@lenso/storage 0.1.0 → 0.2.0

package/README.md

@@ -15,6 +15,14 @@ Private object storage with explicit Lenso instance references. Business methods
 
 Install `@lenso/core` and this package. Install the three AWS SDK peers for `/s3`, or `drizzle-orm@0.45.3` for the database subpaths. Do not import `/local` or `/s3` in a Workers entry. Inspect `storage.capabilities` before selecting signing, conditional or range operations; unsupported operations throw `StorageError` with `code: "unsupported"`.
 
+`StorageError` retains its internal message and optional cause. Its runtime code
+is restricted to the declared domain codes; an unsupported code becomes
+`provider`. Use `storageErrorDiagnostic(error)` for a transport-neutral fixed
+`{code, phase, message}` projection of a recognized instance. Do not publish the
+original provider text. The existing `/fetch` helpers retain their JSON format
+and status mapping, not Problem Details; applications may explicitly opt into
+the optional Web helper at a separate HTTP boundary.
+
 ## Multiple instances and object streams
 
 ```ts

package/dist/fetch.js

@@ -1,6 +1,7 @@
 import {
-  StorageError2
-} from "./index-0fz1t930.js";
+  StorageError2,
+  storageErrorDiagnostic2
+} from "./index-tarzr4hr.js";
 
 // src/fetch.ts
 var privateDownloadHeaders = {
@@ -12,7 +13,8 @@ async function respond(operation) {
   try {
     return await operation();
   } catch (error) {
-    if (!(error instanceof StorageError2))
+    const safe = storageErrorDiagnostic2(error);
+    if (!safe)
       throw error;
     const status = {
       "invalid-key": 400,
@@ -24,8 +26,8 @@ async function respond(operation) {
       "too-large": 413,
       aborted: 499,
       provider: 502
-    }[error.code];
-    return Response.json({ error: error.code }, {
+    }[safe.code];
+    return Response.json({ error: safe.code }, {
       status,
       headers: { "cache-control": "private, no-store" }
     });

package/dist/files.js

@@ -2,11 +2,11 @@ import {
   StorageError2,
   validateContentType2,
   validateExpiry2
-} from "./index-0fz1t930.js";
+} from "./index-tarzr4hr.js";
 import {
   validateUpload,
   checkedUpload
-} from "./index-fa6z0g4w.js";
+} from "./index-2dw57ap0.js";
 
 // src/files.ts
 import { definePlugin } from "@lenso/core/plugin";

package/dist/{index-fa6z0g4w.js → index-2dw57ap0.js}

@@ -1,7 +1,7 @@
 import {
   StorageError2,
   validateContentType2
-} from "./index-0fz1t930.js";
+} from "./index-tarzr4hr.js";
 
 // src/stream.ts
 function validateUpload(input) {

package/dist/{index-0fz1t930.js → index-tarzr4hr.js}

@@ -1,14 +1,31 @@
 // src/index.ts
 import { definePlugin } from "@lenso/core/plugin";
+var storageMessages = {
+  "invalid-key": "Object key is invalid.",
+  "invalid-input": "Storage input is invalid.",
+  "not-found": "Object was not found.",
+  forbidden: "Storage access denied.",
+  unsupported: "Storage operation is not supported.",
+  conflict: "Storage state conflicts with the operation.",
+  "too-large": "Object exceeds the size limit.",
+  aborted: "Storage request cancelled; effects may have completed.",
+  provider: "Storage provider operation failed."
+};
 
 class StorageError2 extends Error {
   code;
   constructor(code, message, options) {
     super(message, options);
-    this.code = code;
+    this.code = typeof code === "string" && Object.hasOwn(storageMessages, code) ? code : "provider";
     this.name = "StorageError";
   }
 }
+function storageErrorDiagnostic2(error) {
+  if (!(error instanceof StorageError2))
+    return;
+  const code = typeof error.code === "string" && Object.hasOwn(storageMessages, error.code) ? error.code : "provider";
+  return { code, phase: "invoke", message: storageMessages[code] };
+}
 function createStoragePlugin2(options) {
   return definePlugin({
     id: options.id,
@@ -61,4 +78,4 @@ function unsupportedSigning2() {
   throw new StorageError2("unsupported", "This adapter cannot issue signed URLs; configure an authorized application Fetch endpoint");
 }
 
-export { StorageError2, createStoragePlugin2, validateKey2, validateContentType2, validateList2, validateRange2, validateExpiry2, unsupportedSigning2 };
+export { StorageError2, storageErrorDiagnostic2, createStoragePlugin2, validateKey2, validateContentType2, validateList2, validateRange2, validateExpiry2, unsupportedSigning2 };

package/dist/index.d.ts

@@ -4,6 +4,12 @@ export declare class StorageError extends Error {
     readonly code: StorageErrorCode;
     constructor(code: StorageErrorCode, message: string, options?: ErrorOptions);
 }
+/** Preserve provider causes internally; publish only a fixed domain classification. */
+export declare function storageErrorDiagnostic(error: unknown): {
+    readonly code: StorageErrorCode;
+    readonly phase: "invoke";
+    readonly message: string;
+} | undefined;
 export interface StorageCapabilities {
     readonly provider: "local" | "s3" | "r2-binding";
     readonly signedUpload: boolean;

package/dist/index.js

@@ -1,5 +1,6 @@
 import {
   StorageError2,
+  storageErrorDiagnostic2,
   createStoragePlugin2,
   validateKey2,
   validateContentType2,
@@ -7,10 +8,11 @@ import {
   validateRange2,
   validateExpiry2,
   unsupportedSigning2
-} from "./index-0fz1t930.js";
+} from "./index-tarzr4hr.js";
 export {
   StorageError2 as StorageError,
   createStoragePlugin2 as createStoragePlugin,
+  storageErrorDiagnostic2 as storageErrorDiagnostic,
   unsupportedSigning2 as unsupportedSigning,
   validateContentType2 as validateContentType,
   validateExpiry2 as validateExpiry,

package/dist/local.js

@@ -5,10 +5,10 @@ import {
   validateList2,
   validateRange2,
   unsupportedSigning2
-} from "./index-0fz1t930.js";
+} from "./index-tarzr4hr.js";
 import {
   checkedUpload
-} from "./index-fa6z0g4w.js";
+} from "./index-2dw57ap0.js";
 
 // src/local.ts
 import { constants } from "node:fs";

package/dist/r2.js

@@ -5,11 +5,11 @@ import {
   validateList2,
   validateRange2,
   unsupportedSigning2
-} from "./index-0fz1t930.js";
+} from "./index-tarzr4hr.js";
 import {
   validateUpload,
   checkedUpload
-} from "./index-fa6z0g4w.js";
+} from "./index-2dw57ap0.js";
 
 // src/r2.ts
 function metadata(object) {

package/dist/s3.js

@@ -5,11 +5,11 @@ import {
   validateList2,
   validateRange2,
   validateExpiry2
-} from "./index-0fz1t930.js";
+} from "./index-tarzr4hr.js";
 import {
   validateUpload,
   checkedUpload
-} from "./index-fa6z0g4w.js";
+} from "./index-2dw57ap0.js";
 
 // src/s3.ts
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lenso/storage",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -53,7 +53,7 @@
     "test": "bun test test"
   },
   "dependencies": {
-    "@lenso/core": "^0.1.0"
+    "@lenso/core": "^0.2.1"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "3.1147.0",