@effect-pantry/storage 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 effect-pantry contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,223 @@
+# @effect-pantry/storage
+
+> [!WARNING]
+> **Early-stage package** — APIs may change without notice. Not recommended for production use yet. Feedback and contributions welcome!
+
+**Effect-native object storage** — wraps [files-sdk](https://files-sdk.dev) as typed Effect functions. Swap backends by swapping adapters — the API stays the same.
+
+## Installation
+
+```bash
+npm install @effect-pantry/storage effect
+```
+
+> **`files-sdk` is a peer dependency.** Install your own version and choose which adapters to bring in (e.g., `files-sdk/s3`, `files-sdk/memory`). Targets **Effect v3** and **files-sdk ^1.6.0**.
+
+## Quick Start
+
+```ts
+import { memory } from "files-sdk/memory"
+import { Storage, StorageAdapter } from "@effect-pantry/storage"
+import { Effect, Layer } from "effect"
+
+const layer = Storage.layer().pipe(
+  Layer.provide(Layer.succeed(StorageAdapter, memory())),
+)
+
+const program = Effect.gen(function* () {
+  const s = yield* Storage.Storage
+
+  // Upload
+  const { result } = yield* s.upload("data.json", JSON.stringify({ hello: "world" }))
+  yield* result;
+
+  // Download
+  const file = yield* s.download("data.json")
+  const text = yield* file.text()
+
+  return text
+})
+
+Effect.runPromise(Effect.provide(program, layer))
+```
+
+## API Reference
+
+### `Storage.Storage` (Context.Tag)
+
+The service tag. Inject with `yield* Storage.Storage`.
+
+### `StorageAdapter` (Context.Tag)
+
+Provide any `files-sdk` adapter:
+
+```ts
+import { s3 } from "files-sdk/s3"
+
+Layer.succeed(StorageAdapter, s3({
+  bucket: "my-bucket",
+  region: "us-east-1",
+}))
+```
+
+### `Storage.layer`
+
+Creates a layer that requires `StorageAdapter` and provides `Storage.Storage`.
+Accepts optional {@link MakeOptions} (e.g. `prefix`, `timeout`, `retries`).
+
+```ts
+const layer = Storage.layer().pipe(
+  Layer.provide(Layer.succeed(StorageAdapter, memory())),
+)
+
+// With options
+const layerWithPrefix = Storage.layer({ prefix: "app-data/" }).pipe(
+  Layer.provide(Layer.succeed(StorageAdapter, memory())),
+)
+```
+
+### `Storage.make`
+
+Creates a `Storage` service. Reads the adapter from context.
+Accepts optional {@link MakeOptions} forwarded to the underlying
+`FilesSDK.Files` constructor.
+
+```ts
+const s = yield* Storage.make()
+```
+
+With options:
+
+```ts
+const s = yield* Storage.make({ prefix: "uploads/", timeout: 30_000 })
+```
+
+Or inline:
+
+```ts
+const s = yield* Storage.make().pipe(
+  Effect.provideService(StorageAdapter, memory()),
+)
+```
+
+### Methods
+
+| Method | Signature | Returns |
+|--------|-----------|---------|
+| `upload(key, body, opts?)` | `Effect<{ result, progress }, never>` | Returns `{ result: Effect<UploadResult, StorageError>, progress: Stream<UploadProgress> }`. Consume progress concurrently, then `yield*` the result. |
+| `download(key, opts?)` | `Effect<StoredFile, StorageError>` | File with lazy body accessors |
+| `head(key, opts?)` | `Effect<StoredFile, StorageError>` | Metadata without the body |
+| `exists(key, opts?)` | `Effect<boolean, StorageError>` | Existence check |
+| `delete(key, opts?)` | `Effect<void, StorageError>` | Permanent removal |
+| `copy(from, to, opts?)` | `Effect<void, StorageError>` | Server-side copy |
+| `move(from, to, opts?)` | `Effect<void, StorageError>` | Rename / relocate |
+| `list(opts?)` | `Effect<ListResult, StorageError>` | Cursor-paginated listing |
+| `url(key, opts?)` | `Effect<string, StorageError>` | Public or signed download URL |
+| `file(key)` | `FileHandle` | Key-bound handle for ergonomic single-key ops |
+| `signedUploadUrl(key, opts)` | `Effect<SignedUpload, StorageError>` | Presigned upload URL |
+| `hookStream(name)` | `Stream<HookEventMap[N]>` | Observable hook events |
+
+### `FileHandle`
+
+A key-bound storage handle. Every method operates on a pre-bound key.
+
+```ts
+const avatar = s.file("avatars/abc.png")
+
+// Upload
+yield* avatar.upload(body, { contentType: "image/png" })
+
+// Check existence
+if (yield* avatar.exists()) {
+  const meta = yield* avatar.head()
+}
+
+// Copy / move
+yield* avatar.copyTo("avatars/abc.bak.png")
+yield* avatar.copyFrom("legacy/abc.png")
+```
+
+| Method | Equivalent |
+|--------|-----------|
+| `upload(body, opts?)` | `s.upload(key, body, opts?)` |
+| `download(opts?)` | `s.download(key, opts?)` |
+| `head(opts?)` | `s.head(key, opts?)` |
+| `exists(opts?)` | `s.exists(key, opts?)` |
+| `delete(opts?)` | `s.delete(key, opts?)` |
+| `url(opts?)` | `s.url(key, opts?)` |
+| `signedUploadUrl(opts)` | `s.signedUploadUrl(key, opts)` |
+| `copyTo(destKey, opts?)` | `s.copy(key, destKey, opts?)` |
+| `copyFrom(srcKey, opts?)` | `s.copy(srcKey, key, opts?)` |
+
+### Errors
+
+All methods return typed, tagged errors:
+
+| Error | Code | When |
+|-------|------|------|
+| `StorageNotFoundError` | `NotFound` | Key, bucket, or container missing |
+| `StorageUnauthorizedError` | `Unauthorized` | Credentials missing, expired, or insufficient |
+| `StorageConflictError` | `Conflict` | Precondition failed |
+| `StorageProviderError` | `Provider` | Network, throttling, 5xx, timeout, cancellation |
+
+```ts
+import { StorageNotFoundError, StorageUnauthorizedError } from "@effect-pantry/storage"
+
+yield* s.download("missing.txt").pipe(
+  Effect.catchTags({
+    StorageNotFoundError: (e) => Effect.succeed(null),
+    StorageUnauthorizedError: (e) => Effect.fail(new Error("Check credentials")),
+    StorageConflictError: (e) => Effect.fail(e),
+    StorageProviderError: (e) => Effect.fail(e),
+  }),
+)
+```
+
+> Use `toStorageError(error)` to manually map unknown errors into typed `StorageError` values when working outside the `Storage` service.
+
+### Hooks
+
+Observe SDK events as Effect streams:
+
+```ts
+const s = yield* Storage.Storage
+
+yield* s.hookStream("onAction").pipe(
+  Stream.runForEach((e) => Effect.log(`[${e.status}] ${e.type} ${e.key}`)),
+  Effect.forkScoped,
+)
+
+yield* s.hookStream("onError").pipe(
+  Stream.runForEach((e) => Effect.log(`[${e.error.code}] ${e.key}`)),
+  Effect.forkScoped,
+)
+```
+
+### `transfer(source, dest, opts?)`
+
+Cross-provider migration using `FilesSDK.Files` instances. → [Full example](./examples/04-cross-provider-transfer.ts)
+
+```ts
+import { transfer } from "@effect-pantry/storage"
+import * as FilesSDK from "files-sdk"
+import { s3 } from "files-sdk/s3"
+import { r2 } from "files-sdk/r2"
+
+const from = new FilesSDK.Files({ adapter: s3({ bucket: "old", region: "us-east-1" }) })
+const to   = new FilesSDK.Files({ adapter: r2({ bucket: "new", accountId: "..." }) })
+
+const { result, progress } = yield* transfer(from, to, { prefix: "uploads/" })
+const { transferred, skipped, errors } = yield* result
+```
+
+## Examples
+
+- [Basic usage](./examples/01-basic-usage.ts) — Full CRUD with the memory adapter
+- [S3 adapter](./examples/02-s3-adapter.ts) — Real S3/R2 configuration patterns
+- [Hooks & monitoring](./examples/03-hooks-and-monitoring.ts) — Logging, metrics, alerting
+- [Cross-provider transfer](./examples/04-cross-provider-transfer.ts) — S3 → R2 migration with progress
+- [Streams & progress](./examples/05-streams-and-progress.ts) — Upload/download progress, cancellation
+
+## License
+
+MIT

package/dist/adapter.d.ts

@@ -0,0 +1,13 @@
+import * as FilesSDK from 'files-sdk';
+import { Context } from 'effect';
+declare const StorageAdapter_base: Context.TagClass<StorageAdapter, "@effect-pantry/storage/Adapter", FilesSDK.Adapter<unknown>>;
+/**
+ * The `files-sdk` {@link FilesSDK.Adapter} powering the {@link Storage} service.
+ *
+ * Provide via `Layer.succeed(StorageAdapter, myAdapter)` to plug any of
+ * the 40+ adapters (memory, fs, S3, R2, Vercel Blob, …) into the service.
+ */
+export declare class StorageAdapter extends StorageAdapter_base {
+}
+export {};
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;;AAEjC;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,mBAGjC;CAAG"}

package/dist/adapter.js

@@ -0,0 +1,10 @@
+import { Context } from 'effect';
+/**
+ * The `files-sdk` {@link FilesSDK.Adapter} powering the {@link Storage} service.
+ *
+ * Provide via `Layer.succeed(StorageAdapter, myAdapter)` to plug any of
+ * the 40+ adapters (memory, fs, S3, R2, Vercel Blob, …) into the service.
+ */
+export class StorageAdapter extends Context.Tag('@effect-pantry/storage/Adapter')() {
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,OAAO,cAAe,SAAQ,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,EAG9E;CAAG"}

package/dist/errors.d.ts

@@ -0,0 +1,62 @@
+declare const StorageNotFoundError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "StorageNotFoundError";
+} & Readonly<A>;
+/**
+ * The requested key, bucket, or container does not exist.
+ *
+ * @param cause - The original underlying error from the storage provider.
+ */
+export declare class StorageNotFoundError extends StorageNotFoundError_base<{
+    readonly message: string;
+    readonly cause: unknown;
+}> {
+}
+declare const StorageUnauthorizedError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "StorageUnauthorizedError";
+} & Readonly<A>;
+/**
+ * Credentials are missing, expired, or have insufficient permissions.
+ *
+ * @param cause - The original underlying error from the storage provider.
+ */
+export declare class StorageUnauthorizedError extends StorageUnauthorizedError_base<{
+    readonly message: string;
+    readonly cause: unknown;
+}> {
+}
+declare const StorageConflictError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "StorageConflictError";
+} & Readonly<A>;
+/**
+ * A precondition failed (e.g. a conditional write lost a race).
+ *
+ * @param cause - The original underlying error from the storage provider.
+ */
+export declare class StorageConflictError extends StorageConflictError_base<{
+    readonly message: string;
+    readonly cause: unknown;
+}> {
+}
+declare const StorageProviderError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "StorageProviderError";
+} & Readonly<A>;
+/**
+ * A provider-level failure: network, throttling, 5xx, timeout, or cancellation.
+ *
+ * @param cause - The original underlying error from the storage provider.
+ */
+export declare class StorageProviderError extends StorageProviderError_base<{
+    readonly message: string;
+    readonly cause: unknown;
+    readonly aborted: boolean;
+}> {
+}
+export type StorageError = StorageNotFoundError | StorageUnauthorizedError | StorageConflictError | StorageProviderError;
+/**
+ * Map an unknown error (ideally an SDK `FilesError`) to a tagged Effect error.
+ *
+ * Fallback: unknown errors become `StorageProviderError` with `aborted: false`.
+ */
+export declare const toStorageError: (error: unknown) => StorageError;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAGA;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,0BAAyC;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG;;;;AAEL;;;;GAIG;AACH,qBAAa,wBAAyB,SAAQ,8BAA6C;IACzF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG;;;;AAEL;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,0BAAyC;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG;;;;AAEL;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,0BAAyC;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;CAAG;AAEL,MAAM,MAAM,YAAY,GACpB,oBAAoB,GACpB,wBAAwB,GACxB,oBAAoB,GACpB,oBAAoB,CAAC;AAEzB;;;;GAIG;AACH,eAAO,MAAM,cAAc,UAAW,OAAO,KAAG,YAuB/C,CAAC"}

