@pyric/cli 0.1.0-alpha.9

package/dist/serve/worker/client/firestore-refs.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Firestore reference, query, and sentinel factories — the synchronous,
+ * client-side descriptor builders. No RPC fires here: each returns a handle or
+ * marker carrying a serializable descriptor the execution functions send later.
+ */
+import type { QueryConstraintDescriptor, SentinelMarker } from '../protocol.js';
+import type { ClientDb, DocRefHandle, CollRefHandle, QueryHandle } from './handles.js';
+/**
+ * Build a document reference. Mirrors `pyric/firestore`'s `doc(db, path)`.
+ *
+ * WHY CLIENT-SIDE: Firebase's `doc()` is synchronous and path-only — it
+ * needs no data from the sandbox. We build a descriptor object here and
+ * include the port so execution calls can route to the worker.
+ */
+export declare function doc(parent: ClientDb | CollRefHandle, ...pathSegments: string[]): DocRefHandle;
+/**
+ * Build a collection reference. Mirrors `pyric/firestore`'s `collection(db, path)`.
+ */
+export declare function collection(parent: ClientDb | DocRefHandle, ...pathSegments: string[]): CollRefHandle;
+/**
+ * Build a collection-group query. Mirrors `pyric/firestore`'s `collectionGroup(db, id)`.
+ */
+export declare function collectionGroup(db: ClientDb, collectionId: string): QueryHandle;
+/** Opaque query constraint — carries its descriptor for embedding in queries. */
+export interface QueryConstraintHandle {
+    readonly _descriptor: QueryConstraintDescriptor;
+}
+export declare function where(field: string, op: string, value: unknown): QueryConstraintHandle;
+/**
+ * OR composite filter — at least one operand must match. Operands must be
+ * filters (`where()`, or nested `or()`/`and()`). Mirrors `pyric/firestore`'s
+ * `or(...)`; the worker rebuilds it with the real modular factory.
+ */
+export declare function or(...filters: QueryConstraintHandle[]): QueryConstraintHandle;
+/** AND composite filter — every operand must match. See {@link or}. */
+export declare function and(...filters: QueryConstraintHandle[]): QueryConstraintHandle;
+export declare function orderBy(field: string, direction?: 'asc' | 'desc'): QueryConstraintHandle;
+export declare function limit(n: number): QueryConstraintHandle;
+export declare function limitToLast(n: number): QueryConstraintHandle;
+export declare function startAt(...values: unknown[]): QueryConstraintHandle;
+export declare function startAfter(...values: unknown[]): QueryConstraintHandle;
+export declare function endAt(...values: unknown[]): QueryConstraintHandle;
+export declare function endBefore(...values: unknown[]): QueryConstraintHandle;
+/**
+ * Apply query constraints to a source ref or query.
+ * Mirrors `pyric/firestore`'s `query(source, ...constraints)`.
+ */
+export declare function query(source: CollRefHandle | QueryHandle, ...constraints: QueryConstraintHandle[]): QueryHandle;
+export declare function serverTimestamp(): SentinelMarker;
+export declare function increment(n: number): SentinelMarker;
+export declare function arrayUnion(...values: unknown[]): SentinelMarker;
+export declare function arrayRemove(...values: unknown[]): SentinelMarker;
+export declare function deleteField(): SentinelMarker;
+//# sourceMappingURL=firestore-refs.d.ts.map

