ts-procedures 3.1.0 → 3.3.0

package/README.md

@@ -71,6 +71,34 @@ Create(name, config, handler)
 - `procedure` - Generic reference to the handler
 - `info` - Procedure meta (name, description, schema, `TExtendedConfig` properties, etc.)
 
+### CreateStream Function
+
+The `CreateStream` function defines streaming procedures that yield values over time using async generators:
+
+```typescript
+CreateStream(name, config, handler)
+```
+
+**Config Options:**
+- `schema.params` - Input parameter schema (validated at runtime)
+- `schema.yieldType` - Schema for each yielded value (validated if `validateYields: true`)
+- `schema.returnType` - Schema for final return value (documentation only)
+- `validateYields` - Enable runtime validation of yielded values (default: `false`)
+
+**Handler Signature:**
+```typescript
+async function* (ctx, params) => AsyncGenerator<TYield, TReturn | void>
+```
+
+**Context Extensions:**
+- `ctx.error(message, meta?)` - Create a ProcedureError
+- `ctx.signal` - AbortSignal for cancellation support
+
+**Returns:**
+- `{ [name]: handler }` - Named generator export
+- `procedure` - Generic reference to the generator
+- `info` - Procedure meta with `isStream: true`
+
 ## Using Generics
 
 ### Base Context
@@ -237,6 +265,193 @@ AJV is configured with:
 
 **Note:** `schema.params` is validated at runtime. `schema.returnType` is for documentation/introspection only.
 
+## Streaming Procedures
+
+Streaming procedures use async generators to yield values over time, enabling SSE (Server-Sent Events), HTTP streaming, and real-time data feeds.
+
+### Basic Streaming
+
+```typescript
+import { Procedures } from 'ts-procedures'
+import { v } from 'suretype'
+
+const { CreateStream } = Procedures<{ userId: string }>()
+
+const { StreamUpdates } = CreateStream(
+  'StreamUpdates',
+  {
+    description: 'Stream real-time updates',
+    schema: {
+      params: v.object({ topic: v.string().required() }),
+      yieldType: v.object({
+        id: v.string().required(),
+        message: v.string().required(),
+        timestamp: v.number().required(),
+      }),
+    },
+  },
+  async function* (ctx, params) {
+    // Types are inferred from schema:
+    // - params.topic: string
+    // - yield value must match { id, message, timestamp }
+    // - ctx.signal: AbortSignal for cancellation
+
+    let counter = 0
+    while (!ctx.signal.aborted) {
+      yield {
+        id: `${counter++}`,
+        message: `Update for ${params.topic}`,
+        timestamp: Date.now(),
+      }
+      await new Promise(r => setTimeout(r, 1000))
+    }
+  },
+)
+
+// Consume the stream
+for await (const update of StreamUpdates({ userId: 'user-123' }, { topic: 'news' })) {
+  console.log(update.message)
+}
+```
+
+### Yield Validation
+
+By default, yielded values are not validated for performance. Enable validation with `validateYields: true`:
+
+```typescript
+const { ValidatedStream } = CreateStream(
+  'ValidatedStream',
+  {
+    schema: {
+      yieldType: v.object({ count: v.number().required() }),
+    },
+    validateYields: true, // Enable runtime validation of each yield
+  },
+  async function* () {
+    yield { count: 1 }  // Valid
+    yield { count: 2 }  // Valid
+    // yield { count: 'invalid' } // Would throw ProcedureYieldValidationError
+  },
+)
+```
+
+### Abort Signal Integration
+
+The `ctx.signal` allows handlers to detect when consumers stop iterating:
+
+```typescript
+const { CancellableStream } = CreateStream(
+  'CancellableStream',
+  {},
+  async function* (ctx) {
+    try {
+      while (!ctx.signal.aborted) {
+        yield await fetchNextItem()
+      }
+    } finally {
+      // Cleanup when stream ends (consumer stopped or completed)
+      await cleanup()
+    }
+  },
+)
+
+// Consumer can break early - signal.aborted becomes true
+for await (const item of CancellableStream({}, {})) {
+  if (shouldStop) break // Triggers abort
+}
+```
+
+### SSE Integration Example
+
+```typescript
+import express from 'express'
+import { Procedures } from 'ts-procedures'
+
+const app = express()
+
+const { CreateStream, getProcedures } = Procedures<{ req: express.Request }>({
+  onCreate: (proc) => {
+    if (proc.isStream) {
+      // Register streaming procedures as SSE endpoints
+      app.get(`/stream/${proc.name}`, async (req, res) => {
+        res.writeHead(200, {
+          'Content-Type': 'text/event-stream',
+          'Cache-Control': 'no-cache',
+          'Connection': 'keep-alive',
+        })
+
+        const generator = proc.handler({ req }, req.query)
+
+        req.on('close', async () => {
+          // Client disconnected - stop the generator
+          await generator.return(undefined)
+        })
+
+        try {
+          for await (const data of generator) {
+            res.write(`data: ${JSON.stringify(data)}\n\n`)
+          }
+        } finally {
+          res.end()
+        }
+      })
+    }
+  },
+})
+
+// Define a streaming procedure
+CreateStream(
+  'LiveFeed',
+  {
+    schema: {
+      params: v.object({ channel: v.string() }),
+      yieldType: v.object({ event: v.string(), data: v.any() }),
+    },
+  },
+  async function* (ctx, params) {
+    while (!ctx.signal.aborted) {
+      const event = await pollForEvent(params.channel)
+      yield event
+    }
+  },
+)
+
+app.listen(3000)
+// SSE endpoint: GET /stream/LiveFeed?channel=updates
+```
+
+### Stream Errors
+
+Streaming procedures support the same error handling as regular procedures:
+
+```typescript
+const { StreamWithErrors } = CreateStream(
+  'StreamWithErrors',
+  {},
+  async function* (ctx) {
+    yield { status: 'starting' }
+
+    const data = await fetchData()
+    if (!data) {
+      throw ctx.error('No data available', { code: 'NO_DATA' })
+    }
+
+    yield { status: 'complete', data }
+  },
+)
+
+try {
+  for await (const item of StreamWithErrors({}, {})) {
+    console.log(item)
+  }
+} catch (e) {
+  if (e instanceof ProcedureError) {
+    console.log(e.message) // 'No data available'
+    console.log(e.meta)    // { code: 'NO_DATA' }
+  }
+}
+```
+
 ## Error Handling
 
 ### Using ctx.error()
