@supalive/core 0.1.0

package/dist/src/server/subscription-manager-client.js

@@ -0,0 +1,207 @@
+import { Client } from "rpc-websockets";
+import * as types from "./subscription-manager-types";
+import { logger as baseLogger, logLevelOf } from "../logger";
+import { supaliveStringify } from "../helper";
+const logger = baseLogger.child({ name: "SUBS_MGR_CLIENT" }, { level: logLevelOf("SUB_MANAGER_CLIENT_LOG_LEVEL") });
+export const subscriptionManagerDataPack = {
+    encode: (data) => supaliveStringify(data),
+    decode: (data) => JSON.parse(data),
+};
+/**
+ * RPC client for the (single) sub-manager process.
+ *
+ * Design (Convex-inspired):
+ *   • The sub-manager is in-memory and ephemeral. There is no version
+ *     protocol, no client-side registration registry, no OUT_OF_SYNC
+ *     replay logic. All recovery is driven from the app server using
+ *     state it already has (`serverSubscriptions`) plus registration
+ *     records persisted to Redis at `sl:reg:<subId>`.
+ *
+ *   • Out-of-order `updateSubscriptionReadSet` calls are filtered server
+ *     side using `lastSnapshotTs` (monotonic DB commit timestamp).
+ *
+ *   • On rpc-websockets reconnect, the client:
+ *       1. Transitions to `busy` (any in-flight `invalidateWriteset`
+ *          buffers its writeSet).
+ *       2. Invokes the app server's `recoveryDriver` to re-register all
+ *          known subs.
+ *       3. Flushes the buffer as one batched `invalidateWriteset` RPC and
+ *          hands the resulting `affected[]` to `affectedHandler`.
+ *       4. Transitions to `ready`.
+ *
+ *   • During an extended outage, the buffer is bounded; if exceeded, it
+ *     is dropped and we rely on the commit-log replay built into
+ *     `SubscriptionWorker.register()` to catch each sub up on the next
+ *     re-register.
+ */
+export class SubManagerClient {
+    client;
+    state = "busy";
+    hasConnectedOnce = false;
+    /** Resolves whenever state transitions to 'ready'. Replaced on each busy→ready cycle. */
+    readyPromise;
+    resolveReady;
+    /** Writeset entries accumulated while state === 'busy'. Flushed as one RPC after recovery. */
+    bufferedWriteSets = [];
+    bufferLimit;
+    bufferDroppedDuringOutage = false;
+    recoveryDriver;
+    affectedHandler;
+    constructor(urlOrOptions) {
+        const opts = typeof urlOrOptions === "string"
+            ? { url: urlOrOptions }
+            : urlOrOptions;
+        this.bufferLimit = opts.invalidateBufferLimit ?? 50_000;
+        this.readyPromise = new Promise((r) => { this.resolveReady = r; });
+        this.client = new Client(opts.url, {
+            dataPack: subscriptionManagerDataPack,
+        });
+        this.client.setAutoReconnect(true);
+        this.client.setMaxReconnects(0);
+        // Ensure the dataPack is set even if rpc-websockets doesn't pass it through to the Client constructor
+        this.client.dataPack = subscriptionManagerDataPack;
+        this.client.on("open", this.handleOpen.bind(this));
+        this.client.on("close", this.handleClose.bind(this));
+        this.client.on("error", (err) => logger.warn(err, "sub-manager client socket error"));
+    }
+    /**
+     * Wire up the app-server-driven recovery. Must be called before any
+     * disconnect/reconnect cycle for buffered writeSets to be flushed and
+     * subscriptions re-registered.
+     */
+    setRecoveryDriver(driver) {
+        this.recoveryDriver = driver;
+    }
+    /**
+     * Wire up the handler invoked when batched invalidate results land
+     * after recovery. The handler is expected to drive
+     * `reexecuteAffectedQuery` for each entry.
+     */
+    setAffectedHandler(handler) {
+        this.affectedHandler = handler;
+    }
+    // ─── RPC methods ────────────────────────────────────────────────────────
+    async registerSubscription(params) {
+        return this.call("registerSubscription", params, types.RegisterSubscriptionResultSchema);
+    }
+    async registerSubscriptionBatch(params) {
+        return this.call("registerSubscriptionBatch", params, types.RegisterSubscriptionBatchResultSchema);
+    }
+    async updateSubscriptionReadSet(params) {
+        return this.call("updateSubscriptionReadSet", params, types.UpdateSubscriptionReadSetResultSchema);
+    }
+    async unregisterSubscription(params) {
+        return this.call("unregisterSubscription", params, types.UnregisterSubscriptionResultSchema);
+    }
+    async unregisterSubscriptions(params) {
+        return this.call("unregisterSubscriptions", params, types.UnregisterSubscriptionsResultSchema);
+    }
+    /**
+     * Sends the writeSet to the sub-manager for invalidation, OR buffers it
+     * if the client is currently disconnected / recovering. Returns
+     * `{ affected: [] }` while buffering — the actual `affected` from the
+     * buffered batch is delivered via the registered `affectedHandler`
+     * after recovery completes.
+     */
+    async invalidateWriteset(params) {
+        if (this.state === "busy") {
+            this.appendToBuffer(params.writeSet);
+            return { affected: [] };
+        }
+        return this.call("invalidateWriteset", params, types.InvalidateWritesetResultSchema);
+    }
+    // ─── Internal ───────────────────────────────────────────────────────────
+    /**
+     * Single point through which RPCs go. Throws on transport / server error.
+     * `registerSubscription`, `updateSubscriptionReadSet`, and
+     * `unregisterSubscription` are NOT gated on the ready state: during a
+     * disconnect they will fail at the socket layer, and during recovery
+     * (which itself uses these methods) gating would deadlock.
+     */
+    async call(procName, params, resType) {
+        const result = await this.client.call(procName, params);
+        return resType.parse(result);
+    }
+    appendToBuffer(writeSet) {
+        if (this.bufferedWriteSets.length + writeSet.length > this.bufferLimit) {
+            if (!this.bufferDroppedDuringOutage) {
+                logger.warn(`Invalidate buffer would exceed ${this.bufferLimit}; dropping buffered entries. ` +
+                    `Subscriptions will be caught up via commit-log replay on re-register.`);
+                this.bufferDroppedDuringOutage = true;
+            }
+            this.bufferedWriteSets = [];
+            return;
+        }
+        this.bufferedWriteSets.push(...writeSet);
+    }
+    async flushBuffer() {
+        if (this.bufferedWriteSets.length === 0)
+            return;
+        const writeSet = this.bufferedWriteSets;
+        this.bufferedWriteSets = [];
+        this.bufferDroppedDuringOutage = false;
+        try {
+            const result = await this.call("invalidateWriteset", { writeSet }, types.InvalidateWritesetResultSchema);
+            if (this.affectedHandler && result.affected.length > 0) {
+                await this.affectedHandler(result.affected);
+            }
+        }
+        catch (err) {
+            logger.error(err, "Failed to flush invalidate buffer after recovery");
+        }
+    }
+    markBusy() {
+        if (this.state === "busy")
+            return;
+        this.state = "busy";
+        this.readyPromise = new Promise((r) => { this.resolveReady = r; });
+    }
+    markReady() {
+        if (this.state === "ready")
+            return;
+        this.state = "ready";
+        this.resolveReady();
+    }
+    handleClose() {
+        logger.info("sub-manager client: socket closed");
+        this.markBusy();
+    }
+    handleOpen() {
+        if (!this.hasConnectedOnce) {
+            this.hasConnectedOnce = true;
+            logger.info("sub-manager client: initial connect");
+            this.markReady();
+            return;
+        }
+        logger.info("sub-manager client: reconnected — starting recovery");
+        void this.runRecovery();
+    }
+    async runRecovery() {
+        // Stay 'busy' for the duration of recovery so concurrent
+        // invalidateWriteset calls keep buffering.
+        try {
+            if (this.recoveryDriver) {
+                await this.recoveryDriver();
+            }
+            else {
+                logger.warn("sub-manager client: no recoveryDriver configured — skipping recovery step");
+            }
+            await this.flushBuffer();
+        }
+        catch (err) {
+            logger.error(err, "Recovery failed; state will be marked ready anyway");
+        }
+        finally {
+            logger.info("sub-manager client: recovery complete");
+            this.markReady();
+        }
+    }
+    /**
+     * Test/inspection helpers.
+     */
+    /** @internal */
+    isReady() { return this.state === "ready"; }
+    /** @internal */
+    bufferSize() { return this.bufferedWriteSets.length; }
+}
+//# sourceMappingURL=subscription-manager-client.js.map

