@koolbase/core 12.16.0 → 12.17.0

package/dist/cjs/storage-errors.d.ts

@@ -226,6 +226,24 @@ export declare class KoolbaseStorageInvalidCursorError extends KoolbaseStorageEr
 export declare class KoolbaseStorageSignInRequiredError extends KoolbaseStorageError {
     constructor(message?: string);
 }
+/**
+ * A move refused while records point at the file (S1b): `field` holds its
+ * path in `records` records. Change those first, or copy the file. Code:
+ * `file_in_use`.
+ */
+export declare class KoolbaseStorageFileInUseError extends KoolbaseStorageError {
+    field?: string;
+    records: number;
+    constructor(message?: string, field?: string, records?: number);
+}
+/**
+ * A move, within a bucket, to a name a deleted file's kept versions still
+ * use (S1b): the two histories would become one. Choose another name.
+ * Code: `name_has_history`.
+ */
+export declare class KoolbaseStorageNameHasHistoryError extends KoolbaseStorageError {
+    constructor(message?: string);
+}
 /**
  * Maps a non-2xx storage-layer response to a typed
  * {@link KoolbaseStorageError}, preferring the server's stable `code` and

package/dist/cjs/storage-errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KoolbaseStorageSignInRequiredError = exports.KoolbaseStorageInvalidCursorError = exports.KoolbaseStorageBusyError = exports.KoolbaseUploadNotFoundError = exports.KoolbaseUploadCancelledError = exports.KoolbaseStorageMetadataInvalidError = exports.KoolbaseStorageMimeTypeError = exports.KoolbaseStorageFileTooLargeError = exports.KoolbaseStorageQuotaError = exports.KoolbaseCapBelowUsageError = exports.KoolbaseUploadExpiredError = exports.KoolbaseUploadURLFailedError = exports.KoolbaseStoragePermissionError = exports.KoolbaseStorageValidationError = exports.KoolbaseStorageNotFoundError = exports.KoolbaseStorageConflictError = exports.KoolbaseStorageProjectIdentityError = exports.KoolbaseStorageError = void 0;
+exports.KoolbaseStorageNameHasHistoryError = exports.KoolbaseStorageFileInUseError = exports.KoolbaseStorageSignInRequiredError = exports.KoolbaseStorageInvalidCursorError = exports.KoolbaseStorageBusyError = exports.KoolbaseUploadNotFoundError = exports.KoolbaseUploadCancelledError = exports.KoolbaseStorageMetadataInvalidError = exports.KoolbaseStorageMimeTypeError = exports.KoolbaseStorageFileTooLargeError = exports.KoolbaseStorageQuotaError = exports.KoolbaseCapBelowUsageError = exports.KoolbaseUploadExpiredError = exports.KoolbaseUploadURLFailedError = exports.KoolbaseStoragePermissionError = exports.KoolbaseStorageValidationError = exports.KoolbaseStorageNotFoundError = exports.KoolbaseStorageConflictError = exports.KoolbaseStorageProjectIdentityError = exports.KoolbaseStorageError = void 0;
 exports.koolbaseStorageError = koolbaseStorageError;
 exports.koolbaseStorageErrorFromResponse = koolbaseStorageErrorFromResponse;
 const errors_js_1 = require("./errors.js");
@@ -316,6 +316,34 @@ class KoolbaseStorageSignInRequiredError extends KoolbaseStorageError {
     }
 }
 exports.KoolbaseStorageSignInRequiredError = KoolbaseStorageSignInRequiredError;
+/**
+ * A move refused while records point at the file (S1b): `field` holds its
+ * path in `records` records. Change those first, or copy the file. Code:
+ * `file_in_use`.
+ */
+class KoolbaseStorageFileInUseError extends KoolbaseStorageError {
+    constructor(message, field, records = 0) {
+        super(message ?? 'Records still point at this file', 'file_in_use');
+        this.field = field;
+        this.records = records;
+        this.name = 'KoolbaseStorageFileInUseError';
+        Object.setPrototypeOf(this, KoolbaseStorageFileInUseError.prototype);
+    }
+}
+exports.KoolbaseStorageFileInUseError = KoolbaseStorageFileInUseError;
+/**
+ * A move, within a bucket, to a name a deleted file's kept versions still
+ * use (S1b): the two histories would become one. Choose another name.
+ * Code: `name_has_history`.
+ */
+class KoolbaseStorageNameHasHistoryError extends KoolbaseStorageError {
+    constructor(message) {
+        super(message ?? 'A deleted file by that name still has kept versions; choose another name', 'name_has_history');
+        this.name = 'KoolbaseStorageNameHasHistoryError';
+        Object.setPrototypeOf(this, KoolbaseStorageNameHasHistoryError.prototype);
+    }
+}
+exports.KoolbaseStorageNameHasHistoryError = KoolbaseStorageNameHasHistoryError;
 /**
  * Maps a non-2xx storage-layer response to a typed
  * {@link KoolbaseStorageError}, preferring the server's stable `code` and
@@ -363,6 +391,12 @@ function koolbaseStorageError(status, body, fallbackMessage = 'Storage request f
             return new KoolbaseStorageSignInRequiredError(message);
         case 'not_allowed':
             return new KoolbaseStoragePermissionError(message);
+        case 'file_in_use': {
+            const d = (body?.details ?? {});
+            return new KoolbaseStorageFileInUseError(message, d.field, Number(d.records ?? 0));
+        }
+        case 'name_has_history':
+            return new KoolbaseStorageNameHasHistoryError(message);
     }
     // ─── status fallback (pre-code servers or uncoded paths) ───
     switch (status) {

package/dist/cjs/storage.d.ts

@@ -94,6 +94,37 @@ export declare class KoolbaseStorage {
      * the bucket's view rule hides from the caller.
      */
     getFileInfo(bucket: string, path: string): Promise<KoolbaseFileInfo>;