package/dist/errors.js

@@ -0,0 +1,60 @@
+import { Data } from 'effect';
+import * as FilesSDK from 'files-sdk';
+/**
+ * The requested key, bucket, or container does not exist.
+ *
+ * @param cause - The original underlying error from the storage provider.
+ */
+export class StorageNotFoundError extends Data.TaggedError('StorageNotFoundError') {
+}
+/**
+ * Credentials are missing, expired, or have insufficient permissions.
+ *
+ * @param cause - The original underlying error from the storage provider.
+ */
+export class StorageUnauthorizedError extends Data.TaggedError('StorageUnauthorizedError') {
+}
+/**
+ * A precondition failed (e.g. a conditional write lost a race).
+ *
+ * @param cause - The original underlying error from the storage provider.
+ */
+export class StorageConflictError extends Data.TaggedError('StorageConflictError') {
+}
+/**
+ * A provider-level failure: network, throttling, 5xx, timeout, or cancellation.
+ *
+ * @param cause - The original underlying error from the storage provider.
+ */
+export class StorageProviderError extends Data.TaggedError('StorageProviderError') {
+}
+/**
+ * Map an unknown error (ideally an SDK `FilesError`) to a tagged Effect error.
+ *
+ * Fallback: unknown errors become `StorageProviderError` with `aborted: false`.
+ */
+export const toStorageError = (error) => {
+    if (error instanceof FilesSDK.FilesError) {
+        const message = error.message;
+        const cause = error.cause;
+        switch (error.code) {
+            case 'NotFound':
+                return new StorageNotFoundError({ message, cause });
+            case 'Unauthorized':
+                return new StorageUnauthorizedError({ message, cause });
+            case 'Conflict':
+                return new StorageConflictError({ message, cause });
+            default:
+                // files-sdk v1.6 has exactly four codes ("NotFound", "Unauthorized",
+                // "Conflict", "Provider"). If this branch triggers, the SDK added a new
+                // error code — file an issue to add a dedicated tagged error.
+                return new StorageProviderError({ message, cause, aborted: error.aborted });
+        }
+    }
+    return new StorageProviderError({
+        message: error instanceof Error ? error.message : String(error),
+        cause: error,
+        aborted: false,
+    });
+};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,KAAK,QAAQ,MAAM,WAAW,CAAC;AAEtC;;;;GAIG;AACH,MAAM,OAAO,oBAAqB,SAAQ,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAG/E;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,wBAAyB,SAAQ,IAAI,CAAC,WAAW,CAAC,0BAA0B,CAGvF;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,oBAAqB,SAAQ,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAG/E;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,oBAAqB,SAAQ,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAI/E;CAAG;AAQL;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAc,EAAgB,EAAE;IAC7D,IAAI,KAAK,YAAY,QAAQ,CAAC,UAAU,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC1B,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,UAAU;gBACb,OAAO,IAAI,oBAAoB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACtD,KAAK,cAAc;gBACjB,OAAO,IAAI,wBAAwB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1D,KAAK,UAAU;gBACb,OAAO,IAAI,oBAAoB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACtD;gBACE,qEAAqE;gBACrE,wEAAwE;gBACxE,8DAA8D;gBAC9D,OAAO,IAAI,oBAAoB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IACD,OAAO,IAAI,oBAAoB,CAAC;QAC9B,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/D,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/features/transfer.d.ts

