ts-procedures 10.1.2 → 10.2.1

package/build/core/internal.js

@@ -77,6 +77,28 @@ export function appendDefinitionSite(error, name, definitionInfo) {
 export function combineSignals(incoming, own) {
     return incoming ? AbortSignal.any([incoming, own]) : own;
 }
+/**
+ * Apply factory-defined middlewares around a core invocation.
+ * Middlewares run from first to last; each sees the (possibly augmented) ctx + input.
+ * Supports both unary results and async generators (for streams).
+ */
+export function runWithMiddlewares(middlewares, ctx, input, core) {
+    if (!middlewares.length) {
+        return core(ctx, input);
+    }
+    // Build the chain from the inside out
+    let current = core;
+    for (let i = middlewares.length - 1; i >= 0; i--) {
+        const mw = middlewares[i];
+        const previous = current;
+        current = (c, i) => mw({
+            ctx: c,
+            input: i,
+            next: (o = {}) => previous(o.ctx ?? c, o.input ?? i),
+        });
+    }
+    return current(ctx, input);
+}
 /**
  * Drives a user stream iterator with the framework guarantees shared by
  * CreateStream and CreateHttpStream:

package/build/core/internal.js.map

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

package/build/core/procedures.d.ts

@@ -10,6 +10,7 @@ import type { AnyProcedureRegistration, ProceduresOptions, TNoContextProvided }
  *     schema: { adapters: [myZodAdapter] },        // TypeBox is built in
  *     http: { pathPrefix: '/v1', scope: 'billing' }, // CreateHttp* defaults
  *     onCreate: (procedure) => log(procedure.kind, procedure.name),
+ *     // middleware: [ myFactoryGuard ],   // runs with final ctx + input for every proc
  *   })
  * ```
  *
@@ -18,6 +19,8 @@ import type { AnyProcedureRegistration, ProceduresOptions, TNoContextProvided }
  * - `TExtendedConfig` — extra per-procedure config fields (e.g. `scope`,
  *   `version`, auth flags) carried through to registrations, `info`, and
  *   `onCreate`.
+ * - `middleware` — factory-level middleware with access to the final ctx + input
+ *   ("parse the incoming call") for authz, enrichment, etc. See `FactoryMiddleware`.
  */
 export declare function Procedures<TContext = TNoContextProvided, TExtendedConfig = unknown>(options?: ProceduresOptions<TContext, TExtendedConfig>): {
     /** All registered procedures, in registration order. */
@@ -70,10 +73,7 @@ export declare function Procedures<TContext = TNoContextProvided, TExtendedConfi
             yield?: import("../schema/compile.js").Validate;
         } | undefined;
     } & TExtendedConfig>;
