@jumentix/cli-init 0.0.0

package/dist/sources/messages.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Named validation / resolution messages (exit code 1). Keep stable for tests and docs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SOURCE_MESSAGES = void 0;
+exports.SOURCE_MESSAGES = Object.freeze({
+    NO_CORE_SERVICE: 'GenerationPlan validation failed: no core service.',
+    ENTITY_WITHOUT_PRIMARY_KEY: (entityName, domainId) => (`GenerationPlan validation failed: entity "${entityName}" in domain "${domainId}" has no primary key.`),
+    RELATION_CROSSING_BOUNDARY: (relationName, fromService, toService) => (`GenerationPlan validation failed: relation "${relationName}" crosses service boundary `
+        + `(${fromService} / ${toService}) in monolith mode.`),
+    UNSUPPORTED_INTERFACE: (serviceId, kind, value) => (`GenerationPlan validation failed: unsupported ${kind} interface "${value}" on service "${serviceId}".`),
+    DUPLICATE_ENTITY_NAMES: (entityName, domainA, domainB) => (`GenerationPlan validation failed: duplicate entity name "${entityName}" across domains `
+        + `"${domainA}" and "${domainB}".`),
+    INVALID_FROM: (from) => (`Source resolution failed: --from="${from}" is not a readable file or http(s) catalog URL.`),
+    INVALID_PRESET: (preset) => (`Source resolution failed: unsupported --preset="${preset}" (supported: users).`),
+    INVALID_OAS: 'Source resolution failed: document is not a valid OpenAPI 3.x object with components.schemas.',
+    INVALID_DESIGNER_EXPORT: (reason) => (`Source resolution failed: designer export rejected (${reason}).`),
+    CATALOG_FETCH_FAILED: (url, detail) => (`Source resolution failed: catalog fetch failed for ${url}: ${detail}.`),
+    UNSUPPORTED_MODE: (mode) => (`Source resolution failed: unsupported --mode="${mode}".`)
+});
+//# sourceMappingURL=messages.js.map

package/dist/sources/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/sources/messages.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEU,QAAA,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,eAAe,EAAE,oDAAoD;IACrE,0BAA0B,EAAE,CAAC,UAAkB,EAAE,QAAgB,EAAE,EAAE,CAAC,CACpE,6CAA6C,UAAU,gBAAgB,QAAQ,uBAAuB,CACvG;IACD,0BAA0B,EAAE,CAAC,YAAoB,EAAE,WAAmB,EAAE,SAAiB,EAAE,EAAE,CAAC,CAC5F,+CAA+C,YAAY,6BAA6B;UACtF,IAAI,WAAW,MAAM,SAAS,qBAAqB,CACtD;IACD,qBAAqB,EAAE,CAAC,SAAiB,EAAE,IAAyB,EAAE,KAAa,EAAE,EAAE,CAAC,CACtF,iDAAiD,IAAI,eAAe,KAAK,iBAAiB,SAAS,IAAI,CACxG;IACD,sBAAsB,EAAE,CAAC,UAAkB,EAAE,OAAe,EAAE,OAAe,EAAE,EAAE,CAAC,CAChF,4DAA4D,UAAU,mBAAmB;UACvF,IAAI,OAAO,UAAU,OAAO,IAAI,CACnC;IACD,YAAY,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,CAC9B,qCAAqC,IAAI,kDAAkD,CAC5F;IACD,cAAc,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,CAClC,mDAAmD,MAAM,uBAAuB,CACjF;IACD,WAAW,EAAE,+FAA+F;IAC5G,uBAAuB,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,CAC3C,uDAAuD,MAAM,IAAI,CAClE;IACD,oBAAoB,EAAE,CAAC,GAAW,EAAE,MAAc,EAAE,EAAE,CAAC,CACrD,sDAAsD,GAAG,KAAK,MAAM,GAAG,CACxE;IACD,gBAAgB,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,CAClC,iDAAiD,IAAI,IAAI,CAC1D;CACF,CAAC,CAAC"}

package/dist/sources/oas.d.ts

