pyric 0.0.1 → 0.1.0-alpha.10

package/dist/database/sandbox/sentinels.js

@@ -0,0 +1,92 @@
+/**
+ * RTDB-side write sentinels.
+ *
+ * Production `firebase/database` ships exactly one server-side sentinel
+ * for ordinary writes: `serverTimestamp()` returns the shape
+ * `{ ".sv": "timestamp" }`. The wire serializer recognises that marker
+ * and the server stamps `Date.now()` (epoch ms) into the field. On
+ * read-back the client never sees the marker — only the resolved
+ * number. Oracle observation
+ * `packages/conformance/observations/rtdb/rtdb-servertimestamp-resolves.json`
+ * confirms the shape.
+ *
+ * Sandbox match: we recognise the same `{ ".sv": "timestamp" }` marker
+ * and resolve it at write time. The marker shape is the cross-target
+ * contract — agent code that writes a value built by
+ * `import { serverTimestamp } from 'pyric/database'` produces the same
+ * literal on either backend.
+ */
+const SERVER_TIMESTAMP_MARKER = '{".sv":"timestamp"}';
+/** True when `v` is the `{ ".sv": "timestamp" }` server-timestamp marker. */
+export function isServerTimestampSentinel(v) {
+    if (v === null || typeof v !== 'object')
+        return false;
+    const obj = v;
+    return obj['.sv'] === 'timestamp';
+}
+/** True when `v` is the `{ ".sv": { increment: n } }` increment marker. */
+export function isIncrementSentinel(v) {
+    if (v === null || typeof v !== 'object')
+        return false;
+    const sv = v['.sv'];
+    return (sv !== null &&
+        typeof sv === 'object' &&
+        typeof sv.increment === 'number');
+}
+/**
+ * Walk the value tree, replacing every server-side sentinel:
+ *   - `serverTimestamp()` → `now` (epoch ms).
+ *   - `increment(delta)` → `current + delta` at the corresponding path
+ *     (`0` when the current value is absent / non-numeric — DB-GAP).
+ *
+ * Returns a fresh tree — input is left untouched. `current` is the value
+ * presently stored at the SAME path as `value`; it's walked in parallel
+ * so each nested `increment` resolves against its own field's prior
+ * value. Pass `undefined`/`null` when there's nothing stored.
+ *
+ * Used by the sandbox backend at every write boundary (`set`, `update`,
+ * `push`). Multi-path `update({ '/a': sentinel, '/b': { nested: sentinel } })`
+ * is handled by the caller calling this per-path with that path's prior
+ * value.
+ */
+export function resolveSentinels(value, now, current) {
+    if (isServerTimestampSentinel(value))
+        return now;
+    if (isIncrementSentinel(value)) {
+        const delta = value['.sv'].increment;
+        const base = typeof current === 'number' ? current : 0;
+        return base + delta;
+    }
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (Array.isArray(value)) {
+        return value.map((v, i) => resolveSentinels(v, now, Array.isArray(current) ? current[i] : undefined));
+    }
+    const curObj = current !== null && typeof current === 'object' && !Array.isArray(current)
+        ? current
+        : undefined;
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+        out[k] = resolveSentinels(v, now, curObj ? curObj[k] : undefined);
+    }
+    return out;
+}
+/**
+ * Factory used by the modular SDK's `serverTimestamp()` export. Returns
+ * the same `{ ".sv": "timestamp" }` shape `firebase/database` emits so
+ * the upstream SDK's wire encoder accepts the same shape unchanged.
+ */
+export function serverTimestampSentinel() {
+    return { '.sv': 'timestamp' };
+}
+/**
+ * Factory used by the modular SDK's `increment(delta)` export. Returns
+ * the same `{ ".sv": { increment: delta } }` shape `firebase/database`
+ * emits so the upstream SDK's wire encoder accepts the same shape unchanged.
+ */
+export function incrementSentinel(delta) {
+    return { '.sv': { increment: delta } };
+}
+/** Debug-only — for assertions/tests. */
+export const SENTINEL_DEBUG = { SERVER_TIMESTAMP_MARKER };
+//# sourceMappingURL=sentinels.js.map