@@ -0,0 +1,50 @@
+import * as FilesSDK from 'files-sdk';
+/** Options for {@link transfer}, with `signal` and `onProgress` managed internally. */
+export type TransferOptions = Omit<FilesSDK.TransferOptions, 'signal' | 'onProgress'>;
+/**
+ * Cross-provider migration: walks every object the `source` exposes and
+ * streams each one straight to `dest`, whatever the backends are.
+ *
+ * Returns an `{ result, progress }` pair where `result` is a **deferred
+ * Effect** — the transfer does not start until you `yield*` it, and
+ * `progress` is a {@link Stream} of {@link FilesSDK.TransferProgress}
+ * events emitted while the transfer runs. Consume the stream concurrently
+ * with the result:
+ *
+ * @example
+ * ```ts
+ * import { s3 } from "files-sdk/s3";
+ * import { r2 } from "files-sdk/r2";
+ * import * as FilesSDK from "files-sdk";
+ * import { transfer } from "@effect-pantry/storage";
+ *
+ * const from = new FilesSDK.Files({ adapter: s3({ bucket: "old" }) });
+ * const to   = new FilesSDK.Files({ adapter: r2({ bucket: "new", ... }) });
+ *
+ * // With progress — fork the stream consumer before awaiting the result
+ * const { result, progress } = yield* transfer(from, to, { prefix: "uploads/" });
+ * yield* Stream.runForEach(progress, (p) =>
+ *   Effect.log(`${p.status} ${p.key} (${p.done}/${p.total})`)
+ * ).pipe(Effect.forkScoped);
+ * const { transferred, skipped, errors } = yield* result;
+ *
+ * // Without progress — just yield the result
+ * const { transferred, skipped, errors } = yield* transfer(from, to).pipe(
+ *   Effect.flatMap(({ result }) => result)
+ * );
+ * ```
+ *
+ * Both arguments are full {@link FilesSDK.Files} instances, not raw
+ * adapters, so each leg honors its own `prefix`, retries, timeouts, and
+ * hooks.
+ *
+ * @returns An {@link Effect} resolving to `{ result, progress }` where
+ *   `result` is a deferred effect that yields a
+ *   {@link FilesSDK.TransferResult} when executed, and `progress` is a
+ *   stream of {@link FilesSDK.TransferProgress} events.
+ */
+export declare const transfer: (source: FilesSDK.Files, dest: FilesSDK.Files, opts?: TransferOptions) => import("effect/Effect").Effect<{
+    result: import("effect/Effect").Effect<FilesSDK.TransferResult, import("../errors.ts").StorageError, never>;
+    progress: import("effect/Stream").Stream<FilesSDK.TransferProgress, never, never>;
+}, never, never>;
+//# sourceMappingURL=transfer.d.ts.map