+    /**
+     * Move a file to `to`, in its bucket or into `toBucket` (S1b). Nothing is
+     * uploaded again. The bucket's rules decide: delete on the file, and
+     * upload at the destination, whose limits apply as to an upload. The
+     * destination must be free.
+     *
+     * Within one bucket the file keeps its kept versions. Refused with
+     * `KoolbaseStorageFileInUseError` while records point at the file: change
+     * them first, or {@link copy} it.
+     *
+     * @example
+     * await Koolbase.storage.move({ bucket: 'inbox', from: 'scan.png', toBucket: 'vault', to: '2026/scan.png' });
+     */
+    move(options: {
+        bucket: string;
+        from: string;
+        to: string;
+        toBucket?: string;
+    }): Promise<KoolbaseObject>;
+    /**
+     * Copy a file to `to`, in its bucket or into `toBucket` (S1b): a new file,
+     * the caller's, with the same bytes. The bucket's rules decide: view on
+     * the file, and upload at the destination.
+     */
+    copy(options: {
+        bucket: string;
+        from: string;
+        to: string;
+        toBucket?: string;
+    }): Promise<KoolbaseObject>;
+    private transfer;
     /**
      * Apply a partial metadata update to an existing object. Returns the
      * post-update {@link KoolbaseObject} with the merged metadata.

package/dist/cjs/storage.js

@@ -256,6 +256,44 @@ class KoolbaseStorage {
         }
         return (0, storage_files_js_1.fileInfoFromJson)((await res.json()));
     }
+    /**
+     * Move a file to `to`, in its bucket or into `toBucket` (S1b). Nothing is
+     * uploaded again. The bucket's rules decide: delete on the file, and
+     * upload at the destination, whose limits apply as to an upload. The
+     * destination must be free.
+     *
+     * Within one bucket the file keeps its kept versions. Refused with
+     * `KoolbaseStorageFileInUseError` while records point at the file: change
+     * them first, or {@link copy} it.
+     *
+     * @example
+     * await Koolbase.storage.move({ bucket: 'inbox', from: 'scan.png', toBucket: 'vault', to: '2026/scan.png' });
+     */
+    async move(options) {
+        return this.transfer('move', options);
+    }
+    /**
+     * Copy a file to `to`, in its bucket or into `toBucket` (S1b): a new file,
+     * the caller's, with the same bytes. The bucket's rules decide: view on
+     * the file, and upload at the destination.
+     */
+    async copy(options) {
+        return this.transfer('copy', options);
+    }
+    async transfer(op, o) {
+        const body = { bucket: o.bucket, from: o.from, to: o.to };
+        if (o.toBucket && o.toBucket !== o.bucket)
+            body.to_bucket = o.toBucket;
+        const res = await (0, network_js_1.sessionFetch)(`${this.config.baseUrl}/v1/sdk/storage/${op}`, {
+            method: 'POST',
+            headers: { ...(await this.buildHeaders()), 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            throw await this.error(res, op === 'move' ? 'Failed to move the file' : 'Failed to copy the file');
+        }
+        return mapObjectFromServer(await res.json());
+    }
     /**
      * Apply a partial metadata update to an existing object. Returns the
      * post-update {@link KoolbaseObject} with the merged metadata.

package/dist/esm/storage-errors.d.ts

@@ -226,6 +226,24 @@ export declare class KoolbaseStorageInvalidCursorError extends KoolbaseStorageEr
 export declare class KoolbaseStorageSignInRequiredError extends KoolbaseStorageError {
     constructor(message?: string);
 }
+/**
+ * A move refused while records point at the file (S1b): `field` holds its
+ * path in `records` records. Change those first, or copy the file. Code:
+ * `file_in_use`.
+ */
+export declare class KoolbaseStorageFileInUseError extends KoolbaseStorageError {
+    field?: string;
+    records: number;
+    constructor(message?: string, field?: string, records?: number);
+}
+/**
+ * A move, within a bucket, to a name a deleted file's kept versions still
+ * use (S1b): the two histories would become one. Choose another name.
+ * Code: `name_has_history`.
+ */
+export declare class KoolbaseStorageNameHasHistoryError extends KoolbaseStorageError {
+    constructor(message?: string);
+}
 /**
  * Maps a non-2xx storage-layer response to a typed
  * {@link KoolbaseStorageError}, preferring the server's stable `code` and

package/dist/esm/storage-errors.js

@@ -293,6 +293,32 @@ export class KoolbaseStorageSignInRequiredError extends KoolbaseStorageError {
         Object.setPrototypeOf(this, KoolbaseStorageSignInRequiredError.prototype);
     }
 }
+/**
+ * A move refused while records point at the file (S1b): `field` holds its
+ * path in `records` records. Change those first, or copy the file. Code:
+ * `file_in_use`.
+ */
+export class KoolbaseStorageFileInUseError extends KoolbaseStorageError {
+    constructor(message, field, records = 0) {
+        super(message ?? 'Records still point at this file', 'file_in_use');
+        this.field = field;
+        this.records = records;
+        this.name = 'KoolbaseStorageFileInUseError';
+        Object.setPrototypeOf(this, KoolbaseStorageFileInUseError.prototype);
+    }
+}
+/**
+ * A move, within a bucket, to a name a deleted file's kept versions still
+ * use (S1b): the two histories would become one. Choose another name.
+ * Code: `name_has_history`.
+ */
+export class KoolbaseStorageNameHasHistoryError extends KoolbaseStorageError {
+    constructor(message) {
+        super(message ?? 'A deleted file by that name still has kept versions; choose another name', 'name_has_history');
+        this.name = 'KoolbaseStorageNameHasHistoryError';
+        Object.setPrototypeOf(this, KoolbaseStorageNameHasHistoryError.prototype);
+    }
+}
 /**
  * Maps a non-2xx storage-layer response to a typed
  * {@link KoolbaseStorageError}, preferring the server's stable `code` and
@@ -340,6 +366,12 @@ export function koolbaseStorageError(status, body, fallbackMessage = 'Storage re
             return new KoolbaseStorageSignInRequiredError(message);
         case 'not_allowed':
             return new KoolbaseStoragePermissionError(message);
+        case 'file_in_use': {
+            const d = (body?.details ?? {});
+            return new KoolbaseStorageFileInUseError(message, d.field, Number(d.records ?? 0));
+        }
+        case 'name_has_history':
+            return new KoolbaseStorageNameHasHistoryError(message);
     }
     // ─── status fallback (pre-code servers or uncoded paths) ───
     switch (status) {

package/dist/esm/storage.d.ts

@@ -94,6 +94,37 @@ export declare class KoolbaseStorage {
      * the bucket's view rule hides from the caller.
      */
     getFileInfo(bucket: string, path: string): Promise<KoolbaseFileInfo>;
+    /**
+     * Move a file to `to`, in its bucket or into `toBucket` (S1b). Nothing is
+     * uploaded again. The bucket's rules decide: delete on the file, and
+     * upload at the destination, whose limits apply as to an upload. The
+     * destination must be free.
+     *
+     * Within one bucket the file keeps its kept versions. Refused with
+     * `KoolbaseStorageFileInUseError` while records point at the file: change
+     * them first, or {@link copy} it.
+     *
+     * @example
+     * await Koolbase.storage.move({ bucket: 'inbox', from: 'scan.png', toBucket: 'vault', to: '2026/scan.png' });
+     */
+    move(options: {
+        bucket: string;
+        from: string;
+        to: string;
+        toBucket?: string;
+    }): Promise<KoolbaseObject>;
+    /**
+     * Copy a file to `to`, in its bucket or into `toBucket` (S1b): a new file,
+     * the caller's, with the same bytes. The bucket's rules decide: view on
+     * the file, and upload at the destination.
+     */
+    copy(options: {
+        bucket: string;
+        from: string;
+        to: string;
+        toBucket?: string;
+    }): Promise<KoolbaseObject>;
+    private transfer;
     /**
      * Apply a partial metadata update to an existing object. Returns the
      * post-update {@link KoolbaseObject} with the merged metadata.

package/dist/esm/storage.js

@@ -253,6 +253,44 @@ export class KoolbaseStorage {
         }
         return fileInfoFromJson((await res.json()));
     }
+    /**
+     * Move a file to `to`, in its bucket or into `toBucket` (S1b). Nothing is
+     * uploaded again. The bucket's rules decide: delete on the file, and
+     * upload at the destination, whose limits apply as to an upload. The
+     * destination must be free.
+     *
+     * Within one bucket the file keeps its kept versions. Refused with
+     * `KoolbaseStorageFileInUseError` while records point at the file: change
+     * them first, or {@link copy} it.
+     *
+     * @example
+     * await Koolbase.storage.move({ bucket: 'inbox', from: 'scan.png', toBucket: 'vault', to: '2026/scan.png' });
+     */
+    async move(options) {
+        return this.transfer('move', options);
+    }
+    /**
+     * Copy a file to `to`, in its bucket or into `toBucket` (S1b): a new file,
+     * the caller's, with the same bytes. The bucket's rules decide: view on
+     * the file, and upload at the destination.
+     */
+    async copy(options) {
+        return this.transfer('copy', options);
+    }
+    async transfer(op, o) {
+        const body = { bucket: o.bucket, from: o.from, to: o.to };
+        if (o.toBucket && o.toBucket !== o.bucket)
+            body.to_bucket = o.toBucket;
+        const res = await sessionFetch(`${this.config.baseUrl}/v1/sdk/storage/${op}`, {
+            method: 'POST',
+            headers: { ...(await this.buildHeaders()), 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            throw await this.error(res, op === 'move' ? 'Failed to move the file' : 'Failed to copy the file');
+        }
+        return mapObjectFromServer(await res.json());
+    }
     /**
      * Apply a partial metadata update to an existing object. Returns the
      * post-update {@link KoolbaseObject} with the merged metadata.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koolbase/core",
-  "version": "12.16.0",
+  "version": "12.17.0",
   "description": "Koolbase SDK core \u2014 shared behaviour behind @koolbase/react-native and @koolbase/js. Install one of those, not this.",
   "main": "./dist/cjs/index.js",
   "types": "./dist/esm/index.d.ts",