@ts-pf/server 0.1.0-beta.0

package/README.md

@@ -0,0 +1,7 @@
+# @ts-pf/server
+
+`createImplementer()`, middleware, `runProcedure`, `lookupProcedure`, `createLocalClient()`, and server call interceptors / `DedupePlugin`. No `Request` / `Response`.
+
+Agent skill: [`skills/ts-pf-server/`](skills/ts-pf-server/). Sync with `npx skills experimental_sync -y`.
+
+HTTP serving is [`@ts-pf/server-http`](../server-http). See the [root README](../../README.md) for the Fetch happy path.

package/dist/call-interceptor.d.ts

@@ -0,0 +1,28 @@
+import type { ImplementedProcedure } from './runtime.js';
+export type CallInterceptor = (ctx: {
+    procedure: ImplementedProcedure;
+    path: string[];
+    input: unknown;
+    context: unknown;
+    signal?: AbortSignal;
+    next: (opts?: {
+        input?: unknown;
+        /** Replaces context entirely; does not merge. */
+        context?: unknown;
+        signal?: AbortSignal;
+    }) => Promise<unknown>;
+}) => Promise<unknown>;
+type CallState = {
+    input: unknown;
+    context: unknown;
+    signal?: AbortSignal;
+};
+export declare function runCallInterceptors(interceptors: readonly CallInterceptor[], ctx: {
+    procedure: ImplementedProcedure;
+    path: string[];
+    input: unknown;
+    context: unknown;
+    signal?: AbortSignal;
+}, execute: (current: CallState) => Promise<unknown>): Promise<unknown>;
+export {};
+//# sourceMappingURL=call-interceptor.d.ts.map

package/dist/call-interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-interceptor.d.ts","sourceRoot":"","sources":["../src/call-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAExD,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE;IAClC,SAAS,EAAE,oBAAoB,CAAA;IAC/B,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,iDAAiD;QACjD,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,MAAM,CAAC,EAAE,WAAW,CAAA;KACrB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACvB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAEtB,KAAK,SAAS,GAAG;IACf,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,CAAA;AAED,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,SAAS,eAAe,EAAE,EACxC,GAAG,EAAE;IACH,SAAS,EAAE,oBAAoB,CAAA;IAC/B,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,EACD,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,GAChD,OAAO,CAAC,OAAO,CAAC,CAsClB"}

package/dist/call-interceptor.js

@@ -0,0 +1,40 @@
+export function runCallInterceptors(interceptors, ctx, execute) {
+    const interceptorPath = ctx.path.slice();
+    const run = (index, current) => {
+        const interceptor = interceptors[index];
+        if (!interceptor) {
+            return execute(current);
+        }
+        return interceptor({
+            procedure: ctx.procedure,
+            path: interceptorPath,
+            input: current.input,
+            context: current.context,
+            ...(current.signal ? { signal: current.signal } : {}),
+            next: (opts) => {
+                const nextCurrent = {
+                    input: opts && 'input' in opts ? opts.input : current.input,
+                    context: opts && 'context' in opts ? opts.context : current.context,
+                };
+                if (opts && 'signal' in opts) {
+                    if (opts.signal) {
+                        nextCurrent.signal = opts.signal;
+                    }
+                }
+                else if (current.signal) {
+                    nextCurrent.signal = current.signal;
+                }
+                return run(index + 1, nextCurrent);
+            },
+        });
+    };
+    const initial = {
+        input: ctx.input,
+        context: ctx.context,
+    };
+    if (ctx.signal) {
+        initial.signal = ctx.signal;
+    }
+    return run(0, initial);
+}
+//# sourceMappingURL=call-interceptor.js.map

package/dist/call-interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-interceptor.js","sourceRoot":"","sources":["../src/call-interceptor.ts"],"names":[],"mappings":"AAsBA,MAAM,UAAU,mBAAmB,CACjC,YAAwC,EACxC,GAMC,EACD,OAAiD;IAEjD,MAAM,eAAe,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;IACxC,MAAM,GAAG,GAAG,CAAC,KAAa,EAAE,OAAkB,EAAoB,EAAE;QAClE,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;QACvC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,OAAO,CAAC,OAAO,CAAC,CAAA;QACzB,CAAC;QACD,OAAO,WAAW,CAAC;YACjB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;gBACb,MAAM,WAAW,GAAc;oBAC7B,KAAK,EAAE,IAAI,IAAI,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK;oBAC3D,OAAO,EAAE,IAAI,IAAI,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO;iBACpE,CAAA;gBACD,IAAI,IAAI,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;oBAC7B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;wBAChB,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;oBAClC,CAAC;gBACH,CAAC;qBAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;oBAC1B,WAAW,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;gBACrC,CAAC;gBACD,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,WAAW,CAAC,CAAA;YACpC,CAAC;SACF,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,MAAM,OAAO,GAAc;QACzB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB,CAAA;IACD,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAA;IAC7B,CAAC;IACD,OAAO,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;AACxB,CAAC"}

package/dist/caller.d.ts

@@ -0,0 +1,10 @@
+import type { ContractClient } from '@ts-pf/contract';
+import type { CallInterceptor } from './call-interceptor.js';
+import { type CallPlugin } from './plugin.js';
+import { type ImplementedRouter } from './runtime.js';
+export declare function createLocalClient<T>(router: ImplementedRouter<T>, opts: {
+    context: unknown;
+    interceptors?: readonly CallInterceptor[];
+    plugins?: readonly CallPlugin[];
+}): ContractClient<T>;
+//# sourceMappingURL=caller.d.ts.map

package/dist/caller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caller.d.ts","sourceRoot":"","sources":["../src/caller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EAEL,KAAK,iBAAiB,EAIvB,MAAM,cAAc,CAAA;AA2DrB,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC5B,IAAI,EAAE;IACJ,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;IACzC,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAA;CAChC,GACA,cAAc,CAAC,CAAC,CAAC,CAGnB"}

