ts-procedures 7.2.0 → 8.0.0

package/agent_config/claude-code/skills/ts-procedures-scaffold/templates/hono-rpc.md

@@ -1,142 +0,0 @@
-# Hono RPC Template: {{Name}}
-
-## Implementation — `{{Name}}.rpc.ts`
-
-```typescript
-import { Procedures } from 'ts-procedures'
-import { HonoRPCAppBuilder, defineErrorTaxonomy } from 'ts-procedures/hono-rpc'
-import type { RPCConfig } from 'ts-procedures/http'
-import { Type } from 'typebox'
-
-// ─── Context ──────────────────────────────────────────────
-
-type {{Name}}Context = {
-  userId: string
-  requestId: string
-}
-
-// ─── Procedures ───────────────────────────────────────────
-
-const RPC = Procedures<{{Name}}Context, RPCConfig>()
-
-export const { GetItem } = RPC.Create(
-  'GetItem',
-  {
-    scope: '{{name}}',  // TODO: set URL scope
-    version: 1,
-    description: 'Fetch item by ID',
-    schema: {
-      params: Type.Object({
-        id: Type.String(),
-      }),
-      returnType: Type.Object({
-        id: Type.String(),
-        name: Type.String(),
-      }),
-    },
-  },
-  async (ctx, params) => {
-    // TODO: implement
-    return { id: params.id, name: 'Example' }
-  }
-)
-
-export const { ListItems } = RPC.Create(
-  'ListItems',
-  {
-    scope: '{{name}}',
-    version: 1,
-    description: 'List all items',
-    schema: {
-      params: Type.Object({
-        page: Type.Optional(Type.Number()),
-        limit: Type.Optional(Type.Number()),
-      }),
-    },
-  },
-  async (ctx, params) => {
-    // TODO: implement
-    return { items: [], total: 0 }
-  }
-)
-
-// ─── Error Taxonomy ───────────────────────────────────────
-// Declare the error classes this service throws. Framework errors
-// (ProcedureValidationError → 400, ctx.error() → 500) are caught by the
-// default taxonomy automatically. Add your own classes here — handlers just
-// `throw` them and the builder serializes via this map. See
-// docs/http-integrations.md#error-handling for the full contract.
-
-const {{name}}Errors = defineErrorTaxonomy({
-  // Example — replace with your app's error classes:
-  // NotFoundError: { class: NotFoundError, statusCode: 404 },
-  // AuthError:     { class: AuthError,     statusCode: 401 },
-})
-
-// ─── Hono App Builder ─────────────────────────────────────
-
-export const {{name}}App = new HonoRPCAppBuilder({
-  pathPrefix: '/api',
-  errors: {{name}}Errors,
-  unknownError: {
-    statusCode: 500,
-    toResponse: () => ({ name: 'InternalServerError', message: 'Unexpected error' }),
-    onCatch: (err, { procedure }) => console.error(`[${procedure.name}]`, err),
-  },
-})
-  .register(RPC, (c) => ({
-    userId: c.req.header('x-user-id') || 'anonymous',
-    requestId: c.req.header('x-request-id') || crypto.randomUUID(),
-  }))
-  .build()
-
-// Route map:
-// POST /api/{{name}}/get-item/1
-// POST /api/{{name}}/list-items/1
-
-// Documentation: {{name}}App.docs
-```
-
-## Test — `{{Name}}.rpc.test.ts`
-
-```typescript
-import { describe, test, expect } from 'vitest'
-import { {{name}}App } from './{{Name}}.rpc'
-
-describe('{{Name}} RPC', () => {
-  test('GET item returns expected result', async () => {
-    const res = await {{name}}App.request('/api/{{name}}/get-item/1', {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ id: 'item-1' }),
-    })
-
-    expect(res.status).toBe(200)
-    const body = await res.json()
-    expect(body).toEqual({ id: 'item-1', name: 'Example' })
-  })
-
-  test('returns 400 for invalid params', async () => {
-    const res = await {{name}}App.request('/api/{{name}}/get-item/1', {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({}),
-    })
-
-    expect(res.status).toBe(400)
-  })
-
-  test('LIST items returns array', async () => {
-    const res = await {{name}}App.request('/api/{{name}}/list-items/1', {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ page: 1, limit: 10 }),
-    })
-
-    expect(res.status).toBe(200)
-    const body = await res.json()
-    expect(body).toHaveProperty('items')
-    expect(body).toHaveProperty('total')
-  })
-})
-```

package/agent_config/claude-code/skills/ts-procedures-scaffold/templates/hono-stream.md