@@ -0,0 +1,11 @@
+import type { GenerationPlan } from './types';
+import { type InterfaceDefaults } from './planBuilder';
+export declare function isHttpUrl(value: string): boolean;
+export declare function parseDocumentText(raw: string, hintPath?: string): Record<string, unknown>;
+export declare function readLocalDocument(filePath: string): Record<string, unknown>;
+export declare function isOpenApiDocument(doc: Record<string, unknown>): boolean;
+export declare function isDesignerExport(doc: Record<string, unknown>): boolean;
+/**
+ * Load an OpenAPI 3.x file (YAML or JSON) into a GenerationPlan.
+ */
+export declare function loadOasSource(fromPath: string, defaults: InterfaceDefaults): Promise<GenerationPlan>;

package/dist/sources/oas.js

@@ -0,0 +1,75 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadOasSource = exports.isDesignerExport = exports.isOpenApiDocument = exports.readLocalDocument = exports.parseDocumentText = exports.isHttpUrl = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const yaml_1 = require("yaml");
+const types_1 = require("./types");
+const messages_1 = require("./messages");
+const planBuilder_1 = require("./planBuilder");
+function isHttpUrl(value) {
+    return /^https?:\/\//i.test(value.trim());
+}
+exports.isHttpUrl = isHttpUrl;
+function parseDocumentText(raw, hintPath = '') {
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        throw new types_1.SourceResolutionError(messages_1.SOURCE_MESSAGES.INVALID_OAS);
+    }
+    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            const where = hintPath ? ` in ${hintPath}` : '';
+            throw new types_1.SourceResolutionError(`Source resolution failed: invalid JSON${where}: ${detail}`);
+        }
+    }
+    try {
+        return (0, yaml_1.parse)(trimmed);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        const where = hintPath ? ` in ${hintPath}` : '';
+        throw new types_1.SourceResolutionError(`Source resolution failed: invalid YAML${where}: ${detail}`);
+    }
+}
+exports.parseDocumentText = parseDocumentText;
+function readLocalDocument(filePath) {
+    const absolute = node_path_1.default.isAbsolute(filePath) ? filePath : node_path_1.default.resolve(process.cwd(), filePath);
+    if (!node_fs_1.default.existsSync(absolute) || !node_fs_1.default.statSync(absolute).isFile()) {
+        throw new types_1.SourceResolutionError(messages_1.SOURCE_MESSAGES.INVALID_FROM(filePath));
+    }
+    return parseDocumentText(node_fs_1.default.readFileSync(absolute, 'utf8'), absolute);
+}
+exports.readLocalDocument = readLocalDocument;
+function isOpenApiDocument(doc) {
+    const version = String(doc.openapi || '');
+    return version.startsWith('3.') && Boolean(doc.components);
+}
+exports.isOpenApiDocument = isOpenApiDocument;
+function isDesignerExport(doc) {
+    if (doc.kind === 'service-management-suite')
+        return true;
+    if (Array.isArray(doc.domains) && (doc.architecture || doc.relationships || doc.view)) {
+        return true;
+    }
+    return false;
+}
+exports.isDesignerExport = isDesignerExport;
+/**
+ * Load an OpenAPI 3.x file (YAML or JSON) into a GenerationPlan.
+ */
+async function loadOasSource(fromPath, defaults) {
+    const doc = readLocalDocument(fromPath);
+    if (!isOpenApiDocument(doc)) {
+        throw new types_1.SourceResolutionError(messages_1.SOURCE_MESSAGES.INVALID_OAS);
+    }
+    return (0, planBuilder_1.buildPlanFromOasDocument)(doc, defaults);
+}
+exports.loadOasSource = loadOasSource;
+//# sourceMappingURL=oas.js.map

package/dist/sources/oas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oas.js","sourceRoot":"","sources":["../../src/sources/oas.ts"],"names":[],"mappings":"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"}

package/dist/sources/planBuilder.d.ts

