feat: improved error handling

examples/access-protection/jitar.json

@@ -1,4 +1,4 @@
 {
-    "source": "./dist",
-    "target": "./build"
+    "source": "./build",
+    "target": "./dist"
 }

examples/access-protection/tsconfig.json

@@ -3,7 +3,7 @@
   "compilerOptions":
   {
     "rootDir": "./src",
-    "outDir": "./dist"
+    "outDir": "./build"
   },
   "include": ["./src"]
 }

examples/data-transportation/jitar.json

@@ -1,4 +1,4 @@
 {
-    "source": "./dist",
-    "target": "./build"
+    "source": "./build",
+    "target": "./dist"
 }

examples/data-transportation/tsconfig.json

@@ -3,7 +3,7 @@
   "compilerOptions":
   {
     "rootDir": "./src",
-    "outDir": "./dist"
+    "outDir": "./build"
   },
   "include": ["./src"]
 }

examples/error-handling/jitar.json

@@ -1,4 +1,4 @@
 {
-    "source": "./dist",
-    "target": "./build"
+    "source": "./build",
+    "target": "./dist"
 }

examples/error-handling/tsconfig.json

@@ -3,7 +3,7 @@
   "compilerOptions":
   {
     "rootDir": "./src",
-    "outDir": "./dist"
+    "outDir": "./build"
   },
   "include": ["./src"]
 }

examples/health-checks/jitar.json

@@ -1,4 +1,4 @@
 {
-    "source": "./dist",
-    "target": "./build"
+    "source": "./build",
+    "target": "./dist"
 }

examples/health-checks/tsconfig.json

@@ -3,7 +3,7 @@
   "compilerOptions":
   {
     "rootDir": "./src",
-    "outDir": "./dist"
+    "outDir": "./build"
   },
   "include": ["./src"]
 }

examples/hello-world/jitar.json

@@ -1,4 +1,4 @@
 {
-    "source": "./dist",
-    "target": "./build"
+    "source": "./build",
+    "target": "./dist"
 }

examples/hello-world/tsconfig.json

@@ -3,7 +3,7 @@
   "compilerOptions":
   {
     "rootDir": "./src",
-    "outDir": "./dist"
+    "outDir": "./build"
   },
   "include": ["./src"]
 }

examples/load-balancing/jitar.json

@@ -1,4 +1,4 @@
 {
-    "source": "./dist",
-    "target": "./build"
+    "source": "./build",
+    "target": "./dist"
 }

examples/load-balancing/tsconfig.json

@@ -3,7 +3,7 @@
   "compilerOptions":
   {
     "rootDir": "./src",
-    "outDir": "./dist"
+    "outDir": "./build"
   },
   "include": ["./src"]
 }

examples/middleware/jitar.json

@@ -1,4 +1,4 @@
 {
-    "source": "./dist",
-    "target": "./build"
+    "source": "./build",
+    "target": "./dist"
 }

examples/middleware/tsconfig.json

@@ -3,7 +3,7 @@
   "compilerOptions":
   {
     "rootDir": "./src",
-    "outDir": "./dist"
+    "outDir": "./build"
   },
   "include": ["./src"]
 }

examples/multi-version/jitar.json

@@ -1,4 +1,4 @@
 {
-    "source": "./dist",
-    "target": "./build"
+    "source": "./build",
+    "target": "./dist"
 }

examples/multi-version/tsconfig.json

@@ -3,7 +3,7 @@
   "compilerOptions":
   {
     "rootDir": "./src",
-    "outDir": "./dist"
+    "outDir": "./build"
   },
   "include": ["./src"]
 }

examples/resources/jitar.json

@@ -1,6 +1,6 @@
 {
-    "source": "./dist",
-    "target": "./build",
+    "source": "./build",
+    "target": "./dist",
     "segments": "./segments",
     "resources": "./resources"
 }

examples/resources/tsconfig.json

@@ -3,7 +3,7 @@
   "compilerOptions":
   {
     "rootDir": "./src",
-    "outDir": "./dist"
+    "outDir": "./build"
   },
   "include": ["./src"]
 }

examples/segmentation/jitar.json

@@ -1,5 +1,5 @@
 {
-    "source": "./dist",
-    "target": "./build",
+    "source": "./build",
+    "target": "./dist",
     "segments": "./segments"
 }

examples/segmentation/tsconfig.json

@@ -3,7 +3,7 @@
   "compilerOptions":
   {
     "rootDir": "./src",
-    "outDir": "./dist"
+    "outDir": "./build"
   },
   "include": ["./src"]
 }

packages/analysis/README.md