package/dist/database/sandbox/sentinels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentinels.js","sourceRoot":"","sources":["../../../src/database/sandbox/sentinels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAiBtD,6EAA6E;AAC7E,MAAM,UAAU,yBAAyB,CAAC,CAAU;IAClD,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,GAAG,GAAG,CAA4B,CAAC;IACzC,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,WAAW,CAAC;AACpC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,mBAAmB,CAAC,CAAU;IAC5C,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,EAAE,GAAI,CAA6B,CAAC,KAAK,CAAC,CAAC;IACjD,OAAO,CACL,EAAE,KAAK,IAAI;QACX,OAAO,EAAE,KAAK,QAAQ;QACtB,OAAQ,EAA8B,CAAC,SAAS,KAAK,QAAQ,CAC9D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,GAAW,EAAE,OAAiB;IAC7E,IAAI,yBAAyB,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACjD,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAI,KAA2B,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC;QAC5D,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,OAAO,IAAI,GAAG,KAAK,CAAC;IACtB,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACxB,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAC1E,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GACV,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QACxE,CAAC,CAAE,OAAmC;QACtC,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC;AACzC,CAAC;AAED,yCAAyC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/database/sandbox-controls.d.ts

@@ -0,0 +1,15 @@
+/** RTDB-specific owner controls for the public `pyric/sandbox/database` seam. */
+import type { LocalSandbox } from 'pyric/sandbox';
+import type { JsonValue } from './sandbox/data-tree.js';
+export type RtdbRulesJson = {
+    rules: Record<string, unknown>;
+};
+/** Replace the active RTDB rules. Pass `null` to restore default allow. */
+export declare function setRules(sandbox: LocalSandbox, rules: RtdbRulesJson | null): void;
+/** Read the currently active rules as detached JSON. */
+export declare function getActiveRules(sandbox: LocalSandbox): RtdbRulesJson | null;
+/** Replace RTDB data in bulk without applying security rules. */
+export declare function setData(sandbox: LocalSandbox, data: Record<string, unknown>): void;
+/** Snapshot the complete RTDB tree without applying security rules. */
+export declare function snapshotState(sandbox: LocalSandbox): JsonValue;
+//# sourceMappingURL=sandbox-controls.d.ts.map

package/dist/database/sandbox-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-controls.d.ts","sourceRoot":"","sources":["../../src/database/sandbox-controls.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,MAAM,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAE/D,2EAA2E;AAC3E,wBAAgB,QAAQ,CACtB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,aAAa,GAAG,IAAI,GAC1B,IAAI,CAEN;AAED,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa,GAAG,IAAI,CAE1E;AAED,iEAAiE;AACjE,wBAAgB,OAAO,CACrB,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI,CAEN;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,CAE9D"}

package/dist/database/sandbox-controls.js

@@ -0,0 +1,18 @@
+import { getOrCreateBackend } from './sandbox/backend-for.js';
+/** Replace the active RTDB rules. Pass `null` to restore default allow. */
+export function setRules(sandbox, rules) {
+    getOrCreateBackend(sandbox).setRules(rules);
+}
+/** Read the currently active rules as detached JSON. */
+export function getActiveRules(sandbox) {
+    return getOrCreateBackend(sandbox).getActiveRules();
+}
+/** Replace RTDB data in bulk without applying security rules. */
+export function setData(sandbox, data) {
+    getOrCreateBackend(sandbox).setData(data);
+}
+/** Snapshot the complete RTDB tree without applying security rules. */
+export function snapshotState(sandbox) {
+    return getOrCreateBackend(sandbox).snapshotState();
+}
+//# sourceMappingURL=sandbox-controls.js.map

package/dist/database/sandbox-controls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-controls.js","sourceRoot":"","sources":["../../src/database/sandbox-controls.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAK9D,2EAA2E;AAC3E,MAAM,UAAU,QAAQ,CACtB,OAAqB,EACrB,KAA2B;IAE3B,kBAAkB,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,cAAc,CAAC,OAAqB;IAClD,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC,cAAc,EAAE,CAAC;AACtD,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,OAAO,CACrB,OAAqB,EACrB,IAA6B;IAE7B,kBAAkB,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAiC,CAAC,CAAC;AACzE,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,OAAqB;IACjD,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,CAAC;AACrD,CAAC"}

