@koolbase/core 12.21.0 → 12.23.0

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

@@ -258,6 +258,22 @@ export declare class KoolbaseStorageFileInUseError extends KoolbaseStorageError
 export declare class KoolbaseStorageNameHasHistoryError extends KoolbaseStorageError {
     constructor(message?: string);
 }
+/**
+ * An upload refused because malware was found in it (storage S6). Nothing of
+ * it was kept; the message names what was found. Trying again with the same
+ * file will be refused again. Code: `malware_found`.
+ */
+export declare class KoolbaseStorageMalwareError extends KoolbaseStorageError {
+    constructor(message?: string);
+}
+/**
+ * A file found to contain malware after it was stored (storage S6): it is
+ * quarantined, and no link to it is given. The server answers 423. Code:
+ * `quarantined`.
+ */
+export declare class KoolbaseStorageQuarantinedError 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.KoolbaseStorageNameHasHistoryError = exports.KoolbaseStorageFileInUseError = exports.KoolbaseDownloadCancelledError = exports.KoolbaseUploadIncompleteError = 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.KoolbaseStorageQuarantinedError = exports.KoolbaseStorageMalwareError = exports.KoolbaseStorageNameHasHistoryError = exports.KoolbaseStorageFileInUseError = exports.KoolbaseDownloadCancelledError = exports.KoolbaseUploadIncompleteError = 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");
@@ -368,6 +368,32 @@ class KoolbaseStorageNameHasHistoryError extends KoolbaseStorageError {
     }
 }
 exports.KoolbaseStorageNameHasHistoryError = KoolbaseStorageNameHasHistoryError;
+/**
+ * An upload refused because malware was found in it (storage S6). Nothing of
+ * it was kept; the message names what was found. Trying again with the same
+ * file will be refused again. Code: `malware_found`.
+ */
+class KoolbaseStorageMalwareError extends KoolbaseStorageError {
+    constructor(message) {
+        super(message ?? 'This file contains malware and was not uploaded', 'malware_found');
+        this.name = 'KoolbaseStorageMalwareError';
+        Object.setPrototypeOf(this, KoolbaseStorageMalwareError.prototype);
+    }
+}
+exports.KoolbaseStorageMalwareError = KoolbaseStorageMalwareError;
+/**
+ * A file found to contain malware after it was stored (storage S6): it is
+ * quarantined, and no link to it is given. The server answers 423. Code:
+ * `quarantined`.
+ */
+class KoolbaseStorageQuarantinedError extends KoolbaseStorageError {
+    constructor(message) {
+        super(message ?? 'This file is quarantined: malware was found in it', 'quarantined');
+        this.name = 'KoolbaseStorageQuarantinedError';
+        Object.setPrototypeOf(this, KoolbaseStorageQuarantinedError.prototype);
+    }
+}
+exports.KoolbaseStorageQuarantinedError = KoolbaseStorageQuarantinedError;
 /**
  * Maps a non-2xx storage-layer response to a typed
  * {@link KoolbaseStorageError}, preferring the server's stable `code` and
@@ -421,6 +447,10 @@ function koolbaseStorageError(status, body, fallbackMessage = 'Storage request f
         }
         case 'name_has_history':
             return new KoolbaseStorageNameHasHistoryError(message);
+        case 'malware_found':
+            return new KoolbaseStorageMalwareError(message);
+        case 'quarantined':
+            return new KoolbaseStorageQuarantinedError(message);
         case 'upload_incomplete': {
             const d = (body?.details ?? {});
             return new KoolbaseUploadIncompleteError(message, Array.isArray(d.missing) ? d.missing : []);
@@ -434,6 +464,8 @@ function koolbaseStorageError(status, body, fallbackMessage = 'Storage request f
             return new KoolbaseStorageFileTooLargeError(message);
         case 415:
             return new KoolbaseStorageMimeTypeError(message);
+        case 423:
+            return new KoolbaseStorageQuarantinedError(message);
         case 404:
             return new KoolbaseStorageNotFoundError(message);
         case 401:

package/dist/cjs/storage.d.ts

@@ -216,6 +216,7 @@ export declare class KoolbaseStorage {
         bucket: string;
         path: string;
         transform?: KoolbaseImageTransform;
+        preset?: string;
     }): string;
     /**
      * Build the stable public CDN URL for a file in a public bucket.

package/dist/cjs/storage.js

@@ -556,6 +556,9 @@ class KoolbaseStorage {
             this.nudgeBootstrap?.();
             throw new storage_errors_js_1.KoolbaseStorageProjectIdentityError();
         }
+        // A named preset (Storage → Presets): the edge sizes it; no transform.
+        if (args.preset)
+            return KoolbaseStorage.publicUrlWithPreset({ projectId: pid, presetName: args.preset, bucket: args.bucket, path: args.path });
         return KoolbaseStorage.publicUrl({ projectId: pid, bucket: args.bucket, path: args.path, transform: args.transform });
     }
     /**

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

@@ -258,6 +258,22 @@ export declare class KoolbaseStorageFileInUseError extends KoolbaseStorageError
 export declare class KoolbaseStorageNameHasHistoryError extends KoolbaseStorageError {
     constructor(message?: string);
 }
+/**
+ * An upload refused because malware was found in it (storage S6). Nothing of
+ * it was kept; the message names what was found. Trying again with the same
+ * file will be refused again. Code: `malware_found`.
+ */
+export declare class KoolbaseStorageMalwareError extends KoolbaseStorageError {
+    constructor(message?: string);
+}
+/**
+ * A file found to contain malware after it was stored (storage S6): it is
+ * quarantined, and no link to it is given. The server answers 423. Code:
+ * `quarantined`.
+ */
+export declare class KoolbaseStorageQuarantinedError 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

