@marinoscar/platform-web 0.0.0-stage → 0.1.0-next.4

package/dist/db-backup/headless/db-backup-client.d.ts.map

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

package/dist/db-backup/headless/db-backup-client.js

@@ -0,0 +1,301 @@
+/**
+ * The database-backup API, as the web app sees it (issue #287, epic #254).
+ *
+ * ONE MODULE FOR TEN ROUTES ON ONE CONTROLLER, shaped exactly like
+ * `services/jobs.ts` (#266) and `services/nodes.ts` (#271): `services/api.ts`
+ * stays the transport — the `ApiService` instance, the refresh dance, the
+ * maintenance recogniser — and an epic's own surface gets a module where its
+ * calls sit next to the types they produce. Everything below goes through the
+ * shared `api` client, so a backup request inherits the token refresh, the 401
+ * retry and the maintenance interception like every other call in the app.
+ * That last one is not incidental here: this is the one page in the
+ * application that deliberately causes a maintenance window, and it must be
+ * gated by the same central recogniser as everything else rather than by a
+ * special case of its own.
+ *
+ * =============================================================================
+ * THE BYTE COUNTS ARE STRINGS, AND THEY STAY STRINGS
+ * =============================================================================
+ *
+ * `sizeBytes` and `bytesWritten` are `BigInt` columns, and the API publishes
+ * them as DECIMAL STRINGS (`^\d+$`) rather than as JSON numbers, because a
+ * multi-terabyte dump exceeds `Number.MAX_SAFE_INTEGER` and JSON has no integer
+ * type to protect it. They are typed as `string` here for the same reason, and
+ * nothing in this app widens them to `number` at the boundary.
+ *
+ * `parseByteCount` is the ONE place a string becomes a number, it is used only
+ * for FORMATTING and for the progress ratio, and it says so: at those sizes a
+ * few bits of mantissa are invisible in "1.4 TB" and in a percentage, whereas
+ * the same rounding applied at the transport boundary would silently corrupt a
+ * value that later gets compared or summed. It returns `null` rather than
+ * `NaN` for anything it cannot read, so a caller cannot accidentally render
+ * "NaN B".
+ *
+ * =============================================================================
+ * THE PRECONDITION PREDICATES MIRROR THE API'S REFUSALS
+ * =============================================================================
+ *
+ * `db-backup.controller.ts` answers 400 for a download of a run that is not
+ * `completed`, for a delete of a run that is still active, for a cancel of a
+ * run that has finished, for a restore of a run that is not `completed`, and
+ * for a rollback of a run that was never restored. Each of those has a
+ * predicate below, and the page disables the corresponding control from it —
+ * so a precondition is READ OFF THE UI rather than discovered by clicking and
+ * being refused. They are exported from the service module, next to the routes
+ * whose rules they mirror, exactly as `isJobActionable` and
+ * `nodeCredentialStatus` are.
+ *
+ * =============================================================================
+ * THE CONFIRMATION LITERALS ARE CONSTANTS, AND THEY ARE DIFFERENT WORDS
+ * =============================================================================
+ *
+ * `RESTORE` and `ROLLBACK` are Zod literals on the API's DTOs
+ * (`db-backup-restore.dto.ts`), and the pipe refuses anything else before the
+ * service is reached — so a mis-fired or replayed POST cannot reconstruct one
+ * by accident. They are two DIFFERENT words on purpose: a body copied from one
+ * route to the other is refused rather than silently accepted. The dialog makes
+ * the operator type the literal, and it compares against these constants rather
+ * than against a string typed a second time in a component.
+ */
+import { BACKUP_FREQUENCIES, BACKUP_STATUSES, BACKUP_TRIGGERS, BUILTIN_RESTORE_GATE_IDS, RESTORE_CONFIRMATION, RESTORE_ROLLBACK_MODES, RESTORE_SCHEMA_OVERRIDE_FIELD, RESTORE_STATUSES, ROLLBACK_CONFIRMATION, } from '@marinoscar/platform-contract/db-backup';
+// The value lists are the contract's (`@marinoscar/platform-contract/db-backup`,
+// #740): the API's enums are built from the same tuples.
+// =============================================================================
+// Enumerations — the API's own, restated so a bad value cannot compile
+// =============================================================================
+/**
+ * `DatabaseBackupRunDto.status` — the lifecycle of one dump.
+ *
+ *   `pending`   — claimed, nothing streamed yet.
+ *   `running`   — `pg_dump` is streaming into object storage.
+ *   `completed` — archive uploaded, checksummed and read back.
+ *   `failed`    — the dump or the upload failed; the partial archive is gone.
+ *   `stale`     — the run stopped heartbeating and the sweep released its slot.
+ *                 NOT the same as `failed`: nobody knows how it ended, and its
+ *                 archive may or may not exist. See the table module for why
+ *                 that difference is drawn on screen and not just in the enum.
+ *
+ * @stability experimental
+ */
+export const DB_BACKUP_RUN_STATUSES = BACKUP_STATUSES;
+/**
+ * What caused a run. `pre_restore` is the safety dump the restore path takes
+ * immediately before a swap, and an operator must be able to tell it from a
+ * backup they asked for — it is the archive a rollback falls back to.
+ *
+ * @stability experimental
+ */
+export const DB_BACKUP_TRIGGERS = BACKUP_TRIGGERS;
+/**
+ * `databaseBackup.frequency`.
+ *
+ * @stability experimental
+ */
+export const DB_BACKUP_FREQUENCIES = BACKUP_FREQUENCIES;
+/**
+ * `databaseBackup.restoreRollbackMode` — what a restore does with the database
+ * it displaces, and therefore what a rollback COSTS.
+ *
+ *   `retain_database` — keep it, renamed. Rolling back is a catalog rename:
+ *                       SECONDS. Costs roughly double the volume for
+ *                       `oldDatabaseRetentionHours`.
+ *   `drop_database`   — drop it. Rolling back means restoring the pre-restore
+ *                       dump: HOURS.
+ */
+export { RESTORE_ROLLBACK_MODES };
+/**
+ * The restore audit state on the run the restore was performed FROM.
+ *
+ * `restoring` → `verifying` → `swapping` → `completed` | `failed`, plus
+ * `rolled_back` once a completed restore has been undone. `null` means this
+ * archive has never been restored, which is what makes the rollback route a
+ * 400 rather than a no-op.
+ */
+export { RESTORE_STATUSES };
+/**
+ * The pre-flight gates, by id (`rls_bypass` since #740). Every one of them is
+ * reported on every restore attempt, passes included — see
+ * `RestorePreflight.gates`.
+ */
+export { BUILTIN_RESTORE_GATE_IDS };
+/**
+ * The same eight ids under their former name.
+ *
+ * @deprecated Renamed {@link BUILTIN_RESTORE_GATE_IDS}: the gate id is open now (an app registers its own gates).
+ * @stability experimental
+ */
+export const RESTORE_GATE_IDS = BUILTIN_RESTORE_GATE_IDS;
+/**
+ * The exact strings the API's Zod literals require
+ * (`db-backup-restore.dto.ts`). Two different words, deliberately.
+ */
+export { RESTORE_CONFIRMATION, ROLLBACK_CONFIRMATION };
+/**
+ * The one value `block.overrideParameter` can name today, and the field the
+ * dialog's separate override control sets.
+ *
+ * The API is explicit that this flag unblocks THE SCHEMA GATE AND NOTHING
+ * ELSE: no amount of accepting a mismatch makes a role without `CREATEDB` able
+ * to create a database. The dialog therefore offers the override only when the
+ * block names this parameter, never as a general "force" switch.
+ *
+ * @stability experimental
+ */
+export const OVERRIDE_SCHEMA_CHECK_PARAMETER = RESTORE_SCHEMA_OVERRIDE_FIELD;
+// =============================================================================
+// Requests
+// =============================================================================
+const BASE = '/admin/db-backup';
+/**
+ * The db-backup client over a {@link PlatformApiClient} (the platform host's
+ * transport: the reference app's `api` service). Keep the result's identity
+ * stable (`useMemo`), as the hooks do.
+ *
+ * @param api - the transport.
+ * @returns the client.
+ *
+ * @stability experimental
+ */
+export function createDbBackupApi(api) {
+    return {
+        async getDbBackupConfig() {
+            return api.get(`${BASE}/config`);
+        },
+        async updateDbBackupConfig(input) {
+            return api.put(`${BASE}/config`, input);
+        },
+        async startBackupRun() {
+            return api.post(`${BASE}/runs`);
+        },
+        async getBackupRuns(params = {}) {
+            const query = new URLSearchParams();
+            if (params.page)
+                query.set('page', String(params.page));
+            if (params.pageSize)
+                query.set('pageSize', String(params.pageSize));
+            if (params.status)
+                query.set('status', params.status);
+            if (params.trigger)
+                query.set('trigger', params.trigger);
+            return api.get(`${BASE}/runs?${query}`);
+        },
+        async getBackupRun(id) {
+            return api.get(`${BASE}/runs/${id}`);
+        },
+        async getBackupDownloadUrl(id) {
+            return api.get(`${BASE}/runs/${id}/download`);
+        },
+        async cancelBackupRun(id) {
+            return api.post(`${BASE}/runs/${id}/cancel`);
+        },
+        async deleteBackupRun(id) {
+            return api.delete(`${BASE}/runs/${id}`);
+        },
+        async startRestore(id, options = {}) {
+            const body = {
+                confirmation: RESTORE_CONFIRMATION,
+            };
+            if (options.overrideSchemaCheck)
+                body.overrideSchemaCheck = true;
+            return api.post(`${BASE}/runs/${id}/restore`, body);
+        },
+        async rollbackRestore(id) {
+            return api.post(`${BASE}/runs/${id}/rollback`, {
+                confirmation: ROLLBACK_CONFIRMATION,
+            });
+        },
+    };
+}
+// =============================================================================
+// Shared predicates — mirrors of the API's own refusals
+// =============================================================================
+/**
+ * Holding the single active slot: `pending` or `running`.
+ *
+ * @stability experimental
+ */
+export function isBackupRunActive(run) {
+    return run.status === 'pending' || run.status === 'running';
+}
+/**
+ * Whether an archive can be downloaded or restored.
+ *
+ * `completed` and nothing else — the same rule `getDownloadUrl` and
+ * `requireRunForRestore` both enforce. A `stale` run is deliberately NOT
+ * downloadable: nobody knows how it ended, so its archive may be truncated.
+ *
+ * @stability experimental
+ */
+export function isBackupDownloadable(run) {
+    return run.status === 'completed';
+}
+/**
+ * Restoring has the same `completed`-only precondition the download does.
+ *
+ * @stability experimental
+ */
+export function isBackupRestorable(run) {
+    return run.status === 'completed';
+}
+/**
+ * The API refuses to delete a run that is still active — its archive is mid-upload.
+ *
+ * @stability experimental
+ */
+export function isBackupDeletable(run) {
+    return !isBackupRunActive(run);
+}
+/**
+ * Only an active run can be cancelled; one that has finished is a 400.
+ *
+ * @stability experimental
+ */
+export function isBackupCancelable(run) {
+    return isBackupRunActive(run);
+}
+/**
+ * Whether a restore performed FROM this archive is still moving.
+ *
+ * The three non-terminal states, and what the page watches to know a restart is
+ * expected.
+ *
+ * @stability experimental
+ */
+export function isRestoreInFlight(run) {
+    return (run.restoreStatus === 'restoring' ||
+        run.restoreStatus === 'verifying' ||
+        run.restoreStatus === 'swapping');
+}
+/**
+ * Whether the rollback route has a swap to undo.
+ *
+ * `restoreStatus !== null` on a `completed` run, which is exactly what
+ * `rollbackRestore` checks before it refuses with `restore_never_ran`. Note it
+ * is deliberately NOT narrowed to `restoreStatus === 'completed'`: a restore
+ * that failed mid-swap is precisely the case an operator most needs to undo.
+ *
+ * @stability experimental
+ */
+export function isRollbackAvailable(run) {
+    return run.status === 'completed' && run.restoreStatus !== null;
+}
+/**
+ * A decimal byte string as a number, for FORMATTING ONLY — see the module
+ * header on why the transported value stays a string.
+ *
+ * `null` (not `NaN`, and not `0`) for anything unreadable, so a caller renders
+ * "unknown" rather than a confident wrong number. `null` in means `null` out:
+ * `freeDiskBytes` is genuinely absent on many hosts, and that is a different
+ * fact from "zero bytes free".
+ *
+ * @stability experimental
+ */
+export function parseByteCount(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (!/^\d+$/.test(value.trim()))
+        return null;
+    const parsed = Number(value.trim());
+    return Number.isFinite(parsed) ? parsed : null;
+}
+//# sourceMappingURL=db-backup-client.js.map

