@effect-kit/storage 0.0.0-stage → 0.0.0

package/dist/filesystem.js

@@ -0,0 +1,75 @@
+import { Storage } from "./core/storage.js";
+import { TransferDriver } from "./transfers/dependencies.js";
+import { syncDirectory } from "./runtime/filesystem.js";
+import { fileError, makeLayout, mapIO } from "./providers/filesystem/layout.js";
+import { list } from "./providers/filesystem/list.js";
+import { get, head, put } from "./providers/filesystem/operations.js";
+import { Context, Effect, Layer } from "effect";
+
+// src/providers/filesystem/index.ts
+var FilesystemStorage = class FilesystemStorage extends Context.Service()("@effect-kit/storage/FilesystemStorage") {
+	static make = Effect.fnUntraced(function* (options) {
+		const context = yield* makeLayout(options).pipe(Effect.mapError((error) => error._tag === "PlatformError" ? mapIO("make")(error) : error));
+		const { fs } = context;
+		return {
+			...Storage.make({
+				provider: "filesystem",
+				storeId: context.storeId,
+				capabilities: {
+					putConditions: ["create-only"],
+					getConditions: ["if-match", "if-none-match"],
+					deleteConditions: [],
+					ranges: [
+						"bounded",
+						"from",
+						"suffix"
+					],
+					versionedReads: "none",
+					list: {
+						maxPageSize: 1e3,
+						delimiter: true,
+						cursorPersistence: "provider",
+						snapshot: false
+					}
+				},
+				put: (request) => put(context, request),
+				get: (request) => get(context, request),
+				head: (request) => head(context, request),
+				delete: Effect.fnUntraced(function* (request) {
+					yield* context.checkDirectories;
+					const key = "ref" in request ? request.ref.key : request.key;
+					const filename = yield* context.filename(key);
+					yield* context.regularFile(filename).pipe(Effect.catchReason("PlatformError", "NotFound", () => Effect.void), Effect.mapError((error) => error._tag === "PlatformError" ? mapIO("delete", "not-started")(error) : error));
+					yield* fs.remove(filename, { force: true }).pipe(Effect.andThen(syncDirectory(fs, context.objects)), Effect.uninterruptible, Effect.mapError(mapIO("delete", "unknown")));
+				}),
+				listPage: (request) => list(context, request)
+			}),
+			reclaimStaging: Effect.fnUntraced(function* (ownership) {
+				if (ownership.ownership !== "exclusive") return yield* fileError("reclaimStaging", "ExclusiveOwnershipRequired", "not-started");
+				yield* context.checkDirectories;
+				const names = yield* fs.readDirectory(context.staging).pipe(Effect.mapError(mapIO("reclaimStaging")));
+				let removed = 0;
+				for (const name of names) {
+					if (!/^upload-[a-f0-9-]{36}\.pending$/u.test(name)) continue;
+					const filename = context.path.join(context.staging, name);
+					yield* context.regularFile(filename).pipe(Effect.mapError((error) => error._tag === "PlatformError" ? mapIO("reclaimStaging")(error) : error));
+					yield* fs.remove(filename).pipe(Effect.uninterruptible, Effect.mapError(mapIO("reclaimStaging", "unknown")));
+					removed++;
+				}
+				yield* syncDirectory(fs, context.staging).pipe(Effect.uninterruptible, Effect.mapError(mapIO("reclaimStaging", "unknown")));
+				return removed;
+			})
+		};
+	});
+	static layer(options) {
+		return Layer.effectContext(Effect.map(FilesystemStorage.make(options), (service) => Context.make(Storage, service).pipe(Context.add(FilesystemStorage, service), Context.add(TransferDriver, {
+			storage: service,
+			maximumObjectBytes: options.maxObjectBytes ?? 1073741824,
+			maximumSingleUploadBytes: options.maxObjectBytes ?? 1073741824,
+			transportOverheadBytes: 98304
+		}))));
+	}
+};
+
+export { FilesystemStorage };
+//# sourceMappingURL=filesystem.js.map