package/dist/serve/worker/client/firestore-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestore-refs.d.ts","sourceRoot":"","sources":["../../../../src/serve/worker/client/firestore-refs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAKV,yBAAyB,EAGzB,cAAc,EACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIvF;;;;;;GAMG;AACH,wBAAgB,GAAG,CACjB,MAAM,EAAE,QAAQ,GAAG,aAAa,EAChC,GAAG,YAAY,EAAE,MAAM,EAAE,GACxB,YAAY,CAuBd;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,QAAQ,GAAG,YAAY,EAC/B,GAAG,YAAY,EAAE,MAAM,EAAE,GACxB,aAAa,CAoBf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,WAAW,CAO/E;AAID,iFAAiF;AACjF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAAC;CACjD;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,qBAAqB,CAEtF;AA2BD;;;;GAIG;AACH,wBAAgB,EAAE,CAAC,GAAG,OAAO,EAAE,qBAAqB,EAAE,GAAG,qBAAqB,CAE7E;AAED,uEAAuE;AACvE,wBAAgB,GAAG,CAAC,GAAG,OAAO,EAAE,qBAAqB,EAAE,GAAG,qBAAqB,CAE9E;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,qBAAqB,CAExF;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAEtD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAE5D;AAED,wBAAgB,OAAO,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,qBAAqB,CAEnE;AAED,wBAAgB,UAAU,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,qBAAqB,CAEtE;AAED,wBAAgB,KAAK,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,qBAAqB,CAEjE;AAED,wBAAgB,SAAS,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,qBAAqB,CAErE;AAED;;;GAGG;AACH,wBAAgB,KAAK,CACnB,MAAM,EAAE,aAAa,GAAG,WAAW,EACnC,GAAG,WAAW,EAAE,qBAAqB,EAAE,GACtC,WAAW,CAsBb;AAID,wBAAgB,eAAe,IAAI,cAAc,CAEhD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,cAAc,CAEnD;AAED,wBAAgB,UAAU,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,cAAc,CAE/D;AAED,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,cAAc,CAEhE;AAED,wBAAgB,WAAW,IAAI,cAAc,CAE5C"}

package/dist/serve/worker/client/firestore-refs.js

