@ductape/sdk 0.3.6 → 0.3.7

package/dist/index.d.ts

@@ -993,7 +993,12 @@ export default class Ductape implements IDuctape {
          * @returns {Promise<void>} Resolves when the storage files are fetched. Throws on error.
          */
         /**
-         * Deletes a storage by tag.
+         * Deletes an entire storage **component** from the product's configuration.
+         * This is an administrative operation, not a file operation — to delete a single file
+         * from cloud storage, use `ductape.storage.remove(options)` (matches `IDeleteOptions`)
+         * instead. Calling this with an `IDeleteOptions`-shaped object by mistake previously
+         * stringified that object into the request URL and produced a confusing 404 rather than a
+         * clear error (DT-087) — now rejected immediately with a descriptive TypeError.
          * @param {string} product - The product tag.
          * @param {string} tag - The storage tag.
          * @returns {Promise<void>} Resolves when the storage is deleted. Throws on error.
@@ -1133,6 +1138,8 @@ export default class Ductape implements IDuctape {
                 fileName: string;
                 buffer: string | Buffer;
                 mimeType?: string;
+                /** Opaque Ductape session token used for authorization and activity attribution. */
+                session?: string;
             }) => Promise<import("./storage").IStorageResult>;
             /**
              * Downloads a file from cloud storage.
@@ -1151,6 +1158,7 @@ export default class Ductape implements IDuctape {
                 env: string;
                 storage: string;
                 fileName: string;
+                session?: string;
             }) => Promise<import("./storage").IDownloadResult>;
             /**
              * Removes a file from cloud storage.
@@ -1169,6 +1177,7 @@ export default class Ductape implements IDuctape {
                 env: string;
                 storage: string;
                 fileName: string;
+                session?: string;
             }) => Promise<import("./storage").IDeleteResult>;
             /**
              * Lists files in cloud storage with pagination.
@@ -1212,6 +1221,7 @@ export default class Ductape implements IDuctape {
                 fileName: string;
                 expiresIn?: number;
                 action?: "read" | "write";
+                session?: string;
             }) => Promise<import("./storage").ISignedUrlResult>;
         };
         /**

package/dist/index.js

@@ -1268,12 +1268,22 @@ class Ductape {
               return builder.fetchStorageFiles(data);
             },*/
             /**
-             * Deletes a storage by tag.
+             * Deletes an entire storage **component** from the product's configuration.
+             * This is an administrative operation, not a file operation — to delete a single file
+             * from cloud storage, use `ductape.storage.remove(options)` (matches `IDeleteOptions`)
+             * instead. Calling this with an `IDeleteOptions`-shaped object by mistake previously
+             * stringified that object into the request URL and produced a confusing 404 rather than a
+             * clear error (DT-087) — now rejected immediately with a descriptive TypeError.
              * @param {string} product - The product tag.
              * @param {string} tag - The storage tag.
              * @returns {Promise<void>} Resolves when the storage is deleted. Throws on error.
              */
             delete: async (product, tag) => {
+                if (typeof product !== 'string' || typeof tag !== 'string') {
+                    throw new TypeError('storage.delete(product, tag) expects two string arguments (product tag, storage tag) — ' +
+                        'it deletes an entire storage component from the product. To delete a single file, use ' +
+                        'storage.remove({product, env, storage, fileName}) instead.');
+                }
                 const builder = await this.getProductBuilder(product);
                 return builder.deleteStorage(tag);
             },