@@ -262,7 +477,8 @@ Create(
 | Error Class | Trigger |
 |-------------|---------|
 | ProcedureError | `ctx.error()` in handlers |
-| ProcedureValidationError | Schema validation failure |
+| ProcedureValidationError | Schema validation failure (params) |
+| ProcedureYieldValidationError | Yield validation failure (streaming with `validateYields: true`) |
 | ProcedureRegistrationError | Invalid schema at registration |
 
 ### Error Properties
@@ -470,10 +686,13 @@ import {
   ProcedureError,
   ProcedureValidationError,
   ProcedureRegistrationError,
-  
+  ProcedureYieldValidationError,  // For streaming yield validation
+
   // Types
   TLocalContext,
+  TStreamContext,               // Streaming context with AbortSignal
   TProcedureRegistration,
+  TStreamProcedureRegistration, // Streaming procedure registration
   TNoContextProvided,
 
   // Schema utilities
@@ -485,6 +704,7 @@ import {
   // Schema types
   TJSONSchema,
   TSchemaLib,
+  TSchemaLibGenerator,          // AsyncGenerator type utility
   TSchemaParsed,
   TSchemaValidationError,
   Prettify,

package/build/errors.d.ts

@@ -1,17 +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;
-    constructor(procedureName: string, message: string, meta?: object | undefined);
+    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);
+    constructor(procedureName: string, message: string, errors?: TSchemaValidationError[] | undefined, definitionInfo?: DefinitionInfo);
 }
 export declare class ProcedureRegistrationError extends ProcedureError {
     readonly procedureName: string;
-    constructor(procedureName: string, message: 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

@@ -1,23 +1,56 @@
+import { formatDefinitionInfo } from './stack-utils.js';
 export class ProcedureError extends Error {
     procedureName;
     message;
     meta;
     cause;
-    constructor(procedureName, message, meta) {
+    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) {
-        super(procedureName, message);
+    constructor(procedureName, message, errors, 
+    // Used for error stack trace details
+    definitionInfo) {
+        super(procedureName, message, undefined, definitionInfo);
         this.procedureName = procedureName;
         this.errors = errors;
         this.name = 'ProcedureValidationError';
@@ -27,12 +60,28 @@ export class ProcedureValidationError extends ProcedureError {
 }
 export class ProcedureRegistrationError extends ProcedureError {
     procedureName;
-    constructor(procedureName, message) {
-        super(procedureName, message);
+    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

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,cAAe,SAAQ,KAAK;IAI5B;IACA;IACA;IALX,KAAK,CAAU;IAEf,YACW,aAAqB,EACrB,OAAe,EACf,IAAa;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAA;QAJL,kBAAa,GAAb,aAAa,CAAQ;QACrB,YAAO,GAAP,OAAO,CAAQ;QACf,SAAI,GAAJ,IAAI,CAAS;QAGtB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAE5B,mGAAmG;QACnG,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAA;IACvD,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,cAAc;IAE/C;IAEA;IAHX,YACW,aAAqB,EAC9B,OAAe,EACN,MAAiC;QAE1C,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;QAJpB,kBAAa,GAAb,aAAa,CAAQ;QAErB,WAAM,GAAN,MAAM,CAA2B;QAG1C,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAA;QAEtC,mGAAmG;QACnG,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAA;IACjE,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,cAAc;IACvC;IAArB,YAAqB,aAAqB,EAAE,OAAe;QACzD,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;QADV,kBAAa,GAAb,aAAa,CAAQ;QAExC,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAA;QAExC,mGAAmG;QACnG,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAA;IACnE,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/build/errors.test.js

@@ -37,4 +37,86 @@ describe('Error Classes', () => {
         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

@@ -1 +1 @@
-{"version":3,"file":"errors.test.js","sourceRoot":"","sources":["../src/errors.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC/C,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,aAAa,CAAA;AAEpB,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE;QACjD,MAAM,GAAG,GAAG,IAAI,cAAc,CAAC,UAAU,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAA;QAE7E,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;QACvC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC1C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;QAC5C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAA;QACvC,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,iDAAiD,EAAE,GAAG,EAAE;QAC3D,MAAM,GAAG,GAAG,IAAI,wBAAwB,CAAC,UAAU,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAA;QAE7E,MAAM,CAAC,GAAG,YAAY,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChD,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC7D,MAAM,GAAG,GAAG,IAAI,0BAA0B,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAA;QAE7E,MAAM,CAAC,GAAG,YAAY,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChD,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAA;QACnD,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAClD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAA;QACzC,MAAM,GAAG,GAAG,IAAI,cAAc,CAAC,UAAU,EAAE,eAAe,CAAC,CAAA;QAC3D,GAAG,CAAC,KAAK,GAAG,KAAK,CAAA;QAEjB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC/B,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAClE,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;QACtD,MAAM,aAAa,GAAG,IAAI,wBAAwB,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,CAAA;QAC1E,MAAM,eAAe,GAAG,IAAI,0BAA0B,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;QAE1E,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC3C,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACjD,MAAM,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"errors.test.js","sourceRoot":"","sources":["../src/errors.test.ts"],"names":[],"mappings":"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"}

package/build/exports.d.ts

@@ -1,5 +1,6 @@
 export * from './index.js';
 export * from './errors.js';
+export * from './stack-utils.js';
 export * from './schema/extract-json-schema.js';
 export * from './schema/parser.js';
 export * from './schema/resolve-schema-lib.js';

package/build/exports.js

@@ -1,5 +1,6 @@
 export * from './index.js';
 export * from './errors.js';
+export * from './stack-utils.js';
 export * from './schema/extract-json-schema.js';
 export * from './schema/parser.js';
 export * from './schema/resolve-schema-lib.js';

package/build/exports.js.map

@@ -1 +1 @@
-{"version":3,"file":"exports.js","sourceRoot":"","sources":["../src/exports.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,iCAAiC,CAAA;AAC/C,cAAc,oBAAoB,CAAA;AAClC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../src/exports.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,oBAAoB,CAAA;AAClC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,mBAAmB,CAAA"}

package/build/implementations/http/hono-stream/index.d.ts

@@ -0,0 +1,92 @@
+import { Hono, Context } from 'hono';
+import { TStreamProcedureRegistration } from '../../../index.js';
+import { ExtractConfig, ExtractContext, ProceduresFactory, RPCConfig } from '../../types.js';
+import { StreamHttpRouteDoc, StreamMode } from './types.js';
+export type { StreamHttpRouteDoc, StreamMode };
+export type HonoStreamAppBuilderConfig = {
+    /**
+     * An existing Hono application instance to use.
+     * If not provided, a new instance will be created.
+     */
+    app?: Hono;
+    /** Optional path prefix for all stream routes. */
+    pathPrefix?: string;
+    /** Default stream mode for all routes. Defaults to 'sse'. */
+    defaultStreamMode?: StreamMode;
+    onRequestStart?: (c: Context) => void;
+    onRequestEnd?: (c: Context) => void;
+    onStreamStart?: (procedure: TStreamProcedureRegistration, c: Context) => void;
+    onStreamEnd?: (procedure: TStreamProcedureRegistration, c: Context) => void;
+    /**
+     * Error handler called when a streaming procedure throws an error.
+     */
+    onStreamError?: (procedure: TStreamProcedureRegistration, c: Context, error: Error) => Response | Promise<Response>;
+};
+/**
+ * Builder class for creating a Hono application with streaming RPC routes.
+ *
+ * Usage:
+ *   const StreamRPC = Procedures<StreamContext, RPCConfig>()
+ *
+ *   const streamApp = new HonoStreamAppBuilder()
+ *     .register(StreamRPC, (c): Promise<StreamContext> => { /* context resolution logic * / })
+ *     .build();
+ *
+ *   const app = streamApp.app; // Hono application
+ *   const docs = streamApp.docs; // Stream route documentation
+ */
+export declare class HonoStreamAppBuilder {
+    readonly config?: HonoStreamAppBuilderConfig | undefined;
+    /**
+     * Constructor for HonoStreamAppBuilder.
+     */
+    constructor(config?: HonoStreamAppBuilderConfig | undefined);
+    /**
+     * Generates the stream route path based on the RPC configuration.
+     */
+    static makeStreamHttpRoutePath({ name, config, prefix, }: {
+        name: string;
+        prefix?: string;
+        config: RPCConfig;
+    }): string;
+    /**
+     * Instance method wrapper for makeStreamHttpRoutePath that uses the builder's pathPrefix.
+     */
+    makeStreamHttpRoutePath(name: string, config: RPCConfig): string;
+    private factories;
+    private _app;
+    private _docs;
+    get app(): Hono;
+    get docs(): StreamHttpRouteDoc[];
+    /**
+     * Registers a procedure factory with its context.
+     * Only streaming procedures (created with CreateStream) will be registered.
+     */
+    register<TFactory extends ProceduresFactory>(factory: TFactory, factoryContext: ExtractContext<TFactory> | ((c: Context) => ExtractContext<TFactory> | Promise<ExtractContext<TFactory>>), options?: {
+        streamMode?: StreamMode;
+        extendProcedureDoc?: (params: {
+            base: StreamHttpRouteDoc;
+            procedure: TStreamProcedureRegistration<any, ExtractConfig<TFactory>>;
+        }) => Record<string, any>;
+    }): this;
+    /**
+     * Creates a route handler for streaming procedures.
+     */
+    private createStreamHandler;
+    /**
+     * Handles SSE streaming mode.
+     */
+    private handleSSEStream;
+    /**
+     * Handles text streaming mode.
+     */
+    private handleTextStream;
+    /**
+     * Builds and returns the Hono application with registered streaming routes.
+     */
+    build(): Hono;
+    /**
+     * Generates the Stream HTTP route documentation for the given procedure.
+     */
+    private buildStreamHttpRouteDoc;
+}