@@ -1,147 +0,0 @@
-# Hono Stream Template: {{Name}}
-
-## Implementation — `{{Name}}.stream-rpc.ts`
-
-```typescript
-import { Procedures } from 'ts-procedures'
-import { HonoStreamAppBuilder, sse, defineErrorTaxonomy } from 'ts-procedures/hono-stream'
-import type { RPCConfig } from 'ts-procedures/http'
-import { Type } from 'typebox'
-
-// ─── Context ──────────────────────────────────────────────
-
-type {{Name}}Context = {
-  userId: string
-}
-
-// ─── Stream Procedures ────────────────────────────────────
-
-const StreamRPC = Procedures<{{Name}}Context, RPCConfig>()
-
-export const { {{Name}}Stream } = StreamRPC.CreateStream(
-  '{{Name}}Stream',
-  {
-    scope: '{{name}}',  // TODO: set URL scope
-    version: 1,
-    description: 'TODO: describe what this streams',
-    schema: {
-      params: Type.Object({
-        // TODO: define input parameters
-        channel: Type.String(),
-      }),
-      yieldType: Type.Object({
-        // TODO: define shape of each yielded value
-        type: Type.String(),
-        payload: Type.Any(),
-        timestamp: Type.Number(),
-      }),
-    },
-  },
-  async function* (ctx, params) {
-    // ctx.signal is ALWAYS present in stream handlers
-
-    // TODO: implement streaming logic
-    let counter = 0
-    while (!ctx.signal.aborted) {
-      const event = await pollForEvents(params.channel, { signal: ctx.signal })
-
-      // Use sse() to attach SSE metadata (event type, id, retry)
-      yield sse(
-        { type: event.type, payload: event.data, timestamp: Date.now() },
-        { event: event.type, id: String(counter++) }
-      )
-    }
-  }
-)
-
-// Placeholder — replace with real event source
-async function pollForEvents(channel: string, opts?: { signal?: AbortSignal }) {
-  await new Promise(r => setTimeout(r, 1000))
-  return { type: 'update', data: { value: Math.random() } }
-}
-
-// ─── Error Taxonomy (pre-stream) ──────────────────────────
-// Pre-stream errors (validation, context resolution) flow through the
-// taxonomy — framework errors are caught by the default taxonomy automatically.
-// Mid-stream errors (thrown after the first yield) still go through
-// onMidStreamError since the HTTP status is already committed.
-
-const {{name}}Errors = defineErrorTaxonomy({
-  // Example — replace with your app's error classes:
-  // AuthError: { class: AuthError, statusCode: 401 },
-})
-
-// ─── Hono Stream App Builder ──────────────────────────────
-
-export const {{name}}StreamApp = new HonoStreamAppBuilder({
-  pathPrefix: '/api',
-  defaultStreamMode: 'sse',  // or 'text' for newline-delimited JSON
-  errors: {{name}}Errors,
-  unknownError: {
-    statusCode: 500,
-    toResponse: () => ({ name: 'InternalServerError', message: 'Unexpected error' }),
-  },
-  onMidStreamError: (procedure, c, error) => ({
-    data: { type: 'error', payload: { message: error.message }, timestamp: Date.now() },
-    closeStream: true,
-  }),
-})
-  .register(StreamRPC, (c) => ({
-    userId: c.req.header('x-user-id') || 'anonymous',
-  }))
-  .build()
-
-// Routes:
-// GET  /api/{{name}}/{{name}}-stream/1?channel=test
-// POST /api/{{name}}/{{name}}-stream/1  (body: { channel: "test" })
-
-// SSE output per yield:
-// event: {{Name}}Stream
-// id: 0
-// data: {"type":"update","payload":{...},"timestamp":1234567890}
-```
-
-## Test — `{{Name}}.stream-rpc.test.ts`
-
-```typescript
-import { describe, test, expect } from 'vitest'
-import { {{name}}StreamApp } from './{{Name}}.stream-rpc'
-
-describe('{{Name}} Stream RPC', () => {
-  test('GET returns SSE stream', async () => {
-    const res = await {{name}}StreamApp.request(
-      '/api/{{name}}/{{name}}-stream/1?channel=test'
-    )
-
-    expect(res.status).toBe(200)
-    expect(res.headers.get('content-type')).toContain('text/event-stream')
-  })
-
-  test('POST returns SSE stream', async () => {
-    const res = await {{name}}StreamApp.request(
-      '/api/{{name}}/{{name}}-stream/1',
-      {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({ channel: 'test' }),
-      }
-    )
-
-    expect(res.status).toBe(200)
-    expect(res.headers.get('content-type')).toContain('text/event-stream')
-  })
-
-  test('returns 400 for invalid params', async () => {
-    const res = await {{name}}StreamApp.request(
-      '/api/{{name}}/{{name}}-stream/1',
-      {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({}),
-      }
-    )
-
-    expect(res.status).toBe(400)
-  })
-})
-```

package/build/implementations/http/express-rpc/error-taxonomy.test.js

