@happyvertical/smrt-content 0.43.10 → 0.44.1

package/dist/svelte/components/GovernedContentEditor.svelte

@@ -20,25 +20,45 @@ export type GovernedContentEditorSaveData = ContentData & {
 };
 
 export interface Props {
+  /** Base URL for content and governance API requests. */
   apiBaseUrl?: string;
+  /** Existing content to edit; omit to create new content. */
   content?: ContentData;
+  /** ID of the content being edited; defaults to 'new'. */
   contentId?: string;
+  /** Default relationship type for new facts added to the content. */
   defaultRelationship?: string;
+  /** Key for the publication review profile to enforce. */
   reviewProfileKey?: string;
+  /** Label shown for custom review workflow submissions. */
   customReviewLabel?: string;
+  /** Instructions shown for custom review workflow submissions. */
   customReviewInstructions?: string;
+  /** Policy key applied to custom review submissions. */
   customReviewPolicyKey?: string;
+  /** Whether to require publication readiness before saving. */
   enforcePublishReadiness?: boolean;
+  /** Whether to disable the save button. */
   saveDisabled?: boolean;
+  /** Message displayed when save is disabled or unavailable. */
   saveNotice?: string | null;
+  /** Whether the agent chat assistant panel is available. */
   agentChatEnabled?: boolean;
+  /** Message displayed when agent chat is unavailable. */
   agentChatNotice?: string | null;
+  /** Whether to hide the save and cancel action buttons. */
   hideActions?: boolean;
+  /** Whether to hide the agent chat panel. */
   hideChat?: boolean;
+  /** Whether to display the fact catalog panel. */
   showFactCatalog?: boolean;
+  /** Whether to display the governance status panel. */
   showGovernancePanel?: boolean;
+  /** Invoked when the assistant context changes during editing. */
   onAssistantContextChange?: ContentEditorAssistantContextChange;
+  /** Invoked when the user saves the content. */
   onSave: (data: GovernedContentEditorSaveData) => void;
+  /** Invoked when the user cancels editing. */
   onCancel: () => void;
 }
 

package/dist/svelte/components/GovernedContentEditor.svelte.d.ts