@@ -341,6 +341,30 @@ export class KoolbaseStorageNameHasHistoryError extends KoolbaseStorageError {
         Object.setPrototypeOf(this, KoolbaseStorageNameHasHistoryError.prototype);
     }
 }
+/**
+ * An upload refused because malware was found in it (storage S6). Nothing of
+ * it was kept; the message names what was found. Trying again with the same
+ * file will be refused again. Code: `malware_found`.
+ */
+export class KoolbaseStorageMalwareError extends KoolbaseStorageError {
+    constructor(message) {
+        super(message ?? 'This file contains malware and was not uploaded', 'malware_found');
+        this.name = 'KoolbaseStorageMalwareError';
+        Object.setPrototypeOf(this, KoolbaseStorageMalwareError.prototype);
+    }
+}
+/**
+ * A file found to contain malware after it was stored (storage S6): it is
+ * quarantined, and no link to it is given. The server answers 423. Code:
+ * `quarantined`.
+ */
+export class KoolbaseStorageQuarantinedError extends KoolbaseStorageError {
+    constructor(message) {
+        super(message ?? 'This file is quarantined: malware was found in it', 'quarantined');
+        this.name = 'KoolbaseStorageQuarantinedError';
+        Object.setPrototypeOf(this, KoolbaseStorageQuarantinedError.prototype);
+    }
+}
 /**
  * Maps a non-2xx storage-layer response to a typed
  * {@link KoolbaseStorageError}, preferring the server's stable `code` and
@@ -394,6 +418,10 @@ export function koolbaseStorageError(status, body, fallbackMessage = 'Storage re
         }
         case 'name_has_history':
             return new KoolbaseStorageNameHasHistoryError(message);
+        case 'malware_found':
+            return new KoolbaseStorageMalwareError(message);
+        case 'quarantined':
+            return new KoolbaseStorageQuarantinedError(message);
         case 'upload_incomplete': {
             const d = (body?.details ?? {});
             return new KoolbaseUploadIncompleteError(message, Array.isArray(d.missing) ? d.missing : []);
@@ -407,6 +435,8 @@ export function koolbaseStorageError(status, body, fallbackMessage = 'Storage re
             return new KoolbaseStorageFileTooLargeError(message);
         case 415:
             return new KoolbaseStorageMimeTypeError(message);
+        case 423:
+            return new KoolbaseStorageQuarantinedError(message);
         case 404:
             return new KoolbaseStorageNotFoundError(message);
         case 401:

package/dist/esm/storage.d.ts

@@ -216,6 +216,7 @@ export declare class KoolbaseStorage {
         bucket: string;
         path: string;
         transform?: KoolbaseImageTransform;
+        preset?: string;
     }): string;
     /**
      * Build the stable public CDN URL for a file in a public bucket.

package/dist/esm/storage.js

@@ -553,6 +553,9 @@ export class KoolbaseStorage {
             this.nudgeBootstrap?.();
             throw new KoolbaseStorageProjectIdentityError();
         }
+        // A named preset (Storage → Presets): the edge sizes it; no transform.
+        if (args.preset)
+            return KoolbaseStorage.publicUrlWithPreset({ projectId: pid, presetName: args.preset, bucket: args.bucket, path: args.path });
         return KoolbaseStorage.publicUrl({ projectId: pid, bucket: args.bucket, path: args.path, transform: args.transform });
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koolbase/core",
-  "version": "12.21.0",
+  "version": "12.23.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",