@@ -0,0 +1,167 @@
+/**
+ * Firestore reference, query, and sentinel factories — the synchronous,
+ * client-side descriptor builders. No RPC fires here: each returns a handle or
+ * marker carrying a serializable descriptor the execution functions send later.
+ */
+import { lastSegment } from './handles.js';
+// ─── Path factories (client-side only — no RPC) ──────────────────────────
+/**
+ * Build a document reference. Mirrors `pyric/firestore`'s `doc(db, path)`.
+ *
+ * WHY CLIENT-SIDE: Firebase's `doc()` is synchronous and path-only — it
+ * needs no data from the sandbox. We build a descriptor object here and
+ * include the port so execution calls can route to the worker.
+ */
+export function doc(parent, ...pathSegments) {
+    const port = 'port' in parent ? parent.port : parent.port;
+    let path;
+    if (parent.__kind === 'client-db') {
+        if (pathSegments.length === 0)
+            throw new TypeError('doc(db, path) requires a path segment.');
+        path = pathSegments.join('/');
+    }
+    else {
+        // parent is a CollRefHandle
+        const collPath = parent.descriptor.path;
+        path = pathSegments.length > 0
+            ? `${collPath}/${pathSegments.join('/')}`
+            : collPath; // caller will get auto-id via addDoc; doc() without id is unusual
+    }
+    const descriptor = { __ref: 'doc', path };
+    return {
+        __kind: 'doc-ref',
+        descriptor,
+        port,
+        id: lastSegment(path),
+        path,
+    };
+}
+/**
+ * Build a collection reference. Mirrors `pyric/firestore`'s `collection(db, path)`.
+ */
+export function collection(parent, ...pathSegments) {
+    const port = parent.port;
+    if (pathSegments.length === 0)
+        throw new TypeError('collection() requires a path segment.');
+    let path;
+    if (parent.__kind === 'client-db') {
+        path = pathSegments.join('/');
+    }
+    else {
+        const docPath = parent.descriptor.path;
+        path = `${docPath}/${pathSegments.join('/')}`;
+    }
+    const descriptor = { __ref: 'collection', path };
+    return {
+        __kind: 'coll-ref',
+        descriptor,
+        port,
+        id: lastSegment(path),
+        path,
+    };
+}
+/**
+ * Build a collection-group query. Mirrors `pyric/firestore`'s `collectionGroup(db, id)`.
+ */
+export function collectionGroup(db, collectionId) {
+    const descriptor = {
+        __ref: 'query',
+        source: { __ref: 'group', collectionId },
+        constraints: [],
+    };
+    return { __kind: 'query', descriptor, port: db.port };
+}
+export function where(field, op, value) {
+    return { _descriptor: { kind: 'where', field, op, value } };
+}
+/**
+ * Extract a constraint's FILTER descriptor for composite embedding — throws
+ * the same TypeError `pyric/firestore`'s `and()`/`or()` raise when handed a
+ * non-filter (`orderBy` / `limit` / cursors are not valid inside composites).
+ */
+function toFilterDescriptor(kind, c) {
+    const d = c._descriptor;
+    if (d.kind !== 'where' && d.kind !== 'and' && d.kind !== 'or') {
+        throw new TypeError(`pyric worker client: ${kind}() received a non-filter constraint (orderBy / limit are not valid here).`);
+    }
+    return d;
+}
+function composite(kind, filters) {
+    if (filters.length === 0) {
+        throw new TypeError(`pyric worker client: ${kind}() requires at least one filter argument.`);
+    }
+    return { _descriptor: { kind, filters: filters.map((f) => toFilterDescriptor(kind, f)) } };
+}
+/**
+ * OR composite filter — at least one operand must match. Operands must be
+ * filters (`where()`, or nested `or()`/`and()`). Mirrors `pyric/firestore`'s
+ * `or(...)`; the worker rebuilds it with the real modular factory.
+ */
+export function or(...filters) {
+    return composite('or', filters);
+}
+/** AND composite filter — every operand must match. See {@link or}. */
+export function and(...filters) {
+    return composite('and', filters);
+}
+export function orderBy(field, direction) {
+    return { _descriptor: { kind: 'orderBy', field, direction } };
+}
+export function limit(n) {
+    return { _descriptor: { kind: 'limit', n } };
+}
+export function limitToLast(n) {
+    return { _descriptor: { kind: 'limitToLast', n } };
+}
+export function startAt(...values) {
+    return { _descriptor: { kind: 'startAt', values } };
+}
+export function startAfter(...values) {
+    return { _descriptor: { kind: 'startAfter', values } };
+}
+export function endAt(...values) {
+    return { _descriptor: { kind: 'endAt', values } };
+}
+export function endBefore(...values) {
+    return { _descriptor: { kind: 'endBefore', values } };
+}
+/**
+ * Apply query constraints to a source ref or query.
+ * Mirrors `pyric/firestore`'s `query(source, ...constraints)`.
+ */
+export function query(source, ...constraints) {
+    const sourceDescriptor = source.__kind === 'coll-ref'
+        ? source.descriptor
+        : source.descriptor;
+    const existingConstraints = source.__kind === 'query'
+        ? source.descriptor.constraints
+        : [];
+    const descriptor = {
+        __ref: 'query',
+        source: sourceDescriptor.__ref === 'query'
+            ? sourceDescriptor.source
+            : sourceDescriptor,
+        constraints: [
+            ...existingConstraints,
+            ...constraints.map((c) => c._descriptor),
+        ],
+    };
+    return { __kind: 'query', descriptor, port: source.port };
+}
+// ─── Sentinel factories (client-side markers) ────────────────────────────
+export function serverTimestamp() {
+    return { __sentinel: 'serverTimestamp' };
+}
+export function increment(n) {
+    return { __sentinel: 'increment', n };
+}
+export function arrayUnion(...values) {
+    return { __sentinel: 'arrayUnion', values };
+}
+export function arrayRemove(...values) {
+    return { __sentinel: 'arrayRemove', values };
+}
+export function deleteField() {
+    return { __sentinel: 'deleteField' };
+}
+//# sourceMappingURL=firestore-refs.js.map