package/dist/firestore/aggregates.d.ts

@@ -0,0 +1,50 @@
+import type { Query, CollectionReference } from './types.js';
+/**
+ * Aggregate-field descriptor returned by `count()` / `sum(field)` /
+ * `average(field)`.
+ */
+export type AggregateField = {
+    readonly kind: 'count';
+} | {
+    readonly kind: 'sum';
+    readonly field: string;
+} | {
+    readonly kind: 'average';
+    readonly field: string;
+};
+/** Spec passed to `getAggregateFromServer(query, spec)`. */
+export type AggregateSpec = Record<string, AggregateField>;
+/**
+ * Snapshot returned by `getCountFromServer` /
+ * `getAggregateFromServer`. `.data()` returns the computed numbers
+ * keyed by the spec's aliases (or `{ count: number }` for the
+ * count-only entry point).
+ */
+export interface AggregateQuerySnapshot<T extends Record<string, number | null> = Record<string, number | null>> {
+    data(): T;
+}
+/** Factory: count() aggregate. */
+export declare function count(): AggregateField;
+/** Factory: sum-of-`field` aggregate. */
+export declare function sum(field: string): AggregateField;
+/** Factory: average-of-`field` aggregate. */
+export declare function average(field: string): AggregateField;
+/**
+ * Count documents matching the query. Returns a snapshot whose
+ * `.data()` yields `{ count: N }` — same shape `firebase/firestore`'s
+ * `getCountFromServer` produces.
+ */
+export declare function getCountFromServer(source: Query | CollectionReference): Promise<AggregateQuerySnapshot<{
+    count: number;
+}>>;
+/**
+ * Run a multi-field aggregate against the query. Spec entries are
+ * keyed by caller-chosen aliases; the returned snapshot's `.data()`
+ * uses the same keys.
+ *
+ * The sandbox target dispatches straight into the chainable adapter.
+ */
+export declare function getAggregateFromServer<S extends AggregateSpec>(source: Query | CollectionReference, spec: S): Promise<AggregateQuerySnapshot<{
+    [K in keyof S]: number | null;
+}>>;
+//# sourceMappingURL=aggregates.d.ts.map

package/dist/firestore/aggregates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregates.d.ts","sourceRoot":"","sources":["../../src/firestore/aggregates.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAqB7D;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7G,IAAI,IAAI,CAAC,CAAC;CACX;AAED,kCAAkC;AAClC,wBAAgB,KAAK,IAAI,cAAc,CAEtC;AAED,yCAAyC;AACzC,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAEjD;AAED,6CAA6C;AAC7C,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAErD;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,KAAK,GAAG,mBAAmB,GAClC,OAAO,CAAC,sBAAsB,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAKpD;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,SAAS,aAAa,EAClE,MAAM,EAAE,KAAK,GAAG,mBAAmB,EACnC,IAAI,EAAE,CAAC,GACN,OAAO,CAAC,sBAAsB,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI;CAAE,CAAC,CAAC,CAMpE"}

package/dist/firestore/aggregates.js

@@ -0,0 +1,40 @@
+import { targetOf, chainQueryFor, } from './state.js';
+/** Factory: count() aggregate. */
+export function count() {
+    return { kind: 'count' };
+}
+/** Factory: sum-of-`field` aggregate. */
+export function sum(field) {
+    return { kind: 'sum', field };
+}
+/** Factory: average-of-`field` aggregate. */
+export function average(field) {
+    return { kind: 'average', field };
+}
+/**
+ * Count documents matching the query. Returns a snapshot whose
+ * `.data()` yields `{ count: N }` — same shape `firebase/firestore`'s
+ * `getCountFromServer` produces.
+ */
+export async function getCountFromServer(source) {
+    const target = targetOf(source);
+    const snap = await chainQueryFor(target, source).aggregate({ count: { kind: 'count' } });
+    const data = snap.data();
+    return { data: () => ({ count: (data.count ?? 0) }) };
+}
+/**
+ * Run a multi-field aggregate against the query. Spec entries are
+ * keyed by caller-chosen aliases; the returned snapshot's `.data()`
+ * uses the same keys.
+ *
+ * The sandbox target dispatches straight into the chainable adapter.
+ */
+export async function getAggregateFromServer(source, spec) {
+    const target = targetOf(source);
+    const chainSpec = {};
+    for (const alias of Object.keys(spec))
+        chainSpec[alias] = spec[alias];
+    const snap = await chainQueryFor(target, source).aggregate(chainSpec);
+    return { data: () => snap.data() };
+}
+//# sourceMappingURL=aggregates.js.map