package/dist/features/transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../src/features/transfer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,WAAW,CAAC;AAGtC,uFAAuF;AACvF,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,QAAQ,GAAG,YAAY,CAAC,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,QAAQ,WAAY,QAAQ,CAAC,KAAK,QAAQ,QAAQ,CAAC,KAAK,SAAS,eAAe;;;gBAG1F,CAAC"}

package/dist/features/transfer.js

@@ -0,0 +1,46 @@
+import * as FilesSDK from 'files-sdk';
+import { bridgeProgress } from '../internal.js';
+/**
+ * Cross-provider migration: walks every object the `source` exposes and
+ * streams each one straight to `dest`, whatever the backends are.
+ *
+ * Returns an `{ result, progress }` pair where `result` is a **deferred
+ * Effect** — the transfer does not start until you `yield*` it, and
+ * `progress` is a {@link Stream} of {@link FilesSDK.TransferProgress}
+ * events emitted while the transfer runs. Consume the stream concurrently
+ * with the result:
+ *
+ * @example
+ * ```ts
+ * import { s3 } from "files-sdk/s3";
+ * import { r2 } from "files-sdk/r2";
+ * import * as FilesSDK from "files-sdk";
+ * import { transfer } from "@effect-pantry/storage";
+ *
+ * const from = new FilesSDK.Files({ adapter: s3({ bucket: "old" }) });
+ * const to   = new FilesSDK.Files({ adapter: r2({ bucket: "new", ... }) });
+ *
+ * // With progress — fork the stream consumer before awaiting the result
+ * const { result, progress } = yield* transfer(from, to, { prefix: "uploads/" });
+ * yield* Stream.runForEach(progress, (p) =>
+ *   Effect.log(`${p.status} ${p.key} (${p.done}/${p.total})`)
+ * ).pipe(Effect.forkScoped);
+ * const { transferred, skipped, errors } = yield* result;
+ *
+ * // Without progress — just yield the result
+ * const { transferred, skipped, errors } = yield* transfer(from, to).pipe(
+ *   Effect.flatMap(({ result }) => result)
+ * );
+ * ```
+ *
+ * Both arguments are full {@link FilesSDK.Files} instances, not raw
+ * adapters, so each leg honors its own `prefix`, retries, timeouts, and
+ * hooks.
+ *
+ * @returns An {@link Effect} resolving to `{ result, progress }` where
+ *   `result` is a deferred effect that yields a
+ *   {@link FilesSDK.TransferResult} when executed, and `progress` is a
+ *   stream of {@link FilesSDK.TransferProgress} events.
+ */
+export const transfer = (source, dest, opts) => bridgeProgress((signal, onProgress) => FilesSDK.transfer(source, dest, { ...opts, signal, onProgress }));
+//# sourceMappingURL=transfer.js.map

package/dist/features/transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.js","sourceRoot":"","sources":["../../src/features/transfer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAKhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,MAAsB,EAAE,IAAoB,EAAE,IAAsB,EAAE,EAAE,CAC/F,cAAc,CAAqD,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,CACxF,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CACjE,CAAC"}

package/dist/hooks.d.ts

@@ -0,0 +1,26 @@
+import type { FilesActionEvent, FilesErrorEvent, FilesRetryEvent } from 'files-sdk';
+/**
+ * Discriminated union of every hook event emitted through the PubSub.
+ *
+ * Use {@link Storage.hookStream} to subscribe to a single kind of event;
+ * the stream filters on `_tag` automatically.
+ */
+export type HookEvent = {
+    readonly _tag: 'onAction';
+    readonly event: FilesActionEvent;
+} | {
+    readonly _tag: 'onError';
+    readonly event: FilesErrorEvent;
+} | {
+    readonly _tag: 'onRetry';
+    readonly event: FilesRetryEvent;
+};
+/** Maps each constructor hook name to its event payload type. */
+export interface HookEventMap {
+    readonly onAction: FilesActionEvent;
+    readonly onError: FilesErrorEvent;
+    readonly onRetry: FilesRetryEvent;
+}
+/** The three constructor hook names supported by files-sdk. */
+export type HookName = keyof HookEventMap;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GAC/D;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GAC7D;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAC;AAElE,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;CACnC;AAED,+DAA+D;AAC/D,MAAM,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC"}

