@btravstack/storage 0.37.0 → 0.39.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btravstack/storage",
-  "version": "0.37.0",
+  "version": "0.39.0",
   "description": "A Storage port for @btravstack/core: an in-memory adapter, an S3-compatible adapter with presigned reads, and a composition that spans, counts and logs every operation",
   "keywords": [
     "dependency-injection",
@@ -55,11 +55,11 @@
   "devDependencies": {
     "@aws-sdk/client-s3": "3.1149.0",
     "@aws-sdk/s3-request-presigner": "3.1149.0",
-    "@btravstack/config": "0.37.0",
-    "@btravstack/core": "0.37.0",
-    "@btravstack/di": "0.37.0",
+    "@btravstack/config": "0.39.0",
+    "@btravstack/core": "0.39.0",
+    "@btravstack/di": "0.39.0",
     "@btravstack/internal-test-infra": "0.0.0",
-    "@btravstack/observability": "0.37.0",
+    "@btravstack/observability": "0.39.0",
     "@btravstack/tsconfig": "0.4.0",
     "@opentelemetry/api": "1.9.1",
     "@opentelemetry/sdk-metrics": "2.12.0",
@@ -76,9 +76,9 @@
   "peerDependencies": {
     "@aws-sdk/client-s3": "^3.1000.0",
     "@aws-sdk/s3-request-presigner": "^3.1000.0",
-    "@btravstack/config": "^0.37.0",
-    "@btravstack/core": "^0.37.0",
-    "@btravstack/di": "^0.37.0",
+    "@btravstack/config": "^0.39.0",
+    "@btravstack/core": "^0.39.0",
+    "@btravstack/di": "^0.39.0",
     "unthrown": "^5.0.0"
   },
   "peerDependenciesMeta": {

package/dist/storage-uSBWFyB2.d.cts

@@ -1,92 +0,0 @@
-import { AsyncResult } from "unthrown";
-//#region src/storage.d.ts
-/** One stored object: its bytes and what they are. */
-type StoredObject = {
-  readonly bytes: Uint8Array;
-  readonly contentType: string;
-};
-declare const ObjectNotFound_base: import("unthrown").TaggedErrorConstructor<"ObjectNotFound">;
-/** The key is not there. Only `get` answers it — see `delete` and `presignedUrl` below. */
-declare class ObjectNotFound extends ObjectNotFound_base<{
-  readonly key: string;
-}> {}
-declare const ObjectExists_base: import("unthrown").TaggedErrorConstructor<"ObjectExists">;
-/** An object already holds the key. Only `putIfAbsent` answers it. */
-declare class ObjectExists extends ObjectExists_base<{
-  readonly key: string;
-}> {}
-declare const StorageUnavailable_base: import("unthrown").TaggedErrorConstructor<"StorageUnavailable">;
-/** The store could not answer — the endpoint is down, the credentials were refused, the bucket is gone. */
-declare class StorageUnavailable extends StorageUnavailable_base<{
-  readonly operation: "put" | "putIfAbsent" | "get" | "delete" | "presignedUrl" | "presignedUpload";
-  readonly key: string;
-  readonly reason: string;
-}> {}
-declare const PresignNotSupported_base: import("unthrown").TaggedErrorConstructor<"PresignNotSupported">;
-/** The adapter cannot mint a time-limited URL, and says so rather than pretending. */
-declare class PresignNotSupported extends PresignNotSupported_base<{
-  readonly key: string;
-}> {}
-type StorageService = {
-  readonly put: (key: string, bytes: Uint8Array, options: {
-    readonly contentType: string;
-  }) => AsyncResult<void, StorageUnavailable>;
-  /** Writes the object only if no object holds the key: the first writer wins, atomically, in the store. */
-  readonly putIfAbsent: (key: string, bytes: Uint8Array, options: {
-    readonly contentType: string;
-  }) => AsyncResult<void, ObjectExists | StorageUnavailable>;
-  readonly get: (key: string) => AsyncResult<StoredObject, ObjectNotFound | StorageUnavailable>;
-  /** Deleting a key nobody stored is `Ok`: delete is idempotent, which is S3's own behaviour rather than a fiction over it. */
-  readonly delete: (key: string) => AsyncResult<void, StorageUnavailable>;
-  /**
-   * A URL that reads the object for `ttlMs`, without the caller holding
-   * credentials.
-   *
-   * There is **no `ObjectNotFound` arm**: presigning is a signature computation
-   * that asks the store nothing, so a URL for an absent key is minted happily
-   * and 404s when followed. Checking would cost a HEAD per call.
-   */
-  readonly presignedUrl: (key: string, options: {
-    readonly ttlMs: number;
-  }) => AsyncResult<string, PresignNotSupported | StorageUnavailable>;
-  /**
-   * A URL that writes the object for `ttlMs`, without the caller holding
-   * credentials — so the bytes go from the client to the store and never
-   * through this process.
-   *
-   * **`contentType` and `contentLength` are signed, not advisory.** They are
-   * part of the signature, so a client sending different ones is refused by the
-   * store. The same URL can write the key repeatedly until expiry, replacing
-   * the previous object with different bytes of that size and type. Neither
-   * signed header proves the bytes. `contentLength` is required — an unsigned
-   * length would allow an unbounded single write, and there is no ceiling a
-   * presigned PUT can express other than the exact number.
-   *
-   * The application still decides every input: whether this caller may write
-   * this key, how long the URL lives, and what size it is willing to accept.
-   * The adapter computes a signature over that decision and nothing more.
-   */
-  readonly presignedUpload: (key: string, options: {
-    readonly ttlMs: number;
-    readonly contentType: string;
-    readonly contentLength: number;
-  }) => AsyncResult<string, PresignNotSupported | StorageUnavailable>;
-};
-declare const Storage_base: import("@btravstack/di").PortClass<"Storage">;
-/**
- * The port an application depends on.
- *
- * Keys are plain strings the caller composes, tenant included: a store is an
- * application service, and the framework has no concept of a tenant to put in a
- * slot.
- *
- * **Bytes, not streams.** An object here is a document. Streaming would change
- * every signature, adapter and test to serve a case that wants a different
- * design anyway — a stated non-goal, not an oversight.
- */
-declare class Storage extends Storage_base<StorageService> {}
-declare const StorageBackend_base: import("@btravstack/di").PortClass<"StorageBackend">;
-/** The port every adapter provides, and the one an application never depends on. */
-declare class StorageBackend extends StorageBackend_base<StorageService> {}
-//#endregion
-export { StorageBackend as a, StoredObject as c, Storage as i, ObjectNotFound as n, StorageService as o, PresignNotSupported as r, StorageUnavailable as s, ObjectExists as t };

package/dist/storage-uSBWFyB2.d.mts

@@ -1,92 +0,0 @@
-import { AsyncResult } from "unthrown";
-//#region src/storage.d.ts
-/** One stored object: its bytes and what they are. */
-type StoredObject = {
-  readonly bytes: Uint8Array;
-  readonly contentType: string;
-};
-declare const ObjectNotFound_base: import("unthrown").TaggedErrorConstructor<"ObjectNotFound">;
-/** The key is not there. Only `get` answers it — see `delete` and `presignedUrl` below. */
-declare class ObjectNotFound extends ObjectNotFound_base<{
-  readonly key: string;
-}> {}
-declare const ObjectExists_base: import("unthrown").TaggedErrorConstructor<"ObjectExists">;
-/** An object already holds the key. Only `putIfAbsent` answers it. */
-declare class ObjectExists extends ObjectExists_base<{
-  readonly key: string;
-}> {}
-declare const StorageUnavailable_base: import("unthrown").TaggedErrorConstructor<"StorageUnavailable">;
-/** The store could not answer — the endpoint is down, the credentials were refused, the bucket is gone. */
-declare class StorageUnavailable extends StorageUnavailable_base<{
-  readonly operation: "put" | "putIfAbsent" | "get" | "delete" | "presignedUrl" | "presignedUpload";
-  readonly key: string;
-  readonly reason: string;
-}> {}
-declare const PresignNotSupported_base: import("unthrown").TaggedErrorConstructor<"PresignNotSupported">;
-/** The adapter cannot mint a time-limited URL, and says so rather than pretending. */
-declare class PresignNotSupported extends PresignNotSupported_base<{
-  readonly key: string;
-}> {}
-type StorageService = {
-  readonly put: (key: string, bytes: Uint8Array, options: {
-    readonly contentType: string;
-  }) => AsyncResult<void, StorageUnavailable>;
-  /** Writes the object only if no object holds the key: the first writer wins, atomically, in the store. */
-  readonly putIfAbsent: (key: string, bytes: Uint8Array, options: {
-    readonly contentType: string;
-  }) => AsyncResult<void, ObjectExists | StorageUnavailable>;
-  readonly get: (key: string) => AsyncResult<StoredObject, ObjectNotFound | StorageUnavailable>;
-  /** Deleting a key nobody stored is `Ok`: delete is idempotent, which is S3's own behaviour rather than a fiction over it. */
-  readonly delete: (key: string) => AsyncResult<void, StorageUnavailable>;
-  /**
-   * A URL that reads the object for `ttlMs`, without the caller holding
-   * credentials.
-   *
-   * There is **no `ObjectNotFound` arm**: presigning is a signature computation
-   * that asks the store nothing, so a URL for an absent key is minted happily
-   * and 404s when followed. Checking would cost a HEAD per call.
-   */
-  readonly presignedUrl: (key: string, options: {
-    readonly ttlMs: number;
-  }) => AsyncResult<string, PresignNotSupported | StorageUnavailable>;
-  /**
-   * A URL that writes the object for `ttlMs`, without the caller holding
-   * credentials — so the bytes go from the client to the store and never
-   * through this process.
-   *
-   * **`contentType` and `contentLength` are signed, not advisory.** They are
-   * part of the signature, so a client sending different ones is refused by the
-   * store. The same URL can write the key repeatedly until expiry, replacing
-   * the previous object with different bytes of that size and type. Neither
-   * signed header proves the bytes. `contentLength` is required — an unsigned
-   * length would allow an unbounded single write, and there is no ceiling a
-   * presigned PUT can express other than the exact number.
-   *
-   * The application still decides every input: whether this caller may write
-   * this key, how long the URL lives, and what size it is willing to accept.
-   * The adapter computes a signature over that decision and nothing more.
-   */
-  readonly presignedUpload: (key: string, options: {
-    readonly ttlMs: number;
-    readonly contentType: string;
-    readonly contentLength: number;
-  }) => AsyncResult<string, PresignNotSupported | StorageUnavailable>;
-};
-declare const Storage_base: import("@btravstack/di").PortClass<"Storage">;
-/**
- * The port an application depends on.
- *
- * Keys are plain strings the caller composes, tenant included: a store is an
- * application service, and the framework has no concept of a tenant to put in a
- * slot.
- *
- * **Bytes, not streams.** An object here is a document. Streaming would change
- * every signature, adapter and test to serve a case that wants a different
- * design anyway — a stated non-goal, not an oversight.
- */
-declare class Storage extends Storage_base<StorageService> {}
-declare const StorageBackend_base: import("@btravstack/di").PortClass<"StorageBackend">;
-/** The port every adapter provides, and the one an application never depends on. */
-declare class StorageBackend extends StorageBackend_base<StorageService> {}
-//#endregion
-export { StorageBackend as a, StoredObject as c, Storage as i, ObjectNotFound as n, StorageService as o, PresignNotSupported as r, StorageUnavailable as s, ObjectExists as t };