package/dist/firestore/aggregates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregates.js","sourceRoot":"","sources":["../../src/firestore/aggregates.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,QAAQ,EACR,aAAa,GACd,MAAM,YAAY,CAAC;AA4CpB,kCAAkC;AAClC,MAAM,UAAU,KAAK;IACnB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,GAAG,CAAC,KAAa;IAC/B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAmC;IAEnC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IACzF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACzB,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAW,EAAE,CAAC,EAAE,CAAC;AAClE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAmC,EACnC,IAAO;IAEP,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,SAAS,GAAuB,EAAE,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAwB,CAAC;IAC7F,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACtE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAuC,EAAE,CAAC;AAC1E,CAAC"}

package/dist/firestore/equality.d.ts

@@ -0,0 +1,5 @@
+import type { DocumentReference, Query, DocumentSnapshot, QuerySnapshot } from './types.js';
+export declare function refEqual(a: DocumentReference, b: DocumentReference): boolean;
+export declare function queryEqual(a: Query, b: Query): boolean;
+export declare function snapshotEqual(a: DocumentSnapshot | QuerySnapshot, b: DocumentSnapshot | QuerySnapshot): boolean;
+//# sourceMappingURL=equality.d.ts.map

package/dist/firestore/equality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"equality.d.ts","sourceRoot":"","sources":["../../src/firestore/equality.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EACjB,KAAK,EACL,gBAAgB,EAChB,aAAa,EACd,MAAM,YAAY,CAAC;AAOpB,wBAAgB,QAAQ,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAI5E;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,OAAO,CAGtD;AAED,wBAAgB,aAAa,CAC3B,CAAC,EAAE,gBAAgB,GAAG,aAAa,EACnC,CAAC,EAAE,gBAAgB,GAAG,aAAa,GAClC,OAAO,CAGT"}

package/dist/firestore/equality.js

@@ -0,0 +1,20 @@
+/** `pyric/firestore` — sandbox reference and snapshot equality helpers. */
+import { targetOf, underlyingOf } from './state.js';
+function assertRecognizedPair(a, b) {
+    targetOf(a);
+    targetOf(b);
+}
+export function refEqual(a, b) {
+    assertRecognizedPair(a, b);
+    return underlyingOf(a).path
+        === underlyingOf(b).path;
+}
+export function queryEqual(a, b) {
+    assertRecognizedPair(a, b);
+    return a === b;
+}
+export function snapshotEqual(a, b) {
+    assertRecognizedPair(a, b);
+    return a === b;
+}
+//# sourceMappingURL=equality.js.map

package/dist/firestore/equality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"equality.js","sourceRoot":"","sources":["../../src/firestore/equality.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQpD,SAAS,oBAAoB,CAAC,CAAS,EAAE,CAAS;IAChD,QAAQ,CAAC,CAAC,CAAC,CAAC;IACZ,QAAQ,CAAC,CAAC,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,CAAoB,EAAE,CAAoB;IACjE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3B,OAAQ,YAAY,CAAC,CAAC,CAAsB,CAAC,IAAI;YAC1C,YAAY,CAAC,CAAC,CAAsB,CAAC,IAAI,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAQ,EAAE,CAAQ;IAC3C,oBAAoB,CAAC,CAAW,EAAE,CAAW,CAAC,CAAC;IAC/C,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,CAAmC,EACnC,CAAmC;IAEnC,oBAAoB,CAAC,CAAW,EAAE,CAAW,CAAC,CAAC;IAC/C,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC"}

