ts-procedures 5.5.0 → 5.6.0-beta.1

package/build/codegen/emit-types.js

@@ -0,0 +1,40 @@
+let ajscValidated = false;
+async function validateAjscFormat() {
+    if (ajscValidated)
+        return;
+    ajscValidated = true;
+    const { TypescriptConverter } = await import('ajsc');
+    const probe = new TypescriptConverter({ type: 'string' }, { inlineTypes: true });
+    const probeCode = probe.code.trim();
+    if (probeCode !== 'string') {
+        console.warn(`[ts-procedures-codegen] ajsc output format may have changed. Expected "string" for { type: "string" }, got: "${probeCode}"`);
+    }
+}
+/**
+ * Converts a JSON Schema to a TypeScript type string using ajsc.
+ *
+ * Returns `export type ${typeName} = ${code}` where code is the inline type
+ * body from TypescriptConverter with inlineTypes: true.
+ *
+ * Returns undefined for undefined or null schema.
+ */
+export async function jsonSchemaToTypeString(typeName, schema, options) {
+    if (schema == null)
+        return undefined;
+    await validateAjscFormat();
+    const { TypescriptConverter } = await import('ajsc');
+    const converter = new TypescriptConverter(schema, {
+        ...options,
+        inlineTypes: true,
+    });
+    let code = converter.code.trim();
+    if (!code) {
+        throw new Error(`[ts-procedures-codegen] ajsc produced empty output for type "${typeName}". Schema: ${JSON.stringify(schema)}`);
+    }
+    // Strip any 'export type X = ' or 'type X = ' prefix ajsc might add
+    code = code.replace(/^(?:export\s+)?type\s+\w+\s*=\s*/, '');
+    // Remove trailing semicolons and newlines
+    code = code.replace(/;\s*$/, '').trim();
+    return `export type ${typeName} = ${code}`;
+}
+//# sourceMappingURL=emit-types.js.map

package/build/codegen/emit-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-types.js","sourceRoot":"","sources":["../../src/codegen/emit-types.ts"],"names":[],"mappings":"AAMA,IAAI,aAAa,GAAG,KAAK,CAAA;AACzB,KAAK,UAAU,kBAAkB;IAC/B,IAAI,aAAa;QAAE,OAAM;IACzB,aAAa,GAAG,IAAI,CAAA;IACpB,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAA;IACpD,MAAM,KAAK,GAAG,IAAI,mBAAmB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAA;IAChF,MAAM,SAAS,GAAI,KAAK,CAAC,IAAe,CAAC,IAAI,EAAE,CAAA;IAC/C,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,gHAAgH,SAAS,GAAG,CAAC,CAAA;IAC5I,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAgB,EAChB,MAA2C,EAC3C,OAAqB;IAErB,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,SAAS,CAAA;IAEpC,MAAM,kBAAkB,EAAE,CAAA;IAE1B,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAA;IAEpD,MAAM,SAAS,GAAG,IAAI,mBAAmB,CAAC,MAAiC,EAAE;QAC3E,GAAG,OAAO;QACV,WAAW,EAAE,IAAI;KAClB,CAAC,CAAA;IAEF,IAAI,IAAI,GAAI,SAAS,CAAC,IAAe,CAAC,IAAI,EAAE,CAAA;IAC5C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,gEAAgE,QAAQ,cAAc,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAC/G,CAAA;IACH,CAAC;IACD,oEAAoE;IACpE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,kCAAkC,EAAE,EAAE,CAAC,CAAA;IAC3D,0CAA0C;IAC1C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAEvC,OAAO,eAAe,QAAQ,MAAM,IAAI,EAAE,CAAA;AAC5C,CAAC"}

package/build/codegen/emit-types.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/codegen/emit-types.test.js

