ts-procedures 5.5.0 → 5.6.0-beta.1

package/build/codegen/e2e.test.js

@@ -0,0 +1,321 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { generateClient } from './index.js';
+import { mkdirSync, rmSync, readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+// ---------------------------------------------------------------------------
+// Fixtures
+// ---------------------------------------------------------------------------
+const rpcRoute = {
+    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' }, email: { type: 'string' } },
+            required: ['name', 'email'],
+        },
+    },
+};
+const apiRoute = {
+    kind: 'api',
+    name: 'UpdateUser',
+    path: '/users/:id',
+    fullPath: '/api/users/:id',
+    method: 'put',
+    scope: 'users',
+    jsonSchema: {
+        pathParams: {
+            type: 'object',
+            properties: { id: { type: 'string' } },
+            required: ['id'],
+        },
+        body: {
+            type: 'object',
+            properties: { name: { type: 'string' } },
+            required: ['name'],
+        },
+        response: {
+            type: 'object',
+            properties: { id: { type: 'string' }, name: { type: 'string' } },
+            required: ['id', 'name'],
+        },
+    },
+};
+const streamRoute = {
+    kind: 'stream',
+    name: 'WatchEvents',
+    path: '/events/stream',
+    methods: ['get'],
+    streamMode: 'sse',
+    scope: 'events',
+    version: 1,
+    jsonSchema: {
+        params: {
+            type: 'object',
+            properties: { filter: { type: 'string' } },
+            required: [],
+        },
+        // SSE envelope wrapping the actual yield payload
+        yieldType: {
+            type: 'object',
+            properties: {
+                data: {
+                    type: 'object',
+                    properties: { type: { type: 'string' }, payload: { type: 'string' } },
+                    required: ['type'],
+                },
+                event: { type: 'string' },
+                id: { type: 'string' },
+                retry: { type: 'number' },
+            },
+            required: ['data'],
+        },
+        returnType: {
+            type: 'object',
+            properties: { count: { type: 'number' } },
+            required: ['count'],
+        },
+    },
+};
+const procedureErrorDoc = {
+    name: 'ProcedureError',
+    statusCode: 500,
+    description: 'An error thrown from within a procedure handler via ctx.error().',
+    schema: {
+        type: 'object',
+        properties: {
+            name: { type: 'string', const: 'ProcedureError' },
+            procedureName: { type: 'string' },
+            message: { type: 'string' },
+            meta: { type: 'object' },
+        },
+        required: ['name', 'procedureName', 'message'],
+    },
+};
+const validationErrorDoc = {
+    name: 'ProcedureValidationError',
+    statusCode: 400,
+    description: 'Schema validation failed for the procedure input parameters.',
+    schema: {
+        type: 'object',
+        properties: {
+            name: { type: 'string', const: 'ProcedureValidationError' },
+            procedureName: { type: 'string' },
+            message: { type: 'string' },
+        },
+        required: ['name', 'procedureName', 'message'],
+    },
+};
+const envelope = {
+    basePath: '/api',
+    headers: [],
+    errors: [procedureErrorDoc, validationErrorDoc],
+    routes: [rpcRoute, apiRoute, streamRoute],
+};
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeTmpDir() {
+    const dir = join(tmpdir(), `ts-proc-e2e-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    mkdirSync(dir, { recursive: true });
+    return dir;
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('E2E: generateClient full pipeline', () => {
+    let tmpDir;
+    afterEach(() => {
+        if (tmpDir && existsSync(tmpDir)) {
+            rmSync(tmpDir, { recursive: true, force: true });
+        }
+    });
+    // ── File existence ─────────────────────────────────────────────────────────
+    it('creates users.ts, events.ts, and index.ts', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        expect(existsSync(join(tmpDir, 'users.ts'))).toBe(true);
+        expect(existsSync(join(tmpDir, 'events.ts'))).toBe(true);
+        expect(existsSync(join(tmpDir, 'index.ts'))).toBe(true);
+    });
+    // ── users.ts — RPC route ───────────────────────────────────────────────────
+    it('users.ts contains GetUserParams type', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'users.ts'), 'utf-8');
+        expect(content).toContain('GetUserParams');
+    });
+    it('users.ts contains GetUserResponse type', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'users.ts'), 'utf-8');
+        expect(content).toContain('GetUserResponse');
+    });
+    // ── users.ts — API route ───────────────────────────────────────────────────
+    it('users.ts contains UpdateUserParams type', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'users.ts'), 'utf-8');
+        expect(content).toContain('UpdateUserParams');
+    });
+    it('users.ts contains UpdateUserResponse type', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'users.ts'), 'utf-8');
+        expect(content).toContain('UpdateUserResponse');
+    });
+    it('users.ts API callable uses fullPath in the path field', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'users.ts'), 'utf-8');
+        // fullPath ('/api/users/:id') should appear in the callable body
+        expect(content).toContain("path: '/api/users/:id'");
+        // bare path without prefix should NOT appear as path: value for the api route
+        expect(content).not.toContain("path: '/users/:id'");
+    });
+    it('users.ts exports bindUsersScope function', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'users.ts'), 'utf-8');
+        expect(content).toContain('bindUsersScope');
+    });
+    it('users.ts uses client.call for RPC route', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'users.ts'), 'utf-8');
+        expect(content).toContain('client.call');
+    });
+    // ── events.ts — Stream route ───────────────────────────────────────────────
+    it('events.ts contains WatchEventsYield type', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'events.ts'), 'utf-8');
+        expect(content).toContain('WatchEventsYield');
+    });
+    it('events.ts contains WatchEventsReturn type', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'events.ts'), 'utf-8');
+        expect(content).toContain('WatchEventsReturn');
+    });
+    it('events.ts imports TypedStream', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'events.ts'), 'utf-8');
+        expect(content).toContain('TypedStream');
+    });
+    it('events.ts uses client.stream', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'events.ts'), 'utf-8');
+        expect(content).toContain('client.stream');
+    });
+    it("events.ts callable has streamMode: 'sse'", async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'events.ts'), 'utf-8');
+        expect(content).toContain("streamMode: 'sse'");
+    });
+    it('events.ts SSE envelope is unwrapped — yield type does NOT contain event/id/retry fields', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'events.ts'), 'utf-8');
+        // Extract the WatchEventsYield type declaration line
+        const yieldMatch = content.match(/export type WatchEventsYield = (.+)/);
+        expect(yieldMatch).not.toBeNull();
+        const yieldTypeBody = yieldMatch[1];
+        // The SSE envelope properties should not appear in the resolved yield type
+        expect(yieldTypeBody).not.toContain('event');
+        expect(yieldTypeBody).not.toContain('retry');
+    });
+    // ── index.ts ───────────────────────────────────────────────────────────────
+    it('index.ts contains createScopeBindings', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'index.ts'), 'utf-8');
+        expect(content).toContain('createScopeBindings');
+    });
+    it('index.ts re-exports from users scope', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'index.ts'), 'utf-8');
+        expect(content).toContain("from './users'");
+    });
+    it('index.ts re-exports from events scope', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'index.ts'), 'utf-8');
+        expect(content).toContain("from './events'");
+    });
+    it('index.ts imports and uses bindUsersScope', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'index.ts'), 'utf-8');
+        expect(content).toContain('bindUsersScope');
+    });
+    it('index.ts imports and uses bindEventsScope', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'index.ts'), 'utf-8');
+        expect(content).toContain('bindEventsScope');
+    });
+    // ── _errors.ts ─────────────────────────────────────────────────────────────
+    it('_errors.ts file exists when envelope has errors with schemas', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        expect(existsSync(join(tmpDir, '_errors.ts'))).toBe(true);
+    });
+    it('_errors.ts contains ProcedureError type', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, '_errors.ts'), 'utf-8');
+        expect(content).toContain('export type ProcedureError =');
+    });
+    it('_errors.ts contains ProcedureErrorUnion', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, '_errors.ts'), 'utf-8');
+        expect(content).toContain('export type ProcedureErrorUnion =');
+        expect(content).toContain('ProcedureError');
+        expect(content).toContain('ProcedureValidationError');
+    });
+    it('index.ts re-exports from _errors when errors are present', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'index.ts'), 'utf-8');
+        expect(content).toContain("export * from './_errors'");
+    });
+    it('_errors.ts is not generated when no errors have schemas', async () => {
+        tmpDir = makeTmpDir();
+        const envelopeNoErrors = { ...envelope, errors: [] };
+        await generateClient({ envelope: envelopeNoErrors, outDir: tmpDir });
+        expect(existsSync(join(tmpDir, '_errors.ts'))).toBe(false);
+    });
+    it('index.ts does not re-export _errors when no errors are present', async () => {
+        tmpDir = makeTmpDir();
+        const envelopeNoErrors = { ...envelope, errors: [] };
+        await generateClient({ envelope: envelopeNoErrors, outDir: tmpDir });
+        const content = readFileSync(join(tmpDir, 'index.ts'), 'utf-8');
+        expect(content).not.toContain("_errors");
+    });
+    // ── Auto-generated headers ─────────────────────────────────────────────────
+    it('all generated files have the auto-generated header comment', async () => {
+        tmpDir = makeTmpDir();
+        await generateClient({ envelope, outDir: tmpDir });
+        for (const file of ['users.ts', 'events.ts', 'index.ts', '_errors.ts']) {
+            const content = readFileSync(join(tmpDir, file), 'utf-8');
+            expect(content).toContain('// Auto-generated by ts-procedures-codegen — do not edit');
+        }
+    });
+});
+//# sourceMappingURL=e2e.test.js.map

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

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

package/build/codegen/emit-errors.d.ts

@@ -0,0 +1,9 @@
+import { type AjscOptions } from './emit-types.js';
+import type { ErrorDoc } from '../implementations/types.js';
+/**
+ * Generates a TypeScript file with error type declarations from the DocEnvelope.errors array.
+ *
+ * Only errors with a `schema` property are included. If no errors have schemas,
+ * returns `undefined` (no file generated).
+ */
+export declare function emitErrorsFile(errors: ErrorDoc[], ajscOpts?: AjscOptions, _clientImportPath?: string): Promise<string | undefined>;

package/build/codegen/emit-errors.js

@@ -0,0 +1,30 @@
+import { jsonSchemaToTypeString } from './emit-types.js';
+/**
+ * Generates a TypeScript file with error type declarations from the DocEnvelope.errors array.
+ *
+ * Only errors with a `schema` property are included. If no errors have schemas,
+ * returns `undefined` (no file generated).
+ */
+export async function emitErrorsFile(errors, ajscOpts, _clientImportPath) {
+    // Filter to only errors that have a schema
+    const errorsWithSchema = errors.filter((e) => e.schema != null);
+    if (errorsWithSchema.length === 0) {
+        return undefined;
+    }
+    const typeLines = [];
+    for (const error of errorsWithSchema) {
+        const typeDecl = await jsonSchemaToTypeString(error.name, error.schema, ajscOpts);
+        if (typeDecl != null) {
+            typeLines.push(`/** ${error.description} (HTTP ${error.statusCode}) */`);
+            typeLines.push(typeDecl);
+            typeLines.push('');
+        }
+    }
+    // Discriminated union of all error types
+    const unionMembers = errorsWithSchema.map((e) => e.name).join(' | ');
+    typeLines.push(`export type ProcedureErrorUnion = ${unionMembers}`);
+    typeLines.push('');
+    const body = typeLines.join('\n');
+    return ['// Auto-generated by ts-procedures-codegen — do not edit', '', body].join('\n');
+}
+//# sourceMappingURL=emit-errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emit-errors.js","sourceRoot":"","sources":["../../src/codegen/emit-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAoB,MAAM,iBAAiB,CAAA;AAG1E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAkB,EAClB,QAAsB,EACtB,iBAA0B;IAE1B,2CAA2C;IAC3C,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAuD,EAAE,CAChG,CAAC,CAAC,MAAM,IAAI,IAAI,CACjB,CAAA;IAED,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM,SAAS,GAAa,EAAE,CAAA;IAE9B,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QACjF,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;YACrB,SAAS,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,WAAW,UAAU,KAAK,CAAC,UAAU,MAAM,CAAC,CAAA;YACxE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACxB,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACpB,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,MAAM,YAAY,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACpE,SAAS,CAAC,IAAI,CAAC,qCAAqC,YAAY,EAAE,CAAC,CAAA;IACnE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAElB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEjC,OAAO,CAAC,0DAA0D,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC1F,CAAC"}

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

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

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

@@ -0,0 +1,110 @@
+import { describe, expect, it } from 'vitest';
+import { emitErrorsFile } from './emit-errors.js';
+// ---------------------------------------------------------------------------
+// Fixtures
+// ---------------------------------------------------------------------------
+const procedureErrorDoc = {
+    name: 'ProcedureError',
+    statusCode: 500,
+    description: 'An error thrown from within a procedure handler via ctx.error().',
+    schema: {
+        type: 'object',
+        properties: {
+            name: { type: 'string', const: 'ProcedureError' },
+            procedureName: { type: 'string' },
+            message: { type: 'string' },
+            meta: { type: 'object' },
+        },
+        required: ['name', 'procedureName', 'message'],
+    },
+};
+const validationErrorDoc = {
+    name: 'ProcedureValidationError',
+    statusCode: 400,
+    description: 'Schema validation failed for the procedure input parameters.',
+    schema: {
+        type: 'object',
+        properties: {
+            name: { type: 'string', const: 'ProcedureValidationError' },
+            procedureName: { type: 'string' },
+            message: { type: 'string' },
+        },
+        required: ['name', 'procedureName', 'message'],
+    },
+};
+const errorDocWithoutSchema = {
+    name: 'UnknownError',
+    statusCode: 503,
+    description: 'An unknown error occurred.',
+    // no schema
+};
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('emitErrorsFile', () => {
+    it('generates types for errors with schemas', async () => {
+        const result = await emitErrorsFile([procedureErrorDoc, validationErrorDoc]);
+        expect(result).toBeDefined();
+        expect(result).toContain('export type ProcedureError =');
+        expect(result).toContain('export type ProcedureValidationError =');
+    });
+    it('generates ProcedureErrorUnion discriminated union', async () => {
+        const result = await emitErrorsFile([procedureErrorDoc, validationErrorDoc]);
+        expect(result).toBeDefined();
+        expect(result).toContain('export type ProcedureErrorUnion = ProcedureError | ProcedureValidationError');
+    });
+    it('includes JSDoc with statusCode and description', async () => {
+        const result = await emitErrorsFile([procedureErrorDoc]);
+        expect(result).toBeDefined();
+        expect(result).toContain('/** An error thrown from within a procedure handler via ctx.error(). (HTTP 500) */');
+    });
+    it('includes JSDoc before the type declaration', async () => {
+        const result = await emitErrorsFile([procedureErrorDoc]);
+        expect(result).toBeDefined();
+        const jsdocIdx = result.indexOf('/** An error thrown from within a procedure handler via ctx.error().');
+        const typeIdx = result.indexOf('export type ProcedureError =');
+        expect(jsdocIdx).toBeLessThan(typeIdx);
+    });
+    it('includes the auto-generated header comment', async () => {
+        const result = await emitErrorsFile([procedureErrorDoc]);
+        expect(result).toBeDefined();
+        expect(result).toContain('// Auto-generated by ts-procedures-codegen — do not edit');
+    });
+    it('returns undefined when no errors have schemas', async () => {
+        const result = await emitErrorsFile([errorDocWithoutSchema]);
+        expect(result).toBeUndefined();
+    });
+    it('returns undefined for empty errors array', async () => {
+        const result = await emitErrorsFile([]);
+        expect(result).toBeUndefined();
+    });
+    it('skips errors without schema, includes those with schema', async () => {
+        const result = await emitErrorsFile([procedureErrorDoc, errorDocWithoutSchema, validationErrorDoc]);
+        expect(result).toBeDefined();
+        expect(result).toContain('export type ProcedureError =');
+        expect(result).toContain('export type ProcedureValidationError =');
+        // UnknownError has no schema, so it should not appear as a type
+        expect(result).not.toContain('export type UnknownError =');
+        // But the union should only include the ones with schemas
+        expect(result).toContain('ProcedureError | ProcedureValidationError');
+        expect(result).not.toContain('UnknownError');
+    });
+    it('union type has single type when only one error has schema', async () => {
+        const result = await emitErrorsFile([procedureErrorDoc]);
+        expect(result).toBeDefined();
+        expect(result).toContain('export type ProcedureErrorUnion = ProcedureError');
+    });
+    it('union type does not include errros without schemas', async () => {
+        const result = await emitErrorsFile([procedureErrorDoc, errorDocWithoutSchema]);
+        expect(result).toBeDefined();
+        expect(result).not.toContain('UnknownError');
+        expect(result).toContain('export type ProcedureErrorUnion = ProcedureError');
+    });
+    it('respects ajscOpts passed to jsonSchemaToTypeString', async () => {
+        // Just verify it does not crash when options are passed — behavior is tested in emit-types.test.ts
+        const result = await emitErrorsFile([procedureErrorDoc], { enumStyle: 'union' });
+        expect(result).toBeDefined();
+        expect(result).toContain('export type ProcedureError =');
+    });
+});
+//# sourceMappingURL=emit-errors.test.js.map

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

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

package/build/codegen/emit-index.d.ts

@@ -0,0 +1,6 @@
+import type { ScopeGroup } from './group-routes.js';
+/**
+ * Generates a barrel index file that re-exports all scope files and provides
+ * a `createScopeBindings` factory function.
+ */
+export declare function emitIndexFile(groups: ScopeGroup[], clientImportPath?: string, hasErrors?: boolean): string;

package/build/codegen/emit-index.js

@@ -0,0 +1,49 @@
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Converts a string to PascalCase (splits on whitespace, hyphens, underscores). */
+function toPascalCase(str) {
+    return str
+        .split(/[\s\-_]+/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join('');
+}
+/** Derives the bind function name from a camelCase scope identifier. */
+function bindFunctionName(camelCase) {
+    return `bind${toPascalCase(camelCase)}Scope`;
+}
+// ---------------------------------------------------------------------------
+// emitIndexFile
+// ---------------------------------------------------------------------------
+/**
+ * Generates a barrel index file that re-exports all scope files and provides
+ * a `createScopeBindings` factory function.
+ */
+export function emitIndexFile(groups, clientImportPath = 'ts-procedures/client', hasErrors = false) {
+    const bindImports = groups
+        .map((g) => `import { ${bindFunctionName(g.camelCase)} } from './${g.scopeKey}'`)
+        .join('\n');
+    const scopeReExports = groups
+        .map((g) => `export * from './${g.scopeKey}'`)
+        .join('\n');
+    const errorsReExport = hasErrors ? `export * from './_errors'` : '';
+    const reExports = [scopeReExports, errorsReExport].filter(Boolean).join('\n');
+    const scopeBindings = groups
+        .map((g) => `    ${g.camelCase}: ${bindFunctionName(g.camelCase)}(client),`)
+        .join('\n');
+    return [
+        '// Auto-generated by ts-procedures-codegen — do not edit',
+        `import type { ClientInstance } from '${clientImportPath}'`,
+        bindImports,
+        '',
+        reExports,
+        '',
+        'export function createScopeBindings(client: ClientInstance) {',
+        '  return {',
+        scopeBindings,
+        '  }',
+        '}',
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=emit-index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emit-index.js","sourceRoot":"","sources":["../../src/codegen/emit-index.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,oFAAoF;AACpF,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG;SACP,KAAK,CAAC,UAAU,CAAC;SACjB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,EAAE,CAAC,CAAA;AACb,CAAC;AAED,wEAAwE;AACxE,SAAS,gBAAgB,CAAC,SAAiB;IACzC,OAAO,OAAO,YAAY,CAAC,SAAS,CAAC,OAAO,CAAA;AAC9C,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAoB,EAAE,gBAAgB,GAAG,sBAAsB,EAAE,SAAS,GAAG,KAAK;IAC9G,MAAM,WAAW,GAAG,MAAM;SACvB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,QAAQ,GAAG,CAAC;SAChF,IAAI,CAAC,IAAI,CAAC,CAAA;IAEb,MAAM,cAAc,GAAG,MAAM;SAC1B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,CAAC,QAAQ,GAAG,CAAC;SAC7C,IAAI,CAAC,IAAI,CAAC,CAAA;IAEb,MAAM,cAAc,GAAG,SAAS,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,EAAE,CAAA;IAEnE,MAAM,SAAS,GAAG,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAE7E,MAAM,aAAa,GAAG,MAAM;SACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,SAAS,KAAK,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC;SAC3E,IAAI,CAAC,IAAI,CAAC,CAAA;IAEb,OAAO;QACL,0DAA0D;QAC1D,wCAAwC,gBAAgB,GAAG;QAC3D,WAAW;QACX,EAAE;QACF,SAAS;QACT,EAAE;QACF,+DAA+D;QAC/D,YAAY;QACZ,aAAa;QACb,KAAK;QACL,GAAG;QACH,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}

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

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