package/dist/firestore/field-values.d.ts

@@ -0,0 +1,61 @@
+/**
+ * `pyric/firestore` — field-value sentinels + sandbox scalar types.
+ *
+ * Canonical `firebase/firestore` imports still receive Firebase's classes
+ * when package resolution has not selected Pyric. This mirror owns local
+ * equivalents so its sandbox implementation never loads the production SDK.
+ */
+import { FieldValue as ChainFieldValue, Timestamp as ChainTimestamp, type FieldValueSentinel } from 'pyric/sandbox/admin-firestore';
+export declare class Bytes {
+    private readonly bytes;
+    private constructor();
+    static fromBase64String(base64: string): Bytes;
+    static fromUint8Array(array: Uint8Array): Bytes;
+    toBase64(): string;
+    toUint8Array(): Uint8Array;
+    toString(): string;
+    isEqual(other: Bytes): boolean;
+    toJSON(): object;
+    static fromJSON(json: object): Bytes;
+}
+export declare class GeoPoint {
+    private readonly lat;
+    private readonly lng;
+    constructor(lat: number, lng: number);
+    get latitude(): number;
+    get longitude(): number;
+    isEqual(other: GeoPoint): boolean;
+    toJSON(): {
+        latitude: number;
+        longitude: number;
+        type: string;
+    };
+    static fromJSON(json: object): GeoPoint;
+}
+export declare class FieldPath {
+    readonly _internalPath: {
+        segments: string[];
+        offset: number;
+        len: number;
+    };
+    constructor(...fieldNames: string[]);
+    isEqual(other: FieldPath): boolean;
+}
+export declare function documentId(): FieldPath;
+export declare class VectorValue {
+    readonly _values: number[];
+    private constructor();
+    static create(values: number[]): VectorValue;
+    toArray(): number[];
+    isEqual(other: VectorValue): boolean;
+    toJSON(): object;
+    static fromJSON(json: object): VectorValue;
+}
+export declare function vector(values?: number[]): VectorValue;
+export { ChainFieldValue as FieldValue, ChainTimestamp as Timestamp };
+export declare function serverTimestamp(): FieldValueSentinel;
+export declare function increment(n: number): FieldValueSentinel;
+export declare function arrayUnion(...values: unknown[]): FieldValueSentinel;
+export declare function arrayRemove(...values: unknown[]): FieldValueSentinel;
+export declare function deleteField(): FieldValueSentinel;
+//# sourceMappingURL=field-values.d.ts.map

package/dist/firestore/field-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-values.d.ts","sourceRoot":"","sources":["../../src/firestore/field-values.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,UAAU,IAAI,eAAe,EAC7B,SAAS,IAAI,cAAc,EAC3B,KAAK,kBAAkB,EACxB,MAAM,+BAA+B,CAAC;AAEvC,qBAAa,KAAK;IACI,OAAO,CAAC,QAAQ,CAAC,KAAK;IAA1C,OAAO;IAEP,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;IAO9C,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK;IAI/C,QAAQ,IAAI,MAAM;IAMlB,YAAY,IAAI,UAAU;IAI1B,QAAQ,IAAI,MAAM;IAIlB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAM9B,MAAM,IAAI,MAAM;IAIhB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;CAOrC;AAED,qBAAa,QAAQ;IAEjB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM;IAU9B,IAAI,QAAQ,IAAI,MAAM,CAAqB;IAC3C,IAAI,SAAS,IAAI,MAAM,CAAqB;IAE5C,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAMjC,MAAM,IAAI;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAQ/D,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;CAWxC;AAED,qBAAa,SAAS;IACpB,QAAQ,CAAC,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;gBAEhE,GAAG,UAAU,EAAE,MAAM,EAAE;IAWnC,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;CAOnC;AAED,wBAAgB,UAAU,IAAI,SAAS,CAEtC;AAED,qBAAa,WAAW;IACF,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE;IAA9C,OAAO;IAEP,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW;IAO5C,OAAO,IAAI,MAAM,EAAE;IAInB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;IAOpC,MAAM,IAAI,MAAM;IAOhB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;CAW3C;AAED,wBAAgB,MAAM,CAAC,MAAM,GAAE,MAAM,EAAO,GAAG,WAAW,CAEzD;AAED,OAAO,EAAE,eAAe,IAAI,UAAU,EAAE,cAAc,IAAI,SAAS,EAAE,CAAC;AAEtE,wBAAgB,eAAe,IAAI,kBAAkB,CAEpD;AACD,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAEvD;AACD,wBAAgB,UAAU,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAEnE;AACD,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAEpE;AACD,wBAAgB,WAAW,IAAI,kBAAkB,CAEhD"}

