@skmtc/core 0.0.225 → 0.0.227

package/script/context/GenerateContext.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenerateContext = void 0;
+const mod_js_1 = require("../deps/jsr.io/@std/path/1.0.0/mod.js");
+const Import_js_1 = require("../dsl/Import.js");
+const GeneratorKeys_js_1 = require("../types/GeneratorKeys.js");
+const OperationDriver_js_1 = require("../dsl/OperationDriver.js");
+const ModelDriver_js_1 = require("../dsl/ModelDriver.js");
+class GenerateContext {
+    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,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "schemaModel", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "settings", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        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;
+    }
+    getFile(filePath, { throwIfNotFound = false } = {}) {
+        const normalisedPath = (0, mod_js_1.normalize)(filePath);
+        const currentFile = this.files.get(normalisedPath);
+        if (!currentFile) {
+            if (throwIfNotFound) {
+                throw new Error(`File not found: '${normalisedPath}'`);
+            }
+            else {
+                return this.addFile(normalisedPath);
+            }
+        }
+        return currentFile;
+    }
+    register({ imports = {}, packageDependencies = {}, definitions, destinationPath }) {
+        const currentFile = this.getFile(destinationPath);
+        Object.entries(imports).forEach(([importModule, importNames]) => {
+            const module = currentFile.imports.get(importModule);
+            const importItem = new Import_js_1.Import({ module: importModule, importNames });
+            if (module) {
+                importItem.importNames.forEach(n => module.add(`${n}`));
+            }
+            else {
+                currentFile.imports.set(importModule, new Set(importItem.importNames.map(n => `${n}`)));
+            }
+        });
+        Object.entries(packageDependencies).forEach(([module, version]) => {
+            this.packageDependencies.set(module, version);
+        });
+        definitions
+            ?.filter((definition) => Boolean(definition))
+            .forEach(definition => {
+            currentFile.definitions.set(`${definition.identifier}`, definition);
+        });
+    }
+    transform({ coreContext, generation, destinationPath, ...rest }) {
+        if ('operation' in rest) {
+            const { creator, operation } = rest;
+            const { settings, definition } = new OperationDriver_js_1.OperationDriver({
+                context: coreContext,
+                creator,
+                operation,
+                generation,
+                destinationPath
+            });
+            return { settings, definition };
+        }
+        else {
+            const { creator, refName } = rest;
+            const { settings, definition } = new ModelDriver_js_1.ModelDriver({
+                context: coreContext,
+                creator,
+                refName,
+                generation,
+                destinationPath
+            });
+            return { settings, definition };
+        }
+    }
+    getOperationBaseSettings({ generatorId, path, method }) {
+        const generatorSettings = this.settings?.generators?.find(({ id }) => id === generatorId);
+        const operationSettings = generatorSettings && 'operations' in generatorSettings
+            ? generatorSettings.operations?.[path]?.[method]
+            : undefined;
+        const exportPath = operationSettings?.exportPath
+            ? (0, mod_js_1.join)(generatorSettings?.exportPath ?? '', operationSettings?.exportPath)
+            : undefined;
+        const baseSettings = {
+            exportPath,
+            selected: Boolean(operationSettings?.selected),
+            name: operationSettings?.name,
+            importFrom: operationSettings?.importFrom
+        };
+        return baseSettings;
+    }
+    getModelBaseSettings({ generatorId, refName }) {
+        const generatorSettings = this.settings?.generators?.find(({ id }) => id === generatorId);
+        const modelSettings = generatorSettings && 'models' in generatorSettings
+            ? generatorSettings?.models?.[refName]
+            : undefined;
+        const exportPath = modelSettings?.exportPath
+            ? (0, mod_js_1.join)(generatorSettings?.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(),
+            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((0, GeneratorKeys_js_1.toOperationGeneratorKey)({ generatorId: dependencyId, operation }));
+        });
+    }
+    /** Produce external instance and return its name */
+    pick({ name, exportPath }) {
+        return this.getFile(exportPath).definitions.get(name);
+    }
+}
+exports.GenerateContext = GenerateContext;

package/script/context/LogStore.d.ts

@@ -0,0 +1,25 @@
+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[]>;
+    addLog({ level, phase, trail, message }: ReportArgs): void;
+    generateOutput(): {
+        logs: string;
+        operations: string;
+    };
+}
+export {};
+//# sourceMappingURL=LogStore.d.ts.map

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

@@ -0,0 +1 @@
+{"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/script/context/LogStore.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogStore = void 0;
+const LOG_LEVELS = {
+    info: 1,
+    warn: 3,
+    error: 5
+};
+class LogStore {
+    constructor() {
+        Object.defineProperty(this, "logs", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "operations", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: {}
+        });
+    }
+    addLog({ level, phase, trail, message }) {
+        const fullLog = `${level
+            .toUpperCase()
+            .padEnd(6)} [${phase.toUpperCase()}]  ${trail.toString()} - ${message}`;
+        this.logs.push(fullLog);
+        const { apiPath, method } = trail;
+        if (apiPath && method) {
+            const operationId = `${trail.method?.toUpperCase()} ${trail.apiPath}`;
+            if (!this.operations[operationId]) {
+                this.operations[operationId] = [];
+            }
+            const subMethodPath = `${trail.toSubMethodTrail().toString()}`;
+            const pathAndMessage = subMethodPath
+                ? `${subMethodPath} - ${message}`
+                : message;
+            const subMethodLog = `${level
+                .toUpperCase()
+                .padEnd(6)} [${phase.toUpperCase()}]  ${pathAndMessage}`;
+            this.operations[operationId].push(subMethodLog);
+        }
+    }
+    generateOutput() {
+        const logs = this.logs.join('\n');
+        const operations = Object.entries(this.operations).reduce((acc, [operation, logs]) => {
+            acc += `${operation}\n${logs.join('\n')}\n\n`;
+            return acc;
+        }, '');
+        return {
+            logs,
+            operations
+        };
+    }
+}
+exports.LogStore = LogStore;