package/dist/filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.js","names":[],"sources":["../src/providers/filesystem/index.ts"],"sourcesContent":["import { Context, Effect, Layer } from \"effect\";\n\nimport type { StorageError } from \"../../core/errors.js\";\nimport { Storage } from \"../../core/storage.js\";\nimport type { StorageService } from \"../../core/storage.js\";\nimport { syncDirectory } from \"../../runtime/filesystem.js\";\nimport { TransferDriver } from \"../../transfers/dependencies.js\";\nimport type { FilesystemOptions } from \"./layout.js\";\nimport { makeLayout, mapIO, fileError } from \"./layout.js\";\nimport { list } from \"./list.js\";\nimport { get, head, put } from \"./operations.js\";\n\nexport type { FilesystemOptions } from \"./layout.js\";\nexport interface FilesystemStorageService extends StorageService {\n  /** Only call after excluding every writer across processes. No age heuristic proves ownership. */\n  readonly reclaimStaging: (options: {\n    readonly ownership: \"exclusive\";\n  }) => Effect.Effect<number, StorageError>;\n}\n\nexport class FilesystemStorage extends Context.Service<\n  FilesystemStorage,\n  FilesystemStorageService\n>()(\"@effect-kit/storage/FilesystemStorage\") {\n  static readonly make = Effect.fnUntraced(function* (options: FilesystemOptions) {\n    const context = yield* makeLayout(options).pipe(\n      Effect.mapError((error) => (error._tag === \"PlatformError\" ? mapIO(\"make\")(error) : error)),\n    );\n    const { fs } = context;\n    const storage = Storage.make({\n      provider: \"filesystem\",\n      storeId: context.storeId,\n      capabilities: {\n        putConditions: [\"create-only\"],\n        getConditions: [\"if-match\", \"if-none-match\"],\n        deleteConditions: [],\n        ranges: [\"bounded\", \"from\", \"suffix\"],\n        versionedReads: \"none\",\n        list: {\n          maxPageSize: 1000,\n          delimiter: true,\n          cursorPersistence: \"provider\",\n          snapshot: false,\n        },\n      },\n      put: (request) => put(context, request),\n      get: (request) => get(context, request),\n      head: (request) => head(context, request),\n      delete: Effect.fnUntraced(function* (request) {\n        yield* context.checkDirectories;\n        const key = \"ref\" in request ? request.ref.key : request.key;\n        const filename = yield* context.filename(key);\n        yield* context.regularFile(filename).pipe(\n          Effect.catchReason(\"PlatformError\", \"NotFound\", () => Effect.void),\n          Effect.mapError((error) =>\n            error._tag === \"PlatformError\" ? mapIO(\"delete\", \"not-started\")(error) : error,\n          ),\n        );\n        yield* fs\n          .remove(filename, { force: true })\n          .pipe(\n            Effect.andThen(syncDirectory(fs, context.objects)),\n            Effect.uninterruptible,\n            Effect.mapError(mapIO(\"delete\", \"unknown\")),\n          );\n      }),\n      listPage: (request) => list(context, request),\n    });\n    const service: FilesystemStorageService = {\n      ...storage,\n      reclaimStaging: Effect.fnUntraced(function* (ownership) {\n        if (ownership.ownership !== \"exclusive\")\n          return yield* fileError(\"reclaimStaging\", \"ExclusiveOwnershipRequired\", \"not-started\");\n        yield* context.checkDirectories;\n        const names = yield* fs\n          .readDirectory(context.staging)\n          .pipe(Effect.mapError(mapIO(\"reclaimStaging\")));\n        let removed = 0;\n        for (const name of names) {\n          if (!/^upload-[a-f0-9-]{36}\\.pending$/u.test(name)) continue;\n          const filename = context.path.join(context.staging, name);\n          yield* context\n            .regularFile(filename)\n            .pipe(\n              Effect.mapError((error) =>\n                error._tag === \"PlatformError\" ? mapIO(\"reclaimStaging\")(error) : error,\n              ),\n            );\n          yield* fs\n            .remove(filename)\n            .pipe(Effect.uninterruptible, Effect.mapError(mapIO(\"reclaimStaging\", \"unknown\")));\n          removed++;\n        }\n        yield* syncDirectory(fs, context.staging).pipe(\n          Effect.uninterruptible,\n          Effect.mapError(mapIO(\"reclaimStaging\", \"unknown\")),\n        );\n        return removed;\n      }),\n    };\n    return service;\n  });\n\n  static layer(options: FilesystemOptions) {\n    return Layer.effectContext(\n      Effect.map(FilesystemStorage.make(options), (service) =>\n        Context.make(Storage, service).pipe(\n          Context.add(FilesystemStorage, service),\n          Context.add(TransferDriver, {\n            storage: service,\n            maximumObjectBytes: options.maxObjectBytes ?? 1024 * 1024 * 1024,\n            maximumSingleUploadBytes: options.maxObjectBytes ?? 1024 * 1024 * 1024,\n            transportOverheadBytes: 65536 + 32768,\n          }),\n        ),\n      ),\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/gcs/admin.d.ts