package/dist/firestore/field-values.js

@@ -0,0 +1,167 @@
+/**
+ * `pyric/firestore` — field-value sentinels + sandbox scalar types.
+ *
+ * Canonical `firebase/firestore` imports still receive Firebase's classes
+ * when package resolution has not selected Pyric. This mirror owns local
+ * equivalents so its sandbox implementation never loads the production SDK.
+ */
+import { FieldValue as ChainFieldValue, Timestamp as ChainTimestamp, } from 'pyric/sandbox/admin-firestore';
+export class Bytes {
+    bytes;
+    constructor(bytes) {
+        this.bytes = bytes;
+    }
+    static fromBase64String(base64) {
+        const binary = atob(base64);
+        const bytes = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i += 1)
+            bytes[i] = binary.charCodeAt(i);
+        return new Bytes(bytes);
+    }
+    static fromUint8Array(array) {
+        return new Bytes(array.slice());
+    }
+    toBase64() {
+        let binary = '';
+        for (const byte of this.bytes)
+            binary += String.fromCharCode(byte);
+        return btoa(binary);
+    }
+    toUint8Array() {
+        return this.bytes.slice();
+    }
+    toString() {
+        return `Bytes(base64: ${this.toBase64()})`;
+    }
+    isEqual(other) {
+        return other instanceof Bytes
+            && this.bytes.length === other.bytes.length
+            && this.bytes.every((byte, index) => byte === other.bytes[index]);
+    }
+    toJSON() {
+        return { type: 'firestore/bytes/1.0', bytes: this.toBase64() };
+    }
+    static fromJSON(json) {
+        const value = json;
+        if (value.type !== 'firestore/bytes/1.0' || typeof value.bytes !== 'string') {
+            throw new TypeError('Invalid Bytes JSON value.');
+        }
+        return Bytes.fromBase64String(value.bytes);
+    }
+}
+export class GeoPoint {
+    lat;
+    lng;
+    constructor(lat, lng) {
+        this.lat = lat;
+        this.lng = lng;
+        if (!Number.isFinite(lat) || lat < -90 || lat > 90) {
+            throw new TypeError('Latitude must be a number between -90 and 90.');
+        }
+        if (!Number.isFinite(lng) || lng < -180 || lng > 180) {
+            throw new TypeError('Longitude must be a number between -180 and 180.');
+        }
+    }
+    get latitude() { return this.lat; }
+    get longitude() { return this.lng; }
+    isEqual(other) {
+        return other instanceof GeoPoint
+            && this.lat === other.lat
+            && this.lng === other.lng;
+    }
+    toJSON() {
+        return {
+            latitude: this.lat,
+            longitude: this.lng,
+            type: 'firestore/geoPoint/1.0',
+        };
+    }
+    static fromJSON(json) {
+        const value = json;
+        if (value.type !== 'firestore/geoPoint/1.0'
+            || typeof value.latitude !== 'number'
+            || typeof value.longitude !== 'number') {
+            throw new TypeError('Invalid GeoPoint JSON value.');
+        }
+        return new GeoPoint(value.latitude, value.longitude);
+    }
+}
+export class FieldPath {
+    _internalPath;
+    constructor(...fieldNames) {
+        if (fieldNames.length === 0 || fieldNames.some((name) => name.length === 0)) {
+            throw new TypeError('FieldPath requires at least one non-empty field name.');
+        }
+        this._internalPath = {
+            segments: fieldNames.slice(),
+            offset: 0,
+            len: fieldNames.length,
+        };
+    }
+    isEqual(other) {
+        const ours = this._internalPath.segments;
+        const theirs = other?._internalPath?.segments;
+        return Array.isArray(theirs)
+            && ours.length === theirs.length
+            && ours.every((segment, index) => segment === theirs[index]);
+    }
+}
+export function documentId() {
+    return new FieldPath('__name__');
+}
+export class VectorValue {
+    _values;
+    constructor(_values) {
+        this._values = _values;
+    }
+    static create(values) {
+        if (!values.every((value) => typeof value === 'number')) {
+            throw new TypeError('Vector values must be numbers.');
+        }
+        return new VectorValue(values.slice());
+    }
+    toArray() {
+        return this._values.slice();
+    }
+    isEqual(other) {
+        const theirs = other instanceof VectorValue ? other._values : undefined;
+        return theirs !== undefined
+            && this._values.length === theirs.length
+            && this._values.every((value, index) => value === theirs[index]);
+    }
+    toJSON() {
+        return {
+            type: 'firestore/vectorValue/1.0',
+            vectorValues: this.toArray(),
+        };
+    }
+    static fromJSON(json) {
+        const value = json;
+        if (value.type !== 'firestore/vectorValue/1.0'
+            || !Array.isArray(value.vectorValues)
+            || !value.vectorValues.every((entry) => typeof entry === 'number')) {
+            throw new TypeError('Invalid VectorValue JSON value.');
+        }
+        return VectorValue.create(value.vectorValues);
+    }
+}
+export function vector(values = []) {
+    return VectorValue.create(values);
+}
+export { ChainFieldValue as FieldValue, ChainTimestamp as Timestamp };
+export function serverTimestamp() {
+    return ChainFieldValue.serverTimestamp();
+}
+export function increment(n) {
+    return ChainFieldValue.increment(n);
+}
+export function arrayUnion(...values) {
+    return ChainFieldValue.arrayUnion(...values);
+}
+export function arrayRemove(...values) {
+    return ChainFieldValue.arrayRemove(...values);
+}
+export function deleteField() {
+    return ChainFieldValue.delete();
+}
+//# sourceMappingURL=field-values.js.map