package/dist/serve/worker/client/firestore-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestore-refs.js","sourceRoot":"","sources":["../../../../src/serve/worker/client/firestore-refs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,4EAA4E;AAE5E;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CACjB,MAAgC,EAChC,GAAG,YAAsB;IAEzB,MAAM,IAAI,GAAG,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAE,MAAmB,CAAC,IAAI,CAAC;IACxE,IAAI,IAAY,CAAC;IAEjB,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAC;QAC7F,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,4BAA4B;QAC5B,MAAM,QAAQ,GAAI,MAAwB,CAAC,UAAU,CAAC,IAAI,CAAC;QAC3D,IAAI,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC;YAC5B,CAAC,CAAC,GAAG,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YACzC,CAAC,CAAC,QAAQ,CAAC,CAAC,kEAAkE;IAClF,CAAC;IAED,MAAM,UAAU,GAAW,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAClD,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,UAAU;QACV,IAAI;QACJ,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC;QACrB,IAAI;KACL,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,MAA+B,EAC/B,GAAG,YAAsB;IAEzB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;IAE5F,IAAI,IAAY,CAAC;IACjB,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,MAAM,OAAO,GAAI,MAAuB,CAAC,UAAU,CAAC,IAAI,CAAC;QACzD,IAAI,GAAG,GAAG,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IAChD,CAAC;IAED,MAAM,UAAU,GAAY,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC1D,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,UAAU;QACV,IAAI;QACJ,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC;QACrB,IAAI;KACL,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,EAAY,EAAE,YAAoB;IAChE,MAAM,UAAU,GAAoB;QAClC,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE;QACxC,WAAW,EAAE,EAAE;KAChB,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;AACxD,CAAC;AASD,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,EAAU,EAAE,KAAc;IAC7D,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CACzB,IAAkB,EAClB,CAAwB;IAExB,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;IACxB,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9D,MAAM,IAAI,SAAS,CACjB,wBAAwB,IAAI,2EAA2E,CACxG,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,SAAS,CAAC,IAAkB,EAAE,OAAgC;IACrE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,SAAS,CAAC,wBAAwB,IAAI,2CAA2C,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC7F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,EAAE,CAAC,GAAG,OAAgC;IACpD,OAAO,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,GAAG,CAAC,GAAG,OAAgC;IACrD,OAAO,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,SAA0B;IAC/D,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,CAAS;IAC7B,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,EAAE,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAG,MAAiB;IAC1C,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAG,MAAiB;IAC7C,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAG,MAAiB;IACxC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAG,MAAiB;IAC5C,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK,CACnB,MAAmC,EACnC,GAAG,WAAoC;IAEvC,MAAM,gBAAgB,GACpB,MAAM,CAAC,MAAM,KAAK,UAAU;QAC1B,CAAC,CAAE,MAAwB,CAAC,UAAU;QACtC,CAAC,CAAE,MAAsB,CAAC,UAAU,CAAC;IAEzC,MAAM,mBAAmB,GACvB,MAAM,CAAC,MAAM,KAAK,OAAO;QACvB,CAAC,CAAE,MAAsB,CAAC,UAAU,CAAC,WAAW;QAChD,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,UAAU,GAAoB;QAClC,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,gBAAgB,CAAC,KAAK,KAAK,OAAO;YACxC,CAAC,CAAE,gBAAoC,CAAC,MAAM;YAC9C,CAAC,CAAE,gBAAgD;QACrD,WAAW,EAAE;YACX,GAAG,mBAAmB;YACtB,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;SACzC;KACF,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC5D,CAAC;AAED,4EAA4E;AAE5E,MAAM,UAAU,eAAe;IAC7B,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAG,MAAiB;IAC7C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAG,MAAiB;IAC9C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;AACvC,CAAC"}

