@jumentix/cli-init 0.0.0

package/dist/legacy/bootstrap.d.ts

@@ -0,0 +1,80 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import type { Readable, Writable } from 'node:stream';
+export declare const BOILERPLATE_REPOSITORY = "https://github.com/web2solutions/Jumentix.git";
+export declare const SERVICE_TYPES: readonly [{
+    readonly id: "rest";
+    readonly label: "HTTP/REST server (OpenAPI/Swagger + static assets)";
+    readonly profile: {
+        readonly interface: "http-rest";
+        readonly staticAssets: true;
+        readonly functions: false;
+    };
+}, {
+    readonly id: "websocket";
+    readonly label: "WebSocket server (+ static assets)";
+    readonly profile: {
+        readonly interface: "websocket";
+        readonly staticAssets: true;
+        readonly functions: false;
+    };
+}, {
+    readonly id: "grpc";
+    readonly label: "gRPC server (+ static assets)";
+    readonly profile: {
+        readonly interface: "grpc";
+        readonly staticAssets: true;
+        readonly functions: false;
+    };
+}, {
+    readonly id: "graphql";
+    readonly label: "GraphQL server (+ static assets)";
+    readonly profile: {
+        readonly interface: "graphql";
+        readonly staticAssets: true;
+        readonly functions: false;
+    };
+}, {
+    readonly id: "functions";
+    readonly label: "Function services bundle (AWS/Google/Azure/Vercel/Cloudflare)";
+    readonly profile: {
+        readonly interface: "functions";
+        readonly staticAssets: false;
+        readonly functions: true;
+    };
+}];
+export type ServiceType = (typeof SERVICE_TYPES)[number];
+export declare function printHelp(log?: (message?: string) => void): void;
+export type LegacyCliArgs = {
+    help: boolean;
+    nonInteractive: boolean;
+    serviceTypeId: string;
+    projectName: string;
+    gitBranch: string;
+    installDeps: boolean | undefined;
+    repository: string;
+};
+export declare function parseCliArgs(argv: string[]): LegacyCliArgs;
+export declare function createPrompt({ input, output }?: {
+    input?: Readable;
+    output?: Writable;
+}): {
+    ask: (question: string) => Promise<string>;
+    close: () => void;
+};
+export declare const GIT_LOCATION_VARIABLES: string[];
+export declare function environmentWithoutRepositoryLocation(env?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function resolveCommandBinary(command: string): string;
+export declare function runCommand(command: string, args: string[], cwd: string): void;
+export declare function toAbsolute(targetPath: string, base?: string): string;
+export declare function ensureTargetFolderIsEmpty(targetPath: string): void;
+export declare function chooseServiceType(ask: (question: string) => Promise<string>, log?: (message?: string) => void): Promise<ServiceType>;
+export declare function resolveServiceTypeById(serviceTypeId: string): ServiceType;
+export declare function writeBootstrapProfile(targetPath: string, payload: Record<string, unknown>): void;
+export declare function run(options?: {
+    argv?: string[];
+    log?: (message?: string) => void;
+    createPrompt?: typeof createPrompt;
+    execute?: typeof runCommand;
+    workingDirectory?: string;
+}): Promise<void>;

package/dist/legacy/bootstrap.js

@@ -0,0 +1,276 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = exports.writeBootstrapProfile = exports.resolveServiceTypeById = exports.chooseServiceType = exports.ensureTargetFolderIsEmpty = exports.toAbsolute = exports.runCommand = exports.resolveCommandBinary = exports.environmentWithoutRepositoryLocation = exports.GIT_LOCATION_VARIABLES = exports.createPrompt = exports.parseCliArgs = exports.printHelp = exports.SERVICE_TYPES = exports.BOILERPLATE_REPOSITORY = void 0;
+/* eslint-disable no-console, no-continue */
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_readline_1 = __importDefault(require("node:readline"));
+const node_child_process_1 = require("node:child_process");
+exports.BOILERPLATE_REPOSITORY = 'https://github.com/web2solutions/Jumentix.git';
+exports.SERVICE_TYPES = [
+    {
+        id: 'rest',
+        label: 'HTTP/REST server (OpenAPI/Swagger + static assets)',
+        profile: { interface: 'http-rest', staticAssets: true, functions: false }
+    },
+    {
+        id: 'websocket',
+        label: 'WebSocket server (+ static assets)',
+        profile: { interface: 'websocket', staticAssets: true, functions: false }
+    },
+    {
+        id: 'grpc',
+        label: 'gRPC server (+ static assets)',
+        profile: { interface: 'grpc', staticAssets: true, functions: false }
+    },
+    {
+        id: 'graphql',
+        label: 'GraphQL server (+ static assets)',
+        profile: { interface: 'graphql', staticAssets: true, functions: false }
+    },
+    {
+        id: 'functions',
+        label: 'Function services bundle (AWS/Google/Azure/Vercel/Cloudflare)',
+        profile: { interface: 'functions', staticAssets: false, functions: true }
+    }
+];
+function printHelp(log = console.log) {
+    log(`
+Jumentix Bootstrap CLI (legacy)
+
+Usage:
+  jumentix-init [options]
+
+Options:
+  --help                         Show this message and exit
+  --non-interactive              Disable prompts (requires --service-type and --project-name)
+  --service-type=<id>            One of: rest, websocket, grpc, graphql, functions
+  --project-name=<name>          Target folder name/path
+  --git-branch=<branch>          Branch to clone (default: dev)
+  --install-deps=<y|n|true|false> Install dependencies after scaffold (default: true)
+  --repo=<git-url>               Override template repository URL
+`);
+}
+exports.printHelp = printHelp;
+function parseCliArgs(argv) {
+    const args = {
+        help: false,
+        nonInteractive: false,
+        serviceTypeId: '',
+        projectName: '',
+        gitBranch: '',
+        installDeps: undefined,
+        repository: ''
+    };
+    for (const rawArg of argv) {
+        if (rawArg === '--help' || rawArg === '-h') {
+            args.help = true;
+            continue;
+        }
+        if (rawArg === '--non-interactive') {
+            args.nonInteractive = true;
+            continue;
+        }
+        if (rawArg.startsWith('--service-type=')) {
+            args.serviceTypeId = rawArg.split('=')[1] || '';
+            continue;
+        }
+        if (rawArg.startsWith('--project-name=')) {
+            args.projectName = rawArg.split('=')[1] || '';
+            continue;
+        }
+        if (rawArg.startsWith('--git-branch=')) {
+            args.gitBranch = rawArg.split('=')[1] || '';
+            continue;
+        }
+        if (rawArg.startsWith('--install-deps=')) {
+            const installDepsRaw = (rawArg.split('=')[1] || '').toLowerCase();
+            args.installDeps = installDepsRaw === 'y'
+                || installDepsRaw === 'yes'
+                || installDepsRaw === 'true'
+                || installDepsRaw === '1';
+            continue;
+        }
+        if (rawArg.startsWith('--repo=')) {
+            args.repository = rawArg.split('=')[1] || '';
+        }
+    }
+    return args;
+}
+exports.parseCliArgs = parseCliArgs;
+function createPrompt({ input = process.stdin, output = process.stdout } = {}) {
+    const rl = node_readline_1.default.createInterface({
+        input: input,
+        output: output
+    });
+    const ask = (question) => new Promise((resolve) => {
+        rl.question(question, (answer) => resolve(String(answer || '').trim()));
+    });
+    return {
+        ask,
+        close: () => rl.close()
+    };
+}
+exports.createPrompt = createPrompt;
+exports.GIT_LOCATION_VARIABLES = [
+    'GIT_DIR',
+    'GIT_WORK_TREE',
+    'GIT_INDEX_FILE',
+    'GIT_OBJECT_DIRECTORY',
+    'GIT_ALTERNATE_OBJECT_DIRECTORIES',
+    'GIT_COMMON_DIR',
+    'GIT_NAMESPACE'
+];
+function environmentWithoutRepositoryLocation(env = process.env) {
+    const copy = { ...env };
+    for (const name of exports.GIT_LOCATION_VARIABLES)
+        delete copy[name];
+    return copy;
+}
+exports.environmentWithoutRepositoryLocation = environmentWithoutRepositoryLocation;
+/**
+ * Absolute resolutions for the commands the legacy bootstrap spawns, instead
+ * of bare names the OS would resolve through PATH — a writable PATH entry
+ * could shadow the binary a credential-adjacent scaffold step runs (CodeQL
+ * javascript:S4036, same rationale as ci-cd/lib/git-binary.js). Fail closed
+ * for anything not on the list: an unknown command is a bug, not something
+ * to PATH-search.
+ */
+function resolveFirstExisting(candidates, name) {
+    for (const candidate of candidates) {
+        if (node_fs_1.default.existsSync(candidate))
+            return candidate;
+    }
+    throw new Error(`Could not resolve "${name}" to an absolute path (looked in: ${candidates.join(', ')}). `
+        + 'This check resolves without PATH on purpose; add the binary location to '
+        + 'RESOLVED_BINARIES in packages/cli-init/src/legacy/bootstrap.ts.');
+}
+const RESOLVED_BINARIES = {
+    git: () => resolveFirstExisting(['/usr/bin/git', '/bin/git'], 'git'),
+    bun: () => process.execPath,
+    node: () => process.execPath
+};
+function resolveCommandBinary(command) {
+    // An absolute path is already resolved — PATH search is the S4036 risk,
+    // and a caller that went to the trouble of an absolute path is not
+    // searching. Only bare names go through the registry below.
+    if (node_path_1.default.isAbsolute(command))
+        return command;
+    const resolve = RESOLVED_BINARIES[command];
+    if (!resolve) {
+        throw new Error(`Refusing to spawn unlisted command "${command}" without an absolute path.`);
+    }
+    return resolve();
+}
+exports.resolveCommandBinary = resolveCommandBinary;
+function runCommand(command, args, cwd) {
+    const result = (0, node_child_process_1.spawnSync)(resolveCommandBinary(command), args, {
+        cwd,
+        stdio: 'inherit',
+        env: environmentWithoutRepositoryLocation()
+    });
+    if (result.status !== 0) {
+        throw new Error(`${command} ${args.join(' ')} failed with exit code ${String(result.status)}`);
+    }
+}
+exports.runCommand = runCommand;
+function toAbsolute(targetPath, base = process.cwd()) {
+    if (node_path_1.default.isAbsolute(targetPath))
+        return targetPath;
+    return node_path_1.default.resolve(base, targetPath);
+}
+exports.toAbsolute = toAbsolute;
+function ensureTargetFolderIsEmpty(targetPath) {
+    if (!node_fs_1.default.existsSync(targetPath))
+        return;
+    const files = node_fs_1.default.readdirSync(targetPath);
+    if (files.length > 0) {
+        throw new Error(`Target folder "${targetPath}" already exists and is not empty.`);
+    }
+}
+exports.ensureTargetFolderIsEmpty = ensureTargetFolderIsEmpty;
+async function chooseServiceType(ask, log = console.log) {
+    log('\nSelect service type:');
+    exports.SERVICE_TYPES.forEach((type, index) => {
+        log(` ${index + 1}. ${type.label}`);
+    });
+    const selected = await ask('Type number: ');
+    const index = Number(selected) - 1;
+    if (!Number.isInteger(index) || index < 0 || index >= exports.SERVICE_TYPES.length) {
+        throw new Error('Invalid service type selection.');
+    }
+    return exports.SERVICE_TYPES[index];
+}
+exports.chooseServiceType = chooseServiceType;
+function resolveServiceTypeById(serviceTypeId) {
+    const found = exports.SERVICE_TYPES.find((serviceType) => serviceType.id === serviceTypeId);
+    if (!found) {
+        throw new Error(`Invalid service type "${serviceTypeId}".`);
+    }
+    return found;
+}
+exports.resolveServiceTypeById = resolveServiceTypeById;
+function writeBootstrapProfile(targetPath, payload) {
+    const configDir = node_path_1.default.join(targetPath, '.jumentix');
+    node_fs_1.default.mkdirSync(configDir, { recursive: true });
+    const outputPath = node_path_1.default.join(configDir, 'service-profile.json');
+    node_fs_1.default.writeFileSync(outputPath, `${JSON.stringify(payload, null, 2)}\n`, 'utf8');
+}
+exports.writeBootstrapProfile = writeBootstrapProfile;
+async function run(options = {}) {
+    const { argv = process.argv.slice(2), log = console.log, createPrompt: makePrompt = createPrompt, execute = runCommand, workingDirectory = process.cwd() } = options;
+    const cliArgs = parseCliArgs(argv);
+    if (cliArgs.help) {
+        printHelp(log);
+        return;
+    }
+    if (cliArgs.nonInteractive && (!cliArgs.serviceTypeId || !cliArgs.projectName)) {
+        throw new Error('Non-interactive mode requires --service-type and --project-name.');
+    }
+    const prompt = cliArgs.nonInteractive
+        ? { ask: async () => '', close: () => undefined }
+        : makePrompt();
+    try {
+        log('\nJumentix Bootstrap CLI');
+        const serviceType = cliArgs.serviceTypeId
+            ? resolveServiceTypeById(cliArgs.serviceTypeId)
+            : await chooseServiceType(prompt.ask, log);
+        const projectName = cliArgs.projectName || await prompt.ask('Project folder name (e.g. my-service): ');
+        if (!projectName)
+            throw new Error('Project folder name is required.');
+        const targetPath = toAbsolute(projectName, workingDirectory);
+        ensureTargetFolderIsEmpty(targetPath);
+        const gitBranch = cliArgs.gitBranch
+            || (await prompt.ask('Git branch to clone (default: dev): '))
+            || 'dev';
+        const installDeps = typeof cliArgs.installDeps === 'boolean'
+            ? cliArgs.installDeps
+            : (((await prompt.ask('Run bun install after scaffold? (Y/n): ')) || 'y').toLowerCase() !== 'n');
+        const repository = cliArgs.repository || exports.BOILERPLATE_REPOSITORY;
+        log('\nCloning boilerplate repository...');
+        execute('git', ['clone', '--branch', gitBranch, '--', repository, projectName], workingDirectory);
+        writeBootstrapProfile(targetPath, {
+            generatedAt: new Date().toISOString(),
+            template: 'jumentix',
+            repository,
+            branch: gitBranch,
+            serviceType: serviceType.id,
+            profile: serviceType.profile
+        });
+        if (installDeps) {
+            log('\nInstalling dependencies...');
+            execute('bun', ['install'], targetPath);
+        }
+        log('\nScaffold completed successfully.');
+        log(`Project path: ${targetPath}`);
+        log(`Profile: ${node_path_1.default.join(targetPath, '.jumentix', 'service-profile.json')}`);
+    }
+    finally {
+        prompt.close();
+    }
+}
+exports.run = run;
+//# sourceMappingURL=bootstrap.js.map

package/dist/legacy/bootstrap.js.map

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

package/dist/prompt.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="node" />
+import type { Readable, Writable } from 'node:stream';
+export type Prompt = {
+    ask: (question: string) => Promise<string>;
+    confirm: (question: string, defaultYes?: boolean) => Promise<boolean>;
+    select: <T extends string>(question: string, choices: Array<{
+        id: T;
+        label: string;
+    }>) => Promise<T>;
+    close: () => void;
+};
+/**
+ * readline over injectable streams — no heavy TUI dependency (Req 037 / JUM-844).
+ */
+export declare function createPrompt({ input, output }?: {
+    input?: Readable;
+    output?: Writable;
+}): Prompt;

package/dist/prompt.js

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPrompt = void 0;
+const node_readline_1 = __importDefault(require("node:readline"));
+/**
+ * readline over injectable streams — no heavy TUI dependency (Req 037 / JUM-844).
+ */
+function createPrompt({ input = process.stdin, output = process.stdout } = {}) {
+    const rl = node_readline_1.default.createInterface({
+        input: input,
+        output: output
+    });
+    const ask = (question) => new Promise((resolve) => {
+        rl.question(question, (answer) => resolve(String(answer || '').trim()));
+    });
+    const confirm = async (question, defaultYes = true) => {
+        const hint = defaultYes ? 'Y/n' : 'y/N';
+        const answer = (await ask(`${question} (${hint}): `)).toLowerCase();
+        if (!answer)
+            return defaultYes;
+        return answer === 'y' || answer === 'yes';
+    };
+    const select = async (question, choices) => {
+        if (choices.length === 0) {
+            throw new Error('select requires at least one choice.');
+        }
+        // eslint-disable-next-line no-console
+        console.log(`\n${question}`);
+        choices.forEach((choice, index) => {
+            // eslint-disable-next-line no-console
+            console.log(` ${index + 1}. ${choice.label}`);
+        });
+        const selected = await ask('Type number: ');
+        const index = Number(selected) - 1;
+        if (!Number.isInteger(index) || index < 0 || index >= choices.length) {
+            throw new Error(`Invalid selection "${selected}".`);
+        }
+        return choices[index].id;
+    };
+    return {
+        ask,
+        confirm,
+        select,
+        close: () => rl.close()
+    };
+}
+exports.createPrompt = createPrompt;
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":";;;;;;AAAA,kEAAqC;AAarC;;GAEG;AACH,SAAgB,YAAY,CAAC,EAC3B,KAAK,GAAG,OAAO,CAAC,KAAK,EACrB,MAAM,GAAG,OAAO,CAAC,MAAM,KAIrB,EAAE;IACJ,MAAM,EAAE,GAAG,uBAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,KAAY;QACnB,MAAM,EAAE,MAAa;KACtB,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,CAAC,QAAgB,EAAmB,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QACzE,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,KAAK,EAAE,QAAgB,EAAE,UAAU,GAAG,IAAI,EAAoB,EAAE;QAC9E,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QACxC,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,GAAG,QAAQ,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACpE,IAAI,CAAC,MAAM;YAAE,OAAO,UAAU,CAAC;QAC/B,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,KAAK,CAAC;IAC5C,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,KAAK,EAClB,QAAgB,EAChB,OAAwC,EAC5B,EAAE;QACd,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;QAC7B,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;YAChC,sCAAsC;YACtC,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,IAAI,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IAC3B,CAAC,CAAC;IAEF,OAAO;QACL,GAAG;QACH,OAAO;QACP,MAAM;QACN,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE;KACxB,CAAC;AACJ,CAAC;AAlDD,oCAkDC"}

package/dist/sources/catalog.d.ts

@@ -0,0 +1,7 @@
+import type { GenerationPlan } from './types';
+import { type InterfaceDefaults } from './planBuilder';
+/**
+ * Fetch a catalog URL and normalize the payload to a GenerationPlan.
+ * Accepts OpenAPI documents or designer suite exports.
+ */
+export declare function loadCatalogSource(url: string, defaults: InterfaceDefaults, fetchImpl?: typeof fetch): Promise<GenerationPlan>;

package/dist/sources/catalog.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadCatalogSource = void 0;
+const types_1 = require("./types");
+const messages_1 = require("./messages");
+const planBuilder_1 = require("./planBuilder");
+const designerExport_1 = require("./designerExport");
+const oas_1 = require("./oas");
+/**
+ * Fetch a catalog URL and normalize the payload to a GenerationPlan.
+ * Accepts OpenAPI documents or designer suite exports.
+ */
+async function loadCatalogSource(url, defaults, fetchImpl = fetch) {
+    if (!(0, oas_1.isHttpUrl)(url)) {
+        throw new types_1.SourceResolutionError(messages_1.SOURCE_MESSAGES.INVALID_FROM(url));
+    }
+    let response;
+    try {
+        response = await fetchImpl(url, {
+            headers: { Accept: 'application/json, application/yaml, text/yaml, */*' }
+        });
+    }
+    catch (error) {
+        throw new types_1.SourceResolutionError(messages_1.SOURCE_MESSAGES.CATALOG_FETCH_FAILED(url, error instanceof Error ? error.message : String(error)));
+    }
+    if (!response.ok) {
+        throw new types_1.SourceResolutionError(messages_1.SOURCE_MESSAGES.CATALOG_FETCH_FAILED(url, `HTTP ${response.status}`));
+    }
+    const text = await response.text();
+    const doc = (0, oas_1.parseDocumentText)(text, url);
+    if ((0, oas_1.isDesignerExport)(doc)) {
+        return (0, designerExport_1.planFromDesignerDocument)(doc, defaults);
+    }
+    if ((0, oas_1.isOpenApiDocument)(doc)) {
+        return (0, planBuilder_1.buildPlanFromOasDocument)(doc, defaults);
+    }
+    throw new types_1.SourceResolutionError(messages_1.SOURCE_MESSAGES.CATALOG_FETCH_FAILED(url, 'payload is neither OAS nor designer export'));
+}
+exports.loadCatalogSource = loadCatalogSource;
+//# sourceMappingURL=catalog.js.map

package/dist/sources/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/sources/catalog.ts"],"names":[],"mappings":";;;AACA,mCAAgD;AAChD,yCAA6C;AAC7C,+CAGuB;AACvB,qDAA4D;AAC5D,+BAKe;AAEf;;;GAGG;AACI,KAAK,UAAU,iBAAiB,CACrC,GAAW,EACX,QAA2B,EAC3B,YAA0B,KAAK;IAE/B,IAAI,CAAC,IAAA,eAAS,EAAC,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,6BAAqB,CAAC,0BAAe,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;YAC9B,OAAO,EAAE,EAAE,MAAM,EAAE,oDAAoD,EAAE;SAC1E,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,6BAAqB,CAC7B,0BAAe,CAAC,oBAAoB,CAClC,GAAG,EACH,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,6BAAqB,CAC7B,0BAAe,CAAC,oBAAoB,CAAC,GAAG,EAAE,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC,CACrE,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,GAAG,GAAG,IAAA,uBAAiB,EAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAEzC,IAAI,IAAA,sBAAgB,EAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAA,yCAAwB,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,IAAA,uBAAiB,EAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAA,sCAAwB,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,IAAI,6BAAqB,CAC7B,0BAAe,CAAC,oBAAoB,CAAC,GAAG,EAAE,4CAA4C,CAAC,CACxF,CAAC;AACJ,CAAC;AA1CD,8CA0CC"}

package/dist/sources/designerExport.d.ts

@@ -0,0 +1,10 @@
+import type { GenerationPlan } from './types';
+import { type InterfaceDefaults } from './planBuilder';
+/**
+ * Load a designer suite export JSON into a GenerationPlan.
+ */
+export declare function loadDesignerExportSource(fromPath: string, defaults: InterfaceDefaults): Promise<GenerationPlan>;
+/**
+ * Build a plan from an already-parsed designer export document (tests / catalog).
+ */
+export declare function planFromDesignerDocument(doc: Record<string, unknown>, defaults: InterfaceDefaults): Promise<GenerationPlan>;

package/dist/sources/designerExport.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planFromDesignerDocument = exports.loadDesignerExportSource = void 0;
+const types_1 = require("./types");
+const messages_1 = require("./messages");
+const planBuilder_1 = require("./planBuilder");
+const oas_1 = require("./oas");
+/**
+ * Load a designer suite export JSON into a GenerationPlan.
+ */
+async function loadDesignerExportSource(fromPath, defaults) {
+    const doc = (0, oas_1.readLocalDocument)(fromPath);
+    if (!(0, oas_1.isDesignerExport)(doc)) {
+        throw new types_1.SourceResolutionError(messages_1.SOURCE_MESSAGES.INVALID_DESIGNER_EXPORT('not a designer suite export'));
+    }
+    const { buildStateFromSuiteExport } = await (0, planBuilder_1.loadDesignerCore)();
+    const imported = buildStateFromSuiteExport(doc);
+    if (!imported.ok) {
+        throw new types_1.SourceResolutionError(messages_1.SOURCE_MESSAGES.INVALID_DESIGNER_EXPORT(String(imported.reason || 'import-failed')));
+    }
+    return (0, planBuilder_1.buildPlanFromDesignerState)(imported.state, defaults);
+}
+exports.loadDesignerExportSource = loadDesignerExportSource;
+/**
+ * Build a plan from an already-parsed designer export document (tests / catalog).
+ */
+async function planFromDesignerDocument(doc, defaults) {
+    if (!(0, oas_1.isDesignerExport)(doc)) {
+        throw new types_1.SourceResolutionError(messages_1.SOURCE_MESSAGES.INVALID_DESIGNER_EXPORT('not a designer suite export'));
+    }
+    const { buildStateFromSuiteExport } = await (0, planBuilder_1.loadDesignerCore)();
+    const imported = buildStateFromSuiteExport(doc);
+    if (!imported.ok) {
+        throw new types_1.SourceResolutionError(messages_1.SOURCE_MESSAGES.INVALID_DESIGNER_EXPORT(String(imported.reason || 'import-failed')));
+    }
+    return (0, planBuilder_1.buildPlanFromDesignerState)(imported.state, defaults);
+}
+exports.planFromDesignerDocument = planFromDesignerDocument;
+//# sourceMappingURL=designerExport.js.map

package/dist/sources/designerExport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"designerExport.js","sourceRoot":"","sources":["../../src/sources/designerExport.ts"],"names":[],"mappings":";;;AACA,mCAAgD;AAChD,yCAA6C;AAC7C,+CAIuB;AACvB,+BAA4D;AAE5D;;GAEG;AACI,KAAK,UAAU,wBAAwB,CAC5C,QAAgB,EAChB,QAA2B;IAE3B,MAAM,GAAG,GAAG,IAAA,uBAAiB,EAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,IAAA,sBAAgB,EAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,6BAAqB,CAC7B,0BAAe,CAAC,uBAAuB,CAAC,6BAA6B,CAAC,CACvE,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,yBAAyB,EAAE,GAAG,MAAM,IAAA,8BAAgB,GAAE,CAAC;IAC/D,MAAM,QAAQ,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,6BAAqB,CAC7B,0BAAe,CAAC,uBAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC,CACpF,CAAC;IACJ,CAAC;IAED,OAAO,IAAA,wCAA0B,EAC/B,QAAQ,CAAC,KAAyD,EAClE,QAAQ,CACT,CAAC;AACJ,CAAC;AAvBD,4DAuBC;AAED;;GAEG;AACI,KAAK,UAAU,wBAAwB,CAC5C,GAA4B,EAC5B,QAA2B;IAE3B,IAAI,CAAC,IAAA,sBAAgB,EAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,6BAAqB,CAC7B,0BAAe,CAAC,uBAAuB,CAAC,6BAA6B,CAAC,CACvE,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,yBAAyB,EAAE,GAAG,MAAM,IAAA,8BAAgB,GAAE,CAAC;IAC/D,MAAM,QAAQ,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,6BAAqB,CAC7B,0BAAe,CAAC,uBAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC,CACpF,CAAC;IACJ,CAAC;IACD,OAAO,IAAA,wCAA0B,EAC/B,QAAQ,CAAC,KAAyD,EAClE,QAAQ,CACT,CAAC;AACJ,CAAC;AApBD,4DAoBC"}