package/dist/hooks.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @effect-pantry/storage — Effect-native storage wrapping files-sdk.
+ *
+ * Provides a {@link Storage} context tag backed by any files-sdk adapter
+ * (memory, fs, S3, R2, Vercel Blob, and 35+ more), with typed errors and
+ * automatic cancellation bridging.
+ *
+ * **⚠️ Early-stage package** — APIs may change without notice.
+ * Not recommended for production use yet.
+ *
+ * @module
+ */
+export * as Storage from './service.js';
+export * as StorageAdapter from './adapter.js';
+export type { FileHandle, MakeOptions, UploadOptions } from './service-types.js';
+export { transfer } from './features/transfer.js';
+export type { TransferOptions } from './features/transfer.js';
+export { StorageNotFoundError, StorageUnauthorizedError, StorageConflictError, StorageProviderError, toStorageError, } from './errors.js';
+export type { StorageError } from './errors.js';
+export type { HookEvent, HookEventMap, HookName } from './hooks.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,cAAc,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @effect-pantry/storage — Effect-native storage wrapping files-sdk.
+ *
+ * Provides a {@link Storage} context tag backed by any files-sdk adapter
+ * (memory, fs, S3, R2, Vercel Blob, and 35+ more), with typed errors and
+ * automatic cancellation bridging.
+ *
+ * **⚠️ Early-stage package** — APIs may change without notice.
+ * Not recommended for production use yet.
+ *
+ * @module
+ */
+export * as Storage from './service.js';
+export * as StorageAdapter from './adapter.js';
+export { transfer } from './features/transfer.js';
+export { StorageNotFoundError, StorageUnauthorizedError, StorageConflictError, StorageProviderError, toStorageError, } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,cAAc,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGlD,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/internal.d.ts

@@ -0,0 +1,32 @@
+import { Effect, Stream } from 'effect';
+import { type StorageError } from './errors.js';
+/** @internal */
+export declare const wrapSDKCall: <A>(fn: (signal: AbortSignal) => Promise<A>) => Effect.Effect<A, StorageError, never>;
+/** @internal
+ *
+ * Bridges a callback-style progress operation to an Effect returning both
+ * a deferred result and a progress {@link Stream}. The caller consumes
+ * the stream concurrently with the result — e.g. fork the stream consumer
+ * then `yield*` the result.
+ *
+ * Progress callbacks are pushed synchronously via {@link Queue.unsafeOffer}
+ * so no extra fibers are spawned per callback. The queue is shut down when
+ * the result effect completes, fails, or is interrupted (via `ensuring`).
+ *
+ * @example
+ * ```ts
+ * const { result, progress } = yield* bridgeProgress((signal, onProgress) =>
+ *   sdk.upload(key, body, { signal, onProgress })
+ * );
+ *
+ * // Fork progress consumption
+ * yield* Stream.runForEach(progress, (p) => Effect.log(p)).pipe(Effect.forkScoped);
+ * // Await result
+ * const uploadResult = yield* result;
+ * ```
+ */
+export declare const bridgeProgress: <A, P>(fn: (signal: AbortSignal, onProgress: (progress: P) => void) => Promise<A>) => Effect.Effect<{
+    result: Effect.Effect<A, StorageError>;
+    progress: Stream.Stream<P>;
+}, never>;
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAS,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhE,gBAAgB;AAChB,eAAO,MAAM,WAAW,GAAI,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,0CACf,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,CAAC,MAC7B,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KACzE,MAAM,CAAC,MAAM,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;CAAE,EAAE,KAAK,CAa1F,CAAC"}

package/dist/internal.js

@@ -0,0 +1,38 @@
+import { Effect, Queue, Stream } from 'effect';
+import { toStorageError } from './errors.js';
+/** @internal */
+export const wrapSDKCall = (fn) => Effect.tryPromise({ try: fn, catch: toStorageError });
+/** @internal
+ *
+ * Bridges a callback-style progress operation to an Effect returning both
+ * a deferred result and a progress {@link Stream}. The caller consumes
+ * the stream concurrently with the result — e.g. fork the stream consumer
+ * then `yield*` the result.
+ *
+ * Progress callbacks are pushed synchronously via {@link Queue.unsafeOffer}
+ * so no extra fibers are spawned per callback. The queue is shut down when
+ * the result effect completes, fails, or is interrupted (via `ensuring`).
+ *
+ * @example
+ * ```ts
+ * const { result, progress } = yield* bridgeProgress((signal, onProgress) =>
+ *   sdk.upload(key, body, { signal, onProgress })
+ * );
+ *
+ * // Fork progress consumption
+ * yield* Stream.runForEach(progress, (p) => Effect.log(p)).pipe(Effect.forkScoped);
+ * // Await result
+ * const uploadResult = yield* result;
+ * ```
+ */
+export const bridgeProgress = (fn) => Effect.gen(function* () {
+    const queue = yield* Queue.unbounded();
+    const result = Effect.tryPromise({
+        try: (signal) => fn(signal, (progress) => {
+            queue.unsafeOffer(progress);
+        }),
+        catch: toStorageError,
+    }).pipe(Effect.ensuring(queue.shutdown));
+    return { result, progress: Stream.fromQueue(queue) };
+});
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAqB,MAAM,aAAa,CAAC;AAEhE,gBAAgB;AAChB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAI,EAAuC,EAAE,EAAE,CACxE,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,EAA0E,EACoB,EAAE,CAChG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,SAAS,EAAK,CAAC;IAE1C,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC;QAC/B,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CACd,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;YACtB,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC,CAAC;QACJ,KAAK,EAAE,cAAc;KACtB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEzC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;AACvD,CAAC,CAAC,CAAC"}

package/dist/service-types.d.ts

