@pyric/cli 0.1.0-alpha.10

package/dist/discover/types.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Type system for `firestore_discover_paths`.
+ *
+ * Locked by the design rationale Decisions Log.
+ * Do not change shape without updating that file first; v2's `diff_schemas`
+ * tool depends on these types JSON-roundtripping cleanly.
+ *
+ * Pure types — no runtime imports. Both the merge module and the agent-facing
+ * tool surface depend on this file.
+ */
+/**
+ * Firestore scalar wire types. Matches the discriminator emitted by
+ * `_fieldsProto.<field>.valueType` (Phase 0.1 lock).
+ *
+ * `null` is represented as a scalar so descriptors can carry a single union
+ * shape; the merge layer separately tracks `nullable` per descriptor.
+ */
+export type FirestoreScalarType = 'null' | 'boolean' | 'integer' | 'double' | 'timestamp' | 'string' | 'bytes' | 'geopoint';
+/**
+ * One observed type for a field. Vector kept distinct from map per Phase 1.2
+ * vector-sentinel lock; reference target is the **template-form full path**
+ * per Phase 3.1 lock (`users/{userId}/posts`, not `posts`).
+ */
+export type FieldType = {
+    kind: 'scalar';
+    type: FirestoreScalarType;
+} | {
+    kind: 'reference';
+    targetCollection: string;
+} | {
+    kind: 'array';
+    elementTypes: FieldType[];
+} | {
+    kind: 'map';
+    fields: Record<string, FieldDescriptor>;
+} | {
+    kind: 'vector';
+    dimension: number | 'mixed';
+};
+/**
+ * Per-field descriptor accumulated across a sampled stream.
+ *
+ * - `types` is a deduped union; vector-dim drift keeps each dimension as a
+ *   distinct entry by default (Phase 1.2 lock).
+ * - `presenceSeen / presenceTotal` ratio drives presence-based agent UX; the
+ *   denominator includes docs where the field was absent.
+ * - `nullable` is an annotation, not a peer type (Phase 2.1 lock — `null`
+ *   never appears as a `FieldType` in this descriptor's types[]).
+ * - `enumCandidate` populated when the field qualifies per Phase 3.2 lock
+ *   (`distinct ≤ 10 AND distinct ≤ samplesSeen / 2`); otherwise `undefined`.
+ *   Tracked only for `scalar:string` and `scalar:integer/double`; other kinds
+ *   are not enum candidates.
+ * - `example` is one observed non-null value per Phase 3.2 lock. Drives form
+ *   placeholders, fixtures, README payloads. JSON-stringifiable (wire-typed
+ *   primitives + arrays + plain-object maps).
+ * - `reservedReason` populated by the wire layer when the field name matches
+ *   a reserved-name pattern per 0.B; agents/codegen use it to skip or
+ *   sanitize the field.
+ */
+export interface FieldDescriptor {
+    types: FieldType[];
+    presenceSeen: number;
+    presenceTotal: number;
+    nullable: boolean;
+    enumCandidate?: EnumCandidate;
+    example?: ExampleValue;
+    reservedReason?: ReservedFieldReason;
+}
+/** Captured low-cardinality value set for enum-candidate fields. */
+export interface EnumCandidate {
+    /** Whether the field still passes the threshold; flips to false if widened past it. */
+    qualifies: boolean;
+    /** Distinct values observed so far (string/number); ordered by first-seen. */
+    values: Array<string | number>;
+    /** Distinct count after which the candidate is dropped (default 10). */
+    threshold: number;
+}
+/** A representative observed value, JSON-safe. */
+export type ExampleValue = string | number | boolean | null | ExampleValue[] | {
+    [k: string]: ExampleValue;
+};
+/** Why a field name is flagged reserved per 0.B. */
+export type ReservedFieldReason = 'firestore_reserved_name' | 'dotted_field_name' | 'numeric_field_name' | 'double_underscore_wrap';
+/**
+ * Per-collection accumulated schema. `samplesSeen` is the doc count fed
+ * through `mergeDoc`, used as the presence denominator.
+ */
+export interface FieldSchema {
+    fields: Record<string, FieldDescriptor>;
+    samplesSeen: number;
+}
+/**
+ * 4-state classification for sampling termination per Phase 2.2 lock.
+ *
+ * - `converged_via_stable`: hit `stopOnStable` consecutive no-change docs.
+ *   Schema is *probably* complete — known false-negative is mid-stream drift
+ *   later than `stopOnStable` docs into the stable region (out of scope per
+ *   Phase 2.1 lock; deferred to a future `firestore_re_crawl`).
+ * - `converged_via_exhausted`: iterator returned empty before `maxSamples`.
+ *   Schema is *provably* complete — we read every doc.
+ * - `converged_via_max`: hit `maxSamples` cap without converging. Schema may
+ *   be incomplete; agent should treat with caution.
+ * - `sampling_open`: crawl interrupted (continuation boundary). Resume with
+ *   the returned continuation handle to keep sampling.
+ */
+export type SamplingComplete = 'converged_via_stable' | 'converged_via_exhausted' | 'converged_via_max' | 'sampling_open';
+/**
+ * Schema for a single collection as surfaced in the tool output's
+ * `finalizedSchemas`.
+ */
+export interface CollectionSchema {
+    templatePath: string;
+    examplePath?: string;
+    schema: FieldSchema;
+    samplingComplete: SamplingComplete;
+    declaredAt: number | null;
+    subcollectionTemplatePaths: string[];
+}
+/**
+ * Path within a doc to a field. `'[]'` segment denotes array element scope,
+ * used for nested-array/map descriptors.
+ */
+export type FieldPath = ReadonlyArray<string | '[]'>;
+/**
+ * Frozen `SchemaChange` enum per Phase 5 implementation plan lock. Emitted
+ * by the merge layer; carried in `schema_updated` events.
+ *
+ * Renamed from v1 scope's `ChangeReason` to match the agent-facing terminology
+ * in the validation plan's event-model lock.
+ */
+export type SchemaChange = {
+    kind: 'field_added';
+    path: FieldPath;
+    type: FieldType;
+} | {
+    kind: 'type_expanded';
+    path: FieldPath;
+    addedType: FieldType;
+} | {
+    kind: 'presence_changed';
+    path: FieldPath;
+    presenceSeen: number;
+    presenceTotal: number;
+} | {
+    kind: 'enum_added';
+    path: FieldPath;
+    values: Array<string | number>;
+} | {
+    kind: 'enum_widened';
+    path: FieldPath;
+    addedValue: string | number;
+} | {
+    kind: 'enum_dropped';
+    path: FieldPath;
+    reason: 'over_threshold' | 'type_widened';
+} | {
+    kind: 'vector_dim_drift';
+    path: FieldPath;
+    addedDimension: number;
+} | {
+    kind: 'became_nullable';
+    path: FieldPath;
+};
+/**
+ * Event stream emitted by `firestore_discover_paths`. Frozen enum per
+ * Phase 3.3 lock. Order within a batch is meaningful — agents may rely on
+ * `collection_discovered` arriving before `schema_updated` for the same path.
+ */
+export type DiscoverEvent = {
+    kind: 'collection_discovered';
+    templatePath: string;
+    depth: number;
+    parentPath?: string;
+} | {
+    kind: 'schema_updated';
+    templatePath: string;
+    changes: SchemaChange[];
+} | {
+    kind: 'sampling_complete';
+    templatePath: string;
+    samplingComplete: SamplingComplete;
+    samplesSeen: number;
+    declaredAt: number | null;
+} | {
+    kind: 'error';
+    templatePath: string;
+    code: string;
+    message: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/discover/types.d.ts.map

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

package/dist/discover/types.js

@@ -0,0 +1,12 @@
+/**
+ * Type system for `firestore_discover_paths`.
+ *
+ * Locked by the design rationale Decisions Log.
+ * Do not change shape without updating that file first; v2's `diff_schemas`
+ * tool depends on these types JSON-roundtripping cleanly.
+ *
+ * Pure types — no runtime imports. Both the merge module and the agent-facing
+ * tool surface depend on this file.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/discover/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/discover/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/discover/wire.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Firestore wire-format → FieldObservation conversion.
+ *
+ * The SDK boundary for `firestore_discover_paths`. Reads the private
+ * `DocumentSnapshot._fieldsProto` representation per the Phase 0.1 lock
+ * (numberTypeStrategy: "wire" — preserves integerValue/doubleValue
+ * distinction at the value boundary).
+ *
+ * Three responsibilities:
+ *   1. Validate `_fieldsProto` is present and shaped as expected. Fail
+ *      loud if absent (prerequisite 0.A — silent fallback to data() would
+ *      collapse all numeric types and corrupt downstream codegen).
+ *   2. Convert each wire value into a FieldObservation suitable for
+ *      `mergeDoc` — including the example projection and the enum sample.
+ *   3. Flag reserved field names (prerequisite 0.B) so codegen layers can
+ *      skip or sanitize.
+ */
+import type { FieldObservation } from './merge.js';
+import type { WireDocumentSnapshot } from './firestore-source.js';
+import type { FieldType, ReservedFieldReason } from './types.js';
+/**
+ * Thrown when `DocumentSnapshot._fieldsProto` is unavailable or malformed.
+ * Per prerequisite 0.A, the wire reader does NOT silently fall back to
+ * `data()` — that would collapse integer/double at the value boundary
+ * and corrupt every downstream codegen consumer.
+ */
+export declare class WireProtoUnavailableError extends Error {
+    readonly name = "WireProtoUnavailableError";
+    constructor(opts: {
+        docPath: string;
+        reason: string;
+    });
+}
+/**
+ * Classify a field name. Returns undefined for normal names, or a
+ * specific ReservedFieldReason for names that codegen must skip/sanitize.
+ *
+ * Rules ordered by specificity (most specific first):
+ *   - exact `__name__` etc. → firestore_reserved_name
+ *   - contains '.'          → dotted_field_name (breaks dot-path access)
+ *   - pure-numeric          → numeric_field_name (looks like array index)
+ *   - __foo__               → double_underscore_wrap (sentinel collision)
+ */
+export declare function classifyFieldName(name: string): ReservedFieldReason | undefined;
+export type WireValue = any;
+/**
+ * Pure type extraction. Does not extract examples or enum samples — use
+ * `wireValueToObservation` for the full observation.
+ */
+export declare function wireValueToFieldType(v: WireValue): FieldType;
+/**
+ * Full observation including JSON-safe example projection and enum sample
+ * extraction. The merge layer consumes this shape.
+ */
+export declare function wireValueToObservation(v: WireValue): FieldObservation;
+/**
+ * Convert a Firestore document snapshot into a FieldObservation map.
+ * Detects reserved field names per 0.B — they appear in the output but
+ * the descriptor returned by the merge layer carries `reservedReason`
+ * so codegen can skip them.
+ *
+ * Throws `WireProtoUnavailableError` if `_fieldsProto` is absent (0.A
+ * fail-loud contract). Empty docs (proto present but zero keys) return
+ * an empty record without throwing.
+ */
+export declare function snapshotToObservations(snap: WireDocumentSnapshot): {
+    observations: Record<string, FieldObservation>;
+    reservedNames: Record<string, ReservedFieldReason>;
+};
+//# sourceMappingURL=wire.d.ts.map

package/dist/discover/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/discover/wire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAEV,SAAS,EACT,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAIpB;;;;;GAKG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,SAAkB,IAAI,+BAA+B;gBACzC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAWtD;AAMD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAQ/E;AAKD,MAAM,MAAM,SAAS,GAAG,GAAG,CAAC;AAE5B;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,SAAS,GAAG,SAAS,CA8C5D;AAID;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,SAAS,GAAG,gBAAgB,CAMrE;AA4GD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG;IAClE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC/C,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CACpD,CAqCA"}

package/dist/discover/wire.js

@@ -0,0 +1,309 @@
+/**
+ * Firestore wire-format → FieldObservation conversion.
+ *
+ * The SDK boundary for `firestore_discover_paths`. Reads the private
+ * `DocumentSnapshot._fieldsProto` representation per the Phase 0.1 lock
+ * (numberTypeStrategy: "wire" — preserves integerValue/doubleValue
+ * distinction at the value boundary).
+ *
+ * Three responsibilities:
+ *   1. Validate `_fieldsProto` is present and shaped as expected. Fail
+ *      loud if absent (prerequisite 0.A — silent fallback to data() would
+ *      collapse all numeric types and corrupt downstream codegen).
+ *   2. Convert each wire value into a FieldObservation suitable for
+ *      `mergeDoc` — including the example projection and the enum sample.
+ *   3. Flag reserved field names (prerequisite 0.B) so codegen layers can
+ *      skip or sanitize.
+ */
+import { fieldTypeKey } from './merge.js';
+// ─── Error type for 0.A ───────────────────────────────────────────────────
+/**
+ * Thrown when `DocumentSnapshot._fieldsProto` is unavailable or malformed.
+ * Per prerequisite 0.A, the wire reader does NOT silently fall back to
+ * `data()` — that would collapse integer/double at the value boundary
+ * and corrupt every downstream codegen consumer.
+ */
+export class WireProtoUnavailableError extends Error {
+    name = 'WireProtoUnavailableError';
+    constructor(opts) {
+        super(`firestore_discover_paths could not read wire types from document ` +
+            `"${opts.docPath}": ${opts.reason}. The discover_paths tool depends on ` +
+            `firebase-admin DocumentSnapshot._fieldsProto for accurate ` +
+            `integer/double type inference (Phase 0.1 lock). If this is a ` +
+            `firebase-admin upgrade incompatibility, set ` +
+            `numberTypeStrategy: "heuristic" to opt into the lossy fallback ` +
+            `knowingly. Otherwise file an issue with the admin SDK version.`);
+    }
+}
+// ─── Reserved-name detection (0.B) ────────────────────────────────────────
+const FIRESTORE_RESERVED_NAMES = new Set(['__name__']);
+/**
+ * Classify a field name. Returns undefined for normal names, or a
+ * specific ReservedFieldReason for names that codegen must skip/sanitize.
+ *
+ * Rules ordered by specificity (most specific first):
+ *   - exact `__name__` etc. → firestore_reserved_name
+ *   - contains '.'          → dotted_field_name (breaks dot-path access)
+ *   - pure-numeric          → numeric_field_name (looks like array index)
+ *   - __foo__               → double_underscore_wrap (sentinel collision)
+ */
+export function classifyFieldName(name) {
+    if (FIRESTORE_RESERVED_NAMES.has(name))
+        return 'firestore_reserved_name';
+    if (name.includes('.'))
+        return 'dotted_field_name';
+    if (/^-?\d+$/.test(name))
+        return 'numeric_field_name';
+    if (name.length >= 4 && name.startsWith('__') && name.endsWith('__')) {
+        return 'double_underscore_wrap';
+    }
+    return undefined;
+}
+/**
+ * Pure type extraction. Does not extract examples or enum samples — use
+ * `wireValueToObservation` for the full observation.
+ */
+export function wireValueToFieldType(v) {
+    if ('nullValue' in v)
+        return { kind: 'scalar', type: 'null' };
+    if ('booleanValue' in v)
+        return { kind: 'scalar', type: 'boolean' };
+    if ('integerValue' in v)
+        return { kind: 'scalar', type: 'integer' };
+    if ('doubleValue' in v)
+        return { kind: 'scalar', type: 'double' };
+    if ('timestampValue' in v)
+        return { kind: 'scalar', type: 'timestamp' };
+    if ('stringValue' in v)
+        return { kind: 'scalar', type: 'string' };
+    if ('bytesValue' in v)
+        return { kind: 'scalar', type: 'bytes' };
+    if ('geoPointValue' in v)
+        return { kind: 'scalar', type: 'geopoint' };
+    if ('referenceValue' in v) {
+        return {
+            kind: 'reference',
+            targetCollection: parseRefTargetCollectionPath(v.referenceValue),
+        };
+    }
+    if ('arrayValue' in v) {
+        const values = v.arrayValue?.values ?? [];
+        const elementTypes = values.map(wireValueToFieldType);
+        const seen = new Set();
+        const deduped = elementTypes.filter((t) => {
+            const k = fieldTypeKey(t);
+            if (seen.has(k))
+                return false;
+            seen.add(k);
+            return true;
+        });
+        return { kind: 'array', elementTypes: deduped };
+    }
+    if ('mapValue' in v) {
+        const fieldsObj = v.mapValue?.fields ?? {};
+        // Vector sentinel detection (Phase 1.2 lock)
+        const sentinel = fieldsObj['__type__'];
+        if (sentinel?.stringValue === '__vector__') {
+            const arr = fieldsObj['value']?.arrayValue?.values ?? [];
+            return { kind: 'vector', dimension: arr.length };
+        }
+        const fields = {};
+        for (const [k, sub] of Object.entries(fieldsObj)) {
+            fields[k] = descriptorFromObservation(wireValueToObservation(sub));
+        }
+        return { kind: 'map', fields };
+    }
+    throw new Error(`Unrecognized wire value: ${JSON.stringify(Object.keys(v))}`);
+}
+// ─── Wire value → FieldObservation ────────────────────────────────────────
+/**
+ * Full observation including JSON-safe example projection and enum sample
+ * extraction. The merge layer consumes this shape.
+ */
+export function wireValueToObservation(v) {
+    const type = wireValueToFieldType(v);
+    const isNull = type.kind === 'scalar' && type.type === 'null';
+    const example = exampleFromWire(v);
+    const enumSample = enumSampleFromWire(v, type);
+    return { type, isNull, example, enumSample };
+}
+/** Project a wire value into a JSON-safe example. */
+function exampleFromWire(v) {
+    if ('nullValue' in v)
+        return null;
+    if ('booleanValue' in v)
+        return v.booleanValue;
+    if ('stringValue' in v)
+        return v.stringValue;
+    if ('integerValue' in v) {
+        const raw = v.integerValue;
+        // integerValue is wire-encoded as a string (int64). Parse but cap at
+        // safe integer range; outside that, return as-string to preserve.
+        const n = typeof raw === 'string' ? Number(raw) : raw;
+        if (Number.isSafeInteger(n))
+            return n;
+        return String(raw);
+    }
+    if ('doubleValue' in v)
+        return v.doubleValue;
+    // timestamp/bytes/geopoint/reference: not codegen-friendly placeholders;
+    // omit so descriptor.example stays undefined and codegen knows to skip.
+    if ('timestampValue' in v)
+        return undefined;
+    if ('bytesValue' in v)
+        return undefined;
+    if ('geoPointValue' in v)
+        return undefined;
+    if ('referenceValue' in v)
+        return undefined;
+    if ('arrayValue' in v) {
+        const values = v.arrayValue?.values ?? [];
+        const projected = [];
+        for (const e of values) {
+            const proj = exampleFromWire(e);
+            // Skip elements that don't project (e.g., bytes inside an array).
+            // Better than nulling them out — keeps the example shape useful.
+            if (proj !== undefined)
+                projected.push(proj);
+        }
+        return projected;
+    }
+    if ('mapValue' in v) {
+        const fieldsObj = v.mapValue?.fields ?? {};
+        if (fieldsObj['__type__']?.stringValue === '__vector__')
+            return undefined;
+        const out = {};
+        for (const [k, sub] of Object.entries(fieldsObj)) {
+            const proj = exampleFromWire(sub);
+            if (proj !== undefined)
+                out[k] = proj;
+        }
+        return out;
+    }
+    return undefined;
+}
+/** Extract an enum sample if the type is enum-eligible (string/int/double). */
+function enumSampleFromWire(v, type) {
+    if (type.kind !== 'scalar')
+        return undefined;
+    if (type.type === 'string')
+        return v.stringValue;
+    if (type.type === 'integer') {
+        const raw = v.integerValue;
+        const n = typeof raw === 'string' ? Number(raw) : raw;
+        return Number.isSafeInteger(n) ? n : undefined;
+    }
+    if (type.type === 'double')
+        return v.doubleValue;
+    return undefined;
+}
+/** Tiny adapter — turns a single observation into a one-shot descriptor for
+ *  nested map fields. Mirrors what mergeDoc does for first-time keys. */
+function descriptorFromObservation(obs) {
+    const isNull = obs.isNull;
+    return {
+        types: isNull ? [] : [obs.type],
+        presenceSeen: 1,
+        presenceTotal: 1,
+        nullable: isNull,
+        enumCandidate: !isNull &&
+            obs.type.kind === 'scalar' &&
+            (obs.type.type === 'string' ||
+                obs.type.type === 'integer' ||
+                obs.type.type === 'double') &&
+            obs.enumSample !== undefined
+            ? { qualifies: false, values: [obs.enumSample], threshold: 10 }
+            : undefined,
+        example: obs.example,
+    };
+}
+// ─── Reference path parsing ───────────────────────────────────────────────
+/**
+ * Parse a referenceValue string into the full collection path of the target.
+ *
+ * Format: projects/<p>/databases/<d>/documents/<coll>/<doc>[/<coll>/<doc>...]
+ * For `projects/x/databases/(default)/documents/users/uid_1/posts/p_1`,
+ * returns `users/uid_1/posts` (full path, Phase 1.2 lock for unambiguity).
+ *
+ * Note: this is the *literal* path of the observed reference. Callers that
+ * want the template form must substitute doc IDs into wildcards based on
+ * the parent collection's template path.
+ */
+function parseRefTargetCollectionPath(refPath) {
+    const idx = refPath.indexOf('/documents/');
+    if (idx === -1)
+        return refPath; // unparseable; preserve raw
+    const tail = refPath.slice(idx + '/documents/'.length);
+    const segments = tail.split('/');
+    if (segments.length < 2 || segments.length % 2 !== 0)
+        return tail;
+    return segments.slice(0, -1).join('/');
+}
+// ─── Document snapshot → observations ─────────────────────────────────────
+/**
+ * Convert a Firestore document snapshot into a FieldObservation map.
+ * Detects reserved field names per 0.B — they appear in the output but
+ * the descriptor returned by the merge layer carries `reservedReason`
+ * so codegen can skip them.
+ *
+ * Throws `WireProtoUnavailableError` if `_fieldsProto` is absent (0.A
+ * fail-loud contract). Empty docs (proto present but zero keys) return
+ * an empty record without throwing.
+ */
+export function snapshotToObservations(snap) {
+    const proto = snap._fieldsProto;
+    const docPath = snap.ref?.path ?? '<unknown>';
+    if (proto === undefined || proto === null) {
+        throw new WireProtoUnavailableError({
+            docPath,
+            reason: '_fieldsProto is undefined; firebase-admin SDK contract may have changed',
+        });
+    }
+    const observations = {};
+    const reservedNames = {};
+    for (const [k, v] of Object.entries(proto)) {
+        // Sanity check: every value must have a valueType discriminator (or
+        // one of the explicit *Value keys). If neither is present, we're
+        // looking at a shape we don't recognize — fail loud.
+        if (v == null || (typeof v !== 'object')) {
+            throw new WireProtoUnavailableError({
+                docPath,
+                reason: `field "${k}" has non-object proto value (${typeof v}); SDK contract may have changed`,
+            });
+        }
+        if (!hasAnyKnownValueKey(v)) {
+            throw new WireProtoUnavailableError({
+                docPath,
+                reason: `field "${k}" has no recognizable valueType discriminator; SDK contract may have changed`,
+            });
+        }
+        const reason = classifyFieldName(k);
+        if (reason)
+            reservedNames[k] = reason;
+        observations[k] = wireValueToObservation(v);
+    }
+    return { observations, reservedNames };
+}
+const KNOWN_VALUE_KEYS = [
+    'nullValue',
+    'booleanValue',
+    'integerValue',
+    'doubleValue',
+    'timestampValue',
+    'stringValue',
+    'bytesValue',
+    'geoPointValue',
+    'referenceValue',
+    'arrayValue',
+    'mapValue',
+];
+function hasAnyKnownValueKey(v) {
+    for (const k of KNOWN_VALUE_KEYS)
+        if (k in v)
+            return true;
+    // valueType discriminator alone (without a peer *Value key) is NOT
+    // sufficient — some SDK versions emit it but still need the parallel
+    // key for value access.
+    return false;
+}
+//# sourceMappingURL=wire.js.map

package/dist/discover/wire.js.map

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

package/dist/functions-rtdb/child.d.ts

@@ -0,0 +1,52 @@
+import { type ChildProcess } from 'node:child_process';
+export interface SerializedFunctionsRtdbError {
+    name: string;
+    message: string;
+    stack?: string;
+}
+export type FunctionsRtdbChildEvent = {
+    type: 'execution';
+    exportName: string;
+    ref: string;
+    params: Record<string, string>;
+    status: 'fulfilled';
+} | {
+    type: 'execution';
+    exportName: string;
+    ref: string;
+    params: Record<string, string>;
+    status: 'rejected';
+    error: SerializedFunctionsRtdbError;
+} | {
+    type: 'delivery-error';
+    exportName: string;
+    error: SerializedFunctionsRtdbError;
+};
+export interface FunctionsRtdbChildReady {
+    triggerCount: number;
+    unsupportedTriggers: UnsupportedFunctionsTrigger[];
+}
+export interface UnsupportedFunctionsTrigger {
+    exportName: string;
+    eventType: string;
+}
+export interface SpawnFunctionsRtdbChildOptions {
+    cwd: string;
+    entry: string;
+    env: NodeJS.ProcessEnv;
+    instance: string;
+    location: string;
+    databaseHost?: string;
+    childModuleUrl?: string | URL;
+    nodeExecutable?: string;
+    onEvent?(event: FunctionsRtdbChildEvent): void;
+}
+export interface FunctionsRtdbChildHandle {
+    child: ChildProcess;
+    ready: Promise<FunctionsRtdbChildReady>;
+    exited: Promise<number>;
+    stop(): Promise<number>;
+}
+/** Spawn the real Firebase Functions SDK in an isolated Node process. */
+export declare function spawnFunctionsRtdbChild(options: SpawnFunctionsRtdbChildOptions): FunctionsRtdbChildHandle;
+//# sourceMappingURL=child.d.ts.map

package/dist/functions-rtdb/child.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child.d.ts","sourceRoot":"","sources":["../../src/functions-rtdb/child.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAkB9D,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,uBAAuB,GAC/B;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,WAAW,CAAC;CACrB,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,4BAA4B,CAAC;CACrC,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,4BAA4B,CAAC;CACrC,CAAC;AAEN,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,2BAA2B,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,8BAA8B;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACxC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAyBD,yEAAyE;AACzE,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,8BAA8B,GACtC,wBAAwB,CA8F1B"}