-    CreateHttp: <TName extends string, TReq extends Record<string, unknown> | undefined = undefined, TRes extends {
-        body?: unknown;
-        headers?: unknown;
-    } | undefined = undefined, TErrorKey extends string = string>(name: TName, config: import("./types.js").TCreateHttpConfig<TReq, TRes, TErrorKey>, handler: (ctx: TContext & import("./types.js").TLocalContext extends infer T ? { [Key in keyof T]: T[Key]; } : never, req: TReq extends Record<string, unknown> ? { [Key_1 in keyof { [K in keyof TReq]: import("../exports.js").Infer<TReq[K]>; }]: { [K in keyof TReq]: import("../exports.js").Infer<TReq[K]>; }[Key_1]; } : undefined) => Promise<import("./create-http.js").HttpReturn<TRes>>) => import("./types.js").ProcedureResult<TName, (ctx: { [Key in keyof TContext]: TContext[Key]; }, req: TReq extends Record<string, unknown> ? { [Key_1 in keyof { [K in keyof TReq]: import("../exports.js").Infer<TReq[K]>; }]: { [K in keyof TReq]: import("../exports.js").Infer<TReq[K]>; }[Key_1]; } : undefined) => Promise<import("./create-http.js").HttpReturn<TRes>>, {
+    CreateHttp: <TName extends string, TReq extends import("./types.js").THttpReqInput | undefined = undefined, TRes extends import("./types.js").THttpResInput | undefined = undefined, TErrorKey extends string = string>(name: TName, config: import("./types.js").TCreateHttpConfig<TReq, TRes, TErrorKey>, handler: (ctx: TContext & import("./types.js").TLocalContext extends infer T ? { [Key in keyof T]: T[Key]; } : never, req: import("./types.js").HttpReq<TReq>) => Promise<import("./create-http.js").HttpReturn<TRes>>) => import("./types.js").ProcedureResult<TName, (ctx: { [Key in keyof TContext]: TContext[Key]; }, req: import("./types.js").HttpReq<TReq>) => Promise<import("./create-http.js").HttpReturn<TRes>>, {
         path: string;
         method: import("./types.js").HttpMethod;
         successStatus?: number;
@@ -93,29 +93,22 @@ export declare function Procedures<TContext = TNoContextProvided, TExtendedConfi
         name: TName;
         kind: "http";
     }>;
-    CreateHttpStream: <TName extends string, TReq extends Record<string, unknown> | undefined, TYieldType, TReturnType = void, TResHeaders = undefined, TErrorKey extends string = string>(name: TName, config: {
+    CreateHttpStream: <TName extends string, TReq extends import("./types.js").THttpReqInput | undefined, TYieldType, TReturnType = void, TResHeaders = undefined, TErrorKey extends string = string>(name: TName, config: {
         path: string;
         method: import("./types.js").HttpMethod;
         scope?: string;
         errors?: TErrorKey[] | undefined;
         description?: string;
-        schema: {
-            req?: TReq | undefined;
-            yield?: TYieldType | undefined;
-            returnType?: TReturnType | undefined;
-            res?: (TResHeaders extends undefined ? undefined : {
-                headers: TResHeaders;
-            }) | undefined;
-        };
+        schema: import("./types.js").THttpStreamSchema<TReq, TYieldType, TReturnType, TResHeaders>;
         validateYields?: boolean;
     }, handler: TResHeaders extends undefined ? (ctx: TContext & import("./types.js").TLocalContext & {
         signal: AbortSignal;
-    } extends infer T ? { [Key in keyof T]: T[Key]; } : never, req: TReq extends Record<string, unknown> ? { [Key_1 in keyof { [K in keyof TReq]: import("../exports.js").Infer<TReq[K]>; }]: { [K in keyof TReq]: import("../exports.js").Infer<TReq[K]>; }[Key_1]; } : undefined) => AsyncGenerator<import("../exports.js").Infer<TYieldType>, void | import("../exports.js").Infer<TReturnType>, unknown> : (ctx: TContext & import("./types.js").TLocalContext & {
+    } extends infer T ? { [Key in keyof T]: T[Key]; } : never, req: import("./types.js").HttpReq<TReq>) => AsyncGenerator<import("../exports.js").Infer<TYieldType>, void | import("../exports.js").Infer<TReturnType>, unknown> : (ctx: TContext & import("./types.js").TLocalContext & {
         signal: AbortSignal;
-    } extends infer T ? { [Key in keyof T]: T[Key]; } : never, req: TReq extends Record<string, unknown> ? { [Key_1 in keyof { [K in keyof TReq]: import("../exports.js").Infer<TReq[K]>; }]: { [K in keyof TReq]: import("../exports.js").Infer<TReq[K]>; }[Key_1]; } : undefined) => Promise<{
+    } extends infer T ? { [Key in keyof T]: T[Key]; } : never, req: import("./types.js").HttpReq<TReq>) => Promise<{
         headers: import("../exports.js").Infer<TResHeaders>;
         stream: AsyncGenerator<import("../exports.js").Infer<TYieldType>, void | import("../exports.js").Infer<TReturnType>, unknown>;
-    }>) => import("./types.js").ProcedureResult<TName, (ctx: { [Key in keyof TContext]: TContext[Key]; }, req: TReq extends Record<string, unknown> ? { [Key_1 in keyof { [K in keyof TReq]: import("../exports.js").Infer<TReq[K]>; }]: { [K in keyof TReq]: import("../exports.js").Infer<TReq[K]>; }[Key_1]; } : undefined) => Promise<{
+    }>) => import("./types.js").ProcedureResult<TName, (ctx: { [Key in keyof TContext]: TContext[Key]; }, req: import("./types.js").HttpReq<TReq>) => Promise<{
         stream: AsyncGenerator<import("../exports.js").Infer<TYieldType>, void | import("../exports.js").Infer<TReturnType>, unknown>;
         initialHeaders?: Record<string, string>;
     }>, {

package/build/core/procedures.js

@@ -15,6 +15,7 @@ import { typeboxAdapter } from '../schema/typebox.js';
  *     schema: { adapters: [myZodAdapter] },        // TypeBox is built in
  *     http: { pathPrefix: '/v1', scope: 'billing' }, // CreateHttp* defaults
  *     onCreate: (procedure) => log(procedure.kind, procedure.name),
+ *     // middleware: [ myFactoryGuard ],   // runs with final ctx + input for every proc
  *   })
  * ```
  *
@@ -23,6 +24,8 @@ import { typeboxAdapter } from '../schema/typebox.js';
  * - `TExtendedConfig` — extra per-procedure config fields (e.g. `scope`,
  *   `version`, auth flags) carried through to registrations, `info`, and
  *   `onCreate`.
+ * - `middleware` — factory-level middleware with access to the final ctx + input
+ *   ("parse the incoming call") for authz, enrichment, etc. See `FactoryMiddleware`.
  */
 export function Procedures(options) {
     const registry = new Map();
@@ -33,6 +36,7 @@ export function Procedures(options) {
         adapters: [...(options?.schema?.adapters ?? []), typeboxAdapter],
         compile: createValidatorCompiler(options?.validation === false ? undefined : options?.validation),
         httpDefaults: options?.http,
+        middlewares: options?.middleware ?? [],
     };
     const Create = makeCreate(runtime);
     const CreateStream = makeCreateStream(runtime);

package/build/core/procedures.js.map

@@ -1 +1 @@
-{"version":3,"file":"procedures.js","sourceRoot":"","sources":["../../src/core/procedures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAIrD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,UAAU,CACxB,OAAsD;IAEtD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA+D,CAAA;IAEvF,MAAM,OAAO,GAA8C;QACzD,QAAQ;QACR,QAAQ,EAAE,OAAO,EAAE,QAAQ;QAC3B,cAAc,EAAE,OAAO,EAAE,UAAU,KAAK,KAAK;QAC7C,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC,EAAE,cAAc,CAAC;QAChE,OAAO,EAAE,uBAAuB,CAAC,OAAO,EAAE,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC;QACjG,YAAY,EAAE,OAAO,EAAE,IAAI;KAC5B,CAAA;IAED,MAAM,MAAM,GAAG,UAAU,CAA4B,OAAO,CAAC,CAAA;IAC7D,MAAM,YAAY,GAAG,gBAAgB,CAA4B,OAAO,CAAC,CAAA;IACzE,MAAM,UAAU,GAAG,cAAc,CAAW,OAAO,CAAC,CAAA;IACpD,MAAM,gBAAgB,GAAG,oBAAoB,CAAW,OAAO,CAAC,CAAA;IAEhE,OAAO;QACL,wDAAwD;QACxD,aAAa,EAAE,GAAG,EAAE;YAClB,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;QACtC,CAAC;QAED,oCAAoC;QACpC,YAAY,EAAE,CAAC,IAAY,EAAE,EAAE;YAC7B,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC;QAED,+DAA+D;QAC/D,eAAe,EAAE,CAAC,IAAY,EAAE,EAAE;YAChC,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAC9B,CAAC;QAED,wCAAwC;QACxC,KAAK,EAAE,GAAG,EAAE;YACV,QAAQ,CAAC,KAAK,EAAE,CAAA;QAClB,CAAC;QAED,MAAM;QACN,YAAY;QACZ,UAAU;QACV,gBAAgB;KACjB,CAAA;AACH,CAAC"}
+{"version":3,"file":"procedures.js","sourceRoot":"","sources":["../../src/core/procedures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAIrD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,UAAU,CACxB,OAAsD;IAEtD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA+D,CAAA;IAEvF,MAAM,OAAO,GAA8C;QACzD,QAAQ;QACR,QAAQ,EAAE,OAAO,EAAE,QAAQ;QAC3B,cAAc,EAAE,OAAO,EAAE,UAAU,KAAK,KAAK;QAC7C,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC,EAAE,cAAc,CAAC;QAChE,OAAO,EAAE,uBAAuB,CAAC,OAAO,EAAE,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC;QACjG,YAAY,EAAE,OAAO,EAAE,IAAI;QAC3B,WAAW,EAAE,OAAO,EAAE,UAAU,IAAI,EAAE;KACvC,CAAA;IAED,MAAM,MAAM,GAAG,UAAU,CAA4B,OAAO,CAAC,CAAA;IAC7D,MAAM,YAAY,GAAG,gBAAgB,CAA4B,OAAO,CAAC,CAAA;IACzE,MAAM,UAAU,GAAG,cAAc,CAAW,OAAO,CAAC,CAAA;IACpD,MAAM,gBAAgB,GAAG,oBAAoB,CAAW,OAAO,CAAC,CAAA;IAEhE,OAAO;QACL,wDAAwD;QACxD,aAAa,EAAE,GAAG,EAAE;YAClB,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;QACtC,CAAC;QAED,oCAAoC;QACpC,YAAY,EAAE,CAAC,IAAY,EAAE,EAAE;YAC7B,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC;QAED,+DAA+D;QAC/D,eAAe,EAAE,CAAC,IAAY,EAAE,EAAE;YAChC,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAC9B,CAAC;QAED,wCAAwC;QACxC,KAAK,EAAE,GAAG,EAAE;YACV,QAAQ,CAAC,KAAK,EAAE,CAAA;QAClB,CAAC;QAED,MAAM;QACN,YAAY;QACZ,UAAU;QACV,gBAAgB;KACjB,CAAA;AACH,CAAC"}

package/build/core/types.d.ts

@@ -1,7 +1,7 @@
 import type * as AJV from 'ajv';
 import type { ProcedureError } from './errors.js';
 import type { SchemaAdapter } from '../schema/adapter.js';
-import type { TJSONSchema } from '../schema/json-schema.js';
+import type { Infer, Prettify, TJSONSchema } from '../schema/json-schema.js';
 import type { Validate } from '../schema/compile.js';
 export type TNoContextProvided = unknown;
 /**
@@ -61,7 +61,52 @@ export type TStreamProcedureRegistration<TContext = unknown, TExtendedConfig = u
     handler: (ctx: TContext, params?: any) => AsyncGenerator<any, any, unknown>;
 };
 export type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'head';
-export type TCreateHttpConfig<TReq, TRes, TErrorKey extends string = string> = {
+/**
+ * Canonical shape for `schema.req` channels.
+ * Used both to constrain generics and to provide autocomplete when writing
+ * `CreateHttp` / `CreateHttpStream` config objects.
+ *
+ * Note: RPC `Create` / `CreateStream` use a flatter `schema: { params?, yieldType?, returnType? }`
+ * directly (no extra container generic), so they don't need an equivalent named input shape.
+ */
+export type THttpReqInput = {
+    pathParams?: unknown;
+    query?: unknown;
+    body?: unknown;
+    headers?: unknown;
+};
+/**
+ * Canonical shape for `schema.res` on CreateHttp (CreateHttpStream only supports `headers`).
+ */
+export type THttpResInput = {
+    body?: unknown;
+    headers?: unknown;
+};
+/**
+ * @internal Helper to surface literal channel keys for autocomplete
+ * while still threading the user's concrete generic schemas through for inference.
+ */
+export type HttpSchemaInput<Base, T> = Base & (T extends undefined ? {} : T);
+/**
+ * @internal Shared helper for typing the destructured `req` argument passed to
+ * CreateHttp / CreateHttpStream handlers. Mirrors the per-channel Infer.
+ */
+export type HttpReq<TReq> = TReq extends Record<string, unknown> ? Prettify<{
+    [K in keyof TReq]: Infer<TReq[K]>;
+}> : undefined;
+/**
+ * Shape used for the `schema` option of `CreateHttpStream`.
+ * Reuses the same req input shape as CreateHttp for autocomplete consistency.
+ */
+export type THttpStreamSchema<TReq extends THttpReqInput | undefined = undefined, TYield = unknown, TReturn = void, TResHeaders = undefined> = {
+    req?: HttpSchemaInput<THttpReqInput, TReq>;
+    yield?: TYield;
+    returnType?: TReturn;
+    res?: TResHeaders extends undefined ? undefined : {
+        headers: TResHeaders;
+    };
+};
+export type TCreateHttpConfig<TReq extends THttpReqInput | undefined = undefined, TRes extends THttpResInput | undefined = undefined, TErrorKey extends string = string> = {
     path: string;
     method: HttpMethod;
     successStatus?: number;
@@ -70,8 +115,8 @@ export type TCreateHttpConfig<TReq, TRes, TErrorKey extends string = string> = {
     description?: string;
     /** Optional — a no-input, no-output route (e.g. a 204 logout) may omit it. */
     schema?: {
-        req?: TReq;
-        res?: TRes;
+        req?: HttpSchemaInput<THttpReqInput, TReq>;
+        res?: HttpSchemaInput<THttpResInput, TRes>;
     };
 };
 export type THttpProcedureRegistration<TContext = unknown> = {
@@ -180,4 +225,40 @@ export type ProceduresOptions<TContext = unknown, TExtendedConfig = unknown> = {
         pathPrefix?: string;
         scope?: string;
     };
+    /**
+     * Optional middleware that runs for *every* procedure defined via this factory.
+     * Runs after schema validation but before the user handler, with the *same*
+     * context the handler receives (including injected `error()` and `signal`).
+     *
+     * Use this for cross-cutting logic that needs the resolved `TContext` + the
+     * incoming call data ("parse the incoming call"):
+     * - Authorization / tenancy checks using `ctx.user` + `input`
+     * - Enriching ctx for all procedures on the factory
+     * - Auditing, feature flags, etc.
+     *
+     * The middleware receives a `next` function. Call `await next({ ctx?, input? })`
+     * to continue (optionally with augmented ctx or transformed input). You may
+     * also return/throw early.
+     *
+     * Works for both direct calls and all adapters. Complements (runs after)
+     * builder-level middleware on HonoAppBuilder.
+     */
+    middleware?: FactoryMiddleware<TContext>[];
 };
+/**
+ * Middleware defined on a Procedures factory.
+ *
+ * - `ctx` is the fully resolved context (your TContext + `error()` + `signal`).
+ * - `input` is the (already schema-validated) call argument:
+ *   - For Create / CreateStream: the `params` object
+ *   - For CreateHttp / CreateHttpStream: the `{ pathParams?, query?, body?, headers? }`
+ * - Call `next()` (or `next({ ctx: augmented, input: transformed })`) to proceed.
+ */
+export type FactoryMiddleware<TContext = unknown> = (opts: {
+    ctx: Prettify<TContext & TLocalContext>;
+    input: unknown;
+    next: (opts?: {
+        ctx?: any;
+        input?: unknown;
+    }) => Promise<any> | AsyncGenerator<any, any, unknown>;
+}) => Promise<any> | AsyncGenerator<any, any, unknown> | void;

package/build/errors.d.ts

@@ -0,0 +1,33 @@
+import { TSchemaValidationError } from './schema/parser.js';
+import { DefinitionInfo, DefinitionLocation } from './stack-utils.js';
+export declare class ProcedureError extends Error {
+    readonly procedureName: string;
+    readonly message: string;
+    readonly meta?: object | undefined;
+    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.
+     */
+    getDefinitionLocation(): string | undefined;
+    /**
+     * Enhances the error stack with definition location information.
+     */
+    private enhanceStack;
+}
+export declare class ProcedureValidationError extends ProcedureError {
+    readonly procedureName: string;
+    readonly errors?: TSchemaValidationError[] | undefined;
+    constructor(procedureName: string, message: string, errors?: TSchemaValidationError[] | undefined, definitionInfo?: DefinitionInfo);
+}
+export declare class ProcedureRegistrationError extends ProcedureError {
+    readonly procedureName: string;
+    constructor(procedureName: string, message: string, definitionInfo?: DefinitionInfo);
+}
+export declare class ProcedureYieldValidationError extends ProcedureError {
+    readonly procedureName: string;
+    readonly errors?: TSchemaValidationError[] | undefined;
+    constructor(procedureName: string, message: string, errors?: TSchemaValidationError[] | undefined, definitionInfo?: DefinitionInfo);
+}

package/build/errors.js

@@ -0,0 +1,91 @@
+import { formatDefinitionInfo } from './stack-utils.js';
+import { kebabCase } from 'es-toolkit/string';
+export class ProcedureError extends Error {
+    procedureName;
+    message;
+    meta;
+    cause;
+    definedAt;
+    definitionStack;
+    constructor(procedureName, message, meta, 
+    // Used for error stack trace details
+    definitionInfo) {
+        super(message);
+        this.procedureName = procedureName;
+        this.message = message;
+        this.meta = meta;
+        this.name = 'ProcedureError';
+        if (definitionInfo) {
+            this.definedAt = definitionInfo.definedAt;
+            this.definitionStack = definitionInfo.definitionStack;
+            this.enhanceStack();
+        }
+        // https://www.dannyguo.com/blog/how-to-fix-instanceof-not-working-for-custom-errors-in-typescript/
+        Object.setPrototypeOf(this, ProcedureError.prototype);
+    }
+    /**
+     * Returns a formatted string showing where the procedure was defined.
+     */
+    getDefinitionLocation() {
+        if (!this.definedAt) {
+            return undefined;
+        }
+        return `${this.definedAt.file}:${this.definedAt.line}:${this.definedAt.column}`;
+    }
+    /**
+     * Enhances the error stack with definition location information.
+     */
+    enhanceStack() {
+        if (!this.stack || !this.definedAt) {
+            return;
+        }
+        const definitionSection = formatDefinitionInfo({ definedAt: this.definedAt, definitionStack: this.definitionStack }, this.procedureName);
+        if (definitionSection) {
+            this.stack = this.stack + definitionSection;
+        }
+    }
+}
+export class ProcedureValidationError extends ProcedureError {
+    procedureName;
+    errors;
+    constructor(procedureName, message, errors, 
+    // Used for error stack trace details
+    definitionInfo) {
+        const readableErrors = errors
+            ?.map((err) => `- ${kebabCase(err.instancePath).replace('-', '.')} ${err.message}`)
+            .join(', ');
+        super(procedureName, message + ' ' + readableErrors, { errors }, definitionInfo);
+        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);
+    }
+}
+export class ProcedureRegistrationError extends ProcedureError {
+    procedureName;
+    constructor(procedureName, message, 
+    // Used for error stack trace details
+    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);
+    }
+}
+export class ProcedureYieldValidationError extends ProcedureError {
+    procedureName;
+    errors;
+    constructor(procedureName, message, errors, 
+    // Used for error stack trace details
+    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/errors.js.map

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

package/build/errors.test.d.ts

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

package/build/errors.test.js

@@ -0,0 +1,122 @@
+import { describe, expect, test } from 'vitest';
+import { ProcedureError, ProcedureValidationError, ProcedureRegistrationError, } from './errors.js';
+describe('Error Classes', () => {
+    test('ProcedureError has correct properties', () => {
+        const err = new ProcedureError('TestProc', 'Something failed', { code: 123 });
+        expect(err.name).toBe('ProcedureError');
+        expect(err.procedureName).toBe('TestProc');
+        expect(err.message).toBe('Something failed');
+        expect(err.meta).toEqual({ code: 123 });
+        expect(err instanceof Error).toBe(true);
+    });
+    test('ProcedureValidationError extends ProcedureError', () => {
+        const err = new ProcedureValidationError('TestProc', 'Validation failed', []);
+        expect(err instanceof ProcedureError).toBe(true);
+        expect(err instanceof Error).toBe(true);
+        expect(err.name).toBe('ProcedureValidationError');
+    });
+    test('ProcedureRegistrationError extends ProcedureError', () => {
+        const err = new ProcedureRegistrationError('TestProc', 'Registration failed');
+        expect(err instanceof ProcedureError).toBe(true);
+        expect(err instanceof Error).toBe(true);
+        expect(err.name).toBe('ProcedureRegistrationError');
+        expect(err.procedureName).toBe('TestProc');
+    });
+    test('ProcedureError supports cause property', () => {
+        const cause = new Error('Original error');
+        const err = new ProcedureError('TestProc', 'Wrapped error');
+        err.cause = cause;
+        expect(err.cause).toBe(cause);
+    });
+    test('All error types have consistent procedureName property', () => {
+        const baseErr = new ProcedureError('Proc1', 'message');
+        const validationErr = new ProcedureValidationError('Proc2', 'message', []);
+        const registrationErr = new ProcedureRegistrationError('Proc3', 'message');
+        expect(baseErr.procedureName).toBe('Proc1');
+        expect(validationErr.procedureName).toBe('Proc2');
+        expect(registrationErr.procedureName).toBe('Proc3');
+    });
+});
+describe('Error Classes - Definition Info', () => {
+    const mockDefinitionInfo = {
+        definedAt: {
+            file: '/app/procedures/user.ts',
+            line: 25,
+            column: 3,
+            raw: 'at Object.<anonymous> (/app/procedures/user.ts:25:3)',
+        },
+        definitionStack: 'Error\n    at Object.<anonymous> (/app/procedures/user.ts:25:3)',
+    };
+    test('ProcedureError includes definedAt when provided', () => {
+        const err = new ProcedureError('TestProc', 'Something failed', undefined, mockDefinitionInfo);
+        expect(err.definedAt).toBeDefined();
+        expect(err.definedAt?.file).toBe('/app/procedures/user.ts');
+        expect(err.definedAt?.line).toBe(25);
+        expect(err.definedAt?.column).toBe(3);
+    });
+    test('ProcedureError includes definitionStack when provided', () => {
+        const err = new ProcedureError('TestProc', 'Something failed', undefined, mockDefinitionInfo);
+        expect(err.definitionStack).toBeDefined();
+        expect(err.definitionStack).toContain('/app/procedures/user.ts');
+    });
+    test('ProcedureError works without definitionInfo (backward compat)', () => {
+        const err = new ProcedureError('TestProc', 'Something failed', { code: 123 });
+        expect(err.definedAt).toBeUndefined();
+        expect(err.definitionStack).toBeUndefined();
+        expect(err.procedureName).toBe('TestProc');
+        expect(err.message).toBe('Something failed');
+        expect(err.meta).toEqual({ code: 123 });
+    });
+    test('ProcedureValidationError includes definedAt when provided', () => {
+        const err = new ProcedureValidationError('TestProc', 'Validation failed', [], mockDefinitionInfo);
+        expect(err.definedAt).toBeDefined();
+        expect(err.definedAt?.file).toBe('/app/procedures/user.ts');
+        expect(err.definedAt?.line).toBe(25);
+    });
+    test('ProcedureValidationError works without definitionInfo (backward compat)', () => {
+        const err = new ProcedureValidationError('TestProc', 'Validation failed', []);
+        expect(err.definedAt).toBeUndefined();
+        expect(err.definitionStack).toBeUndefined();
+        expect(err.name).toBe('ProcedureValidationError');
+    });
+    test('ProcedureRegistrationError includes definedAt when provided', () => {
+        const err = new ProcedureRegistrationError('TestProc', 'Registration failed', mockDefinitionInfo);
+        expect(err.definedAt).toBeDefined();
+        expect(err.definedAt?.file).toBe('/app/procedures/user.ts');
+    });
+    test('ProcedureRegistrationError works without definitionInfo (backward compat)', () => {
+        const err = new ProcedureRegistrationError('TestProc', 'Registration failed');
+        expect(err.definedAt).toBeUndefined();
+        expect(err.definitionStack).toBeUndefined();
+        expect(err.name).toBe('ProcedureRegistrationError');
+    });
+    test('getDefinitionLocation returns formatted location string', () => {
+        const err = new ProcedureError('TestProc', 'Something failed', undefined, mockDefinitionInfo);
+        const location = err.getDefinitionLocation();
+        expect(location).toBe('/app/procedures/user.ts:25:3');
+    });
+    test('getDefinitionLocation returns undefined when no definedAt', () => {
+        const err = new ProcedureError('TestProc', 'Something failed');
+        const location = err.getDefinitionLocation();
+        expect(location).toBeUndefined();
+    });
+    test('enhanced stack contains definition location', () => {
+        const err = new ProcedureError('TestProc', 'Something failed', undefined, mockDefinitionInfo);
+        expect(err.stack).toContain('--- Procedure "TestProc" defined at ---');
+        expect(err.stack).toContain('/app/procedures/user.ts:25:3');
+    });
+    test('stack is not modified when no definitionInfo', () => {
+        const err = new ProcedureError('TestProc', 'Something failed');
+        expect(err.stack).toBeDefined();
+        expect(err.stack).not.toContain('--- Procedure');
+    });
+    test('all error types enhance stack with definition location', () => {
+        const baseErr = new ProcedureError('Proc1', 'message', undefined, mockDefinitionInfo);
+        const validationErr = new ProcedureValidationError('Proc2', 'message', [], mockDefinitionInfo);
+        const registrationErr = new ProcedureRegistrationError('Proc3', 'message', mockDefinitionInfo);
+        expect(baseErr.stack).toContain('--- Procedure "Proc1" defined at ---');
+        expect(validationErr.stack).toContain('--- Procedure "Proc2" defined at ---');
+        expect(registrationErr.stack).toContain('--- Procedure "Proc3" defined at ---');
+    });
+});
+//# sourceMappingURL=errors.test.js.map

package/build/errors.test.js.map

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

package/build/exports.d.ts

@@ -12,7 +12,7 @@
  * - `ts-procedures/codegen` — client code generation (also: npx ts-procedures-codegen)
  */
 export { Procedures } from './core/procedures.js';
-export type { ProceduresOptions, ProcedureKind, AnyProcedureRegistration, TProcedureRegistration, TStreamProcedureRegistration, THttpProcedureRegistration, THttpStreamProcedureRegistration, TCreateHttpConfig, TLocalContext, TStreamContext, TNoContextProvided, HttpMethod, } from './core/types.js';
+export type { ProceduresOptions, ProcedureKind, AnyProcedureRegistration, TProcedureRegistration, TStreamProcedureRegistration, THttpProcedureRegistration, THttpStreamProcedureRegistration, TCreateHttpConfig, THttpReqInput, THttpResInput, THttpStreamSchema, HttpSchemaInput, HttpReq, TLocalContext, TStreamContext, TNoContextProvided, HttpMethod, FactoryMiddleware, } from './core/types.js';
 export type { HttpReturn } from './core/create-http.js';
 export { ProcedureError, ProcedureValidationError, ProcedureRegistrationError, ProcedureYieldValidationError, } from './core/errors.js';
 export type { ProcedureErrorKind } from './core/errors.js';
@@ -27,6 +27,5 @@ export { createValidatorCompiler, DEFAULT_AJV_OPTIONS } from './schema/compile.j
 export type { Validate, ValidatorCompiler, ValidationOptions, TSchemaValidationError, } from './schema/compile.js';
 export type { Infer, TSchemaLib, TJSONSchema, Prettify } from './schema/json-schema.js';
 export { writeDocEnvelope } from './server/doc-envelope.js';
-export { DOC_ENVELOPE_SPEC_VERSION } from './server/spec-version.js';
 export type { DocEnvelopeSource } from './server/doc-envelope.js';
 export type { DocEnvelope } from './server/types.js';

package/build/exports.js

@@ -21,8 +21,4 @@ export { computeSchema } from './schema/compute-schema.js';
 export { createValidatorCompiler, DEFAULT_AJV_OPTIONS } from './schema/compile.js';
 // Doc envelope — offline codegen input
 export { writeDocEnvelope } from './server/doc-envelope.js';
-// `generatorVersion` metadata lives on `ts-procedures/server`
-// (DOC_ENVELOPE_GENERATOR_VERSION) — it's niche telemetry. The spec version is
-// the one consumers branch on, so it gets the prominent top-level export.
-export { DOC_ENVELOPE_SPEC_VERSION } from './server/spec-version.js';
 //# sourceMappingURL=exports.js.map

package/build/exports.js.map

@@ -1 +1 @@
-{"version":3,"file":"exports.js","sourceRoot":"","sources":["../src/exports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,8DAA8D;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAgBjD,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAKvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAE1D,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AASlF,uCAAuC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,8DAA8D;AAC9D,+EAA+E;AAC/E,0EAA0E;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../src/exports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,8DAA8D;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAsBjD,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAKvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAE1D,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AASlF,uCAAuC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA"}

package/build/implementations/http/doc-registry.d.ts

@@ -0,0 +1,28 @@
+import type { AnyHttpRouteDoc, DocEnvelope, DocRegistryConfig, DocRegistryOutputOptions, DocSource, ErrorDoc } from '../types.js';
+export type { AnyHttpRouteDoc, DocEnvelope, DocRegistryConfig, DocRegistryOutputOptions, DocSource, ErrorDoc, HeaderDoc, } from '../types.js';
+export declare class DocRegistry {
+    private readonly basePath;
+    private readonly headers;
+    private errors;
+    private readonly sources;
+    constructor(config?: DocRegistryConfig);
+    from(source: DocSource<AnyHttpRouteDoc>): this;
+    /**
+     * Adds one or more {@link ErrorDoc} entries to the envelope. Use for errors
+     * outside your runtime taxonomy — middleware-level errors, infrastructure
+     * errors (502/503/504), or doc-only meta errors.
+     *
+     * Deduped by `name` — last write wins.
+     */
+    documentError(...docs: ErrorDoc[]): this;
+    toJSON<T = DocEnvelope>(options?: DocRegistryOutputOptions<T>): T;
+    /**
+     * Framework error defaults — derived from {@link defaultErrorTaxonomy} plus
+     * `ProcedureRegistrationError` (which is thrown only at registration time
+     * and therefore lives in the catalog, not the runtime taxonomy).
+     *
+     * Most consumers do not need to call this directly — the `DocRegistry`
+     * constructor auto-includes these unless `includeDefaults: false` is passed.
+     */
+    static defaultErrors(): ErrorDoc[];
+}