ts-procedures 8.6.0 → 9.0.0

package/build/{stack-utils.js → core/definition-site.js}

@@ -1,10 +1,15 @@
 /**
- * Internal ts-procedures files that should be skipped when finding user code.
- * Only skip the core library files, not test files or user code.
+ * Captures WHERE a procedure was defined (file:line:column) at registration
+ * time, so every error a procedure ever throws can point back to its
+ * definition site — not just the call site.
+ */
+/**
+ * Library-internal files skipped when walking the stack for the user's frame.
+ * Only core library files — never test files or user code.
  */
 const INTERNAL_FILES = [
-    '/index.ts',
-    '/index.js',
+    '/procedures.ts',
+    '/procedures.js',
     '/create.ts',
     '/create.js',
     '/create-stream.ts',
@@ -13,18 +18,20 @@ const INTERNAL_FILES = [
     '/create-http.js',
     '/create-http-stream.ts',
     '/create-http-stream.js',
+    '/internal.ts',
+    '/internal.js',
     '/errors.ts',
     '/errors.js',
-    '/stack-utils.ts',
-    '/stack-utils.js',
+    '/definition-site.ts',
+    '/definition-site.js',
     '/compute-schema.ts',
     '/compute-schema.js',
-    '/parser.ts',
-    '/parser.js',
+    '/compile.ts',
+    '/compile.js',
 ];
 /**
- * Captures the stack trace at the call site and extracts the definition location.
- * Finds the first stack frame outside of ts-procedures internal files.
+ * Captures the stack trace at the call site and extracts the definition
+ * location: the first stack frame outside ts-procedures internals.
  */
 export function captureDefinitionInfo() {
     const err = new Error();
@@ -33,20 +40,16 @@ export function captureDefinitionInfo() {
         return {};
     }
     const lines = stack.split('\n');
-    // Find the first frame that's not from ts-procedures internals
-    // Skip the first line (Error message) and frames from this module
     let userFrame;
     for (let i = 1; i < lines.length; i++) {
         const rawLine = lines[i];
         if (!rawLine)
             continue;
         const line = rawLine.trim();
-        // Skip empty or invalid frames
         if (!line.startsWith('at ')) {
             continue;
         }
-        // Skip frames from ts-procedures internal source files
-        const isInternalFile = INTERNAL_FILES.some(file => line.includes(file));
+        const isInternalFile = INTERNAL_FILES.some((file) => line.includes(file));
         if (isInternalFile) {
             continue;
         }
@@ -78,7 +81,6 @@ export function captureDefinitionInfo() {
  * - "at /path/to/file.ts:10:5"
  */
 function parseStackFrame(frame) {
-    // Match patterns like "(path:line:column)" or just "path:line:column"
     const match = frame.match(/\(([^)]+):(\d+):(\d+)\)$/) || frame.match(/at ([^:]+):(\d+):(\d+)$/);
     if (match && match[1] && match[2] && match[3]) {
         return {
@@ -90,9 +92,7 @@ function parseStackFrame(frame) {
     }
     return undefined;
 }
-/**
- * Formats definition info for appending to error stacks.
- */
+/** Formats definition info for appending to error stacks. */
 export function formatDefinitionInfo(info, procedureName) {
     if (!info.definedAt) {
         return undefined;
@@ -100,4 +100,4 @@ export function formatDefinitionInfo(info, procedureName) {
     const { file, line, column } = info.definedAt;
     return `\n--- Procedure "${procedureName}" defined at ---\n    at ${file}:${line}:${column}`;
 }
-//# sourceMappingURL=stack-utils.js.map
+//# sourceMappingURL=definition-site.js.map

package/build/core/definition-site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-site.js","sourceRoot":"","sources":["../../src/core/definition-site.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH;;;GAGG;AACH,MAAM,cAAc,GAAG;IACrB,gBAAgB;IAChB,gBAAgB;IAChB,YAAY;IACZ,YAAY;IACZ,mBAAmB;IACnB,mBAAmB;IACnB,iBAAiB;IACjB,iBAAiB;IACjB,wBAAwB;IACxB,wBAAwB;IACxB,cAAc;IACd,cAAc;IACd,YAAY;IACZ,YAAY;IACZ,qBAAqB;IACrB,qBAAqB;IACrB,oBAAoB;IACpB,oBAAoB;IACpB,aAAa;IACb,aAAa;CACd,CAAA;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAA;IACvB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAA;IAEvB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAE/B,IAAI,SAA6B,CAAA;IAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACxB,IAAI,CAAC,OAAO;YAAE,SAAQ;QACtB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;QAE3B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,SAAQ;QACV,CAAC;QAED,MAAM,cAAc,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;QACzE,IAAI,cAAc,EAAE,CAAC;YACnB,SAAQ;QACV,CAAC;QAED,6EAA6E;QAC7E,IAAI,IAAI,CAAC,QAAQ,CAAC,8BAA8B,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,iCAAiC,CAAC,EAAE,CAAC;YACtG,SAAQ;QACV,CAAC;QAED,4BAA4B;QAC5B,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,8BAA8B,CAAC,EAAE,CAAC;YAC/G,SAAQ;QACV,CAAC;QAED,SAAS,GAAG,IAAI,CAAA;QAChB,MAAK;IACP,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,CAAA;IACnC,CAAC;IAED,MAAM,SAAS,GAAG,eAAe,CAAC,SAAS,CAAC,CAAA;IAE5C,OAAO;QACL,SAAS;QACT,eAAe,EAAE,KAAK;KACvB,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,eAAe,CAAC,KAAa;IACpC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,0BAA0B,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAA;IAE/F,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;YACd,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAC9B,GAAG,EAAE,KAAK;SACX,CAAA;IACH,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,oBAAoB,CAAC,IAAoB,EAAE,aAAqB;IAC9E,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAA;IAC7C,OAAO,oBAAoB,aAAa,4BAA4B,IAAI,IAAI,IAAI,IAAI,MAAM,EAAE,CAAA;AAC9F,CAAC"}

package/build/{stack-utils.test.js → core/definition-site.test.js}

@@ -1,6 +1,6 @@
 import { describe, expect, test } from 'vitest';
-import { captureDefinitionInfo, formatDefinitionInfo } from './stack-utils.js';
-describe('Stack Utils', () => {
+import { captureDefinitionInfo, formatDefinitionInfo } from './definition-site.js';
+describe('Definition Site', () => {
     describe('captureDefinitionInfo', () => {
         test('returns definition info with definedAt', () => {
             const info = captureDefinitionInfo();
@@ -75,6 +75,15 @@ describe('Stack Utils', () => {
             expect(info).toBeDefined();
             expect(info.definitionStack).toBeDefined();
         });
+        test('skips v9 library-internal frames, not this test file', () => {
+            // v9's internal-file list covers procedures.ts / internal.ts / compile.ts
+            // (etc.) — but must never swallow user/test frames whose names merely
+            // resemble internal files (e.g. this `definition-site.test.ts` file is
+            // NOT matched by the `/definition-site.ts` entry).
+            const info = captureDefinitionInfo();
+            expect(info.definedAt).toBeDefined();
+            expect(info.definedAt?.file).toContain('definition-site.test.ts');
+        });
     });
 });
-//# sourceMappingURL=stack-utils.test.js.map
+//# sourceMappingURL=definition-site.test.js.map

package/build/core/definition-site.test.js.map

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

package/build/{errors.d.ts → core/errors.d.ts}

@@ -1,33 +1,44 @@
-import type { TSchemaValidationError } from './schema/parser.js';
-import type { DefinitionInfo, DefinitionLocation } from './stack-utils.js';
+import type { TSchemaValidationError } from '../schema/compile.js';
+import type { DefinitionInfo, DefinitionLocation } from './definition-site.js';
+/** Discriminant carried by every framework error (alternative to `instanceof`). */
+export type ProcedureErrorKind = 'procedure' | 'validation' | 'yield-validation' | 'registration';
+/**
+ * Base error for everything the framework throws. Produced by `ctx.error()`
+ * in handlers, and used to box non-ProcedureError throws (with the original
+ * error as `cause`). Carries the procedure's definition site so stack traces
+ * point at the definition, not just the call.
+ */
 export declare class ProcedureError extends Error {
     readonly procedureName: string;
     readonly message: string;
     readonly meta?: object | undefined;
+    readonly kind: ProcedureErrorKind;
     cause?: unknown;
     readonly definedAt?: DefinitionLocation;
     readonly definitionStack?: string;
     constructor(procedureName: string, message: string, meta?: object | undefined, definitionInfo?: DefinitionInfo);
-    /**
-     * Returns a formatted string showing where the procedure was defined.
-     */
+    /** Returns `file:line:column` of the procedure definition, when captured. */
     getDefinitionLocation(): string | undefined;
-    /**
-     * Enhances the error stack with definition location information.
-     */
+    /** Appends the definition-site section to the error stack. */
     private enhanceStack;
 }
+/** Schema validation failure for params / req channels (400 in the default taxonomy). */
 export declare class ProcedureValidationError extends ProcedureError {
     readonly procedureName: string;
     readonly errors?: TSchemaValidationError[] | undefined;
+    readonly kind = "validation";
     constructor(procedureName: string, message: string, errors?: TSchemaValidationError[] | undefined, definitionInfo?: DefinitionInfo);
 }
+/** Invalid registration: bad schema, duplicate name, misplaced config fields. */
 export declare class ProcedureRegistrationError extends ProcedureError {
     readonly procedureName: string;
+    readonly kind = "registration";
     constructor(procedureName: string, message: string, definitionInfo?: DefinitionInfo);
 }
+/** Stream yield failed schema validation (only with `validateYields: true`). */
 export declare class ProcedureYieldValidationError extends ProcedureError {
     readonly procedureName: string;
     readonly errors?: TSchemaValidationError[] | undefined;
+    readonly kind = "yield-validation";
     constructor(procedureName: string, message: string, errors?: TSchemaValidationError[] | undefined, definitionInfo?: DefinitionInfo);
 }

package/build/{errors.js → core/errors.js}

@@ -1,15 +1,20 @@
-import { formatDefinitionInfo } from './stack-utils.js';
 import { kebabCase } from 'es-toolkit/string';
+import { formatDefinitionInfo } from './definition-site.js';
+/**
+ * Base error for everything the framework throws. Produced by `ctx.error()`
+ * in handlers, and used to box non-ProcedureError throws (with the original
+ * error as `cause`). Carries the procedure's definition site so stack traces
+ * point at the definition, not just the call.
+ */
 export class ProcedureError extends Error {
     procedureName;
     message;
     meta;
+    kind = 'procedure';
     cause;
     definedAt;
     definitionStack;
-    constructor(procedureName, message, meta, 
-    // Used for error stack trace details
-    definitionInfo) {
+    constructor(procedureName, message, meta, definitionInfo) {
         super(message);
         this.procedureName = procedureName;
         this.message = message;
@@ -21,20 +26,16 @@ export class ProcedureError extends Error {
             this.enhanceStack();
         }
         // https://www.dannyguo.com/blog/how-to-fix-instanceof-not-working-for-custom-errors-in-typescript/
-        Object.setPrototypeOf(this, ProcedureError.prototype);
+        Object.setPrototypeOf(this, new.target.prototype);
     }
-    /**
-     * Returns a formatted string showing where the procedure was defined.
-     */
+    /** Returns `file:line:column` of the procedure definition, when captured. */
     getDefinitionLocation() {
         if (!this.definedAt) {
             return undefined;
         }
         return `${this.definedAt.file}:${this.definedAt.line}:${this.definedAt.column}`;
     }
-    /**
-     * Enhances the error stack with definition location information.
-     */
+    /** Appends the definition-site section to the error stack. */
     enhanceStack() {
         if (!this.stack || !this.definedAt) {
             return;
@@ -45,12 +46,12 @@ export class ProcedureError extends Error {
         }
     }
 }
+/** Schema validation failure for params / req channels (400 in the default taxonomy). */
 export class ProcedureValidationError extends ProcedureError {
     procedureName;
     errors;
-    constructor(procedureName, message, errors, 
-    // Used for error stack trace details
-    definitionInfo) {
+    kind = 'validation';
+    constructor(procedureName, message, errors, definitionInfo) {
         const readableErrors = errors
             ?.map((err) => `- ${kebabCase(err.instancePath).replace('-', '.')} ${err.message}`)
             .join(', ');
@@ -58,34 +59,28 @@ export class ProcedureValidationError extends ProcedureError {
         this.procedureName = procedureName;
         this.errors = errors;
         this.name = 'ProcedureValidationError';
-        // https://www.dannyguo.com/blog/how-to-fix-instanceof-not-working-for-custom-errors-in-typescript/
-        Object.setPrototypeOf(this, ProcedureValidationError.prototype);
     }
 }
+/** Invalid registration: bad schema, duplicate name, misplaced config fields. */
 export class ProcedureRegistrationError extends ProcedureError {
     procedureName;
-    constructor(procedureName, message, 
-    // Used for error stack trace details
-    definitionInfo) {
+    kind = 'registration';
+    constructor(procedureName, message, definitionInfo) {
         super(procedureName, message, undefined, definitionInfo);
         this.procedureName = procedureName;
         this.name = 'ProcedureRegistrationError';
-        // https://www.dannyguo.com/blog/how-to-fix-instanceof-not-working-for-custom-errors-in-typescript/
-        Object.setPrototypeOf(this, ProcedureRegistrationError.prototype);
     }
 }
+/** Stream yield failed schema validation (only with `validateYields: true`). */
 export class ProcedureYieldValidationError extends ProcedureError {
     procedureName;
     errors;
-    constructor(procedureName, message, errors, 
-    // Used for error stack trace details
-    definitionInfo) {
+    kind = 'yield-validation';
+    constructor(procedureName, message, errors, definitionInfo) {
         super(procedureName, message, undefined, definitionInfo);
         this.procedureName = procedureName;
         this.errors = errors;
         this.name = 'ProcedureYieldValidationError';
-        // https://www.dannyguo.com/blog/how-to-fix-instanceof-not-working-for-custom-errors-in-typescript/
-        Object.setPrototypeOf(this, ProcedureYieldValidationError.prototype);
     }
 }
 //# sourceMappingURL=errors.js.map

package/build/core/errors.js.map

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

package/build/core/errors.test.js.map

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

package/build/core/factory-options.test.js

@@ -0,0 +1,82 @@
+import { describe, expect, it } from 'vitest';
+import { Type } from 'typebox';
+import { Procedures } from './procedures.js';
+import { ProcedureValidationError } from './errors.js';
+describe('Procedures factory options (new in v9)', () => {
+    describe('schema.adapters', () => {
+        // A minimal stand-in for a zod/valibot-style adapter: schema objects carry
+        // their JSON Schema under a custom marker key.
+        const fakeLibAdapter = {
+            name: 'fake-lib',
+            detect: (s) => typeof s === 'object' && s !== null && '__fakeJsonSchema' in s,
+            toJsonSchema: (s) => s.__fakeJsonSchema,
+        };
+        const fakeSchema = {
+            __fakeJsonSchema: {
+                type: 'object',
+                properties: { id: { type: 'string' } },
+                required: ['id'],
+            },
+        };
+        it('registers and validates with a custom schema adapter', async () => {
+            const { Create } = Procedures({ schema: { adapters: [fakeLibAdapter] } });
+            const { GetThing } = Create('GetThing', { schema: { params: fakeSchema } }, async (_ctx, params) => params);
+            await expect(GetThing({}, { id: 'a' })).resolves.toEqual({ id: 'a' });
+            await expect(GetThing({}, {})).rejects.toThrow(ProcedureValidationError);
+        });
+        it('custom adapters take precedence over the built-in TypeBox adapter', () => {
+            // An adapter that recognizes EVERYTHING and maps to a permissive schema —
+            // if it runs first, a TypeBox schema never reaches the typebox adapter.
+            const greedy = {
+                name: 'greedy',
+                detect: () => true,
+                toJsonSchema: () => ({ type: 'object' }),
+            };
+            const { Create } = Procedures({ schema: { adapters: [greedy] } });
+            const { Info } = { Info: Create('Info', { schema: { params: Type.Object({ n: Type.Number() }) } }, async () => 'ok') };
+            expect(Info.info.schema.params).toEqual({ type: 'object' });
+        });
+        it('TypeBox keeps working with custom adapters present', async () => {
+            const { Create } = Procedures({ schema: { adapters: [fakeLibAdapter] } });
+            const { Echo } = Create('Echo', { schema: { params: Type.Object({ n: Type.Number() }) } }, async (_ctx, p) => p);
+            await expect(Echo({}, { n: 1 })).resolves.toEqual({ n: 1 });
+        });
+    });
+    describe('validation.ajv', () => {
+        it('merges custom AJV options over the defaults', async () => {
+            const { Create } = Procedures({ validation: { ajv: { coerceTypes: false } } });
+            const { Strict } = Create('Strict', { schema: { params: Type.Object({ n: Type.Number() }) } }, async (_ctx, p) => p);
+            // Default config would coerce '1' → 1; with coerceTypes off it must fail.
+            await expect(Strict({}, { n: '1' })).rejects.toThrow(ProcedureValidationError);
+            await expect(Strict({}, { n: 1 })).resolves.toEqual({ n: 1 });
+        });
+    });
+    describe('http defaults', () => {
+        const reqId = { req: { pathParams: Type.Object({ id: Type.String() }) } };
+        it('applies pathPrefix and scope to CreateHttp routes', () => {
+            const { CreateHttp } = Procedures({ http: { pathPrefix: '/v1', scope: 'billing' } });
+            const { info } = CreateHttp('GetInvoice', { path: '/invoices/:id', method: 'get', schema: reqId }, async () => undefined);
+            expect(info.path).toBe('/v1/invoices/:id');
+            expect(info.scope).toBe('billing');
+        });
+        it('per-route scope wins over the factory default', () => {
+            const { CreateHttp } = Procedures({ http: { scope: 'billing' } });
+            const { info } = CreateHttp('GetReport', { path: '/reports', method: 'get', scope: 'reports', schema: {} }, async () => undefined);
+            expect(info.scope).toBe('reports');
+            expect(info.path).toBe('/reports');
+        });
+        it('applies pathPrefix to CreateHttpStream routes', () => {
+            const { CreateHttpStream } = Procedures({ http: { pathPrefix: 'v1' } });
+            const { info } = CreateHttpStream('Watch', { path: 'watch', method: 'get', schema: {} }, 
+            // eslint-disable-next-line require-yield
+            async function* () { return undefined; });
+            // both prefix and path get normalized to a single joining slash
+            expect(info.path).toBe('/v1/watch');
+        });
+        it('path-param consistency is checked against the prefixed path', () => {
+            const { CreateHttp } = Procedures({ http: { pathPrefix: '/v1' } });
+            expect(() => CreateHttp('Bad', { path: '/things/:id', method: 'get', schema: {} }, async () => undefined)).toThrow(/path parameters \[id\] but schema\.req\.pathParams is not defined/);
+        });
+    });
+});
+//# sourceMappingURL=factory-options.test.js.map

package/build/core/factory-options.test.js.map

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

package/build/core/http-route.d.ts

@@ -0,0 +1,13 @@
+import type { DefinitionInfo } from './definition-site.js';
+export declare function extractPathParamNames(path: string): string[];
+/**
+ * Applies the factory-level `http.pathPrefix` default to a route path.
+ * Both sides are normalized to exactly one joining `/`.
+ */
+export declare function applyPathPrefix(prefix: string | undefined, path: string): string;
+/**
+ * Registration-time guard: the `:params` in the path and the keys of
+ * `schema.req.pathParams` must agree exactly. Catches typos where a handler
+ * would silently receive `undefined` for a misspelled param.
+ */
+export declare function checkPathParamConsistency(procedureName: string, path: string, pathParamsSchema: Record<string, unknown> | undefined, definitionInfo: DefinitionInfo): void;

package/build/core/http-route.js

@@ -0,0 +1,54 @@
+/**
+ * Route-shape helpers shared by CreateHttp and CreateHttpStream.
+ */
+import { ProcedureRegistrationError } from './errors.js';
+const PATH_PARAM_RE = /:([a-zA-Z_][a-zA-Z0-9_]*)/g;
+export function extractPathParamNames(path) {
+    const matches = path.match(PATH_PARAM_RE);
+    return matches ? matches.map((m) => m.slice(1)) : [];
+}
+/**
+ * Applies the factory-level `http.pathPrefix` default to a route path.
+ * Both sides are normalized to exactly one joining `/`.
+ */
+export function applyPathPrefix(prefix, path) {
+    if (!prefix)
+        return path;
+    const normalizedPrefix = prefix.startsWith('/') ? prefix : `/${prefix}`;
+    const trimmedPrefix = normalizedPrefix.endsWith('/') ? normalizedPrefix.slice(0, -1) : normalizedPrefix;
+    const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+    return `${trimmedPrefix}${normalizedPath}`;
+}
+/**
+ * Registration-time guard: the `:params` in the path and the keys of
+ * `schema.req.pathParams` must agree exactly. Catches typos where a handler
+ * would silently receive `undefined` for a misspelled param.
+ */
+export function checkPathParamConsistency(procedureName, path, pathParamsSchema, definitionInfo) {
+    const pathParamNames = extractPathParamNames(path);
+    const hasPathParams = pathParamNames.length > 0;
+    const hasSchema = pathParamsSchema !== undefined;
+    if (hasPathParams && !hasSchema) {
+        throw new ProcedureRegistrationError(procedureName, `Path "${path}" has path parameters [${pathParamNames.join(', ')}] but schema.req.pathParams is not defined.`, definitionInfo);
+    }
+    if (!hasPathParams && hasSchema) {
+        throw new ProcedureRegistrationError(procedureName, `schema.req.pathParams is defined but path "${path}" has no path parameters.`, definitionInfo);
+    }
+    if (hasPathParams && hasSchema) {
+        const schemaProperties = pathParamsSchema.properties;
+        if (schemaProperties) {
+            const schemaKeys = Object.keys(schemaProperties);
+            const missing = pathParamNames.filter((p) => !schemaKeys.includes(p));
+            const extra = schemaKeys.filter((k) => !pathParamNames.includes(k));
+            if (missing.length > 0 || extra.length > 0) {
+                const parts = [];
+                if (missing.length > 0)
+                    parts.push(`path has [${missing.join(', ')}] missing from schema`);
+                if (extra.length > 0)
+                    parts.push(`schema has [${extra.join(', ')}] not in path`);
+                throw new ProcedureRegistrationError(procedureName, `Path param mismatch for "${procedureName}": ${parts.join('; ')}.`, definitionInfo);
+            }
+        }
+    }
+}
+//# sourceMappingURL=http-route.js.map

package/build/core/http-route.js.map

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

package/build/core/internal.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Shared machinery for the four creators. Everything here is package-private:
+ * the public API is `Procedures()` and the creators it returns.
+ */
+import { ProcedureError } from './errors.js';
+import type { DefinitionInfo } from './definition-site.js';
+import type { AnyProcedureRegistration } from './types.js';
+import type { SchemaAdapter } from '../schema/adapter.js';
+import type { Validate, ValidatorCompiler } from '../schema/compile.js';
+/**
+ * Everything a creator needs from its owning factory, resolved once in
+ * `Procedures()`.
+ */
+export type FactoryRuntime<TContext, TExtendedConfig> = {
+    registry: Map<string, AnyProcedureRegistration<TContext, TExtendedConfig>>;
+    onCreate?: (procedure: AnyProcedureRegistration<TContext, TExtendedConfig>) => void;
+    /** True when the factory was created with `validation: false`. */
+    skipValidation: boolean;
+    adapters: readonly SchemaAdapter[];
+    compile: ValidatorCompiler;
+    httpDefaults?: {
+        pathPrefix?: string;
+        scope?: string;
+    };
+};
+/** Create/CreateStream reject HTTP-only config fields with a pointer to CreateHttp. */
+export declare function assertNoHttpFields(creatorName: 'Create' | 'CreateStream', procedureName: string, config: Record<string, unknown>, definitionInfo: DefinitionInfo): void;
+/** Duplicate names fail fast, BEFORE schema computation. */
+export declare function assertNotDuplicate(registry: Map<string, unknown>, name: string, definitionInfo: DefinitionInfo): void;
+/**
+ * Should this call skip runtime validation? Either the caller already
+ * validated (`ctx.isPrevalidated`, set by HTTP builders) or the whole factory
+ * opted out (`validation: false`).
+ */
+export declare function shouldSkipValidation(ctx: unknown, runtime: {
+    skipValidation: boolean;
+}): boolean;
+/** Validates RPC params; throws `ProcedureValidationError` on failure. */
+export declare function validateParams(name: string, validate: Validate | undefined, params: unknown, definitionInfo: DefinitionInfo): void;
+/** Validates each HTTP req channel independently; error messages name the channel. */
+export declare function validateReqChannels(name: string, validators: Record<string, Validate> | undefined, req: unknown, definitionInfo: DefinitionInfo): void;
+/**
+ * Boxes a non-ProcedureError thrown by a unary handler into a ProcedureError
+ * (original error as `cause`), preserving the original stack and appending
+ * the definition site. ProcedureErrors pass through untouched.
+ */
+export declare function toProcedureError(name: string, definitionInfo: DefinitionInfo, error: any): ProcedureError;
+/** Appends the definition site to a thrown error's stack, in place. */
+export declare function appendDefinitionSite(error: any, name: string, definitionInfo: DefinitionInfo): void;
+/** Combines an incoming (e.g. HTTP request) signal with the stream's own controller. */
+export declare function combineSignals(incoming: AbortSignal | undefined, own: AbortSignal): AbortSignal;
+/**
+ * Drives a user stream iterator with the framework guarantees shared by
+ * CreateStream and CreateHttpStream:
+ * - optional per-yield validation (`validateYields: true`)
+ * - errors get the definition site appended to their stack — but keep their
+ *   original class, so HTTP taxonomies and typed-error dispatch see the real
+ *   thrown value
+ * - on ANY exit, the user iterator's `return()` runs (its `finally` blocks
+ *   fire on early consumer close) and the controller aborts with reason
+ *   `'stream-completed'` so handlers can distinguish completion from client
+ *   disconnect
+ * - the user generator's return value is propagated (becomes the
+ *   `event: 'return'` SSE payload downstream)
+ */
+export declare function iterateWithGuards(userIterator: AsyncIterator<any, any, unknown>, options: {
+    name: string;
+    validateYields: boolean;
+    validateYield: Validate | undefined;
+    abortController: AbortController;
+    definitionInfo: DefinitionInfo;
+}): AsyncGenerator<any, any, unknown>;