package/dist/serve/worker/client/firestore-writes.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Firestore write execution — single-document writes, `writeBatch`, and
+ * `runTransaction` with read-set validation + retry for multi-tab correctness.
+ */
+import type { ClientDb, DocRefHandle, CollRefHandle } from './handles.js';
+import type { ClientDocSnapshot } from './snapshots.js';
+export declare function setDoc(ref: DocRefHandle, data: Record<string, unknown>, options?: {
+    merge?: boolean;
+    mergeFields?: string[];
+}): Promise<void>;
+export declare function updateDoc(ref: DocRefHandle, data: Record<string, unknown>): Promise<void>;
+export declare function deleteDoc(ref: DocRefHandle): Promise<void>;
+export declare function addDoc(coll: CollRefHandle, data: Record<string, unknown>): Promise<DocRefHandle>;
+/**
+ * Client-side write batch. Buffers `set`/`update`/`delete` calls and
+ * sends them all to the worker on `.commit()`.
+ *
+ * Mirrors `pyric/firestore`'s `writeBatch(db)` shape:
+ *   const batch = writeBatch(db);
+ *   batch.set(ref, { ... });
+ *   batch.delete(ref2);
+ *   await batch.commit();
+ */
+export interface ClientWriteBatch {
+    set(ref: DocRefHandle, data: Record<string, unknown>, options?: {
+        merge?: boolean;
+        mergeFields?: string[];
+    }): ClientWriteBatch;
+    update(ref: DocRefHandle, data: Record<string, unknown>): ClientWriteBatch;
+    delete(ref: DocRefHandle): ClientWriteBatch;
+    commit(): Promise<void>;
+}
+export declare function writeBatch(db: ClientDb): ClientWriteBatch;
+/** Client-side transaction handle. */
+export interface ClientTransaction {
+    get(ref: DocRefHandle): Promise<ClientDocSnapshot>;
+    set(ref: DocRefHandle, data: Record<string, unknown>, options?: {
+        merge?: boolean;
+        mergeFields?: string[];
+    }): void;
+    update(ref: DocRefHandle, data: Record<string, unknown>): void;
+    delete(ref: DocRefHandle): void;
+}
+/**
+ * Run a transaction. Mirrors `pyric/firestore`'s `runTransaction(db, fn)`.
+ *
+ * MULTI-TAB CORRECTNESS — READ-SET VALIDATION + RETRY
+ * ----------------------------------------------------
+ * A transaction spans two messages: the `txn.get` RPC (read) and the
+ * `txnCommit` RPC (commit). Between those two messages another tab may
+ * write to a doc the current tab read — a silent lost update without
+ * validation. We fix this the standard way:
+ *
+ *   1. Each `txn.get(ref)` records `{ path, data }` in a per-attempt
+ *      read-set (`data` is the raw `SerializedDocData` the worker
+ *      returned, or `null` if the doc was missing).
+ *   2. `txnCommit` carries both `reads` (the read-set) and `writes`.
+ *   3. The worker re-reads each doc inside a sandbox transaction, re-
+ *      serializes it the same way, and compares the JSON strings.
+ *      Any mismatch → `{ ok: false, error: { code: 'aborted' } }`.
+ *   4. On `aborted`, the client discards the result of `updateFn` and
+ *      re-runs it with a fresh transaction object (fresh reads, empty
+ *      write buffer). Up to `TXN_MAX_ATTEMPTS` attempts are made.
+ *   5. After the cap, throws an error with `.code === 'aborted'`.
+ *
+ * This matches real Firestore's behaviour: the SDK retries `updateFn`
+ * on conflict rather than surfacing the error immediately.
+ */
+export declare function runTransaction<R>(db: ClientDb, updateFn: (txn: ClientTransaction) => Promise<R> | R): Promise<R>;
+//# sourceMappingURL=firestore-writes.d.ts.map

