@supalive/core 0.1.0

package/dist/src/router/procedure.d.ts

@@ -0,0 +1,204 @@
+import type { ZodType } from "zod";
+import type { DbReader, DbWriter } from "../db/context";
+import type { SupaliveDb } from "../db/realtime_db";
+/**
+ * Query context passed to query handlers.
+ * Contains database reader and user-defined server context.
+ */
+export interface QueryCtx<TContext = unknown> {
+    /** Database reader for queries */
+    db: DbReader;
+    /** User-defined server context (auth, requestId, etc.) */
+    serverCtx: TContext;
+}
+/**
+ * Mutation context passed to mutation handlers.
+ * Contains database writer and user-defined server context.
+ */
+export interface MutationCtx<TContext = unknown> {
+    /** Database writer for mutations (includes insert/update/delete) */
+    db: DbWriter;
+    /** User-defined server context (auth, requestId, etc.) */
+    serverCtx: TContext;
+}
+/**
+ * Action context passed to action handlers.
+ * Contains the full SupaliveDb for both queries and mutations, plus user-defined server context.
+ */
+export interface ActionCtx<TContext = unknown> {
+    /** Full database interface for queries and mutations */
+    db: SupaliveDb;
+    /** User-defined server context (auth, requestId, etc.) */
+    serverCtx: TContext;
+}
+export type QueryFn<TInput, TResult, TContext = unknown> = (ctx: QueryCtx<TContext>, input: TInput) => Promise<TResult>;
+export type MutationFn<TInput, TResult, TContext = unknown> = (ctx: MutationCtx<TContext>, input: TInput) => Promise<TResult>;
+export type ActionFn<TInput, TResult, TContext = unknown> = (ctx: ActionCtx<TContext>, input: TInput) => Promise<TResult>;
+/**
+ * Per-procedure override for the cache/subscription segmentation key.
+ *
+ *   omitted | undefined  → fall back to `config.getUserId(serverCtx)` (default)
+ *   false               → no identity in hash; cache/sub shared across all users
+ *   string              → a static identity literal (e.g. "public" or a tenant id)
+ *   function            → compute from serverCtx + input (sync)
+ *
+ * When the result of a query is identical regardless of who calls it, set
+ * this to a literal (or `false`) so a single cache entry serves everyone.
+ *
+ * The function form intentionally takes `serverCtx` (not the full `QueryCtx`)
+ * because identity is resolved before any DB read is issued.
+ */
+export type QueryIdentitySpec<TInput, TContext> = false | string | ((serverCtx: TContext, input: TInput) => string | null | undefined);
+export interface BaseProcedure<TInput, TResult, TType extends "query" | "mutation" | "action", TContext = unknown, TInternal extends boolean = boolean> {
+    readonly _type: "procedure";
+    readonly procedureType: TType;
+    readonly inputSchema: ZodType<TInput>;
+    readonly fn: QueryFn<TInput, TResult, TContext> | MutationFn<TInput, TResult, TContext> | ActionFn<TInput, TResult, TContext>;
+    readonly internal: TInternal;
+}
+export interface QueryProcedure<TInput, TResult, TContext = unknown, TInternal extends boolean = boolean> extends BaseProcedure<TInput, TResult, "query", TContext, TInternal> {
+    readonly procedureType: "query";
+    readonly fn: QueryFn<TInput, TResult, TContext>;
+    readonly queryIdentity?: QueryIdentitySpec<TInput, TContext>;
+}
+export interface MutationProcedure<TInput, TResult, TContext = unknown, TInternal extends boolean = boolean> extends BaseProcedure<TInput, TResult, "mutation", TContext, TInternal> {
+    readonly procedureType: "mutation";
+    readonly fn: MutationFn<TInput, TResult, TContext>;
+}
+export interface ActionProcedure<TInput, TResult, TContext = unknown, TInternal extends boolean = boolean> extends BaseProcedure<TInput, TResult, "action", TContext, TInternal> {
+    readonly procedureType: "action";
+    readonly fn: ActionFn<TInput, TResult, TContext>;
+}
+export type AnyProcedure<TContext = unknown> = QueryProcedure<any, any, TContext> | MutationProcedure<any, any, TContext> | ActionProcedure<any, any, TContext>;
+export interface QueryConfig<TInput, TResult, TContext = unknown> {
+    /** Zod schema for input validation */
+    args: ZodType<TInput>;
+    /** The query handler function */
+    handler: QueryFn<TInput, TResult, TContext>;
+    /** Mark as internal (server-only). Default: false */
+    internal?: boolean;
+    /**
+     * Override the cache/subscription segmentation key for this procedure.
+     * See {@link QueryIdentitySpec}. Omit to keep the default (per-user) behavior.
+     */
+    queryIdentity?: QueryIdentitySpec<TInput, TContext>;
+}
+export interface MutationConfig<TInput, TResult, TContext = unknown> {
+    /** Zod schema for input validation */
+    args: ZodType<TInput>;
+    /** The mutation handler function */
+    handler: MutationFn<TInput, TResult, TContext>;
+    /** Mark as internal (server-only). Default: false */
+    internal?: boolean;
+}
+export interface ActionConfig<TInput, TResult, TContext = unknown> {
+    /** Zod schema for input validation */
+    args: ZodType<TInput>;
+    /** The action handler function */
+    handler: ActionFn<TInput, TResult, TContext>;
+    /** Mark as internal (server-only). Default: false */
+    internal?: boolean;
+}
+/** Extract input type from a procedure */
+export type InputOf<T> = T extends BaseProcedure<infer I, any, any, any> ? I : never;
+/** Extract output type from a procedure */
+export type OutputOf<T> = T extends BaseProcedure<any, infer O, any, any> ? O : never;
+/** Extract procedure type (query/mutation) */
+export type TypeOf<T> = T extends BaseProcedure<any, any, infer Type, any> ? Type : never;
+/** Extract server context type from a procedure */
+export type ContextOf<T> = T extends BaseProcedure<any, any, any, infer C> ? C : never;
+/**
+ * Create a query builder with a pre-defined context type.
+ * This allows you to define the context type once and have it inferred
+ * automatically in all your query handlers.
+ *
+ * @example
+ * // Define your server context
+ * interface ServerContext {
+ *   auth: { userId: string };
+ *   requestId: string;
+ * }
+ *
+ * // Create a typed query builder
+ * const query = createQueryBuilder<ServerContext>();
+ *
+ * // Use it - context type is automatically inferred!
+ * const getUser = query({
+ *   args: z.object({ id: z.string() }),
+ *   handler: async (ctx, { id }) => {
+ *     // ctx.db for database queries
+ *     const user = await ctx.db.query(UsersSchema).find(id);
+ *     // ctx.context for server context
+ *     console.log(ctx.context.requestId);
+ *     return user;
+ *   }
+ * });
+ */
+export declare function createQueryBuilder<TContext = unknown>(): <TInput, TResult, const TInternal extends boolean = false>(config: QueryConfig<TInput, TResult, TContext> & {
+    internal?: TInternal;
+}) => QueryProcedure<TInput, TResult, TContext, TInternal>;
+/**
+ * Create a mutation builder with a pre-defined context type.
+ * This allows you to define the context type once and have it inferred
+ * automatically in all your mutation handlers.
+ *
+ * @example
+ * // Define your server context
+ * interface ServerContext {
+ *   auth: { userId: string };
+ *   requestId: string;
+ * }
+ *
+ * // Create a typed mutation builder
+ * const mutation = createMutationBuilder<ServerContext>();
+ *
+ * // Use it - context type is automatically inferred!
+ * const createUser = mutation({
+ *   args: z.object({ name: z.string() }),
+ *   handler: async (ctx, { name }) => {
+ *     // ctx.db for mutations
+ *     await ctx.db.insert(UsersSchema, id, { name });
+ *     // ctx.context for server context
+ *     console.log(ctx.context.requestId);
+ *     return { success: true };
+ *   }
+ * });
+ */
+export declare function createMutationBuilder<TContext = unknown>(): <TInput, TResult, const TInternal extends boolean = false>(config: MutationConfig<TInput, TResult, TContext> & {
+    internal?: TInternal;
+}) => MutationProcedure<TInput, TResult, TContext, TInternal>;
+/**
+ * Create an action builder with a pre-defined context type.
+ * Actions have access to the full SupaliveDb for both queries and mutations.
+ *
+ * @example
+ * // Define your server context
+ * interface ServerContext {
+ *   auth: { userId: string };
+ *   requestId: string;
+ * }
+ *
+ * // Create a typed action builder
+ * const action = createActionBuilder<ServerContext>();
+ *
+ * // Use it - context type is automatically inferred!
+ * const processOrder = action({
+ *   args: z.object({ orderId: z.string() }),
+ *   handler: async (ctx, { orderId }) => {
+ *     // ctx.db for full database access
+ *     const order = await ctx.db.query(async (db) => {
+ *       return db.query(OrdersSchema).find(orderId);
+ *     });
+ *     await ctx.db.mutation(async (db) => {
+ *       await db.update(OrdersSchema, orderId, { status: "processed" });
+ *     });
+ *     // ctx.context for server context
+ *     console.log(ctx.context.requestId);
+ *     return { success: true };
+ *   }
+ * });
+ */
+export declare function createActionBuilder<TContext = unknown>(): <TInput, TResult, const TInternal extends boolean = false>(config: ActionConfig<TInput, TResult, TContext> & {
+    internal?: TInternal;
+}) => ActionProcedure<TInput, TResult, TContext, TInternal>;
+//# sourceMappingURL=procedure.d.ts.map

