release: v0.2.1

Author: leoweyr

Diff for: README.md

@@ -26,12 +26,20 @@ Package the Legacy Script Engine plugin:
 npx lses pack
 ```
 
-Deploy the Legacy Script Engine plugin package to the local Levilamina server:
+Deploy the Legacy Script Engine plugin package to the local LeviLamina server:
 
 ```bash
 npx lses deploy <path>
 ```
 
 | Argument | Description                                   | Type   |
 | -------- | --------------------------------------------- | ------ |
-| `<path>` | Specific Levilamina server working directory. | String |
+| `<path>` | Specific LeviLamina server working directory. | String |
+
+## ❗ Important
+
+The `main` configuration entry file in package.json should be relative to the project's working directory, <font color="red">not the directory of the Legacy Script Engine plugin package.</font>
+
+For example, in a TypeScript project where index.ts is defined as the entry point in source code and the TypeScript compiler is configured via tsconfig.json to emit to the build directory named dist, you should set the `main` field in package.json to `dist/index.js`. 
+
+This ensures that the `entry` field in the manifest.json generated by `npx lses manifest` can be correctly identified and located by LeviLamina.

Diff for: package.json

@@ -1,6 +1,6 @@
 {
     "name": "legacy-script-engine-scaffold",
-    "version": "0.2.0",
+    "version": "0.2.1",
     "description": "A utility for assisting in the development of Legacy Script Engine plugins.",
     "bugs": "https://github.com/leoweyr/LSEScaffold/issues",
     "bin": {
@@ -13,7 +13,7 @@
         "clean": "tsc --build --clean",
         "compile": "tsc",
         "build": "npm run clean && npm run compile",
-        "install": "npm run build && npm link",
+        "local-deploy": "npm run build && npm link",
         "package": "npm run build && npm pack",
         "deploy": "npm run package && npm publish"
     },

Diff for: src/nodejs/NodeJsConfigurationMainError.ts

@@ -0,0 +1,22 @@
+import { CliLoggableError } from "../cli/CliLoggableError";
+
+
+export class NodeJsConfigurationMainError extends Error implements CliLoggableError {
+    private static MESSAGE: string = "The `main` configuration in package.json is incorrect.";
+
+    public constructor() {
+        super(NodeJsConfigurationMainError.MESSAGE);
+    }
+
+    public getMessage(): string {
+        return NodeJsConfigurationMainError.MESSAGE;
+    }
+
+    public getSuggestion(): Array<string> {
+        const suggestion: Array<string> = new Array<string>();
+
+        suggestion.push("Ensure the `main` field is set to be relative to the project's working directory.");
+
+        return suggestion;
+    }
+}

Diff for: src/packager/Manifest.ts

@@ -5,6 +5,7 @@ import { Project } from "../project/Project";
 import { NodeJsConfiguration } from "../nodejs/NodeJsConfiguration";
 import { ManifestFileNotFoundError } from "./ManifestFileNotFoundError";
 import { ManifestConfigurationMissingError } from "./ManifestConfigurationMissingError";
+import { NodeJsConfigurationMainError } from "../nodejs/NodeJsConfigurationMainError";
 
 
 export class Manifest {
@@ -37,13 +38,18 @@ export class Manifest {
         const nodeJsConfiguration: NodeJsConfiguration = this.project.getNodeJsConfiguration();
         const name: string = nodeJsConfiguration.getName();
         const version: string = nodeJsConfiguration.getVersion();
-        const entry: string = nodeJsConfiguration.getMainEntry();
+        const absoluteEntry: string = Path.join(this.project.getPath(), nodeJsConfiguration.getMainEntry());
+        const relativeEntry: string = absoluteEntry.split(`${this.project.getBuiltPath()}\\`).join("");
+
+        if (relativeEntry === absoluteEntry) {
+            throw new NodeJsConfigurationMainError();
+        }
 
         const manifest = {
             "name": name,
             "version": version,
             "type": "lse-nodejs",
-            "entry": entry,
+            "entry": relativeEntry,
             "dependencies": [{"name": "legacy-script-engine-nodejs"}]
         };
 

Diff for: src/project/TypeScriptProject.ts

@@ -64,7 +64,7 @@ export class TypeScriptProject implements Project {
     }
 
     public getBuiltPath(): string {
-        return this.typeScriptConfiguration.getEmittedDirectory();
+        return Path.join(this.typeScriptConfiguration.getEmittedDirectory());
     }
 
     public getNodeJsConfiguration(): NodeJsConfiguration {