@@ -0,0 +1,82 @@
+import { describe, expect, it, vi } from 'vitest';
+import { jsonSchemaToTypeString } from './emit-types.js';
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('jsonSchemaToTypeString', () => {
+    it('converts a simple object schema with required fields', async () => {
+        const schema = {
+            type: 'object',
+            properties: {
+                id: { type: 'string' },
+            },
+            required: ['id'],
+        };
+        const result = await jsonSchemaToTypeString('MyType', schema);
+        expect(result).toBe('export type MyType = { id: string; }');
+    });
+    it('includes optional marker for non-required fields', async () => {
+        const schema = {
+            type: 'object',
+            properties: {
+                id: { type: 'string' },
+                name: { type: 'string' },
+            },
+            required: ['id'],
+        };
+        const result = await jsonSchemaToTypeString('User', schema);
+        expect(result).toBe('export type User = { id: string; name?: string; }');
+    });
+    it('converts a string enum schema', async () => {
+        const schema = {
+            type: 'string',
+            enum: ['a', 'b'],
+        };
+        const result = await jsonSchemaToTypeString('Status', schema);
+        expect(result).toBe('export type Status = "a" | "b"');
+    });
+    it('converts a plain string schema', async () => {
+        const schema = { type: 'string' };
+        const result = await jsonSchemaToTypeString('Id', schema);
+        expect(result).toBe('export type Id = string');
+    });
+    it('returns undefined for undefined schema', async () => {
+        const result = await jsonSchemaToTypeString('Missing', undefined);
+        expect(result).toBeUndefined();
+    });
+    it('uses the typeName in the export statement', async () => {
+        const schema = { type: 'number' };
+        const result = await jsonSchemaToTypeString('Count', schema);
+        expect(result).toMatch(/^export type Count = /);
+    });
+    it('handles already-clean inline output', async () => {
+        // Existing schemas still work — no regression
+        const schema = {
+            type: 'object',
+            properties: { id: { type: 'string' } },
+            required: ['id'],
+        };
+        const result = await jsonSchemaToTypeString('MyType', schema);
+        expect(result).toBe('export type MyType = { id: string; }');
+    });
+    it('strips "export type Root = " prefix and does not double-wrap', async () => {
+        vi.resetModules();
+        vi.doMock('ajsc', () => ({
+            TypescriptConverter: class {
+                code;
+                constructor(_schema, _opts) {
+                    this.code = '\n\nexport type Root = { id: string; };\n';
+                }
+            },
+        }));
+        const { jsonSchemaToTypeString: fn } = await import('./emit-types.js');
+        const result = await fn('MyType', { type: 'object', properties: { id: { type: 'string' } }, required: ['id'] });
+        // Should be the clean body, not double-wrapped
+        expect(result).toBe('export type MyType = { id: string; }');
+        expect(result).not.toContain('export type Root');
+        expect(result).not.toContain('export type MyType = export type');
+        vi.doUnmock('ajsc');
+        vi.resetModules();
+    });
+});
+//# sourceMappingURL=emit-types.test.js.map

package/build/codegen/emit-types.test.js.map

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

package/build/codegen/group-routes.d.ts

@@ -0,0 +1,23 @@
+import type { AnyHttpRouteDoc } from '../implementations/types.js';
+export interface ScopeGroup {
+    scopeKey: string;
+    camelCase: string;
+    routes: AnyHttpRouteDoc[];
+}
+/**
+ * Normalizes a scope value to a string key:
+ * - string   → returned as-is
+ * - string[] → joined with '-'
+ * - undefined → 'default'
+ */
+export declare function normalizeScope(scope: string | string[] | undefined): string;
+/**
+ * Converts a hyphenated scope key to camelCase.
+ * e.g. 'admin-users' → 'adminUsers', 'users' → 'users'
+ */
+export declare function scopeToCamelCase(scope: string): string;
+/**
+ * Groups an array of route docs into a Map keyed by normalized scope.
+ * Routes without a scope emit a console.warn and are grouped under 'default'.
+ */
+export declare function groupRoutesByScope(routes: AnyHttpRouteDoc[]): Map<string, ScopeGroup>;

package/build/codegen/group-routes.js