package/dist/caller.js

@@ -0,0 +1,53 @@
+import { applyPlugins } from './plugin.js';
+import { isImplementedProcedure, runProcedure, } from './runtime.js';
+function buildRunOptions(signal, interceptors) {
+    if (!signal && interceptors.length === 0) {
+        return undefined;
+    }
+    const options = {};
+    if (signal) {
+        options.signal = signal;
+    }
+    if (interceptors.length > 0) {
+        options.interceptors = interceptors;
+    }
+    return options;
+}
+function createNode(node, context, interceptors) {
+    if (isImplementedProcedure(node)) {
+        return (...args) => {
+            const first = args[0];
+            const second = args[1];
+            if (args.length < 2 &&
+                typeof first === 'object' &&
+                first !== null &&
+                'signal' in first &&
+                first.signal instanceof AbortSignal) {
+                const signal = first.signal;
+                const options = buildRunOptions(signal, interceptors);
+                return options
+                    ? runProcedure(node, undefined, context, options)
+                    : runProcedure(node, undefined, context);
+            }
+            const options = buildRunOptions(second?.signal, interceptors);
+            return options
+                ? runProcedure(node, first, context, options)
+                : runProcedure(node, first, context);
+        };
+    }
+    const nested = {};
+    for (const [key, child] of Object.entries(node)) {
+        if (key === '~pf') {
+            continue;
+        }
+        if (child) {
+            nested[key] = createNode(child, context, interceptors);
+        }
+    }
+    return nested;
+}
+export function createLocalClient(router, opts) {
+    const interceptors = applyPlugins(opts.plugins ?? [], opts.interceptors);
+    return createNode(router, opts.context, interceptors);
+}
+//# sourceMappingURL=caller.js.map

package/dist/caller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caller.js","sourceRoot":"","sources":["../src/caller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAmB,MAAM,aAAa,CAAA;AAC3D,OAAO,EAGL,sBAAsB,EAEtB,YAAY,GACb,MAAM,cAAc,CAAA;AAErB,SAAS,eAAe,CACtB,MAA+B,EAC/B,YAAwC;IAExC,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,MAAM,OAAO,GAAwB,EAAE,CAAA;IACvC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,MAAM,GAAG,MAAM,CAAA;IACzB,CAAC;IACD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,YAAY,GAAG,YAAY,CAAA;IACrC,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,UAAU,CACjB,IAAuD,EACvD,OAAgB,EAChB,YAAwC;IAExC,IAAI,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,IAAe,EAAE,EAAE;YAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;YACrB,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAyC,CAAA;YAC9D,IACE,IAAI,CAAC,MAAM,GAAG,CAAC;gBACf,OAAO,KAAK,KAAK,QAAQ;gBACzB,KAAK,KAAK,IAAI;gBACd,QAAQ,IAAI,KAAK;gBAChB,KAA8B,CAAC,MAAM,YAAY,WAAW,EAC7D,CAAC;gBACD,MAAM,MAAM,GAAI,KAAiC,CAAC,MAAM,CAAA;gBACxD,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;gBACrD,OAAO,OAAO;oBACZ,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC;oBACjD,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;YAC5C,CAAC;YACD,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,CAAA;YAC7D,OAAO,OAAO;gBACZ,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC;gBAC7C,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;QACxC,CAAC,CAAA;IACH,CAAC;IACD,MAAM,MAAM,GAA4B,EAAE,CAAA;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;YAClB,SAAQ;QACV,CAAC;QACD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;QACxD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,MAA4B,EAC5B,IAIC;IAED,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;IACxE,OAAO,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,CAAsB,CAAA;AAC5E,CAAC"}

package/dist/dedupe-plugin.d.ts

@@ -0,0 +1,15 @@
+import type { CallInterceptor } from './call-interceptor.js';
+import type { CallPlugin } from './plugin.js';
+export type DedupePluginOptions = {
+    key?: (ctx: {
+        path: string[];
+        input: unknown;
+    }) => string | undefined;
+};
+/** In-flight coalescing around runProcedure. Default keys every unary call; pass `key` to restrict to reads — unsafe for non-idempotent writes. */
+export declare class DedupePlugin implements CallPlugin {
+    readonly name = "dedupe";
+    readonly intercept: CallInterceptor;
+    constructor(options?: DedupePluginOptions);
+}
+//# sourceMappingURL=dedupe-plugin.d.ts.map

package/dist/dedupe-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupe-plugin.d.ts","sourceRoot":"","sources":["../src/dedupe-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,GAAG,SAAS,CAAA;CACtE,CAAA;AAuFD,mJAAmJ;AACnJ,qBAAa,YAAa,YAAW,UAAU;IAC7C,QAAQ,CAAC,IAAI,YAAW;IACxB,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;gBAEvB,OAAO,CAAC,EAAE,mBAAmB;CAmD1C"}

package/dist/dedupe-plugin.js