@@ -0,0 +1,79 @@
+/// <reference path="../../src/designer-core-shim.d.ts" />
+import { type DbChoice, type GenerationMode, type GenerationPlan, type HttpInterface, type RealtimeInterface } from './types';
+export type InterfaceDefaults = {
+    http: HttpInterface;
+    realtime: RealtimeInterface;
+    db: DbChoice;
+    mode?: string;
+    frontend?: boolean;
+    offline?: boolean;
+};
+type DesignerCore = typeof import('@jumentix/designer-core');
+export declare function loadDesignerCore(): Promise<DesignerCore>;
+export declare function parseHttp(raw: string | undefined, fallback?: HttpInterface): HttpInterface;
+export declare function parseRealtime(raw: string | undefined, fallback?: RealtimeInterface): RealtimeInterface;
+export declare function parseDb(raw: string | undefined, fallback?: DbChoice): DbChoice;
+export declare function inferMode(serviceCount: number, requested: string | undefined, frontend?: boolean): GenerationMode;
+/**
+ * Build a GenerationPlan from a parsed OAS document (+ optional designer domain model).
+ */
+export declare function buildPlanFromOasDocument(oas: Record<string, unknown>, defaults: InterfaceDefaults, imported?: {
+    domains: Array<{
+        id: string;
+        name: string;
+        entities: Array<{
+            id: string;
+            name: string;
+            fields: Array<{
+                name: string;
+                pk?: boolean;
+            }>;
+        }>;
+    }>;
+    architecture?: {
+        services: Array<{
+            id: string;
+            kind: string;
+            url?: string;
+            domains: string[];
+        }>;
+    };
+}): Promise<GenerationPlan>;
+/**
+ * Build a GenerationPlan from a designer suite export / normalised designer state.
+ */
+export declare function buildPlanFromDesignerState(state: {
+    domains: Array<{
+        id: string;
+        name: string;
+        entities: Array<{
+            id: string;
+            name: string;
+            fields: Array<{
+                name: string;
+                pk?: boolean;
+                type?: string;
+            }>;
+            meta?: Record<string, unknown>;
+        }>;
+    }>;
+    relationships?: Array<{
+        id?: string;
+        name?: string;
+        fromEntityId: string;
+        toEntityId: string;
+    }>;
+    architecture?: {
+        services: Array<{
+            id: string;
+            kind: string;
+            url?: string;
+            domains: string[];
+        }>;
+    };
+    interfaces?: Array<{
+        type?: string;
+        framework?: string;
+    }>;
+}, defaults: InterfaceDefaults): Promise<GenerationPlan>;
+export {};

package/dist/sources/planBuilder.js

