@hot-updater/plugin-core 0.36.7 → 1.0.0-rc.0

package/dist/types/databaseOperations.d.mts

@@ -0,0 +1,173 @@
+import { ApiKeyRow, BundleRow, DatabaseModel, DatabaseRow, ReleaseCatalogRow, ReleaseRow } from "./databaseRows.mjs";
+import { ChannelDeleteInput, ChannelDeleteResult, ChannelInsertInput, ChannelInsertResult, DatabaseCommit, DatabaseCommitResult } from "./databasePlugin.mjs";
+import { DatabaseDistinctFields, DatabaseDistinctOn, DatabaseOrderBy, DatabaseSelect, DatabaseWhere, SelectedDatabaseRow } from "./databaseQuery.mjs";
+
+//#region src/types/databaseOperations.d.ts
+type DatabaseCapability = "create" | "update" | "delete" | "count" | "findOne" | "findMany";
+type DatabaseModelCapabilities = {
+  readonly bundles: {
+    readonly create: true;
+    readonly update: true;
+    readonly delete: true;
+    readonly count: true;
+    readonly findOne: true;
+    readonly findMany: true;
+  };
+  readonly bundle_patches: {
+    readonly create: true;
+    readonly update: false;
+    readonly delete: true;
+    readonly count: true;
+    readonly findOne: true;
+    readonly findMany: true;
+  };
+  readonly releases: {
+    readonly create: true;
+    readonly update: true;
+    readonly delete: true;
+    readonly count: true;
+    readonly findOne: true;
+    readonly findMany: true;
+  };
+  readonly release_catalogs: {
+    readonly create: true;
+    readonly update: true;
+    readonly delete: false;
+    readonly count: false;
+    readonly findOne: true;
+    readonly findMany: true;
+  };
+  readonly channels: {
+    readonly create: true;
+    readonly update: false;
+    readonly delete: true;
+    readonly count: false;
+    readonly findOne: true;
+    readonly findMany: true;
+  };
+  readonly bundle_events: {
+    readonly create: true;
+    readonly update: false;
+    readonly delete: false;
+    readonly count: false;
+    readonly findOne: false;
+    readonly findMany: true;
+  };
+  readonly api_keys: {
+    readonly create: true;
+    readonly update: true;
+    readonly delete: false;
+    readonly count: false;
+    readonly findOne: true;
+    readonly findMany: true;
+  };
+};
+type DatabaseModelsWithCapability<TCapability extends DatabaseCapability> = { readonly [TModel in DatabaseModel]: DatabaseModelCapabilities[TModel][TCapability] extends true ? TModel : never }[DatabaseModel];
+type CreateDatabaseModel = DatabaseModelsWithCapability<"create">;
+type UpdateDatabaseModel = DatabaseModelsWithCapability<"update">;
+type DeleteDatabaseModel = DatabaseModelsWithCapability<"delete">;
+type CountDatabaseModel = DatabaseModelsWithCapability<"count">;
+type FindOneDatabaseModel = DatabaseModelsWithCapability<"findOne">;
+type FindManyDatabaseModel = DatabaseModelsWithCapability<"findMany">;
+type DatabaseDeleteModel = DeleteDatabaseModel;
+type DatabaseFindOneModel = FindOneDatabaseModel;
+type CreateDatabaseInputBase<TModel extends CreateDatabaseModel, TSelect extends DatabaseSelect<TModel> | undefined = undefined> = {
+  readonly model: TModel;
+  readonly data: DatabaseRow<TModel>;
+  readonly select?: TSelect;
+};
+type CreateDatabaseInput<TModel extends CreateDatabaseModel, TSelect extends DatabaseSelect<TModel> | undefined = undefined> = CreateDatabaseInputBase<TModel, TSelect> & (TModel extends "channels" | "api_keys" ? {
+  readonly onConflict?: "ignore";
+} : {
+  readonly onConflict?: never;
+});
+type BundleRowUpdateFields = Partial<Omit<BundleRow, "id">>;
+type ReleaseRowUpdate = Partial<Pick<ReleaseRow, "revision" | "scope_key" | "target_app_version" | "fingerprint_hash" | "enabled" | "should_force_update" | "message" | "rollout_cohort_count" | "target_cohorts" | "updated_at_ms">>;
+type ReleaseCatalogRowUpdate = Omit<ReleaseCatalogRow, "scope_key">;
+type BundleRowUpdate = BundleRowUpdateFields;
+type ApiKeyRowUpdate = Pick<ApiKeyRow, "revoked_at_ms">;
+type DatabaseRowUpdate<TModel extends UpdateDatabaseModel> = {
+  readonly bundles: BundleRowUpdate;
+  readonly releases: ReleaseRowUpdate;
+  readonly release_catalogs: ReleaseCatalogRowUpdate;
+  readonly api_keys: ApiKeyRowUpdate;
+}[TModel];
+type UpdateDatabaseInput<TModel extends UpdateDatabaseModel, TSelect extends DatabaseSelect<TModel> | undefined = undefined> = {
+  readonly model: TModel;
+  readonly where: readonly DatabaseWhere<TModel>[];
+  readonly update: DatabaseRowUpdate<TModel>;
+  readonly select?: TSelect;
+};
+type UpdateBundleDatabaseInput<TSelect extends DatabaseSelect<"bundles"> | undefined = undefined> = UpdateDatabaseInput<"bundles", TSelect>;
+type DeleteDatabaseInput<TModel extends DeleteDatabaseModel> = {
+  readonly model: TModel;
+  readonly where: readonly DatabaseWhere<TModel>[];
+};
+type CountDatabaseInput<TModel extends CountDatabaseModel> = {
+  readonly model: TModel;
+  readonly where?: readonly DatabaseWhere<TModel>[];
+  readonly distinct?: DatabaseDistinctFields<TModel>;
+};
+type CountBundlesDatabaseInput = CountDatabaseInput<"bundles">;
+type FindOneDatabaseInput<TModel extends FindOneDatabaseModel, TSelect extends DatabaseSelect<TModel> | undefined = undefined> = {
+  readonly model: TModel;
+  readonly where?: readonly DatabaseWhere<TModel>[];
+  readonly select?: TSelect;
+};
+type FindManyDatabaseInput<TModel extends FindManyDatabaseModel, TSelect extends DatabaseSelect<TModel> | undefined = undefined> = {
+  readonly model: TModel;
+  readonly where?: readonly DatabaseWhere<TModel>[];
+  readonly limit?: number;
+  readonly offset?: number;
+  readonly orderBy?: DatabaseOrderBy<TModel>;
+  readonly distinctOn?: DatabaseDistinctOn<TModel>;
+  readonly select?: TSelect;
+};
+type SelectedDatabaseInputRow<TInput extends {
+  readonly model: DatabaseModel;
+  readonly select?: readonly string[] | undefined;
+}> = SelectedDatabaseRow<TInput["model"], "select" extends keyof TInput ? Extract<TInput["select"], DatabaseSelect<TInput["model"]> | undefined> : undefined>;
+interface DatabasePluginCrud {
+  create<TInput extends CreateDatabaseImplementationInput>(input: TInput): Promise<SelectedDatabaseInputRow<TInput>>;
+  update<TInput extends UpdateDatabaseImplementationInput>(input: TInput): Promise<SelectedDatabaseInputRow<TInput> | null>;
+  delete(input: DeleteDatabaseImplementationInput): Promise<void>;
+  count(input: CountDatabaseImplementationInput): Promise<number>;
+  findOne<TInput extends FindOneDatabaseImplementationInput>(input: TInput): Promise<SelectedDatabaseInputRow<TInput> | null>;
+  findMany<TInput extends FindManyDatabasePluginInput>(input: TInput): Promise<SelectedDatabaseInputRow<TInput>[]>;
+}
+type DatabaseImplementationResult = { readonly [TModel in DatabaseModel]: Partial<DatabaseRow<TModel>> }[DatabaseModel];
+type CreateDatabaseImplementationInput = { readonly [TModel in CreateDatabaseModel]: CreateDatabaseInput<TModel, DatabaseSelect<TModel> | undefined> }[CreateDatabaseModel];
+type UpdateDatabaseImplementationInput = { readonly [TModel in UpdateDatabaseModel]: UpdateDatabaseInput<TModel, DatabaseSelect<TModel> | undefined> }[UpdateDatabaseModel];
+type DeleteDatabaseImplementationInput = { readonly [TModel in DeleteDatabaseModel]: DeleteDatabaseInput<TModel> }[DeleteDatabaseModel];
+type CountDatabaseImplementationInput = { readonly [TModel in CountDatabaseModel]: CountDatabaseInput<TModel> }[CountDatabaseModel];
+type UpdateBundleDatabaseImplementationInput = UpdateDatabaseInput<"bundles", DatabaseSelect<"bundles"> | undefined>;
+type CountBundlesDatabaseImplementationInput = CountDatabaseInput<"bundles">;
+type FindOneDatabaseImplementationInput = { readonly [TModel in FindOneDatabaseModel]: FindOneDatabaseInput<TModel, DatabaseSelect<TModel> | undefined> }[FindOneDatabaseModel];
+type FindManyDatabaseImplementationInput = { readonly [TModel in FindManyDatabaseModel]: Omit<FindManyDatabaseInput<TModel, DatabaseSelect<TModel> | undefined>, "limit" | "offset"> & {
+  readonly limit: number;
+  readonly offset: number;
+} }[FindManyDatabaseModel];
+type FindManyDatabasePluginInput = { readonly [TModel in FindManyDatabaseModel]: FindManyDatabaseInput<TModel, DatabaseSelect<TModel> | undefined> }[FindManyDatabaseModel];
+interface TransactionDatabasePluginImplementation {
+  create(input: CreateDatabaseImplementationInput): Promise<DatabaseImplementationResult>;
+  update(input: UpdateDatabaseImplementationInput): Promise<DatabaseImplementationResult | null>;
+  delete(input: DeleteDatabaseImplementationInput): Promise<void>;
+  count(input: CountDatabaseImplementationInput): Promise<number>;
+  findOne(input: FindOneDatabaseImplementationInput): Promise<DatabaseImplementationResult | null>;
+  findMany(input: FindManyDatabaseImplementationInput): Promise<readonly DatabaseImplementationResult[]>;
+}
+interface DatabasePluginImplementation {
+  create(input: CreateDatabaseImplementationInput): Promise<DatabaseImplementationResult>;
+  update(input: UpdateDatabaseImplementationInput): Promise<DatabaseImplementationResult | null>;
+  delete(input: DeleteDatabaseImplementationInput): Promise<void>;
+  count(input: CountDatabaseImplementationInput): Promise<number>;
+  findOne(input: FindOneDatabaseImplementationInput): Promise<DatabaseImplementationResult | null>;
+  findMany(input: FindManyDatabaseImplementationInput): Promise<readonly DatabaseImplementationResult[]>;
+  insertChannel(input: ChannelInsertInput): Promise<ChannelInsertResult>;
+  deleteChannel(input: ChannelDeleteInput): Promise<ChannelDeleteResult>;
+  transaction?: <TResult>(callback: (transaction: TransactionDatabasePluginImplementation) => Promise<TResult>) => Promise<TResult>;
+  commit?: (input: DatabaseCommit) => Promise<DatabaseCommitResult>;
+  dispose?: () => Promise<void>;
+}
+//#endregion
+export { ApiKeyRowUpdate, BundleRowUpdate, CountBundlesDatabaseImplementationInput, CountBundlesDatabaseInput, CountDatabaseImplementationInput, CountDatabaseInput, CountDatabaseModel, CreateDatabaseImplementationInput, CreateDatabaseInput, CreateDatabaseModel, DatabaseCapability, DatabaseDeleteModel, DatabaseFindOneModel, DatabaseImplementationResult, DatabaseModelCapabilities, DatabaseModelsWithCapability, DatabasePluginCrud, DatabasePluginImplementation, DatabaseRowUpdate, DeleteDatabaseImplementationInput, DeleteDatabaseInput, DeleteDatabaseModel, FindManyDatabaseImplementationInput, FindManyDatabaseInput, FindManyDatabaseModel, FindManyDatabasePluginInput, FindOneDatabaseImplementationInput, FindOneDatabaseInput, FindOneDatabaseModel, ReleaseCatalogRowUpdate, ReleaseRowUpdate, SelectedDatabaseInputRow, TransactionDatabasePluginImplementation, UpdateBundleDatabaseImplementationInput, UpdateBundleDatabaseInput, UpdateDatabaseImplementationInput, UpdateDatabaseInput, UpdateDatabaseModel };

