@postgres.ai/shared 4.1.3 → 4.2.0-pr-1200

package/{dist/pages → 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/{dist/pages → 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/{dist/stores → 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/{dist/stores → 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/{dist/types → 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/probeSource.d.ts

@@ -0,0 +1,32 @@
+export declare type ProbeSourceRequest = {
+    url: string;
+    password: string;
+};
+export declare type SourceConnection = {
+    host: string;
+    port: number;
+    username: string;
+    dbname: string;
+};
+export declare type ProposedConfig = {
+    source: SourceConnection;
+    detectedProvider: string;
+    dockerImage: string;
+    dockerTag: string;
+    pgMajorVersion: number;
+    databases: string[];
+    sharedBuffers: string;
+    memoryProbed: boolean;
+    sharedPreloadLibraries: string;
+    queryTuning: {
+        [key: string]: string;
+    };
+};
+export declare type ProbeSourceError = {
+    status: number;
+    message: string;
+};
+export declare type ProbeSource = (req: ProbeSourceRequest) => Promise<{
+    response: ProposedConfig | null;
+    error: ProbeSourceError | null;
+}>;

package/{dist/types → 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/{dist/types → 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/updateConfig.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/{dist/types → 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/{dist/types → 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/{dist/types → types}/api/entities/config.d.ts

@@ -1,10 +1,12 @@
 export interface DatabaseType {
     [name: string]: string | Object;
 }
+export declare type RetrievalMode = 'logical' | 'physical' | 'unknown' | '';
 export declare type configTypes = {
     global?: {
         debug?: boolean;
     };
+    retrievalMode?: RetrievalMode;
     databaseContainer?: {
         dockerImage?: string;
         dockerPath?: string;
@@ -46,6 +48,25 @@ export declare type configTypes = {
                     };
                 };
             };
+            physicalRestore?: {
+                options?: {
+                    tool?: string;
+                    dockerImage?: string;
+                    sync?: {
+                        enabled?: boolean;
+                    };
+                    walg?: {
+                        backupName?: string;
+                    };
+                    pgbackrest?: {
+                        stanza?: string;
+                        delta?: boolean;
+                    };
+                    envs?: {
+                        [key: string]: string | number | boolean;
+                    };
+                };
+            };
         };
     };
 };
@@ -71,6 +92,17 @@ export declare const formatConfig: (config: configTypes) => {
     dockerTag?: string | undefined;
     dockerImageType?: string | undefined;
     debug: boolean | undefined;
+    retrievalMode: RetrievalMode;
+    physicalTool: string;
+    physicalDockerImage: string;
+    physicalSyncEnabled: boolean;
+    physicalWalgBackupName: string;
+    physicalPgbackrestStanza: string;
+    physicalPgbackrestDelta: boolean;
+    physicalEnvs: {
+        key: string;
+        value: string;
+    }[];
     dockerImage: string | undefined;
 };
 export declare type Config = ReturnType<typeof formatConfig>;

package/types/api/entities/config.js

@@ -0,0 +1,74 @@
+import { formatDatabases, formatDumpCustomOptions, getImageMajorVersion, getImageType, isSeDockerImage, } from '@postgres.ai/shared/pages/Instance/Configuration/utils';
+import { formatTuningParams } from '../endpoints/testDbSource';
+const formatPhysicalEnvs = (envs) => {
+    if (!envs)
+        return [];
+    return Object.entries(envs).map(([key, value]) => ({
+        key,
+        value: typeof value === 'string' ? value : String(value),
+    }));
+};
+const inferRetrievalMode = (config) => {
+    var _a, _b, _c, _d;
+    if (config.retrievalMode)
+        return config.retrievalMode;
+    if ((_b = (_a = config.retrieval) === null || _a === void 0 ? void 0 : _a.spec) === null || _b === void 0 ? void 0 : _b.physicalRestore)
+        return 'physical';
+    if ((_d = (_c = config.retrieval) === null || _c === void 0 ? void 0 : _c.spec) === null || _d === void 0 ? void 0 : _d.logicalDump)
+        return 'logical';
+    return '';
+};
+export const formatConfig = (config) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16, _17, _18, _19, _20, _21, _22, _23, _24, _25, _26, _27, _28, _29, _30, _31, _32, _33, _34, _35, _36, _37, _38, _39, _40, _41, _42, _43, _44, _45, _46, _47, _48, _49, _50, _51, _52, _53, _54, _55, _56, _57, _58;
+    const dockerImage = (_a = config.databaseContainer) === null || _a === void 0 ? void 0 : _a.dockerImage;
+    const physical = (_d = (_c = (_b = config.retrieval) === null || _b === void 0 ? void 0 : _b.spec) === null || _c === void 0 ? void 0 : _c.physicalRestore) === null || _d === void 0 ? void 0 : _d.options;
+    return {
+        debug: (_e = config.global) === null || _e === void 0 ? void 0 : _e.debug,
+        retrievalMode: inferRetrievalMode(config),
+        physicalTool: (_f = physical === null || physical === void 0 ? void 0 : physical.tool) !== null && _f !== void 0 ? _f : '',
+        physicalDockerImage: (_g = physical === null || physical === void 0 ? void 0 : physical.dockerImage) !== null && _g !== void 0 ? _g : '',
+        physicalSyncEnabled: (_j = (_h = physical === null || physical === void 0 ? void 0 : physical.sync) === null || _h === void 0 ? void 0 : _h.enabled) !== null && _j !== void 0 ? _j : false,
+        physicalWalgBackupName: (_l = (_k = physical === null || physical === void 0 ? void 0 : physical.walg) === null || _k === void 0 ? void 0 : _k.backupName) !== null && _l !== void 0 ? _l : '',
+        physicalPgbackrestStanza: (_o = (_m = physical === null || physical === void 0 ? void 0 : physical.pgbackrest) === null || _m === void 0 ? void 0 : _m.stanza) !== null && _o !== void 0 ? _o : '',
+        physicalPgbackrestDelta: (_q = (_p = physical === null || physical === void 0 ? void 0 : physical.pgbackrest) === null || _p === void 0 ? void 0 : _p.delta) !== null && _q !== void 0 ? _q : false,
+        physicalEnvs: formatPhysicalEnvs(physical === null || physical === void 0 ? void 0 : physical.envs),
+        dockerImage: isSeDockerImage(dockerImage)
+            ? getImageMajorVersion(dockerImage)
+            : dockerImage && getImageType(dockerImage) === 'Generic Postgres'
+                ? getImageMajorVersion(dockerImage) || dockerImage
+                : dockerImage,
+        ...(dockerImage && {
+            dockerImageType: getImageType(dockerImage),
+        }),
+        // Extract dockerTag for both SE images and Generic Postgres images
+        ...(dockerImage && dockerImage.includes(':') && {
+            dockerTag: dockerImage.split(':')[1],
+        }),
+        dockerPath: dockerImage,
+        tuningParams: formatTuningParams((_r = config.databaseConfigs) === null || _r === void 0 ? void 0 : _r.configs),
+        sharedBuffers: (_t = (_s = config.databaseConfigs) === null || _s === void 0 ? void 0 : _s.configs) === null || _t === void 0 ? void 0 : _t.shared_buffers,
+        sharedPreloadLibraries: (_v = (_u = config.databaseConfigs) === null || _u === void 0 ? void 0 : _u.configs) === null || _v === void 0 ? void 0 : _v.shared_preload_libraries,
+        timetable: (_x = (_w = config.retrieval) === null || _w === void 0 ? void 0 : _w.refresh) === null || _x === void 0 ? void 0 : _x.timetable,
+        dbname: (_3 = (_2 = (_1 = (_0 = (_z = (_y = config.retrieval) === null || _y === void 0 ? void 0 : _y.spec) === null || _z === void 0 ? void 0 : _z.logicalDump) === null || _0 === void 0 ? void 0 : _0.options) === null || _1 === void 0 ? void 0 : _1.source) === null || _2 === void 0 ? void 0 : _2.connection) === null || _3 === void 0 ? void 0 : _3.dbname,
+        host: (_9 = (_8 = (_7 = (_6 = (_5 = (_4 = config.retrieval) === null || _4 === void 0 ? void 0 : _4.spec) === null || _5 === void 0 ? void 0 : _5.logicalDump) === null || _6 === void 0 ? void 0 : _6.options) === null || _7 === void 0 ? void 0 : _7.source) === null || _8 === void 0 ? void 0 : _8.connection) === null || _9 === void 0 ? void 0 : _9.host,
+        port: (_15 = (_14 = (_13 = (_12 = (_11 = (_10 = config.retrieval) === null || _10 === void 0 ? void 0 : _10.spec) === null || _11 === void 0 ? void 0 : _11.logicalDump) === null || _12 === void 0 ? void 0 : _12.options) === null || _13 === void 0 ? void 0 : _13.source) === null || _14 === void 0 ? void 0 : _14.connection) === null || _15 === void 0 ? void 0 : _15.port,
+        username: (_21 = (_20 = (_19 = (_18 = (_17 = (_16 = config.retrieval) === null || _16 === void 0 ? void 0 : _16.spec) === null || _17 === void 0 ? void 0 : _17.logicalDump) === null || _18 === void 0 ? void 0 : _18.options) === null || _19 === void 0 ? void 0 : _19.source) === null || _20 === void 0 ? void 0 : _20.connection) === null || _21 === void 0 ? void 0 : _21.username,
+        password: (_27 = (_26 = (_25 = (_24 = (_23 = (_22 = config.retrieval) === null || _22 === void 0 ? void 0 : _22.spec) === null || _23 === void 0 ? void 0 : _23.logicalDump) === null || _24 === void 0 ? void 0 : _24.options) === null || _25 === void 0 ? void 0 : _25.source) === null || _26 === void 0 ? void 0 : _26.connection) === null || _27 === void 0 ? void 0 : _27.password,
+        databases: formatDatabases((_32 = (_31 = (_30 = (_29 = (_28 = config.retrieval) === null || _28 === void 0 ? void 0 : _28.spec) === null || _29 === void 0 ? void 0 : _29.logicalDump) === null || _30 === void 0 ? void 0 : _30.options) === null || _31 === void 0 ? void 0 : _31.databases) !== null && _32 !== void 0 ? _32 : null),
+        dumpParallelJobs: (_36 = (_35 = (_34 = (_33 = config.retrieval) === null || _33 === void 0 ? void 0 : _33.spec) === null || _34 === void 0 ? void 0 : _34.logicalDump) === null || _35 === void 0 ? void 0 : _35.options) === null || _36 === void 0 ? void 0 : _36.parallelJobs,
+        dumpIgnoreErrors: (_40 = (_39 = (_38 = (_37 = config.retrieval) === null || _37 === void 0 ? void 0 : _37.spec) === null || _38 === void 0 ? void 0 : _38.logicalDump) === null || _39 === void 0 ? void 0 : _39.options) === null || _40 === void 0 ? void 0 : _40.ignoreErrors,
+        restoreParallelJobs: (_44 = (_43 = (_42 = (_41 = config.retrieval) === null || _41 === void 0 ? void 0 : _41.spec) === null || _42 === void 0 ? void 0 : _42.logicalRestore) === null || _43 === void 0 ? void 0 : _43.options) === null || _44 === void 0 ? void 0 : _44.parallelJobs,
+        restoreIgnoreErrors: (_48 = (_47 = (_46 = (_45 = config.retrieval) === null || _45 === void 0 ? void 0 : _45.spec) === null || _46 === void 0 ? void 0 : _46.logicalRestore) === null || _47 === void 0 ? void 0 : _47.options) === null || _48 === void 0 ? void 0 : _48.ignoreErrors,
+        restoreConfigs: (() => {
+            var _a, _b, _c, _d;
+            const configs = (_d = (_c = (_b = (_a = config.retrieval) === null || _a === void 0 ? void 0 : _a.spec) === null || _b === void 0 ? void 0 : _b.logicalRestore) === null || _c === void 0 ? void 0 : _c.options) === null || _d === void 0 ? void 0 : _d.configs;
+            if (!configs || Object.keys(configs).length === 0)
+                return '';
+            return Object.entries(configs)
+                .map(([k, v]) => `${k}=${v}`)
+                .join('\n');
+        })(),
+        pgDumpCustomOptions: formatDumpCustomOptions((_53 = (_52 = (_51 = (_50 = (_49 = config.retrieval) === null || _49 === void 0 ? void 0 : _49.spec) === null || _50 === void 0 ? void 0 : _50.logicalDump) === null || _51 === void 0 ? void 0 : _51.options) === null || _52 === void 0 ? void 0 : _52.customOptions) !== null && _53 !== void 0 ? _53 : null),
+        pgRestoreCustomOptions: formatDumpCustomOptions((_58 = (_57 = (_56 = (_55 = (_54 = config.retrieval) === null || _54 === void 0 ? void 0 : _54.spec) === null || _55 === void 0 ? void 0 : _55.logicalRestore) === null || _56 === void 0 ? void 0 : _56.options) === null || _57 === void 0 ? void 0 : _57.customOptions) !== null && _58 !== void 0 ? _58 : null),
+    };
+};

package/types/api/entities/dbSource.js

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

package/{dist/types → 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/{dist/types → 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/{dist/types → 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/{dist/utils → utils}/api.d.ts

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

package/{dist/utils → 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/{dist/utils → 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/{dist/utils → 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;
+    }
+}