@intuitionrobotics/firebase 2.0.12 → 2.1.1

package/dist/app-backend/FirebaseModule.d.ts

@@ -18,10 +18,10 @@ type ConfigType = {
 export declare class FirebaseModule_Class extends Module<ConfigType> {
     private readonly adminSessions;
     static localAdminConfigId: string;
-    private localProjectId;
+    private _localProjectId?;
     constructor();
-    protected init(): void;
     getLocalProjectId(): string;
+    private getLocalProjectIdSafe;
     private deriveLocalProjectId;
     protected connect(): Promise<void>;
     protected disconnect(): Promise<void>;

package/dist/app-backend/FirebaseModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FirebaseModule.d.ts","sourceRoot":"","sources":["../../src/main/app-backend/FirebaseModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,MAAM,EAET,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAC,qBAAqB,EAAC,MAAM,iCAAiC,CAAC;AAEtE,OAAO,EAAC,KAAK,uBAAuB,EAAC,MAAM,4BAA4B,CAAC;AAExE,MAAM,MAAM,QAAQ,GAAG;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAA;AACD,KAAK,UAAU,GAAG;IACd,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,uBAAuB,CAAC;CAC5D,CAAC;AAEF,qBAAa,oBACT,SAAQ,MAAM,CAAC,UAAU,CAAC;IAG1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+C;IAC7E,OAAc,kBAAkB,EAAE,MAAM,CAAC;IACzC,OAAO,CAAC,cAAc,CAAU;;IAQhC,SAAS,CAAC,IAAI,IAAI,IAAI;IAItB,iBAAiB,IAAI,MAAM;IAI3B,OAAO,CAAC,oBAAoB;IAoB5B,SAAS,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC,SAAS,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM9B,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IA4BpE,cAAc,CAAC,SAAS,EAAE,MAAM;CAGnC;AAED,eAAO,MAAM,cAAc,sBAA6B,CAAC"}
+{"version":3,"file":"FirebaseModule.d.ts","sourceRoot":"","sources":["../../src/main/app-backend/FirebaseModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,MAAM,EAET,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAC,qBAAqB,EAAC,MAAM,iCAAiC,CAAC;AAEtE,OAAO,EAAC,KAAK,uBAAuB,EAAC,MAAM,4BAA4B,CAAC;AAExE,MAAM,MAAM,QAAQ,GAAG;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAA;AACD,KAAK,UAAU,GAAG;IACd,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,uBAAuB,CAAC;CAC5D,CAAC;AAEF,qBAAa,oBACT,SAAQ,MAAM,CAAC,UAAU,CAAC;IAG1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+C;IAC7E,OAAc,kBAAkB,EAAE,MAAM,CAAC;IAEzC,OAAO,CAAC,eAAe,CAAC,CAAS;;IAMjC,iBAAiB,IAAI,MAAM;IAI3B,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,oBAAoB;IAoB5B,SAAS,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC,SAAS,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM9B,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IA6BpE,cAAc,CAAC,SAAS,EAAE,MAAM;CAGnC;AAED,eAAO,MAAM,cAAc,sBAA6B,CAAC"}

package/dist/app-backend/FirebaseModule.js

@@ -6,17 +6,21 @@ export class FirebaseModule_Class extends Module {
     // private readonly tokenSessions: { [s: string]: FirebaseSession_UserPassword; } = {};
     adminSessions = {};
     static localAdminConfigId;
-    localProjectId;
+    // Derived lazily on first use (was eagerly set in init()).
+    _localProjectId;
     constructor() {
         super("FirebaseModule");
-        if (process.env.GCLOUD_PROJECT)
-            this.localProjectId = process.env.GCLOUD_PROJECT;
-    }
-    init() {
-        this.localProjectId = this.deriveLocalProjectId();
     }
     getLocalProjectId() {
-        return this.localProjectId;
+        return this._localProjectId ??= this.deriveLocalProjectId();
+    }
+    getLocalProjectIdSafe() {
+        try {
+            return this.getLocalProjectId();
+        }
+        catch (_e) {
+            return undefined;
+        }
     }
     deriveLocalProjectId() {
         let projectId;
@@ -46,14 +50,15 @@ export class FirebaseModule_Class extends Module {
     createAdminSession(_projectId, _sessionName) {
         let projectId = _projectId;
         if (!projectId)
-            projectId = this.localProjectId;
+            projectId = this.getLocalProjectId();
         const sessionName = _sessionName || projectId || "local-admin";
         let session = this.adminSessions[sessionName];
         if (session)
             return session;
         this.logInfo(`Creating Firebase session for project id: ${projectId}`);
         let config = this.getProjectAuth(projectId);
-        if (!config && _projectId && this.localProjectId && this.localProjectId !== _projectId)
+        const localProjectId = this.getLocalProjectIdSafe();
+        if (!config && _projectId && localProjectId && localProjectId !== _projectId)
             throw new BadImplementationException(`Config for key ${_projectId} is not defined`);
         if (typeof config === "string")
             config = JSON.parse(readFileSync(config, "utf8"));

package/dist/app-backend/FirebaseModule.js.map

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

package/dist/app-backend/functions/firebase-function-core.d.ts

@@ -0,0 +1,105 @@
+import * as functionsV1 from "firebase-functions/v1";
+import { type CloudFunction, type HttpsFunction } from "firebase-functions/v1";
+import { type HttpsFunction as HttpsFunctionV2 } from "firebase-functions/v2/https";
+import { type MemoryOption } from "firebase-functions/v2/options";
+import type { CloudFunction as CloudFunctionV2 } from "firebase-functions/v2/core";
+import { Module } from "@intuitionrobotics/ts-common";
+/**
+ * Which Cloud Functions generation a function deploys as.
+ *  - "v1": legacy gen-1 (HTTPS, Pub/Sub-backed scheduler, classic event triggers)
+ *  - "v2": gen-2 (Cloud Run backed) — the modern default
+ */
+export type FunctionGeneration = "v1" | "v2";
+export declare const setDefaultFunctionGeneration: (generation: FunctionGeneration) => void;
+export declare const getDefaultFunctionGeneration: () => FunctionGeneration;
+/**
+ * Memory units accepted by the neutral options. Both v1 ("1GB") and
+ * v2 ("1GiB") spellings are tolerated and translated to the active generation.
+ */
+export type FirebaseFunctionMemory = "128MiB" | "256MiB" | "512MiB" | "1GiB" | "2GiB" | "4GiB" | "8GiB" | "16GiB" | "32GiB" | "128MB" | "256MB" | "512MB" | "1GB" | "2GB" | "4GB" | "8GB";
+/**
+ * SDK-version-neutral runtime options. Replaces the v1-only `RuntimeOptions`
+ * in the public surface — each generation translates this to its own option shape.
+ */
+export type FirebaseFunctionOptions = {
+    generation?: FunctionGeneration;
+    region?: string | string[];
+    memory?: FirebaseFunctionMemory;
+    timeoutSeconds?: number;
+    minInstances?: number;
+    maxInstances?: number;
+    /** v2-only; ignored under v1. */
+    concurrency?: number;
+    serviceAccount?: string;
+    /** Names of secrets to bind (v2 Secret Manager / v1 runtime secrets). */
+    secrets?: string[];
+    labels?: Record<string, string>;
+};
+/** Any value the Firebase CLI can deploy — covers both generations' return types. */
+export type DeployableFunction = HttpsFunction | CloudFunction<any> | HttpsFunctionV2 | CloudFunctionV2<any>;
+/** Bootstrap config applied once at startup (see {@link configureFirebaseFunctionsRuntime}). */
+export type FirebaseFunctionsRuntimeConfig = {
+    /** Pin the deploy region (matches the frontend's hardcoded cloudfunctions.net host). */
+    region?: string | string[];
+    /** Override the repo-wide default generation. */
+    defaultGeneration?: FunctionGeneration;
+};
+/**
+ * Call once at process startup (e.g. in the app's index.ts) before functions are built.
+ * Pins the region for both generations and optionally sets the default generation.
+ */
+export declare function configureFirebaseFunctionsRuntime(config: FirebaseFunctionsRuntimeConfig): void;
+export interface FirebaseFunctionInterface {
+    onDestroy: (() => Promise<void>)[];
+    getFunction(): DeployableFunction;
+    addOnStart(onStart: () => Promise<void>): void;
+    addOnDestroy(onDestroy: () => Promise<void>): void;
+}
+/** Neutral event-context — both v1 `EventContext` and the v2 CloudEvent shim satisfy it. */
+export type FirebaseEventContext = {
+    eventId?: string;
+    timestamp?: string;
+    eventType?: string;
+    resource?: any;
+    params?: {
+        [option: string]: any;
+    };
+    [key: string]: any;
+};
+export declare function getFormattedFunctionName(name: string): string;
+export declare function buildLabels(name: string, type: string, generation: FunctionGeneration): Record<string, string>;
+/** Runs every onStart hook, then the work, then (always) every onDestroy hook. */
+export declare function runLifecycle<T>(onStart: (() => Promise<void>)[], onDestroy: (() => Promise<void>)[], work: () => Promise<T>): Promise<T | void>;
+export type CommonV2Options = {
+    region?: string;
+    memory?: MemoryOption;
+    timeoutSeconds?: number;
+    minInstances?: number;
+    maxInstances?: number;
+    concurrency?: number;
+    serviceAccount?: string;
+    secrets?: string[];
+    labels?: Record<string, string>;
+};
+/** Build a region-scoped v1 FunctionBuilder with the translated RuntimeOptions + labels. */
+export declare function v1Builder(options: FirebaseFunctionOptions, labels: Record<string, string>): functionsV1.FunctionBuilder;
+/** Translate neutral options to a v2 options object (spread into each trigger's options). */
+export declare function toV2Options(options: FirebaseFunctionOptions, labels: Record<string, string>): CommonV2Options;
+export declare abstract class FirebaseFunction<Config = any> extends Module<Config> implements FirebaseFunctionInterface {
+    onDestroy: (() => Promise<void>)[];
+    onStart: (() => Promise<void>)[];
+    protected options: FirebaseFunctionOptions;
+    private generationOverride?;
+    constructor(name: string, onStart?: () => Promise<void>, onDestroy?: () => Promise<void>, options?: FirebaseFunctionOptions);
+    abstract getFunction(): DeployableFunction;
+    protected get generation(): FunctionGeneration;
+    /** Override the generation for this function only. */
+    setGeneration(generation: FunctionGeneration): this;
+    /** Merge in runtime options (memory, region, instances, secrets, generation, ...). */
+    setOptions(options: FirebaseFunctionOptions): this;
+    protected labels(type: string): Record<string, string>;
+    protected runLifecycle<T>(work: () => Promise<T>): Promise<void | T>;
+    addOnStart(onStart: () => Promise<void>): void;
+    addOnDestroy(onDestroy: () => Promise<void>): void;
+}
+//# sourceMappingURL=firebase-function-core.d.ts.map

package/dist/app-backend/functions/firebase-function-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase-function-core.d.ts","sourceRoot":"","sources":["../../../src/main/app-backend/functions/firebase-function-core.ts"],"names":[],"mappings":"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"}

package/dist/app-backend/functions/firebase-function-core.js

@@ -0,0 +1,162 @@
+// Shared infrastructure for the Firebase Function abstraction: the generation
+// switch, SDK-neutral options + v1/v2 translators, lifecycle/label helpers and
+// the FirebaseFunction base class. Each trigger family lives in its own sibling
+// module (firebase-function-<trigger>.ts) and imports from here, so a bundled
+// consumer that uses only one trigger never pulls in the others' v2 SDK subpaths.
+import * as functionsV1 from "firebase-functions/v1";
+import {} from "firebase-functions/v1";
+import {} from "firebase-functions/v2/https";
+import { setGlobalOptions } from "firebase-functions/v2/options";
+import { Module } from "@intuitionrobotics/ts-common";
+/**
+ * Repo-wide default generation. New functions deploy as this unless they
+ * override it (per instance via FirebaseFunction.setGeneration / options,
+ * or globally via {@link setDefaultFunctionGeneration}).
+ *
+ * One-line rollback: `setDefaultFunctionGeneration("v1")` and redeploy.
+ */
+let DEFAULT_GENERATION = "v2";
+export const setDefaultFunctionGeneration = (generation) => {
+    DEFAULT_GENERATION = generation;
+};
+export const getDefaultFunctionGeneration = () => DEFAULT_GENERATION;
+/** Region applied to v1 functions (v2 uses setGlobalOptions); set via {@link configureFirebaseFunctionsRuntime}. */
+let DEFAULT_REGION;
+/**
+ * Call once at process startup (e.g. in the app's index.ts) before functions are built.
+ * Pins the region for both generations and optionally sets the default generation.
+ */
+export function configureFirebaseFunctionsRuntime(config) {
+    if (config.defaultGeneration)
+        setDefaultFunctionGeneration(config.defaultGeneration);
+    if (config.region) {
+        DEFAULT_REGION = config.region;
+        // v2 global region is a single region; multi-region requires per-function (HTTPS only).
+        setGlobalOptions({ region: Array.isArray(config.region) ? config.region[0] : config.region });
+    }
+}
+// --- shared helpers (used by every trigger module) ----------------------------
+export function getFormattedFunctionName(name) {
+    return name.replace(/([A-Z])/g, "_$1").toLowerCase().replace(/\s/g, "_");
+}
+export function buildLabels(name, type, generation) {
+    return {
+        infra: "thunderstorm",
+        function_name: getFormattedFunctionName(name),
+        type,
+        version: generation
+    };
+}
+/** Runs every onStart hook, then the work, then (always) every onDestroy hook. */
+export async function runLifecycle(onStart, onDestroy, work) {
+    try {
+        for (const _onStart of onStart)
+            await _onStart();
+        return await work();
+    }
+    finally {
+        for (const _onDestroy of onDestroy)
+            await _onDestroy();
+    }
+}
+const V1_MEMORY = {
+    "128MB": "128MB", "256MB": "256MB", "512MB": "512MB", "1GB": "1GB", "2GB": "2GB", "4GB": "4GB", "8GB": "8GB",
+    "128MiB": "128MB", "256MiB": "256MB", "512MiB": "512MB", "1GiB": "1GB", "2GiB": "2GB", "4GiB": "4GB",
+    "8GiB": "8GB", "16GiB": "8GB", "32GiB": "8GB"
+};
+const V2_MEMORY = {
+    "128MiB": "128MiB", "256MiB": "256MiB", "512MiB": "512MiB", "1GiB": "1GiB", "2GiB": "2GiB", "4GiB": "4GiB",
+    "8GiB": "8GiB", "16GiB": "16GiB", "32GiB": "32GiB",
+    "128MB": "128MiB", "256MB": "256MiB", "512MB": "512MiB", "1GB": "1GiB", "2GB": "2GiB", "4GB": "4GiB", "8GB": "8GiB"
+};
+/** Build a region-scoped v1 FunctionBuilder with the translated RuntimeOptions + labels. */
+export function v1Builder(options, labels) {
+    const runtimeOptions = { labels };
+    if (options.memory)
+        runtimeOptions.memory = V1_MEMORY[options.memory];
+    if (options.timeoutSeconds !== undefined)
+        runtimeOptions.timeoutSeconds = options.timeoutSeconds;
+    if (options.minInstances !== undefined)
+        runtimeOptions.minInstances = options.minInstances;
+    if (options.maxInstances !== undefined)
+        runtimeOptions.maxInstances = options.maxInstances;
+    if (options.serviceAccount)
+        runtimeOptions.serviceAccount = options.serviceAccount;
+    if (options.secrets)
+        runtimeOptions.secrets = options.secrets;
+    const region = options.region ?? DEFAULT_REGION;
+    const regions = region ? (Array.isArray(region) ? region : [region]) : undefined;
+    const base = regions ? functionsV1.region(...regions) : functionsV1;
+    return base.runWith(runtimeOptions);
+}
+/** Translate neutral options to a v2 options object (spread into each trigger's options). */
+export function toV2Options(options, labels) {
+    const v2 = { labels };
+    if (options.memory)
+        v2.memory = V2_MEMORY[options.memory];
+    // global region already set; this is a per-fn override. v2 non-HTTPS triggers take a single region.
+    if (options.region)
+        v2.region = Array.isArray(options.region) ? options.region[0] : options.region;
+    if (options.timeoutSeconds !== undefined)
+        v2.timeoutSeconds = options.timeoutSeconds;
+    if (options.minInstances !== undefined)
+        v2.minInstances = options.minInstances;
+    if (options.maxInstances !== undefined)
+        v2.maxInstances = options.maxInstances;
+    if (options.concurrency !== undefined)
+        v2.concurrency = options.concurrency;
+    if (options.serviceAccount)
+        v2.serviceAccount = options.serviceAccount;
+    if (options.secrets)
+        v2.secrets = options.secrets;
+    return v2;
+}
+// --- base class ---------------------------------------------------------------
+export class FirebaseFunction extends Module {
+    onDestroy = [];
+    onStart = [];
+    options;
+    generationOverride;
+    constructor(name, onStart, onDestroy, options = {}) {
+        super(name);
+        this.options = options;
+        this.generationOverride = options.generation;
+        if (onStart)
+            this.onStart.push(onStart);
+        if (onDestroy)
+            this.onDestroy.push(onDestroy);
+    }
+    // Resolved lazily (not in the constructor) so the repo-wide default set by
+    // configureFirebaseFunctionsRuntime() at startup wins, regardless of the
+    // order module singletons happen to be constructed in.
+    get generation() {
+        return this.generationOverride ?? DEFAULT_GENERATION;
+    }
+    /** Override the generation for this function only. */
+    setGeneration(generation) {
+        this.generationOverride = generation;
+        return this;
+    }
+    /** Merge in runtime options (memory, region, instances, secrets, generation, ...). */
+    setOptions(options) {
+        this.options = { ...this.options, ...options };
+        if (options.generation)
+            this.generationOverride = options.generation;
+        return this;
+    }
+    labels(type) {
+        return buildLabels(this.getName(), type, this.generation);
+    }
+    runLifecycle(work) {
+        return runLifecycle(this.onStart, this.onDestroy, work);
+    }
+    addOnStart(onStart) {
+        this.onStart.push(onStart);
+    }
+    ;
+    addOnDestroy(onDestroy) {
+        this.onDestroy.push(onDestroy);
+    }
+    ;
+}
+//# sourceMappingURL=firebase-function-core.js.map

package/dist/app-backend/functions/firebase-function-core.js.map

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

package/dist/app-backend/functions/firebase-function-database.d.ts

@@ -0,0 +1,10 @@
+import { type DeployableFunction, FirebaseFunction } from "./firebase-function-core.js";
+export declare abstract class FirebaseFunctionModule<DataType = any, Config = any> extends FirebaseFunction<Config> {
+    private readonly listeningPath;
+    protected constructor(listeningPath: string, name: string, onStart?: () => Promise<void>, onDestroy?: () => Promise<void>);
+    abstract processChanges(before: DataType, after: DataType, params: {
+        [param: string]: any;
+    }): Promise<any>;
+    getFunction: () => DeployableFunction;
+}
+//# sourceMappingURL=firebase-function-database.d.ts.map

package/dist/app-backend/functions/firebase-function-database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase-function-database.d.ts","sourceRoot":"","sources":["../../../src/main/app-backend/functions/firebase-function-database.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,KAAK,kBAAkB,EAAE,gBAAgB,EAAyB,MAAM,6BAA6B,CAAC;AAI9G,8BAAsB,sBAAsB,CAAC,QAAQ,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG,CACrE,SAAQ,gBAAgB,CAAC,MAAM,CAAC;IAEhC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC,SAAS,aAAa,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAOzH,QAAQ,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE;QAAE,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAE1G,WAAW,QAAO,kBAAkB,CAmBlC;CACL"}

package/dist/app-backend/functions/firebase-function-database.js

@@ -0,0 +1,30 @@
+import { Change } from "firebase-functions/v1";
+import { onValueWritten } from "firebase-functions/v2/database";
+import { deepClone } from "@intuitionrobotics/ts-common";
+import { FirebaseFunction, toV2Options, v1Builder } from "./firebase-function-core.js";
+export class FirebaseFunctionModule extends FirebaseFunction {
+    listeningPath;
+    constructor(listeningPath, name, onStart, onDestroy) {
+        super(name);
+        this.listeningPath = listeningPath;
+        if (onStart)
+            this.addOnStart(onStart);
+        if (onDestroy)
+            this.addOnDestroy(onDestroy);
+    }
+    getFunction = () => {
+        const labels = this.labels("realtime-db-listener");
+        if (this.generation === "v1")
+            return v1Builder(this.options, labels).database.ref(this.listeningPath).onWrite(async (change, context) => this.runLifecycle(async () => {
+                const before = change.before && change.before.val();
+                const after = change.after && change.after.val();
+                return this.processChanges(before, after, deepClone(context.params));
+            }));
+        return onValueWritten({ ...toV2Options(this.options, labels), ref: this.listeningPath }, async (event) => this.runLifecycle(async () => {
+            const before = event.data.before && event.data.before.val();
+            const after = event.data.after && event.data.after.val();
+            return this.processChanges(before, after, deepClone(event.params));
+        }));
+    };
+}
+//# sourceMappingURL=firebase-function-database.js.map

package/dist/app-backend/functions/firebase-function-database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase-function-database.js","sourceRoot":"","sources":["../../../src/main/app-backend/functions/firebase-function-database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAmC,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAC,cAAc,EAAC,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAC,SAAS,EAAC,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAA0B,gBAAgB,EAAE,WAAW,EAAE,SAAS,EAAC,MAAM,6BAA6B,CAAC;AAI9G,MAAM,OAAgB,sBAClB,SAAQ,gBAAwB;IAEf,aAAa,CAAS;IAEvC,YAAsB,aAAqB,EAAE,IAAY,EAAE,OAA6B,EAAE,SAA+B;QACrH,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,OAAO;YAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,SAAS;YAAE,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;IAID,WAAW,GAAG,GAAuB,EAAE;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAEnD,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;YACxB,OAAO,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,CAC3E,KAAK,EAAE,MAA4B,EAAE,OAAqB,EAAE,EAAE,CAC1D,IAAI,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE;gBACzB,MAAM,MAAM,GAAa,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;gBAC9D,MAAM,KAAK,GAAa,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;gBAC3D,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YACzE,CAAC,CAAC,CAAC,CAAC;QAEhB,OAAO,cAAc,CAAC,EAAC,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,aAAa,EAAC,EACjF,KAAK,EAAE,KAAK,EAAE,EAAE,CACZ,IAAI,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE;YACzB,MAAM,MAAM,GAAa,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YACtE,MAAM,KAAK,GAAa,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YACnE,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC,CAAC;IAChB,CAAC,CAAC;CACL"}

package/dist/app-backend/functions/firebase-function-express.d.ts

@@ -0,0 +1,18 @@
+import { type Express } from "express";
+import { type DeployableFunction, type FirebaseFunctionInterface, type FirebaseFunctionOptions } from "./firebase-function-core.js";
+export declare class Firebase_ExpressFunction implements FirebaseFunctionInterface {
+    private readonly express;
+    private readonly name;
+    private readonly options;
+    private readonly generationOverride?;
+    onDestroy: (() => Promise<void>)[];
+    onStart: (() => Promise<void>)[];
+    constructor(_express: Express, name?: string, onStart?: () => Promise<void>, onDestroy?: () => Promise<void>, options?: FirebaseFunctionOptions);
+    private get generation();
+    addOnStart(onStart: () => Promise<void>): void;
+    addOnDestroy(onDestroy: () => Promise<void>): void;
+    getName(): string;
+    getFunction: () => DeployableFunction;
+    private runLifecycleAndExpress;
+}
+//# sourceMappingURL=firebase-function-express.d.ts.map

package/dist/app-backend/functions/firebase-function-express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase-function-express.d.ts","sourceRoot":"","sources":["../../../src/main/app-backend/functions/firebase-function-express.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,OAAO,EAA8B,MAAM,SAAS,CAAC;AAElE,OAAO,EAEH,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAM/B,MAAM,6BAA6B,CAAC;AAErC,qBAAa,wBACT,YAAW,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAqB;IACzD,SAAS,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAM;IACxC,OAAO,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAM;gBAE1B,QAAQ,EAAE,OAAO,EAAE,IAAI,SAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,GAAE,uBAA4B;IASlJ,OAAO,KAAK,UAAU,GAErB;IAEM,UAAU,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI9C,YAAY,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIzD,OAAO;IAIP,WAAW,QAAO,kBAAkB,CASlC;IAEF,OAAO,CAAC,sBAAsB;CAGjC"}

package/dist/app-backend/functions/firebase-function-express.js

@@ -0,0 +1,46 @@
+import {} from "express";
+import { onRequest } from "firebase-functions/v2/https";
+import { buildLabels, getDefaultFunctionGeneration, runLifecycle, toV2Options, v1Builder } from "./firebase-function-core.js";
+export class Firebase_ExpressFunction {
+    express;
+    name;
+    options;
+    generationOverride;
+    onDestroy = [];
+    onStart = [];
+    constructor(_express, name = "api", onStart, onDestroy, options = {}) {
+        this.express = _express;
+        this.name = name;
+        this.options = options;
+        this.generationOverride = options.generation;
+        if (onStart)
+            this.onStart.push(onStart);
+        if (onDestroy)
+            this.onDestroy.push(onDestroy);
+    }
+    get generation() {
+        return this.generationOverride ?? getDefaultFunctionGeneration();
+    }
+    addOnStart(onStart) {
+        this.onStart.push(onStart);
+    }
+    ;
+    addOnDestroy(onDestroy) {
+        this.onDestroy.push(onDestroy);
+    }
+    ;
+    getName() {
+        return this.name;
+    }
+    getFunction = () => {
+        const labels = buildLabels(this.getName(), "https", this.generation);
+        const handler = async (req, resp) => this.runLifecycleAndExpress(req, resp);
+        if (this.generation === "v1")
+            return v1Builder(this.options, labels).https.onRequest(handler);
+        return onRequest(toV2Options(this.options, labels), handler);
+    };
+    runLifecycleAndExpress(req, resp) {
+        return runLifecycle(this.onStart, this.onDestroy, async () => this.express(req, resp));
+    }
+}
+//# sourceMappingURL=firebase-function-express.js.map

package/dist/app-backend/functions/firebase-function-express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase-function-express.js","sourceRoot":"","sources":["../../../src/main/app-backend/functions/firebase-function-express.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2C,MAAM,SAAS,CAAC;AAClE,OAAO,EAAC,SAAS,EAAC,MAAM,6BAA6B,CAAC;AACtD,OAAO,EACH,WAAW,EAKX,4BAA4B,EAC5B,YAAY,EACZ,WAAW,EACX,SAAS,EACZ,MAAM,6BAA6B,CAAC;AAErC,MAAM,OAAO,wBAAwB;IAEhB,OAAO,CAAU;IACjB,IAAI,CAAS;IACb,OAAO,CAA0B;IACjC,kBAAkB,CAAsB;IACzD,SAAS,GAA4B,EAAE,CAAC;IACxC,OAAO,GAA4B,EAAE,CAAC;IAEtC,YAAY,QAAiB,EAAE,IAAI,GAAG,KAAK,EAAE,OAA6B,EAAE,SAA+B,EAAE,UAAmC,EAAE;QAC9I,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;QAC7C,IAAI,OAAO;YAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,SAAS;YAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAED,IAAY,UAAU;QAClB,OAAO,IAAI,CAAC,kBAAkB,IAAI,4BAA4B,EAAE,CAAC;IACrE,CAAC;IAEM,UAAU,CAAC,OAA4B;QAC1C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAA,CAAC;IAEK,YAAY,CAAC,SAA8B;QAC9C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAAA,CAAC;IAEF,OAAO;QACH,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,WAAW,GAAG,GAAuB,EAAE;QACnC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,KAAK,EAAE,GAAY,EAAE,IAAc,EAAE,EAAE,CACnD,IAAI,CAAC,sBAAsB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAE3C,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;YACxB,OAAO,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAEpE,OAAO,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC,CAAC;IAEM,sBAAsB,CAAC,GAAY,EAAE,IAAc;QACvD,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IAC3F,CAAC;CACJ"}

package/dist/app-backend/functions/firebase-function-firestore.d.ts

@@ -0,0 +1,13 @@
+import { type DeployableFunction, FirebaseFunction } from "./firebase-function-core.js";
+export type FirestoreConfigs = {
+    configs: any;
+};
+export declare abstract class FirestoreFunctionModule<DataType extends object, Config extends FirestoreConfigs = FirestoreConfigs> extends FirebaseFunction<Config> {
+    private readonly collectionName;
+    protected constructor(collectionName: string, name: string, onStart?: () => Promise<void>, onDestroy?: () => Promise<void>);
+    abstract processChanges(params: {
+        [param: string]: any;
+    }, before?: DataType, after?: DataType): Promise<any>;
+    getFunction: () => DeployableFunction;
+}
+//# sourceMappingURL=firebase-function-firestore.d.ts.map

package/dist/app-backend/functions/firebase-function-firestore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase-function-firestore.d.ts","sourceRoot":"","sources":["../../../src/main/app-backend/functions/firebase-function-firestore.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,KAAK,kBAAkB,EAAE,gBAAgB,EAAyB,MAAM,6BAA6B,CAAC;AAI9G,MAAM,MAAM,gBAAgB,GAAG;IAC3B,OAAO,EAAE,GAAG,CAAA;CACf,CAAA;AAGD,8BAAsB,uBAAuB,CAAC,QAAQ,SAAS,MAAM,EAAE,MAAM,SAAS,gBAAgB,GAAG,gBAAgB,CACrH,SAAQ,gBAAgB,CAAC,MAAM,CAAC;IAEhC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,SAAS,aAAa,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAK1H,QAAQ,CAAC,cAAc,CAAC,MAAM,EAAE;QAAE,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IAE5G,WAAW,QAAO,kBAAkB,CAoBlC;CACL"}

package/dist/app-backend/functions/firebase-function-firestore.js

@@ -0,0 +1,28 @@
+import { Change } from "firebase-functions/v1";
+import { onDocumentWritten } from "firebase-functions/v2/firestore";
+import { deepClone } from "@intuitionrobotics/ts-common";
+import { FirebaseFunction, toV2Options, v1Builder } from "./firebase-function-core.js";
+//TODO: I would like to add a type for the params..
+export class FirestoreFunctionModule extends FirebaseFunction {
+    collectionName;
+    constructor(collectionName, name, onStart, onDestroy) {
+        super(name, onStart, onDestroy);
+        this.collectionName = collectionName;
+    }
+    getFunction = () => {
+        const labels = this.labels("firestore-listener");
+        const documentPath = `${this.collectionName}/{docId}`;
+        if (this.generation === "v1")
+            return v1Builder(this.options, labels).firestore.document(documentPath).onWrite(async (change, context) => this.runLifecycle(async () => {
+                const before = change.before && change.before.data();
+                const after = change.after && change.after.data();
+                return this.processChanges(deepClone(context.params), before, after);
+            }));
+        return onDocumentWritten({ ...toV2Options(this.options, labels), document: documentPath }, async (event) => this.runLifecycle(async () => {
+            const before = event.data?.before.data();
+            const after = event.data?.after.data();
+            return this.processChanges(deepClone(event.params), before, after);
+        }));
+    };
+}
+//# sourceMappingURL=firebase-function-firestore.js.map

package/dist/app-backend/functions/firebase-function-firestore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase-function-firestore.js","sourceRoot":"","sources":["../../../src/main/app-backend/functions/firebase-function-firestore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAoC,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAC,iBAAiB,EAAC,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAC,SAAS,EAAC,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAA0B,gBAAgB,EAAE,WAAW,EAAE,SAAS,EAAC,MAAM,6BAA6B,CAAC;AAQ9G,mDAAmD;AACnD,MAAM,OAAgB,uBAClB,SAAQ,gBAAwB;IAEf,cAAc,CAAS;IAExC,YAAsB,cAAsB,EAAE,IAAY,EAAE,OAA6B,EAAE,SAA+B;QACtH,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QAChC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACzC,CAAC;IAID,WAAW,GAAG,GAAuB,EAAE;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,GAAG,IAAI,CAAC,cAAc,UAAU,CAAC;QAEtD,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;YACxB,OAAO,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,OAAO,CAC3E,KAAK,EAAE,MAAgC,EAAE,OAAqB,EAAE,EAAE,CAC9D,IAAI,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE;gBACzB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAA0B,CAAC;gBAC7E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAA0B,CAAC;gBAC1E,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YACzE,CAAC,CAAC,CAAC,CAAC;QAEhB,OAAO,iBAAiB,CAAC,EAAC,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAC,EACnF,KAAK,EAAE,KAAK,EAAE,EAAE,CACZ,IAAI,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE;YACzB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAA0B,CAAC;YACjE,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAA0B,CAAC;YAC/D,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC,CAAC;IAChB,CAAC,CAAC;CACL"}

package/dist/app-backend/functions/firebase-function-https.d.ts

@@ -0,0 +1,8 @@
+import { type Request, type Response } from "express";
+import { type DeployableFunction, FirebaseFunction } from "./firebase-function-core.js";
+export declare abstract class Firebase_HttpsFunction<Config = any> extends FirebaseFunction<Config> {
+    abstract process(req: Request, res: Response): Promise<any>;
+    getFunction: () => DeployableFunction;
+    onFunctionReady: () => Promise<void>;
+}
+//# sourceMappingURL=firebase-function-https.d.ts.map

package/dist/app-backend/functions/firebase-function-https.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase-function-https.d.ts","sourceRoot":"","sources":["../../../src/main/app-backend/functions/firebase-function-https.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAC,MAAM,SAAS,CAAC;AAEpD,OAAO,EAAC,KAAK,kBAAkB,EAAE,gBAAgB,EAAyB,MAAM,6BAA6B,CAAC;AAE9G,8BAAsB,sBAAsB,CAAC,MAAM,GAAG,GAAG,CACrD,SAAQ,gBAAgB,CAAC,MAAM,CAAC;IAEhC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IAE3D,WAAW,QAAO,kBAAkB,CASlC;IAEF,eAAe,sBAEb;CACL"}

package/dist/app-backend/functions/firebase-function-https.js

@@ -0,0 +1,16 @@
+import {} from "express";
+import { onRequest } from "firebase-functions/v2/https";
+import { FirebaseFunction, toV2Options, v1Builder } from "./firebase-function-core.js";
+export class Firebase_HttpsFunction extends FirebaseFunction {
+    getFunction = () => {
+        const labels = this.labels("https");
+        const handler = async (req, res) => this.runLifecycle(async () => this.process(req, res));
+        if (this.generation === "v1")
+            return v1Builder(this.options, labels).https.onRequest(handler);
+        return onRequest(toV2Options(this.options, labels), handler);
+    };
+    onFunctionReady = async () => {
+        return;
+    };
+}
+//# sourceMappingURL=firebase-function-https.js.map

package/dist/app-backend/functions/firebase-function-https.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase-function-https.js","sourceRoot":"","sources":["../../../src/main/app-backend/functions/firebase-function-https.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,MAAM,SAAS,CAAC;AACpD,OAAO,EAAC,SAAS,EAAC,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAA0B,gBAAgB,EAAE,WAAW,EAAE,SAAS,EAAC,MAAM,6BAA6B,CAAC;AAE9G,MAAM,OAAgB,sBAClB,SAAQ,gBAAwB;IAIhC,WAAW,GAAG,GAAuB,EAAE;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE,CAClD,IAAI,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAE1D,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;YACxB,OAAO,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAEpE,OAAO,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC,CAAC;IAEF,eAAe,GAAG,KAAK,IAAI,EAAE;QACzB,OAAO;IACX,CAAC,CAAC;CACL"}

package/dist/app-backend/functions/firebase-function-pubsub.d.ts

@@ -0,0 +1,15 @@
+import { type StringMap } from "@intuitionrobotics/ts-common";
+import { type DeployableFunction, type FirebaseEventContext, FirebaseFunction } from "./firebase-function-core.js";
+export type TopicMessage = {
+    data: string;
+    attributes: StringMap;
+};
+export declare abstract class Firebase_PubSubFunction<T, Config = any> extends FirebaseFunction<Config> {
+    private readonly topic;
+    protected constructor(topic: string, name: string, onStart?: () => Promise<void>, onDestroy?: () => Promise<void>);
+    abstract onPublish(object: T | undefined, originalMessage: TopicMessage, context: FirebaseEventContext): Promise<any>;
+    private _onPublish;
+    private parseData;
+    getFunction: () => DeployableFunction;
+}
+//# sourceMappingURL=firebase-function-pubsub.d.ts.map

package/dist/app-backend/functions/firebase-function-pubsub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase-function-pubsub.d.ts","sourceRoot":"","sources":["../../../src/main/app-backend/functions/firebase-function-pubsub.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2D,KAAK,SAAS,EAAC,MAAM,8BAA8B,CAAC;AACtH,OAAO,EACH,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,gBAAgB,EAGnB,MAAM,6BAA6B,CAAC;AAErC,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,SAAS,CAAA;CAAE,CAAC;AAEnE,8BAAsB,uBAAuB,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CACzD,SAAQ,gBAAgB,CAAC,MAAM,CAAC;IAEhC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,SAAS,aAAa,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAKjH,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,GAAG,CAAC;IAErH,OAAO,CAAC,UAAU,CAahB;IAEF,OAAO,CAAC,SAAS;IAUjB,WAAW,QAAO,kBAAkB,CAmBlC;CACL"}