@rindle/api-server 0.1.0-rc.5

package/dist/index.js

@@ -0,0 +1,388 @@
+export const DEFAULT_RINDLE_API_ROUTES = {
+    query: "/api/rindle/query",
+    read: "/api/rindle/read",
+    mutate: "/api/rindle/mutate",
+};
+export class RindleApiError extends Error {
+    code;
+    status;
+    constructor(code, message, status) {
+        super(message);
+        this.name = "RindleApiError";
+        this.code = code;
+        this.status = status;
+    }
+}
+/**
+ * A read/write-split `RindleDaemonClient` (READ-ROUTER-DESIGN.md §2.1). Writes
+ * (`executeSqlTxn` / `rejectMutation` / `applyRowChangeTxn` / `migrate`) go to the single
+ * write-master, UNCHANGED and never through the router; reads (`materialize` / `query` /
+ * `dematerialize`) go to the read router. Hand one of these to {@link createRindleApiServer} as
+ * `daemon` to point the reads leg at the router while writes stay on the master — no placement
+ * logic enters the api-server.
+ *
+ * ```ts
+ * const daemon = new SplitDaemonClient(
+ *   new HttpRindleDaemonClient({ baseUrl: MASTER_URL, headers: writeAuth }),  // writes → master
+ *   new HttpRindleDaemonClient({ baseUrl: ROUTER_URL, headers: routerAuth }), // reads  → router
+ * );
+ * ```
+ */
+export class SplitDaemonClient {
+    writes;
+    reads;
+    constructor(writes, reads) {
+        this.writes = writes;
+        this.reads = reads;
+    }
+    // writes → the single master, never through the router
+    executeSqlTxn(input) {
+        return this.writes.executeSqlTxn(input);
+    }
+    rejectMutation(input) {
+        return this.writes.rejectMutation(input);
+    }
+    applyRowChangeTxn(input) {
+        return this.writes.applyRowChangeTxn(input);
+    }
+    migrate(input) {
+        return this.writes.migrate(input);
+    }
+    // reads → the router (it stamps `wsEndpoint` onto the outputs)
+    materialize(input) {
+        return this.reads.materialize(input);
+    }
+    query(input) {
+        return this.reads.query(input);
+    }
+    dematerialize(input) {
+        return this.reads.dematerialize(input);
+    }
+}
+export function defineApiQueries(queries) {
+    return queries;
+}
+/**
+ * Register a list of co-located client {@link NamedQuery `defineQuery`} values as the server's query
+ * surface — the bulk, no-boilerplate counterpart to {@link defineApiQueries}. Each query already
+ * carries its wire `name` and a `resolve` that re-runs its validator on the UNTRUSTED wire args and
+ * builds the authoritative `Query`, so the server just imports every co-located query and hands the
+ * list here. The same validated args build a byte-identical AST on both tiers.
+ *
+ * The query's AUTHORITATIVE {@link ApiContext} is forwarded as `resolve`'s ctx — so a context-scoped
+ * `defineQuery` (e.g. "my issues") is built from the server's trusted principal, never the client's.
+ * A context-free query simply ignores the extra argument.
+ *
+ * Use {@link defineApiQueries} instead (or in addition) only when the server must DIVERGE from the
+ * client — define a server-specific `defineQuery` with the same name and register that.
+ *
+ * ```ts
+ * queries: registerQueries<User>([issuesPageQuery, issueDetailQuery, recentCommentsQuery, usersQuery]),
+ * ```
+ */
+export function registerQueries(queries) {
+    const out = {};
+    for (const query of queries) {
+        if (Object.prototype.hasOwnProperty.call(out, query.queryName)) {
+            throw new Error(`registerQueries: duplicate query name "${query.queryName}"`);
+        }
+        out[query.queryName] = (ctx, args) => query.resolve(args, ctx);
+    }
+    return out;
+}
+export function defineApiMutators(mutators) {
+    return mutators;
+}
+export function queryResultToAst(result) {
+    if (result && typeof result === "object" && "ast" in result && typeof result.ast === "function") {
+        return result.ast();
+    }
+    return result;
+}
+export function createRindleApiServer(opts) {
+    const routes = { ...DEFAULT_RINDLE_API_ROUTES, ...opts.routes };
+    const mode = opts.mode ?? "normalized";
+    // Names that are ALSO configured pins — a lease for one is forced to a `pinned` policy (the lazy
+    // floor, §4.1) so the first viewer to route to a follower warms it for late joiners.
+    const pinnedNames = new Set((opts.pinnedQueries ?? []).map((p) => p.name));
+    // Resolve a named query (+ args) to its AST under a given context — the shared path for both
+    // a per-viewer lease and a system-level pin (which skips per-user authorization).
+    const resolveAst = async (name, args, context) => {
+        const query = opts.queries?.[name];
+        if (!query)
+            throw new RindleApiError("not-found", `unknown query: ${name}`, 404);
+        const result = opts.runQuery
+            ? await opts.runQuery({ user: context.user, name, args, query, context })
+            : await query(context, args);
+        return queryResultToAst(result);
+    };
+    const createQueryLease = async (input) => {
+        const context = { user: input.user, request: input.request };
+        await assertAuthorized(opts.authorizeQuery, {
+            user: input.user,
+            name: input.name,
+            args: input.args,
+            context,
+        });
+        const ast = await resolveAst(input.name, input.args, context);
+        // Lazy pin tier (§4.1): a leased query that is ALSO a configured pin is materialized with a
+        // `pinned` policy regardless of the configured default, so it survives its first viewer's
+        // departure. Otherwise use the configured policy.
+        const policy = pinnedNames.has(input.name)
+            ? { kind: "pinned", name: input.name }
+            : await resolvePolicy(opts.materializationPolicy, input);
+        const subject = await resolveSubject(opts.subject, input);
+        const routingKey = await resolveRoutingKey(opts.routingKey, input);
+        const out = await opts.daemon.materialize({
+            ast,
+            mode,
+            policy,
+            subject,
+            leaseTtlMs: opts.leaseTtlMs,
+            // The anonymous routing key rides `metadata.routingKey`; the router keys on
+            // `subject ?? metadata.routingKey` (§2.2). Omitted when there is none.
+            metadata: routingKey !== undefined ? { routingKey } : undefined,
+        });
+        return queryLeaseResponse(out);
+    };
+    const readQuery = async (input) => {
+        const context = { user: input.user, request: input.request };
+        // Same per-viewer gate a live lease passes — a one-shot read returns the same rows a subscribe
+        // would, so it must clear the same authorization.
+        await assertAuthorized(opts.authorizeQuery, {
+            user: input.user,
+            name: input.name,
+            args: input.args,
+            context,
+        });
+        const ast = await resolveAst(input.name, input.args, context);
+        // Scope the one-shot's dedup `QueryKey` by the SAME key the lease path routes on — the routing
+        // key (`subject ?? cookie ?? clientId`) — so the warm pipeline this read leaves behind is the
+        // very one the browser's follow-up `subscribe` reuses, ON THE SAME FOLLOWER HRW will place it
+        // (the warm handoff, SSR-DESIGN.md §3.4 / READ-ROUTER-DESIGN.md §2.4) rather than a second,
+        // viewer-mismatched materialization.
+        const subject = await resolveSubject(opts.subject, input);
+        const routingKey = await resolveRoutingKey(opts.routingKey, input);
+        const visibilityKey = subject ?? routingKey;
+        const out = await opts.daemon.query({ ast, visibilityKey, ttlMs: opts.readIdleTtlMs });
+        const res = { rows: out.rows, cvMin: out.cvMin, queryKey: out.queryKey };
+        if (out.wsEndpoint !== undefined)
+            res.wsEndpoint = out.wsEndpoint;
+        return res;
+    };
+    const pushMutation = async (input) => {
+        const context = { user: input.user, request: input.request };
+        const mutator = opts.mutators?.[input.envelope.name];
+        if (!mutator)
+            return reject(opts.daemon, input.envelope, `unknown mutator: ${input.envelope.name}`);
+        let sql;
+        try {
+            await assertAuthorized(opts.authorizeMutation, {
+                user: input.user,
+                envelope: input.envelope,
+                context,
+            });
+            const tx = new CollectingSqlMutationTx();
+            const result = await mutator(tx, input.envelope.args, {
+                user: input.user,
+                envelope: input.envelope,
+                daemon: opts.daemon,
+                request: input.request,
+            });
+            sql = mutationResultToSqlTxn(result, tx);
+        }
+        catch (err) {
+            return reject(opts.daemon, input.envelope, String(err?.message ?? err));
+        }
+        const output = await opts.daemon.executeSqlTxn({
+            ...sql,
+            clientID: input.envelope.clientID,
+            mid: input.envelope.mid,
+        });
+        return { accepted: true, rejected: false, output };
+    };
+    const pushMutations = async (input) => {
+        const out = [];
+        for (const envelope of input.envelopes) {
+            out.push(await pushMutation({ user: input.user, envelope, request: input.request }));
+        }
+        return out;
+    };
+    const assertPins = async () => {
+        const pins = opts.pinnedQueries;
+        if (!pins?.length)
+            return;
+        const context = { user: opts.pinUser, request: undefined };
+        // Resolve every pin's authoritative AST under the system pin user (a transient failure on one
+        // shouldn't strand the rest), then drive the warm-up — fleet fan-out via the router if
+        // configured, else one materialize per pin on the single daemon.
+        const resolved = await Promise.allSettled(pins.map(async (pin) => ({
+            pin,
+            req: {
+                ast: await resolveAst(pin.name, pin.args ?? null, context),
+                mode,
+                policy: { kind: "pinned", name: pin.name },
+                leaseTtlMs: opts.leaseTtlMs,
+            },
+        })));
+        const failures = [];
+        const pairs = [];
+        resolved.forEach((r, i) => {
+            if (r.status === "fulfilled")
+                pairs.push(r.value);
+            else
+                failures.push(`${pins[i].name}: ${errMessage(r.reason)}`);
+        });
+        const reqs = pairs.map((p) => p.req);
+        if (reqs.length) {
+            if (opts.pinFanout) {
+                // Push tier (§4.2): fan EACH pin across ALL live followers via the router (fire-and-forget,
+                // router-stateless). A whole-fan-out failure is surfaced so the caller retries.
+                try {
+                    await opts.pinFanout.assertPins(reqs);
+                }
+                catch (e) {
+                    failures.push(errMessage(e));
+                }
+            }
+            else {
+                // Single-daemon: materialize each pin once (the daemon dedups by canonical query).
+                const results = await Promise.allSettled(reqs.map((req) => opts.daemon.materialize(req)));
+                results.forEach((r, i) => {
+                    if (r.status === "rejected")
+                        failures.push(`${pairs[i].pin.name}: ${errMessage(r.reason)}`);
+                });
+            }
+        }
+        if (failures.length) {
+            throw new Error(`assertPins: ${failures.length} failed — ${failures.join("; ")}`);
+        }
+    };
+    return {
+        routes,
+        createQueryLease,
+        readQuery,
+        assertPins,
+        pushMutation,
+        pushMutations,
+        handleQueryJson: (body, context) => {
+            const msg = parseObject(body, "query request");
+            return createQueryLease({
+                user: context.user,
+                name: parseString(msg.name, "name"),
+                args: msg.args ?? null,
+                request: context.request,
+                clientId: typeof msg.clientId === "string" ? msg.clientId : undefined,
+            });
+        },
+        handleReadJson: (body, context) => {
+            const msg = parseObject(body, "read request");
+            return readQuery({
+                user: context.user,
+                name: parseString(msg.name, "name"),
+                args: msg.args ?? null,
+                request: context.request,
+                clientId: typeof msg.clientId === "string" ? msg.clientId : undefined,
+            });
+        },
+        handleMutateJson: (body, context) => {
+            const msg = parseObject(body, "mutation request");
+            if (Array.isArray(msg.envelopes)) {
+                return pushMutations({
+                    user: context.user,
+                    envelopes: msg.envelopes.map(parseEnvelope),
+                    request: context.request,
+                });
+            }
+            const envelope = parseEnvelope(msg.envelope ?? msg);
+            return pushMutation({ user: context.user, envelope, request: context.request });
+        },
+    };
+}
+class CollectingSqlMutationTx {
+    stmts = [];
+    get statements() {
+        return this.stmts;
+    }
+    exec(sql, params = []) {
+        this.stmts.push({ sql, params });
+    }
+}
+function mutationResultToSqlTxn(result, tx) {
+    if (Array.isArray(result))
+        return { statements: result };
+    if (result && typeof result === "object" && "statements" in result) {
+        return { statements: result.statements, idempotencyKey: result.idempotencyKey };
+    }
+    return { statements: [...tx.statements] };
+}
+async function assertAuthorized(authorizer, input) {
+    if (!authorizer)
+        return;
+    const result = await authorizer(input);
+    if (result === false)
+        throw new RindleApiError("forbidden", "rindle request forbidden", 403);
+}
+async function resolvePolicy(policy, input) {
+    if (!policy)
+        return { kind: "whileSubscribed" };
+    return typeof policy === "function" ? await policy(input) : policy;
+}
+async function resolveSubject(subject, input) {
+    if (typeof subject === "function")
+        return subject(input);
+    return subject;
+}
+/** Resolve the anonymous routing key (READ-ROUTER-DESIGN.md §2.2): an explicit value/resolver if
+ *  configured, otherwise the browser-supplied `clientId`. The router keys on `subject ?? this`. */
+async function resolveRoutingKey(routingKey, input) {
+    if (routingKey === undefined)
+        return input.clientId;
+    return typeof routingKey === "function" ? routingKey(input) : routingKey;
+}
+function queryLeaseResponse(out) {
+    const res = {
+        leaseToken: out.leaseToken,
+        materializationId: out.materializationId,
+        queryKey: out.queryKey,
+        reused: out.reused,
+    };
+    // Only present in a routed deploy — absent reproduces today's single-daemon response exactly.
+    if (out.wsEndpoint !== undefined)
+        res.wsEndpoint = out.wsEndpoint;
+    return res;
+}
+function errMessage(reason) {
+    return String(reason?.message ?? reason);
+}
+async function reject(daemon, envelope, reason) {
+    const output = await daemon.rejectMutation({ clientID: envelope.clientID, mid: envelope.mid, reason });
+    return { accepted: false, rejected: true, reason, output };
+}
+function parseObject(value, label) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new RindleApiError("bad-request", `invalid ${label}`, 400);
+    }
+    return value;
+}
+function parseString(value, label) {
+    if (typeof value !== "string")
+        throw new RindleApiError("bad-request", `invalid ${label}`, 400);
+    return value;
+}
+function parseEnvelope(value) {
+    const obj = parseObject(value, "mutation envelope");
+    return {
+        clientID: parseString(obj.clientID, "clientID"),
+        mid: parseNumber(obj.mid, "mid"),
+        name: parseString(obj.name, "name"),
+        args: obj.args ?? null,
+    };
+}
+function parseNumber(value, label) {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw new RindleApiError("bad-request", `invalid ${label}`, 400);
+    }
+    return value;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@rindle/api-server",
+  "version": "0.1.0-rc.5",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rindle-sh/rindle.git",
+    "directory": "packages/api-server"
+  },
+  "type": "module",
+  "description": "Application API-server helpers for Rindle query leases and custom mutator routing.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "@rindle/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "dependencies": {
+    "@rindle/client": "0.1.0-rc.5",
+    "@rindle/daemon-client": "0.1.0-rc.5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "tsc --noEmit && node --conditions=@rindle/source --test test/*.test.ts"
+  }
+}