package/dist/src/router/procedure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedure.d.ts","sourceRoot":"","sources":["../../../src/router/procedure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD;;;GAGG;AACH,MAAM,WAAW,QAAQ,CAAC,QAAQ,GAAG,OAAO;IAC1C,kCAAkC;IAClC,EAAE,EAAE,QAAQ,CAAC;IACb,0DAA0D;IAC1D,SAAS,EAAE,QAAQ,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW,CAAC,QAAQ,GAAG,OAAO;IAC7C,oEAAoE;IACpE,EAAE,EAAE,QAAQ,CAAC;IACb,0DAA0D;IAC1D,SAAS,EAAE,QAAQ,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS,CAAC,QAAQ,GAAG,OAAO;IAC3C,wDAAwD;IACxD,EAAE,EAAE,UAAU,CAAC;IACf,0DAA0D;IAC1D,SAAS,EAAE,QAAQ,CAAC;CACrB;AAID,MAAM,MAAM,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,IAAI,CACzD,GAAG,EAAE,QAAQ,CAAC,QAAQ,CAAC,EACvB,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,MAAM,MAAM,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,IAAI,CAC5D,GAAG,EAAE,WAAW,CAAC,QAAQ,CAAC,EAC1B,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,MAAM,MAAM,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,IAAI,CAC1D,GAAG,EAAE,SAAS,CAAC,QAAQ,CAAC,EACxB,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,iBAAiB,CAAC,MAAM,EAAE,QAAQ,IAC1C,KAAK,GACL,MAAM,GACN,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAExE,MAAM,WAAW,aAAa,CAC5B,MAAM,EAAE,OAAO,EACf,KAAK,SAAS,OAAO,GAAG,UAAU,GAAG,QAAQ,EAC7C,QAAQ,GAAG,OAAO,EAClB,SAAS,SAAS,OAAO,GAAG,OAAO;IAEnC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9H,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc,CAC7B,MAAM,EAAE,OAAO,EACf,QAAQ,GAAG,OAAO,EAClB,SAAS,SAAS,OAAO,GAAG,OAAO,CACnC,SAAQ,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC;IACpE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChD,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,iBAAiB,CAChC,MAAM,EAAE,OAAO,EACf,QAAQ,GAAG,OAAO,EAClB,SAAS,SAAS,OAAO,GAAG,OAAO,CACnC,SAAQ,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC;IACvE,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC;IACnC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,eAAe,CAC9B,MAAM,EAAE,OAAO,EACf,QAAQ,GAAG,OAAO,EAClB,SAAS,SAAS,OAAO,GAAG,OAAO,CACnC,SAAQ,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC;IACrE,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;IACjC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;CAClD;AAED,MAAM,MAAM,YAAY,CAAC,QAAQ,GAAG,OAAO,IACvC,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,GAClC,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,GACrC,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;AAIxC,MAAM,WAAW,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO;IAC9D,sCAAsC;IACtC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC5C,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO;IACjE,sCAAsC;IACtC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,oCAAoC;IACpC,OAAO,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/C,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO;IAC/D,sCAAsC;IACtC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,kCAAkC;IAClC,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7C,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,0CAA0C;AAC1C,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAErF,2CAA2C;AAC3C,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEtF,8CAA8C;AAC9C,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,IAAI,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC;AAE1F,mDAAmD;AACnD,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEvF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,GAAG,OAAO,MAC7B,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,SAAS,OAAO,GAAG,KAAK,EAC5E,QAAQ,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,KACxE,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAUxD;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,GAAG,OAAO,MAC7B,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,SAAS,OAAO,GAAG,KAAK,EAC/E,QAAQ,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,KAC3E,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAS3D;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,GAAG,OAAO,MAC7B,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,SAAS,OAAO,GAAG,KAAK,EAC7E,QAAQ,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,KACzE,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CASzD"}