package/script/context/ParseContext.d.ts

@@ -0,0 +1,15 @@
+import type { OpenAPIV3 } from 'openapi-types';
+import type { Trail } from './Trail.js';
+type ParseContextArgs = {
+    parsedDocument: OpenAPIV3.Document;
+};
+export declare class ParseContext {
+    parsedDocument: OpenAPIV3.Document;
+    refDiffs: Promise<{
+        trail: Trail;
+        key: string;
+    }>[];
+    constructor({ parsedDocument }: ParseContextArgs);
+}
+export {};
+//# sourceMappingURL=ParseContext.d.ts.map

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

@@ -0,0 +1 @@
+{"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/script/context/ParseContext.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParseContext = void 0;
+class ParseContext {
+    constructor({ parsedDocument }) {
+        Object.defineProperty(this, "parsedDocument", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "refDiffs", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.parsedDocument = parsedDocument;
+        this.refDiffs = [];
+    }
+}
+exports.ParseContext = ParseContext;

package/script/context/RenderContext.d.ts

@@ -0,0 +1,50 @@
+import type { PrettierConfigType } from '../types/prettierConfig.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>;
+    prettier?: PrettierConfigType;
+    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 prettier?;
+    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<RenderResult>;
+    private collate;
+    getFile(filePath: string): FileContents;
+    addGeneratorKey({ generatorKey }: AddGeneratorKeyArgs): void;
+    pick({ name, exportPath }: PickArgs): Definition | undefined;
+}
+export {};
+//# sourceMappingURL=RenderContext.d.ts.map

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

@@ -0,0 +1 @@
+{"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/script/context/RenderContext.js

@@ -0,0 +1,253 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RenderContext = void 0;
+const mod_js_1 = require("../deps/jsr.io/@std/encoding/1.0.1/mod.js");
+const Import_js_1 = require("../dsl/Import.js");
+const standalone_1 = require("prettier/standalone");
+const typescript_1 = __importDefault(require("prettier/plugins/typescript"));
+const estree_1 = __importDefault(require("prettier/plugins/estree"));
+const tiny_invariant_1 = __importDefault(require("tiny-invariant"));
+const mod_js_2 = require("../deps/jsr.io/@std/path/1.0.0/mod.js");
+const Sentry = __importStar(require("@sentry/deno"));
+class RenderContext {
+    constructor({ files, packageDependencies, prettier, settings, renderDependencies, pinnableGenerators }) {
+        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,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "prettier", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "settings", {
+            enumerable: true,
+            configurable: true,
+            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.prettier = prettier;
+        this.settings = settings;
+        this.pinnableGenerators = pinnableGenerators;
+    }
+    toPackageJson() {
+        const dependencies = Object.fromEntries(this.packageDependencies.entries());
+        const packageJson = JSON.stringify({ dependencies }, null, 2);
+        return packageJson;
+    }
+    async render({ packageJson }) {
+        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
+            });
+        });
+        return {
+            artifacts: packageJson
+                ? {
+                    ...result.artifacts,
+                    'package.json': this.toPackageJson()
+                }
+                : result.artifacts,
+            manifest: {
+                ...result.manifest,
+                pinnable
+            },
+            renderDependencies
+        };
+    }
+    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
+            });
+        });
+        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: {}
+            }
+        });
+    }
+    getFile(filePath) {
+        const normalisedPath = (0, mod_js_2.normalize)(filePath);
+        const currentFile = this.files.get(normalisedPath);
+        (0, tiny_invariant_1.default)(currentFile, `File not found during render phase: ${normalisedPath}`);
+        return currentFile;
+    }
+    addGeneratorKey({ generatorKey }) {
+        const path = this.currentDestinationPath;
+        (0, tiny_invariant_1.default)(!['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);
+    }
+}
+exports.RenderContext = RenderContext;
+const toHash = async (content) => {
+    const messageBuffer = new TextEncoder().encode(content);
+    const hashBuffer = await crypto.subtle.digest('SHA-256', messageBuffer);
+    return (0, mod_js_1.encodeHex)(hashBuffer);
+};
+const renderFile = ({ file, destination, basePath }) => {
+    const imports = Array.from(file.imports.entries()).map(([module, importItems]) => new Import_js_1.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: (0, mod_js_2.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 (0, standalone_1.format)(content, {
+        parser: 'typescript',
+        plugins: [estree_1.default, typescript_1.default],
+        ...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/script/context/Trail.d.ts

@@ -0,0 +1,26 @@
+import type { OpenAPIV3 } from 'openapi-types';
+type ConstructorArgs = {
+    path?: string[];
+    apiPath?: string;
+    method?: string;
+    schemaRef?: string;
+    document?: OpenAPIV3.Document;
+    subMethodIndex?: number;
+};
+export declare class Trail {
+    path: string[];
+    apiPath: string | undefined;
+    method: string | undefined;
+    schemaRef: string | undefined;
+    document: OpenAPIV3.Document | undefined;
+    subMethodIndex?: number;
+    constructor({ path, apiPath, method, schemaRef, document, subMethodIndex }?: ConstructorArgs);
+    add(path: string): Trail;
+    addApiPath(apiPath: string): Trail;
+    addMethod(method: string): Trail;
+    addSchemaRef(schemaRef: string): Trail;
+    toSubMethodTrail(): Trail;
+    toString(): string;
+}
+export {};
+//# sourceMappingURL=Trail.d.ts.map

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

@@ -0,0 +1 @@
+{"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"}