@@ -5,25 +5,45 @@ export type GovernedContentEditorSaveData = ContentData & {
     facts: FactData[];
 };
 export interface Props {
+    /** Base URL for content and governance API requests. */
     apiBaseUrl?: string;
+    /** Existing content to edit; omit to create new content. */
     content?: ContentData;
+    /** ID of the content being edited; defaults to 'new'. */
     contentId?: string;
+    /** Default relationship type for new facts added to the content. */
     defaultRelationship?: string;
+    /** Key for the publication review profile to enforce. */
     reviewProfileKey?: string;
+    /** Label shown for custom review workflow submissions. */
     customReviewLabel?: string;
+    /** Instructions shown for custom review workflow submissions. */
     customReviewInstructions?: string;
+    /** Policy key applied to custom review submissions. */
     customReviewPolicyKey?: string;
+    /** Whether to require publication readiness before saving. */
     enforcePublishReadiness?: boolean;
+    /** Whether to disable the save button. */
     saveDisabled?: boolean;
+    /** Message displayed when save is disabled or unavailable. */
     saveNotice?: string | null;
+    /** Whether the agent chat assistant panel is available. */
     agentChatEnabled?: boolean;
+    /** Message displayed when agent chat is unavailable. */
     agentChatNotice?: string | null;
+    /** Whether to hide the save and cancel action buttons. */
     hideActions?: boolean;
+    /** Whether to hide the agent chat panel. */
     hideChat?: boolean;
+    /** Whether to display the fact catalog panel. */
     showFactCatalog?: boolean;
+    /** Whether to display the governance status panel. */
     showGovernancePanel?: boolean;
+    /** Invoked when the assistant context changes during editing. */
     onAssistantContextChange?: ContentEditorAssistantContextChange;
+    /** Invoked when the user saves the content. */
     onSave: (data: GovernedContentEditorSaveData) => void;
+    /** Invoked when the user cancels editing. */
     onCancel: () => void;
 }
 declare const GovernedContentEditor: import("svelte").Component<Props, {

package/dist/svelte/components/GovernedContentEditor.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GovernedContentEditor.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/GovernedContentEditor.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,mCAAmC,EAEpC,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,WAAW,EAGX,QAAQ,EACT,MAAM,wBAAwB,CAAC;AAMhC,MAAM,MAAM,6BAA6B,GAAG,WAAW,GAAG;IACxD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,KAAK;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,wBAAwB,CAAC,EAAE,mCAAmC,CAAC;IAC/D,MAAM,EAAE,CAAC,IAAI,EAAE,6BAA6B,KAAK,IAAI,CAAC;IACtD,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAwSD,QAAA,MAAM,qBAAqB;;gCAhOS,MAAM;MAgOyB,CAAC;AACpE,KAAK,qBAAqB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACtE,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"GovernedContentEditor.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/GovernedContentEditor.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,mCAAmC,EAEpC,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,WAAW,EAGX,QAAQ,EACT,MAAM,wBAAwB,CAAC;AAMhC,MAAM,MAAM,6BAA6B,GAAG,WAAW,GAAG;IACxD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,KAAK;IACpB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,uDAAuD;IACvD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,8DAA8D;IAC9D,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,0CAA0C;IAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iDAAiD;IACjD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sDAAsD;IACtD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iEAAiE;IACjE,wBAAwB,CAAC,EAAE,mCAAmC,CAAC;IAC/D,+CAA+C;IAC/C,MAAM,EAAE,CAAC,IAAI,EAAE,6BAA6B,KAAK,IAAI,CAAC;IACtD,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAwSD,QAAA,MAAM,qBAAqB;;gCAhOS,MAAM;MAgOyB,CAAC;AACpE,KAAK,qBAAqB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACtE,eAAe,qBAAqB,CAAC"}