package/dist/db-backup/headless/db-backup-client.js.map

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

package/dist/db-backup/headless/index.d.ts

@@ -0,0 +1,12 @@
+export { BUILTIN_RESTORE_GATE_IDS, DB_BACKUP_FREQUENCIES, DB_BACKUP_RUN_STATUSES, DB_BACKUP_TRIGGERS, OVERRIDE_SCHEMA_CHECK_PARAMETER, RESTORE_CONFIRMATION, RESTORE_GATE_IDS, RESTORE_ROLLBACK_MODES, RESTORE_STATUSES, ROLLBACK_CONFIRMATION, createDbBackupApi, isBackupCancelable, isBackupDeletable, isBackupDownloadable, isBackupRestorable, isBackupRunActive, isRestoreInFlight, isRollbackAvailable, parseByteCount, } from './db-backup-client.js';
+/** @stability experimental */
+export type { BackupDownloadUrl, CancelBackupResult, DbBackupApi, DbBackupConfig, DbBackupFrequency, DbBackupRetention, DbBackupRestoreAvailability, DbBackupRestoreUnavailableReason, DbBackupRun, DbBackupRunListParams, DbBackupRunListResponse, DbBackupRunStatus, DbBackupTrigger, DeleteBackupResult, EffectiveRollbackMode, GuidedRestoreInstructions, RestoreBlock, RestoreGate, RestoreGateId, RestoreGateKind, RestoreGateVerdict, RestorePreflight, RestoreRollbackMode, RestoreRollbackPlan, RestoreStatus, RollbackRestoreResult, StartRestoreResult, UpdateDbBackupConfigInput, } from './db-backup-client.js';
+export { DB_BACKUP_POLL_INTERVAL_MS, useDbBackupActions, useDbBackupApi, useDbBackupConfig, useDbBackupRuns, useVisiblePolling, } from './use-db-backup.js';
+/** @stability experimental */
+export type { UseDbBackupActionsResult, UseDbBackupConfigResult, UseDbBackupOptions, UseDbBackupRunsResult, } from './use-db-backup.js';
+export { DbBackupWebAdaptersProvider, useDbBackupWebAdapters } from './adapters.js';
+/** @stability experimental */
+export type { DbBackupWebAdapters } from './adapters.js';
+/** @stability experimental */
+export type { DbBackupDataTableComponent, DbBackupDataTableProps, DbBackupTableColumn, DbBackupTableColumnPriority, DbBackupTableEnumValue, DbBackupTableFilter, DbBackupTableFilterModelOperator, DbBackupTableFilterOperator, DbBackupTableRowAction, DbBackupTableSortState, } from './table.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/db-backup/headless/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/db-backup/headless/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,+BAA+B,EAC/B,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,8BAA8B;AAC9B,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,2BAA2B,EAC3B,gCAAgC,EAChC,WAAW,EACX,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,8BAA8B;AAC9B,YAAY,EACV,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACpF,8BAA8B;AAC9B,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,8BAA8B;AAC9B,YAAY,EACV,0BAA0B,EAC1B,sBAAsB,EACtB,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,EACtB,mBAAmB,EACnB,gCAAgC,EAChC,2BAA2B,EAC3B,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/db-backup/headless/index.js