package/dist/sources/index.d.ts

@@ -0,0 +1,10 @@
+export type { GenerationPlan, GenerationMode, PlanService, PlanDomain, PlanEntity, EntityRelation, EntityOperation, SourceResolveOptions, HttpInterface, RealtimeInterface, DbChoice, ServiceKind } from './types';
+export { ALLOWED_HTTP, ALLOWED_REALTIME, ALLOWED_DB, ALLOWED_MODES, SourceResolutionError } from './types';
+export { SOURCE_MESSAGES } from './messages';
+export { validateGenerationPlan } from './validate';
+export { resolveSources, printPlanSummary } from './resolve';
+export { loadOasSource, isOpenApiDocument, isDesignerExport, readLocalDocument } from './oas';
+export { loadDesignerExportSource, planFromDesignerDocument } from './designerExport';
+export { loadCatalogSource } from './catalog';
+export { loadPresetSource, resolveUsersPresetPath } from './preset';
+export { buildPlanFromOasDocument, buildPlanFromDesignerState, inferMode } from './planBuilder';

package/dist/sources/index.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inferMode = exports.buildPlanFromDesignerState = exports.buildPlanFromOasDocument = exports.resolveUsersPresetPath = exports.loadPresetSource = exports.loadCatalogSource = exports.planFromDesignerDocument = exports.loadDesignerExportSource = exports.readLocalDocument = exports.isDesignerExport = exports.isOpenApiDocument = exports.loadOasSource = exports.printPlanSummary = exports.resolveSources = exports.validateGenerationPlan = exports.SOURCE_MESSAGES = exports.SourceResolutionError = exports.ALLOWED_MODES = exports.ALLOWED_DB = exports.ALLOWED_REALTIME = exports.ALLOWED_HTTP = void 0;
+var types_1 = require("./types");
+Object.defineProperty(exports, "ALLOWED_HTTP", { enumerable: true, get: function () { return types_1.ALLOWED_HTTP; } });
+Object.defineProperty(exports, "ALLOWED_REALTIME", { enumerable: true, get: function () { return types_1.ALLOWED_REALTIME; } });
+Object.defineProperty(exports, "ALLOWED_DB", { enumerable: true, get: function () { return types_1.ALLOWED_DB; } });
+Object.defineProperty(exports, "ALLOWED_MODES", { enumerable: true, get: function () { return types_1.ALLOWED_MODES; } });
+Object.defineProperty(exports, "SourceResolutionError", { enumerable: true, get: function () { return types_1.SourceResolutionError; } });
+var messages_1 = require("./messages");
+Object.defineProperty(exports, "SOURCE_MESSAGES", { enumerable: true, get: function () { return messages_1.SOURCE_MESSAGES; } });
+var validate_1 = require("./validate");
+Object.defineProperty(exports, "validateGenerationPlan", { enumerable: true, get: function () { return validate_1.validateGenerationPlan; } });
+var resolve_1 = require("./resolve");
+Object.defineProperty(exports, "resolveSources", { enumerable: true, get: function () { return resolve_1.resolveSources; } });
+Object.defineProperty(exports, "printPlanSummary", { enumerable: true, get: function () { return resolve_1.printPlanSummary; } });
+var oas_1 = require("./oas");
+Object.defineProperty(exports, "loadOasSource", { enumerable: true, get: function () { return oas_1.loadOasSource; } });
+Object.defineProperty(exports, "isOpenApiDocument", { enumerable: true, get: function () { return oas_1.isOpenApiDocument; } });
+Object.defineProperty(exports, "isDesignerExport", { enumerable: true, get: function () { return oas_1.isDesignerExport; } });
+Object.defineProperty(exports, "readLocalDocument", { enumerable: true, get: function () { return oas_1.readLocalDocument; } });
+var designerExport_1 = require("./designerExport");
+Object.defineProperty(exports, "loadDesignerExportSource", { enumerable: true, get: function () { return designerExport_1.loadDesignerExportSource; } });
+Object.defineProperty(exports, "planFromDesignerDocument", { enumerable: true, get: function () { return designerExport_1.planFromDesignerDocument; } });
+var catalog_1 = require("./catalog");
+Object.defineProperty(exports, "loadCatalogSource", { enumerable: true, get: function () { return catalog_1.loadCatalogSource; } });
+var preset_1 = require("./preset");
+Object.defineProperty(exports, "loadPresetSource", { enumerable: true, get: function () { return preset_1.loadPresetSource; } });
+Object.defineProperty(exports, "resolveUsersPresetPath", { enumerable: true, get: function () { return preset_1.resolveUsersPresetPath; } });
+var planBuilder_1 = require("./planBuilder");
+Object.defineProperty(exports, "buildPlanFromOasDocument", { enumerable: true, get: function () { return planBuilder_1.buildPlanFromOasDocument; } });
+Object.defineProperty(exports, "buildPlanFromDesignerState", { enumerable: true, get: function () { return planBuilder_1.buildPlanFromDesignerState; } });
+Object.defineProperty(exports, "inferMode", { enumerable: true, get: function () { return planBuilder_1.inferMode; } });
+//# sourceMappingURL=index.js.map