@@ -0,0 +1,156 @@
+import * as FilesSDK from 'files-sdk';
+import { Effect, Stream } from 'effect';
+import type { StorageError } from './errors.js';
+import type { HookEventMap, HookName } from './hooks.js';
+/** Options for {@link Storage.upload}, with `signal` and `onProgress` managed internally. */
+export type UploadOptions = Omit<FilesSDK.UploadOptions, 'signal' | 'onProgress'>;
+/**
+ * A key-bound handle to a single storage object.
+ *
+ * Returned by {@link StorageInterface.file} — every method operates on the
+ * pre-bound key so callers don't need to pass it on each call. Key
+ * validation happens eagerly at construction; all I/O defers to the
+ * underlying {@link StorageInterface} methods.
+ *
+ * @example
+ * ```ts
+ * const avatar = svc.file("avatars/abc.png");
+ * yield* avatar.upload(body, { contentType: "image/png" });
+ * if (yield* avatar.exists()) {
+ *   const meta = yield* avatar.head();
+ * }
+ * ```
+ */
+export interface FileHandle {
+    /** The key this handle is bound to. */
+    readonly key: string;
+    readonly upload: (body: FilesSDK.Body, opts?: UploadOptions) => Effect.Effect<{
+        result: Effect.Effect<FilesSDK.UploadResult, StorageError>;
+        progress: Stream.Stream<FilesSDK.UploadProgress>;
+    }, never>;
+    readonly download: (opts?: FilesSDK.DownloadOptions) => Effect.Effect<FilesSDK.StoredFile, StorageError>;
+    readonly head: (opts?: FilesSDK.OperationOptions) => Effect.Effect<FilesSDK.StoredFile, StorageError>;
+    readonly exists: (opts?: FilesSDK.OperationOptions) => Effect.Effect<boolean, StorageError>;
+    readonly delete: (opts?: FilesSDK.OperationOptions) => Effect.Effect<void, StorageError>;
+    readonly url: (opts?: FilesSDK.UrlOptions) => Effect.Effect<string, StorageError>;
+    readonly signedUploadUrl: (opts: FilesSDK.SignUploadOptions) => Effect.Effect<FilesSDK.SignedUpload, StorageError>;
+    /**
+     * Copy the handle's object to a new key. The handle is the source.
+     * Shortcut for `Storage.copy(handle.key, destKey, opts)`.
+     */
+    readonly copyTo: (destKey: string, opts?: FilesSDK.OperationOptions) => Effect.Effect<void, StorageError>;
+    /**
+     * Copy from a source key into the handle's key. The handle is the destination.
+     * Shortcut for `Storage.copy(srcKey, handle.key, opts)`.
+     */
+    readonly copyFrom: (srcKey: string, opts?: FilesSDK.OperationOptions) => Effect.Effect<void, StorageError>;
+}
+/**
+ * Options passed to {@link Storage.make} to configure the underlying
+ * {@link FilesSDK.Files} instance.
+ *
+ * `adapter` and `hooks` are excluded — the adapter comes from the
+ * {@link StorageAdapter} context tag and hooks are wired internally to
+ * the PubSub event stream.
+ */
+export type MakeOptions = Omit<FilesSDK.FilesOptions<FilesSDK.Adapter>, 'adapter' | 'hooks'>;
+/**
+ * Type interface for the Storage service — separated from the
+ * implementation to keep each file focused and under the module-size
+ * guideline.
+ *
+ * The runtime {@link Context.Tag} lives in `service.ts` alongside
+ * {@link make} and {@link layer}.
+ */
+export interface StorageInterface {
+    readonly upload: (
+    /** Object key (path) to store the object at. */
+    key: string, 
+    /** Body content to upload (string, Buffer, ReadableStream, Blob, File, etc.). */
+    body: FilesSDK.Body, 
+    /** Optional upload configuration (contentType, multipart threshold, etc.). */
+    opts?: UploadOptions) => Effect.Effect<{
+        result: Effect.Effect<FilesSDK.UploadResult, StorageError>;
+        progress: Stream.Stream<FilesSDK.UploadProgress>;
+    }, never>;
+    readonly download: (
+    /** Object key (path) to retrieve. */
+    key: string, 
+    /** Optional download configuration (range, accept header, stream mode, etc.). */
+    opts?: FilesSDK.DownloadOptions) => Effect.Effect<FilesSDK.StoredFile, StorageError>;
+    readonly head: (
+    /** Object key (path) to inspect without downloading. */
+    key: string, opts?: FilesSDK.OperationOptions) => Effect.Effect<FilesSDK.StoredFile, StorageError>;
+    readonly exists: (
+    /** Object key (path) to check for existence. */
+    key: string, opts?: FilesSDK.OperationOptions) => Effect.Effect<boolean, StorageError>;
+    readonly delete: (
+    /** Object key (path) to permanently remove. */
+    key: string, opts?: FilesSDK.OperationOptions) => Effect.Effect<void, StorageError>;
+    readonly copy: (
+    /** Source key (path) to copy from. */
+    from: string, 
+    /** Destination key (path) to copy to. */
+    to: string, opts?: FilesSDK.OperationOptions) => Effect.Effect<void, StorageError>;
+    readonly move: (
+    /** Source key (path) to move from. */
+    from: string, 
+    /** Destination key (path) to move to. */
+    to: string, opts?: FilesSDK.OperationOptions) => Effect.Effect<void, StorageError>;
+    readonly list: (
+    /** Optional listing configuration (prefix, maxKeys, cursor, recursive, etc.). */
+    opts?: FilesSDK.ListOptions) => Effect.Effect<FilesSDK.ListResult, StorageError>;
+    readonly url: (
+    /** Object key (path) to generate a public/download URL for. */
+    key: string, 
+    /** Optional URL configuration (expiresIn, etc.). */
+    opts?: FilesSDK.UrlOptions) => Effect.Effect<string, StorageError>;
+    readonly signedUploadUrl: (
+    /** Object key (path) to generate a signed upload URL for. */
+    key: string, 
+    /** Required by the underlying SDK — `expiresIn` is always required;
+     *  `contentType` and `maxSize` may also be needed depending on the adapter. */
+    opts: FilesSDK.SignUploadOptions) => Effect.Effect<FilesSDK.SignedUpload, StorageError>;
+    /**
+     * Create a {@link FileHandle} bound to a single key.
+     *
+     * The key is validated eagerly — an empty key throws synchronously.
+     * Every method on the handle delegates to the corresponding
+     * {@link StorageInterface} method, so adapters implement nothing extra.
+     *
+     * @example
+     * ```ts
+     * const avatar = svc.file("avatars/abc.png");
+     * yield* avatar.upload(body, { contentType: "image/png" });
+     * yield* avatar.copyTo("avatars/abc.bak.png");
+     * ```
+     */
+    readonly file: (key: string) => FileHandle;
+    /**
+     * Subscribe to constructor hook events as an Effect {@link Stream}.
+     *
+     * Events are emitted from an unbounded internal {@link PubSub} — every
+     * storage operation pushes into it, and the stream filters to the chosen
+     * hook kind. Multiple consumers can subscribe independently; each gets
+     * its own subscription.
+     *
+     * The stream ends when the storage layer's scope is released.
+     *
+     * **Note:** The internal PubSub is unbounded. If consumers never drain
+     * the stream, memory grows without limit. Always run the stream consumer
+     * or cancel it before producing a large volume of events.
+     *
+     * @example
+     * ```ts
+     * const svc = yield* Storage;
+     *
+     * // Stream of FilesActionEvent
+     * yield* svc.hookStream("onAction").pipe(
+     *   Stream.runForEach((e) => Effect.log(`Storage ${e.type}: ${e.status}`)),
+     *   Effect.forkScoped,
+     * );
+     * ```
+     */
+    readonly hookStream: <N extends HookName>(name: N) => Stream.Stream<HookEventMap[N], never>;
+}
+//# sourceMappingURL=service-types.d.ts.map

