@skmtc/core 0.0.30 → 0.0.218

package/esm/context/GenerateContext.js

@@ -1,13 +1,22 @@
-import { normalize } from '../deps/jsr.io/@std/path/0.224.0/mod.js';
+import { join, normalize } from '../deps/jsr.io/@std/path/1.0.0/mod.js';
 import { Import } from '../dsl/Import.js';
+import { toOperationGeneratorKey } from '../types/GeneratorKeys.js';
+import { OperationDriver } from '../dsl/OperationDriver.js';
+import { ModelDriver } from '../dsl/ModelDriver.js';
 export class GenerateContext {
-    constructor({ schemaModel, settings, reporter }) {
+    constructor({ schemaModel, generatorsMap, settings }) {
         Object.defineProperty(this, "files", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "renderDependencies", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "packageDependencies", {
             enumerable: true,
             configurable: true,
@@ -26,26 +35,29 @@ export class GenerateContext {
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "reporter", {
+        Object.defineProperty(this, "generatorsMap", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        this.generatorsMap = generatorsMap;
         this.files = new Map();
+        this.renderDependencies = new Map();
         this.packageDependencies = new Map();
         this.schemaModel = schemaModel;
         this.settings = settings;
-        this.reporter = reporter;
-    }
-    static create(args) {
-        return new GenerateContext(args);
     }
-    getFile(filePath) {
+    getFile(filePath, { throwIfNotFound = false } = {}) {
         const normalisedPath = normalize(filePath);
         const currentFile = this.files.get(normalisedPath);
         if (!currentFile) {
-            return this.addFile(normalisedPath);
+            if (throwIfNotFound) {
+                throw new Error(`File not found: '${normalisedPath}'`);
+            }
+            else {
+                return this.addFile(normalisedPath);
+            }
         }
         return currentFile;
     }
@@ -53,7 +65,7 @@ export class GenerateContext {
         const currentFile = this.getFile(destinationPath);
         Object.entries(imports).forEach(([importModule, importNames]) => {
             const module = currentFile.imports.get(importModule);
-            const importItem = Import.create(importModule, importNames);
+            const importItem = new Import({ module: importModule, importNames });
             if (module) {
                 importItem.importNames.forEach(n => module.add(`${n}`));
             }
@@ -70,22 +82,92 @@ export class GenerateContext {
             currentFile.definitions.set(`${definition.identifier}`, definition);
         });
     }
+    transform({ coreContext, generation, destinationPath, ...rest }) {
+        if ('operation' in rest) {
+            const { creator, operation } = rest;
+            const { settings, definition } = new OperationDriver({
+                context: coreContext,
+                creator,
+                operation,
+                generation,
+                destinationPath
+            });
+            return { settings, definition };
+        }
+        else {
+            const { creator, refName } = rest;
+            const { settings, definition } = new ModelDriver({
+                context: coreContext,
+                creator,
+                refName,
+                generation,
+                destinationPath
+            });
+            return { settings, definition };
+        }
+    }
+    getOperationBaseSettings({ pluginId, path, method }) {
+        const pluginSettings = this.settings?.generators?.find(({ id }) => id === pluginId);
+        const operationSettings = pluginSettings && 'operations' in pluginSettings
+            ? pluginSettings.operations?.[path]?.[method]
+            : undefined;
+        const exportPath = operationSettings?.exportPath
+            ? join(pluginSettings?.exportPath ?? '', operationSettings?.exportPath)
+            : undefined;
+        const baseSettings = {
+            exportPath,
+            selected: Boolean(operationSettings?.selected),
+            name: operationSettings?.name,
+            importFrom: operationSettings?.importFrom
+        };
+        return baseSettings;
+    }
+    getModelBaseSettings({ pluginId, refName }) {
+        const pluginSettings = this.settings?.generators?.find(({ id }) => id === pluginId);
+        const modelSettings = pluginSettings && 'models' in pluginSettings
+            ? pluginSettings?.models?.[refName]
+            : undefined;
+        const exportPath = modelSettings?.exportPath
+            ? join(pluginSettings?.exportPath ?? '', modelSettings?.exportPath)
+            : undefined;
+        const baseSettings = {
+            exportPath,
+            selected: Boolean(modelSettings?.selected),
+            name: modelSettings?.name,
+            importFrom: modelSettings?.importFrom
+        };
+        return baseSettings;
+    }
     addFile(normalisedPath) {
         if (this.files.has(normalisedPath)) {
             throw new Error(`File already exists: ${normalisedPath}`);
         }
         const newFile = {
             imports: new Map(),
-            definitions: new Map()
+            definitions: new Map(),
+            generatorKeys: new Set()
         };
         this.files.set(normalisedPath, newFile);
         return newFile;
     }
+    resolveSchemaRefOnce(refName) {
+        const schema = this.schemaModel.components?.schemas?.[refName]?.resolveOnce();
+        if (!schema) {
+            throw new Error(`Schema not found: ${refName}`);
+        }
+        return schema;
+    }
+    addRenderDependency({ generatorId, dependencies, operation }) {
+        if (!this.renderDependencies.has(generatorId)) {
+            this.renderDependencies.set(generatorId, new Set());
+        }
+        const generatorDependencies = this.renderDependencies.get(generatorId);
+        dependencies.forEach(dependencyId => {
+            generatorDependencies?.add(toOperationGeneratorKey({ generatorId: dependencyId, operation }));
+        });
+    }
     /** Produce external instance and return its name */
     pick({ name, exportPath }) {
         return this.getFile(exportPath).definitions.get(name);
     }
-    report({ level, phase, trail, message }) {
-        this.reporter.report({ level, phase, trail, message });
-    }
 }

package/esm/context/LogStore.d.ts

@@ -1,4 +1,17 @@
-import type { ReportArgs } from './Reporter.js';
+import type { Trail } from './Trail.js';
+import type { PhaseType } from './types.js';
+type LogLevel = keyof typeof LOG_LEVELS;
+export type ReportArgs = {
+    level: LogLevel;
+    phase: PhaseType;
+    trail: Trail;
+    message: string;
+};
+declare const LOG_LEVELS: {
+    info: number;
+    warn: number;
+    error: number;
+};
 export declare class LogStore {
     logs: string[];
     operations: Record<string, string[]>;
@@ -8,4 +21,5 @@ export declare class LogStore {
         operations: string;
     };
 }
+export {};
 //# sourceMappingURL=LogStore.d.ts.map

package/esm/context/LogStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LogStore.d.ts","sourceRoot":"","sources":["../../src/context/LogStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,qBAAa,QAAQ;IACnB,IAAI,EAAE,MAAM,EAAE,CAAK;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAK;IAEzC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,UAAU;IA8BnD,cAAc,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;CAevD"}
+{"version":3,"file":"LogStore.d.ts","sourceRoot":"","sources":["../../src/context/LogStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,KAAK,QAAQ,GAAG,MAAM,OAAO,UAAU,CAAA;AAEvC,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,QAAQ,CAAA;IACf,KAAK,EAAE,SAAS,CAAA;IAChB,KAAK,EAAE,KAAK,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,QAAA,MAAM,UAAU;;;;CAIf,CAAA;AAED,qBAAa,QAAQ;IACnB,IAAI,EAAE,MAAM,EAAE,CAAK;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAK;IAEzC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,UAAU;IA8BnD,cAAc,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;CAevD"}

package/esm/context/LogStore.js

@@ -1,3 +1,8 @@
+const LOG_LEVELS = {
+    info: 1,
+    warn: 3,
+    error: 5
+};
 export class LogStore {
     constructor() {
         Object.defineProperty(this, "logs", {

package/esm/context/ParseContext.d.ts

@@ -1,23 +1,15 @@
-import type { ReportArgs, Reporter } from './Reporter.js';
-import type { SpecVersion } from '@redocly/openapi-core';
 import type { OpenAPIV3 } from 'openapi-types';
 import type { Trail } from './Trail.js';
 type ParseContextArgs = {
-    specVersion: SpecVersion;
     parsedDocument: OpenAPIV3.Document;
-    reporter?: Reporter | undefined;
 };
 export declare class ParseContext {
-    private reporter;
-    specVersion: SpecVersion;
     parsedDocument: OpenAPIV3.Document;
     refDiffs: Promise<{
         trail: Trail;
         key: string;
     }>[];
-    private constructor();
-    static create({ parsedDocument, specVersion, reporter }: ParseContextArgs): ParseContext;
-    report({ level, phase, trail, message }: ReportArgs): void;
+    constructor({ parsedDocument }: ParseContextArgs);
 }
 export {};
 //# sourceMappingURL=ParseContext.d.ts.map

package/esm/context/ParseContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParseContext.d.ts","sourceRoot":"","sources":["../../src/context/ParseContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC,KAAK,gBAAgB,GAAG;IACtB,WAAW,EAAE,WAAW,CAAA;IACxB,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAA;IAClC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;CAChC,CAAA;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAsB;IACtC,WAAW,EAAE,WAAW,CAAA;IACxB,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAA;IAClC,QAAQ,EAAE,OAAO,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAA;IAElD,OAAO;IAWP,MAAM,CAAC,MAAM,CAAC,EACZ,cAAc,EACd,WAAW,EACX,QAAQ,EACT,EAAE,gBAAgB,GAAG,YAAY;IAIlC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,UAAU;CAQpD"}
+{"version":3,"file":"ParseContext.d.ts","sourceRoot":"","sources":["../../src/context/ParseContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC,KAAK,gBAAgB,GAAG;IACtB,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAA;CACnC,CAAA;AAED,qBAAa,YAAY;IACvB,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAA;IAClC,QAAQ,EAAE,OAAO,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAA;gBAEtC,EAAE,cAAc,EAAE,EAAE,gBAAgB;CAIjD"}

package/esm/context/ParseContext.js

@@ -1,17 +1,5 @@
 export class ParseContext {
-    constructor({ parsedDocument, specVersion, reporter }) {
-        Object.defineProperty(this, "reporter", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "specVersion", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
+    constructor({ parsedDocument }) {
         Object.defineProperty(this, "parsedDocument", {
             enumerable: true,
             configurable: true,
@@ -25,14 +13,6 @@ export class ParseContext {
             value: void 0
         });
         this.parsedDocument = parsedDocument;
-        this.specVersion = specVersion;
-        this.reporter = reporter;
         this.refDiffs = [];
     }
-    static create({ parsedDocument, specVersion, reporter }) {
-        return new ParseContext({ parsedDocument, specVersion, reporter });
-    }
-    report({ level, phase, trail, message }) {
-        this.reporter?.report({ level, phase, trail, message });
-    }
 }

package/esm/context/RenderContext.d.ts

@@ -1,32 +1,50 @@
 import type { PrettierConfigType } from '../types/prettierConfig.js';
-import type { ReportArgs } from './Reporter.js';
-import type { Reporter } from './Reporter.js';
-import type { FileContents, RenderOptions } from './types.js';
-import type { Settings } from '../settings/types.js';
+import type { AddGeneratorKeyArgs, FileContents, RenderDependencies, RenderOptions } from './types.js';
+import type { ClientSettings } from '../types/Settings.js';
 import type { Definition } from '../dsl/Definition.js';
 import type { PickArgs } from './GenerateContext.js';
+import type { GeneratorKey } from '../types/GeneratorKeys.js';
 type ConstructorArgs = {
     files: Map<string, FileContents>;
     packageDependencies: Map<string, string>;
-    reporter: Reporter;
     prettier?: PrettierConfigType;
-    settings: Settings | undefined;
+    settings: ClientSettings | undefined;
+    renderDependencies: RenderDependencies;
+    pinnableGenerators: string[];
+};
+type ManifestEntry = {
+    numberOfLines: number;
+    numberOfCharacters: number;
+    hash: string;
+    generatorKeys: GeneratorKey[];
+};
+type Manifest = {
+    createdAt: string;
+    files: Record<string, ManifestEntry>;
+    pinnable: Record<GeneratorKey, string>;
+};
+export type FilesRenderResult = {
+    artifacts: Record<string, string>;
+    manifest: Manifest;
+};
+export type RenderResult = FilesRenderResult & {
+    renderDependencies: Record<string, string[]>;
 };
 export declare class RenderContext {
     files: Map<string, FileContents>;
+    renderDependencies: RenderDependencies;
     packageDependencies: Map<string, string>;
-    private reporter;
     private prettier?;
-    settings: Settings | undefined;
-    private constructor();
-    static create(args: ConstructorArgs): RenderContext;
+    settings: ClientSettings | undefined;
+    currentDestinationPath: string | 'PRE_RENDER' | 'POST_RENDER';
+    pinnableGenerators: string[];
+    constructor({ files, packageDependencies, prettier, settings, renderDependencies, pinnableGenerators }: ConstructorArgs);
     toPackageJson(): string;
-    render({ packageJson }: RenderOptions): Promise<Record<string, string>>;
+    render({ packageJson }: RenderOptions): Promise<RenderResult>;
     private collate;
-    private format;
     getFile(filePath: string): FileContents;
+    addGeneratorKey({ generatorKey }: AddGeneratorKeyArgs): void;
     pick({ name, exportPath }: PickArgs): Definition | undefined;
-    report({ level, phase, trail, message }: ReportArgs): void;
 }
 export {};
 //# sourceMappingURL=RenderContext.d.ts.map

package/esm/context/RenderContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RenderContext.d.ts","sourceRoot":"","sources":["../../src/context/RenderContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAK7C,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAEpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAEpD,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAChC,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,QAAQ,EAAE,QAAQ,CAAA;IAClB,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAC7B,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAA;CAC/B,CAAA;AAED,qBAAa,aAAa;IACxB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAChC,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,QAAQ,CAAC,CAAoB;IACrC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAA;IAE9B,OAAO;IAcP,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,aAAa;IAInD,aAAa,IAAI,MAAM;IAQjB,MAAM,CAAC,EACX,WAAW,EACZ,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAUlD,OAAO,CAAC,OAAO;YA+BD,MAAM;IA4BpB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAavC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS;IAI5D,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,UAAU,GAAG,IAAI;CAG3D"}
+{"version":3,"file":"RenderContext.d.ts","sourceRoot":"","sources":["../../src/context/RenderContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAMpE,OAAO,KAAK,EACV,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACd,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAG7D,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAChC,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAC7B,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;IACpC,kBAAkB,EAAE,kBAAkB,CAAA;IACtC,kBAAkB,EAAE,MAAM,EAAE,CAAA;CAC7B,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,YAAY,EAAE,CAAA;CAC9B,CAAA;AAED,KAAK,QAAQ,GAAG;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACpC,QAAQ,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;CACvC,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,QAAQ,EAAE,QAAQ,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG;IAC7C,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAC7C,CAAA;AAED,qBAAa,aAAa;IACxB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAChC,kBAAkB,EAAE,kBAAkB,CAAA;IACtC,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,OAAO,CAAC,QAAQ,CAAC,CAAoB;IACrC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;IACpC,sBAAsB,EAAE,MAAM,GAAG,YAAY,GAAG,aAAa,CAAA;IAC7D,kBAAkB,EAAE,MAAM,EAAE,CAAA;gBAChB,EACV,KAAK,EACL,mBAAmB,EACnB,QAAQ,EACR,QAAQ,EACR,kBAAkB,EAClB,kBAAkB,EACnB,EAAE,eAAe;IAUlB,aAAa,IAAI,MAAM;IAQjB,MAAM,CAAC,EAAE,WAAW,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;YAyCrD,OAAO;IAuErB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAavC,eAAe,CAAC,EAAE,YAAY,EAAE,EAAE,mBAAmB;IAarD,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS;CAG7D"}

package/esm/context/RenderContext.js

@@ -1,24 +1,26 @@
+import { encodeHex } from '../deps/jsr.io/@std/encoding/1.0.1/mod.js';
 import { Import } from '../dsl/Import.js';
 import { format } from 'prettier/standalone';
 import typescript from 'prettier/plugins/typescript';
 import estree from 'prettier/plugins/estree';
 import invariant from 'tiny-invariant';
-import { join, normalize } from '../deps/jsr.io/@std/path/0.224.0/mod.js';
+import { join, normalize } from '../deps/jsr.io/@std/path/1.0.0/mod.js';
+import * as Sentry from '@sentry/deno';
 export class RenderContext {
-    constructor({ files, packageDependencies, reporter, prettier, settings }) {
+    constructor({ files, packageDependencies, prettier, settings, renderDependencies, pinnableGenerators }) {
         Object.defineProperty(this, "files", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "packageDependencies", {
+        Object.defineProperty(this, "renderDependencies", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "reporter", {
+        Object.defineProperty(this, "packageDependencies", {
             enumerable: true,
             configurable: true,
             writable: true,
@@ -36,14 +38,25 @@ export class RenderContext {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "currentDestinationPath", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "pinnableGenerators", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.currentDestinationPath = 'PRE_RENDER';
+        this.renderDependencies = renderDependencies;
         this.files = files;
         this.packageDependencies = packageDependencies;
-        this.reporter = reporter;
         this.prettier = prettier;
         this.settings = settings;
-    }
-    static create(args) {
-        return new RenderContext(args);
+        this.pinnableGenerators = pinnableGenerators;
     }
     toPackageJson() {
         const dependencies = Object.fromEntries(this.packageDependencies.entries());
@@ -51,50 +64,90 @@ export class RenderContext {
         return packageJson;
     }
     async render({ packageJson }) {
-        const artifactsMap = this.collate();
-        const formatted = await this.format(artifactsMap);
-        return packageJson
-            ? { ...formatted, 'package.json': this.toPackageJson() }
-            : formatted;
-    }
-    collate() {
-        const fileEntries = Array.from(this.files.entries()).map(([destination, file]) => {
-            const imports = Array.from(file.imports.entries()).map(([module, importItems]) => {
-                return Import.create(module, Array.from(importItems));
+        const result = await Sentry.startSpan({ name: 'Collate content' }, async () => {
+            return await this.collate();
+        });
+        const renderDependenciesEntries = [
+            ...this.renderDependencies.entries()
+        ].map(([generatorId, dependencyGeneratorKeys]) => {
+            return [generatorId, Array.from(dependencyGeneratorKeys)];
+        });
+        const renderDependencies = Object.fromEntries(renderDependenciesEntries);
+        const pinnable = await Sentry.startSpan({ name: 'Generate pinnable' }, () => {
+            return generatePinnable({
+                pinnableGenerators: this.pinnableGenerators,
+                manifest: result.manifest
             });
-            const fileContents = [
-                imports,
-                Array.from(file.definitions.values()),
-                [] // Without this TS, tries to convert Stringable[] to Import[]
-            ]
-                .filter((section) => Boolean(section?.length))
-                .map(section => section.join('\n'))
-                .join('\n\n');
-            const path = this.settings?.basePath
-                ? join(this.settings.basePath, destination.replace(/^@\//, ''))
-                : destination;
-            return [path, fileContents];
         });
-        return Object.fromEntries(fileEntries);
+        return {
+            artifacts: packageJson
+                ? {
+                    ...result.artifacts,
+                    'package.json': this.toPackageJson()
+                }
+                : result.artifacts,
+            manifest: {
+                ...result.manifest,
+                pinnable
+            },
+            renderDependencies
+        };
     }
-    async format(artifactsMap) {
-        if (!this.prettier) {
-            return artifactsMap;
-        }
-        const artifactPromises = Object.values(artifactsMap).map(artifact => {
-            return format(artifact, {
-                parser: 'typescript',
-                plugins: [estree, typescript],
-                ...this.prettier
+    async collate() {
+        const fileEntries = Array.from(this.files.entries());
+        const fileObjects = fileEntries.map(([destination, file]) => {
+            // Set the current destination path to be used by
+            // addGeneratorKey method to apply generator keys
+            // to Correct file
+            this.currentDestinationPath = destination;
+            return renderFile({
+                file,
+                destination,
+                basePath: this.settings?.basePath,
+                prettier: this.prettier
             });
         });
-        const prettifiedArtifacts = await Promise.all(artifactPromises);
-        const prettifiedArtifactEntries = Object.keys(artifactsMap).map((key, index) => {
-            const prettifiedArtifact = prettifiedArtifacts[index];
-            invariant(prettifiedArtifact, 'Prettified artifact is undefined');
-            return [key, prettifiedArtifact];
+        this.currentDestinationPath = 'POST_RENDER';
+        const resolvedFileObjects = [];
+        for (const fileObject of fileObjects) {
+            const formattedContent = await Sentry.startSpan({ name: `Format file: ${fileObject.path}` }, async () => {
+                return await formatContent({
+                    content: fileObject.content,
+                    prettier: this.prettier
+                });
+            });
+            const hash = await toHash(formattedContent);
+            resolvedFileObjects.push({
+                ...fileObject,
+                content: formattedContent,
+                hash
+            });
+        }
+        return resolvedFileObjects.reduce((acc, fileObject) => ({
+            artifacts: {
+                ...acc.artifacts,
+                [fileObject.path]: fileObject.content
+            },
+            manifest: {
+                ...acc.manifest,
+                files: {
+                    ...acc.manifest.files,
+                    [fileObject.path]: {
+                        numberOfLines: fileObject.numberOfLines,
+                        numberOfCharacters: fileObject.numberOfCharacters,
+                        hash: fileObject.hash,
+                        generatorKeys: fileObject.generatorKeys
+                    }
+                }
+            }
+        }), {
+            artifacts: {},
+            manifest: {
+                createdAt: new Date().toISOString(),
+                files: {},
+                pinnable: {}
+            }
         });
-        return Object.fromEntries(prettifiedArtifactEntries);
     }
     getFile(filePath) {
         const normalisedPath = normalize(filePath);
@@ -102,10 +155,69 @@ export class RenderContext {
         invariant(currentFile, `File not found during render phase: ${normalisedPath}`);
         return currentFile;
     }
+    addGeneratorKey({ generatorKey }) {
+        const path = this.currentDestinationPath;
+        invariant(!['PRE_RENDER', 'POST_RENDER'].includes(path), `Cannot add generator key during ${path} phase`);
+        const currentFile = this.getFile(path);
+        currentFile.generatorKeys.add(generatorKey);
+    }
     pick({ name, exportPath }) {
         return this.getFile(exportPath).definitions.get(name);
     }
-    report({ level, phase, trail, message }) {
-        this.reporter.report({ level, phase, trail, message });
-    }
 }
+const toHash = async (content) => {
+    const messageBuffer = new TextEncoder().encode(content);
+    const hashBuffer = await crypto.subtle.digest('SHA-256', messageBuffer);
+    return encodeHex(hashBuffer);
+};
+const renderFile = ({ file, destination, basePath }) => {
+    const imports = Array.from(file.imports.entries()).map(([module, importItems]) => new Import({ module, importNames: Array.from(importItems) }));
+    const definitions = Array.from(file.definitions.values());
+    const content = [imports, definitions]
+        .filter(section => Boolean(section.length))
+        .map(section => section.join('\n'))
+        .join('\n\n');
+    return {
+        content,
+        path: join(basePath ?? 'dist', destination.replace(/^@\//, '')),
+        numberOfLines: content.split('\n').length,
+        numberOfCharacters: content.length,
+        generatorKeys: Array.from(file.generatorKeys).filter(Boolean) // @TODO Fix null keys
+    };
+};
+const formatContent = async ({ content, prettier }) => {
+    if (!prettier) {
+        return content;
+    }
+    return await format(content, {
+        parser: 'typescript',
+        plugins: [estree, typescript],
+        ...prettier
+    });
+};
+const generatePinnable = ({ pinnableGenerators, manifest }) => {
+    const output = {};
+    Object.entries(manifest.files).forEach(([filepath, entry]) => {
+        entry.generatorKeys.forEach(generatorKey => {
+            if (!output[generatorKey]) {
+                output[generatorKey] = [];
+            }
+            output[generatorKey].push(filepath);
+        });
+    });
+    const pinnableEntries = Object.entries(output)
+        .map(([generatorKey, files]) => {
+        if (files.length !== 1) {
+            return null;
+        }
+        const isPinnable = pinnableGenerators.reduce((acc, pinnableGenerator) => {
+            if (generatorKey.startsWith(pinnableGenerator)) {
+                return true;
+            }
+            return acc;
+        }, false);
+        return isPinnable ? [generatorKey, files[0]] : null;
+    })
+        .filter((generatorKey) => generatorKey !== null);
+    return Object.fromEntries(pinnableEntries);
+};

package/esm/context/Trail.d.ts

@@ -1,4 +1,3 @@
-import type { Stringable } from '../dsl/Stringable.js';
 import type { OpenAPIV3 } from 'openapi-types';
 type ConstructorArgs = {
     path?: string[];
@@ -8,15 +7,14 @@ type ConstructorArgs = {
     document?: OpenAPIV3.Document;
     subMethodIndex?: number;
 };
-export declare class Trail implements Stringable {
+export declare class Trail {
     path: string[];
     apiPath: string | undefined;
     method: string | undefined;
     schemaRef: string | undefined;
     document: OpenAPIV3.Document | undefined;
     subMethodIndex?: number;
-    private constructor();
-    static create({ path, apiPath, method, schemaRef, document, subMethodIndex }?: ConstructorArgs): Trail;
+    constructor({ path, apiPath, method, schemaRef, document, subMethodIndex }?: ConstructorArgs);
     add(path: string): Trail;
     addApiPath(apiPath: string): Trail;
     addMethod(method: string): Trail;

package/esm/context/Trail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Trail.d.ts","sourceRoot":"","sources":["../../src/context/Trail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,KAAK,eAAe,GAAG;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,qBAAa,KAAM,YAAW,UAAU;IACtC,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,QAAQ,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAA;IACxC,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,OAAO;IAgBP,MAAM,CAAC,MAAM,CAAC,EACZ,IAAI,EACJ,OAAO,EACP,MAAM,EACN,SAAS,EACT,QAAQ,EACR,cAAc,EACf,GAAE,eAAoB,GAAG,KAAK;IAW/B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAWxB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK;IAWlC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;IAWhC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK;IAWtC,gBAAgB,IAAI,KAAK;IAWzB,QAAQ,IAAI,MAAM;CASnB"}
+{"version":3,"file":"Trail.d.ts","sourceRoot":"","sources":["../../src/context/Trail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,KAAK,eAAe,GAAG;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,qBAAa,KAAK;IAChB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,QAAQ,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAA;IACxC,cAAc,CAAC,EAAE,MAAM,CAAA;gBAEX,EACV,IAAS,EACT,OAAO,EACP,MAAM,EACN,SAAS,EACT,QAAQ,EACR,cAAc,EACf,GAAE,eAAoB;IASvB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAWxB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK;IAWlC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;IAWhC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK;IAWtC,gBAAgB,IAAI,KAAK;IAWzB,QAAQ,IAAI,MAAM;CASnB"}