package/dist/sources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":";;;AAcA,iCAMiB;AALf,qGAAA,YAAY,OAAA;AACZ,yGAAA,gBAAgB,OAAA;AAChB,mGAAA,UAAU,OAAA;AACV,sGAAA,aAAa,OAAA;AACb,8GAAA,qBAAqB,OAAA;AAEvB,uCAA6C;AAApC,2GAAA,eAAe,OAAA;AACxB,uCAAoD;AAA3C,kHAAA,sBAAsB,OAAA;AAC/B,qCAA6D;AAApD,yGAAA,cAAc,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AACzC,6BAKe;AAJb,oGAAA,aAAa,OAAA;AACb,wGAAA,iBAAiB,OAAA;AACjB,uGAAA,gBAAgB,OAAA;AAChB,wGAAA,iBAAiB,OAAA;AAEnB,mDAAsF;AAA7E,0HAAA,wBAAwB,OAAA;AAAE,0HAAA,wBAAwB,OAAA;AAC3D,qCAA8C;AAArC,4GAAA,iBAAiB,OAAA;AAC1B,mCAAoE;AAA3D,0GAAA,gBAAgB,OAAA;AAAE,gHAAA,sBAAsB,OAAA;AACjD,6CAIuB;AAHrB,uHAAA,wBAAwB,OAAA;AACxB,yHAAA,0BAA0B,OAAA;AAC1B,wGAAA,SAAS,OAAA"}

package/dist/sources/messages.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Named validation / resolution messages (exit code 1). Keep stable for tests and docs.
+ */
+export declare const SOURCE_MESSAGES: Readonly<{
+    NO_CORE_SERVICE: "GenerationPlan validation failed: no core service.";
+    ENTITY_WITHOUT_PRIMARY_KEY: (entityName: string, domainId: string) => string;
+    RELATION_CROSSING_BOUNDARY: (relationName: string, fromService: string, toService: string) => string;
+    UNSUPPORTED_INTERFACE: (serviceId: string, kind: 'http' | 'realtime', value: string) => string;
+    DUPLICATE_ENTITY_NAMES: (entityName: string, domainA: string, domainB: string) => string;
+    INVALID_FROM: (from: string) => string;
+    INVALID_PRESET: (preset: string) => string;
+    INVALID_OAS: "Source resolution failed: document is not a valid OpenAPI 3.x object with components.schemas.";
+    INVALID_DESIGNER_EXPORT: (reason: string) => string;
+    CATALOG_FETCH_FAILED: (url: string, detail: string) => string;
+    UNSUPPORTED_MODE: (mode: string) => string;
+}>;