@marinoscar/platform-api 0.0.0-stage → 0.1.0-next.10

package/dist/db-backup/migration-state.util.d.ts

@@ -0,0 +1,62 @@
+import type { DbBackupPrisma } from './data/db-backup-db';
+/** The narrowest slice of Prisma this module needs. Keeps its callers' tests free of a database. */
+type MigrationQueryClient = Pick<DbBackupPrisma, '$queryRaw'>;
+/**
+ * The newest applied migration in the connected database, or `null`.
+ *
+ * `rolled_back_at IS NULL` because a rolled-back migration is one whose schema
+ * change is NOT in this database, and naming it would be worse than naming
+ * nothing. `finished_at IS NOT NULL` for the same reason applied to a
+ * migration that is still running or failed part way.
+ *
+ * BEST-EFFORT: every failure is `null`, never a throw. Both callers treat an
+ * unreadable value as "cannot tell" — the backup still runs (a run that could
+ * not read its provenance is still a valid archive) and the restore gate
+ * degrades to a warning rather than blocking. A missing `_prisma_migrations`
+ * table, or a role without permission to read it, must not be able to stop
+ * either operation.
+ *
+ * @stability experimental
+ */
+export declare function readLatestAppliedMigration(prisma: MigrationQueryClient): Promise<string | null>;
+/**
+ * How an archive's schema relates to the live one.
+ *
+ * @stability experimental
+ */
+export type MigrationComparison = 
+/** Same migration. The archive restores into exactly the schema the code expects. */
+'match'
+/** The archive predates the live schema: restoring it loses later migrations. */
+ | 'archive_older'
+/** The archive is ahead of the live schema: the running code has not seen it. */
+ | 'archive_newer'
+/** One side could not be read. A warning, never a block. */
+ | 'unknown';
+/**
+ * Compares an archive's recorded migration against the live one.
+ *
+ * ⚠ LEXICOGRAPHIC, AND THAT IS CORRECT HERE. Prisma migration directory names
+ * begin with a zero-padded `YYYYMMDDHHMMSS`, so string order is chronological
+ * order for every name Prisma generates. It is not a general-purpose version
+ * compare and must not be reused as one — a hand-renamed migration breaks it,
+ * which is a good reason not to hand-rename migrations.
+ *
+ * BOTH DIRECTIONS ARE A MISMATCH, which is the part people get wrong:
+ *
+ *   - `archive_older` is the obvious one. The restored database is missing
+ *     columns the running code selects, and the first request after the swap
+ *     fails.
+ *   - `archive_newer` is the dangerous one, because it LOOKS harmless. The
+ *     archive has columns the code does not know about — which is fine until
+ *     the deployment that produced it also removed something, renamed
+ *     something, or changed a constraint the old code violates. Worse, Prisma
+ *     will consider the schema up to date and apply nothing, so nobody is ever
+ *     told. It is reported and blocked for the same reason: a restore across a
+ *     schema boundary is a decision, and it has to be made by a human.
+ *
+ * @stability experimental
+ */
+export declare function compareMigrationNames(archiveMigration: string | null, liveMigration: string | null): MigrationComparison;
+export {};
+//# sourceMappingURL=migration-state.util.d.ts.map

package/dist/db-backup/migration-state.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-state.util.d.ts","sourceRoot":"","sources":["../../src/db-backup/migration-state.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAuB1D,oGAAoG;AACpG,KAAK,oBAAoB,GAAG,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;AAE9D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAexB;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB;AAC7B,qFAAqF;AACnF,OAAO;AACT,iFAAiF;GAC/E,eAAe;AACjB,iFAAiF;GAC/E,eAAe;AACjB,4DAA4D;GAC1D,SAAS,CAAC;AAEd;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,qBAAqB,CACnC,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,mBAAmB,CAKrB"}