package/dist/src/router/procedure.js

@@ -0,0 +1,122 @@
+/**
+ * Create a query builder with a pre-defined context type.
+ * This allows you to define the context type once and have it inferred
+ * automatically in all your query handlers.
+ *
+ * @example
+ * // Define your server context
+ * interface ServerContext {
+ *   auth: { userId: string };
+ *   requestId: string;
+ * }
+ *
+ * // Create a typed query builder
+ * const query = createQueryBuilder<ServerContext>();
+ *
+ * // Use it - context type is automatically inferred!
+ * const getUser = query({
+ *   args: z.object({ id: z.string() }),
+ *   handler: async (ctx, { id }) => {
+ *     // ctx.db for database queries
+ *     const user = await ctx.db.query(UsersSchema).find(id);
+ *     // ctx.context for server context
+ *     console.log(ctx.context.requestId);
+ *     return user;
+ *   }
+ * });
+ */
+export function createQueryBuilder() {
+    return function query(config) {
+        return {
+            _type: "procedure",
+            procedureType: "query",
+            inputSchema: config.args,
+            fn: config.handler,
+            internal: (config.internal ?? false),
+            queryIdentity: config.queryIdentity,
+        };
+    };
+}
+// ─── Mutation Builder Factory ────────────────────────────────────────────────
+/**
+ * Create a mutation builder with a pre-defined context type.
+ * This allows you to define the context type once and have it inferred
+ * automatically in all your mutation handlers.
+ *
+ * @example
+ * // Define your server context
+ * interface ServerContext {
+ *   auth: { userId: string };
+ *   requestId: string;
+ * }
+ *
+ * // Create a typed mutation builder
+ * const mutation = createMutationBuilder<ServerContext>();
+ *
+ * // Use it - context type is automatically inferred!
+ * const createUser = mutation({
+ *   args: z.object({ name: z.string() }),
+ *   handler: async (ctx, { name }) => {
+ *     // ctx.db for mutations
+ *     await ctx.db.insert(UsersSchema, id, { name });
+ *     // ctx.context for server context
+ *     console.log(ctx.context.requestId);
+ *     return { success: true };
+ *   }
+ * });
+ */
+export function createMutationBuilder() {
+    return function mutation(config) {
+        return {
+            _type: "procedure",
+            procedureType: "mutation",
+            inputSchema: config.args,
+            fn: config.handler,
+            internal: (config.internal ?? false),
+        };
+    };
+}
+// ─── Action Builder Factory ──────────────────────────────────────────────────
+/**
+ * Create an action builder with a pre-defined context type.
+ * Actions have access to the full SupaliveDb for both queries and mutations.
+ *
+ * @example
+ * // Define your server context
+ * interface ServerContext {
+ *   auth: { userId: string };
+ *   requestId: string;
+ * }
+ *
+ * // Create a typed action builder
+ * const action = createActionBuilder<ServerContext>();
+ *
+ * // Use it - context type is automatically inferred!
+ * const processOrder = action({
+ *   args: z.object({ orderId: z.string() }),
+ *   handler: async (ctx, { orderId }) => {
+ *     // ctx.db for full database access
+ *     const order = await ctx.db.query(async (db) => {
+ *       return db.query(OrdersSchema).find(orderId);
+ *     });
+ *     await ctx.db.mutation(async (db) => {
+ *       await db.update(OrdersSchema, orderId, { status: "processed" });
+ *     });
+ *     // ctx.context for server context
+ *     console.log(ctx.context.requestId);
+ *     return { success: true };
+ *   }
+ * });
+ */
+export function createActionBuilder() {
+    return function action(config) {
+        return {
+            _type: "procedure",
+            procedureType: "action",
+            inputSchema: config.args,
+            fn: config.handler,
+            internal: (config.internal ?? false),
+        };
+    };
+}
+//# sourceMappingURL=procedure.js.map