@@ -0,0 +1,46 @@
+/**
+ * Normalizes a scope value to a string key:
+ * - string   → returned as-is
+ * - string[] → joined with '-'
+ * - undefined → 'default'
+ */
+export function normalizeScope(scope) {
+    if (scope === undefined)
+        return 'default';
+    if (Array.isArray(scope))
+        return scope.join('-');
+    return scope;
+}
+/**
+ * Converts a hyphenated scope key to camelCase.
+ * e.g. 'admin-users' → 'adminUsers', 'users' → 'users'
+ */
+export function scopeToCamelCase(scope) {
+    const parts = scope.split('-');
+    return parts
+        .map((part, index) => index === 0 ? part : part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+}
+/**
+ * Groups an array of route docs into a Map keyed by normalized scope.
+ * Routes without a scope emit a console.warn and are grouped under 'default'.
+ */
+export function groupRoutesByScope(routes) {
+    const groups = new Map();
+    for (const route of routes) {
+        const rawScope = 'scope' in route ? route.scope : undefined;
+        if (rawScope === undefined) {
+            console.warn(`[ts-procedures] Route "${route.name}" has no scope — it will be grouped under "default".`);
+        }
+        const scopeKey = normalizeScope(rawScope);
+        const camelCase = scopeToCamelCase(scopeKey);
+        let group = groups.get(scopeKey);
+        if (group === undefined) {
+            group = { scopeKey, camelCase, routes: [] };
+            groups.set(scopeKey, group);
+        }
+        group.routes.push(route);
+    }
+    return groups;
+}
+//# sourceMappingURL=group-routes.js.map

package/build/codegen/group-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-routes.js","sourceRoot":"","sources":["../../src/codegen/group-routes.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAoC;IACjE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACzC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAChD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC9B,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACnB,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAClE;SACA,IAAI,CAAC,EAAE,CAAC,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAyB;IAC1D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAA;IAE5C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,OAAO,IAAI,KAAK,CAAC,CAAC,CAAE,KAAuC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;QAC9F,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CACV,0BAA0B,KAAK,CAAC,IAAI,sDAAsD,CAC3F,CAAA;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;QACzC,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QAE5C,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,KAAK,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;YAC3C,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QAC7B,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC1B,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/build/codegen/group-routes.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/codegen/group-routes.test.js

@@ -0,0 +1,131 @@
+import { describe, expect, it, vi, beforeEach, afterEach } from 'vitest';
+import { normalizeScope, scopeToCamelCase, groupRoutesByScope } from './group-routes.js';
+// ---------------------------------------------------------------------------
+// Fixtures
+// ---------------------------------------------------------------------------
+const rpcRouteUsers = {
+    kind: 'rpc',
+    name: 'GetUser',
+    path: '/users/1',
+    method: 'post',
+    scope: 'users',
+    version: 1,
+    jsonSchema: {},
+};
+const rpcRouteAdmin = {
+    kind: 'rpc',
+    name: 'DeleteUser',
+    path: '/admin-users/1',
+    method: 'post',
+    scope: ['admin', 'users'],
+    version: 1,
+    jsonSchema: {},
+};
+const rpcRouteUsers2 = {
+    kind: 'rpc',
+    name: 'ListUsers',
+    path: '/users/1',
+    method: 'post',
+    scope: 'users',
+    version: 1,
+    jsonSchema: {},
+};
+const apiRouteNoScope = {
+    kind: 'api',
+    name: 'HealthCheck',
+    path: '/health',
+    method: 'get',
+    fullPath: '/api/health',
+    jsonSchema: {},
+};
+const apiRouteWithScope = {
+    kind: 'api',
+    name: 'ListPosts',
+    path: '/posts',
+    method: 'get',
+    fullPath: '/api/posts',
+    scope: 'posts',
+    jsonSchema: {},
+};
+// ---------------------------------------------------------------------------
+// normalizeScope
+// ---------------------------------------------------------------------------
+describe('normalizeScope', () => {
+    it('returns a string scope as-is', () => {
+        expect(normalizeScope('users')).toBe('users');
+    });
+    it('joins a string array scope with hyphens', () => {
+        expect(normalizeScope(['admin', 'users'])).toBe('admin-users');
+    });
+    it('returns "default" for undefined scope', () => {
+        expect(normalizeScope(undefined)).toBe('default');
+    });
+});
+// ---------------------------------------------------------------------------
+// scopeToCamelCase
+// ---------------------------------------------------------------------------
+describe('scopeToCamelCase', () => {
+    it('returns a single word as-is', () => {
+        expect(scopeToCamelCase('users')).toBe('users');
+    });
+    it('converts a hyphenated scope to camelCase', () => {
+        expect(scopeToCamelCase('admin-users')).toBe('adminUsers');
+    });
+    it('converts multi-segment hyphenated scope', () => {
+        expect(scopeToCamelCase('super-admin-users')).toBe('superAdminUsers');
+    });
+});
+// ---------------------------------------------------------------------------
+// groupRoutesByScope
+// ---------------------------------------------------------------------------
+describe('groupRoutesByScope', () => {
+    beforeEach(() => {
+        vi.spyOn(console, 'warn').mockImplementation(() => { });
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('groups routes by their scope', () => {
+        const routes = [rpcRouteUsers, rpcRouteUsers2];
+        const groups = groupRoutesByScope(routes);
+        expect(groups.size).toBe(1);
+        expect(groups.has('users')).toBe(true);
+        const usersGroup = groups.get('users');
+        expect(usersGroup.scopeKey).toBe('users');
+        expect(usersGroup.camelCase).toBe('users');
+        expect(usersGroup.routes).toHaveLength(2);
+    });
+    it('handles array scopes by joining with hyphens', () => {
+        const routes = [rpcRouteAdmin];
+        const groups = groupRoutesByScope(routes);
+        expect(groups.has('admin-users')).toBe(true);
+        const group = groups.get('admin-users');
+        expect(group.scopeKey).toBe('admin-users');
+        expect(group.camelCase).toBe('adminUsers');
+        expect(group.routes).toHaveLength(1);
+    });
+    it('groups routes from multiple scopes', () => {
+        const routes = [rpcRouteUsers, rpcRouteAdmin, apiRouteWithScope];
+        const groups = groupRoutesByScope(routes);
+        expect(groups.size).toBe(3);
+        expect(groups.has('users')).toBe(true);
+        expect(groups.has('admin-users')).toBe(true);
+        expect(groups.has('posts')).toBe(true);
+    });
+    it('warns on missing scope and groups into "default"', () => {
+        const routes = [apiRouteNoScope];
+        const groups = groupRoutesByScope(routes);
+        expect(console.warn).toHaveBeenCalled();
+        expect(groups.has('default')).toBe(true);
+        const defaultGroup = groups.get('default');
+        expect(defaultGroup.scopeKey).toBe('default');
+        expect(defaultGroup.camelCase).toBe('default');
+        expect(defaultGroup.routes).toHaveLength(1);
+    });
+    it('does not warn when all routes have scopes', () => {
+        const routes = [rpcRouteUsers, apiRouteWithScope];
+        groupRoutesByScope(routes);
+        expect(console.warn).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=group-routes.test.js.map

package/build/codegen/group-routes.test.js.map

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

package/build/codegen/index.d.ts

@@ -0,0 +1,11 @@
+import { type ResolveInput } from './resolve-envelope.js';
+import type { AjscOptions } from './emit-types.js';
+export interface GenerateClientOptions extends ResolveInput {
+    outDir: string;
+    ajsc?: AjscOptions;
+    clientImportPath?: string;
+    dryRun?: boolean;
+}
+export declare function generateClient(options: GenerateClientOptions): Promise<void>;
+export type { AjscOptions } from './emit-types.js';
+export type { ResolveInput } from './resolve-envelope.js';

package/build/codegen/index.js

@@ -0,0 +1,13 @@
+import { resolveEnvelope } from './resolve-envelope.js';
+import { runPipeline } from './pipeline.js';
+export async function generateClient(options) {
+    const envelope = await resolveEnvelope(options);
+    await runPipeline({
+        envelope,
+        outDir: options.outDir,
+        ajsc: options.ajsc,
+        clientImportPath: options.clientImportPath,
+        dryRun: options.dryRun,
+    });
+}
+//# sourceMappingURL=index.js.map

package/build/codegen/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/codegen/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAqB,MAAM,uBAAuB,CAAA;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAU3C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA8B;IACjE,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAA;IAC/C,MAAM,WAAW,CAAC;QAChB,QAAQ;QACR,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAA;AACJ,CAAC"}

package/build/codegen/pipeline.d.ts

@@ -0,0 +1,14 @@
+import type { DocEnvelope } from '../implementations/types.js';
+import type { AjscOptions } from './emit-types.js';
+export interface PipelineOptions {
+    envelope: DocEnvelope;
+    outDir: string;
+    ajsc?: AjscOptions;
+    clientImportPath?: string;
+    dryRun?: boolean;
+}
+export interface GeneratedFile {
+    path: string;
+    code: string;
+}
+export declare function runPipeline(options: PipelineOptions): Promise<GeneratedFile[]>;

package/build/codegen/pipeline.js

@@ -0,0 +1,49 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { createHash } from 'node:crypto';
+import { groupRoutesByScope } from './group-routes.js';
+import { emitScopeFile } from './emit-scope.js';
+import { emitIndexFile } from './emit-index.js';
+import { emitErrorsFile } from './emit-errors.js';
+export async function runPipeline(options) {
+    const { envelope, outDir, ajsc: ajscOpts, clientImportPath, dryRun = false } = options;
+    const hash = createHash('md5').update(JSON.stringify(envelope)).digest('hex');
+    const hashComment = `// Source hash: ${hash}`;
+    const groups = groupRoutesByScope(envelope.routes);
+    const groupArray = Array.from(groups.values());
+    const files = [];
+    for (const group of groupArray) {
+        const rawCode = await emitScopeFile(group, ajscOpts, clientImportPath);
+        const lines = rawCode.split('\n');
+        lines.splice(1, 0, hashComment);
+        const code = lines.join('\n');
+        files.push({ path: join(outDir, `${group.scopeKey}.ts`), code });
+    }
+    const errorsCode = await emitErrorsFile(envelope.errors, ajscOpts, clientImportPath);
+    const hasErrors = errorsCode != null;
+    if (errorsCode != null) {
+        const errorsLines = errorsCode.split('\n');
+        errorsLines.splice(1, 0, hashComment);
+        const errorsWithHash = errorsLines.join('\n');
+        files.push({ path: join(outDir, '_errors.ts'), code: errorsWithHash });
+    }
+    const rawIndexCode = emitIndexFile(groupArray, clientImportPath, hasErrors);
+    const indexLines = rawIndexCode.split('\n');
+    indexLines.splice(1, 0, hashComment);
+    const indexCode = indexLines.join('\n');
+    files.push({ path: join(outDir, 'index.ts'), code: indexCode });
+    if (dryRun) {
+        for (const file of files) {
+            const bytes = Buffer.byteLength(file.code, 'utf-8');
+            console.log(`[dry-run] Would write: ${file.path} (${bytes} bytes)`);
+        }
+    }
+    else {
+        await mkdir(outDir, { recursive: true });
+        for (const file of files) {
+            await writeFile(file.path, file.code, 'utf-8');
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=pipeline.js.map

package/build/codegen/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/codegen/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAGxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAejD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAwB;IACxD,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,OAAO,CAAA;IAEtF,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC7E,MAAM,WAAW,GAAG,mBAAmB,IAAI,EAAE,CAAA;IAE7C,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IAClD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;IAE9C,MAAM,KAAK,GAAoB,EAAE,CAAA;IAEjC,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAA;QACtE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACjC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,CAAA;QAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA;IAClE,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAA;IACpF,MAAM,SAAS,GAAG,UAAU,IAAI,IAAI,CAAA;IACpC,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC1C,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,CAAA;QACrC,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAA;IACxE,CAAC;IAED,MAAM,YAAY,GAAG,aAAa,CAAC,UAAU,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAA;IAC3E,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC3C,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,CAAA;IACpC,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACvC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;IAE/D,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YACnD,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,CAAC,IAAI,KAAK,KAAK,SAAS,CAAC,CAAA;QACrE,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAChD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC"}

package/build/codegen/pipeline.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/codegen/pipeline.test.js

@@ -0,0 +1,151 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { generateClient } from './index.js';
+import { runPipeline } from './pipeline.js';
+import { mkdirSync, rmSync, readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+// ---------------------------------------------------------------------------
+// Fixtures
+// ---------------------------------------------------------------------------
+const envelope = {
+    basePath: '/api',
+    headers: [],
+    errors: [],
+    routes: [
+        {
+            kind: 'rpc',
+            name: 'GetUser',
+            path: '/users/1',
+            method: 'post',
+            scope: 'users',
+            version: 1,
+            jsonSchema: {
+                body: {
+                    type: 'object',
+                    properties: { id: { type: 'string' } },
+                    required: ['id'],
+                },
+                response: {
+                    type: 'object',
+                    properties: { name: { type: 'string' } },
+                    required: ['name'],
+                },
+            },
+        },
+        {
+            kind: 'rpc',
+            name: 'CreateInvoice',
+            path: '/billing/1',
+            method: 'post',
+            scope: 'billing',
+            version: 1,
+            jsonSchema: {
+                body: {
+                    type: 'object',
+                    properties: { amount: { type: 'number' } },
+                    required: ['amount'],
+                },
+                response: {
+                    type: 'object',
+                    properties: { invoiceId: { type: 'string' } },
+                    required: ['invoiceId'],
+                },
+            },
+        },
+    ],
+};
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeTmpDir() {
+    const dir = join(tmpdir(), `ts-proc-pipeline-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    mkdirSync(dir, { recursive: true });
+    return dir;
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('generateClient pipeline', () => {
+    let tmpDir;
+    afterEach(() => {
+        if (tmpDir && existsSync(tmpDir)) {
+            rmSync(tmpDir, { recursive: true, force: true });
+        }
+    });
+    it('creates scope file for each unique scope (users.ts, billing.ts)', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        expect(existsSync(join(tmpDir, 'users.ts'))).toBe(true);
+        expect(existsSync(join(tmpDir, 'billing.ts'))).toBe(true);
+    });
+    it('creates index.ts', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        expect(existsSync(join(tmpDir, 'index.ts'))).toBe(true);
+    });
+    it('users.ts contains bindUsersScope function', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'users.ts'), 'utf-8');
+        expect(content).toContain('bindUsersScope');
+        expect(content).toContain('GetUser');
+    });
+    it('billing.ts contains bindBillingScope function', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'billing.ts'), 'utf-8');
+        expect(content).toContain('bindBillingScope');
+        expect(content).toContain('CreateInvoice');
+    });
+    it('index.ts exports from both scope files and has createScopeBindings', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'index.ts'), 'utf-8');
+        expect(content).toContain("from './users'");
+        expect(content).toContain("from './billing'");
+        expect(content).toContain('createScopeBindings');
+    });
+    it('creates outDir if it does not exist', async () => {
+        tmpDir = makeTmpDir();
+        const nested = join(tmpDir, 'nested', 'output');
+        await generateClient({ envelope, outDir: nested });
+        expect(existsSync(join(nested, 'index.ts'))).toBe(true);
+    });
+    it('all generated files have the auto-generated header comment', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        for (const file of ['users.ts', 'billing.ts', 'index.ts']) {
+            const content = readFileSync(join(tmpDir, file), 'utf-8');
+            expect(content).toContain('// Auto-generated by ts-procedures-codegen — do not edit');
+        }
+    });
+    it('generated files include source hash comment', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        for (const file of ['users.ts', 'billing.ts', 'index.ts']) {
+            const content = readFileSync(join(tmpDir, file), 'utf-8');
+            const lines = content.split('\n');
+            expect(lines[1]).toMatch(/^\/\/ Source hash: [a-f0-9]{32}$/);
+        }
+    });
+    it('dry-run mode does not create files on disk', async () => {
+        tmpDir = makeTmpDir();
+        const dryDir = join(tmpDir, 'dry-output');
+        await runPipeline({ envelope, outDir: dryDir, dryRun: true });
+        expect(existsSync(dryDir)).toBe(false);
+    });
+    it('dry-run mode returns generated file entries', async () => {
+        tmpDir = makeTmpDir();
+        const dryDir = join(tmpDir, 'dry-output');
+        const files = await runPipeline({ envelope, outDir: dryDir, dryRun: true });
+        expect(files.length).toBe(3); // users.ts, billing.ts, index.ts
+        const paths = files.map((f) => f.path);
+        expect(paths).toContain(join(dryDir, 'users.ts'));
+        expect(paths).toContain(join(dryDir, 'billing.ts'));
+        expect(paths).toContain(join(dryDir, 'index.ts'));
+        for (const file of files) {
+            expect(file.code).toContain('// Auto-generated by ts-procedures-codegen — do not edit');
+        }
+    });
+});
+//# sourceMappingURL=pipeline.test.js.map

package/build/codegen/pipeline.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.test.js","sourceRoot":"","sources":["../../src/codegen/pipeline.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAGhC,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,MAAM,QAAQ,GAAgB;IAC5B,QAAQ,EAAE,MAAM;IAChB,OAAO,EAAE,EAAE;IACX,MAAM,EAAE,EAAE;IACV,MAAM,EAAE;QACN;YACE,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,MAAM;YACd,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,CAAC;YACV,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBACtC,QAAQ,EAAE,CAAC,IAAI,CAAC;iBACjB;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBACxC,QAAQ,EAAE,CAAC,MAAM,CAAC;iBACnB;aACF;SACF;QACD;YACE,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,MAAM;YACd,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,CAAC;YACV,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBAC1C,QAAQ,EAAE,CAAC,QAAQ,CAAC;iBACrB;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBAC7C,QAAQ,EAAE,CAAC,WAAW,CAAC;iBACxB;aACF;SACF;KACF;CACF,CAAA;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,UAAU;IACjB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,yBAAyB,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IACxG,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACnC,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,IAAI,MAAc,CAAA;IAElB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAClD,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,GAAG,UAAU,EAAE,CAAA;QACrB,MAAM,cAAc,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QAElD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kBAAkB,EAAE,KAAK,IAAI,EAAE;QAChC,MAAM,GAAG,UAAU,EAAE,CAAA;QACrB,MAAM,cAAc,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QAElD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,GAAG,UAAU,EAAE,CAAA;QACrB,MAAM,cAAc,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QAElD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAA;QAC/D,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAA;QAC3C,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,GAAG,UAAU,EAAE,CAAA;QACrB,MAAM,cAAc,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QAElD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAA;QACjE,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAA;QAC7C,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,GAAG,UAAU,EAAE,CAAA;QACrB,MAAM,cAAc,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QAElD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAA;QAC/D,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAA;QAC3C,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAA;QAC7C,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,GAAG,UAAU,EAAE,CAAA;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;QAC/C,MAAM,cAAc,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QAElD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,GAAG,UAAU,EAAE,CAAA;QACrB,MAAM,cAAc,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QAElD,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,CAAC;YAC1D,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAA;YACzD,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,0DAA0D,CAAC,CAAA;QACvF,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,GAAG,UAAU,EAAE,CAAA;QACrB,MAAM,cAAc,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QAElD,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,CAAC;YAC1D,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAA;YACzD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACjC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAA;QAC9D,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,GAAG,UAAU,EAAE,CAAA;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;QACzC,MAAM,WAAW,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7D,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,GAAG,UAAU,EAAE,CAAA;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;QACzC,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QAC3E,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA,CAAC,iCAAiC;QAC9D,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QACtC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;QACjD,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;QACnD,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;QACjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,0DAA0D,CAAC,CAAA;QACzF,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/build/codegen/resolve-envelope.d.ts

@@ -0,0 +1,7 @@
+import type { DocEnvelope } from '../implementations/types.js';
+export interface ResolveInput {
+    url?: string;
+    file?: string;
+    envelope?: DocEnvelope;
+}
+export declare function resolveEnvelope(input: ResolveInput): Promise<DocEnvelope>;