@@ -0,0 +1,307 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPlanFromDesignerState = exports.buildPlanFromOasDocument = exports.inferMode = exports.parseDb = exports.parseRealtime = exports.parseHttp = exports.loadDesignerCore = void 0;
+/* eslint-disable no-continue */
+const types_1 = require("./types");
+const messages_1 = require("./messages");
+let designerCorePromise;
+async function loadDesignerCore() {
+    if (!designerCorePromise) {
+        designerCorePromise = Promise.resolve().then(() => __importStar(require('@jumentix/designer-core')));
+    }
+    return designerCorePromise;
+}
+exports.loadDesignerCore = loadDesignerCore;
+function parseHttp(raw, fallback = 'express') {
+    const value = (raw || fallback).toLowerCase();
+    if (!types_1.ALLOWED_HTTP.includes(value)) {
+        throw new types_1.SourceResolutionError(messages_1.SOURCE_MESSAGES.UNSUPPORTED_INTERFACE('defaults', 'http', String(raw)));
+    }
+    return value;
+}
+exports.parseHttp = parseHttp;
+function parseRealtime(raw, fallback = 'none') {
+    const value = (raw || fallback).toLowerCase();
+    if (!types_1.ALLOWED_REALTIME.includes(value)) {
+        throw new types_1.SourceResolutionError(messages_1.SOURCE_MESSAGES.UNSUPPORTED_INTERFACE('defaults', 'realtime', String(raw)));
+    }
+    return value;
+}
+exports.parseRealtime = parseRealtime;
+function parseDb(raw, fallback = 'sqlite') {
+    const value = (raw || fallback).toLowerCase();
+    if (!types_1.ALLOWED_DB.includes(value)) {
+        throw new types_1.SourceResolutionError(`Source resolution failed: unsupported --db="${raw}".`);
+    }
+    return value;
+}
+exports.parseDb = parseDb;
+function inferMode(serviceCount, requested, frontend) {
+    if (requested) {
+        const mode = requested.toLowerCase();
+        if (!types_1.ALLOWED_MODES.includes(mode)) {
+            throw new types_1.SourceResolutionError(messages_1.SOURCE_MESSAGES.UNSUPPORTED_MODE(requested));
+        }
+        return mode;
+    }
+    if (frontend)
+        return 'hybrid';
+    return serviceCount <= 1 ? 'monolith' : 'services';
+}
+exports.inferMode = inferMode;
+function isPortObjectSchema(schemaKey, schemaValue) {
+    if (schemaValue['x-port-object'] === true)
+        return true;
+    if (/^Request(Create|Update)/.test(schemaKey))
+        return true;
+    if (/^Response/.test(schemaKey))
+        return true;
+    return false;
+}
+function primaryKeyFromSchema(schemaValue, fields) {
+    const explicit = schemaValue['x-primary-key'];
+    if (typeof explicit === 'string' && explicit.trim())
+        return explicit.trim();
+    const pkField = fields.find((field) => field.pk);
+    if (pkField)
+        return pkField.name;
+    const props = schemaValue.properties && typeof schemaValue.properties === 'object'
+        ? schemaValue.properties
+        : {};
+    if (props.id)
+        return 'id';
+    return '';
+}
+function relationsFromSchema(entityName, schemaValue) {
+    const relations = [];
+    const props = schemaValue.properties && typeof schemaValue.properties === 'object'
+        ? schemaValue.properties
+        : {};
+    for (const [fieldName, fieldSchema] of Object.entries(props)) {
+        const rel = fieldSchema?.['x-relation'];
+        if (!rel || typeof rel !== 'object' || Array.isArray(rel))
+            continue;
+        const target = String(rel.entity || '').trim();
+        if (!target)
+            continue;
+        relations.push({
+            name: `${entityName}.${fieldName}`,
+            entity: target,
+            match: String(rel.match || '').trim() || undefined,
+            display: String(rel.display || '').trim() || undefined,
+            kind: String(rel.kind || '').trim() || undefined,
+            field: fieldName
+        });
+    }
+    return relations;
+}
+function operationsForEntity(oas, entityName, schemaKey) {
+    const operations = [];
+    const paths = (oas.paths && typeof oas.paths === 'object')
+        ? oas.paths
+        : {};
+    const needle = `#/components/schemas/${schemaKey}`;
+    for (const [pathKey, methods] of Object.entries(paths)) {
+        for (const [method, operation] of Object.entries(methods || {})) {
+            if (!operation || typeof operation !== 'object')
+                continue;
+            const blob = JSON.stringify(operation);
+            const tagMatch = Array.isArray(operation.tags)
+                && operation.tags.some((tag) => String(tag).toLowerCase() === entityName.toLowerCase());
+            if (!blob.includes(needle) && !tagMatch)
+                continue;
+            operations.push({
+                operationId: String(operation.operationId || `${method}_${pathKey}`),
+                method: method.toUpperCase(),
+                path: pathKey,
+                summary: typeof operation.summary === 'string' ? operation.summary : undefined
+            });
+        }
+    }
+    return operations;
+}
+function schemaKeyForEntity(schemas, entityName, domainName) {
+    for (const [key, value] of Object.entries(schemas)) {
+        if (isPortObjectSchema(key, value))
+            continue;
+        const xEntity = String(value['x-entity'] || '').trim();
+        const xDomain = String(value['x-domain'] || '').trim();
+        if (xEntity === entityName && (!domainName || !xDomain || xDomain === domainName)) {
+            return key;
+        }
+    }
+    if (schemas[entityName] && !isPortObjectSchema(entityName, schemas[entityName])) {
+        return entityName;
+    }
+    return undefined;
+}
+/**
+ * Build a GenerationPlan from a parsed OAS document (+ optional designer domain model).
+ */
+async function buildPlanFromOasDocument(oas, defaults, imported) {
+    const { filterOasDocumentForService, buildDomainsFromOas } = await loadDesignerCore();
+    const openapi = String(oas.openapi || '');
+    if (!openapi.startsWith('3.') || !oas.components || typeof oas.components !== 'object') {
+        throw new types_1.SourceResolutionError(messages_1.SOURCE_MESSAGES.INVALID_OAS);
+    }
+    const fromImporter = imported || (() => {
+        const result = buildDomainsFromOas(oas);
+        if (!result.ok || !result.domains) {
+            throw new types_1.SourceResolutionError(messages_1.SOURCE_MESSAGES.INVALID_OAS);
+        }
+        return {
+            domains: result.domains,
+            architecture: result.architecture
+        };
+    })();
+    const components = oas.components;
+    const schemas = components.schemas || {};
+    const domains = fromImporter.domains.map((domain) => {
+        const entities = domain.entities.map((entity) => {
+            const schemaKey = schemaKeyForEntity(schemas, entity.name, domain.name) || entity.name;
+            const schemaValue = schemas[schemaKey] || {
+                type: 'object',
+                'x-entity': entity.name,
+                'x-domain': domain.name
+            };
+            const primaryKey = primaryKeyFromSchema(schemaValue, entity.fields || []);
+            return {
+                name: entity.name,
+                schema: schemaValue,
+                primaryKey,
+                relations: relationsFromSchema(entity.name, schemaValue),
+                operations: operationsForEntity(oas, entity.name, schemaKey)
+            };
+        });
+        return {
+            id: domain.id,
+            name: domain.name,
+            entities
+        };
+    });
+    const architectureServices = fromImporter.architecture?.services || [];
+    let services;
+    if (architectureServices.length) {
+        services = architectureServices.map((service) => ({
+            id: service.id,
+            kind: service.kind === 'core' ? 'core' : 'domain',
+            url: service.url,
+            domains: Array.isArray(service.domains) ? [...service.domains] : [],
+            interfaces: {
+                http: defaults.http,
+                realtime: defaults.realtime
+            },
+            db: defaults.db
+        }));
+    }
+    else {
+        services = [{
+                id: 'core',
+                kind: 'core',
+                url: 'http://localhost:3000/api/1.0.0',
+                domains: domains.map((domain) => domain.id),
+                interfaces: { http: defaults.http, realtime: defaults.realtime },
+                db: defaults.db
+            }];
+    }
+    if (services.length === 1 && services[0].domains.length === 0) {
+        services[0].domains = domains.map((domain) => domain.id);
+    }
+    const mode = inferMode(services.length, defaults.mode, defaults.frontend);
+    const oasPerService = {};
+    for (const service of services) {
+        const filtered = filterOasDocumentForService(oas, service.id);
+        oasPerService[service.id] = filtered;
+    }
+    if (Object.keys(oasPerService).length === 0) {
+        oasPerService.core = oas;
+    }
+    const plan = {
+        mode,
+        services,
+        domains,
+        contracts: { oasPerService }
+    };
+    if (defaults.frontend || mode === 'hybrid' || mode === 'frontend') {
+        plan.frontend = {
+            modules: domains.map((domain) => domain.name || domain.id),
+            offline: Boolean(defaults.offline)
+        };
+    }
+    return plan;
+}
+exports.buildPlanFromOasDocument = buildPlanFromOasDocument;
+/**
+ * Build a GenerationPlan from a designer suite export / normalised designer state.
+ */
+async function buildPlanFromDesignerState(state, defaults) {
+    const { buildOasDocumentSet } = await loadDesignerCore();
+    const { merged, services: oasServices } = buildOasDocumentSet(state);
+    const plan = await buildPlanFromOasDocument(merged, defaults, {
+        domains: state.domains,
+        architecture: state.architecture || {
+            services: Object.keys(oasServices || {}).map((id) => ({
+                id,
+                kind: id === 'core' ? 'core' : 'domain',
+                domains: []
+            }))
+        }
+    });
+    const entityById = new Map();
+    for (const domain of plan.domains) {
+        const sourceDomain = state.domains.find((entry) => entry.id === domain.id);
+        for (const entity of domain.entities) {
+            const sourceEntity = sourceDomain?.entities.find((entry) => entry.name === entity.name);
+            if (sourceEntity?.id) {
+                entityById.set(sourceEntity.id, { domainId: domain.id, entity });
+            }
+            if (!entity.primaryKey) {
+                const pk = (sourceEntity?.fields || []).find((field) => field.pk);
+                entity.primaryKey = pk?.name || '';
+            }
+        }
+    }
+    for (const relationship of state.relationships || []) {
+        const from = entityById.get(relationship.fromEntityId);
+        const to = entityById.get(relationship.toEntityId);
+        if (!from || !to)
+            continue;
+        const already = from.entity.relations.some((rel) => rel.entity === to.entity.name);
+        if (already)
+            continue;
+        from.entity.relations.push({
+            name: relationship.name || `${from.entity.name}->${to.entity.name}`,
+            entity: to.entity.name,
+            kind: 'references'
+        });
+    }
+    if (oasServices && typeof oasServices === 'object') {
+        plan.contracts.oasPerService = oasServices;
+    }
+    return plan;
+}
+exports.buildPlanFromDesignerState = buildPlanFromDesignerState;
+//# sourceMappingURL=planBuilder.js.map