package/dist/firestore/field-values.js.map

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

package/dist/firestore/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `pyric/firestore` — modular Web-SDK Firestore adapter for the Pyric
+ * sandbox.
+ *
+ * Mirrors `firebase/firestore`'s tree-shakable free-function shape
+ * (`getDoc`, `setDoc`, `addDoc`, `query`, `where`, `orderBy`, `limit`,
+ * `onSnapshot`, `runTransaction`, …). Every operation routes to the
+ * no-network sandbox. Production selection happens before this module loads:
+ * package resolution leaves `firebase/firestore` unchanged when inactive.
+ *
+ * This module is a re-export barrel over the per-family modules in this
+ * directory — it holds no implementation. The families mirror the
+ * symmetric `@pyric/cli` worker client split:
+ *   - `state`             the TARGET_SYMBOL brand + routing/converter
+ *                         WeakMaps + tag/resolve helpers + value finalizers
+ *   - `types`             public handle / reference / query / snapshot /
+ *                         converter / batch / transaction types
+ *   - `snapshots`         sandbox snapshot rehydration (reads + listeners)
+ *   - `instances`         getFirestore / getAdminFirestore / actingAs +
+ *                         emulator connect
+ *   - `equality`          refEqual / queryEqual / snapshotEqual
+ *   - `persistence`       offline / persistence / network + cache-init +
+ *                         get-from-server/cache + logLevel + snapshots-sync
+ *   - `refs`              doc / collection / collectionGroup / withConverter
+ *   - `reads`             getDoc / getDocs
+ *   - `writes`            setDoc / updateDoc / deleteDoc / addDoc
+ *   - `query-constraints` query + where/or/and/orderBy/limit + cursors
+ *   - `aggregates`        count / sum / average + getCount/AggregateFromServer
+ *   - `listeners`         onSnapshot
+ *   - `transactions`      runTransaction / writeBatch
+ *   - `field-values`      sentinels + scalar type re-exports
+ *   - `tools`             tool factories
+ *
+ * The barrel IS the published `pyric/firestore` subpath surface. Each family
+ * module exports only its public symbols, so `export *` re-exports exactly
+ * the published set; `state`'s package-internal helpers stay off the surface
+ * (only its `TARGET_SYMBOL` brand is re-exported).
+ */
+export { TARGET_SYMBOL } from './state.js';
+export * from './types.js';
+export * from './instances.js';
+export * from './equality.js';
+export * from './persistence.js';
+export * from './refs.js';
+export * from './reads.js';
+export * from './writes.js';
+export * from './query-constraints.js';
+export * from './aggregates.js';
+export * from './listeners.js';
+export * from './transactions.js';
+export * from './field-values.js';
+export { createFirestoreDataTools, createFirestoreInspectTools } from './tools.js';
+export type { FirestoreDataToolDeps, FirestoreInspectToolDeps, UserAuth, As, } from './tools.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/firestore/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/firestore/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACnF,YAAY,EACV,qBAAqB,EACrB,wBAAwB,EACxB,QAAQ,EACR,EAAE,GACH,MAAM,YAAY,CAAC"}

