@postgres.ai/shared 4.0.2-pr-1148.1 → 4.0.2-pr-1200

package/pages/Snapshots/Snapshot/index.js

@@ -13,11 +13,15 @@ import { makeStyles, Button, TextField, IconButton, Table, TableHead, TableRow,
 import { ErrorStub } from '@postgres.ai/shared/components/ErrorStub';
 import { PageSpinner } from '@postgres.ai/shared/components/PageSpinner';
 import { SectionTitle } from '@postgres.ai/shared/components/SectionTitle';
+import { Select } from '@postgres.ai/shared/components/Select';
+import { Spinner } from '@postgres.ai/shared/components/Spinner';
 import { DestroySnapshotModal } from '@postgres.ai/shared/pages/Snapshots/Snapshot/DestorySnapshotModal';
 import { HorizontalScrollContainer } from '@postgres.ai/shared/components/HorizontalScrollContainer';
 import { Tooltip } from '@postgres.ai/shared/components/Tooltip';
 import { icons } from '@postgres.ai/shared/styles/icons';
 import { formatBytesIEC } from '@postgres.ai/shared/utils/units';
+import { parseDate } from '@postgres.ai/shared/utils/date';
+import { protectionOptions, getProtectionSelectValue, } from '@postgres.ai/shared/utils/protection';
 import { styles } from '@postgres.ai/shared/styles/styles';
 import { SyntaxHighlight } from '@postgres.ai/shared/components/SyntaxHighlight';
 import { TableBodyCell, TableBodyCellMenu, TableHeaderCell, } from '@postgres.ai/shared/components/Table';
@@ -71,6 +75,13 @@ const useStyles = makeStyles(() => ({
     summary: {
         marginTop: 20,
     },
+    protectionControl: {
+        display: 'flex',
+        alignItems: 'center',
+        marginTop: '8px',
+        marginBottom: '8px',
+        maxWidth: 525,
+    },
     text: {
         marginTop: '4px',
     },
@@ -129,11 +140,18 @@ export const SnapshotPage = observer((props) => {
     const history = useHistory();
     const stores = useCreatedStores(props.api);
     const [isOpenDestroyModal, setIsOpenDestroyModal] = useState(false);
-    const { snapshot, branchSnapshot, isSnapshotsLoading, snapshotError, branchSnapshotError, load, } = stores.main;
+    const { snapshot, branchSnapshot, isSnapshotsLoading, isUpdatingSnapshot, updateSnapshotProtection, updateSnapshotError, snapshotError, branchSnapshotError, load, } = stores.main;
     const afterSubmitClick = () => {
         history.push(props.routes.snapshots());
         load(props.snapshotId, props.instanceId);
     };
+    const protectedTillDate = (snapshot === null || snapshot === void 0 ? void 0 : snapshot.protectedTill)
+        ? parseDate(snapshot.protectedTill)
+        : null;
+    const handleProtectionChange = (e) => {
+        const value = e.target.value;
+        updateSnapshotProtection(props.snapshotId, props.instanceId, value === 'none' ? null : parseInt(value, 10));
+    };
     const headRendered = (_jsxs(_Fragment, { children: [_jsx("style", { children: 'p { margin: 0;}' }), props.elements.breadcrumbs, _jsx(SectionTitle, { className: classes.title, tag: "h1", level: 1, text: `Snapshot ${props.snapshotId}`, children: _jsx(InstanceTabs, { tab: TABS_INDEX.SNAPSHOTS, isPlatform: props.isPlatform, instanceId: props.instanceId, hasLogs: props.api.initWS !== undefined, hideInstanceTabs: props.hideBranchingFeatures }) })] }));
     useEffect(() => {
         load(props.snapshotId, props.instanceId);
@@ -147,7 +165,15 @@ export const SnapshotPage = observer((props) => {
                                                         ? formatBytesIEC(snapshot.logicalSize)
                                                         : '-'] }), _jsxs("p", { className: classes.text, children: [_jsx("span", { className: classes.paramTitle, children: "Physical data diff size:" }), (snapshot === null || snapshot === void 0 ? void 0 : snapshot.physicalSize)
                                                         ? formatBytesIEC(snapshot.physicalSize)
-                                                        : '-'] }), (branchSnapshot === null || branchSnapshot === void 0 ? void 0 : branchSnapshot.message) && (_jsxs("p", { className: classes.text, children: [_jsx("span", { className: classes.paramTitle, children: "Message:" }), branchSnapshot.message] }))] }), _jsx("br", {}), _jsx("p", { children: _jsx("strong", { children: "Snapshot info" }) }), (snapshot === null || snapshot === void 0 ? void 0 : snapshot.pool) && (_jsxs("div", { className: classes.copyFieldContainer, children: [_jsx(TextField, { variant: "outlined", label: "snapshot pool", value: snapshot.pool, className: classes.textField, margin: "normal", fullWidth: true, InputLabelProps: {
+                                                        : '-'] }), (branchSnapshot === null || branchSnapshot === void 0 ? void 0 : branchSnapshot.message) && (_jsxs("p", { className: classes.text, children: [_jsx("span", { className: classes.paramTitle, children: "Message:" }), branchSnapshot.message] }))] }), _jsxs("div", { className: classes.summary, children: [_jsx("p", { children: _jsx("strong", { children: "Deletion protection" }) }), _jsxs("div", { className: classes.protectionControl, children: [_jsx(Select, { label: "Deletion protection", items: (snapshot === null || snapshot === void 0 ? void 0 : snapshot.protected) && protectedTillDate
+                                                            ? [
+                                                                {
+                                                                    value: 'current',
+                                                                    children: `Protected until ${protectedTillDate.toLocaleString()}`,
+                                                                },
+                                                                ...protectionOptions,
+                                                            ]
+                                                            : protectionOptions, value: getProtectionSelectValue(Boolean(snapshot === null || snapshot === void 0 ? void 0 : snapshot.protected), protectedTillDate), onChange: handleProtectionChange, disabled: isUpdatingSnapshot, fullWidth: true }), isUpdatingSnapshot && (_jsx(Spinner, { size: "sm", className: classes.spinner }))] }), _jsx("p", { className: classes.text, children: "Protected snapshots cannot be deleted manually or automatically." }), updateSnapshotError && (_jsx(ErrorStub, { title: "Update error", message: updateSnapshotError, className: classes.marginTop }))] }), _jsx("br", {}), _jsx("p", { children: _jsx("strong", { children: "Snapshot info" }) }), (snapshot === null || snapshot === void 0 ? void 0 : snapshot.pool) && (_jsxs("div", { className: classes.copyFieldContainer, children: [_jsx(TextField, { variant: "outlined", label: "snapshot pool", value: snapshot.pool, className: classes.textField, margin: "normal", fullWidth: true, InputLabelProps: {
                                                     shrink: true,
                                                     style: styles.inputFieldLabel,
                                                 }, FormHelperTextProps: {

package/pages/Snapshots/Snapshot/stores/Main.d.ts

@@ -1,5 +1,6 @@
 import { SnapshotsStore, SnapshotsApi } from '@postgres.ai/shared/stores/Snapshots';
 import { DestroySnapshot } from '@postgres.ai/shared/types/api/endpoints/destroySnapshot';
+import { UpdateSnapshot } from '@postgres.ai/shared/types/api/endpoints/updateSnapshot';
 import { SnapshotDto } from '@postgres.ai/shared/types/api/entities/snapshot';
 import { GetBranchSnapshot } from '@postgres.ai/shared/types/api/endpoints/getBranchSnapshot';
 import { BranchSnapshotDto } from '@postgres.ai/shared/types/api/entities/branchSnapshot';
@@ -10,6 +11,7 @@ declare type Error = {
 };
 export declare type Api = SnapshotsApi & {
     destroySnapshot: DestroySnapshot;
+    updateSnapshot?: UpdateSnapshot;
     getBranchSnapshot?: GetBranchSnapshot;
     initWS?: InitWS;
 };
@@ -19,12 +21,15 @@ export declare class MainStore {
     snapshotError: Error | null;
     branchSnapshotError: Error | null;
     isSnapshotsLoading: boolean;
+    isUpdatingSnapshot: boolean;
+    updateSnapshotError: string | null;
     private readonly api;
     readonly snapshots: SnapshotsStore;
     constructor(api: Api);
     load: (snapshotId: string, instanceId: string) => Promise<void>;
     getSnapshot: (snapshotId: string, instanceId: string) => Promise<boolean | undefined>;
     getBranchSnapshot: (snapshotId: string, instanceId: string) => Promise<import("@postgres.ai/shared/types/api/entities/branchSnapshot").BranchSnapshotDTO | null | undefined>;
+    updateSnapshotProtection: (snapshotId: string, instanceId: string, durationMinutes: number | null) => Promise<void>;
     destroySnapshot: (snapshotId: string, forceDelete: boolean, instanceId: string) => Promise<{
         response: boolean | null;
         error: any;

package/pages/Snapshots/Snapshot/stores/Main.js

@@ -7,6 +7,7 @@
 import { makeAutoObservable } from 'mobx';
 import { SnapshotsStore, } from '@postgres.ai/shared/stores/Snapshots';
 import { generateSnapshotPageId } from '@postgres.ai/shared/pages/Instance/Snapshots/utils';
+import { getTextFromUnknownApiError } from '@postgres.ai/shared/utils/api';
 export class MainStore {
     constructor(api) {
         this.snapshot = null;
@@ -14,6 +15,8 @@ export class MainStore {
         this.snapshotError = null;
         this.branchSnapshotError = null;
         this.isSnapshotsLoading = false;
+        this.isUpdatingSnapshot = false;
+        this.updateSnapshotError = null;
         this.load = async (snapshotId, instanceId) => {
             if (!snapshotId)
                 return;
@@ -55,6 +58,32 @@ export class MainStore {
             }
             return response;
         };
+        this.updateSnapshotProtection = async (snapshotId, instanceId, durationMinutes) => {
+            if (!this.api.updateSnapshot || !this.snapshot)
+                return;
+            this.isUpdatingSnapshot = true;
+            this.updateSnapshotError = null;
+            const prevProtected = this.snapshot.protected;
+            const isProtected = durationMinutes !== null;
+            this.snapshot.protected = isProtected;
+            const { response, error } = await this.api.updateSnapshot({
+                instanceId,
+                snapshotId: this.snapshot.id,
+                snapshot: {
+                    isProtected,
+                    protectionDurationMinutes: durationMinutes !== null && durationMinutes !== void 0 ? durationMinutes : undefined,
+                },
+            });
+            if (response) {
+                await this.load(snapshotId, instanceId);
+            }
+            else if (this.snapshot) {
+                this.snapshot.protected = prevProtected;
+            }
+            if (error)
+                this.updateSnapshotError = await getTextFromUnknownApiError(error);
+            this.isUpdatingSnapshot = false;
+        };
         this.destroySnapshot = async (snapshotId, forceDelete, instanceId) => {
             if (!this.api.destroySnapshot || !snapshotId)
                 return;

package/stores/Snapshots.d.ts

@@ -18,7 +18,7 @@ export declare class SnapshotsStore {
     private readonly api;
     constructor(api: SnapshotsApi);
     load: (instanceId: string) => Promise<boolean | undefined>;
-    reload: (instanceId: string, branchName?: string) => Promise<boolean | undefined>;
+    reload: (instanceId: string, branchName?: string, silent?: boolean) => Promise<boolean | undefined>;
     createSnapshot: (cloneId: string, message: string, instanceId: string) => Promise<import("../types/api/entities/createSnapshot").CreateSnapshotDTO | null | undefined>;
     private loadData;
 }

package/stores/Snapshots.js

@@ -18,7 +18,7 @@ export class SnapshotsStore {
             this.error = null;
             return this.loadData(instanceId);
         };
-        this.reload = (instanceId, branchName) => this.loadData(instanceId, branchName);
+        this.reload = (instanceId, branchName, silent) => this.loadData(instanceId, branchName, silent);
         this.createSnapshot = async (cloneId, message, instanceId) => {
             if (!this.api.createSnapshot || !cloneId)
                 return;
@@ -35,18 +35,24 @@ export class SnapshotsStore {
             }
             return response;
         };
-        this.loadData = async (instanceId, branchName) => {
+        this.loadData = async (instanceId, branchName, silent) => {
             if (!this.api.getSnapshots)
                 return;
-            this.isLoading = true;
+            if (!silent)
+                this.isLoading = true;
             const { response, error } = await this.api.getSnapshots({
                 instanceId,
                 branchName,
             });
-            this.isLoading = false;
-            if (response)
+            if (!silent)
+                this.isLoading = false;
+            if (response) {
                 this.data = response;
-            if (error) {
+                this.error = null;
+            }
+            // a silent background refresh keeps the existing list on a transient failure; errors
+            // surface only on a foreground load.
+            if (error && !silent) {
                 this.error = await error
                     .json()
                     .then((error) => { var _a, _b; return (_b = (_a = error.details) === null || _a === void 0 ? void 0 : _a.split('"message": "')[1]) === null || _b === void 0 ? void 0 : _b.split('"')[0]; });

package/types/api/endpoints/getBranches.d.ts

@@ -6,6 +6,9 @@ export interface Branch {
     snapshotID: string;
     dataset: string;
     numSnapshots: number;
+    protected: boolean;
+    protectedTill?: string;
+    deleteAt?: string;
 }
 export declare const formatBranchesDto: (dto: Branch[]) => {
     dataStateAt: string;
@@ -15,6 +18,9 @@ export declare const formatBranchesDto: (dto: Branch[]) => {
     snapshotID: string;
     dataset: string;
     numSnapshots: number;
+    protected: boolean;
+    protectedTill?: string | undefined;
+    deleteAt?: string | undefined;
 }[];
 export declare type GetBranches = (instanceId: string) => Promise<{
     response: Branch[] | null;

package/types/api/endpoints/testDbSource.d.ts

@@ -17,6 +17,8 @@ export declare type TestDbSource = (values: dbSource) => Promise<{
 export declare const formatTuningParams: (tuningParams: {
     [key: string]: string;
 } | undefined) => string;
-export declare const formatTuningParamsToObj: (tuningParams: string | undefined) => {
+export declare const formatTuningParamsToObj: (tuningParams: string | {
+    [key: string]: string;
+} | undefined) => {
     [key: string]: string;
 };

package/types/api/endpoints/testDbSource.js

@@ -11,6 +11,12 @@ export const formatTuningParams = (tuningParams) => {
     return formattedTuningParams;
 };
 export const formatTuningParamsToObj = (tuningParams) => {
+    // Simple mode seeds tuningParams as an object (the proposed queryTuning map);
+    // Expert mode keeps it as the textarea string. Pass an already-parsed object
+    // through unchanged so callers never run .split on a non-string.
+    if (tuningParams && typeof tuningParams === 'object') {
+        return tuningParams;
+    }
     let formattedTuningParams = {};
     if (tuningParams) {
         const tuningParamsArr = tuningParams.split('\n');

package/types/api/endpoints/updateBranch.d.ts

@@ -0,0 +1,11 @@
+export declare type UpdateBranch = (args: {
+    instanceId: string;
+    branchName: string;
+    branch: {
+        isProtected: boolean;
+        protectionDurationMinutes?: number;
+    };
+}) => Promise<{
+    response: true | null;
+    error: Response | null;
+}>;

package/types/api/endpoints/updateBranch.js

@@ -0,0 +1 @@
+export {};

package/types/api/endpoints/updateSnapshot.d.ts

@@ -0,0 +1,11 @@
+export declare type UpdateSnapshot = (args: {
+    instanceId: string;
+    snapshotId: string;
+    snapshot: {
+        isProtected: boolean;
+        protectionDurationMinutes?: number;
+    };
+}) => Promise<{
+    response: true | null;
+    error: Response | null;
+}>;

package/types/api/endpoints/updateSnapshot.js

@@ -0,0 +1 @@
+export {};

package/types/api/endpoints/upgradeClone.d.ts

@@ -0,0 +1,8 @@
+export declare type UpgradeClone = (args: {
+    instanceId: string;
+    cloneId: string;
+    dockerImage?: string;
+}) => Promise<{
+    response: true | null;
+    error: Response | null;
+}>;

package/types/api/endpoints/upgradeClone.js

@@ -0,0 +1 @@
+export {};

package/types/api/entities/branchSnapshots.d.ts

@@ -12,4 +12,7 @@ export declare const formatBranchSnapshotDto: (dto: SnapshotDto[]) => {
     logicalSize: number;
     message: string;
     branch: string;
+    protected: boolean;
+    protectedTill?: string | undefined;
+    deleteAt?: string | undefined;
 }[];

package/types/api/entities/clone.d.ts

@@ -4,9 +4,11 @@ export declare type CloneDto = {
     id: string;
     branch: string;
     status: {
-        code: 'OK' | 'CREATING' | 'DELETING' | 'RESETTING' | 'FATAL';
+        code: 'OK' | 'CREATING' | 'DELETING' | 'RESETTING' | 'UPGRADING' | 'WARNING' | 'FATAL';
         message: string;
     };
+    dockerImage?: string;
+    dbVersion?: string;
     protected: boolean;
     protectedTill?: string;
     metadata: {
@@ -39,13 +41,18 @@ export declare const formatCloneDto: (dto: CloneDto) => {
         logicalSize: number;
         message: string;
         branch: string;
+        protected: boolean;
+        protectedTill?: string | undefined;
+        deleteAt?: string | undefined;
     } | null;
     id: string;
     branch: string;
     status: {
-        code: 'OK' | 'CREATING' | 'DELETING' | 'RESETTING' | 'FATAL';
+        code: 'OK' | 'CREATING' | 'DELETING' | 'RESETTING' | 'UPGRADING' | 'WARNING' | 'FATAL';
         message: string;
     };
+    dockerImage?: string | undefined;
+    dbVersion?: string | undefined;
     protected: boolean;
     protectedTill?: string | undefined;
     metadata: {

package/types/api/entities/instance.d.ts

@@ -75,13 +75,18 @@ export declare const formatInstanceDto: (dto: InstanceDto) => {
                     logicalSize: number;
                     message: string;
                     branch: string;
+                    protected: boolean;
+                    protectedTill?: string | undefined;
+                    deleteAt?: string | undefined;
                 } | null;
                 id: string;
                 branch: string;
                 status: {
-                    code: "OK" | "CREATING" | "DELETING" | "RESETTING" | "FATAL";
+                    code: "OK" | "CREATING" | "DELETING" | "RESETTING" | "UPGRADING" | "WARNING" | "FATAL";
                     message: string;
                 };
+                dockerImage?: string | undefined;
+                dbVersion?: string | undefined;
                 protected: boolean;
                 protectedTill?: string | undefined;
                 metadata: {
@@ -106,6 +111,11 @@ export declare const formatInstanceDto: (dto: InstanceDto) => {
             code: "OK" | "WARNING" | "NO_RESPONSE";
             message: string;
         };
+        cloneUpgrade?: {
+            available: boolean;
+            targetVersion?: number | undefined;
+            reason?: string | undefined;
+        } | undefined;
         clones?: import("./clone").CloneDto[] | undefined;
         expectedCloningTime?: number | undefined;
         fileSystem?: {

package/types/api/entities/instanceState.d.ts

@@ -12,6 +12,11 @@ export declare type InstanceStateDto = {
         code: 'OK' | 'WARNING' | 'NO_RESPONSE';
         message: string;
     };
+    cloneUpgrade?: {
+        available: boolean;
+        targetVersion?: number;
+        reason?: string;
+    };
     clones?: CloneDto[];
     expectedCloningTime?: number;
     pools?: PoolDto[];
@@ -80,13 +85,18 @@ export declare const formatInstanceStateDto: (dto: InstanceStateDto) => {
                 logicalSize: number;
                 message: string;
                 branch: string;
+                protected: boolean;
+                protectedTill?: string | undefined;
+                deleteAt?: string | undefined;
             } | null;
             id: string;
             branch: string;
             status: {
-                code: "OK" | "CREATING" | "DELETING" | "RESETTING" | "FATAL";
+                code: "OK" | "CREATING" | "DELETING" | "RESETTING" | "UPGRADING" | "WARNING" | "FATAL";
                 message: string;
             };
+            dockerImage?: string | undefined;
+            dbVersion?: string | undefined;
             protected: boolean;
             protectedTill?: string | undefined;
             metadata: {
@@ -111,6 +121,11 @@ export declare const formatInstanceStateDto: (dto: InstanceStateDto) => {
         code: 'OK' | 'WARNING' | 'NO_RESPONSE';
         message: string;
     };
+    cloneUpgrade?: {
+        available: boolean;
+        targetVersion?: number | undefined;
+        reason?: string | undefined;
+    } | undefined;
     clones?: CloneDto[] | undefined;
     expectedCloningTime?: number | undefined;
     fileSystem?: {

package/types/api/entities/snapshot.d.ts

@@ -9,6 +9,9 @@ export declare type SnapshotDto = {
     logicalSize: number;
     message: string;
     branch: string;
+    protected: boolean;
+    protectedTill?: string;
+    deleteAt?: string;
 };
 export declare const formatSnapshotDto: (dto: SnapshotDto) => {
     createdAtDate: Date;
@@ -23,5 +26,8 @@ export declare const formatSnapshotDto: (dto: SnapshotDto) => {
     logicalSize: number;
     message: string;
     branch: string;
+    protected: boolean;
+    protectedTill?: string | undefined;
+    deleteAt?: string | undefined;
 };
 export declare type Snapshot = ReturnType<typeof formatSnapshotDto>;

package/utils/api.d.ts

@@ -1 +1 @@
-export declare const getTextFromUnknownApiError: (error: Response) => Promise<string>;
+export declare const getTextFromUnknownApiError: (error: Response) => Promise<any>;

package/utils/api.js

@@ -9,6 +9,12 @@ export const getTextFromUnknownApiError = async (error) => {
     try {
         const result = await error.json();
         log(result);
+        // The engine answers with models.Error{code, message}. Showing the serialized object puts
+        // `{"code":"BAD_REQUEST","message":"..."}` in front of the user when the message alone is
+        // what they need; anything without a usable message still falls back to the raw body.
+        if (typeof (result === null || result === void 0 ? void 0 : result.message) === 'string' && result.message !== '') {
+            return result.message;
+        }
         return JSON.stringify(result);
     }
     catch (e) {

package/utils/clone.d.ts

@@ -4,10 +4,12 @@ declare const STATUS_CODE_TO_TYPE: {
     CREATING: "waiting";
     DELETING: "waiting";
     RESETTING: "waiting";
+    UPGRADING: "waiting";
+    WARNING: "warning";
     FATAL: "error";
 };
 declare type StatusCode = keyof typeof STATUS_CODE_TO_TYPE;
-export declare const getCloneStatusType: (statusCode: StatusCode) => "error" | "waiting" | "ok";
+export declare const getCloneStatusType: (statusCode: StatusCode) => "error" | "warning" | "waiting" | "ok";
 export declare const getCloneStatusText: (statusCode: StatusCode) => string;
 export declare const checkIsCloneStable: (clone: Clone) => boolean;
 export {};

package/utils/clone.js

@@ -10,6 +10,8 @@ const STATUS_CODE_TO_TYPE = {
     CREATING: 'waiting',
     DELETING: 'waiting',
     RESETTING: 'waiting',
+    UPGRADING: 'waiting',
+    WARNING: 'warning',
     FATAL: 'error',
 };
 export const getCloneStatusType = (statusCode) => { var _a; return (_a = STATUS_CODE_TO_TYPE[statusCode]) !== null && _a !== void 0 ? _a : 'unknown'; };
@@ -18,4 +20,8 @@ export const getCloneStatusText = (statusCode) => {
         return statusCode;
     return capitalize(statusCode);
 };
-export const checkIsCloneStable = (clone) => clone.status.code === 'OK' || clone.status.code === 'FATAL';
+// WARNING is terminal too: it means the clone is running, just not on the version that was
+// requested. Leaving it out would make the clone page poll forever after a failed upgrade.
+export const checkIsCloneStable = (clone) => clone.status.code === 'OK' ||
+    clone.status.code === 'WARNING' ||
+    clone.status.code === 'FATAL';

package/utils/clonePoller.d.ts

@@ -0,0 +1,12 @@
+export declare const UNSTABLE_CLONE_UPDATE_TIMEOUT = 1000;
+export declare class ClonePoller {
+    private readonly intervalMs;
+    private timeout?;
+    private stopped;
+    constructor(intervalMs?: number);
+    get isStopped(): boolean;
+    start: () => void;
+    stop: () => void;
+    cancel: () => void;
+    scheduleNext: (tick: () => void) => void;
+}

package/utils/clonePoller.js

@@ -0,0 +1,41 @@
+/*--------------------------------------------------------------------------
+ * Copyright (c) 2019-2021, Postgres.ai, Nikolay Samokhvalov nik@postgres.ai
+ * All Rights Reserved. Proprietary and confidential.
+ * Unauthorized copying of this file, via any medium is strictly prohibited
+ *--------------------------------------------------------------------------
+ */
+// interval between clone status polls while a clone is still unstable.
+export const UNSTABLE_CLONE_UPDATE_TIMEOUT = 1000;
+// ClonePoller owns a single self-rescheduling timeout used to poll clone status
+// until it becomes stable. It is reusable: start() re-arms a poller that was
+// previously stopped, and stop() cancels any pending tick and blocks further
+// scheduling — including a tick that an in-flight request is about to queue.
+export class ClonePoller {
+    constructor(intervalMs = UNSTABLE_CLONE_UPDATE_TIMEOUT) {
+        this.intervalMs = intervalMs;
+        this.stopped = false;
+        // start re-arms the poller so a reused store polls again.
+        this.start = () => {
+            this.stopped = false;
+        };
+        // stop halts polling and cancels any pending tick.
+        this.stop = () => {
+            this.stopped = true;
+            clearTimeout(this.timeout);
+        };
+        // cancel drops a pending tick without blocking future scheduling.
+        this.cancel = () => {
+            clearTimeout(this.timeout);
+        };
+        // scheduleNext queues the next tick, unless the poller has been stopped.
+        this.scheduleNext = (tick) => {
+            clearTimeout(this.timeout);
+            if (this.stopped)
+                return;
+            this.timeout = setTimeout(tick, this.intervalMs);
+        };
+    }
+    get isStopped() {
+        return this.stopped;
+    }
+}

package/utils/date.js

@@ -5,23 +5,23 @@
  *--------------------------------------------------------------------------
  */
 import { parse, startOfDay, isSameDay, startOfMonth, startOfWeek, endOfMonth, endOfWeek, differenceInDays, addDays, addMonths, isSameMonth, format, formatDistanceToNowStrict, } from 'date-fns';
+const compactDatePattern = /^(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})$/;
+// formatDateToISO converts a compact UTC timestamp ('20060102150405') to RFC3339 ('2006-01-02T15:04:05Z').
+// The value is a UTC wall-clock, so it must never be interpreted in the browser timezone.
 export const formatDateToISO = (dateString) => {
-    // Handle empty or invalid date strings
-    if (!dateString || dateString.trim() === '') {
+    var _a;
+    const parts = compactDatePattern.exec((_a = dateString === null || dateString === void 0 ? void 0 : dateString.trim()) !== null && _a !== void 0 ? _a : '');
+    if (!parts) {
         return '';
     }
-    try {
-        const parsedDate = parse(dateString, 'yyyyMMddHHmmss', new Date());
-        // Additional validation of parsed date
-        if (!isValidDate(parsedDate) || isNaN(parsedDate.getTime())) {
-            return '';
-        }
-        return format(parsedDate, "yyyy-MM-dd'T'HH:mm:ssXXX");
-    }
-    catch (error) {
-        // Return empty string for invalid date formats
+    const [compact, year, month, day, hours, minutes, seconds] = parts;
+    const parsedDate = new Date(Date.UTC(+year, +month - 1, +day, +hours, +minutes, +seconds));
+    if (!isValidDate(parsedDate)) {
         return '';
     }
+    const isoDate = parsedDate.toISOString().replace(/\.\d+Z$/, 'Z');
+    // reject values rolled over by Date.UTC, e.g. month 13 or hour 25.
+    return isoDate.replace(/[-:TZ]/g, '') === compact ? isoDate : '';
 };
 // parseDate parses date of both format: '2006-01-02 15:04:05 UTC' and `2006-01-02T15:04:05Z` (RFC3339).
 export const parseDate = (dateStr) => parse(dateStr.replace(' UTC', 'Z').replace('T', ' '), 'yyyy-MM-dd HH:mm:ssX', new Date());

package/utils/protection.d.ts

@@ -0,0 +1,5 @@
+export declare const protectionOptions: {
+    value: string;
+    children: string;
+}[];
+export declare const getProtectionSelectValue: (isProtected: boolean, protectedTillDate: Date | null) => string;

package/utils/protection.js

@@ -0,0 +1,23 @@
+// protectionOptions lists the deletion-protection choices shared by the branch and snapshot
+// detail pages: no protection, a set of bounded durations, and forever. The values are the
+// protectionDurationMinutes passed to the update endpoints ('0' means forever, 'none' clears
+// protection).
+export const protectionOptions = [
+    { value: 'none', children: 'No protection' },
+    { value: '60', children: '1 hour' },
+    { value: '720', children: '12 hours' },
+    { value: '1440', children: '1 day' },
+    { value: '4320', children: '3 days' },
+    { value: '10080', children: '7 days' },
+    { value: '43200', children: '30 days' },
+    { value: '0', children: 'Forever' },
+];
+// getProtectionSelectValue maps an entity's protection state to the Select value: 'none' when
+// unprotected, 'current' when protected until a specific time, '0' when protected forever.
+export const getProtectionSelectValue = (isProtected, protectedTillDate) => {
+    if (!isProtected)
+        return 'none';
+    if (!protectedTillDate)
+        return '0';
+    return 'current';
+};