@@ -1,83 +0,0 @@
-import { describe, expect, test, vi } from 'vitest';
-import request from 'supertest';
-import { Type } from 'typebox';
-import { Procedures } from '../../../index.js';
-import { ExpressRPCAppBuilder, defineErrorTaxonomy } from './index.js';
-class UseCaseError extends Error {
-    externalMsg;
-    internalMsg;
-    constructor(externalMsg, internalMsg) {
-        super(externalMsg);
-        this.externalMsg = externalMsg;
-        this.internalMsg = internalMsg;
-        this.name = 'UseCaseError';
-        Object.setPrototypeOf(this, UseCaseError.prototype);
-    }
-}
-describe('ExpressRPCAppBuilder — error taxonomy', () => {
-    test('taxonomy catches user error thrown from RPC handler', async () => {
-        const errors = defineErrorTaxonomy({
-            UseCaseError: {
-                class: UseCaseError,
-                statusCode: 422,
-                toResponse: (err) => ({ name: 'UseCaseError', message: err.externalMsg }),
-            },
-        });
-        const RPC = Procedures();
-        RPC.Create('Boom', { scope: 'test', version: 1, schema: { params: Type.Object({}) } }, async () => {
-            throw new UseCaseError('ext', 'int');
-        });
-        const app = new ExpressRPCAppBuilder({ errors }).register(RPC, () => ({})).build();
-        const res = await request(app).post('/test/boom/1').send({});
-        expect(res.status).toBe(422);
-        expect(res.body).toEqual({ name: 'UseCaseError', message: 'ext' });
-    });
-    test('unknownError catches unmapped errors', async () => {
-        const RPC = Procedures();
-        RPC.Create('Boom', { scope: 'test', version: 1, schema: { params: Type.Object({}) } }, async () => {
-            throw new TypeError('db down');
-        });
-        const app = new ExpressRPCAppBuilder({
-            unknownError: { statusCode: 503, toResponse: () => ({ name: 'ServiceUnavailable' }) },
-        })
-            .register(RPC, () => ({}))
-            .build();
-        const res = await request(app).post('/test/boom/1').send({});
-        expect(res.status).toBe(503);
-        expect(res.body).toEqual({ name: 'ServiceUnavailable' });
-    });
-    test('onCatch receives { req, res } as raw context', async () => {
-        let rawSeen;
-        const errors = defineErrorTaxonomy({
-            UseCaseError: {
-                class: UseCaseError,
-                statusCode: 422,
-                onCatch: (_err, ctx) => {
-                    rawSeen = ctx.raw;
-                },
-            },
-        });
-        const RPC = Procedures();
-        RPC.Create('Boom', { scope: 'test', version: 1, schema: { params: Type.Object({}) } }, async () => {
-            throw new UseCaseError('ext', 'int');
-        });
-        const app = new ExpressRPCAppBuilder({ errors }).register(RPC, () => ({})).build();
-        await request(app).post('/test/boom/1').send({});
-        expect(rawSeen.req).toBeDefined();
-        expect(rawSeen.res).toBeDefined();
-    });
-    test('onError callback handles errors not matched by the taxonomy', async () => {
-        const onError = vi.fn((_p, _req, res) => {
-            res.status(418).json({ legacy: true });
-        });
-        const RPC = Procedures();
-        RPC.Create('Boom', { scope: 'test', version: 1, schema: { params: Type.Object({}) } }, async () => {
-            throw new TypeError('legacy');
-        });
-        const app = new ExpressRPCAppBuilder({ onError }).register(RPC, () => ({})).build();
-        const res = await request(app).post('/test/boom/1').send({});
-        expect(res.status).toBe(418);
-        expect(onError).toHaveBeenCalledOnce();
-    });
-});
-//# sourceMappingURL=error-taxonomy.test.js.map

package/build/implementations/http/express-rpc/error-taxonomy.test.js.map

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

package/build/implementations/http/express-rpc/index.d.ts