package/dist/serve/worker/client/firestore-writes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestore-writes.d.ts","sourceRoot":"","sources":["../../../../src/serve/worker/client/firestore-writes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE1E,OAAO,KAAK,EAAgB,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEtE,wBAAsB,MAAM,CAC1B,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACpD,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhE;AAED,wBAAsB,MAAM,CAC1B,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,YAAY,CAAC,CAgBvB;AAID;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,gBAAgB,CAAC;IAC/H,MAAM,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAAC;IAC3E,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,gBAAgB,CAAC;IAC5C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,GAAG,gBAAgB,CA2BzD;AAID,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnD,GAAG,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IACnH,MAAM,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAAC;CACjC;AAQD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GACnD,OAAO,CAAC,CAAC,CAAC,CAqEZ"}

package/dist/serve/worker/client/firestore-writes.js

@@ -0,0 +1,169 @@
+/**
+ * Firestore write execution — single-document writes, `writeBatch`, and
+ * `runTransaction` with read-set validation + retry for multi-tab correctness.
+ */
+import { nextId, dataRpc } from './core.js';
+import { makeDocSnapshot } from './snapshots.js';
+export async function setDoc(ref, data, options) {
+    await dataRpc(ref.port, {
+        t: 'op',
+        id: nextId(),
+        method: 'setDoc',
+        path: ref.descriptor.path,
+        data,
+        options,
+    });
+}
+export async function updateDoc(ref, data) {
+    await dataRpc(ref.port, {
+        t: 'op',
+        id: nextId(),
+        method: 'updateDoc',
+        path: ref.descriptor.path,
+        data,
+    });
+}
+export async function deleteDoc(ref) {
+    await dataRpc(ref.port, {
+        t: 'op',
+        id: nextId(),
+        method: 'deleteDoc',
+        path: ref.descriptor.path,
+    });
+}
+export async function addDoc(coll, data) {
+    const result = await dataRpc(coll.port, {
+        t: 'op',
+        id: nextId(),
+        method: 'addDoc',
+        collectionPath: coll.descriptor.path,
+        data,
+    });
+    return {
+        __kind: 'doc-ref',
+        descriptor: { __ref: 'doc', path: result.path },
+        port: coll.port,
+        id: result.id,
+        path: result.path,
+    };
+}
+export function writeBatch(db) {
+    const writes = [];
+    const port = db.port;
+    const batch = {
+        set(ref, data, options) {
+            writes.push({ method: 'set', path: ref.descriptor.path, data, options });
+            return batch;
+        },
+        update(ref, data) {
+            writes.push({ method: 'update', path: ref.descriptor.path, data });
+            return batch;
+        },
+        delete(ref) {
+            writes.push({ method: 'delete', path: ref.descriptor.path });
+            return batch;
+        },
+        async commit() {
+            await dataRpc(port, {
+                t: 'op',
+                id: nextId(),
+                method: 'batchCommit',
+                writes: [...writes],
+            });
+        },
+    };
+    return batch;
+}
+/**
+ * Maximum number of times the client will retry `updateFn` on a
+ * worker-reported conflict (`aborted`). Matches Firestore SDK default.
+ */
+const TXN_MAX_ATTEMPTS = 5;
+/**
+ * Run a transaction. Mirrors `pyric/firestore`'s `runTransaction(db, fn)`.
+ *
+ * MULTI-TAB CORRECTNESS — READ-SET VALIDATION + RETRY
+ * ----------------------------------------------------
+ * A transaction spans two messages: the `txn.get` RPC (read) and the
+ * `txnCommit` RPC (commit). Between those two messages another tab may
+ * write to a doc the current tab read — a silent lost update without
+ * validation. We fix this the standard way:
+ *
+ *   1. Each `txn.get(ref)` records `{ path, data }` in a per-attempt
+ *      read-set (`data` is the raw `SerializedDocData` the worker
+ *      returned, or `null` if the doc was missing).
+ *   2. `txnCommit` carries both `reads` (the read-set) and `writes`.
+ *   3. The worker re-reads each doc inside a sandbox transaction, re-
+ *      serializes it the same way, and compares the JSON strings.
+ *      Any mismatch → `{ ok: false, error: { code: 'aborted' } }`.
+ *   4. On `aborted`, the client discards the result of `updateFn` and
+ *      re-runs it with a fresh transaction object (fresh reads, empty
+ *      write buffer). Up to `TXN_MAX_ATTEMPTS` attempts are made.
+ *   5. After the cap, throws an error with `.code === 'aborted'`.
+ *
+ * This matches real Firestore's behaviour: the SDK retries `updateFn`
+ * on conflict rather than surfacing the error immediately.
+ */
+export async function runTransaction(db, updateFn) {
+    const port = db.port;
+    for (let attempt = 0; attempt < TXN_MAX_ATTEMPTS; attempt++) {
+        // Fresh read-set and write buffer for each attempt.
+        const reads = [];
+        const writes = [];
+        const txn = {
+            async get(ref) {
+                // RPC to the worker — capture the raw result before rehydration.
+                const rawResult = await dataRpc(ref.port, {
+                    t: 'op',
+                    id: nextId(),
+                    method: 'getDoc',
+                    path: ref.descriptor.path,
+                });
+                // Record the raw serialized data (or null) in the read-set.
+                // We preserve the wire-form SerializedDocData so the worker can
+                // re-serialize the current doc and compare JSON strings.
+                reads.push({
+                    path: ref.descriptor.path,
+                    data: (rawResult.exists && rawResult.data) ? rawResult.data : null,
+                });
+                return makeDocSnapshot(rawResult, ref.port);
+            },
+            set(ref, data, options) {
+                writes.push({ method: 'set', path: ref.descriptor.path, data, options });
+            },
+            update(ref, data) {
+                writes.push({ method: 'update', path: ref.descriptor.path, data });
+            },
+            delete(ref) {
+                writes.push({ method: 'delete', path: ref.descriptor.path });
+            },
+        };
+        const result = await updateFn(txn);
+        // Send read-set + writes to the worker for validation and commit.
+        try {
+            await dataRpc(port, {
+                t: 'op',
+                id: nextId(),
+                method: 'txnCommit',
+                reads: [...reads],
+                writes: [...writes],
+            });
+            return result;
+        }
+        catch (err) {
+            const e = err;
+            if (e.code === 'aborted') {
+                // Conflict detected — retry updateFn on the next attempt.
+                continue;
+            }
+            // Permission-denied, not-found, etc. — propagate immediately.
+            throw err;
+        }
+    }
+    // Exceeded max attempts.
+    const abortErr = new Error(`Transaction failed after ${TXN_MAX_ATTEMPTS} attempts due to repeated conflicts. ` +
+        'Another tab is concurrently writing to the same documents.');
+    abortErr.code = 'aborted';
+    throw abortErr;
+}
+//# sourceMappingURL=firestore-writes.js.map