package/dist/types/databasePlugin.d.cts

@@ -0,0 +1,240 @@
+import { ApiKeyRow, BundleEventRow, BundlePatchRow, BundleRow, ChannelRow, ReleaseCatalogRow, ReleaseRow } from "./databaseRows.cjs";
+import { BundleRowUpdate, ReleaseRowUpdate } from "./databaseOperations.cjs";
+import { DatabaseBundleQueryOrder, DatabaseBundleQueryWhere } from "./index.cjs";
+
+//#region src/types/databasePlugin.d.ts
+interface BundleModelQuery {
+  readonly where?: DatabaseBundleQueryWhere;
+  readonly limit: number;
+  readonly offset: number;
+  readonly orderBy: DatabaseBundleQueryOrder;
+}
+interface BundleModel {
+  findById(id: string): Promise<BundleRow | null>;
+  findMany(query: BundleModelQuery): Promise<readonly BundleRow[]>;
+  count(where?: DatabaseBundleQueryWhere): Promise<number>;
+}
+interface BundlePatchModel {
+  findByBundleIds(bundleIds: readonly string[]): Promise<readonly BundlePatchRow[]>;
+}
+interface ReleaseModel {
+  findById(id: string): Promise<ReleaseRow | null>;
+  findMany(input: {
+    readonly afterReleaseId?: string;
+    readonly beforeReleaseId?: string;
+    readonly bundleId?: string;
+    readonly channelId?: string;
+    readonly enabled?: boolean;
+    readonly platform?: "ios" | "android";
+    readonly targetAppVersion?: string;
+    readonly limit: number;
+  }): Promise<readonly ReleaseRow[]>;
+  findManyByScope(input: {
+    readonly scopeKey: string;
+    readonly afterReleaseId?: string;
+    readonly limit: number;
+    readonly consistency: "strong";
+  }): Promise<readonly ReleaseRow[]>;
+}
+interface ReleaseCatalogModel {
+  findByScopeKey(scopeKey: string): Promise<ReleaseCatalogRow | null>;
+  findMany(input: {
+    readonly afterScopeKey?: string;
+    readonly limit: number;
+  }): Promise<readonly ReleaseCatalogRow[]>;
+}
+interface AnalyticsScanCursor {
+  readonly receivedAtMs: number;
+  readonly id: string;
+}
+interface AnalyticsScanInput {
+  readonly beforeReceivedAtMs: number;
+  readonly after?: AnalyticsScanCursor;
+  readonly limit: number;
+}
+interface AnalyticsModel {
+  append(row: BundleEventRow): Promise<void>;
+  scan(input: AnalyticsScanInput): Promise<readonly BundleEventRow[]>;
+}
+interface ApiKeyModel {
+  create(row: ApiKeyRow): Promise<"created" | "existing">;
+  findByHash(hash: string): Promise<ApiKeyRow | null>;
+  list(): Promise<readonly ApiKeyRow[]>;
+  revoke(input: {
+    readonly id: string;
+    readonly revokedAtMs: number;
+  }): Promise<ApiKeyRow | null>;
+}
+interface ChannelInsertInput {
+  readonly row: ChannelRow;
+  readonly onConflict: "returnExisting";
+}
+interface ChannelInsertResult {
+  readonly row: ChannelRow;
+  readonly inserted: boolean;
+}
+interface ChannelDeleteInput {
+  readonly id: string;
+}
+type ChannelDeleteResult = {
+  readonly deleted: true;
+} | {
+  readonly deleted: false;
+  readonly reason: "not_found" | "not_empty";
+};
+interface ChannelModel {
+  insert(input: ChannelInsertInput): Promise<ChannelInsertResult>;
+  list(input: {}): Promise<{
+    readonly channels: readonly ChannelRow[];
+  }>;
+  delete(input: ChannelDeleteInput): Promise<ChannelDeleteResult>;
+}
+type DatabaseChange = {
+  readonly model: "bundles";
+  readonly operation: "insert";
+  readonly row: BundleRow;
+} | {
+  readonly model: "bundles";
+  readonly operation: "update";
+  readonly where: {
+    readonly id: string;
+  };
+  readonly update: BundleRowUpdate;
+} | {
+  readonly model: "bundles";
+  readonly operation: "delete";
+  readonly where: {
+    readonly id: string;
+  };
+} | {
+  readonly model: "bundlePatches";
+  readonly operation: "insert";
+  readonly row: BundlePatchRow;
+} | {
+  readonly model: "bundlePatches";
+  readonly operation: "delete";
+  readonly where: {
+    readonly bundleId: string;
+  };
+} | {
+  readonly model: "releases";
+  readonly operation: "insert";
+  readonly row: ReleaseRow;
+} | {
+  readonly model: "releases";
+  readonly operation: "update";
+  readonly where: {
+    readonly id: string;
+  };
+  readonly update: ReleaseRowUpdate;
+} | {
+  readonly model: "releases";
+  readonly operation: "delete";
+  readonly where: {
+    readonly id: string;
+  };
+} | {
+  readonly model: "releaseCatalogs";
+  readonly operation: "put";
+  readonly row: ReleaseCatalogRow;
+} | {
+  readonly model: "channels";
+  readonly operation: "insert";
+  readonly row: ChannelRow;
+  readonly onConflict: "ignore";
+} | {
+  readonly model: "channels";
+  readonly operation: "delete";
+  readonly where: {
+    readonly id: string;
+  };
+} | {
+  readonly model: "analytics";
+  readonly operation: "insert";
+  readonly row: BundleEventRow;
+} | {
+  readonly model: "apiKeys";
+  readonly operation: "insert";
+  readonly row: ApiKeyRow;
+  readonly onConflict: "ignore";
+} | {
+  readonly model: "apiKeys";
+  readonly operation: "update";
+  readonly where: {
+    readonly id: string;
+  };
+  readonly update: {
+    readonly revokedAtMs: number;
+  };
+};
+type DatabaseCommitExpectation = {
+  readonly model: "releases";
+  readonly id: string;
+  readonly revision: number | null;
+} | {
+  readonly model: "releaseCatalogs";
+  readonly scopeKey: string;
+  readonly generation: number | null;
+};
+interface DatabaseCommit {
+  readonly changes: readonly DatabaseChange[];
+  readonly expectations?: readonly DatabaseCommitExpectation[];
+}
+type BundleRepositoryBundleChange = Extract<DatabaseChange, {
+  readonly model: "bundles" | "bundlePatches";
+}>;
+type BundleRepositoryChannelChange = Extract<DatabaseChange, {
+  readonly model: "channels";
+}>;
+type BundleRepositoryChange = BundleRepositoryBundleChange | BundleRepositoryChannelChange;
+/**
+ * The atomic envelopes supported by a bundle-management repository.
+ *
+ * Bundle and patch changes form one aggregate commit. Channel lifecycle is a
+ * separate single-change commit because the standalone HTTP boundary cannot
+ * atomically combine a Channel write with a bundle aggregate write.
+ */
+type BundleRepositoryCommit = {
+  readonly changes: readonly BundleRepositoryBundleChange[];
+} | {
+  readonly changes: readonly [BundleRepositoryChannelChange];
+};
+type DatabaseCommitResult = {
+  readonly committed: true;
+} | {
+  readonly committed: false;
+  readonly conflict: {
+    readonly changeIndex: number;
+    readonly reason: "not_found" | "referenced";
+  } | {
+    readonly changeIndex: -1;
+    readonly reason: "version_conflict";
+    readonly model: "releases" | "releaseCatalogs";
+    readonly key: string;
+    readonly expectedVersion: number | null;
+    readonly actualVersion: number | null;
+  };
+};
+interface DatabaseModels {
+  readonly bundles: BundleModel;
+  readonly bundlePatches: BundlePatchModel;
+  readonly releases: ReleaseModel;
+  readonly releaseCatalogs: ReleaseCatalogModel;
+  readonly channels: ChannelModel;
+  readonly analytics: AnalyticsModel;
+  readonly apiKeys: ApiKeyModel;
+}
+interface BundleRepository {
+  readonly name: string;
+  readonly models: Pick<DatabaseModels, "bundles" | "bundlePatches" | "channels" | "releaseCatalogs" | "releases">;
+  commit(input: DatabaseCommit): Promise<DatabaseCommitResult>;
+  dispose?: () => Promise<void>;
+}
+interface DatabasePlugin {
+  readonly name: string;
+  readonly models: DatabaseModels;
+  commit(input: DatabaseCommit): Promise<DatabaseCommitResult>;
+  dispose?: () => Promise<void>;
+}
+//#endregion
+export { AnalyticsModel, AnalyticsScanCursor, AnalyticsScanInput, ApiKeyModel, BundleModel, BundleModelQuery, BundlePatchModel, BundleRepository, BundleRepositoryChange, BundleRepositoryCommit, ChannelDeleteInput, ChannelDeleteResult, ChannelInsertInput, ChannelInsertResult, ChannelModel, DatabaseChange, DatabaseCommit, DatabaseCommitExpectation, DatabaseCommitResult, DatabaseModels, DatabasePlugin, ReleaseCatalogModel, ReleaseModel };