package/dist/db-backup/migration-state.util.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readLatestAppliedMigration = readLatestAppliedMigration;
+exports.compareMigrationNames = compareMigrationNames;
+/**
+ * The newest applied migration in the connected database, or `null`.
+ *
+ * `rolled_back_at IS NULL` because a rolled-back migration is one whose schema
+ * change is NOT in this database, and naming it would be worse than naming
+ * nothing. `finished_at IS NOT NULL` for the same reason applied to a
+ * migration that is still running or failed part way.
+ *
+ * BEST-EFFORT: every failure is `null`, never a throw. Both callers treat an
+ * unreadable value as "cannot tell" — the backup still runs (a run that could
+ * not read its provenance is still a valid archive) and the restore gate
+ * degrades to a warning rather than blocking. A missing `_prisma_migrations`
+ * table, or a role without permission to read it, must not be able to stop
+ * either operation.
+ *
+ * @stability experimental
+ */
+async function readLatestAppliedMigration(prisma) {
+    try {
+        const rows = await prisma.$queryRaw `
+        SELECT migration_name
+        FROM _prisma_migrations
+        WHERE finished_at IS NOT NULL AND rolled_back_at IS NULL
+        ORDER BY finished_at DESC
+        LIMIT 1
+      `;
+        const value = rows[0]?.migration_name;
+        return typeof value === 'string' && value.length > 0 ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Compares an archive's recorded migration against the live one.
+ *
+ * ⚠ LEXICOGRAPHIC, AND THAT IS CORRECT HERE. Prisma migration directory names
+ * begin with a zero-padded `YYYYMMDDHHMMSS`, so string order is chronological
+ * order for every name Prisma generates. It is not a general-purpose version
+ * compare and must not be reused as one — a hand-renamed migration breaks it,
+ * which is a good reason not to hand-rename migrations.
+ *
+ * BOTH DIRECTIONS ARE A MISMATCH, which is the part people get wrong:
+ *
+ *   - `archive_older` is the obvious one. The restored database is missing
+ *     columns the running code selects, and the first request after the swap
+ *     fails.
+ *   - `archive_newer` is the dangerous one, because it LOOKS harmless. The
+ *     archive has columns the code does not know about — which is fine until
+ *     the deployment that produced it also removed something, renamed
+ *     something, or changed a constraint the old code violates. Worse, Prisma
+ *     will consider the schema up to date and apply nothing, so nobody is ever
+ *     told. It is reported and blocked for the same reason: a restore across a
+ *     schema boundary is a decision, and it has to be made by a human.
+ *
+ * @stability experimental
+ */
+function compareMigrationNames(archiveMigration, liveMigration) {
+    if (archiveMigration === null || liveMigration === null)
+        return 'unknown';
+    if (archiveMigration === liveMigration)
+        return 'match';
+    return archiveMigration < liveMigration ? 'archive_older' : 'archive_newer';
+}
+//# sourceMappingURL=migration-state.util.js.map

package/dist/db-backup/migration-state.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-state.util.js","sourceRoot":"","sources":["../../src/db-backup/migration-state.util.ts"],"names":[],"mappings":";;AA2CA,gEAiBC;AAyCD,sDAQC;AAnFD;;;;;;;;;;;;;;;;GAgBG;AACI,KAAK,UAAU,0BAA0B,CAC9C,MAA4B;IAE5B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,SAAS,CAAoC;;;;;;OAMpE,CAAC;QACJ,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC;QAEtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAiBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,qBAAqB,CACnC,gBAA+B,EAC/B,aAA4B;IAE5B,IAAI,gBAAgB,KAAK,IAAI,IAAI,aAAa,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC1E,IAAI,gBAAgB,KAAK,aAAa;QAAE,OAAO,OAAO,CAAC;IAEvD,OAAO,gBAAgB,GAAG,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC;AAC9E,CAAC"}

package/dist/db-backup/options.d.ts

@@ -0,0 +1,160 @@
+import type { ModuleMetadata } from '@nestjs/common';
+import type { PortBinding } from '../core/index';
+import type { BackupTarget } from './backup-target';
+import type { RestoreCarryOver } from './carry-over.registry';
+/**
+ * Injection token of the resolved {@link DbBackupModuleOptions}. Optional to
+ * every consumer: without it the shipped defaults apply.
+ *
+ * @stability experimental
+ */
+export declare const DB_BACKUP_OPTIONS: unique symbol;
+/**
+ * The application name a backup key is derived from when the app passes none.
+ *
+ * @stability stable
+ */
+export declare const DEFAULT_DB_BACKUP_APP_NAME = "app";
+/**
+ * Options of `DbBackupModule.forRoot()`. Every field is optional.
+ *
+ * @stability experimental
+ */
+export interface DbBackupModuleOptions {
+    /**
+     * The application name in every archive's key and file name
+     * (`database-backups/<slug>/YYYY/MM/<slug>-<ts>-<runId>.dump`), slugified.
+     * Default {@link DEFAULT_DB_BACKUP_APP_NAME}; the reference app passes its
+     * `APP_NAME`. Changing it changes where NEW archives land; existing runs
+     * keep the key they recorded.
+     */
+    appName?: string;
+    /**
+     * The application version recorded on every run (`app_version`). Default:
+     * `APP_VERSION`, else `npm_package_version`, else `'0.0.0'`.
+     */
+    appVersion?: string | (() => string);
+    /**
+     * The deployment mode. Default: the `DB_BACKUP_DEPLOYMENT_MODE` port when
+     * the app binds it, else `'self-hosted'`. `'saas'` turns in-app restore off
+     * (spec, Scaling posture, red flag 7: use the provider's point-in-time
+     * recovery instead); backups keep working.
+     */
+    deploymentMode?: 'self-hosted' | 'saas' | (string & {});
+    /**
+     * An explicit override of the restore surface (the restore and rollback
+     * routes, `db.restore.run`, the restore pre-flight and the page's restore
+     * actions). Default: `deploymentMode !== 'saas'`.
+     */
+    restoreEnabled?: boolean;
+    /**
+     * The process-level scheduler switch. Default: the app's
+     * `dbBackup.scheduleEnabled` config key (
+     * `DB_BACKUP_SCHEDULE_ENABLED !== 'false'`), else on.
+     */
+    scheduleEnabled?: boolean;
+    /**
+     * Tables whose rows must survive a restore, besides the four built-in
+     * carries (the backup catalog, its self-links, the restore's own job row and
+     * the completion audit row). Registered into the `RestoreCarryOver`
+     * registry at `forRoot` time; an app can also call
+     * `registerRestoreCarryOver` from its own file before bootstrap.
+     */
+    extraCarryOver?: readonly RestoreCarryOver[];
+    /**
+     * Where archives live: the primary backup target (PP-14.12). Default: an
+     * adapter over the active `STORAGE_PROVIDER`, which is what the engine did
+     * before the port existed. An app target replaces it (its `id` is recorded on
+     * every run and must equal `databaseBackup.storageProvider` when that is set);
+     * a worker node can take a backup only for the default target, so with an app
+     * target node offload is never offered. The binding is resolved in the
+     * slice's own module: its dependencies come from `imports` and global
+     * modules. See `backup-target.ts`.
+     *
+     * @example
+     * ```ts
+     * DbBackupModule.forRoot({ target: { useClass: VaultBackupTarget }, imports: [VaultModule] });
+     * ```
+     *
+     * @extensionPoint option
+     */
+    target?: PortBinding<BackupTarget>;
+    /**
+     * Targets that receive a copy of every archive after the primary's write was
+     * verified (PP-14.12). A failed mirror never fails the run: it is recorded and
+     * the `backup.mirrors` Doctor check warns. Retention and the admin delete
+     * remove the copies with the original (best effort). Each id must be unique
+     * and different from the primary's.
+     *
+     * @example
+     * ```ts
+     * DbBackupModule.forRoot({ mirrorTargets: [{ useClass: LocalDirBackupTarget }] });
+     * ```
+     *
+     * @extensionPoint option
+     */
+    mirrorTargets?: readonly PortBinding<BackupTarget>[];
+    /**
+     * Modules to import next to the slice: typically the app's `@Global()` host
+     * module binding `DB_BACKUP_NOTIFIER`, `DB_BACKUP_MAINTENANCE`,
+     * `DB_BACKUP_METRICS`, `DB_BACKUP_DEPLOYMENT_MODE` and `DB_BACKUP_SYSTEM_DATA`.
+     */
+    imports?: ModuleMetadata['imports'];
+}
+/**
+ * {@link DbBackupModuleOptions} with every default applied. `restoreEnabled`
+ * and `scheduleEnabled` stay optional: absent means "decide from the port /
+ * the config key at boot".
+ *
+ * @stability experimental
+ */
+export interface ResolvedDbBackupModuleOptions {
+    /** The application name. */
+    readonly appName: string;
+    /** The application version resolver. */
+    readonly appVersion: () => string;
+    /** The deployment mode, when the app passed one. */
+    readonly deploymentMode?: 'self-hosted' | 'saas' | (string & {});
+    /** The restore override, when the app passed one. */
+    readonly restoreEnabled?: boolean;
+    /** The scheduler override, when the app passed one. */
+    readonly scheduleEnabled?: boolean;
+    /** The primary target's binding, or `undefined` for the default adapter over `STORAGE_PROVIDER`. */
+    readonly target?: PortBinding<BackupTarget>;
+    /** The mirror targets' bindings (empty when none). */
+    readonly mirrorTargets: readonly PortBinding<BackupTarget>[];
+    /** The modules imported next to the slice. */
+    readonly imports: NonNullable<ModuleMetadata['imports']>;
+}
+/**
+ * The application version recorded on a run when the app passes none:
+ * `APP_VERSION`, else `npm_package_version`, else `'0.0.0'`.
+ *
+ * @returns the version string.
+ * @stability experimental
+ */
+export declare function defaultAppVersion(): string;
+/**
+ * Applies the defaults and refuses an invalid option at `forRoot()` time.
+ *
+ * @param options - what the app passed.
+ * @returns the resolved options.
+ * @throws Error when `deploymentMode` is not `'self-hosted'` or `'saas'`.
+ *
+ * @stability experimental
+ */
+export declare function resolveDbBackupModuleOptions(options?: DbBackupModuleOptions): ResolvedDbBackupModuleOptions;
+/**
+ * Whether in-app restore is on for these options and the deployment mode the
+ * app reported: an explicit `restoreEnabled` wins, then an explicit
+ * `deploymentMode`, then the port's mode; nothing at all means self-hosted.
+ *
+ * @param options - the resolved options.
+ * @param portMode - the `DB_BACKUP_DEPLOYMENT_MODE` port's mode, when bound.
+ * @param portInAppRestore - the port's `inAppRestoreEnabled`, when it reports one.
+ * @returns `true` when restore is available.
+ *
+ * @stability experimental
+ */
+export declare function resolveRestoreEnabled(options: Pick<ResolvedDbBackupModuleOptions, 'deploymentMode' | 'restoreEnabled'>, portMode?: 'self-hosted' | 'saas' | (string & {}), portInAppRestore?: boolean): boolean;
+//# sourceMappingURL=options.d.ts.map

package/dist/db-backup/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/db-backup/options.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,MAA6D,CAAC;AAErG;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,QAAQ,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IACrC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACxD;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IACnC;;;;;;;;;;;;;OAaG;IACH,aAAa,CAAC,EAAE,SAAS,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC;IACrD;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;CACrC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,6BAA6B;IAC5C,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,CAAC;IAClC,oDAAoD;IACpD,QAAQ,CAAC,cAAc,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACjE,qDAAqD;IACrD,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,uDAAuD;IACvD,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,oGAAoG;IACpG,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IAC5C,sDAAsD;IACtD,QAAQ,CAAC,aAAa,EAAE,SAAS,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC;IAC7D,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC;CAC1D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,qBAA0B,GAAG,6BAA6B,CA8B/G;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,IAAI,CAAC,6BAA6B,EAAE,gBAAgB,GAAG,gBAAgB,CAAC,EACjF,QAAQ,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,EACjD,gBAAgB,CAAC,EAAE,OAAO,GACzB,OAAO,CAOT"}

package/dist/db-backup/options.js

@@ -0,0 +1,103 @@
+"use strict";
+// =============================================================================
+// `DbBackupModule.forRoot()` options (issue #740, PP-8.7)
+// =============================================================================
+//
+// Rung 1 of the extension ladder: every option defaults to the behaviour the
+// reference app had before the move. NO OPTION ADDS AN ENVIRONMENT VARIABLE:
+// the deployment mode comes from `DEPLOYMENT_MODE` (#685) through the
+// `DB_BACKUP_DEPLOYMENT_MODE` port, the scheduler switch from the existing
+// `DB_BACKUP_SCHEDULE_ENABLED` (the app's `dbBackup.scheduleEnabled` config
+// key), and the bypass connection is the `POSTGRES_*` connection itself with
+// the `app.rls_bypass` startup option (#725).
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_DB_BACKUP_APP_NAME = exports.DB_BACKUP_OPTIONS = void 0;
+exports.defaultAppVersion = defaultAppVersion;
+exports.resolveDbBackupModuleOptions = resolveDbBackupModuleOptions;
+exports.resolveRestoreEnabled = resolveRestoreEnabled;
+/**
+ * Injection token of the resolved {@link DbBackupModuleOptions}. Optional to
+ * every consumer: without it the shipped defaults apply.
+ *
+ * @stability experimental
+ */
+exports.DB_BACKUP_OPTIONS = Symbol.for('@marinoscar/platform/db-backup/OPTIONS');
+/**
+ * The application name a backup key is derived from when the app passes none.
+ *
+ * @stability stable
+ */
+exports.DEFAULT_DB_BACKUP_APP_NAME = 'app';
+/**
+ * The application version recorded on a run when the app passes none:
+ * `APP_VERSION`, else `npm_package_version`, else `'0.0.0'`.
+ *
+ * @returns the version string.
+ * @stability experimental
+ */
+function defaultAppVersion() {
+    return process.env.APP_VERSION || process.env.npm_package_version || '0.0.0';
+}
+/**
+ * Applies the defaults and refuses an invalid option at `forRoot()` time.
+ *
+ * @param options - what the app passed.
+ * @returns the resolved options.
+ * @throws Error when `deploymentMode` is not `'self-hosted'` or `'saas'`.
+ *
+ * @stability experimental
+ */
+function resolveDbBackupModuleOptions(options = {}) {
+    if (options.deploymentMode !== undefined && options.deploymentMode !== 'self-hosted' && options.deploymentMode !== 'saas') {
+        throw new Error(`DbBackupModule.forRoot(): deploymentMode must be 'self-hosted' or 'saas' (got ${String(options.deploymentMode)})`);
+    }
+    const checkBinding = (binding, where) => {
+        const kinds = binding !== null && typeof binding === 'object'
+            ? ['useExisting', 'useClass', 'useFactory'].filter((kind) => kind in binding)
+            : [];
+        if (kinds.length !== 1) {
+            throw new Error(`DbBackupModule.forRoot(): ${where} needs exactly one of useExisting, useClass or useFactory`);
+        }
+    };
+    if (options.target !== undefined)
+        checkBinding(options.target, '`target`');
+    const mirrorTargets = options.mirrorTargets ?? [];
+    if (!Array.isArray(mirrorTargets))
+        throw new Error('DbBackupModule.forRoot(): `mirrorTargets` must be an array of bindings');
+    mirrorTargets.forEach((binding, index) => checkBinding(binding, `\`mirrorTargets[${index}]\``));
+    const version = options.appVersion;
+    return Object.freeze({
+        appName: options.appName && options.appName.trim() !== '' ? options.appName : exports.DEFAULT_DB_BACKUP_APP_NAME,
+        appVersion: typeof version === 'function' ? version : version !== undefined ? () => version : defaultAppVersion,
+        ...(options.deploymentMode !== undefined ? { deploymentMode: options.deploymentMode } : {}),
+        ...(options.restoreEnabled !== undefined ? { restoreEnabled: options.restoreEnabled } : {}),
+        ...(options.scheduleEnabled !== undefined ? { scheduleEnabled: options.scheduleEnabled } : {}),
+        ...(options.target !== undefined ? { target: options.target } : {}),
+        mirrorTargets: Object.freeze([...mirrorTargets]),
+        imports: options.imports ?? [],
+    });
+}
+/**
+ * Whether in-app restore is on for these options and the deployment mode the
+ * app reported: an explicit `restoreEnabled` wins, then an explicit
+ * `deploymentMode`, then the port's mode; nothing at all means self-hosted.
+ *
+ * @param options - the resolved options.
+ * @param portMode - the `DB_BACKUP_DEPLOYMENT_MODE` port's mode, when bound.
+ * @param portInAppRestore - the port's `inAppRestoreEnabled`, when it reports one.
+ * @returns `true` when restore is available.
+ *
+ * @stability experimental
+ */
+function resolveRestoreEnabled(options, portMode, portInAppRestore) {
+    if (options.restoreEnabled !== undefined)
+        return options.restoreEnabled;
+    // The port's own answer (the host's `inAppRestore` capability, which an app
+    // mode may set) decides when no option named a mode.
+    if (options.deploymentMode === undefined && portInAppRestore !== undefined)
+        return portInAppRestore;
+    const mode = options.deploymentMode ?? portMode ?? 'self-hosted';
+    return mode !== 'saas';
+}
+//# sourceMappingURL=options.js.map

package/dist/db-backup/options.js.map

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