@@ -0,0 +1,118 @@
+function defaultKey(ctx) {
+    if (typeof ctx.input === 'object' &&
+        ctx.input !== null &&
+        Symbol.asyncIterator in ctx.input) {
+        return undefined;
+    }
+    try {
+        return JSON.stringify([ctx.path, ctx.input]);
+    }
+    catch {
+        return undefined;
+    }
+}
+function joinInflight(entry, inflight, key, signal) {
+    signal?.throwIfAborted();
+    const waiter = {};
+    entry.waiters.add(waiter);
+    const dropIfLast = () => {
+        entry.waiters.delete(waiter);
+        if (entry.waiters.size === 0) {
+            if (inflight.get(key) === entry) {
+                inflight.delete(key);
+            }
+            entry.controller.abort();
+        }
+    };
+    if (!signal) {
+        return entry.promise.finally(() => {
+            entry.waiters.delete(waiter);
+        });
+    }
+    return new Promise((resolve, reject) => {
+        let done = false;
+        const finish = (fn) => {
+            if (done) {
+                return;
+            }
+            done = true;
+            signal.removeEventListener('abort', onAbort);
+            fn();
+        };
+        const onAbort = () => {
+            finish(() => {
+                dropIfLast();
+                reject(signal.reason);
+            });
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        if (signal.aborted) {
+            onAbort();
+            return;
+        }
+        entry.promise.then((value) => {
+            finish(() => {
+                entry.waiters.delete(waiter);
+                resolve(value);
+            });
+        }, (error) => {
+            finish(() => {
+                entry.waiters.delete(waiter);
+                reject(error);
+            });
+        });
+    });
+}
+/** In-flight coalescing around runProcedure. Default keys every unary call; pass `key` to restrict to reads — unsafe for non-idempotent writes. */
+export class DedupePlugin {
+    name = 'dedupe';
+    intercept;
+    constructor(options) {
+        const keyFn = options?.key ?? defaultKey;
+        const byContext = new WeakMap();
+        const anonymous = new Map();
+        const bucket = (context) => {
+            if (typeof context === 'object' && context !== null) {
+                let map = byContext.get(context);
+                if (!map) {
+                    map = new Map();
+                    byContext.set(context, map);
+                }
+                return map;
+            }
+            return anonymous;
+        };
+        this.intercept = async (ctx) => {
+            if (typeof ctx.input === 'object' &&
+                ctx.input !== null &&
+                Symbol.asyncIterator in ctx.input) {
+                return ctx.next();
+            }
+            const key = keyFn({ path: ctx.path, input: ctx.input });
+            if (key === undefined) {
+                return ctx.next();
+            }
+            const inflight = bucket(ctx.context);
+            const existing = inflight.get(key);
+            if (existing) {
+                return joinInflight(existing, inflight, key, ctx.signal);
+            }
+            ctx.signal?.throwIfAborted();
+            const controller = new AbortController();
+            const waiters = new Set();
+            const inner = ctx.next({ signal: controller.signal });
+            const entry = {
+                controller,
+                waiters,
+                promise: inner.finally(() => {
+                    if (inflight.get(key) === entry) {
+                        inflight.delete(key);
+                    }
+                }),
+            };
+            inflight.set(key, entry);
+            return joinInflight(entry, inflight, key, ctx.signal);
+        };
+    }
+}
+//# sourceMappingURL=dedupe-plugin.js.map

package/dist/dedupe-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupe-plugin.js","sourceRoot":"","sources":["../src/dedupe-plugin.ts"],"names":[],"mappings":"AAaA,SAAS,UAAU,CAAC,GAGnB;IACC,IACE,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;QAC7B,GAAG,CAAC,KAAK,KAAK,IAAI;QAClB,MAAM,CAAC,aAAa,IAAI,GAAG,CAAC,KAAK,EACjC,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAA;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CACnB,KAAe,EACf,QAA+B,EAC/B,GAAW,EACX,MAA+B;IAE/B,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,MAAM,MAAM,GAAG,EAAE,CAAA;IACjB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACzB,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC7B,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC;gBAChC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACtB,CAAC;YACD,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,CAAA;QAC1B,CAAC;IACH,CAAC,CAAA;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE;YAChC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC9B,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,IAAI,GAAG,KAAK,CAAA;QAChB,MAAM,MAAM,GAAG,CAAC,EAAc,EAAE,EAAE;YAChC,IAAI,IAAI,EAAE,CAAC;gBACT,OAAM;YACR,CAAC;YACD,IAAI,GAAG,IAAI,CAAA;YACX,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC5C,EAAE,EAAE,CAAA;QACN,CAAC,CAAA;QACD,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,MAAM,CAAC,GAAG,EAAE;gBACV,UAAU,EAAE,CAAA;gBACZ,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACvB,CAAC,CAAC,CAAA;QACJ,CAAC,CAAA;QACD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACzD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,EAAE,CAAA;YACT,OAAM;QACR,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,IAAI,CAChB,CAAC,KAAK,EAAE,EAAE;YACR,MAAM,CAAC,GAAG,EAAE;gBACV,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;gBAC5B,OAAO,CAAC,KAAK,CAAC,CAAA;YAChB,CAAC,CAAC,CAAA;QACJ,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACR,MAAM,CAAC,GAAG,EAAE;gBACV,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;gBAC5B,MAAM,CAAC,KAAK,CAAC,CAAA;YACf,CAAC,CAAC,CAAA;QACJ,CAAC,CACF,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,mJAAmJ;AACnJ,MAAM,OAAO,YAAY;IACd,IAAI,GAAG,QAAQ,CAAA;IACf,SAAS,CAAiB;IAEnC,YAAY,OAA6B;QACvC,MAAM,KAAK,GAAG,OAAO,EAAE,GAAG,IAAI,UAAU,CAAA;QACxC,MAAM,SAAS,GAAG,IAAI,OAAO,EAAiC,CAAA;QAC9D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAA;QAE7C,MAAM,MAAM,GAAG,CAAC,OAAgB,EAAyB,EAAE;YACzD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACpD,IAAI,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;gBAChC,IAAI,CAAC,GAAG,EAAE,CAAC;oBACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;oBACf,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;gBAC7B,CAAC;gBACD,OAAO,GAAG,CAAA;YACZ,CAAC;YACD,OAAO,SAAS,CAAA;QAClB,CAAC,CAAA;QAED,IAAI,CAAC,SAAS,GAAG,KAAK,EAAE,GAAG,EAAE,EAAE;YAC7B,IACE,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;gBAC7B,GAAG,CAAC,KAAK,KAAK,IAAI;gBAClB,MAAM,CAAC,aAAa,IAAI,GAAG,CAAC,KAAK,EACjC,CAAC;gBACD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAA;YACnB,CAAC;YACD,MAAM,GAAG,GAAG,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAA;YACvD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,OAAO,GAAG,CAAC,IAAI,EAAE,CAAA;YACnB,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACpC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAClC,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;YAC1D,CAAC;YACD,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAA;YAC5B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;YACxC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAA;YACjC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAA;YACrD,MAAM,KAAK,GAAa;gBACtB,UAAU;gBACV,OAAO;gBACP,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;oBAC1B,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC;wBAChC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;oBACtB,CAAC;gBACH,CAAC,CAAC;aACH,CAAA;YACD,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACxB,OAAO,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;QACvD,CAAC,CAAA;IACH,CAAC;CACF"}

package/dist/error-factory.d.ts

@@ -0,0 +1,5 @@
+import { type ErrorMap } from '@ts-pf/contract';
+import type { ErrorFactory } from './middleware.js';
+export declare function createErrorFactory(map: ErrorMap): ErrorFactory<ErrorMap>;
+export declare function finalizeDeclaredError(error: unknown, map: ErrorMap): Promise<never>;
+//# sourceMappingURL=error-factory.d.ts.map

package/dist/error-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-factory.d.ts","sourceRoot":"","sources":["../src/error-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAkB,MAAM,iBAAiB,CAAA;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAaxE;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,QAAQ,GACZ,OAAO,CAAC,KAAK,CAAC,CAqBhB"}

package/dist/error-factory.js

@@ -0,0 +1,39 @@
+import { validateSchema } from '@ts-pf/contract';
+import { isPFError, PFError } from '@ts-pf/protocol';
+export function createErrorFactory(map) {
+    const factory = {};
+    for (const [code, def] of Object.entries(map)) {
+        factory[code] = ((data) => {
+            throw new PFError({
+                code,
+                status: def.status ?? 400,
+                message: def.message ?? code,
+                ...(data !== undefined ? { data } : {}),
+            });
+        });
+    }
+    return factory;
+}
+export async function finalizeDeclaredError(error, map) {
+    if (!isPFError(error)) {
+        throw error;
+    }
+    const def = map[error.code];
+    if (def?.data === undefined) {
+        throw error;
+    }
+    const result = await validateSchema(def.data, error.data);
+    if (!result.success) {
+        throw new PFError({
+            code: 'INTERNAL',
+            message: 'Internal server error',
+        });
+    }
+    throw new PFError({
+        code: error.code,
+        status: error.status,
+        message: error.message,
+        ...(result.value !== undefined ? { data: result.value } : {}),
+    });
+}
+//# sourceMappingURL=error-factory.js.map

package/dist/error-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-factory.js","sourceRoot":"","sources":["../src/error-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAGpD,MAAM,UAAU,kBAAkB,CAAC,GAAa;IAC9C,MAAM,OAAO,GAA2B,EAAE,CAAA;IAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAc,EAAE,EAAE;YAClC,MAAM,IAAI,OAAO,CAAC;gBAChB,IAAI;gBACJ,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,GAAG;gBACzB,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;gBAC5B,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxC,CAAC,CAAA;QACJ,CAAC,CAAyB,CAAA;IAC5B,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAc,EACd,GAAa;IAEb,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,KAAK,CAAA;IACb,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC3B,IAAI,GAAG,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,KAAK,CAAA;IACb,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;IACzD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,OAAO,CAAC;YAChB,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,uBAAuB;SACjC,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,IAAI,OAAO,CAAC;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9D,CAAC,CAAA;AACJ,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,32 @@
+import type { CallInterceptor } from './call-interceptor.js';
+export declare function onStart(fn: (ctx: {
+    path: string[];
+    input: unknown;
+    context: unknown;
+    signal?: AbortSignal;
+}) => void | Promise<void>): CallInterceptor;
+export declare function onSuccess(fn: (ctx: {
+    path: string[];
+    input: unknown;
+    context: unknown;
+    signal?: AbortSignal;
+}, output: unknown) => void | Promise<void>): CallInterceptor;
+export declare function onError(fn: (ctx: {
+    path: string[];
+    input: unknown;
+    context: unknown;
+    signal?: AbortSignal;
+}, error: unknown) => void | Promise<void>): CallInterceptor;
+export declare function onFinish(fn: (ctx: {
+    path: string[];
+    input: unknown;
+    context: unknown;
+    signal?: AbortSignal;
+}, result: {
+    ok: true;
+    output: unknown;
+} | {
+    ok: false;
+    error: unknown;
+}) => void | Promise<void>): CallInterceptor;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAoB5D,wBAAgB,OAAO,CACrB,EAAE,EAAE,CAAC,GAAG,EAAE;IACR,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACzB,eAAe,CAKjB;AAED,wBAAgB,SAAS,CACvB,EAAE,EAAE,CACF,GAAG,EAAE;IACH,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,EACD,MAAM,EAAE,OAAO,KACZ,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACxB,eAAe,CAMjB;AAED,wBAAgB,OAAO,CACrB,EAAE,EAAE,CACF,GAAG,EAAE;IACH,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,EACD,KAAK,EAAE,OAAO,KACX,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACxB,eAAe,CAajB;AAED,wBAAgB,QAAQ,CACtB,EAAE,EAAE,CACF,GAAG,EAAE;IACH,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,EACD,MAAM,EAAE;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,KAClE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACxB,eAAe,CAgBjB"}

package/dist/events.js

@@ -0,0 +1,59 @@
+function eventCtx(ctx) {
+    return ctx.signal
+        ? {
+            path: ctx.path,
+            input: ctx.input,
+            context: ctx.context,
+            signal: ctx.signal,
+        }
+        : { path: ctx.path, input: ctx.input, context: ctx.context };
+}
+export function onStart(fn) {
+    return async (ctx) => {
+        await fn(eventCtx(ctx));
+        return ctx.next();
+    };
+}
+export function onSuccess(fn) {
+    return async (ctx) => {
+        const output = await ctx.next();
+        await fn(eventCtx(ctx), output);
+        return output;
+    };
+}
+export function onError(fn) {
+    return async (ctx) => {
+        try {
+            return await ctx.next();
+        }
+        catch (error) {
+            try {
+                await fn(eventCtx(ctx), error);
+            }
+            catch {
+                // Observe-only: always rethrow the original call error.
+            }
+            throw error;
+        }
+    };
+}
+export function onFinish(fn) {
+    return async (ctx) => {
+        let output;
+        try {
+            output = await ctx.next();
+        }
+        catch (error) {
+            try {
+                await fn(eventCtx(ctx), { ok: false, error });
+            }
+            catch {
+                // Always rethrow the original call error.
+            }
+            throw error;
+        }
+        await fn(eventCtx(ctx), { ok: true, output });
+        return output;
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AASA,SAAS,QAAQ,CAAC,GAAa;IAC7B,OAAO,GAAG,CAAC,MAAM;QACf,CAAC,CAAC;YACE,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB;QACH,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAA;AAChE,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,EAK0B;IAE1B,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE;QACnB,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;QACvB,OAAO,GAAG,CAAC,IAAI,EAAE,CAAA;IACnB,CAAC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,EAQyB;IAEzB,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE;QACnB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC/B,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAA;QAC/B,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,EAQyB;IAEzB,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE;QACnB,IAAI,CAAC;YACH,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAA;YAChC,CAAC;YAAC,MAAM,CAAC;gBACP,wDAAwD;YAC1D,CAAC;YACD,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,EAQyB;IAEzB,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE;QACnB,IAAI,MAAe,CAAA;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,0CAA0C;YAC5C,CAAC;YACD,MAAM,KAAK,CAAA;QACb,CAAC;QACD,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QAC7C,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;AACH,CAAC"}

package/dist/implement.d.ts

@@ -0,0 +1,28 @@
+import { type ContractBuilder, type ContractProcedure } from '@ts-pf/contract';
+import type { MiddlewareFn } from './middleware.js';
+import { type ImplementedProcedure, type ImplementedRouter } from './runtime.js';
+export declare function createImplementer<T>(contract: T): Implementer<T, object>;
+export type ProcedureBuilder<TInput, TOutput, TCtx, TErrors extends Record<string, unknown> = Record<string, unknown>> = {
+    use: (mw: MiddlewareFn<TCtx, unknown, TOutput>) => ProcedureBuilder<TInput, TOutput, TCtx, TErrors>;
+    useAfter: (mw: MiddlewareFn<TCtx, TInput, TOutput>) => ProcedureBuilder<TInput, TOutput, TCtx, TErrors>;
+    handler: (fn: (opts: {
+        input: TInput;
+        context: TCtx;
+        errors: import('./middleware.js').ErrorFactory<TErrors>;
+        path: string[];
+        signal?: AbortSignal;
+    }) => TOutput | Promise<TOutput>) => ImplementedProcedure;
+};
+export type Implementer<T, TCtx> = {
+    $context: <C>() => Implementer<T, C>;
+    use: (mw: MiddlewareFn<TCtx, unknown, unknown>) => Implementer<T, TCtx>;
+    useAfter: (mw: MiddlewareFn<TCtx, unknown, unknown>) => Implementer<T, TCtx>;
+    middleware: (fn: MiddlewareFn<TCtx, unknown, unknown>) => MiddlewareFn<TCtx, unknown, unknown>;
+    router: (impl: RouterImpl<T, TCtx>) => ImplementedRouter<T>;
+} & {
+    [K in keyof T as K extends '~pf' ? never : K]: T[K] extends ContractBuilder<infer I, infer O, infer _E, infer _M> ? ProcedureBuilder<I, O, TCtx, _E> : T[K] extends ContractProcedure<infer I, infer O, infer _E, infer _M> ? ProcedureBuilder<I, O, TCtx, _E> : Implementer<T[K], TCtx>;
+};
+export type RouterImpl<T, TCtx> = {
+    [K in keyof T as K extends '~pf' ? never : K]: T[K] extends ContractBuilder<infer _I, infer _O, infer _E, infer _M> ? ImplementedProcedure : T[K] extends ContractProcedure<infer _I, infer _O, infer _E, infer _M> ? ImplementedProcedure : RouterImpl<T[K], TCtx>;
+};
+//# sourceMappingURL=implement.d.ts.map

package/dist/implement.d.ts.map

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

package/dist/implement.js

@@ -0,0 +1,132 @@
+import { isContractProcedure, } from '@ts-pf/contract';
+import { isImplementedProcedure, } from './runtime.js';
+function createImplemented(contract, inherited, extraUse, extraUseAfter, handler) {
+    return {
+        '~pf': {
+            type: 'implemented-procedure',
+            contract,
+            use: [...inherited.use, ...extraUse],
+            useAfter: [...inherited.useAfter, ...extraUseAfter],
+            handler,
+            path: inherited.path,
+        },
+    };
+}
+function applyInherited(node, inherited) {
+    if (isImplementedProcedure(node)) {
+        return {
+            '~pf': {
+                ...node['~pf'],
+                use: [...inherited.use, ...node['~pf'].use],
+                useAfter: [...inherited.useAfter, ...node['~pf'].useAfter],
+            },
+        };
+    }
+    const result = {};
+    for (const [key, child] of Object.entries(node)) {
+        if (key === '~pf') {
+            continue;
+        }
+        if (child) {
+            result[key] = applyInherited(child, inherited);
+        }
+    }
+    return result;
+}
+function assertComplete(contract, impl, path) {
+    if (isContractProcedure(contract)) {
+        if (!isImplementedProcedure(impl)) {
+            throw new Error(`Missing implementation at "${path.join('.') || '<root>'}"`);
+        }
+        return;
+    }
+    if (typeof contract !== 'object' || contract === null) {
+        return;
+    }
+    if (typeof impl !== 'object' || impl === null) {
+        throw new Error(`Missing implementation at "${path.join('.') || '<root>'}"`);
+    }
+    const contractKeys = Object.keys(contract).filter((key) => key !== '~pf');
+    const implKeys = Object.keys(impl).filter((key) => key !== '~pf');
+    for (const key of contractKeys) {
+        if (!(key in impl)) {
+            throw new Error(`Missing implementation at "${[...path, key].join('.')}"`);
+        }
+        assertComplete(contract[key], impl[key], [...path, key]);
+    }
+    for (const key of implKeys) {
+        if (!(key in contract)) {
+            throw new Error(`Unexpected implementation key "${[...path, key].join('.')}"`);
+        }
+    }
+}
+function createNode(contract, inherited) {
+    const extraUse = [];
+    const extraUseAfter = [];
+    const self = {
+        $context() {
+            return createNode(contract, inherited);
+        },
+        use(mw) {
+            return createNode(contract, { ...inherited, use: [...inherited.use, mw] });
+        },
+        useAfter(mw) {
+            return createNode(contract, {
+                ...inherited,
+                useAfter: [...inherited.useAfter, mw],
+            });
+        },
+        middleware(fn) {
+            return fn;
+        },
+        router(impl) {
+            assertComplete(contract, impl, inherited.path);
+            return applyInherited(impl, inherited);
+        },
+    };
+    if (isContractProcedure(contract)) {
+        self.handler = (fn) => createImplemented(contract, inherited, extraUse, extraUseAfter, fn);
+        self.use = (mw) => {
+            extraUse.push(mw);
+            return new Proxy(self, procedureProxy);
+        };
+        self.useAfter = (mw) => {
+            extraUseAfter.push(mw);
+            return new Proxy(self, procedureProxy);
+        };
+    }
+    const procedureProxy = {
+        get(target, key) {
+            if (key in target) {
+                return target[key];
+            }
+            return undefined;
+        },
+    };
+    return new Proxy(self, {
+        get(target, key) {
+            if (key in target) {
+                return target[key];
+            }
+            if (typeof key === 'symbol' || key === '~pf') {
+                return undefined;
+            }
+            if (typeof contract !== 'object' || contract === null) {
+                return undefined;
+            }
+            const child = contract[key];
+            if (child === undefined) {
+                return undefined;
+            }
+            return createNode(child, { ...inherited, path: [...inherited.path, key] });
+        },
+    });
+}
+export function createImplementer(contract) {
+    return createNode(contract, {
+        use: [],
+        useAfter: [],
+        path: [],
+    });
+}
+//# sourceMappingURL=implement.js.map

package/dist/implement.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export type { CallInterceptor } from './call-interceptor.js';
+export { createLocalClient } from './caller.js';
+export { DedupePlugin, type DedupePluginOptions } from './dedupe-plugin.js';
+export { onError, onFinish, onStart, onSuccess } from './events.js';
+export { createImplementer, type Implementer, type ProcedureBuilder, type RouterImpl, } from './implement.js';
+export type { ErrorFactory, MiddlewareFn, NextFn } from './middleware.js';
+export { applyPlugins, type CallPlugin } from './plugin.js';
+export { type ImplementedProcedure, type ImplementedRouter, isImplementedProcedure, lookupProcedure, type RunProcedureOptions, runProcedure, } from './runtime.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACnE,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,UAAU,GAChB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACzE,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,sBAAsB,EACtB,eAAe,EACf,KAAK,mBAAmB,EACxB,YAAY,GACb,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { createLocalClient } from './caller.js';
+export { DedupePlugin } from './dedupe-plugin.js';
+export { onError, onFinish, onStart, onSuccess } from './events.js';
+export { createImplementer, } from './implement.js';
+export { applyPlugins } from './plugin.js';
+export { isImplementedProcedure, lookupProcedure, runProcedure, } from './runtime.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,YAAY,EAA4B,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACnE,OAAO,EACL,iBAAiB,GAIlB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,YAAY,EAAmB,MAAM,aAAa,CAAA;AAC3D,OAAO,EAGL,sBAAsB,EACtB,eAAe,EAEf,YAAY,GACb,MAAM,cAAc,CAAA"}

package/dist/middleware.d.ts

@@ -0,0 +1,18 @@
+import type { ErrorDef, InferErrorData } from '@ts-pf/contract';
+export type NextFn<TCtx, TInput, TOutput> = (opts?: {
+    context?: Partial<TCtx>;
+    input?: TInput;
+}) => Promise<TOutput>;
+export type MiddlewareFn<TCtx = unknown, TInput = unknown, TOutput = unknown> = (opts: {
+    context: TCtx;
+    input: TInput;
+    next: NextFn<TCtx, TInput, TOutput>;
+    errors: ErrorFactory;
+    path: string[];
+}) => Promise<TOutput>;
+export type ErrorFactory<E extends Record<string, unknown> = Record<string, unknown>> = string extends keyof E ? {
+    [K in keyof E]: (data?: unknown) => never;
+} : {
+    [K in keyof E]: [InferErrorData<Extract<E[K], ErrorDef>>] extends [never] ? () => never : (data: InferErrorData<Extract<E[K], ErrorDef>>) => never;
+};
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAE/D,MAAM,MAAM,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAEtB,MAAM,MAAM,YAAY,CACtB,IAAI,GAAG,OAAO,EACd,MAAM,GAAG,OAAO,EAChB,OAAO,GAAG,OAAO,IACf,CAAC,IAAI,EAAE;IACT,OAAO,EAAE,IAAI,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,EAAE,MAAM,EAAE,CAAA;CACf,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAEtB,MAAM,MAAM,YAAY,CACtB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACzD,MAAM,SAAS,MAAM,CAAC,GACtB;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,KAAK;CAAE,GAC7C;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GACrE,MAAM,KAAK,GACX,CAAC,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK;CAC7D,CAAA"}

package/dist/middleware.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":""}

package/dist/plugin.d.ts

@@ -0,0 +1,7 @@
+import type { CallInterceptor } from './call-interceptor.js';
+export type CallPlugin = {
+    readonly name: string;
+    readonly intercept: CallInterceptor;
+};
+export declare function applyPlugins(plugins: readonly CallPlugin[], interceptors?: readonly CallInterceptor[]): CallInterceptor[];
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;CACpC,CAAA;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,YAAY,CAAC,EAAE,SAAS,eAAe,EAAE,GACxC,eAAe,EAAE,CAEnB"}

package/dist/plugin.js

@@ -0,0 +1,4 @@
+export function applyPlugins(plugins, interceptors) {
+    return [...plugins.map((plugin) => plugin.intercept), ...(interceptors ?? [])];
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,YAAY,CAC1B,OAA8B,EAC9B,YAAyC;IAEzC,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAA;AAChF,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,37 @@
+import { type ContractProcedure } from '@ts-pf/contract';
+import { type CallInterceptor } from './call-interceptor.js';
+import { createErrorFactory } from './error-factory.js';
+import type { MiddlewareFn } from './middleware.js';
+export type HandlerFn = (opts: {
+    input: unknown;
+    context: unknown;
+    errors: ReturnType<typeof createErrorFactory>;
+    path: string[];
+    signal?: AbortSignal;
+}) => unknown | Promise<unknown>;
+export type ImplementedProcedure = {
+    readonly '~pf': {
+        type: 'implemented-procedure';
+        contract: ContractProcedure;
+        use: MiddlewareFn[];
+        useAfter: MiddlewareFn[];
+        handler: HandlerFn;
+        path: string[];
+    };
+};
+declare const contractBrand: unique symbol;
+export type ImplementedRouter<T = unknown> = {
+    readonly [key: string]: ImplementedProcedure | ImplementedRouter | undefined;
+} & {
+    readonly [contractBrand]?: T;
+};
+export declare function isImplementedProcedure(value: unknown): value is ImplementedProcedure;
+export type RunProcedureOptions = {
+    signal?: AbortSignal;
+    interceptors?: readonly CallInterceptor[];
+};
+export declare function runProcedure(proc: ImplementedProcedure, rawInput: unknown, context: unknown, options?: RunProcedureOptions): Promise<unknown>;
+export declare function lookupProcedure(router: ImplementedRouter, path: string[]): ImplementedProcedure | undefined;
+export declare function assertContractProcedure(value: unknown): asserts value is ContractProcedure;
+export {};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EAIvB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,KAAK,eAAe,EAErB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,kBAAkB,EAAyB,MAAM,oBAAoB,CAAA;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE;IAC7B,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAA;IAC7C,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAEhC,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,KAAK,EAAE;QACd,IAAI,EAAE,uBAAuB,CAAA;QAC7B,QAAQ,EAAE,iBAAiB,CAAA;QAC3B,GAAG,EAAE,YAAY,EAAE,CAAA;QACnB,QAAQ,EAAE,YAAY,EAAE,CAAA;QACxB,OAAO,EAAE,SAAS,CAAA;QAClB,IAAI,EAAE,MAAM,EAAE,CAAA;KACf,CAAA;CACF,CAAA;AAED,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAA;AAE1C,MAAM,MAAM,iBAAiB,CAAC,CAAC,GAAG,OAAO,IAAI;IAC3C,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,oBAAoB,GAAG,iBAAiB,GAAG,SAAS,CAAA;CAC7E,GAAG;IAAE,QAAQ,CAAC,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAA;CAAE,CAAA;AAEpC,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,oBAAoB,CAO/B;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,YAAY,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;CAC1C,CAAA;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,oBAAoB,EAC1B,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAiHlB;AAwCD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,MAAM,EAAE,GACb,oBAAoB,GAAG,SAAS,CASlC;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,KAAK,IAAI,iBAAiB,CAIpC"}

package/dist/runtime.js

@@ -0,0 +1,165 @@
+import { isContractProcedure, validateSchema, } from '@ts-pf/contract';
+import { PFError } from '@ts-pf/protocol';
+import { runCallInterceptors, } from './call-interceptor.js';
+import { createErrorFactory, finalizeDeclaredError } from './error-factory.js';
+export function isImplementedProcedure(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '~pf' in value &&
+        value['~pf']?.type === 'implemented-procedure');
+}
+export async function runProcedure(proc, rawInput, context, options) {
+    const def = proc['~pf'];
+    const errors = createErrorFactory(def.contract['~pf'].errors);
+    let ctx = { ...context };
+    let input = rawInput;
+    let signal = options?.signal;
+    const runUseAfter = async (index) => {
+        const mw = def.useAfter[index];
+        if (!mw) {
+            const output = await def.handler({
+                input,
+                context: ctx,
+                errors,
+                path: def.path,
+                ...(signal ? { signal } : {}),
+            });
+            const outputSchema = def.contract['~pf'].output;
+            if (outputSchema) {
+                const result = await validateSchema(outputSchema, output);
+                if (!result.success) {
+                    throw new PFError({
+                        code: 'INTERNAL',
+                        message: 'Internal server error',
+                    });
+                }
+                return result.value;
+            }
+            return output;
+        }
+        return mw({
+            context: ctx,
+            input,
+            errors,
+            path: def.path,
+            next: async (opts) => {
+                if (opts?.context) {
+                    ctx = { ...ctx, ...opts.context };
+                }
+                if (opts && 'input' in opts) {
+                    input = opts.input;
+                }
+                return runUseAfter(index + 1);
+            },
+        });
+    };
+    const runUse = async (index) => {
+        const mw = def.use[index];
+        if (!mw) {
+            const inputSchema = def.contract['~pf'].input;
+            if (inputSchema) {
+                const result = await validateSchema(inputSchema, input);
+                if (!result.success) {
+                    throw new PFError({
+                        code: 'VALIDATION',
+                        message: 'Validation failed',
+                        data: { issues: result.issues },
+                    });
+                }
+                input = result.value;
+            }
+            return runUseAfter(0);
+        }
+        return mw({
+            context: ctx,
+            input,
+            errors,
+            path: def.path,
+            next: async (opts) => {
+                if (opts?.context) {
+                    ctx = { ...ctx, ...opts.context };
+                }
+                if (opts && 'input' in opts) {
+                    input = opts.input;
+                }
+                return runUse(index + 1);
+            },
+        });
+    };
+    const map = def.contract['~pf'].errors;
+    const interceptors = options?.interceptors;
+    if (!interceptors?.length) {
+        try {
+            const output = await runUse(0);
+            return wrapIfAsyncIterable(output, map);
+        }
+        catch (error) {
+            return await finalizeDeclaredError(error, map);
+        }
+    }
+    return runCallInterceptors(interceptors, {
+        procedure: proc,
+        path: def.path,
+        input: rawInput,
+        context,
+        ...(signal ? { signal } : {}),
+    }, async (current) => {
+        input = current.input;
+        ctx = { ...current.context };
+        signal = current.signal;
+        try {
+            const output = await runUse(0);
+            return wrapIfAsyncIterable(output, map);
+        }
+        catch (error) {
+            return await finalizeDeclaredError(error, map);
+        }
+    });
+}
+function isAsyncIterable(value) {
+    return (typeof value === 'object' && value !== null && Symbol.asyncIterator in value);
+}
+function wrapIfAsyncIterable(value, map) {
+    if (!isAsyncIterable(value)) {
+        return value;
+    }
+    return wrapAsyncIterable(value, map);
+}
+function wrapAsyncIterable(value, map) {
+    return {
+        [Symbol.asyncIterator]() {
+            const it = value[Symbol.asyncIterator]();
+            return {
+                async next() {
+                    try {
+                        return await it.next();
+                    }
+                    catch (error) {
+                        return await finalizeDeclaredError(error, map);
+                    }
+                },
+                async return() {
+                    return it.return
+                        ? it.return()
+                        : { done: true, value: undefined };
+                },
+            };
+        },
+    };
+}
+export function lookupProcedure(router, path) {
+    let current = router;
+    for (const segment of path) {
+        if (!current || isImplementedProcedure(current)) {
+            return undefined;
+        }
+        current = current[segment];
+    }
+    return current && isImplementedProcedure(current) ? current : undefined;
+}
+export function assertContractProcedure(value) {
+    if (!isContractProcedure(value)) {
+        throw new Error('Expected a contract procedure');
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@ts-pf/server",
+  "version": "0.1.0-beta.0",
+  "description": "Implementer, middleware, runProcedure, and in-process local client",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/crobinson42/ts-pf.git",
+    "directory": "packages/server"
+  },
+  "homepage": "https://github.com/crobinson42/ts-pf/tree/main/packages/server#readme",
+  "bugs": {
+    "url": "https://github.com/crobinson42/ts-pf/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "type-check": "tsc --noEmit",
+    "lint": "biome check src tests"
+  },
+  "dependencies": {
+    "@ts-pf/contract": "0.1.0-beta.0",
+    "@ts-pf/protocol": "0.1.0-beta.0"
+  },
+  "devDependencies": {
+    "zod": "^4.0.0"
+  }
+}

package/skills/ts-pf-server/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: ts-pf-server
+description: Use when implementing a ts-pf contract with createImplementer, middleware, runProcedure, createLocalClient, or server DedupePlugin / CallInterceptor. Triggers: @ts-pf/server, createImplementer, .use(), .useAfter(), createLocalClient, applyPlugins.
+---
+
+# @ts-pf/server
+
+Implementer, middleware, `runProcedure`. No `Request` / `Response`.
+
+Install: `npm i @ts-pf/server@beta` (needs `@ts-pf/contract` + `@ts-pf/protocol`)
+
+Link for agents: `npx skills experimental_sync -y`
+
+## Do
+
+```ts
+import { createImplementer, DedupePlugin } from '@ts-pf/server'
+import { PFError } from '@ts-pf/protocol'
+
+const impl = createImplementer(contract).$context<{ db: Db }>()
+
+const requireUser = impl.middleware(async ({ context, next }) => {
+  const user = await auth(context)
+  if (!user) throw new PFError({ code: 'UNAUTHORIZED', status: 401 })
+  return next({ context: { user } })
+})
+
+export const app = impl.use(requireUser).router({
+  planet: {
+    find: impl.planet.find.handler(async ({ input, context, errors }) => {
+      const row = await context.db.planets.get(input.id)
+      if (!row) throw errors.NOT_FOUND({ id: input.id })
+      return row
+    }),
+  },
+})
+```
+
+`.use()` runs before input validation (`input: unknown`). `.useAfter()` runs after (typed input). `$context<C>()` is the context type source; middleware runtime-merges and does not infer added keys. Pass HTTP `Request` in `FetchHandler.handle(..., { context })`, not via `$context` alone. Name the implemented router `app`. Default `DedupePlugin` keys every unary call — pass `key` to restrict to reads.
+
+## API
+
+- `createImplementer`, `createLocalClient`, `runProcedure`, `lookupProcedure`
+- `applyPlugins`, `CallPlugin`, `CallInterceptor`, `DedupePlugin`
+- `onStart` / `onSuccess` / `onError` / `onFinish`
+
+## Pair with
+
+- HTTP: `ts-pf-server-http` (`FetchHandler`)
+- Message: `ts-pf-message-server`
+- In-process: `createLocalClient(app, { context, plugins, interceptors })`
+
+## Don't
+
+- `FetchHandler` or HTTP plugins here.
+- Import `CallInterceptor` from `@ts-pf/client` (duplicate types).
+- Attach interceptors on `createImplementer` — they attach per caller (`createLocalClient` / handler `{ interceptors }`).
+- Default `DedupePlugin` on non-idempotent writes.