package/dist/svelte/content-list-lifecycle.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Browser-safe trash, restore, and permanent-delete orchestration for
+ * ContentList (#2454).
+ *
+ * Lifecycle authority stays on the server. The browser supplies a selection
+ * hint and expected count, then renders the server's resolved preview. Apply
+ * must reuse that preview's opaque confirmation token and authority-bound
+ * selection while using a fresh request id for each transport attempt; a
+ * changed query, count, permission, row revision, or eligibility is therefore
+ * rejected by the principal-bound server adapter rather than being guessed
+ * from stale list rows.
+ */
+import type { DataSurfaceActionResult, DataSurfaceIdentity, DataSurfaceJsonValue, DataSurfaceSelectionReference } from '@happyvertical/smrt-ui/data';
+import type { ContentListDataQueryRequest } from './content-list-query.js';
+export declare const CONTENT_LIST_LIFECYCLE_ACTION_IDS: readonly ["move-to-trash", "restore", "permanent-delete"];
+export type ContentListLifecycleActionId = (typeof CONTENT_LIST_LIFECYCLE_ACTION_IDS)[number];
+export type ContentListRestoreStatus = 'draft' | 'review' | 'published';
+export interface ContentListLifecycleTarget {
+    /** Canonical server query. Required for all-matching selections. */
+    query?: ContentListDataQueryRequest;
+    /** Count visible when the operator requested the preview. */
+    expectedCount: number;
+    /** Operator-entered server preview count, sent only on permanent-delete apply. */
+    confirmedCount?: number;
+}
+export interface ContentListLifecycleRequest {
+    version: 1;
+    requestId: string;
+    identity: DataSurfaceIdentity;
+    actionId: ContentListLifecycleActionId;
+    phase: 'preview' | 'apply';
+    selection: DataSurfaceSelectionReference;
+    payload?: DataSurfaceJsonValue;
+    expectedRevision: number;
+    target: ContentListLifecycleTarget;
+    confirmationToken?: string;
+    idempotencyKey?: string;
+}
+export interface ContentListLifecycleClient {
+    preview(request: ContentListLifecycleRequest): Promise<DataSurfaceActionResult>;
+    apply(request: ContentListLifecycleRequest): Promise<DataSurfaceActionResult>;
+}
+export interface ContentListLifecycleBinding {
+    client: ContentListLifecycleClient;
+    /** Server-owned surface revision. Never derived from list rows. */
+    revision?: number;
+    /** Override the default ContentList identity. */
+    identity?: DataSurfaceIdentity;
+    /** Server action-selection cap. Defaults to 200 and fails closed in the UI. */
+    maxSelectionSize?: number;
+}
+export interface ContentListLifecycleTransportOptions {
+    apiBaseUrl?: string;
+    path?: string;
+    fetch?: typeof globalThis.fetch;
+    headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+    credentials?: RequestCredentials;
+}
+export type ContentListLifecycleTransportErrorReason = 'network_failure' | 'invalid_json' | 'http_error' | 'invalid_result';
+export declare class ContentListLifecycleTransportError extends Error {
+    readonly status?: number;
+    readonly reason: ContentListLifecycleTransportErrorReason;
+    constructor(message: string, status?: number, reason?: ContentListLifecycleTransportErrorReason);
+}
+export interface ContentListLifecycleOutcome {
+    rowId: string | number;
+    status: 'accepted' | 'skipped' | 'failed';
+    reason?: string;
+    /** Canonical runtime subtype, for example a Document or Mirror. */
+    resourceType?: string;
+    /** Canonical resource id used by the server mutation. */
+    resourceId?: string;
+}
+export interface ContentListLifecycleSummary {
+    resolvedCount: number;
+    accepted: number;
+    skipped: number;
+    failed: number;
+    outcomes: ContentListLifecycleOutcome[];
+    representativeLabels: string[];
+    expiresAt?: number;
+    /** Correlates the visible result with principal audit metadata. */
+    auditReference: string;
+}
+export type ContentListLifecycleControllerStatus = 'idle' | 'previewing' | 'ready' | 'applying' | 'succeeded' | 'failed';
+export interface ContentListLifecycleSnapshot {
+    status: ContentListLifecycleControllerStatus;
+    actionId?: ContentListLifecycleActionId;
+    selection?: DataSurfaceSelectionReference;
+    summary?: ContentListLifecycleSummary;
+    result?: DataSurfaceActionResult;
+    error?: string;
+    /** True when the only safe recovery is another server preview. */
+    renewalRequired: boolean;
+    /** True while an ambiguous apply must replay its exact authority envelope. */
+    replayRequired?: boolean;
+}
+export interface ContentListLifecyclePreviewInput {
+    actionId: ContentListLifecycleActionId;
+    selection: DataSurfaceSelectionReference;
+    expectedCount: number;
+    query?: ContentListDataQueryRequest;
+    restoreStatus?: ContentListRestoreStatus;
+    /** Invalidates the preview when the visible query/selection changes. */
+    viewKey: string;
+}
+export interface ContentListLifecycleControllerOptions extends ContentListLifecycleBinding {
+    createRequestId?: () => string;
+    createIdempotencyKey?: () => string;
+}
+export interface ContentListLifecycleController {
+    snapshot(): ContentListLifecycleSnapshot;
+    subscribe(listener: (snapshot: ContentListLifecycleSnapshot) => void): () => void;
+    preview(input: ContentListLifecyclePreviewInput): Promise<ContentListLifecycleSnapshot>;
+    /**
+     * Apply only after the operator confirms the server-resolved count. The
+     * number is intentionally passed again rather than inferred by the UI.
+     */
+    apply(confirmedCount: number): Promise<ContentListLifecycleSnapshot>;
+    /** Drop a preview after any visible query or selection change. */
+    invalidate(viewKey: string): void;
+    reset(): void;
+}
+/** Authenticated fetch transport for the host's lifecycle route. */
+export declare function createContentListLifecycleTransport(options?: ContentListLifecycleTransportOptions): ContentListLifecycleClient;
+/** Parse the bounded, optional preview/apply details without trusting casts. */
+export declare function readContentListLifecycleSummary(result: DataSurfaceActionResult): ContentListLifecycleSummary;
+/** Framework-free state machine shared by UI and agent-driven lifecycle flows. */
+export declare function createContentListLifecycleController(options: ContentListLifecycleControllerOptions): ContentListLifecycleController;
+/** Keep unsuccessful rows selected so partial failures are visible/retryable. */
+export declare function reconcileContentListLifecycleSelection(selectedRowIds: readonly (string | number)[], result: DataSurfaceActionResult): Array<string | number>;
+//# sourceMappingURL=content-list-lifecycle.d.ts.map

package/dist/svelte/content-list-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-list-lifecycle.d.ts","sourceRoot":"","sources":["../../src/svelte/content-list-lifecycle.ts"],"names":[],"mappings":"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"}

package/dist/svelte/content-list-lifecycle.js

@@ -0,0 +1,439 @@
+/**
+ * Browser-safe trash, restore, and permanent-delete orchestration for
+ * ContentList (#2454).
+ *
+ * Lifecycle authority stays on the server. The browser supplies a selection
+ * hint and expected count, then renders the server's resolved preview. Apply
+ * must reuse that preview's opaque confirmation token and authority-bound
+ * selection while using a fresh request id for each transport attempt; a
+ * changed query, count, permission, row revision, or eligibility is therefore
+ * rejected by the principal-bound server adapter rather than being guessed
+ * from stale list rows.
+ */
+export const CONTENT_LIST_LIFECYCLE_ACTION_IDS = [
+    'move-to-trash',
+    'restore',
+    'permanent-delete',
+];
+export class ContentListLifecycleTransportError extends Error {
+    status;
+    reason;
+    constructor(message, status, reason = 'http_error') {
+        super(message);
+        this.name = 'ContentListLifecycleTransportError';
+        this.status = status;
+        this.reason = reason;
+    }
+}
+const DEFAULT_IDENTITY = {
+    surfaceId: 'content-list',
+    kind: 'table',
+};
+const RENEWAL_REASONS = new Set([
+    'stale_preview',
+    'stale_revision',
+    'invalid_or_expired_confirmation',
+    'confirmation_mismatch',
+    'confirmation_replayed',
+    'count_drifted',
+    'matching_count_drifted',
+    'row_revision_drifted',
+    'stale_query_fingerprint',
+]);
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function identityMatches(value, expected) {
+    if (!isRecord(value))
+        return false;
+    const expectedSubject = expected.subject;
+    const subject = isRecord(value.subject) ? value.subject : undefined;
+    return (value.surfaceId === expected.surfaceId &&
+        value.kind === expected.kind &&
+        (expectedSubject
+            ? subject?.type === expectedSubject.type &&
+                subject.id === expectedSubject.id
+            : value.subject === undefined));
+}
+function joinUrl(base, path) {
+    return `${base.replace(/\/+$/, '')}/${path.replace(/^\/+/, '')}`;
+}
+function messageOf(error) {
+    if (error instanceof Error && error.message.trim())
+        return error.message;
+    if (typeof error === 'string' && error.trim())
+        return error;
+    return 'The content lifecycle request failed.';
+}
+function boundedId(prefix) {
+    const random = globalThis.crypto?.randomUUID?.();
+    if (random)
+        return `${prefix}-${random}`;
+    return `${prefix}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+}
+/** Authenticated fetch transport for the host's lifecycle route. */
+export function createContentListLifecycleTransport(options = {}) {
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    if (typeof fetchImpl !== 'function') {
+        throw new TypeError('createContentListLifecycleTransport requires a fetch implementation');
+    }
+    const url = joinUrl(options.apiBaseUrl ?? '/api/v1', options.path ?? 'contents/lifecycle');
+    async function invoke(request) {
+        let headers;
+        try {
+            const provided = typeof options.headers === 'function'
+                ? await options.headers()
+                : options.headers;
+            headers = new Headers(provided);
+            headers.set('content-type', 'application/json');
+            if (!headers.has('accept'))
+                headers.set('accept', 'application/json');
+        }
+        catch {
+            throw new ContentListLifecycleTransportError('The content lifecycle request could not be prepared.', undefined, 'network_failure');
+        }
+        let response;
+        try {
+            response = await fetchImpl(url, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(request),
+                ...(options.credentials ? { credentials: options.credentials } : {}),
+            });
+        }
+        catch {
+            throw new ContentListLifecycleTransportError('The content lifecycle request failed.', undefined, 'network_failure');
+        }
+        let payload;
+        try {
+            const text = await response.text();
+            payload = text ? JSON.parse(text) : undefined;
+        }
+        catch {
+            throw new ContentListLifecycleTransportError('The content lifecycle route returned invalid JSON.', response.status, 'invalid_json');
+        }
+        if (!response.ok) {
+            const error = isRecord(payload) && isRecord(payload.error)
+                ? payload.error
+                : undefined;
+            throw new ContentListLifecycleTransportError(typeof error?.message === 'string'
+                ? error.message
+                : `The content lifecycle request failed with HTTP ${response.status}.`, response.status, 'http_error');
+        }
+        const result = isRecord(payload) && Object.hasOwn(payload, 'result')
+            ? payload.result
+            : payload;
+        if (!isRecord(result) ||
+            result.version !== 1 ||
+            typeof result.ok !== 'boolean' ||
+            result.requestId !== request.requestId ||
+            result.actionId !== request.actionId ||
+            result.phase !== request.phase ||
+            !identityMatches(result.identity, request.identity)) {
+            throw new ContentListLifecycleTransportError('The content lifecycle route returned an invalid result.', response.status, 'invalid_result');
+        }
+        return result;
+    }
+    return { preview: invoke, apply: invoke };
+}
+/** Parse the bounded, optional preview/apply details without trusting casts. */
+export function readContentListLifecycleSummary(result) {
+    const details = isRecord(result.details) ? result.details : {};
+    const outcomes = Array.isArray(details.outcomes)
+        ? details.outcomes.flatMap((entry) => {
+            if (!isRecord(entry))
+                return [];
+            if ((typeof entry.rowId !== 'string' &&
+                typeof entry.rowId !== 'number') ||
+                !['accepted', 'skipped', 'failed'].includes(String(entry.status)))
+                return [];
+            return [
+                {
+                    rowId: entry.rowId,
+                    status: entry.status,
+                    ...(typeof entry.reason === 'string'
+                        ? { reason: entry.reason }
+                        : {}),
+                    ...(typeof entry.resourceType === 'string'
+                        ? { resourceType: entry.resourceType }
+                        : {}),
+                    ...(typeof entry.resourceId === 'string'
+                        ? { resourceId: entry.resourceId }
+                        : {}),
+                },
+            ];
+        })
+        : [];
+    const number = (value) => Number.isSafeInteger(value) && Number(value) >= 0 ? Number(value) : 0;
+    const representativeLabels = Array.isArray(details.representativeLabels)
+        ? details.representativeLabels.filter((label) => typeof label === 'string')
+        : [];
+    return {
+        resolvedCount: number(details.count),
+        accepted: number(details.accepted),
+        skipped: number(details.skipped),
+        failed: number(details.failed),
+        outcomes,
+        representativeLabels,
+        ...(typeof details.expiresAt === 'number' &&
+            Number.isFinite(details.expiresAt)
+            ? { expiresAt: details.expiresAt }
+            : {}),
+        auditReference: typeof details.auditReference === 'string'
+            ? details.auditReference
+            : result.requestId,
+    };
+}
+function cloneSelection(selection) {
+    return selection.scope === 'explicit-ids'
+        ? { scope: 'explicit-ids', rowIds: [...selection.rowIds] }
+        : { ...selection };
+}
+function requestPayload(input) {
+    return input.actionId === 'restore'
+        ? { status: input.restoreStatus ?? 'draft' }
+        : undefined;
+}
+/** Framework-free state machine shared by UI and agent-driven lifecycle flows. */
+export function createContentListLifecycleController(options) {
+    const listeners = new Set();
+    const identity = options.identity ?? DEFAULT_IDENTITY;
+    const createRequestId = options.createRequestId ?? (() => boundedId('lifecycle'));
+    const createIdempotencyKey = options.createIdempotencyKey ?? (() => boundedId('lifecycle-apply'));
+    let state = {
+        status: 'idle',
+        renewalRequired: false,
+    };
+    let generation = 0;
+    let previewViewKey;
+    let frozen;
+    let pendingApply;
+    const publish = (next) => {
+        state = next;
+        for (const listener of listeners)
+            listener({ ...state });
+    };
+    const reset = () => {
+        if (pendingApply)
+            return;
+        generation += 1;
+        previewViewKey = undefined;
+        frozen = undefined;
+        pendingApply = undefined;
+        publish({ status: 'idle', renewalRequired: false });
+    };
+    const preview = async (input) => {
+        if (pendingApply)
+            return state;
+        const currentGeneration = ++generation;
+        previewViewKey = input.viewKey;
+        frozen = undefined;
+        const selection = cloneSelection(input.selection);
+        if (input.expectedCount < 0 ||
+            !Number.isSafeInteger(input.expectedCount) ||
+            input.expectedCount > (options.maxSelectionSize ?? 200) ||
+            (selection.scope === 'all-matching' && !input.query) ||
+            (selection.scope === 'explicit-ids' && selection.rowIds.length === 0)) {
+            const failed = {
+                status: 'failed',
+                actionId: input.actionId,
+                selection,
+                error: 'The lifecycle selection is invalid.',
+                renewalRequired: true,
+            };
+            publish(failed);
+            return failed;
+        }
+        const payload = requestPayload(input);
+        const request = {
+            version: 1,
+            requestId: createRequestId(),
+            identity,
+            actionId: input.actionId,
+            phase: 'preview',
+            selection,
+            expectedRevision: options.revision ?? 0,
+            target: {
+                expectedCount: input.expectedCount,
+                ...(input.query ? { query: input.query } : {}),
+            },
+            ...(payload === undefined ? {} : { payload }),
+        };
+        publish({
+            status: 'previewing',
+            actionId: input.actionId,
+            selection,
+            renewalRequired: false,
+        });
+        try {
+            const result = await options.client.preview(request);
+            if (currentGeneration !== generation)
+                return state;
+            previewViewKey = undefined;
+            const summary = readContentListLifecycleSummary(result);
+            if (!result.ok || !result.confirmationToken) {
+                const reason = result.reason ?? 'preview_failed';
+                publish({
+                    status: 'failed',
+                    actionId: input.actionId,
+                    selection,
+                    result,
+                    summary,
+                    error: reason,
+                    renewalRequired: RENEWAL_REASONS.has(reason),
+                });
+                return state;
+            }
+            frozen = { request, viewKey: input.viewKey, result };
+            publish({
+                status: 'ready',
+                actionId: input.actionId,
+                selection,
+                result,
+                summary,
+                renewalRequired: false,
+            });
+            return state;
+        }
+        catch (error) {
+            if (currentGeneration !== generation)
+                return state;
+            previewViewKey = undefined;
+            publish({
+                status: 'failed',
+                actionId: input.actionId,
+                selection,
+                error: messageOf(error),
+                renewalRequired: true,
+            });
+            return state;
+        }
+    };
+    const apply = async (confirmedCount) => {
+        const previewed = frozen;
+        const summary = state.summary;
+        const expired = summary?.expiresAt !== undefined && summary.expiresAt <= Date.now();
+        const retry = state.status === 'failed' ? pendingApply : undefined;
+        if ((state.status !== 'ready' && !retry) ||
+            !previewed ||
+            !summary ||
+            confirmedCount !== summary.resolvedCount ||
+            (retry !== undefined && retry.confirmedCount !== confirmedCount) ||
+            expired) {
+            frozen = undefined;
+            publish({
+                ...state,
+                status: 'failed',
+                error: expired
+                    ? 'The lifecycle preview expired and must be renewed.'
+                    : 'The confirmed count no longer matches the lifecycle preview.',
+                renewalRequired: true,
+            });
+            return state;
+        }
+        const currentGeneration = ++generation;
+        const request = retry
+            ? { ...retry.request, requestId: createRequestId() }
+            : {
+                ...previewed.request,
+                requestId: createRequestId(),
+                phase: 'apply',
+                target: {
+                    ...previewed.request.target,
+                    ...(previewed.request.actionId === 'permanent-delete'
+                        ? { confirmedCount }
+                        : {}),
+                },
+                confirmationToken: previewed.result.confirmationToken,
+                idempotencyKey: createIdempotencyKey(),
+            };
+        pendingApply = { request, confirmedCount };
+        publish({ ...state, status: 'applying', error: undefined });
+        try {
+            const result = await options.client.apply(request);
+            if (currentGeneration !== generation)
+                return state;
+            const nextSummary = readContentListLifecycleSummary(result);
+            if (!result.ok) {
+                const reason = result.reason ?? 'apply_failed';
+                if (reason === 'idempotency_in_progress') {
+                    publish({
+                        ...state,
+                        status: 'failed',
+                        result,
+                        error: reason,
+                        renewalRequired: false,
+                        replayRequired: true,
+                    });
+                    return state;
+                }
+                frozen = undefined;
+                pendingApply = undefined;
+                publish({
+                    ...state,
+                    status: 'failed',
+                    result,
+                    summary: nextSummary,
+                    error: reason,
+                    renewalRequired: RENEWAL_REASONS.has(reason),
+                    replayRequired: false,
+                });
+                return state;
+            }
+            frozen = undefined;
+            pendingApply = undefined;
+            publish({
+                ...state,
+                status: 'succeeded',
+                result,
+                summary: nextSummary,
+                renewalRequired: false,
+                replayRequired: false,
+            });
+            return state;
+        }
+        catch (error) {
+            if (currentGeneration !== generation)
+                return state;
+            publish({
+                ...state,
+                status: 'failed',
+                error: messageOf(error),
+                // The server may have committed before the response was lost. Retain
+                // the exact authority/idempotency envelope so retry can replay safely
+                // with a fresh transport correlation id.
+                renewalRequired: false,
+                replayRequired: true,
+            });
+            return state;
+        }
+    };
+    return {
+        snapshot: () => ({ ...state }),
+        subscribe(listener) {
+            listeners.add(listener);
+            listener({ ...state });
+            return () => listeners.delete(listener);
+        },
+        preview,
+        apply,
+        invalidate(viewKey) {
+            // Once apply starts, the server-authorized mutation owns completion.
+            // A changing view must not discard its refresh, audit, or reconciliation.
+            if (state.status === 'applying' || pendingApply)
+                return;
+            if ((previewViewKey !== undefined && previewViewKey !== viewKey) ||
+                (frozen !== undefined && frozen.viewKey !== viewKey)) {
+                reset();
+            }
+        },
+        reset,
+    };
+}
+/** Keep unsuccessful rows selected so partial failures are visible/retryable. */
+export function reconcileContentListLifecycleSelection(selectedRowIds, result) {
+    const accepted = new Set(readContentListLifecycleSummary(result)
+        .outcomes.filter((outcome) => outcome.status === 'accepted')
+        .map((outcome) => String(outcome.rowId)));
+    return selectedRowIds.filter((rowId) => !accepted.has(String(rowId)));
+}