@@ -0,0 +1,9 @@
+// `@marinoscar/platform-web/db-backup/headless`: the db-backup slice's client
+// and hooks, with no component (issue #740, PP-8.7): `createDbBackupApi` over
+// the platform host's transport, the wire types, the predicates the page's
+// actions share with the API's refusals, and `useDbBackupConfig`,
+// `useDbBackupRuns` and `useDbBackupActions`. Documented in ../README.md.
+export { BUILTIN_RESTORE_GATE_IDS, DB_BACKUP_FREQUENCIES, DB_BACKUP_RUN_STATUSES, DB_BACKUP_TRIGGERS, OVERRIDE_SCHEMA_CHECK_PARAMETER, RESTORE_CONFIRMATION, RESTORE_GATE_IDS, RESTORE_ROLLBACK_MODES, RESTORE_STATUSES, ROLLBACK_CONFIRMATION, createDbBackupApi, isBackupCancelable, isBackupDeletable, isBackupDownloadable, isBackupRestorable, isBackupRunActive, isRestoreInFlight, isRollbackAvailable, parseByteCount, } from './db-backup-client.js';
+export { DB_BACKUP_POLL_INTERVAL_MS, useDbBackupActions, useDbBackupApi, useDbBackupConfig, useDbBackupRuns, useVisiblePolling, } from './use-db-backup.js';
+export { DbBackupWebAdaptersProvider, useDbBackupWebAdapters } from './adapters.js';
+//# sourceMappingURL=index.js.map

