@pyric/cli 0.1.0-alpha.9

package/dist/functions-rtdb/child.js

@@ -0,0 +1,283 @@
+import { spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, extname, join, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { startOnValueCreatedExecution, } from './execution.js';
+import { inspectOnValueCreated, listFirebaseEndpoints, } from './discovery.js';
+import { RemoteRtdbTriggerDelivery } from './remote-delivery.js';
+const FORCE_KILL_AFTER_MS = 2_000;
+function serializeError(error) {
+    if (error instanceof Error) {
+        return {
+            name: error.name,
+            message: error.message,
+            ...(error.stack === undefined ? {} : { stack: error.stack }),
+        };
+    }
+    return { name: 'Error', message: String(error) };
+}
+function isChildMessage(value) {
+    return typeof value === 'object' && value !== null && 'type' in value;
+}
+/** Spawn the real Firebase Functions SDK in an isolated Node process. */
+export function spawnFunctionsRtdbChild(options) {
+    const childModuleUrl = options.childModuleUrl ?? new URL('./child.js', import.meta.url);
+    const childModulePath = typeof childModuleUrl === 'string' && !childModuleUrl.startsWith('file:')
+        ? resolve(childModuleUrl)
+        : fileURLToPath(childModuleUrl);
+    const child = spawn(options.nodeExecutable ?? 'node', [childModulePath], {
+        cwd: options.cwd,
+        env: {
+            ...options.env,
+            PYRIC_FUNCTIONS_RTDB_CHILD: '1',
+            PYRIC_FUNCTIONS_ENTRY: resolve(options.entry),
+            PYRIC_FUNCTIONS_INSTANCE: options.instance,
+            PYRIC_FUNCTIONS_LOCATION: options.location,
+            PYRIC_FUNCTIONS_DATABASE_HOST: options.databaseHost ?? 'firebasedatabase.app',
+        },
+        stdio: ['ignore', 'pipe', 'pipe', 'ipc'],
+    });
+    let readySettled = false;
+    let stopping = false;
+    let stderr = '';
+    child.stderr?.setEncoding('utf8');
+    child.stderr?.on('data', (chunk) => {
+        stderr = `${stderr}${chunk}`.slice(-8_192);
+    });
+    let resolveReady;
+    let rejectReady;
+    const ready = new Promise((resolvePromise, rejectPromise) => {
+        resolveReady = resolvePromise;
+        rejectReady = rejectPromise;
+    });
+    child.on('message', (raw) => {
+        if (!isChildMessage(raw))
+            return;
+        if (raw.type === 'ready') {
+            readySettled = true;
+            resolveReady({
+                triggerCount: raw.triggerCount,
+                unsupportedTriggers: raw.unsupportedTriggers,
+            });
+        }
+        else if (raw.type === 'fatal') {
+            if (!readySettled) {
+                readySettled = true;
+                rejectReady(new Error(`Functions RTDB child failed: ${raw.error.stack ?? raw.error.message}`));
+            }
+        }
+        else if (raw.type === 'execution' || raw.type === 'delivery-error') {
+            options.onEvent?.(raw);
+        }
+    });
+    let forceTimer;
+    const exited = new Promise((resolveExited) => {
+        child.once('error', (error) => {
+            if (!readySettled) {
+                readySettled = true;
+                rejectReady(error);
+            }
+        });
+        child.once('close', (code, signal) => {
+            if (forceTimer !== undefined)
+                clearTimeout(forceTimer);
+            const exitCode = typeof code === 'number' ? code : signal ? 1 : 0;
+            if (!readySettled) {
+                readySettled = true;
+                const diagnostic = stderr.trim();
+                rejectReady(new Error(`Functions RTDB child exited before ready (code ${exitCode})` +
+                    (diagnostic ? `\n${diagnostic}` : '')));
+            }
+            resolveExited(exitCode);
+        });
+    });
+    return {
+        child,
+        ready,
+        exited,
+        async stop() {
+            if (child.exitCode !== null || child.signalCode !== null)
+                return exited;
+            if (!stopping) {
+                stopping = true;
+                if (child.connected)
+                    child.send({ type: 'stop' });
+                else
+                    child.kill('SIGTERM');
+                forceTimer = setTimeout(() => {
+                    if (child.exitCode === null && child.signalCode === null)
+                        child.kill('SIGKILL');
+                }, FORCE_KILL_AFTER_MS);
+                forceTimer.unref();
+            }
+            return exited;
+        },
+    };
+}
+function send(message) {
+    process.send?.(message);
+}
+function usesCommonJs(entry) {
+    const extension = extname(entry);
+    if (extension === '.cjs')
+        return true;
+    if (extension === '.mjs')
+        return false;
+    let directory = dirname(entry);
+    while (true) {
+        const packageJsonPath = join(directory, 'package.json');
+        if (existsSync(packageJsonPath)) {
+            const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+            return packageJson.type !== 'module';
+        }
+        const parent = dirname(directory);
+        if (parent === directory)
+            return true;
+        directory = parent;
+    }
+}
+/** Load the entry with the semantics selected by its extension and package scope. */
+async function loadFunctionsExports(entry) {
+    if (usesCommonJs(entry)) {
+        return createRequire(entry)(entry);
+    }
+    return await import(pathToFileURL(entry).href);
+}
+async function runFunctionsRtdbChild() {
+    const entry = process.env.PYRIC_FUNCTIONS_ENTRY;
+    const instance = process.env.PYRIC_FUNCTIONS_INSTANCE;
+    const location = process.env.PYRIC_FUNCTIONS_LOCATION;
+    const databaseHost = process.env.PYRIC_FUNCTIONS_DATABASE_HOST;
+    if (!entry || !instance || !location || !databaseHost) {
+        throw new Error('Functions RTDB child is missing its required environment');
+    }
+    const requireFromEntry = createRequire(entry);
+    const adminApp = requireFromEntry('firebase-admin/app');
+    const app = adminApp.initializeApp();
+    let host;
+    let closing;
+    const close = () => {
+        if (closing)
+            return closing;
+        closing = (async () => {
+            host?.close();
+            await host?.idle();
+            app.sandbox.close();
+            await adminApp.deleteApp(app);
+        })();
+        return closing;
+    };
+    const shutdown = async () => {
+        await close();
+        send({ type: 'stopped' });
+        process.disconnect?.();
+    };
+    process.once('message', (raw) => {
+        if (isChildMessage(raw) && raw.type === 'stopped')
+            return;
+        if (typeof raw === 'object' && raw !== null && 'type' in raw && raw.type === 'stop') {
+            void shutdown().catch((error) => {
+                send({ type: 'fatal', error: serializeError(error) });
+                process.exitCode = 1;
+                process.disconnect?.();
+            });
+        }
+    });
+    process.once('SIGINT', () => void shutdown());
+    process.once('SIGTERM', () => void shutdown());
+    try {
+        // The real database provider asks firebase-admin/app for its default app
+        // when it wraps a raw CloudEvent. Initializing that app before loading the
+        // user's module avoids importing the broad firebase-functions/v2 barrel.
+        const exported = await loadFunctionsExports(entry);
+        const effectiveInstances = [...new Set(inspectOnValueCreated(exported).triggers.map((trigger) => trigger.instance === '*' ? instance : trigger.instance))].sort();
+        if (effectiveInstances.length > 1) {
+            throw new Error('Functions RTDB first slice supports one database instance; found ' +
+                effectiveInstances.join(', '));
+        }
+        host = startOnValueCreatedExecution({
+            exported,
+            delivery: new RemoteRtdbTriggerDelivery(app.sandbox.rtdb),
+            eventOptions: (_projection, sequence, trigger) => ({
+                id: `${randomUUID()}-${sequence}`,
+                time: new Date().toISOString(),
+                instance: trigger.instance === '*' ? instance : trigger.instance,
+                location: trigger.location ?? location,
+                databaseHost,
+            }),
+            onExecution(result, trigger, projection) {
+                sendExecution(result, trigger.exportName, projection.ref, projection.params);
+            },
+            onDeliveryError(error, trigger) {
+                send({
+                    type: 'delivery-error',
+                    exportName: trigger.exportName,
+                    error: serializeError(error),
+                });
+            },
+        });
+        await host.ready;
+        send({
+            type: 'ready',
+            triggerCount: host.triggerCount,
+            unsupportedTriggers: findUnsupportedTriggers(exported),
+        });
+    }
+    catch (error) {
+        await close();
+        throw error;
+    }
+}
+function findUnsupportedTriggers(exported) {
+    const unsupported = [
+        ...inspectOnValueCreated(exported).unsupported,
+    ];
+    for (const { exportName, callable } of listFirebaseEndpoints(exported)) {
+        const endpoint = callable.__endpoint;
+        if (!endpoint)
+            continue;
+        const eventType = endpoint.eventTrigger?.eventType;
+        if (eventType === 'google.firebase.database.ref.v1.created')
+            continue;
+        const label = typeof eventType === 'string'
+            ? eventType
+            : endpoint.callableTrigger !== undefined
+                ? 'callable'
+                : endpoint.httpsTrigger !== undefined
+                    ? 'https'
+                    : endpoint.scheduleTrigger !== undefined
+                        ? 'schedule'
+                        : endpoint.taskQueueTrigger !== undefined
+                            ? 'task-queue'
+                            : 'unknown';
+        unsupported.push({ exportName, eventType: label });
+    }
+    return unsupported;
+}
+function sendExecution(result, exportName, ref, params) {
+    if (result.status === 'fulfilled') {
+        send({ type: 'execution', exportName, ref, params, status: 'fulfilled' });
+    }
+    else {
+        send({
+            type: 'execution',
+            exportName,
+            ref,
+            params,
+            status: 'rejected',
+            error: serializeError(result.error),
+        });
+    }
+}
+if (process.env.PYRIC_FUNCTIONS_RTDB_CHILD === '1') {
+    void runFunctionsRtdbChild().catch((error) => {
+        const serialized = serializeError(error);
+        send({ type: 'fatal', error: serialized });
+        process.stderr.write(`${serialized.stack ?? `${serialized.name}: ${serialized.message}`}\n`);
+        process.exitCode = 1;
+        process.disconnect?.();
+    });
+}
+//# sourceMappingURL=child.js.map

package/dist/functions-rtdb/child.js.map

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

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

@@ -0,0 +1,4 @@
+export interface RtdbTriggerDelivery {
+    subscribe(path: string, listener: (value: unknown) => void, onError?: (error: unknown) => void): () => void;
+}
+//# sourceMappingURL=delivery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../src/functions-rtdb/delivery.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACjC,MAAM,IAAI,CAAC;CACf"}

package/dist/functions-rtdb/delivery.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=delivery.js.map

package/dist/functions-rtdb/delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.js","sourceRoot":"","sources":["../../src/functions-rtdb/delivery.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,41 @@
+export type RtdbCreatedCallable = (rawEvent: Record<string, unknown>) => unknown | Promise<unknown>;
+export interface DiscoveredOnValueCreated {
+    exportName: string;
+    reference: string;
+    instance: string;
+    location?: string;
+    callable: RtdbCreatedCallable;
+}
+export interface UnsupportedOnValueCreated {
+    exportName: string;
+    eventType: string;
+}
+export interface OnValueCreatedInspection {
+    triggers: DiscoveredOnValueCreated[];
+    unsupported: UnsupportedOnValueCreated[];
+}
+export declare const CREATED_EVENT_TYPE = "google.firebase.database.ref.v1.created";
+export type FirebaseEndpointFunction = RtdbCreatedCallable & {
+    __endpoint?: {
+        omit?: unknown;
+        region?: unknown;
+        eventTrigger?: {
+            eventType?: unknown;
+            eventFilters?: Record<string, unknown>;
+            eventFilterPathPatterns?: Record<string, unknown>;
+        };
+        callableTrigger?: unknown;
+        httpsTrigger?: unknown;
+        scheduleTrigger?: unknown;
+        taskQueueTrigger?: unknown;
+    };
+};
+/** Walk exports using the same hyphenated nested names as Firebase's loader. */
+export declare function listFirebaseEndpoints(exported: Record<string, unknown>): Array<{
+    exportName: string;
+    callable: FirebaseEndpointFunction;
+}>;
+/** Classify unchanged v2 RTDB create exports against the admitted first slice. */
+export declare function inspectOnValueCreated(exported: Record<string, unknown>): OnValueCreatedInspection;
+export declare function discoverOnValueCreated(exported: Record<string, unknown>): DiscoveredOnValueCreated[];
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/functions-rtdb/discovery.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,mBAAmB,GAAG,CAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,wBAAwB,EAAE,CAAC;IACrC,WAAW,EAAE,yBAAyB,EAAE,CAAC;CAC1C;AAED,eAAO,MAAM,kBAAkB,4CAA4C,CAAC;AAE5E,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,GAAG;IAC3D,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,YAAY,CAAC,EAAE;YACb,SAAS,CAAC,EAAE,OAAO,CAAC;YACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACvC,uBAAuB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACnD,CAAC;QACF,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,CAAC;CACH,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,wBAAwB,CAAA;CAAE,CAAC,CAqBnE;AAED,kFAAkF;AAClF,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,wBAAwB,CAuD1B;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,wBAAwB,EAAE,CAE5B"}

package/dist/functions-rtdb/discovery.js

@@ -0,0 +1,86 @@
+import { normalizeRtdbReference, supportsRtdbReference, } from './reference-pattern.js';
+export const CREATED_EVENT_TYPE = 'google.firebase.database.ref.v1.created';
+/** Walk exports using the same hyphenated nested names as Firebase's loader. */
+export function listFirebaseEndpoints(exported) {
+    const endpoints = [];
+    const visit = (value, prefix, ancestors) => {
+        if (ancestors.has(value))
+            return;
+        const nestedAncestors = new Set(ancestors).add(value);
+        for (const [name, candidate] of Object.entries(value)) {
+            const exportName = `${prefix}${name}`;
+            const callable = candidate;
+            if (typeof candidate === 'function' && callable.__endpoint) {
+                endpoints.push({ exportName, callable });
+            }
+            else if (typeof candidate === 'object' && candidate !== null) {
+                visit(candidate, `${exportName}-`, nestedAncestors);
+            }
+        }
+    };
+    visit(exported, '', new Set());
+    return endpoints;
+}
+/** Classify unchanged v2 RTDB create exports against the admitted first slice. */
+export function inspectOnValueCreated(exported) {
+    const triggers = [];
+    const unsupported = [];
+    for (const { exportName, callable } of listFirebaseEndpoints(exported)) {
+        const endpoint = callable.__endpoint;
+        const trigger = endpoint?.eventTrigger;
+        if (trigger?.eventType !== CREATED_EVENT_TYPE)
+            continue;
+        if (endpoint?.omit === true) {
+            unsupported.push({
+                exportName,
+                eventType: `${CREATED_EVENT_TYPE} (omitted from emulation)`,
+            });
+            continue;
+        }
+        if (endpoint?.omit !== undefined && endpoint.omit !== false) {
+            unsupported.push({
+                exportName,
+                eventType: `${CREATED_EVENT_TYPE} (unsupported dynamic omit option)`,
+            });
+            continue;
+        }
+        const reference = trigger.eventFilterPathPatterns?.ref;
+        const exactInstance = trigger.eventFilters?.instance;
+        const instancePattern = trigger.eventFilterPathPatterns?.instance;
+        if (typeof reference !== 'string')
+            continue;
+        if (typeof exactInstance !== 'string' && instancePattern !== '*') {
+            if (typeof instancePattern === 'string') {
+                unsupported.push({
+                    exportName,
+                    eventType: `${CREATED_EVENT_TYPE} (unsupported instance pattern: ${instancePattern})`,
+                });
+            }
+            continue;
+        }
+        const instance = typeof exactInstance === 'string' ? exactInstance : '*';
+        if (!supportsRtdbReference(reference)) {
+            unsupported.push({
+                exportName,
+                eventType: `${CREATED_EVENT_TYPE} (unsupported ref pattern: ${reference})`,
+            });
+            continue;
+        }
+        const region = endpoint?.region;
+        const location = Array.isArray(region) && typeof region[0] === 'string'
+            ? region[0]
+            : undefined;
+        triggers.push({
+            exportName,
+            reference: normalizeRtdbReference(reference),
+            instance,
+            ...(location === undefined ? {} : { location }),
+            callable,
+        });
+    }
+    return { triggers, unsupported };
+}
+export function discoverOnValueCreated(exported) {
+    return inspectOnValueCreated(exported).triggers;
+}
+//# sourceMappingURL=discovery.js.map

package/dist/functions-rtdb/discovery.js.map

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

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

@@ -0,0 +1,20 @@
+import { type DiscoveredOnValueCreated } from './discovery.js';
+import type { CreatedValueProjection } from './projection.js';
+export interface CreatedEventOptions {
+    id: string;
+    time: string;
+    instance: string;
+    location: string;
+    databaseHost: string;
+}
+export type CreatedExecutionResult = {
+    status: 'fulfilled';
+    event: Record<string, unknown>;
+} | {
+    status: 'rejected';
+    event: Record<string, unknown>;
+    error: unknown;
+};
+/** Invoke the real Firebase Functions wrapper and await the user's result. */
+export declare function executeOnValueCreated(trigger: DiscoveredOnValueCreated, projection: CreatedValueProjection, options: CreatedEventOptions): Promise<CreatedExecutionResult>;
+//# sourceMappingURL=event.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/functions-rtdb/event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,sBAAsB,GAC9B;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACvD;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAe3E,8EAA8E;AAC9E,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,wBAAwB,EACjC,UAAU,EAAE,sBAAsB,EAClC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CA8BjC"}

package/dist/functions-rtdb/event.js

@@ -0,0 +1,45 @@
+import { CREATED_EVENT_TYPE } from './discovery.js';
+function canonicalizeRtdbValue(value) {
+    if (Array.isArray(value))
+        return value.map(canonicalizeRtdbValue);
+    if (typeof value !== 'object' || value === null)
+        return value;
+    return Object.fromEntries(Object.keys(value)
+        .sort()
+        .map((key) => [
+        key,
+        canonicalizeRtdbValue(value[key]),
+    ]));
+}
+/** Invoke the real Firebase Functions wrapper and await the user's result. */
+export async function executeOnValueCreated(trigger, projection, options) {
+    const event = {
+        specversion: '1.0',
+        id: options.id,
+        // RTDB CloudEvents use the provider resource and a `_` project segment;
+        // the concrete database identity lives in `instances/<instance>`.
+        source: '//firebasedatabase.googleapis.com/projects/_' +
+            `/locations/${options.location}/instances/${options.instance}`,
+        subject: `refs/${projection.ref}`,
+        type: CREATED_EVENT_TYPE,
+        time: options.time,
+        location: options.location,
+        instance: options.instance,
+        ref: projection.ref,
+        firebasedatabasehost: options.databaseHost,
+        authtype: 'unknown',
+        authid: null,
+        data: {
+            data: null,
+            delta: canonicalizeRtdbValue(projection.value),
+        },
+    };
+    try {
+        await trigger.callable(event);
+        return { status: 'fulfilled', event };
+    }
+    catch (error) {
+        return { status: 'rejected', event, error };
+    }
+}
+//# sourceMappingURL=event.js.map

package/dist/functions-rtdb/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/functions-rtdb/event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAiC,MAAM,gBAAgB,CAAC;AAenF,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAClE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC;SAC1C,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;QACZ,GAAG;QACH,qBAAqB,CAAE,KAAiC,CAAC,GAAG,CAAC,CAAC;KAC/D,CAAC,CACL,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAiC,EACjC,UAAkC,EAClC,OAA4B;IAE5B,MAAM,KAAK,GAA4B;QACrC,WAAW,EAAE,KAAK;QAClB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,wEAAwE;QACxE,kEAAkE;QAClE,MAAM,EACJ,8CAA8C;YAC9C,cAAc,OAAO,CAAC,QAAQ,cAAc,OAAO,CAAC,QAAQ,EAAE;QAChE,OAAO,EAAE,QAAQ,UAAU,CAAC,GAAG,EAAE;QACjC,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,EAAE,UAAU,CAAC,GAAG;QACnB,oBAAoB,EAAE,OAAO,CAAC,YAAY;QAC1C,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE;YACJ,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,qBAAqB,CAAC,UAAU,CAAC,KAAK,CAAC;SAC/C;KACF,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC9C,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,20 @@
+import { type DiscoveredOnValueCreated } from './discovery.js';
+import type { RtdbTriggerDelivery } from './delivery.js';
+import { type CreatedEventOptions, type CreatedExecutionResult } from './event.js';
+import { type CreatedValueProjection } from './projection.js';
+export interface OnValueCreatedExecutionOptions {
+    exported: Record<string, unknown>;
+    delivery: RtdbTriggerDelivery;
+    eventOptions(projection: CreatedValueProjection, sequence: number, trigger: DiscoveredOnValueCreated): CreatedEventOptions;
+    onExecution?(result: CreatedExecutionResult, trigger: DiscoveredOnValueCreated, projection: CreatedValueProjection): void;
+    onDeliveryError?(error: unknown, trigger: DiscoveredOnValueCreated): void;
+}
+export interface OnValueCreatedExecutionHost {
+    readonly triggerCount: number;
+    readonly ready: Promise<void>;
+    idle(): Promise<void>;
+    close(): void;
+}
+/** Subscribe discovered functions and serialize their snapshot executions. */
+export declare function startOnValueCreatedExecution(options: OnValueCreatedExecutionOptions): OnValueCreatedExecutionHost;
+//# sourceMappingURL=execution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/functions-rtdb/execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC5B,MAAM,YAAY,CAAC;AACpB,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,YAAY,CACV,UAAU,EAAE,sBAAsB,EAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,wBAAwB,GAChC,mBAAmB,CAAC;IACvB,WAAW,CAAC,CACV,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,wBAAwB,EACjC,UAAU,EAAE,sBAAsB,GACjC,IAAI,CAAC;IACR,eAAe,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAC3E;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,8EAA8E;AAC9E,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,8BAA8B,GACtC,2BAA2B,CAuE7B"}

package/dist/functions-rtdb/execution.js

@@ -0,0 +1,70 @@
+import { discoverOnValueCreated } from './discovery.js';
+import { executeOnValueCreated, } from './event.js';
+import { projectValueCreates, watchPath, } from './projection.js';
+/** Subscribe discovered functions and serialize their snapshot executions. */
+export function startOnValueCreatedExecution(options) {
+    const triggers = discoverOnValueCreated(options.exported);
+    const unsubscribe = [];
+    let closed = false;
+    let sequence = 0;
+    let tail = Promise.resolve();
+    let baselinesRemaining = triggers.length;
+    let readinessFailed = false;
+    let markReady;
+    let failReady;
+    const ready = new Promise((resolve, reject) => {
+        markReady = resolve;
+        failReady = reject;
+    });
+    if (baselinesRemaining === 0)
+        markReady();
+    for (const trigger of triggers) {
+        const path = watchPath(trigger.reference);
+        let hasBaseline = false;
+        let previous;
+        unsubscribe.push(options.delivery.subscribe(path, (next) => {
+            if (closed)
+                return;
+            if (!hasBaseline) {
+                previous = next;
+                hasBaseline = true;
+                baselinesRemaining -= 1;
+                if (baselinesRemaining === 0 && !readinessFailed)
+                    markReady();
+                return;
+            }
+            const before = previous;
+            previous = next;
+            for (const projection of projectValueCreates(trigger.reference, {
+                path,
+                before,
+                after: next,
+            })) {
+                const deliverySequence = ++sequence;
+                tail = tail.then(async () => {
+                    const result = await executeOnValueCreated(trigger, projection, options.eventOptions(projection, deliverySequence, trigger));
+                    options.onExecution?.(result, trigger, projection);
+                });
+            }
+        }, (error) => {
+            if (!hasBaseline && !readinessFailed) {
+                readinessFailed = true;
+                failReady(error);
+            }
+            options.onDeliveryError?.(error, trigger);
+        }));
+    }
+    return {
+        triggerCount: triggers.length,
+        ready,
+        idle: () => tail,
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            for (const stop of unsubscribe.splice(0))
+                stop();
+        },
+    };
+}
+//# sourceMappingURL=execution.js.map

package/dist/functions-rtdb/execution.js.map

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

package/dist/functions-rtdb/in-memory-delivery.d.ts

@@ -0,0 +1,9 @@
+import type { RtdbTriggerDelivery } from './delivery.js';
+/** Deterministic test adapter for the snapshot-delivery seam. */
+export declare class InMemoryRtdbTriggerDelivery implements RtdbTriggerDelivery {
+    #private;
+    seed(path: string, value: unknown): void;
+    emit(path: string, value: unknown): void;
+    subscribe(path: string, listener: (value: unknown) => void): () => void;
+}
+//# sourceMappingURL=in-memory-delivery.d.ts.map

package/dist/functions-rtdb/in-memory-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-delivery.d.ts","sourceRoot":"","sources":["../../src/functions-rtdb/in-memory-delivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAOzD,iEAAiE;AACjE,qBAAa,2BAA4B,YAAW,mBAAmB;;IAIrE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAIxC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IASxC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;CAcxE"}