@hot-updater/firebase 1.0.0-rc.4 → 1.0.0-rc.40

package/dist/index.d.cts

@@ -1,8 +1,27 @@
+import { DatabaseJsonObject, EngineDatabase, Platform, PluginTables, StorageAdapterWith } from "@hot-updater/plugin-core";
 import { AppOptions } from "firebase-admin/app";
-import { StoragePluginWith } from "@hot-updater/plugin-core";
+import "@hot-updater/protocol";
 //#region src/firebaseDatabase.d.ts
-type FirebaseDatabaseConfig = AppOptions;
-declare const firebaseDatabase: (config: FirebaseDatabaseConfig) => import("@hot-updater/plugin-core").DatabasePlugin;
+type FirebaseDatabaseConfig = AppOptions & {
+  /** The one collection the database keeps its items in. */
+  readonly collection?: string;
+  /**
+   * Firestore bills each document write, so Insights' aggregates are
+   * batched: through log rows a compaction merges (the default), or
+   * `{ mode: "memory" }` on a long-lived server. `false` commits them with
+   * each event.
+   */
+  readonly aggregateBatching?: EngineDatabase["aggregateBatching"] | false;
+};
+/**
+ * Writes the schema settings of core and `plugins`, the plugins the server
+ * runs, which the database checks before its first read. Firestore needs no
+ * other setup beyond `firestore.indexes.json`; `hot-updater init` runs it
+ * after deploying the indexes.
+ */
+declare const migrateFirebaseDatabase: (config: FirebaseDatabaseConfig, plugins?: readonly PluginTables[]) => Promise<void>;
+/** Hot Updater's database in one Firestore collection, through the storage engine. */
+declare const firebaseDatabase: (config: FirebaseDatabaseConfig) => EngineDatabase;
 //#endregion
 //#region src/firebaseStorage.d.ts
 interface FirebaseStorageConfig extends AppOptions {
@@ -14,6 +33,783 @@ interface FirebaseStorageConfig extends AppOptions {
   /** Firebase signed URL lifetime in seconds. @default 3600 */
   signedUrlExpiresIn?: number;
 }
-declare const firebaseStorage: (config: FirebaseStorageConfig) => StoragePluginWith<"put" | "get" | "getDownloadUrl" | "exists" | "delete">;
+declare const firebaseStorage: (config: FirebaseStorageConfig) => StorageAdapterWith<"put" | "get" | "getDownloadUrl" | "exists" | "delete">;
 //#endregion
-export { FirebaseDatabaseConfig, FirebaseStorageConfig, firebaseDatabase, firebaseStorage };
+//#region ../insights/dist/server/eventRow.d.mts
+//#region src/server/eventRow.d.ts
+/** Where an update failed, and what failed; open sets, `unknown` for any other value. */
+type BundleEventFailureStage = "check" | "download" | "install" | "unknown";
+type BundleEventFailureReason = "network" | "http" | "invalid_response" | "hash_mismatch" | "signature" | "patch" | "extract" | "storage" | "unknown";
+/** An `UPDATE_FAILED` report's failure, as stored. */
+type BundleEventFailure = DatabaseJsonObject & {
+  readonly stage: BundleEventFailureStage;
+  readonly reason: BundleEventFailureReason;
+  /** What the client was fetching or writing. */
+  readonly resource?: "catalog" | "artifact" | "manifest" | "file" | "patch" | "archive" | "unknown";
+  readonly http_status?: number;
+  /** How the connection failed, when it did. */
+  readonly transport?: "timeout" | "dns" | "tls" | "connection" | "offline" | "cancelled" | "unknown";
+  /** The storage origin's error code, such as `ExpiredToken`. */
+  readonly origin_code?: string;
+  readonly error_message?: string;
+  readonly error_stack?: string;
+};
+type DatabaseHttpResponse = DatabaseJsonObject & {
+  readonly resource: "catalog" | "artifact";
+  readonly path: string;
+  readonly status: number;
+  readonly body: string | null;
+  readonly body_truncated: boolean;
+  readonly received_at_ms: number;
+};
+/** What a kept UNCHANGED row changed against its installation's head. */
+type BundleEventChangeKind = "first_seen" | "bundle" | "release" | "app_version" | "channel" | "native_build";
+/**
+ * An UNCHANGED report the server keeps: what it changed against its
+ * installation's head, and the running values the head held before it. A
+ * report from an installation without a head is `first_seen` alone, with no
+ * previous values: the installation is new to this server, not necessarily
+ * to its device.
+ */
+type BundleEventChange = DatabaseJsonObject & {
+  readonly kinds: BundleEventChangeKind[];
+  readonly previous: (DatabaseJsonObject & {
+    readonly bundle_id: string;
+    readonly release_id: string | null;
+    readonly app_version: string;
+    readonly channel: string;
+    readonly min_bundle_id?: string;
+  }) | null;
+};
+/** Ancillary report data; queryable identity and lifecycle fields stay on the row. */
+type DatabaseBundleEventMetadata = DatabaseJsonObject & {
+  readonly cohort: string;
+  readonly update_strategy: "fingerprint" | "appVersion" | null;
+  readonly fingerprint_hash: string | null;
+  readonly sdk_version: string | null;
+  /** The native build's built-in bundle ID, when the SDK reports it. */
+  readonly min_bundle_id?: string;
+  /** `UPDATE_FAILED`: what failed. */
+  readonly failure?: BundleEventFailure;
+  readonly http_response?: DatabaseHttpResponse;
+  /** `UPDATE_DOWNLOADED`: how the bundle arrived. */
+  readonly delivery?: "patch" | "manifest" | "archive" | "unknown";
+  /** `UPDATE_DOWNLOADED`: a patch failed and the full files came instead. */
+  readonly patch_fallback?: boolean;
+  /** A kept `UNCHANGED` row: what it changed, which the server sets. */
+  readonly change?: BundleEventChange;
+  /**
+   * A download or apply of a target its installation already ran, as when
+   * a reload cut the first runtime's report short, or a download that
+   * repeats the pending one: the server keeps it in history, but it moves
+   * and counts nothing.
+   */
+  readonly late?: true;
+  /**
+   * A launch or crash of a bundle whose download report never arrived: the
+   * server counted that download with it.
+   */
+  readonly implied_download?: true;
+};
+type BundleEventRowBase = {
+  readonly id: string;
+  readonly install_id: string;
+  readonly user_id: string | null;
+  readonly from_release_id: string | null;
+  readonly to_release_id: string | null;
+  readonly to_bundle_id: string;
+  readonly platform: Platform;
+  readonly app_version: string;
+  readonly channel: string;
+  readonly metadata: DatabaseBundleEventMetadata;
+  readonly received_at_ms: number;
+};
+type BundleEventRow = BundleEventRowBase & ({
+  readonly type: "UPDATE_DOWNLOADED";
+  readonly from_bundle_id: string;
+} | {
+  readonly type: "UPDATE_APPLIED" | "RECOVERED";
+  readonly from_bundle_id: string;
+} |
+/** An update that failed: `from` is the running bundle, `to` the target (for a check, the running bundle). */
+{
+  readonly type: "UPDATE_FAILED";
+  readonly from_bundle_id: string;
+} | {
+  readonly type: "UNCHANGED";
+  readonly from_bundle_id: null;
+});
+//#endregion
+//#region ../insights/dist/server/modelTypes.d.mts
+//#region src/server/modelTypes.d.ts
+interface InsightsEventCursor {
+  readonly receivedAtMs: number;
+  readonly id: string;
+}
+interface InsightsScope {
+  readonly platform: "ios" | "android";
+  readonly channel: string;
+}
+/**
+ * Raw event predicates; recovery is attributed to the source bundle. An
+ * UNCHANGED filter matches the kept rows that moved an installation to the
+ * bundle without an apply report.
+ */
+type InsightsBundleEventFilter = InsightsScope & ({
+  readonly type: "RECOVERED";
+  readonly fromBundleId: string;
+} | {
+  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "UPDATE_FAILED" | "UNCHANGED";
+  readonly toBundleId: string;
+});
+type InsightsEventFilter = {
+  readonly kind: "all";
+} | {
+  readonly kind: "installationMovement";
+  readonly installId: string;
+} | ({
+  readonly kind: "bundle";
+} & InsightsBundleEventFilter);
+interface InsightsListEventsInput {
+  readonly filter: InsightsEventFilter;
+  readonly sinceMs?: number;
+  readonly beforeReceivedAtMs: number;
+  readonly after?: InsightsEventCursor;
+  readonly limit: number;
+}
+type InsightsFindLatestEventsInput = {
+  readonly installId: string;
+} | {
+  readonly userId: string;
+  readonly afterInstallId?: string;
+  readonly limit: number;
+};
+interface InsightsCountLatestEventsInput extends InsightsScope {
+  /** A UTC day's start: latest events are counted by the day they fall in. */
+  readonly sinceMs: number;
+  /** Optional OR of one or two fixed predicates; count a matching event once. */
+  readonly bundle?: readonly {
+    readonly field: "from_bundle_id" | "to_bundle_id";
+    readonly value: string;
+    readonly types: readonly BundleEventRow["type"][];
+  }[];
+}
+interface InsightsCountEventsInput {
+  readonly filter: InsightsBundleEventFilter;
+  readonly sinceMs: number;
+  readonly beforeReceivedAtMs: number;
+}
+/** One bundle filter's stored events in each interval of a time range. */
+interface InsightsCountEventSeriesInput {
+  readonly filter: InsightsBundleEventFilter;
+  /** Whole UTC hours, at most 90 days, that a whole number of intervals fill. */
+  readonly timeRange: InsightsTimeRange;
+  /** Whole hours each point spans, from `timeRange.start`. */
+  readonly intervalMs: number;
+}
+/** Stored events in [startMs, startMs + intervalMs). */
+interface InsightsEventSeriesPoint {
+  readonly startMs: number;
+  readonly events: number;
+}
+interface ReleaseReference {
+  readonly releaseId: string;
+  readonly platform: "ios" | "android";
+  readonly channel: string;
+}
+interface InsightsTimeRange {
+  /** Inclusive UTC Unix timestamp in milliseconds. */
+  readonly start: number;
+  /** Exclusive UTC Unix timestamp in milliseconds. */
+  readonly end: number;
+}
+type InsightsCoverage = {
+  readonly kind: "complete";
+  readonly sinceMs: number;
+} | {
+  readonly kind: "partial";
+  readonly sinceMs: number | null;
+};
+/**
+ * A release's counts since its first report, from its lifetime counters,
+ * which are kept.
+ */
+interface ReleaseActivityMetrics {
+  /** Download reports of the release. */
+  readonly downloads: number;
+  /** Apply reports of the release: installations that started running it. */
+  readonly applies: number;
+  /** Launches that crashed on the release and recovered to the one before. */
+  readonly failedLaunches: number;
+}
+interface InsightsGetReleaseActivityInput {
+  /** 1 to 100 releases. */
+  readonly releases: readonly ReleaseReference[];
+}
+interface InsightsGetReleaseActivityResult {
+  readonly data: readonly {
+    readonly release: ReleaseReference;
+    readonly metrics: ReleaseActivityMetrics;
+  }[];
+  readonly measuredAtMs: number;
+}
+interface InsightsGetAppUsageInput {
+  readonly channel: string;
+  readonly platform: "all" | "ios" | "android";
+  readonly appVersion?: string;
+  readonly timeRange: InsightsTimeRange;
+  readonly intervalMs: number;
+}
+interface InsightsGetAppUsageResult {
+  readonly coverage: InsightsCoverage;
+  readonly activeInstallations: number;
+  readonly points: readonly {
+    readonly startMs: number;
+    readonly installations: number;
+  }[];
+  readonly appVersions: readonly string[];
+  readonly versions: readonly {
+    readonly name: string;
+    readonly installations: number;
+  }[];
+  readonly platforms: readonly {
+    readonly name: string;
+    readonly installations: number;
+  }[];
+  readonly bundleDistribution: readonly {
+    readonly appVersion: string;
+    readonly platform: "ios" | "android";
+    /** The release the installations run; null for none. */
+    readonly releaseId: string | null;
+    /** The native build's built-in bundle, when they run it. */
+    readonly builtinBundleId: string | null;
+    readonly installations: number;
+  }[];
+  readonly measuredAtMs: number;
+}
+//#endregion
+//#region ../insights/dist/server/schema.d.mts
+//#region src/server/schema.d.ts
+/** How long Insights keeps its rows, in whole days. Lifetime counters are kept. */
+interface InsightsRetention {
+  /** Raw events and hourly rollups. */
+  readonly rawDays: number;
+  /** Daily rollups, and each installation's latest event and the gauges that count it. */
+  readonly dailyDays: number;
+}
+//#endregion
+//#region ../insights/dist/server/reads.d.mts
+//#region src/server/reads.d.ts
+interface InsightsUpdateFailuresInput {
+  readonly platform: "ios" | "android";
+  readonly channel: string;
+  /** A release's failures; without it, the channel's, which need a time range. */
+  readonly releaseId?: string;
+  /** Without it, a release's failures since its first report. */
+  readonly timeRange?: InsightsTimeRange;
+}
+/** Update failures of one stage and reason, and what else their clients knew. */
+interface InsightsFailureBreakdown {
+  readonly stage: string;
+  readonly reason: string;
+  readonly events: number;
+  /** By resource, HTTP status, origin code, and transport, most first. */
+  readonly details: readonly {
+    readonly resource: string | null;
+    readonly httpStatus: number | null;
+    readonly originCode: string | null;
+    readonly transport: string | null;
+    readonly events: number;
+  }[];
+}
+interface InsightsUpdateFailures {
+  readonly coverage: InsightsCoverage;
+  readonly measuredAtMs: number;
+  /** Update failures other than failed checks: each client reports one at most once a UTC day. */
+  readonly failedUpdates: number;
+  /** Installations with such a failure, estimated. */
+  readonly failedInstallations: number;
+  /** Download reports: each installation reports a bundle's download once. */
+  readonly downloads: number;
+  /** Downloads a patch delivered, and those that fell back from a patch to files or the archive. */
+  readonly patchDownloads: number;
+  readonly patchFallbacks: number;
+  /** A channel's failed update checks, installations with one, and its active installations, estimated. */
+  readonly checks?: {
+    readonly failures: number;
+    readonly failedInstallations: number;
+    readonly activeInstallations: number;
+  };
+  /** Over a time range: failures by stage and reason, most first. */
+  readonly breakdown?: readonly InsightsFailureBreakdown[];
+}
+//#endregion
+//#region ../api-keys/dist/server/model.d.mts
+//#region src/server/model.d.ts
+interface ApiKeyRow {
+  readonly id: string;
+  readonly hash: string;
+  readonly name: string;
+  readonly prefix: string;
+  readonly role: "client";
+  readonly created_at_ms: number;
+  readonly revoked_at_ms: number | null;
+}
+//#endregion
+//#region ../api-keys/dist/server/apiKeys.d.mts
+type ApiKeyMetadata = Omit<ApiKeyRow, "hash">;
+interface CreatedApiKey {
+  /** Plaintext credential. It cannot be recovered after this call returns. */
+  readonly apiKey: string;
+  /** Non-secret metadata. The persisted SHA-256 hash is never exposed. */
+  readonly record: ApiKeyMetadata;
+}
+//#endregion
+//#region src/plugins.d.ts
+/**
+ * The plugins the managed Firebase server runs: Insights, and API keys on every
+ * client route. Its Cloud Function imports this list.
+ */
+declare const plugins: readonly [import("@hot-updater/plugin-core").HotUpdaterPlugin<"insights", {
+  readonly bundle_events: import("@hot-updater/plugin-core").TableDefinition<{
+    readonly id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly type: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly install_id: {
+      readonly type: "string";
+      readonly maxLength: 255;
+    };
+    readonly user_id: {
+      readonly type: "string";
+      readonly maxLength: 255;
+      readonly required: false;
+    };
+    readonly from_release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+    readonly from_bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+    readonly to_release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+    readonly to_bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly app_version: {
+      readonly type: "string";
+    };
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly metadata: {
+      readonly type: "json";
+    };
+    readonly received_at_ms: {
+      readonly type: "integer";
+    };
+  }, {
+    day: "integer";
+    movement_install_id: "string";
+    bundle_ref: "string";
+  }, {
+    readonly movementsByInstall: {
+      readonly eq: readonly ["movement_install_id"];
+      readonly sort: readonly ["received_at_ms"];
+    };
+    readonly byBundle: {
+      readonly eq: readonly ["platform", "channel", "type", "bundle_ref", "day"];
+      readonly sort: readonly ["received_at_ms"];
+    };
+    readonly byDay: {
+      readonly eq: readonly ["day"];
+      readonly sort: readonly ["received_at_ms"];
+    };
+  }, readonly ["id"]>;
+  readonly bundle_event_heads: import("@hot-updater/plugin-core").TableDefinition<{
+    readonly install_id: {
+      readonly type: "string";
+      readonly maxLength: 255;
+    };
+    readonly id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly type: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly user_id: {
+      readonly type: "string";
+      readonly maxLength: 255;
+      readonly required: false;
+    };
+    readonly from_release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+    readonly from_bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+    readonly to_release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+    readonly to_bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly app_version: {
+      readonly type: "string";
+    };
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly metadata: {
+      readonly type: "json";
+    };
+    readonly received_at_ms: {
+      readonly type: "integer";
+    };
+  }, Readonly<Record<string, import("@hot-updater/plugin-core").FieldType>>, {
+    readonly byUser: {
+      readonly eq: readonly ["user_id"];
+      readonly sort: readonly ["install_id"];
+    };
+  }, readonly ["install_id"]>;
+  readonly insights_overview: import("@hot-updater/plugin-core").AggregateDefinition<{
+    readonly identity: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "downloads" | "failed_launches" | "patch_downloads" | "patch_fallbacks", {
+    readonly window: {
+      readonly eq: readonly ["identity"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["identity", "bucket_start_ms"]>;
+  readonly insights_sketches: import("@hot-updater/plugin-core").AggregateDefinition<{
+    readonly identity: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, never, {
+    readonly window: {
+      readonly eq: readonly ["identity"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, "activity_users" | "failed_users", readonly ["identity", "bucket_start_ms"]>;
+  readonly insights_overview_daily: import("@hot-updater/plugin-core").AggregateDefinition<{
+    readonly identity: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "downloads" | "failed_launches" | "patch_downloads" | "patch_fallbacks", {
+    readonly window: {
+      readonly eq: readonly ["identity"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["identity", "bucket_start_ms"]>;
+  readonly insights_sketches_daily: import("@hot-updater/plugin-core").AggregateDefinition<{
+    readonly identity: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, never, {
+    readonly window: {
+      readonly eq: readonly ["identity"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, "activity_users" | "failed_users", readonly ["identity", "bucket_start_ms"]>;
+  readonly insights_overview_lifetime: import("@hot-updater/plugin-core").AggregateDefinition<{
+    readonly identity: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "downloads" | "failed_launches" | "patch_downloads" | "patch_fallbacks" | "applies" | "failed_updates", {
+    readonly window: {
+      readonly eq: readonly ["identity"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["identity", "bucket_start_ms"]>;
+  readonly insights_sketches_lifetime: import("@hot-updater/plugin-core").AggregateDefinition<{
+    readonly identity: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, never, {
+    readonly window: {
+      readonly eq: readonly ["identity"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, "failed_users", readonly ["identity", "bucket_start_ms"]>;
+  readonly insights_distribution: import("@hot-updater/plugin-core").AggregateDefinition<{
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly app_version: {
+      readonly type: "string";
+    };
+    readonly release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "latest_installations", {
+    readonly byScope: {
+      readonly eq: readonly ["channel", "platform"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+    readonly byVersion: {
+      readonly eq: readonly ["channel", "platform", "app_version"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["channel", "platform", "app_version", "release_id", "bucket_start_ms"]>;
+  readonly insights_builtin_distribution: import("@hot-updater/plugin-core").AggregateDefinition<{
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly app_version: {
+      readonly type: "string";
+    };
+    readonly release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly builtin_bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "latest_installations", {
+    readonly byScope: {
+      readonly eq: readonly ["channel", "platform"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+    readonly byVersion: {
+      readonly eq: readonly ["channel", "platform", "app_version"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["channel", "platform", "app_version", "release_id", "builtin_bundle_id", "bucket_start_ms"]>;
+  readonly insights_latest_by_bundle: import("@hot-updater/plugin-core").AggregateDefinition<{
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly bundle_field: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly type: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "installations", {
+    readonly byBundle: {
+      readonly eq: readonly ["platform", "channel", "bundle_field", "bundle_id", "type"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["platform", "channel", "bundle_field", "bundle_id", "type", "bucket_start_ms"]>;
+  readonly insights_outcomes: import("@hot-updater/plugin-core").AggregateDefinition<{
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly type: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bundle_ref: {
+      readonly type: "string";
+      readonly maxLength: 41;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "events", {
+    readonly byRef: {
+      readonly eq: readonly ["platform", "channel", "type", "bundle_ref"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["platform", "channel", "type", "bundle_ref", "bucket_start_ms"]>;
+  readonly insights_failures: import("@hot-updater/plugin-core").AggregateDefinition<{
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+    readonly release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly stage: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly reason: {
+      readonly type: "string";
+      readonly maxLength: 64;
+    };
+    readonly detail: {
+      readonly type: "string";
+      readonly maxLength: 160;
+    };
+  }, "events", {
+    readonly byScope: {
+      readonly eq: readonly ["platform", "channel"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["platform", "channel", "bucket_start_ms", "release_id", "stage", "reason", "detail"]>;
+}, {
+  api: {
+    retention: InsightsRetention;
+    recordEvent: (event: BundleEventRow) => Promise<void>;
+    listEvents: (input: InsightsListEventsInput) => Promise<readonly BundleEventRow[]>;
+    findLatestEvents: (input: InsightsFindLatestEventsInput) => Promise<readonly BundleEventRow[]>;
+    countLatestEvents: (input: InsightsCountLatestEventsInput) => Promise<number>;
+    countEvents: (input: InsightsCountEventsInput) => Promise<number>;
+    countEventSeries: (input: InsightsCountEventSeriesInput) => Promise<readonly InsightsEventSeriesPoint[]>;
+    getReleaseActivity: (input: InsightsGetReleaseActivityInput) => Promise<InsightsGetReleaseActivityResult>;
+    getAppUsage: (input: InsightsGetAppUsageInput) => Promise<InsightsGetAppUsageResult>;
+    getUpdateFailures: (input: InsightsUpdateFailuresInput) => Promise<InsightsUpdateFailures>;
+  };
+  endpoints: import("@hot-updater/plugin-core").PluginEndpoint[];
+}, {}>, import("@hot-updater/plugin-core").HotUpdaterPlugin<"apiKeys", {
+  readonly api_keys: import("@hot-updater/plugin-core").TableDefinition<{
+    readonly id: {
+      readonly type: "string";
+      readonly maxLength: 255;
+    };
+    readonly hash: {
+      readonly type: "string";
+      readonly maxLength: 64;
+      readonly unique: true;
+    };
+    readonly name: {
+      readonly type: "string";
+      readonly maxLength: 64;
+    };
+    readonly prefix: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly role: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly created_at_ms: {
+      readonly type: "integer";
+    };
+    readonly revoked_at_ms: {
+      readonly type: "integer";
+      readonly required: false;
+    };
+  }, {}, {
+    readonly byCreated: {
+      readonly eq: readonly [];
+      readonly sort: readonly ["created_at_ms"];
+    };
+  }, readonly ["id"]>;
+}, {
+  api: {
+    register: (input: {
+      readonly apiKey: string;
+      readonly name: string;
+      readonly createdAtMs?: number;
+    }) => Promise<CreatedApiKey>;
+    provision: (input: {
+      readonly existingApiKey?: string;
+      readonly name: string;
+    }) => Promise<CreatedApiKey>;
+    create(input: {
+      readonly name: string;
+    }): Promise<{
+      readonly apiKey: string;
+      readonly record: ApiKeyMetadata;
+    }>;
+    list(): Promise<readonly ApiKeyMetadata[]>;
+    revoke(input: {
+      readonly id: string;
+    }): Promise<ApiKeyMetadata | null>;
+  };
+  clientAuth: {
+    varyHeaders: string[];
+    authenticate: (headers: Headers) => Promise<boolean>;
+  };
+}, {
+  readonly clientAuth: true;
+}>];
+//#endregion
+export { FirebaseDatabaseConfig, FirebaseStorageConfig, firebaseDatabase, firebaseStorage, migrateFirebaseDatabase, plugins };