package/dist/sources/planBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planBuilder.js","sourceRoot":"","sources":["../../src/sources/planBuilder.ts"],"names":[],"mappings":"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"}

package/dist/sources/preset.d.ts

@@ -0,0 +1,11 @@
+import type { GenerationPlan } from './types';
+import { type InterfaceDefaults } from './planBuilder';
+/**
+ * Resolve the Users preset OAS path.
+ * Prefer `templates/backend/spec/1.0.0.yml` when packaged; else fixtures.
+ */
+export declare function resolveUsersPresetPath(override?: string): string;
+/**
+ * Load the Users preset (`--preset users`) into a GenerationPlan.
+ */
+export declare function loadPresetSource(preset: string, defaults: InterfaceDefaults, presetPath?: string): Promise<GenerationPlan>;

package/dist/sources/preset.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadPresetSource = exports.resolveUsersPresetPath = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const types_1 = require("./types");
+const messages_1 = require("./messages");
+const planBuilder_1 = require("./planBuilder");
+const oas_1 = require("./oas");
+/**
+ * Resolve the Users preset OAS path.
+ * Prefer `templates/backend/spec/1.0.0.yml` when packaged; else fixtures.
+ */
+function resolveUsersPresetPath(override) {
+    if (override) {
+        return node_path_1.default.isAbsolute(override) ? override : node_path_1.default.resolve(process.cwd(), override);
+    }
+    const packageRoot = node_path_1.default.resolve(__dirname, '..', '..');
+    const templateSpec = node_path_1.default.join(packageRoot, 'templates', 'backend', 'spec', '1.0.0.yml');
+    if (node_fs_1.default.existsSync(templateSpec))
+        return templateSpec;
+    const fixture = node_path_1.default.join(packageRoot, 'fixtures', 'users-oas.yml');
+    if (node_fs_1.default.existsSync(fixture))
+        return fixture;
+    throw new types_1.SourceResolutionError('Source resolution failed: Users preset OAS not found under templates/backend/spec or fixtures/.');
+}
+exports.resolveUsersPresetPath = resolveUsersPresetPath;
+/**
+ * Load the Users preset (`--preset users`) into a GenerationPlan.
+ */
+async function loadPresetSource(preset, defaults, presetPath) {
+    const name = (preset || 'users').toLowerCase();
+    if (name !== 'users') {
+        throw new types_1.SourceResolutionError(messages_1.SOURCE_MESSAGES.INVALID_PRESET(preset));
+    }
+    const absolute = resolveUsersPresetPath(presetPath);
+    const doc = (0, oas_1.parseDocumentText)(node_fs_1.default.readFileSync(absolute, 'utf8'), absolute);
+    return (0, planBuilder_1.buildPlanFromOasDocument)(doc, defaults);
+}
+exports.loadPresetSource = loadPresetSource;
+//# sourceMappingURL=preset.js.map