package/dist/firestore/index.js

@@ -0,0 +1,54 @@
+/**
+ * `pyric/firestore` — modular Web-SDK Firestore adapter for the Pyric
+ * sandbox.
+ *
+ * Mirrors `firebase/firestore`'s tree-shakable free-function shape
+ * (`getDoc`, `setDoc`, `addDoc`, `query`, `where`, `orderBy`, `limit`,
+ * `onSnapshot`, `runTransaction`, …). Every operation routes to the
+ * no-network sandbox. Production selection happens before this module loads:
+ * package resolution leaves `firebase/firestore` unchanged when inactive.
+ *
+ * This module is a re-export barrel over the per-family modules in this
+ * directory — it holds no implementation. The families mirror the
+ * symmetric `@pyric/cli` worker client split:
+ *   - `state`             the TARGET_SYMBOL brand + routing/converter
+ *                         WeakMaps + tag/resolve helpers + value finalizers
+ *   - `types`             public handle / reference / query / snapshot /
+ *                         converter / batch / transaction types
+ *   - `snapshots`         sandbox snapshot rehydration (reads + listeners)
+ *   - `instances`         getFirestore / getAdminFirestore / actingAs +
+ *                         emulator connect
+ *   - `equality`          refEqual / queryEqual / snapshotEqual
+ *   - `persistence`       offline / persistence / network + cache-init +
+ *                         get-from-server/cache + logLevel + snapshots-sync
+ *   - `refs`              doc / collection / collectionGroup / withConverter
+ *   - `reads`             getDoc / getDocs
+ *   - `writes`            setDoc / updateDoc / deleteDoc / addDoc
+ *   - `query-constraints` query + where/or/and/orderBy/limit + cursors
+ *   - `aggregates`        count / sum / average + getCount/AggregateFromServer
+ *   - `listeners`         onSnapshot
+ *   - `transactions`      runTransaction / writeBatch
+ *   - `field-values`      sentinels + scalar type re-exports
+ *   - `tools`             tool factories
+ *
+ * The barrel IS the published `pyric/firestore` subpath surface. Each family
+ * module exports only its public symbols, so `export *` re-exports exactly
+ * the published set; `state`'s package-internal helpers stay off the surface
+ * (only its `TARGET_SYMBOL` brand is re-exported).
+ */
+export { TARGET_SYMBOL } from './state.js';
+export * from './types.js';
+export * from './instances.js';
+export * from './equality.js';
+export * from './persistence.js';
+export * from './refs.js';
+export * from './reads.js';
+export * from './writes.js';
+export * from './query-constraints.js';
+export * from './aggregates.js';
+export * from './listeners.js';
+export * from './transactions.js';
+export * from './field-values.js';
+// ─── Tool factories (Slice 10) ────────────────────────────────────────
+export { createFirestoreDataTools, createFirestoreInspectTools } from './tools.js';
+//# sourceMappingURL=index.js.map

package/dist/firestore/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/firestore/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,yEAAyE;AACzE,OAAO,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC"}