package/dist/types/databasePlugin.d.mts

@@ -0,0 +1,240 @@
+import { ApiKeyRow, BundleEventRow, BundlePatchRow, BundleRow, ChannelRow, ReleaseCatalogRow, ReleaseRow } from "./databaseRows.mjs";
+import { BundleRowUpdate, ReleaseRowUpdate } from "./databaseOperations.mjs";
+import { DatabaseBundleQueryOrder, DatabaseBundleQueryWhere } from "./index.mjs";
+
+//#region src/types/databasePlugin.d.ts
+interface BundleModelQuery {
+  readonly where?: DatabaseBundleQueryWhere;
+  readonly limit: number;
+  readonly offset: number;
+  readonly orderBy: DatabaseBundleQueryOrder;
+}
+interface BundleModel {
+  findById(id: string): Promise<BundleRow | null>;
+  findMany(query: BundleModelQuery): Promise<readonly BundleRow[]>;
+  count(where?: DatabaseBundleQueryWhere): Promise<number>;
+}
+interface BundlePatchModel {
+  findByBundleIds(bundleIds: readonly string[]): Promise<readonly BundlePatchRow[]>;
+}
+interface ReleaseModel {
+  findById(id: string): Promise<ReleaseRow | null>;
+  findMany(input: {
+    readonly afterReleaseId?: string;
+    readonly beforeReleaseId?: string;
+    readonly bundleId?: string;
+    readonly channelId?: string;
+    readonly enabled?: boolean;
+    readonly platform?: "ios" | "android";
+    readonly targetAppVersion?: string;
+    readonly limit: number;
+  }): Promise<readonly ReleaseRow[]>;
+  findManyByScope(input: {
+    readonly scopeKey: string;
+    readonly afterReleaseId?: string;
+    readonly limit: number;
+    readonly consistency: "strong";
+  }): Promise<readonly ReleaseRow[]>;
+}
+interface ReleaseCatalogModel {
+  findByScopeKey(scopeKey: string): Promise<ReleaseCatalogRow | null>;
+  findMany(input: {
+    readonly afterScopeKey?: string;
+    readonly limit: number;
+  }): Promise<readonly ReleaseCatalogRow[]>;
+}
+interface AnalyticsScanCursor {
+  readonly receivedAtMs: number;
+  readonly id: string;
+}
+interface AnalyticsScanInput {
+  readonly beforeReceivedAtMs: number;
+  readonly after?: AnalyticsScanCursor;
+  readonly limit: number;
+}
+interface AnalyticsModel {
+  append(row: BundleEventRow): Promise<void>;
+  scan(input: AnalyticsScanInput): Promise<readonly BundleEventRow[]>;
+}
+interface ApiKeyModel {
+  create(row: ApiKeyRow): Promise<"created" | "existing">;
+  findByHash(hash: string): Promise<ApiKeyRow | null>;
+  list(): Promise<readonly ApiKeyRow[]>;
+  revoke(input: {
+    readonly id: string;
+    readonly revokedAtMs: number;
+  }): Promise<ApiKeyRow | null>;
+}
+interface ChannelInsertInput {
+  readonly row: ChannelRow;
+  readonly onConflict: "returnExisting";
+}
+interface ChannelInsertResult {
+  readonly row: ChannelRow;
+  readonly inserted: boolean;
+}
+interface ChannelDeleteInput {
+  readonly id: string;
+}
+type ChannelDeleteResult = {
+  readonly deleted: true;
+} | {
+  readonly deleted: false;
+  readonly reason: "not_found" | "not_empty";
+};
+interface ChannelModel {
+  insert(input: ChannelInsertInput): Promise<ChannelInsertResult>;
+  list(input: {}): Promise<{
+    readonly channels: readonly ChannelRow[];
+  }>;
+  delete(input: ChannelDeleteInput): Promise<ChannelDeleteResult>;
+}
+type DatabaseChange = {
+  readonly model: "bundles";
+  readonly operation: "insert";
+  readonly row: BundleRow;
+} | {
+  readonly model: "bundles";
+  readonly operation: "update";
+  readonly where: {
+    readonly id: string;
+  };
+  readonly update: BundleRowUpdate;
+} | {
+  readonly model: "bundles";
+  readonly operation: "delete";
+  readonly where: {
+    readonly id: string;
+  };
+} | {
+  readonly model: "bundlePatches";
+  readonly operation: "insert";
+  readonly row: BundlePatchRow;
+} | {
+  readonly model: "bundlePatches";
+  readonly operation: "delete";
+  readonly where: {
+    readonly bundleId: string;
+  };
+} | {
+  readonly model: "releases";
+  readonly operation: "insert";
+  readonly row: ReleaseRow;
+} | {
+  readonly model: "releases";
+  readonly operation: "update";
+  readonly where: {
+    readonly id: string;
+  };
+  readonly update: ReleaseRowUpdate;
+} | {
+  readonly model: "releases";
+  readonly operation: "delete";
+  readonly where: {
+    readonly id: string;
+  };
+} | {
+  readonly model: "releaseCatalogs";
+  readonly operation: "put";
+  readonly row: ReleaseCatalogRow;
+} | {
+  readonly model: "channels";
+  readonly operation: "insert";
+  readonly row: ChannelRow;
+  readonly onConflict: "ignore";
+} | {
+  readonly model: "channels";
+  readonly operation: "delete";
+  readonly where: {
+    readonly id: string;
+  };
+} | {
+  readonly model: "analytics";
+  readonly operation: "insert";
+  readonly row: BundleEventRow;
+} | {
+  readonly model: "apiKeys";
+  readonly operation: "insert";
+  readonly row: ApiKeyRow;
+  readonly onConflict: "ignore";
+} | {
+  readonly model: "apiKeys";
+  readonly operation: "update";
+  readonly where: {
+    readonly id: string;
+  };
+  readonly update: {
+    readonly revokedAtMs: number;
+  };
+};
+type DatabaseCommitExpectation = {
+  readonly model: "releases";
+  readonly id: string;
+  readonly revision: number | null;
+} | {
+  readonly model: "releaseCatalogs";
+  readonly scopeKey: string;
+  readonly generation: number | null;
+};
+interface DatabaseCommit {
+  readonly changes: readonly DatabaseChange[];
+  readonly expectations?: readonly DatabaseCommitExpectation[];
+}
+type BundleRepositoryBundleChange = Extract<DatabaseChange, {
+  readonly model: "bundles" | "bundlePatches";
+}>;
+type BundleRepositoryChannelChange = Extract<DatabaseChange, {
+  readonly model: "channels";
+}>;
+type BundleRepositoryChange = BundleRepositoryBundleChange | BundleRepositoryChannelChange;
+/**
+ * The atomic envelopes supported by a bundle-management repository.
+ *
+ * Bundle and patch changes form one aggregate commit. Channel lifecycle is a
+ * separate single-change commit because the standalone HTTP boundary cannot
+ * atomically combine a Channel write with a bundle aggregate write.
+ */
+type BundleRepositoryCommit = {
+  readonly changes: readonly BundleRepositoryBundleChange[];
+} | {
+  readonly changes: readonly [BundleRepositoryChannelChange];
+};
+type DatabaseCommitResult = {
+  readonly committed: true;
+} | {
+  readonly committed: false;
+  readonly conflict: {
+    readonly changeIndex: number;
+    readonly reason: "not_found" | "referenced";
+  } | {
+    readonly changeIndex: -1;
+    readonly reason: "version_conflict";
+    readonly model: "releases" | "releaseCatalogs";
+    readonly key: string;
+    readonly expectedVersion: number | null;
+    readonly actualVersion: number | null;
+  };
+};
+interface DatabaseModels {
+  readonly bundles: BundleModel;
+  readonly bundlePatches: BundlePatchModel;
+  readonly releases: ReleaseModel;
+  readonly releaseCatalogs: ReleaseCatalogModel;
+  readonly channels: ChannelModel;
+  readonly analytics: AnalyticsModel;
+  readonly apiKeys: ApiKeyModel;
+}
+interface BundleRepository {
+  readonly name: string;
+  readonly models: Pick<DatabaseModels, "bundles" | "bundlePatches" | "channels" | "releaseCatalogs" | "releases">;
+  commit(input: DatabaseCommit): Promise<DatabaseCommitResult>;
+  dispose?: () => Promise<void>;
+}
+interface DatabasePlugin {
+  readonly name: string;
+  readonly models: DatabaseModels;
+  commit(input: DatabaseCommit): Promise<DatabaseCommitResult>;
+  dispose?: () => Promise<void>;
+}
+//#endregion
+export { AnalyticsModel, AnalyticsScanCursor, AnalyticsScanInput, ApiKeyModel, BundleModel, BundleModelQuery, BundlePatchModel, BundleRepository, BundleRepositoryChange, BundleRepositoryCommit, ChannelDeleteInput, ChannelDeleteResult, ChannelInsertInput, ChannelInsertResult, ChannelModel, DatabaseChange, DatabaseCommit, DatabaseCommitExpectation, DatabaseCommitResult, DatabaseModels, DatabasePlugin, ReleaseCatalogModel, ReleaseModel };