package/dist/src/server/subscription-manager-client.js.map

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

package/dist/src/server/subscription-manager-types.d.ts

@@ -0,0 +1,168 @@
+import z from "zod";
+import { RawReadEntry, ReadEntry } from "../db/types_db";
+export declare const RegisterSubscriptionParamsSchema: z.ZodObject<{
+    subId: z.ZodString;
+    cacheKey: z.ZodString;
+    queryName: z.ZodString;
+    args: z.ZodUnknown;
+    queryIdentity: z.ZodString;
+    instanceName: z.ZodString;
+    lastSnapshotTs: z.ZodPipe<z.ZodString, z.ZodTransform<bigint, string>>;
+}, z.core.$strip>;
+export type RegisterSubscriptionParams = z.infer<typeof RegisterSubscriptionParamsSchema>;
+export declare const RegisterSubscriptionResultSchema: z.ZodObject<{
+    cacheKey: z.ZodString;
+    recompute: z.ZodBoolean;
+    readSet: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"point">;
+        table: z.ZodString;
+        id: z.ZodString;
+        tableId: z.ZodPipe<z.ZodAny, z.ZodTransform<Uint8Array<ArrayBufferLike>, any>>;
+        expectedCommitTs: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<bigint, string>>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"range">;
+        table: z.ZodString;
+        tableId: z.ZodPipe<z.ZodAny, z.ZodTransform<Uint8Array<ArrayBufferLike>, any>>;
+        predicate: z.ZodType<import("../client").Predicate, unknown, z.core.$ZodTypeInternals<import("../client").Predicate, unknown>>;
+        columns: z.ZodArray<z.ZodString>;
+        orderBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        offset: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>]>>;
+}, z.core.$strip>;
+export type RegisterSubscriptionResult = z.infer<typeof RegisterSubscriptionResultSchema>;
+export declare const RegisterSubscriptionBatchParamsSchema: z.ZodArray<z.ZodObject<{
+    subId: z.ZodString;
+    cacheKey: z.ZodString;
+    queryName: z.ZodString;
+    args: z.ZodUnknown;
+    queryIdentity: z.ZodString;
+    instanceName: z.ZodString;
+    lastSnapshotTs: z.ZodPipe<z.ZodString, z.ZodTransform<bigint, string>>;
+}, z.core.$strip>>;
+export type RegisterSubscriptionBatchParams = z.infer<typeof RegisterSubscriptionBatchParamsSchema>;
+export declare const RegisterSubscriptionBatchResultSchema: z.ZodArray<z.ZodObject<{
+    cacheKey: z.ZodString;
+    recompute: z.ZodBoolean;
+    readSet: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"point">;
+        table: z.ZodString;
+        id: z.ZodString;
+        tableId: z.ZodPipe<z.ZodAny, z.ZodTransform<Uint8Array<ArrayBufferLike>, any>>;
+        expectedCommitTs: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<bigint, string>>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"range">;
+        table: z.ZodString;
+        tableId: z.ZodPipe<z.ZodAny, z.ZodTransform<Uint8Array<ArrayBufferLike>, any>>;
+        predicate: z.ZodType<import("../client").Predicate, unknown, z.core.$ZodTypeInternals<import("../client").Predicate, unknown>>;
+        columns: z.ZodArray<z.ZodString>;
+        orderBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        offset: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>]>>;
+}, z.core.$strip>>;
+export type RegisterSubscriptionBatchResult = z.infer<typeof RegisterSubscriptionBatchResultSchema>;
+export declare const UpdateSubscriptionReadSetParamsSchema: z.ZodObject<{
+    cacheKey: z.ZodString;
+    subId: z.ZodString;
+    instanceName: z.ZodString;
+    lastSnapshotTs: z.ZodPipe<z.ZodString, z.ZodTransform<bigint, string>>;
+    readSet: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"point">;
+        table: z.ZodString;
+        id: z.ZodString;
+        tableId: z.ZodPipe<z.ZodAny, z.ZodTransform<Uint8Array<ArrayBufferLike>, any>>;
+        expectedCommitTs: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<bigint, string>>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"range">;
+        table: z.ZodString;
+        tableId: z.ZodPipe<z.ZodAny, z.ZodTransform<Uint8Array<ArrayBufferLike>, any>>;
+        predicate: z.ZodType<import("../client").Predicate, unknown, z.core.$ZodTypeInternals<import("../client").Predicate, unknown>>;
+        columns: z.ZodArray<z.ZodString>;
+        orderBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        offset: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>]>>;
+}, z.core.$strip>;
+export type UpdateSubscriptionReadSetParams = z.infer<typeof UpdateSubscriptionReadSetParamsSchema>;
+/**
+ * `tracked: false` means the sub-manager has no record of this subId (e.g.
+ * a restart wiped state and the caller hasn't re-registered yet). The app
+ * server should treat this as a signal to register the sub before retrying.
+ */
+export declare const UpdateSubscriptionReadSetResultSchema: z.ZodObject<{
+    tracked: z.ZodBoolean;
+}, z.core.$strip>;
+export type UpdateSubscriptionReadSetResult = z.infer<typeof UpdateSubscriptionReadSetResultSchema>;
+export declare const UnregisterSubscriptionParamsSchema: z.ZodObject<{
+    subId: z.ZodString;
+    instanceName: z.ZodString;
+}, z.core.$strip>;
+export type UnregisterSubscriptionParams = z.infer<typeof UnregisterSubscriptionParamsSchema>;
+export declare const UnregisterSubscriptionsParamsSchema: z.ZodArray<z.ZodObject<{
+    subId: z.ZodString;
+    instanceName: z.ZodString;
+}, z.core.$strip>>;
+export type UnregisterSubscriptionsParams = z.infer<typeof UnregisterSubscriptionsParamsSchema>;
+export declare const UnregisterSubscriptionResultSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+}, z.core.$strip>;
+export type UnregisterSubscriptionResult = z.infer<typeof UnregisterSubscriptionResultSchema>;
+export declare const UnregisterSubscriptionsResultSchema: z.ZodArray<z.ZodObject<{
+    ok: z.ZodBoolean;
+}, z.core.$strip>>;
+export type UnregisterSubscriptionsResult = z.infer<typeof UnregisterSubscriptionsResultSchema>;
+export declare const InvalidateWritesetParamsSchema: z.ZodObject<{
+    writeSet: z.ZodArray<z.ZodObject<{
+        table: z.ZodString;
+        tableId: z.ZodPipe<z.ZodAny, z.ZodTransform<Uint8Array<ArrayBufferLike>, any>>;
+        id: z.ZodString;
+        op: z.ZodEnum<{
+            insert: "insert";
+            update: "update";
+            delete: "delete";
+        }>;
+        data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        prevData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        expectedCommitTs: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<bigint, string>>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type InvalidateWritesetParams = z.infer<typeof InvalidateWritesetParamsSchema>;
+export declare const AffectedSubscriptionSchema: z.ZodObject<{
+    subId: z.ZodString;
+    queryName: z.ZodString;
+    args: z.ZodUnknown;
+    cacheKey: z.ZodString;
+    notifyInstances: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type AffectedSubscription = z.infer<typeof AffectedSubscriptionSchema>;
+export declare const InvalidateWritesetResultSchema: z.ZodObject<{
+    affected: z.ZodArray<z.ZodObject<{
+        subId: z.ZodString;
+        queryName: z.ZodString;
+        args: z.ZodUnknown;
+        cacheKey: z.ZodString;
+        notifyInstances: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type InvalidateWritesetResult = z.infer<typeof InvalidateWritesetResultSchema>;
+export declare const RegistrationRecordSchema: z.ZodObject<{
+    queryName: z.ZodString;
+    args: z.ZodUnknown;
+    queryIdentity: z.ZodString;
+    cacheKey: z.ZodString;
+}, z.core.$strip>;
+export type RegistrationRecord = z.infer<typeof RegistrationRecordSchema>;
+export interface TrackedSubscription {
+    subId: string;
+    queryName: string;
+    args: unknown;
+    cacheKey: string;
+    lastSnapshotTs: bigint;
+    readSet: ReadEntry[];
+    rawReadSet: RawReadEntry[];
+    /** All app server instances that currently hold this subscription. */
+    instances: Set<string>;
+    timeout: NodeJS.Timeout | null;
+}
+//# sourceMappingURL=subscription-manager-types.d.ts.map

package/dist/src/server/subscription-manager-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-manager-types.d.ts","sourceRoot":"","sources":["../../../src/server/subscription-manager-types.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,EAAgB,YAAY,EAAE,SAAS,EAAqC,MAAM,gBAAgB,CAAC;AAY1G,eAAO,MAAM,gCAAgC;;;;;;;;iBAoB3C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;iBAI3C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,eAAO,MAAM,qCAAqC;;;;;;;;kBAA4C,CAAC;AAC/F,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAEpG,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;kBAA4C,CAAC;AAC/F,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAEpG,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;iBAMhD,CAAC;AACH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAEpG;;;;GAIG;AACH,eAAO,MAAM,qCAAqC;;iBAEhD,CAAC;AACH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAEpG,eAAO,MAAM,kCAAkC;;;iBAG7C,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,eAAO,MAAM,mCAAmC;;;kBAA8C,CAAC;AAC/F,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG,eAAO,MAAM,kCAAkC;;iBAAgC,CAAC;AAChF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,eAAO,MAAM,mCAAmC;;kBAAyC,CAAC;AAC1F,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;iBAEzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,0BAA0B;;;;;;iBAarC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,8BAA8B;;;;;;;;iBAEzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAStF,eAAO,MAAM,wBAAwB;;;;;iBAKnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,sEAAsE;IACtE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;CAClC"}

package/dist/src/server/subscription-manager-types.js

@@ -0,0 +1,94 @@
+import z from "zod";
+import { BigIntSchema, ReadEntrySchema, WriteEntrySchema } from "../db/types_db";
+// ─── RPC Schemas ──────────────────────────────────────────────────────────────
+//
+// The wire protocol intentionally has NO `_clientVersion` / `_resync` /
+// `serverVersion` fields. Ordering of concurrent `updateSubscriptionReadSet`
+// calls is enforced by `lastSnapshotTs` (which is monotonic — it comes from
+// `Database.getLatestSnapshotTimestamp()`). Recovery after a sub-manager
+// restart is driven by the app server iterating its own
+// `serverSubscriptions` map and re-registering each one using params
+// persisted in Redis under `sl:reg:<subId>`.
+export const RegisterSubscriptionParamsSchema = z.object({
+    /**
+     * Caller-computed FNV-1a routing key + identity for this subscription.
+     * The sub-manager trusts these values rather than re-deriving them from
+     * (queryName, args, queryIdentity); this avoids one stringify+SHA1 per
+     * register RPC. Trust is fine: the sub-manager RPC channel is fully
+     * internal.
+     */
+    subId: z.string(),
+    cacheKey: z.string(),
+    queryName: z.string(),
+    args: z.unknown(),
+    /**
+     * Segmentation key used in the subId/cacheKey hash. Defaults to the
+     * authenticated user's id ("anonymous" when none), unless the
+     * procedure overrides it via `QueryConfig.queryIdentity`.
+     */
+    queryIdentity: z.string(),
+    instanceName: z.string(),
+    lastSnapshotTs: BigIntSchema,
+});
+export const RegisterSubscriptionResultSchema = z.object({
+    cacheKey: z.string(),
+    recompute: z.boolean(),
+    readSet: z.array(ReadEntrySchema),
+});
+export const RegisterSubscriptionBatchParamsSchema = z.array(RegisterSubscriptionParamsSchema);
+export const RegisterSubscriptionBatchResultSchema = z.array(RegisterSubscriptionResultSchema);
+export const UpdateSubscriptionReadSetParamsSchema = z.object({
+    cacheKey: z.string(),
+    subId: z.string(),
+    instanceName: z.string(),
+    lastSnapshotTs: BigIntSchema,
+    readSet: z.array(ReadEntrySchema),
+});
+/**
+ * `tracked: false` means the sub-manager has no record of this subId (e.g.
+ * a restart wiped state and the caller hasn't re-registered yet). The app
+ * server should treat this as a signal to register the sub before retrying.
+ */
+export const UpdateSubscriptionReadSetResultSchema = z.object({
+    tracked: z.boolean(),
+});
+export const UnregisterSubscriptionParamsSchema = z.object({
+    subId: z.string(),
+    instanceName: z.string(),
+});
+export const UnregisterSubscriptionsParamsSchema = z.array(UnregisterSubscriptionParamsSchema);
+export const UnregisterSubscriptionResultSchema = z.object({ ok: z.boolean() });
+export const UnregisterSubscriptionsResultSchema = z.array(z.object({ ok: z.boolean() }));
+export const InvalidateWritesetParamsSchema = z.object({
+    writeSet: z.array(WriteEntrySchema),
+});
+export const AffectedSubscriptionSchema = z.object({
+    subId: z.string(),
+    queryName: z.string(),
+    args: z.unknown(),
+    cacheKey: z.string(),
+    /**
+     * Every live instance that currently holds this subId. Routing rules:
+     *   • If the writer is in this list, it recomputes locally and publishes
+     *     an `update` to the rest (its own id is filtered by the publisher).
+     *   • Otherwise the writer broadcasts a `recompute-race` to every entry;
+     *     receivers race for a Redis lock and the winner recomputes.
+     */
+    notifyInstances: z.array(z.string()),
+});
+export const InvalidateWritesetResultSchema = z.object({
+    affected: z.array(AffectedSubscriptionSchema),
+});
+// ─── Registration record persisted to Redis ──────────────────────────────────
+//
+// Stored at `sl:reg:<subId>` by the sub-manager when a brand-new subscription
+// is created, and deleted by the sub-manager when the last instance leaves.
+// The app server reads this on reconnect to know how to re-register its
+// known subIds.
+export const RegistrationRecordSchema = z.object({
+    queryName: z.string(),
+    args: z.unknown(),
+    queryIdentity: z.string(),
+    cacheKey: z.string(),
+});
+//# sourceMappingURL=subscription-manager-types.js.map

package/dist/src/server/subscription-manager-types.js.map

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

package/dist/src/server/subscription-manager-worker-entry.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=subscription-manager-worker-entry.d.ts.map

package/dist/src/server/subscription-manager-worker-entry.d.ts.map

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

package/dist/src/server/subscription-manager-worker-entry.js

@@ -0,0 +1,127 @@
+import { parentPort } from "node:worker_threads";
+import Redis from "ioredis";
+import { CacheLayer } from "../db/cache";
+import { PgDatabase } from "../db/postgres";
+import { MySqlDatabase } from "../db/mysql";
+import { mapWriteSetToRaw } from "./overlap-checker";
+import { InvalidateWritesetParamsSchema, RegisterSubscriptionBatchParamsSchema, RegisterSubscriptionParamsSchema, UnregisterSubscriptionParamsSchema, UnregisterSubscriptionsParamsSchema, UpdateSubscriptionReadSetParamsSchema, } from "./subscription-manager-types";
+import { SubscriptionWorker } from "./subscription-worker";
+import { MsgType, } from "./subscription-manager-worker-protocol";
+import { logger as baseLogger } from "../logger";
+if (!parentPort) {
+    throw new Error("subscription-manager-worker-entry must run inside a worker_threads Worker");
+}
+const port = parentPort;
+const logger = baseLogger.child({ name: "SUBS_WRK_ENTRY" });
+let worker = null;
+let db = null;
+let cache = null;
+let redis = null;
+async function init(payload) {
+    redis = new Redis(payload.upstash.redisUrl, {
+        connectTimeout: 15_000,
+        maxRetriesPerRequest: 5,
+    });
+    cache = new CacheLayer(redis, payload.cacheTTLSeconds);
+    if (payload.database.type === "postgres") {
+        db = new PgDatabase(logger.child({ database: "postgres", worker: payload.workerId }), {
+            ...payload.database,
+            connectionString: payload.database.connectionString,
+            max: payload.maxConnectionsPerWorker,
+            min: payload.database.minConnections ?? 1,
+            idleTimeoutMillis: payload.database.idleTimeoutMillis ?? 30_000,
+            connectionTimeoutMillis: payload.database.connectionTimeoutMillis ?? 7_000,
+        });
+    }
+    else {
+        db = new MySqlDatabase(logger.child({ database: "mysql", worker: payload.workerId }), {
+            ...payload.database,
+            connectionLimit: payload.maxConnectionsPerWorker,
+            idleTimeout: payload.database.idleTimeoutMillis ?? 30_000,
+            connectTimeout: payload.database.connectionTimeoutMillis ?? 7_000,
+            waitForConnections: true,
+            queueLimit: payload.database.queueLimit ?? 0,
+        });
+    }
+    worker = new SubscriptionWorker(payload.workerId, cache, db);
+}
+async function dispatch(req) {
+    if (req.type === MsgType.Init) {
+        await init(req.payload);
+        return null;
+    }
+    if (!worker) {
+        throw new Error("Worker received message before Init");
+    }
+    switch (req.type) {
+        case MsgType.Register: {
+            const params = RegisterSubscriptionParamsSchema.parse(req.payload);
+            return worker.register(params);
+        }
+        case MsgType.RegisterBatch: {
+            const params = RegisterSubscriptionBatchParamsSchema.parse(req.payload);
+            return Promise.all(params.map((p) => worker.register(p)));
+        }
+        case MsgType.UpdateReadSet: {
+            const params = UpdateSubscriptionReadSetParamsSchema.parse(req.payload);
+            return worker.updateReadSet(params);
+        }
+        case MsgType.Unregister: {
+            const params = UnregisterSubscriptionParamsSchema.parse(req.payload);
+            return worker.unregister(params);
+        }
+        case MsgType.Unregisters: {
+            const params = UnregisterSubscriptionsParamsSchema.parse(req.payload);
+            return worker.unregisters(params);
+        }
+        case MsgType.Invalidate: {
+            const { writeSet } = InvalidateWritesetParamsSchema.parse(req.payload);
+            const rawWriteSet = mapWriteSetToRaw(writeSet);
+            return worker.invalidate(rawWriteSet);
+        }
+        case MsgType.MinSubscriptionTs: {
+            const m = worker.minSubscriptionTs();
+            // bigint isn't structured-cloneable via JSON; postMessage handles
+            // bigints natively, so we return it as-is.
+            return m;
+        }
+        case MsgType.LatestSnapshotTs: {
+            return db.getLatestSnapshotTimestamp();
+        }
+        case MsgType.Prune: {
+            const ts = req.payload;
+            return db.pruneCommitLogsBefore(ts);
+        }
+        case MsgType.Shutdown: {
+            try {
+                await db?.close();
+            }
+            catch (_) { /* ignore */ }
+            try {
+                await redis?.quit?.();
+            }
+            catch (_) { /* ignore */ }
+            return null;
+        }
+        default: {
+            throw new Error(`Unknown MsgType: ${req.type}`);
+        }
+    }
+}
+port.on("message", async (req) => {
+    try {
+        const result = await dispatch(req);
+        const res = { reqId: req.reqId, ok: true, result };
+        port.postMessage(res);
+    }
+    catch (err) {
+        const e = err;
+        const res = {
+            reqId: req.reqId,
+            ok: false,
+            error: { message: e?.message ?? String(err), stack: e?.stack },
+        };
+        port.postMessage(res);
+    }
+});
+//# sourceMappingURL=subscription-manager-worker-entry.js.map

package/dist/src/server/subscription-manager-worker-entry.js.map

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