@@ -1,125 +0,0 @@
-import express from 'express';
-import { TProcedureRegistration } from '../../../index.js';
-import { ExtractConfig, ExtractContext, ProceduresFactory, RPCConfig, RPCHttpRouteDoc } from '../../types.js';
-import { ErrorTaxonomy, ErrorTaxonomyEntry, UnknownErrorConfig, defineErrorTaxonomy } from '../error-taxonomy.js';
-export type { RPCConfig, RPCHttpRouteDoc };
-export { defineErrorTaxonomy };
-export type { ErrorTaxonomy, ErrorTaxonomyEntry, UnknownErrorConfig };
-export type ExpressRPCAppBuilderConfig = {
-    /**
-     * An existing Express application instance to use.
-     * When provided, ensure to set up necessary middleware (e.g., json/body parser) beforehand.
-     * If not provided, a new instance will be created.
-     */
-    app?: express.Express;
-    /** Optional path prefix for all RPC routes. */
-    pathPrefix?: string;
-    onRequestStart?: (req: express.Request) => void;
-    onRequestEnd?: (req: express.Request, res: express.Response) => void;
-    onSuccess?: (procedure: TProcedureRegistration, req: express.Request, res: express.Response) => void;
-    /**
-     * Declarative error-to-response mapping (one of the two peer error modes).
-     * See hono-api for the full taxonomy contract. The `raw` field passed to
-     * taxonomy callbacks is `{ req, res }`.
-     */
-    errors?: ErrorTaxonomy;
-    /** Fallback serializer for errors not matched by the taxonomy. */
-    unknownError?: UnknownErrorConfig;
-    /**
-     * Imperative error callback — the other peer error mode. Receives every
-     * error directly and writes the response via `res`. Use this when you want
-     * full control, or alongside `errors` for the tail of errors the taxonomy
-     * doesn't cover.
-     */
-    onError?: (procedure: TProcedureRegistration, req: express.Request, res: express.Response, error: Error) => void;
-    /**
-     * Cross-cutting observer — fires for every caught error, BEFORE dispatch.
-     * Awaited. Cannot write to `res` (observer only — check `res.headersSent`
-     * if you must touch it). Thrown errors inside the observer are swallowed
-     * and logged.
-     */
-    onRequestError?: (ctx: OnRequestErrorContext) => void | Promise<void>;
-};
-/**
- * Context passed to the `onRequestError` observer. `raw` is `{ req, res }`
- * for the in-flight request.
- */
-export type OnRequestErrorContext = {
-    err: unknown;
-    procedure: TProcedureRegistration;
-    raw: {
-        req: express.Request;
-        res: express.Response;
-    };
-};
-/**
- * Builder class for creating an Express application with RPC routes.
- *
- * Usage:
- *   const PublicRPC = Procedures<PublicRPCContext, RPCConfig>()
- *   const ProtectedRPC = Procedures<ProtectedRPCContext, RPCConfig>()
- *
- *   const rpcApp = new ExpressRPCAppBuilder()
- *     .register(PublicRPC, (req): Promise<PublicRPCContext> => { /* context resolution logic * / })
- *     .register(ProtectedRPC, (req): Promise<ProtectedRPCContext> => { /* context resolution logic * / })
- *     .build();
- *
- *   const app = rpcApp.app; // Express application
- *   const docs = rpcApp.docs; // RPC route documentation
- */
-export declare class ExpressRPCAppBuilder {
-    readonly config?: ExpressRPCAppBuilderConfig | undefined;
-    /**
-     * Constructor for ExpressRPCAppBuilder.
-     *
-     * @param config
-     */
-    constructor(config?: ExpressRPCAppBuilderConfig | undefined);
-    /**
-     * Generates the RPC route path based on the RPC configuration.
-     * `RPCConfig.scope` can be a string or an array of strings to form nested paths.
-     *
-     * Example
-     *  name:  'GetUser'
-     *  scope: ['users', 'profile']
-     *  version: 1
-     *  path: /users/profile/get-user/1
-     * @param config
-     */
-    static makeRPCHttpRoutePath({ name, config, prefix, }: {
-        name: string;
-        prefix?: string;
-        config: RPCConfig;
-    }): string;
-    /**
-     * Instance method wrapper for makeRPCHttpRoutePath that uses the builder's pathPrefix.
-     * @param config - The RPC configuration
-     */
-    makeRPCHttpRoutePath(name: string, config: RPCConfig): string;
-    private factories;
-    private _app;
-    private _docs;
-    get app(): express.Express;
-    get docs(): RPCHttpRouteDoc[];
-    /**
-     * Registers a procedure factory with its context.
-     * @param factory - The procedure factory created by Procedures<Context, RPCConfig>()
-     * @param factoryContext - The context for procedure handlers. Can be a direct value,
-     *                         a sync function (req) => Context, or an async function (req) => Promise<Context>
-     * @param extendProcedureDoc - A custom function to extend the generated RPC route documentation for each procedure.
-     */
-    register<TFactory extends ProceduresFactory>(factory: TFactory, factoryContext: ExtractContext<TFactory> | ((req: express.Request) => ExtractContext<TFactory> | Promise<ExtractContext<TFactory>>), extendProcedureDoc?: (params: {
-        base: RPCHttpRouteDoc;
-        procedure: TProcedureRegistration<any, ExtractConfig<TFactory>>;
-    }) => Record<string, any>): this;
-    /**
-     * Builds and returns the Express application with registered RPC routes.
-     * @return express.Application
-     */
-    build(): express.Application;
-    /**
-     * Generates the RPC HTTP route for the given procedure.
-     * @param procedure
-     */
-    private buildRpcHttpRouteDoc;
-}