package/dist/service-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-types.d.ts","sourceRoot":"","sources":["../src/service-types.ts"],"names":[],"mappings":"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"}

package/dist/service-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=service-types.js.map

package/dist/service-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-types.js","sourceRoot":"","sources":["../src/service-types.ts"],"names":[],"mappings":""}

package/dist/service.d.ts

@@ -0,0 +1,66 @@
+import { Context, Effect, Layer } from 'effect';
+import { StorageAdapter } from './adapter.js';
+import type { MakeOptions, StorageInterface } from './service-types.js';
+declare const Storage_base: Context.TagClass<Storage, "@effect-pantry/storage/Storage", StorageInterface>;
+/**
+ * Effect-native storage service wrapping a `files-sdk` {@link FilesSDK.Files} instance.
+ *
+ * Depends on {@link StorageAdapter} from the Effect context to create the underlying
+ * SDK client. Every method bridges the SDK's promise-based API to Effect,
+ * carrying typed errors via {@link StorageError} and automatically handling
+ * cancellation through Effect's interruption model.
+ *
+ * **Note:** Bulk operations (`uploadAll`, `downloadAll`, etc.) are not yet
+ * exposed on this service. Use {@link FilesSDK.Files} directly or combine
+ * individual calls with {@link Effect.all} for concurrent operations.
+ *
+ * Provide via {@link Storage.layer}.
+ */
+export declare class Storage extends Storage_base {
+}
+/**
+ * Create a {@link Storage} service from the adapter found in the Effect context.
+ *
+ * Accepts optional {@link MakeOptions} to configure the underlying
+ * {@link FilesSDK.Files} instance (e.g. `prefix`, `timeout`, `retries`).
+ * The `adapter` and `hooks` options are managed internally and cannot be
+ * overridden.
+ *
+ * @example
+ * ```ts
+ * const svc = yield* Storage.make();
+ * ```
+ *
+ * @example With options
+ * ```ts
+ * const svc = yield* Storage.make({ prefix: "uploads/", timeout: 30_000 });
+ * ```
+ */
+export declare const make: (options?: MakeOptions) => Effect.Effect<StorageInterface, never, StorageAdapter>;
+/**
+ * Create an {@link Effect.Layer} that requires {@link StorageAdapter} and provides
+ * {@link Storage}. The consumer supplies the adapter layer.
+ *
+ * Accepts optional {@link MakeOptions} forwarded to
+ * {@link make}.
+ *
+ * @example
+ * ```ts
+ * import { memory } from "files-sdk/memory";
+ * import { Storage, StorageAdapter } from "@effect-pantry/storage";
+ *
+ * const layer = Storage.layer().pipe(
+ *   Layer.provide(Layer.succeed(StorageAdapter, memory())),
+ * );
+ * ```
+ *
+ * @example With options
+ * ```ts
+ * const layer = Storage.layer({ prefix: "app-data/" }).pipe(
+ *   Layer.provide(Layer.succeed(StorageAdapter, memory())),
+ * );
+ * ```
+ */
+export declare const layer: (options?: MakeOptions) => Layer.Layer<Storage, never, StorageAdapter>;
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAwB,MAAM,QAAQ,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,KAAK,EAAc,WAAW,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;;AAEpF;;;;;;;;;;;;;GAaG;AACH,qBAAa,OAAQ,SAAQ,YAG1B;CAAG;AAEN;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,IAAI,aAAc,WAAW,2DAyEtC,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,KAAK,aAAc,WAAW,gDAAyC,CAAC"}

package/dist/service.js