package/dist/src/router/procedure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedure.js","sourceRoot":"","sources":["../../../src/router/procedure.ts"],"names":[],"mappings":"AAuKA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,SAAS,KAAK,CACnB,MAAyE;QAEzE,OAAO;YACL,KAAK,EAAE,WAAW;YAClB,aAAa,EAAE,OAAO;YACtB,WAAW,EAAE,MAAM,CAAC,IAAI;YACxB,EAAE,EAAE,MAAM,CAAC,OAAO;YAClB,QAAQ,EAAE,CAAC,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAc;YACjD,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,SAAS,QAAQ,CACtB,MAA4E;QAE5E,OAAO;YACL,KAAK,EAAE,WAAW;YAClB,aAAa,EAAE,UAAU;YACzB,WAAW,EAAE,MAAM,CAAC,IAAI;YACxB,EAAE,EAAE,MAAM,CAAC,OAAO;YAClB,QAAQ,EAAE,CAAC,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAc;SAClD,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,SAAS,MAAM,CACpB,MAA0E;QAE1E,OAAO;YACL,KAAK,EAAE,WAAW;YAClB,aAAa,EAAE,QAAQ;YACvB,WAAW,EAAE,MAAM,CAAC,IAAI;YACxB,EAAE,EAAE,MAAM,CAAC,OAAO;YAClB,QAAQ,EAAE,CAAC,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAc;SAClD,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/router/router.d.ts