@@ -0,0 +1,470 @@
+import { StorageError } from "../core/errors.js";
+import "../index.js";
+import { GcsConfig } from "../providers/gcs/config.js";
+import "../gcs.js";
+import { Context, Effect, Layer, Schema } from "effect";
+declare const Configuration: Schema.Struct<{
+  readonly cors: Schema.optional<Schema.$Array<Schema.$Record<Schema.String, Schema.Unknown>>>;
+  readonly lifecycle: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+  readonly versioning: Schema.optional<Schema.Struct<{
+    readonly enabled: Schema.Boolean;
+  }>>;
+  readonly encryption: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+  readonly retentionPolicy: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+  readonly softDeletePolicy: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+  readonly iamConfiguration: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+  readonly labels: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+  readonly logging: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+  readonly website: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+  readonly autoclass: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+}>;
+export type GcsBucketConfiguration = typeof Configuration.Type;
+declare const GcsAdministration_base: Context.ServiceClass<GcsAdministration, "@effect-kit/storage/gcs/GcsAdministration", {
+  head: (input: {
+    readonly bucket: string;
+  }) => Effect.Effect<{
+    readonly cors?: readonly {
+      readonly [x: string]: unknown;
+    }[] | undefined;
+    readonly lifecycle?: {
+      readonly [x: string]: unknown;
+    } | undefined;
+    readonly versioning?: {
+      readonly enabled: boolean;
+    } | undefined;
+    readonly encryption?: {
+      readonly [x: string]: unknown;
+    } | undefined;
+    readonly retentionPolicy?: {
+      readonly [x: string]: unknown;
+    } | undefined;
+    readonly softDeletePolicy?: {
+      readonly [x: string]: unknown;
+    } | undefined;
+    readonly iamConfiguration?: {
+      readonly [x: string]: unknown;
+    } | undefined;
+    readonly labels?: {
+      readonly [x: string]: string;
+    } | undefined;
+    readonly logging?: {
+      readonly [x: string]: unknown;
+    } | undefined;
+    readonly website?: {
+      readonly [x: string]: unknown;
+    } | undefined;
+    readonly autoclass?: {
+      readonly [x: string]: unknown;
+    } | undefined;
+    readonly name: string;
+    readonly metageneration: string;
+  }, StorageError, never>;
+  iam: {
+    get: (input: {
+      readonly bucket: string;
+    }) => Effect.Effect<{
+      readonly version: 1 | 3;
+      readonly etag: string;
+      readonly bindings: readonly {
+        readonly role: string;
+        readonly members: readonly string[];
+        readonly condition?: {
+          readonly title: string;
+          readonly expression: string;
+          readonly description?: string | undefined;
+        } | undefined;
+      }[];
+    }, StorageError, never>;
+    set: (input: {
+      readonly bucket: string;
+      readonly policy: {
+        readonly version: 1 | 3;
+        readonly etag: string;
+        readonly bindings: readonly {
+          readonly role: string;
+          readonly members: readonly string[];
+          readonly condition?: {
+            readonly title: string;
+            readonly expression: string;
+            readonly description?: string | undefined;
+          } | undefined;
+        }[];
+      };
+      readonly intent: "replace-bucket-iam-policy";
+    }) => Effect.Effect<{
+      readonly version: 1 | 3;
+      readonly etag: string;
+      readonly bindings: readonly {
+        readonly role: string;
+        readonly members: readonly string[];
+        readonly condition?: {
+          readonly title: string;
+          readonly expression: string;
+          readonly description?: string | undefined;
+        } | undefined;
+      }[];
+    }, StorageError, never>;
+  };
+  listPage: (input: {
+    readonly project: string;
+    readonly cursor?: string;
+    readonly limit?: number;
+  }) => Effect.Effect<{
+    readonly items?: readonly {
+      readonly [x: string]: unknown;
+    }[] | undefined;
+    readonly nextPageToken?: string | undefined;
+  }, StorageError, never>;
+  create: (input: {
+    readonly bucket: string;
+    readonly project: string;
+    readonly location: string;
+  }) => Effect.Effect<{
+    readonly [x: string]: unknown;
+  }, StorageError, never>;
+  deleteEmpty: (input: {
+    readonly bucket: string;
+    readonly ifMetagenerationMatch: string;
+  }) => Effect.Effect<void, StorageError, never>;
+  configuration: {
+    get: (input: {
+      readonly bucket: string;
+    }) => Effect.Effect<{
+      readonly cors?: readonly {
+        readonly [x: string]: unknown;
+      }[] | undefined;
+      readonly lifecycle?: {
+        readonly [x: string]: unknown;
+      } | undefined;
+      readonly versioning?: {
+        readonly enabled: boolean;
+      } | undefined;
+      readonly encryption?: {
+        readonly [x: string]: unknown;
+      } | undefined;
+      readonly retentionPolicy?: {
+        readonly [x: string]: unknown;
+      } | undefined;
+      readonly softDeletePolicy?: {
+        readonly [x: string]: unknown;
+      } | undefined;
+      readonly iamConfiguration?: {
+        readonly [x: string]: unknown;
+      } | undefined;
+      readonly labels?: {
+        readonly [x: string]: string;
+      } | undefined;
+      readonly logging?: {
+        readonly [x: string]: unknown;
+      } | undefined;
+      readonly website?: {
+        readonly [x: string]: unknown;
+      } | undefined;
+      readonly autoclass?: {
+        readonly [x: string]: unknown;
+      } | undefined;
+      readonly name: string;
+      readonly metageneration: string;
+    }, StorageError, never>;
+    plan: (input: {
+      readonly bucket: string;
+      readonly desired: GcsBucketConfiguration;
+    }) => Effect.Effect<{
+      bucket: string;
+      expectedMetageneration: string;
+      desired: {
+        readonly cors?: readonly {
+          readonly [x: string]: unknown;
+        }[] | undefined;
+        readonly lifecycle?: {
+          readonly [x: string]: unknown;
+        } | undefined;
+        readonly versioning?: {
+          readonly enabled: boolean;
+        } | undefined;
+        readonly encryption?: {
+          readonly [x: string]: unknown;
+        } | undefined;
+        readonly retentionPolicy?: {
+          readonly [x: string]: unknown;
+        } | undefined;
+        readonly softDeletePolicy?: {
+          readonly [x: string]: unknown;
+        } | undefined;
+        readonly iamConfiguration?: {
+          readonly [x: string]: unknown;
+        } | undefined;
+        readonly labels?: {
+          readonly [x: string]: string;
+        } | undefined;
+        readonly logging?: {
+          readonly [x: string]: unknown;
+        } | undefined;
+        readonly website?: {
+          readonly [x: string]: unknown;
+        } | undefined;
+        readonly autoclass?: {
+          readonly [x: string]: unknown;
+        } | undefined;
+      };
+      changes: string[];
+    }, StorageError, never>;
+    apply: (input: {
+      readonly plan: object;
+      readonly protectionChange?: {
+        readonly intent: "change-storage-protection";
+        readonly reason: string;
+      };
+    }) => Effect.Effect<{
+      readonly [x: string]: unknown;
+    }, StorageError, never>;
+  };
+  lockRetentionPolicy: (input: {
+    readonly bucket: string;
+    readonly ifMetagenerationMatch: string;
+    readonly intent: "irreversibly-lock-retention";
+  }) => Effect.Effect<{
+    readonly [x: string]: unknown;
+  }, StorageError, never>;
+  notifications: {
+    list: (input: {
+      readonly bucket: string;
+    }) => Effect.Effect<unknown, StorageError, never>;
+    create: (input: {
+      readonly bucket: string;
+      readonly topic: string;
+      readonly events?: ReadonlyArray<string>;
+    }) => Effect.Effect<unknown, StorageError, never>;
+    delete: (input: {
+      readonly bucket: string;
+      readonly id: string;
+    }) => Effect.Effect<void, StorageError, never>;
+  };
+}>;
+export declare class GcsAdministration extends GcsAdministration_base {
+  static readonly make: (config: Omit<GcsConfig, "bucket">) => Effect.Effect<{
+    head: (input: {
+      readonly bucket: string;
+    }) => Effect.Effect<{
+      readonly cors?: readonly {
+        readonly [x: string]: unknown;
+      }[] | undefined;
+      readonly lifecycle?: {
+        readonly [x: string]: unknown;
+      } | undefined;
+      readonly versioning?: {
+        readonly enabled: boolean;
+      } | undefined;
+      readonly encryption?: {
+        readonly [x: string]: unknown;
+      } | undefined;
+      readonly retentionPolicy?: {
+        readonly [x: string]: unknown;
+      } | undefined;
+      readonly softDeletePolicy?: {
+        readonly [x: string]: unknown;
+      } | undefined;
+      readonly iamConfiguration?: {
+        readonly [x: string]: unknown;
+      } | undefined;
+      readonly labels?: {
+        readonly [x: string]: string;
+      } | undefined;
+      readonly logging?: {
+        readonly [x: string]: unknown;
+      } | undefined;
+      readonly website?: {
+        readonly [x: string]: unknown;
+      } | undefined;
+      readonly autoclass?: {
+        readonly [x: string]: unknown;
+      } | undefined;
+      readonly name: string;
+      readonly metageneration: string;
+    }, StorageError, never>;
+    iam: {
+      get: (input: {
+        readonly bucket: string;
+      }) => Effect.Effect<{
+        readonly version: 1 | 3;
+        readonly etag: string;
+        readonly bindings: readonly {
+          readonly role: string;
+          readonly members: readonly string[];
+          readonly condition?: {
+            readonly title: string;
+            readonly expression: string;
+            readonly description?: string | undefined;
+          } | undefined;
+        }[];
+      }, StorageError, never>;
+      set: (input: {
+        readonly bucket: string;
+        readonly policy: {
+          readonly version: 1 | 3;
+          readonly etag: string;
+          readonly bindings: readonly {
+            readonly role: string;
+            readonly members: readonly string[];
+            readonly condition?: {
+              readonly title: string;
+              readonly expression: string;
+              readonly description?: string | undefined;
+            } | undefined;
+          }[];
+        };
+        readonly intent: "replace-bucket-iam-policy";
+      }) => Effect.Effect<{
+        readonly version: 1 | 3;
+        readonly etag: string;
+        readonly bindings: readonly {
+          readonly role: string;
+          readonly members: readonly string[];
+          readonly condition?: {
+            readonly title: string;
+            readonly expression: string;
+            readonly description?: string | undefined;
+          } | undefined;
+        }[];
+      }, StorageError, never>;
+    };
+    listPage: (input: {
+      readonly project: string;
+      readonly cursor?: string;
+      readonly limit?: number;
+    }) => Effect.Effect<{
+      readonly items?: readonly {
+        readonly [x: string]: unknown;
+      }[] | undefined;
+      readonly nextPageToken?: string | undefined;
+    }, StorageError, never>;
+    create: (input: {
+      readonly bucket: string;
+      readonly project: string;
+      readonly location: string;
+    }) => Effect.Effect<{
+      readonly [x: string]: unknown;
+    }, StorageError, never>;
+    deleteEmpty: (input: {
+      readonly bucket: string;
+      readonly ifMetagenerationMatch: string;
+    }) => Effect.Effect<void, StorageError, never>;
+    configuration: {
+      get: (input: {
+        readonly bucket: string;
+      }) => Effect.Effect<{
+        readonly cors?: readonly {
+          readonly [x: string]: unknown;
+        }[] | undefined;
+        readonly lifecycle?: {
+          readonly [x: string]: unknown;
+        } | undefined;
+        readonly versioning?: {
+          readonly enabled: boolean;
+        } | undefined;
+        readonly encryption?: {
+          readonly [x: string]: unknown;
+        } | undefined;
+        readonly retentionPolicy?: {
+          readonly [x: string]: unknown;
+        } | undefined;
+        readonly softDeletePolicy?: {
+          readonly [x: string]: unknown;
+        } | undefined;
+        readonly iamConfiguration?: {
+          readonly [x: string]: unknown;
+        } | undefined;
+        readonly labels?: {
+          readonly [x: string]: string;
+        } | undefined;
+        readonly logging?: {
+          readonly [x: string]: unknown;
+        } | undefined;
+        readonly website?: {
+          readonly [x: string]: unknown;
+        } | undefined;
+        readonly autoclass?: {
+          readonly [x: string]: unknown;
+        } | undefined;
+        readonly name: string;
+        readonly metageneration: string;
+      }, StorageError, never>;
+      plan: (input: {
+        readonly bucket: string;
+        readonly desired: GcsBucketConfiguration;
+      }) => Effect.Effect<{
+        bucket: string;
+        expectedMetageneration: string;
+        desired: {
+          readonly cors?: readonly {
+            readonly [x: string]: unknown;
+          }[] | undefined;
+          readonly lifecycle?: {
+            readonly [x: string]: unknown;
+          } | undefined;
+          readonly versioning?: {
+            readonly enabled: boolean;
+          } | undefined;
+          readonly encryption?: {
+            readonly [x: string]: unknown;
+          } | undefined;
+          readonly retentionPolicy?: {
+            readonly [x: string]: unknown;
+          } | undefined;
+          readonly softDeletePolicy?: {
+            readonly [x: string]: unknown;
+          } | undefined;
+          readonly iamConfiguration?: {
+            readonly [x: string]: unknown;
+          } | undefined;
+          readonly labels?: {
+            readonly [x: string]: string;
+          } | undefined;
+          readonly logging?: {
+            readonly [x: string]: unknown;
+          } | undefined;
+          readonly website?: {
+            readonly [x: string]: unknown;
+          } | undefined;
+          readonly autoclass?: {
+            readonly [x: string]: unknown;
+          } | undefined;
+        };
+        changes: string[];
+      }, StorageError, never>;
+      apply: (input: {
+        readonly plan: object;
+        readonly protectionChange?: {
+          readonly intent: "change-storage-protection";
+          readonly reason: string;
+        };
+      }) => Effect.Effect<{
+        readonly [x: string]: unknown;
+      }, StorageError, never>;
+    };
+    lockRetentionPolicy: (input: {
+      readonly bucket: string;
+      readonly ifMetagenerationMatch: string;
+      readonly intent: "irreversibly-lock-retention";
+    }) => Effect.Effect<{
+      readonly [x: string]: unknown;
+    }, StorageError, never>;
+    notifications: {
+      list: (input: {
+        readonly bucket: string;
+      }) => Effect.Effect<unknown, StorageError, never>;
+      create: (input: {
+        readonly bucket: string;
+        readonly topic: string;
+        readonly events?: ReadonlyArray<string>;
+      }) => Effect.Effect<unknown, StorageError, never>;
+      delete: (input: {
+        readonly bucket: string;
+        readonly id: string;
+      }) => Effect.Effect<void, StorageError, never>;
+    };
+  }, StorageError, never>;
+  static layer(config: Omit<GcsConfig, "bucket">): Layer.Layer<GcsAdministration, StorageError, never>;
+}
+export {};
+//# sourceMappingURL=admin.d.ts.map