@@ -0,0 +1,110 @@
+import * as FilesSDK from 'files-sdk';
+import { Context, Effect, Layer, pipe, PubSub, Stream } from 'effect';
+import { StorageAdapter } from './adapter.js';
+import { bridgeProgress, wrapSDKCall } from './internal.js';
+/**
+ * Effect-native storage service wrapping a `files-sdk` {@link FilesSDK.Files} instance.
+ *
+ * Depends on {@link StorageAdapter} from the Effect context to create the underlying
+ * SDK client. Every method bridges the SDK's promise-based API to Effect,
+ * carrying typed errors via {@link StorageError} and automatically handling
+ * cancellation through Effect's interruption model.
+ *
+ * **Note:** Bulk operations (`uploadAll`, `downloadAll`, etc.) are not yet
+ * exposed on this service. Use {@link FilesSDK.Files} directly or combine
+ * individual calls with {@link Effect.all} for concurrent operations.
+ *
+ * Provide via {@link Storage.layer}.
+ */
+export class Storage extends Context.Tag('@effect-pantry/storage/Storage')() {
+}
+/**
+ * Create a {@link Storage} service from the adapter found in the Effect context.
+ *
+ * Accepts optional {@link MakeOptions} to configure the underlying
+ * {@link FilesSDK.Files} instance (e.g. `prefix`, `timeout`, `retries`).
+ * The `adapter` and `hooks` options are managed internally and cannot be
+ * overridden.
+ *
+ * @example
+ * ```ts
+ * const svc = yield* Storage.make();
+ * ```
+ *
+ * @example With options
+ * ```ts
+ * const svc = yield* Storage.make({ prefix: "uploads/", timeout: 30_000 });
+ * ```
+ */
+export const make = (options) => Effect.gen(function* () {
+    yield* Effect.logWarning('@effect-pantry/storage is in early development — APIs may change. Not recommended for production yet.');
+    const adapter = yield* StorageAdapter;
+    const pubsub = yield* PubSub.unbounded();
+    const offer = (event) => {
+        const ok = pubsub.unsafeOffer(event);
+        if (!ok) {
+            console.warn('[Storage] hook event dropped: PubSub not accepting');
+        }
+    };
+    const files = new FilesSDK.Files({
+        ...options,
+        adapter,
+        hooks: {
+            onAction: (event) => offer({ _tag: 'onAction', event }),
+            onError: (event) => offer({ _tag: 'onError', event }),
+            onRetry: (event) => offer({ _tag: 'onRetry', event }),
+        },
+    });
+    const svc = {
+        upload: (key, body, opts) => bridgeProgress((signal, onProgress) => files.upload(key, body, { ...opts, signal, onProgress })),
+        download: (key, opts) => wrapSDKCall((signal) => files.download(key, { ...opts, signal })),
+        head: (key, opts) => wrapSDKCall((signal) => files.head(key, { ...opts, signal })),
+        exists: (key, opts) => wrapSDKCall((signal) => files.exists(key, { ...opts, signal })),
+        delete: (key, opts) => wrapSDKCall((signal) => files.delete(key, { ...opts, signal })),
+        copy: (from, to, opts) => wrapSDKCall((signal) => files.copy(from, to, { ...opts, signal })),
+        move: (from, to, opts) => wrapSDKCall((signal) => files.move(from, to, { ...opts, signal })),
+        list: (opts) => wrapSDKCall((signal) => files.list({ ...opts, signal })),
+        url: (key, opts) => wrapSDKCall((signal) => files.url(key, { ...opts, signal })),
+        signedUploadUrl: (key, opts) => wrapSDKCall((signal) => files.signedUploadUrl(key, { ...opts, signal })),
+        hookStream: (name) => pipe(Stream.fromPubSub(pubsub), Stream.filter((e) => e._tag === name), Stream.map((e) => e.event)),
+        file: (key) => ({
+            key,
+            upload: (body, opts) => svc.upload(key, body, opts),
+            download: (opts) => svc.download(key, opts),
+            head: (opts) => svc.head(key, opts),
+            exists: (opts) => svc.exists(key, opts),
+            delete: (opts) => svc.delete(key, opts),
+            url: (opts) => svc.url(key, opts),
+            signedUploadUrl: (opts) => svc.signedUploadUrl(key, opts),
+            copyTo: (destKey, opts) => svc.copy(key, destKey, opts),
+            copyFrom: (srcKey, opts) => svc.copy(srcKey, key, opts),
+        }),
+    };
+    return Storage.of(svc);
+});
+/**
+ * Create an {@link Effect.Layer} that requires {@link StorageAdapter} and provides
+ * {@link Storage}. The consumer supplies the adapter layer.
+ *
+ * Accepts optional {@link MakeOptions} forwarded to
+ * {@link make}.
+ *
+ * @example
+ * ```ts
+ * import { memory } from "files-sdk/memory";
+ * import { Storage, StorageAdapter } from "@effect-pantry/storage";
+ *
+ * const layer = Storage.layer().pipe(
+ *   Layer.provide(Layer.succeed(StorageAdapter, memory())),
+ * );
+ * ```
+ *
+ * @example With options
+ * ```ts
+ * const layer = Storage.layer({ prefix: "app-data/" }).pipe(
+ *   Layer.provide(Layer.succeed(StorageAdapter, memory())),
+ * );
+ * ```
+ */
+export const layer = (options) => Layer.effect(Storage, make(options));
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@effect-pantry/storage",
+  "version": "0.0.1",
+  "description": "Effect-native storage — wraps files-sdk as typed Effect functions with scope-managed lifecycle",
+  "keywords": [
+    "effect",
+    "file-storage",
+    "files-sdk",
+    "r2",
+    "s3"
+  ],
+  "homepage": "https://github.com/nipakke/effect-pantry/tree/main/packages/storage#readme",
+  "bugs": {
+    "url": "https://github.com/nipakke/effect-pantry/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nipakke/effect-pantry.git",
+    "directory": "packages/storage"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "effect": "^3.21.2"
+  },
+  "devDependencies": {
+    "@effect/vitest": "^0.29.0",
+    "@types/node": "^25.8.0",
+    "@typescript/native-preview": "7.0.0-dev.20260515.1",
+    "@vitest/ui": "0.1.21",
+    "rimraf": "^6.0.1",
+    "vite-plus": "^0.1.21",
+    "vitest": "^3.2.0",
+    "@tooling/tsconfig": "0.0.1"
+  },
+  "peerDependencies": {
+    "files-sdk": "^1.6.0"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "pnpm clean && tsgo",
+    "test": "vitest run",
+    "check": "vp check",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json"
+  }
+}