@@ -0,0 +1,88 @@
+import type { AnyProcedure } from "./procedure";
+/**
+ * A router maps procedure names (keys) to their definitions.
+ * This is the type that's exported from your app and used by the client.
+ */
+export type Router<TProcedures extends Record<string, AnyProcedure<TContext>>, TContext = unknown> = {
+    _type: "router";
+    procedures: TProcedures;
+    contextName: string;
+};
+/**
+ * Inferred AppRouter type from router() call.
+ * Captures the full procedure map for client type inference.
+ */
+export type AppRouter<TProcedures extends Record<string, AnyProcedure<TContext>> = Record<string, AnyProcedure>, TContext = unknown> = Router<TProcedures, TContext>;
+/** Get query procedures only from a router */
+export type QueryProcedures<T extends Record<string, AnyProcedure>> = {
+    [K in keyof T as T[K] extends {
+        procedureType: "query";
+    } ? K : never]: T[K];
+};
+/** Get mutation procedures only from a router */
+export type MutationProcedures<T extends Record<string, AnyProcedure>> = {
+    [K in keyof T as T[K] extends {
+        procedureType: "mutation";
+    } ? K : never]: T[K];
+};
+/** Get action procedures only from a router */
+export type ActionProcedures<T extends Record<string, AnyProcedure>> = {
+    [K in keyof T as T[K] extends {
+        procedureType: "action";
+    } ? K : never]: T[K];
+};
+/** Get public (non-internal) procedures - for client type safety */
+export type PublicProcedures<T extends Record<string, AnyProcedure>> = Pick<T, {
+    [K in keyof T]: T[K] extends {
+        internal: true;
+    } ? never : K;
+}[keyof T]>;
+/** Extract procedure names from a router */
+export type ProcedureNames<T extends Router<any>> = T extends Router<infer P> ? keyof P : never;
+export type RouterConfig<T> = {
+    procedures: T;
+    contextName?: string;
+};
+/**
+* Create a router from procedure definitions.
+* Procedure names are inferred from the object keys.
+*
+* @example
+* const appRouter = router({
+*   procedures: {
+*     getUser,
+*     createUser,
+*     internalGetAll,
+*   },
+* });
+*
+* export type AppRouter = typeof appRouter;
+*/
+export declare function router<TProcedures extends Record<string, AnyProcedure<any>>, TContext = unknown>(config: RouterConfig<TProcedures>): Router<TProcedures, TContext>;
+export interface RegisteredProcedure<TContext = unknown> {
+    name: string;
+    type: "query" | "mutation" | "action";
+    internal: boolean;
+    inputSchema: AnyProcedure<TContext>["inputSchema"];
+    fn: AnyProcedure<TContext>["fn"];
+    /** Only present for `type === "query"`. See `QueryIdentitySpec`. */
+    queryIdentity?: false | string | ((serverCtx: TContext, input: unknown) => string | null | undefined);
+}
+export declare function getContextRegistry(inContext: string): ContextRegistry;
+export declare class ContextRegistry {
+    procedureRegistry: Map<string, RegisteredProcedure<any>>;
+    internalProcedureNames: Set<string>;
+    registerProcedure<TContext>(name: string, proc: AnyProcedure<TContext>): void;
+    /** Get a registered procedure by name (runtime lookup) */
+    getProcedure<TContext = unknown>(name: string): RegisteredProcedure<TContext> | undefined;
+    /** Get all registered procedure names */
+    getProcedureNames(): string[];
+    /** Get all registered procedures */
+    getAllProcedures(): Map<string, RegisteredProcedure>;
+    /** Clear the registry (for testing only) */
+    clearRegistry(): void;
+    markInternalProcedure(name: string): void;
+    isInternalProcedure(name: string): boolean;
+    clearInternalProcedures(): void;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/src/router/router.d.ts.map

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

package/dist/src/router/router.js

@@ -0,0 +1,88 @@
+/**
+* Create a router from procedure definitions.
+* Procedure names are inferred from the object keys.
+*
+* @example
+* const appRouter = router({
+*   procedures: {
+*     getUser,
+*     createUser,
+*     internalGetAll,
+*   },
+* });
+*
+* export type AppRouter = typeof appRouter;
+*/
+export function router(config) {
+    const registry = getContextRegistry(config.contextName ?? "default");
+    // Register all procedures at router creation time
+    for (const [name, proc] of Object.entries(config.procedures)) {
+        registry.registerProcedure(name, proc);
+    }
+    return {
+        _type: "router",
+        procedures: config.procedures,
+        contextName: config.contextName ?? "default",
+    };
+}
+const contextRegistry = new Map();
+export function getContextRegistry(inContext) {
+    let registry = contextRegistry.get(inContext);
+    if (!registry) {
+        registry = new ContextRegistry();
+        contextRegistry.set(inContext, registry);
+    }
+    return registry;
+}
+export class ContextRegistry {
+    procedureRegistry = new Map();
+    internalProcedureNames = new Set();
+    registerProcedure(name, proc) {
+        if (this.procedureRegistry.has(name)) {
+            throw new Error(`[router] Procedure "${name}" is already registered. ` +
+                `Each procedure name must be unique across the application.`);
+        }
+        // Track internal procedures by name
+        if (proc.internal) {
+            this.markInternalProcedure(name);
+        }
+        const queryIdentity = proc.procedureType === "query"
+            ? proc.queryIdentity
+            : undefined;
+        this.procedureRegistry.set(name, {
+            name,
+            type: proc.procedureType,
+            internal: proc.internal,
+            inputSchema: proc.inputSchema,
+            fn: proc.fn,
+            queryIdentity,
+        });
+    }
+    /** Get a registered procedure by name (runtime lookup) */
+    getProcedure(name) {
+        return this.procedureRegistry.get(name);
+    }
+    /** Get all registered procedure names */
+    getProcedureNames() {
+        return [...this.procedureRegistry.keys()];
+    }
+    /** Get all registered procedures */
+    getAllProcedures() {
+        return new Map(this.procedureRegistry);
+    }
+    /** Clear the registry (for testing only) */
+    clearRegistry() {
+        this.procedureRegistry.clear();
+        this.clearInternalProcedures();
+    }
+    markInternalProcedure(name) {
+        this.internalProcedureNames.add(name);
+    }
+    isInternalProcedure(name) {
+        return this.internalProcedureNames.has(name);
+    }
+    clearInternalProcedures() {
+        this.internalProcedureNames.clear();
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/src/router/router.js.map

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

package/dist/src/server/hash.d.ts

@@ -0,0 +1,12 @@
+/**
+ * FNV-1a 32-bit hash.
+ *
+ * Used for routing subscription operations to logical workers inside the
+ * sub-manager process. Same input always returns the same 32-bit unsigned
+ * integer in both JavaScript and Go, so a future Go port of the sub-manager
+ * can use the identical routing without rebalancing keys.
+ *
+ * Reference: http://www.isthe.com/chongo/tech/comp/fnv/
+ */
+export declare function fnv1a32(s: string): number;
+//# sourceMappingURL=hash.d.ts.map

package/dist/src/server/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/server/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAQzC"}

package/dist/src/server/hash.js

@@ -0,0 +1,20 @@
+/**
+ * FNV-1a 32-bit hash.
+ *
+ * Used for routing subscription operations to logical workers inside the
+ * sub-manager process. Same input always returns the same 32-bit unsigned
+ * integer in both JavaScript and Go, so a future Go port of the sub-manager
+ * can use the identical routing without rebalancing keys.
+ *
+ * Reference: http://www.isthe.com/chongo/tech/comp/fnv/
+ */
+export function fnv1a32(s) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        // h = h * 16777619, expressed as shifts to stay in 32-bit space
+        h = (h + ((h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24))) >>> 0;
+    }
+    return h >>> 0;
+}
+//# sourceMappingURL=hash.js.map

package/dist/src/server/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../src/server/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,IAAI,CAAC,GAAG,UAAU,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACrB,gEAAgE;QAChE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC"}

package/dist/src/server/hash.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hash.test.d.ts.map

package/dist/src/server/hash.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.test.d.ts","sourceRoot":"","sources":["../../../src/server/hash.test.ts"],"names":[],"mappings":""}

package/dist/src/server/hash.test.js

@@ -0,0 +1,43 @@
+import { describe, it, expect } from "vitest";
+import { fnv1a32 } from "./hash";
+describe("fnv1a32", () => {
+    it("is deterministic", () => {
+        expect(fnv1a32("hello")).toBe(fnv1a32("hello"));
+        expect(fnv1a32("")).toBe(fnv1a32(""));
+    });
+    it("returns a 32-bit unsigned integer", () => {
+        const samples = ["", "a", "hello world", "sub_abc123", "x".repeat(200)];
+        for (const s of samples) {
+            const h = fnv1a32(s);
+            expect(Number.isInteger(h)).toBe(true);
+            expect(h >= 0).toBe(true);
+            expect(h <= 0xffffffff).toBe(true);
+        }
+    });
+    it("matches well-known FNV-1a 32 reference vectors", () => {
+        // Reference values from the canonical FNV-1a 32-bit specification.
+        // http://www.isthe.com/chongo/tech/comp/fnv/
+        expect(fnv1a32("")).toBe(0x811c9dc5);
+        expect(fnv1a32("a")).toBe(0xe40c292c);
+        expect(fnv1a32("foobar")).toBe(0xbf9cf968);
+    });
+    it("differs for different inputs", () => {
+        expect(fnv1a32("a")).not.toBe(fnv1a32("b"));
+        expect(fnv1a32("hello")).not.toBe(fnv1a32("Hello"));
+    });
+    it("distributes reasonably evenly across small buckets", () => {
+        const buckets = new Array(4).fill(0);
+        const N = 2000;
+        for (let i = 0; i < N; i++) {
+            buckets[fnv1a32(`sub_${i}`) % 4]++;
+        }
+        // Each bucket should be within ~25% of the expected mean (N/4 = 500).
+        // We allow a generous band because this is a sanity check, not a
+        // distribution proof.
+        for (const c of buckets) {
+            expect(c).toBeGreaterThan(N / 4 * 0.75);
+            expect(c).toBeLessThan(N / 4 * 1.25);
+        }
+    });
+});
+//# sourceMappingURL=hash.test.js.map

package/dist/src/server/hash.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.test.js","sourceRoot":"","sources":["../../../src/server/hash.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEjC,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC1B,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,OAAO,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACrB,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,MAAM,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,mEAAmE;QACnE,6CAA6C;QAC7C,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAa,CAAC;QACjD,MAAM,CAAC,GAAG,IAAI,CAAC;QACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAE,EAAE,CAAC;QACtC,CAAC;QACD,sEAAsE;QACtE,iEAAiE;QACjE,sBAAsB;QACtB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;YACxC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/server/index.d.ts

@@ -0,0 +1,8 @@
+export { SupaliveWebSocketServer } from "./supalive-server";
+export { SubscriptionManager } from "./subscription-manager";
+export { SubManagerClient } from "./subscription-manager-client";
+export { RegisterSubscriptionParamsSchema, type RegisterSubscriptionParams, type RegisterSubscriptionResult, UpdateSubscriptionReadSetParamsSchema, type UpdateSubscriptionReadSetParams, type UpdateSubscriptionReadSetResult, UnregisterSubscriptionParamsSchema, type UnregisterSubscriptionParams, type UnregisterSubscriptionResult, InvalidateWritesetParamsSchema, type InvalidateWritesetParams, type InvalidateWritesetResult, type AffectedSubscription, } from "./subscription-manager-types";
+export { CacheLayer } from "../db/cache";
+export { generateSubscriptionId, generateCacheKey, getHashOf, ANONYMOUS_IDENTITY, } from "./sub_hash";
+export type { SubId } from "./types_server";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EACL,gCAAgC,EAChC,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,qCAAqC,EACrC,KAAK,+BAA+B,EACpC,KAAK,+BAA+B,EACpC,kCAAkC,EAClC,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,8BAA8B,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,GAC1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,SAAS,EACT,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/src/server/index.js

@@ -0,0 +1,7 @@
+export { SupaliveWebSocketServer } from "./supalive-server";
+export { SubscriptionManager } from "./subscription-manager";
+export { SubManagerClient } from "./subscription-manager-client";
+export { RegisterSubscriptionParamsSchema, UpdateSubscriptionReadSetParamsSchema, UnregisterSubscriptionParamsSchema, InvalidateWritesetParamsSchema, } from "./subscription-manager-types";
+export { CacheLayer } from "../db/cache";
+export { generateSubscriptionId, generateCacheKey, getHashOf, ANONYMOUS_IDENTITY, } from "./sub_hash";
+//# sourceMappingURL=index.js.map