package/dist/serve/worker/client/firestore-writes.js.map

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

package/dist/serve/worker/client/handles.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Worker-client handle types — the opaque, port-carrying references the client
+ * surface hands back to callers. Shared by every API family (firestore, auth,
+ * rtdb, storage), so they live in one leaf module with no runtime dependencies
+ * beyond the wire-protocol descriptor types.
+ */
+import type { DocRef, CollRef, QueryDescriptor, InboundMessage, OutboundMessage } from '../protocol.js';
+/** The exact transport contract shared by native MessagePort and SW relay ports. */
+export interface ClientPort {
+    onmessage: ((event: MessageEvent<OutboundMessage>) => void) | null;
+    postMessage(message: InboundMessage): void;
+    start(): void;
+    close(): void;
+}
+/** Opaque client-side Firestore handle. Holds the MessagePort to the worker. */
+export interface ClientDb {
+    readonly __kind: 'client-db';
+    readonly port: ClientPort;
+}
+export interface ClientRtdb {
+    readonly __kind: 'client-rtdb';
+    readonly port: ClientPort;
+}
+export interface RtdbRefHandle {
+    readonly __kind: 'rtdb-ref';
+    readonly port: ClientPort;
+    readonly path: string;
+    readonly key: string | null;
+    readonly parent: RtdbRefHandle | null;
+    readonly root: RtdbRefHandle;
+    toString(): string;
+}
+export interface RtdbDataSnapshot {
+    readonly key: string | null;
+    readonly size: number;
+    exists(): boolean;
+    val(): unknown;
+    child(path: string): RtdbDataSnapshot;
+    hasChild(path: string): boolean;
+    hasChildren(): boolean;
+    exportVal(): unknown;
+    toJSON(): unknown;
+    forEach(cb: (child: RtdbDataSnapshot) => boolean | void): boolean;
+    readonly ref: RtdbRefHandle;
+}
+/** Client-side document reference — carries a DocRef descriptor + port. */
+export interface DocRefHandle {
+    readonly __kind: 'doc-ref';
+    readonly descriptor: DocRef;
+    readonly port: ClientPort;
+    readonly id: string;
+    readonly path: string;
+}
+/** Client-side collection reference. */
+export interface CollRefHandle {
+    readonly __kind: 'coll-ref';
+    readonly descriptor: CollRef;
+    readonly port: ClientPort;
+    readonly id: string;
+    readonly path: string;
+}
+/** Client-side query. */
+export interface QueryHandle {
+    readonly __kind: 'query';
+    readonly descriptor: QueryDescriptor;
+    readonly port: ClientPort;
+}
+/** Union of all client handles. */
+export type AnyHandle = ClientDb | DocRefHandle | CollRefHandle | QueryHandle;
+/** Unsubscribe function returned by every streaming subscription. */
+export type Unsubscribe = () => void;
+export declare function lastSegment(path: string): string;
+//# sourceMappingURL=handles.d.ts.map