package/dist/sources/preset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.js","sourceRoot":"","sources":["../../src/sources/preset.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AACzB,0DAA6B;AAE7B,mCAAgD;AAChD,yCAA6C;AAC7C,+CAAiF;AACjF,+BAA0C;AAE1C;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,QAAiB;IACtD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,mBAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,WAAW,GAAG,mBAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACzF,IAAI,iBAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,YAAY,CAAC;IAErD,MAAM,OAAO,GAAG,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;IACpE,IAAI,iBAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAE3C,MAAM,IAAI,6BAAqB,CAC7B,iGAAiG,CAClG,CAAC;AACJ,CAAC;AAfD,wDAeC;AAED;;GAEG;AACI,KAAK,UAAU,gBAAgB,CACpC,MAAc,EACd,QAA2B,EAC3B,UAAmB;IAEnB,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/C,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,6BAAqB,CAAC,0BAAe,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,QAAQ,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,IAAA,uBAAiB,EAAC,iBAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC3E,OAAO,IAAA,sCAAwB,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC;AAbD,4CAaC"}

package/dist/sources/resolve.d.ts

@@ -0,0 +1,7 @@
+import type { GenerationPlan, SourceResolveOptions } from './types';
+/**
+ * Resolve `--from` / `--preset` into a validated GenerationPlan.
+ * When `--from` is omitted, defaults to `--preset users`.
+ */
+export declare function resolveSources(options?: SourceResolveOptions): Promise<GenerationPlan>;
+export declare function printPlanSummary(plan: GenerationPlan, log: (message?: string) => void): void;