package/dist/db-backup/headless/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/db-backup/headless/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,2EAA2E;AAC3E,kEAAkE;AAClE,0EAA0E;AAE1E,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,+BAA+B,EAC/B,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAgC/B,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC"}

package/dist/db-backup/headless/table.d.ts

@@ -0,0 +1,229 @@
+import type { ReactElement, ReactNode } from 'react';
+/**
+ * Where a column shows on a narrow screen: always (`primary`), on the card
+ * (`secondary`) or only in the detail view (`detail`).
+ *
+ * @stability experimental
+ */
+export type DbBackupTableColumnPriority = 'primary' | 'secondary' | 'detail';
+/**
+ * The filter operators the run lists use (`is` on an enum column).
+ *
+ * @stability experimental
+ */
+export type DbBackupTableFilterOperator = 'is';
+/**
+ * One choice of an enum filter.
+ *
+ * @stability experimental
+ */
+export interface DbBackupTableEnumValue {
+    /** The filter value. */
+    value: string;
+    /** What the filter shows. */
+    label: string;
+}
+/**
+ * One column of a run list.
+ *
+ * @typeParam Row - the row type.
+ * @stability experimental
+ */
+export interface DbBackupTableColumn<Row> {
+    /** Stable id (also the sort field for a sortable column). */
+    id: string;
+    /** Header text. */
+    label: string;
+    /** Cell content; defaults to `value`. */
+    render?: (row: Row) => ReactNode;
+    /** The plain value (search, export, the fallback cell). */
+    value?: (row: Row) => string | number | null;
+    /** Cell and header alignment; default left. */
+    align?: 'left' | 'center' | 'right';
+    /** Narrow-screen placement. */
+    priority: DbBackupTableColumnPriority;
+    /** The API can sort by it. */
+    sortable?: boolean;
+    /** The API can filter by it, with these operators. */
+    filterable?: boolean | DbBackupTableFilterOperator[];
+    /** The filter's input type. */
+    filterType?: 'enum';
+    /** The choices of an enum filter. */
+    enumValues?: DbBackupTableEnumValue[];
+    /**
+     * A query parameter with no cell: offered in the filter menu, never drawn
+     * as a column (the job list's backoff and activity-window filters).
+     */
+    filterOnly?: boolean;
+    /** Covered by the quick search. */
+    searchable?: boolean;
+    /** Included in a CSV export. */
+    exportable?: boolean;
+    /** The viewer may hide it. */
+    hideable?: boolean;
+    /** Truncate long values with an ellipsis. */
+    truncate?: boolean;
+    /** Fixed width in pixels. */
+    width?: number;
+    /** Minimum width in pixels. */
+    minWidth?: number;
+    /** Flex grow factor. */
+    flex?: number;
+}
+/**
+ * A per-row action (a menu item or an icon button).
+ *
+ * @typeParam Row - the row type.
+ * @stability experimental
+ */
+export interface DbBackupTableRowAction<Row> {
+    /** Stable id. */
+    id: string;
+    /** Text and accessible name. */
+    label: string;
+    /** Optional icon. */
+    icon?: ReactNode;
+    /** Runs the action. */
+    onClick: (row: Row) => void;
+    /** Disables it for a row. */
+    disabled?: (row: Row) => boolean;
+    /** Why it is disabled, for a tooltip. */
+    disabledReason?: (row: Row) => string | undefined;
+    /** Styled as destructive. */
+    destructive?: boolean;
+    /** Ask for confirmation first. */
+    confirm?: boolean | {
+        /** Dialog title. */
+        title?: string;
+        /** Dialog text. */
+        description?: string | ((row: Row) => string);
+        /** Confirm button text. */
+        confirmLabel?: string;
+        /** Cancel button text. */
+        cancelLabel?: string;
+    };
+}
+/**
+ * The current sort.
+ *
+ * @stability experimental
+ */
+export interface DbBackupTableSortState {
+    /** The sorted column's id. */
+    field: string;
+    /** The direction. */
+    direction: 'asc' | 'desc';
+}
+/**
+ * Every operator a table's filter model may hold (the run lists only
+ * read `is`). The same union as the reference app's `DataTable`, so its
+ * filter model is assignable here and back.
+ *
+ * @stability experimental
+ */
+export type DbBackupTableFilterModelOperator = 'equals' | 'contains' | 'startsWith' | 'endsWith' | 'gt' | 'gte' | 'lt' | 'lte' | 'between' | 'before' | 'after' | 'is' | 'isNot' | 'isAnyOf' | 'in' | 'isEmpty' | 'isNotEmpty' | (string & {});
+/**
+ * One active filter.
+ *
+ * @stability experimental
+ */
+export interface DbBackupTableFilter {
+    /** The filtered column's id. */
+    columnId: string;
+    /** The operator. */
+    operator: DbBackupTableFilterModelOperator;
+    /** The value. */
+    value: string | number | boolean | (string | number)[] | null;
+}
+/**
+ * The props a run list passes to the table.
+ *
+ * @typeParam Row - the row type.
+ * @stability experimental
+ */
+export interface DbBackupDataTableProps<Row> {
+    /** The columns, in order. */
+    columns: DbBackupTableColumn<Row>[];
+    /** This page's rows. */
+    rows: Row[];
+    /** A row's stable id. */
+    rowId: (row: Row) => string;
+    /** A request is in flight. */
+    loading?: boolean;
+    /** Shown when there are no rows. */
+    emptyState?: ReactNode;
+    /** Server-side paging. */
+    pagination?: {
+        /** The page, zero-based. */
+        page: number;
+        /** The page size. */
+        pageSize: number;
+        /** Rows across all pages. */
+        total: number;
+        /** Called with the next page and size. */
+        onPaginationChange: (next: {
+            page: number;
+            pageSize: number;
+        }) => void;
+        /** The page sizes offered. */
+        pageSizeOptions?: number[];
+    };
+    /** Server-side sorting. */
+    sort?: {
+        /** The current sort, or `null`. */
+        sort: DbBackupTableSortState | null;
+        /** Called with the next sort. */
+        onSortChange: (next: DbBackupTableSortState | null) => void;
+    };
+    /** Row selection. */
+    selection?: {
+        /** The selected row ids. */
+        selectedIds: Set<string>;
+        /** Called with the next selection. */
+        onSelectionChange: (next: Set<string>) => void;
+    };
+    /** The active filters. */
+    filters?: DbBackupTableFilter[];
+    /** Called with the next filters. */
+    onFiltersChange?: (next: DbBackupTableFilter[]) => void;
+    /** The quick search box. */
+    quickSearch?: {
+        /** The current text. */
+        value: string;
+        /** Called with the next text. */
+        onChange: (next: string) => void;
+        /** Placeholder text. */
+        placeholder?: string;
+        /** Accessible name. */
+        ariaLabel?: string;
+    };
+    /** Per-row actions. */
+    rowActions?: DbBackupTableRowAction<Row>[];
+    /** CSV export of every page. */
+    csvExport?: {
+        /** File name without extension. */
+        filename?: string;
+        /** Reads one page of every row for the export (zero-based page). */
+        fetchAllRows?: (params: {
+            page: number;
+            pageSize: number;
+            signal?: AbortSignal;
+        }) => Promise<Row[]>;
+    };
+    /** Persisted layout key (column visibility, density). */
+    tableId?: string;
+    /** Row density. */
+    density?: 'compact' | 'standard' | 'comfortable';
+    /** Accessible name of the table. */
+    ariaLabel?: string;
+    /** Test id. */
+    'data-testid'?: string;
+}
+/**
+ * The table component an app hands the db-backup page: any component
+ * accepting {@link DbBackupDataTableProps} for every row type.
+ *
+ * @stability experimental
+ */
+export type DbBackupDataTableComponent = <Row>(props: DbBackupDataTableProps<Row>) => ReactElement | null;
+//# sourceMappingURL=table.d.ts.map

package/dist/db-backup/headless/table.d.ts.map

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

package/dist/db-backup/headless/table.js

@@ -0,0 +1,11 @@
+// The table the db-backup page renders its run list in (issue #740): the
+// jobs slice's table contract (#854) restated, because a slice of this
+// package imports only `core` (`packages/platform-slices.json`). "Packages
+// own behaviour, apps own appearance": the page decides its columns, paging,
+// filters and row actions; the TABLE that draws them is the app's (the
+// reference app hands its responsive `DataTable` in through
+// `DbBackupWebAdaptersProvider`), and an app's richer table component is
+// assignable to `DbBackupDataTableComponent` without a cast. Without an app
+// table the page falls back to a plain MUI table.
+export {};
+//# sourceMappingURL=table.js.map

package/dist/db-backup/headless/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../../src/db-backup/headless/table.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,uEAAuE;AACvE,2EAA2E;AAC3E,6EAA6E;AAC7E,uEAAuE;AACvE,4DAA4D;AAC5D,yEAAyE;AACzE,4EAA4E;AAC5E,kDAAkD"}