package/dist/serve/worker/client/handles.d.ts.map

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

package/dist/serve/worker/client/handles.js

@@ -0,0 +1,4 @@
+export function lastSegment(path) {
+    return path.split('/').at(-1) ?? path;
+}
+//# sourceMappingURL=handles.js.map

package/dist/serve/worker/client/handles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handles.js","sourceRoot":"","sources":["../../../../src/serve/worker/client/handles.ts"],"names":[],"mappings":"AAwFA,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACxC,CAAC"}

package/dist/serve/worker/client/messaging.d.ts

@@ -0,0 +1,16 @@
+/** Worker-backed Firebase Messaging client/SW receive planes. */
+import type { GetTokenOptions, MessagePayload, NextFn, Observer, Unsubscribe } from 'pyric/messaging';
+import type { ClientDb, ClientPort } from './handles.js';
+type ClientVisibilityState = 'visible' | 'hidden';
+export interface ClientMessaging {
+    readonly __kind: 'client-messaging';
+    readonly port: ClientPort;
+    activeRegistrationId: string;
+}
+export declare function messagingGetMessaging(db: ClientDb): ClientMessaging;
+export declare function messagingGetToken(messaging: ClientMessaging, options?: GetTokenOptions): Promise<string>;
+export declare function messagingDeleteToken(messaging: ClientMessaging): Promise<boolean>;
+export declare function messagingSetVisibility(messaging: ClientMessaging, state: ClientVisibilityState): Promise<void>;
+export declare function messagingSubscribe(messaging: ClientMessaging, target: 'messaging.foreground' | 'messaging.background', nextOrObserver: NextFn<MessagePayload> | Observer<MessagePayload>): Unsubscribe;
+export {};
+//# sourceMappingURL=messaging.d.ts.map

package/dist/serve/worker/client/messaging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../../../src/serve/worker/client/messaging.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,MAAM,EACN,QAAQ,EACR,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEzD,KAAK,qBAAqB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAelD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,GAAG,eAAe,CAMnE;AAED,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,eAAe,EAC1B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAOvF;AAED,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,sBAAsB,GAAG,sBAAsB,EACvD,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,QAAQ,CAAC,cAAc,CAAC,GAChE,WAAW,CAiBb"}