@@ -8,21 +8,20 @@ For more information about Jitar:
 * [Visit our website](https://jitar.dev)
 * [Read the documentation](https://docs.jitar.dev).
 
-## Known limitations
+## TOOLS
 
-1. Declaration of multiple values is not supported
+Two tools are provided:
 
-```ts
-// Supported
-const a = 1;
-export { a }
+* **Reflector** - Extensive reflection (modules, classes, functions, objects and instances)
+* **Parser** - Code parsing (modules, statements, imports, exports, variables, functions and classes)
 
-// Unsupported (will be supported)
-const b = 2, c = 3;
-export { b, c }
-```
+Both tools return a shared based on the ECMAScript specification, but tailored to the Jitar runtime.
+
+## KNOWN LIMITATIONS
+
+The limitations below belong to the parser.
 
-2. Generator as object properties are not supported
+1. Generator as object properties are not supported
 
 ```ts
 // Supported
@@ -45,7 +44,7 @@ class Bar
 }
 ```
 
-3. Destructuring not fully supported
+2. Destructuring not fully supported
 
 ```ts
 // Supported

packages/build/README.md

@@ -7,3 +7,10 @@ For more information about Jitar:
 
 * [Visit our website](https://jitar.dev)
 * [Read the documentation](https://docs.jitar.dev).
+
+## CONTENT
+
+Two tools are provided:
+
+* **BuildHelper** - Generates and returns module and segment code on request.
+* **BuildManager** - Rewrites the whole application to the target folder.

packages/build/src/BuildHelper.ts

@@ -3,11 +3,12 @@ import type { RuntimeConfiguration } from '@jitar/configuration';
 import { Files, LocalFileManager } from '@jitar/sourcing';
 
 import { Application, ApplicationReader } from './source';
-import { LocalModuleGenerator, RemoteModuleGenerator } from './target';
+import { LocalModuleGenerator, RemoteModuleGenerator, SegmentGenerator } from './target';
 import { FileHelper } from './utils';
 
 import ApplicationNotRead from './errors/ApplicationNotRead';
 import ApplicationModuleNotFound from './errors/ApplicationModuleNotFound';
+import ApplicationSegmentNotFound from './errors/ApplicationSegmentNotFound';
 
 import ProjectFileManager from './ProjectFileManager';
 
@@ -91,4 +92,23 @@ export default class BuildHelper
 
         return generator.generate();
     }
+
+    generateSegmentCode(segmentName: string): string
+    {
+        if (this.#application === undefined)
+        {
+            throw new ApplicationNotRead();
+        }
+
+        const segment = this.#application.segmentation.getSegment(segmentName);
+
+        if (segment === undefined)
+        {
+            throw new ApplicationSegmentNotFound(segmentName);
+        }
+
+        const generator = new SegmentGenerator(segment);
+
+        return generator.generate();
+    }
 }

packages/build/src/BuildManager.ts

@@ -7,6 +7,8 @@ import { ApplicationReader } from './source';
 import { ApplicationBuilder } from './target';
 import { FileHelper } from './utils';
 
+import BuildFailed from './errors/BuildFailed';
+
 import ProjectFileManager from './ProjectFileManager';
 
 export default class BuildManager
@@ -43,16 +45,23 @@ export default class BuildManager
 
     async build(): Promise<void>
     {
-        const sourceFileManager = this.#fileManager.source;
-        const resourceFileManager = this.#fileManager.resource;
-        const segmentFileManager = this.#fileManager.segment;
+        try
+        {
+            const sourceFileManager = this.#fileManager.source;
+            const resourceFileManager = this.#fileManager.resource;
+            const segmentFileManager = this.#fileManager.segment;
 
-        const moduleFiles = await sourceFileManager.filterWithIgnores(Files.MODULE_PATTERN, this.#fileManager.sourceIgnores);
-        const resourceFiles = await resourceFileManager.filter(Files.RESOURCE_PATTERN);
-        const segmentFiles = await segmentFileManager.filter(Files.SEGMENT_PATTERN);
+            const moduleFiles = await sourceFileManager.filterWithIgnores(Files.MODULE_PATTERN, this.#fileManager.sourceIgnores);
+            const resourceFiles = await resourceFileManager.filter(Files.RESOURCE_PATTERN);
+            const segmentFiles = await segmentFileManager.filter(Files.SEGMENT_PATTERN);
 
-        const applicationModel = await this.#applicationReader.read(moduleFiles, resourceFiles, segmentFiles);
+            const applicationModel = await this.#applicationReader.read(moduleFiles, resourceFiles, segmentFiles);
 
-        return this.#applicationBuilder.build(applicationModel);
+            await this.#applicationBuilder.build(applicationModel);
+        }
+        catch (error: unknown)
+        {
+            throw new BuildFailed(error);
+        }
     }
 }

packages/build/src/errors/ApplicationSegmentNotFound.ts

@@ -0,0 +1,8 @@
+
+export default class ApplicationSegmentNotFound extends Error
+{
+    constructor(segmentName: string)
+    {
+        super(`Application segment not found '${segmentName}'`);
+    }
+}

packages/build/src/errors/BuildFailed.ts

@@ -0,0 +1,8 @@
+
+export default class BuildFailed extends Error
+{
+    constructor(cause: unknown)
+    {
+        super('Build failed', { cause });
+    }
+}

packages/build/src/source/index.ts

@@ -1,5 +1,5 @@
 
 export { Application, ApplicationReader } from './application';
 export { Module } from './module';
-export { Segment, SegmentModule, SegmentImplementation, Segmentation } from './segment';
+export { Segment, SegmentModule, SegmentMember, SegmentClass, SegmentImplementation, Segmentation } from './segment';
 export { ResourcesList } from './resource';

packages/build/src/source/module/Reader.ts

@@ -2,10 +2,10 @@
 import { Parser } from '@jitar/analysis';
 import type { FileManager } from '@jitar/sourcing';
 
-import FileNotLoaded from './errors/FileNotLoaded';
-
+import ReadingModuleFailed from './errors/ReadingModuleFailed';
 import Module from './models/Module';
 import Repository from './models/Repository';
+
 import LocationRewriter from './LocationRewriter';
 
 export default class Reader
@@ -44,9 +44,7 @@ export default class Reader
         }
         catch (error: unknown)
         {
-            const message = error instanceof Error ? error.message : String(error);
-
-            throw new FileNotLoaded(filename, message);
+            throw new ReadingModuleFailed(filename, error);
         }
     }
 

packages/build/src/source/module/errors/ReadingModuleFailed.ts

@@ -0,0 +1,8 @@
+
+export default class ReadingModuleFailed extends Error
+{
+    constructor(filename: string, cause: unknown)
+    {
+        super(`Failed reading module from '${filename}'`, { cause });
+    }
+}