@effect-kit/storage 0.0.0-stage → 0.1.0

package/dist/s3/admin.d.ts

@@ -0,0 +1,183 @@
+import { StorageError } from "../core/errors.js";
+import { S3Config } from "../providers/s3/config.js";
+import { S3StorageService } from "../s3.js";
+import { ConfigurationSection, S3Configuration } from "../providers/s3/admin-configuration.js";
+import { Context, Effect, Layer } from "effect";
+import { CreateBucketConfiguration } from "@aws-sdk/client-s3";
+export interface S3AdminConfig extends Omit<S3Config, "bucket" | "storeId"> {
+  readonly credentials: NonNullable<S3Config["credentials"]>;
+}
+export interface ConfigurationPlan {
+  readonly bucket: string;
+  readonly changes: ReadonlyArray<{
+    readonly section: ConfigurationSection;
+    readonly before: unknown;
+    readonly after: unknown;
+  }>;
+  readonly concurrency: "best-effort";
+}
+export interface ConfigurationOutcome {
+  readonly bucket: string;
+  readonly steps: ReadonlyArray<{
+    readonly section: ConfigurationSection;
+    readonly status: "applied" | "pending" | "failed" | "unknown";
+    readonly error?: StorageError | undefined;
+  }>;
+  readonly complete: boolean;
+}
+export declare function makeAdministration(storage: S3StorageService): {
+  listPage: (input?: {
+    readonly cursor?: string;
+    readonly limit?: number;
+  } | undefined) => Effect.Effect<{
+    buckets: {
+      name: string | undefined;
+      createdAt: Date | undefined;
+    }[];
+    cursor: string | undefined;
+  }, StorageError, never>;
+  head: (input: {
+    readonly bucket: string;
+  }) => Effect.Effect<{
+    bucket: string;
+    region: string | undefined;
+  }, StorageError, never>;
+  create: (input: {
+    readonly bucket: string;
+    readonly configuration?: CreateBucketConfiguration;
+    readonly objectLockEnabled?: boolean;
+  }) => Effect.Effect<{
+    _tag: "Accepted";
+    bucket: string;
+  }, StorageError, never>;
+  deleteEmpty: (input: {
+    readonly bucket: string;
+  }) => Effect.Effect<void, StorageError, never>;
+  configuration: {
+    get: (input: {
+      readonly bucket: string;
+      readonly sections: ReadonlyArray<ConfigurationSection>;
+    }) => Effect.Effect<{
+      section: "cors" | "encryption" | "lifecycle" | "notifications" | "objectLock" | "policy" | "publicAccess" | "replication" | "versioning";
+      value: unknown;
+    }[], StorageError, never>;
+    plan: (input: {
+      readonly bucket: string;
+      readonly desired: S3Configuration;
+    }) => Effect.Effect<ConfigurationPlan, StorageError, never>;
+    apply: (input: {
+      readonly plan: ConfigurationPlan;
+      readonly allowUnconditional: true;
+      readonly protectionChange?: {
+        readonly intent: "change-storage-protection";
+        readonly reason: string;
+      };
+    }) => Effect.Effect<ConfigurationOutcome, StorageError, never>;
+  };
+};
+export type S3AdministrationService = ReturnType<typeof makeAdministration>;
+declare const S3Administration_base: Context.ServiceClass<S3Administration, "@effect-kit/storage/s3/S3Administration", {
+  listPage: (input?: {
+    readonly cursor?: string;
+    readonly limit?: number;
+  } | undefined) => Effect.Effect<{
+    buckets: {
+      name: string | undefined;
+      createdAt: Date | undefined;
+    }[];
+    cursor: string | undefined;
+  }, StorageError, never>;
+  head: (input: {
+    readonly bucket: string;
+  }) => Effect.Effect<{
+    bucket: string;
+    region: string | undefined;
+  }, StorageError, never>;
+  create: (input: {
+    readonly bucket: string;
+    readonly configuration?: CreateBucketConfiguration;
+    readonly objectLockEnabled?: boolean;
+  }) => Effect.Effect<{
+    _tag: "Accepted";
+    bucket: string;
+  }, StorageError, never>;
+  deleteEmpty: (input: {
+    readonly bucket: string;
+  }) => Effect.Effect<void, StorageError, never>;
+  configuration: {
+    get: (input: {
+      readonly bucket: string;
+      readonly sections: ReadonlyArray<ConfigurationSection>;
+    }) => Effect.Effect<{
+      section: "cors" | "encryption" | "lifecycle" | "notifications" | "objectLock" | "policy" | "publicAccess" | "replication" | "versioning";
+      value: unknown;
+    }[], StorageError, never>;
+    plan: (input: {
+      readonly bucket: string;
+      readonly desired: S3Configuration;
+    }) => Effect.Effect<ConfigurationPlan, StorageError, never>;
+    apply: (input: {
+      readonly plan: ConfigurationPlan;
+      readonly allowUnconditional: true;
+      readonly protectionChange?: {
+        readonly intent: "change-storage-protection";
+        readonly reason: string;
+      };
+    }) => Effect.Effect<ConfigurationOutcome, StorageError, never>;
+  };
+}>;
+export declare class S3Administration extends S3Administration_base {
+  static readonly make: (config: S3AdminConfig) => Effect.Effect<{
+    listPage: (input?: {
+      readonly cursor?: string;
+      readonly limit?: number;
+    } | undefined) => Effect.Effect<{
+      buckets: {
+        name: string | undefined;
+        createdAt: Date | undefined;
+      }[];
+      cursor: string | undefined;
+    }, StorageError, never>;
+    head: (input: {
+      readonly bucket: string;
+    }) => Effect.Effect<{
+      bucket: string;
+      region: string | undefined;
+    }, StorageError, never>;
+    create: (input: {
+      readonly bucket: string;
+      readonly configuration?: CreateBucketConfiguration;
+      readonly objectLockEnabled?: boolean;
+    }) => Effect.Effect<{
+      _tag: "Accepted";
+      bucket: string;
+    }, StorageError, never>;
+    deleteEmpty: (input: {
+      readonly bucket: string;
+    }) => Effect.Effect<void, StorageError, never>;
+    configuration: {
+      get: (input: {
+        readonly bucket: string;
+        readonly sections: ReadonlyArray<ConfigurationSection>;
+      }) => Effect.Effect<{
+        section: "cors" | "encryption" | "lifecycle" | "notifications" | "objectLock" | "policy" | "publicAccess" | "replication" | "versioning";
+        value: unknown;
+      }[], StorageError, never>;
+      plan: (input: {
+        readonly bucket: string;
+        readonly desired: S3Configuration;
+      }) => Effect.Effect<ConfigurationPlan, StorageError, never>;
+      apply: (input: {
+        readonly plan: ConfigurationPlan;
+        readonly allowUnconditional: true;
+        readonly protectionChange?: {
+          readonly intent: "change-storage-protection";
+          readonly reason: string;
+        };
+      }) => Effect.Effect<ConfigurationOutcome, StorageError, never>;
+    };
+  }, StorageError, import("effect/Scope").Scope>;
+  static layer(config: S3AdminConfig): Layer.Layer<S3Administration, StorageError, never>;
+}
+export type { ConfigurationSection, S3Configuration };
+//# sourceMappingURL=admin.d.ts.map

package/dist/s3/admin.js

@@ -0,0 +1,197 @@
+import { storageError } from "../core/errors.js";
+import { decodeRequest } from "../internal/request-validation.js";
+import { request } from "../providers/s3/transport.js";
+import { S3Storage } from "../s3.js";
+import { configurationState } from "../lifecycle/configuration-state.js";
+import { ConfigurationSection, configurationSections, desiredSection, getConfiguration, putConfiguration, validateConfiguration } from "../providers/s3/admin-configuration.js";
+import { Context, Effect, Layer, Result, Schema } from "effect";
+import { CreateBucketCommand, DeleteBucketCommand, HeadBucketCommand, ListBucketsCommand } from "@aws-sdk/client-s3";
+
+// src/providers/s3/admin.ts
+const Bucket = Schema.String.check(Schema.isPattern(/^[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]$/u));
+const Target = Schema.Struct({ bucket: Bucket });
+function makeAdministration(storage) {
+	const issued = /* @__PURE__ */ new WeakMap();
+	const consumed = /* @__PURE__ */ new WeakSet();
+	const allowedSections = storage.provider === "s3" || storage.provider === "minio" ? configurationSections : storage.provider === "wasabi" ? [
+		"cors",
+		"versioning",
+		"lifecycle",
+		"objectLock",
+		"policy",
+		"replication"
+	] : storage.provider === "spaces" ? storage.profile?.bucketTier === "cold" ? ["lifecycle"] : [
+		"cors",
+		"versioning",
+		"lifecycle",
+		"policy"
+	] : [
+		"cors",
+		"versioning",
+		"lifecycle",
+		"encryption",
+		"objectLock",
+		"policy"
+	];
+	const read = Effect.fnUntraced(function* (input) {
+		const value = yield* decodeRequest(Schema.Struct({
+			bucket: Bucket,
+			sections: Schema.Array(ConfigurationSection)
+		}), input, "getConfiguration", storage.provider);
+		if (value.sections.some((section) => !allowedSections.includes(section))) return yield* storageError("getConfiguration", storage.provider, {
+			_tag: "Unsupported",
+			capability: "configuration-section"
+		});
+		return yield* Effect.forEach(value.sections, (section) => getConfiguration(storage, value.bucket, section).pipe(Effect.map((configuration) => ({
+			section,
+			value: configuration
+		}))));
+	});
+	return {
+		listPage: Effect.fnUntraced(function* (input = {}) {
+			const value = yield* decodeRequest(Schema.Struct({
+				cursor: Schema.optional(Schema.NonEmptyString),
+				limit: Schema.optional(Schema.Int.check(Schema.isBetween({
+					minimum: 1,
+					maximum: 1e3
+				})))
+			}), input, "listBuckets", storage.provider);
+			const page = yield* request(storage, "listBuckets", false, (signal) => storage.client.send(new ListBucketsCommand({
+				ContinuationToken: value.cursor,
+				MaxBuckets: value.limit ?? 1e3
+			}), { abortSignal: signal }));
+			return {
+				buckets: (page.Buckets ?? []).map(({ Name, CreationDate }) => ({
+					name: Name,
+					createdAt: CreationDate
+				})),
+				cursor: page.ContinuationToken
+			};
+		}),
+		head: Effect.fnUntraced(function* (input) {
+			const value = yield* decodeRequest(Target, input, "headBucket", storage.provider);
+			const result = yield* request(storage, "headBucket", false, (signal) => storage.client.send(new HeadBucketCommand({ Bucket: value.bucket }), { abortSignal: signal }));
+			return {
+				bucket: value.bucket,
+				region: result.BucketRegion
+			};
+		}),
+		create: Effect.fnUntraced(function* (input) {
+			yield* decodeRequest(Target, { bucket: input.bucket }, "createBucket", storage.provider, true);
+			const region = input.configuration?.LocationConstraint;
+			if (region && region !== storage.config.region || !storage.profile && storage.config.region !== "us-east-1" && !region) return yield* storageError("createBucket", storage.provider, {
+				_tag: "InvalidInput",
+				field: "location"
+			}, "not-started");
+			yield* request(storage, "createBucket", true, (signal) => storage.client.send(new CreateBucketCommand({
+				Bucket: input.bucket,
+				...input.configuration ? { CreateBucketConfiguration: input.configuration } : {},
+				...input.objectLockEnabled ? { ObjectLockEnabledForBucket: true } : {}
+			}), { abortSignal: signal }));
+			return {
+				_tag: "Accepted",
+				bucket: input.bucket
+			};
+		}),
+		deleteEmpty: Effect.fnUntraced(function* (input) {
+			const value = yield* decodeRequest(Target, input, "deleteBucket", storage.provider, true);
+			yield* request(storage, "deleteBucket", true, (signal) => storage.client.send(new DeleteBucketCommand({ Bucket: value.bucket }), { abortSignal: signal }));
+		}),
+		configuration: {
+			get: read,
+			plan: Effect.fnUntraced(function* (input) {
+				yield* decodeRequest(Target, { bucket: input.bucket }, "planConfiguration", storage.provider);
+				const desired = structuredClone(yield* validateConfiguration(input.desired));
+				const sections = configurationSections.filter((section) => desired[section] !== void 0);
+				const before = yield* read({
+					bucket: input.bucket,
+					sections
+				});
+				const changes = before.filter(({ section, value }) => configurationState(value) !== configurationState(desiredSection(desired, section))).map(({ section, value }) => ({
+					section,
+					before: structuredClone(value),
+					after: structuredClone(desiredSection(desired, section))
+				}));
+				const plan = Object.freeze({
+					bucket: input.bucket,
+					changes: Object.freeze(changes),
+					concurrency: "best-effort"
+				});
+				issued.set(plan, {
+					bucket: input.bucket,
+					desired,
+					before,
+					snapshot: configurationState(plan)
+				});
+				return plan;
+			}),
+			apply: Effect.fnUntraced(function* (input) {
+				const saved = issued.get(input.plan);
+				if (!saved || configurationState(input.plan) !== saved.snapshot || consumed.has(input.plan) || input.allowUnconditional !== true) return yield* storageError("applyConfiguration", storage.provider, {
+					_tag: "InvalidInput",
+					field: "issued-plan-and-concurrency-intent"
+				}, "not-started");
+				if (Object.keys(saved.desired).some((section) => [
+					"publicAccess",
+					"policy",
+					"objectLock",
+					"versioning",
+					"encryption",
+					"lifecycle"
+				].includes(section)) && (input.protectionChange?.intent !== "change-storage-protection" || !input.protectionChange.reason)) return yield* storageError("applyConfiguration", storage.provider, {
+					_tag: "InvalidInput",
+					field: "protectionChange"
+				}, "not-started");
+				const current = yield* read({
+					bucket: saved.bucket,
+					sections: saved.before.map((entry) => entry.section)
+				});
+				if (configurationState(current) !== configurationState(saved.before)) return yield* storageError("applyConfiguration", storage.provider, { _tag: "PreconditionFailed" }, "not-started");
+				consumed.add(input.plan);
+				const steps = [];
+				for (const { section, value } of saved.before) {
+					if (configurationState(value) === configurationState(desiredSection(saved.desired, section))) continue;
+					const outcome = yield* Effect.result(putConfiguration(storage, saved.bucket, section, saved.desired));
+					if (Result.isFailure(outcome)) {
+						steps.push({
+							section,
+							status: outcome.failure.mutationOutcome === "unknown" ? "unknown" : "failed",
+							error: outcome.failure
+						});
+						break;
+					}
+					const observed = yield* Effect.result(getConfiguration(storage, saved.bucket, section));
+					steps.push({
+						section,
+						status: Result.isSuccess(observed) && configurationState(observed.success) === configurationState(desiredSection(saved.desired, section)) ? "applied" : "pending",
+						...Result.isFailure(observed) ? { error: observed.failure } : {}
+					});
+				}
+				return {
+					bucket: saved.bucket,
+					steps,
+					complete: steps.every((step) => step.status === "applied") && steps.length === input.plan.changes.length
+				};
+			})
+		}
+	};
+}
+const make = Effect.fnUntraced(function* (config) {
+	if (!config.credentials) return yield* storageError("makeAdministration", "s3", {
+		_tag: "InvalidConfiguration",
+		field: "credentials"
+	});
+	return makeAdministration(yield* S3Storage.make({
+		...config,
+		bucket: "administration"
+	}));
+});
+var S3Administration = class S3Administration extends Context.Service()("@effect-kit/storage/s3/S3Administration") {
+	static make = make;
+	static layer(config) {
+		return Layer.effect(S3Administration, make(config));
+	}
+};
+
+export { S3Administration, makeAdministration };
+//# sourceMappingURL=admin.js.map

package/dist/s3/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.js","names":[],"sources":["../../src/providers/s3/admin.ts"],"sourcesContent":["import { Context, Effect, Layer, Result, Schema } from \"effect\";\n\nimport {\n  CreateBucketCommand,\n  DeleteBucketCommand,\n  HeadBucketCommand,\n  ListBucketsCommand,\n} from \"@aws-sdk/client-s3\";\nimport type { CreateBucketConfiguration } from \"@aws-sdk/client-s3\";\n\nimport { storageError } from \"../../core/errors.js\";\nimport type { StorageError } from \"../../core/errors.js\";\nimport { decodeRequest } from \"../../internal/request-validation.js\";\nimport { configurationState } from \"../../lifecycle/configuration-state.js\";\nimport {\n  ConfigurationSection,\n  configurationSections,\n  desiredSection,\n  getConfiguration,\n  putConfiguration,\n  validateConfiguration,\n} from \"./admin-configuration.js\";\nimport type { S3Configuration } from \"./admin-configuration.js\";\nimport { S3Storage } from \"./index.js\";\nimport type { S3Config, S3StorageService } from \"./index.js\";\nimport { request } from \"./transport.js\";\n\nexport type { S3Configuration, ConfigurationSection } from \"./admin-configuration.js\";\nexport interface S3AdminConfig extends Omit<S3Config, \"bucket\" | \"storeId\"> {\n  readonly credentials: NonNullable<S3Config[\"credentials\"]>;\n}\nconst Bucket = Schema.String.check(Schema.isPattern(/^[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]$/u));\nconst Target = Schema.Struct({ bucket: Bucket });\nexport interface ConfigurationPlan {\n  readonly bucket: string;\n  readonly changes: ReadonlyArray<{\n    readonly section: ConfigurationSection;\n    readonly before: unknown;\n    readonly after: unknown;\n  }>;\n  readonly concurrency: \"best-effort\";\n}\nexport interface ConfigurationOutcome {\n  readonly bucket: string;\n  readonly steps: ReadonlyArray<{\n    readonly section: ConfigurationSection;\n    readonly status: \"applied\" | \"pending\" | \"failed\" | \"unknown\";\n    readonly error?: StorageError | undefined;\n  }>;\n  readonly complete: boolean;\n}\n\nexport function makeAdministration(storage: S3StorageService) {\n  const issued = new WeakMap<\n    ConfigurationPlan,\n    {\n      bucket: string;\n      desired: S3Configuration;\n      snapshot: string;\n      before: ReadonlyArray<{ section: ConfigurationSection; value: unknown }>;\n    }\n  >();\n  const consumed = new WeakSet<ConfigurationPlan>();\n  const allowedSections =\n    storage.provider === \"s3\" || storage.provider === \"minio\"\n      ? configurationSections\n      : storage.provider === \"wasabi\"\n        ? [\"cors\", \"versioning\", \"lifecycle\", \"objectLock\", \"policy\", \"replication\"]\n        : storage.provider === \"spaces\"\n          ? storage.profile?.bucketTier === \"cold\"\n            ? [\"lifecycle\"]\n            : [\"cors\", \"versioning\", \"lifecycle\", \"policy\"]\n          : [\"cors\", \"versioning\", \"lifecycle\", \"encryption\", \"objectLock\", \"policy\"];\n  const read = Effect.fnUntraced(function* (input: {\n    readonly bucket: string;\n    readonly sections: ReadonlyArray<ConfigurationSection>;\n  }) {\n    const value = yield* decodeRequest(\n      Schema.Struct({ bucket: Bucket, sections: Schema.Array(ConfigurationSection) }),\n      input,\n      \"getConfiguration\",\n      storage.provider,\n    );\n    if (value.sections.some((section) => !allowedSections.includes(section)))\n      return yield* storageError(\"getConfiguration\", storage.provider, {\n        _tag: \"Unsupported\",\n        capability: \"configuration-section\",\n      });\n    return yield* Effect.forEach(value.sections, (section) =>\n      getConfiguration(storage, value.bucket, section).pipe(\n        Effect.map((configuration) => ({ section, value: configuration })),\n      ),\n    );\n  });\n  return {\n    listPage: Effect.fnUntraced(function* (\n      input: { readonly cursor?: string; readonly limit?: number } = {},\n    ) {\n      const value = yield* decodeRequest(\n        Schema.Struct({\n          cursor: Schema.optional(Schema.NonEmptyString),\n          limit: Schema.optional(Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 1000 }))),\n        }),\n        input,\n        \"listBuckets\",\n        storage.provider,\n      );\n      const page = yield* request(storage, \"listBuckets\", false, (signal) =>\n        storage.client.send(\n          new ListBucketsCommand({\n            ContinuationToken: value.cursor,\n            MaxBuckets: value.limit ?? 1000,\n          }),\n          { abortSignal: signal },\n        ),\n      );\n      return {\n        buckets: (page.Buckets ?? []).map(({ Name, CreationDate }) => ({\n          name: Name,\n          createdAt: CreationDate,\n        })),\n        cursor: page.ContinuationToken,\n      };\n    }),\n    head: Effect.fnUntraced(function* (input: typeof Target.Type) {\n      const value = yield* decodeRequest(Target, input, \"headBucket\", storage.provider);\n      const result = yield* request(storage, \"headBucket\", false, (signal) =>\n        storage.client.send(new HeadBucketCommand({ Bucket: value.bucket }), {\n          abortSignal: signal,\n        }),\n      );\n      return { bucket: value.bucket, region: result.BucketRegion };\n    }),\n    create: Effect.fnUntraced(function* (input: {\n      readonly bucket: string;\n      readonly configuration?: CreateBucketConfiguration;\n      readonly objectLockEnabled?: boolean;\n    }) {\n      yield* decodeRequest(\n        Target,\n        { bucket: input.bucket },\n        \"createBucket\",\n        storage.provider,\n        true,\n      );\n      const region = input.configuration?.LocationConstraint;\n      if (\n        (region && region !== storage.config.region) ||\n        (!storage.profile && storage.config.region !== \"us-east-1\" && !region)\n      )\n        return yield* storageError(\n          \"createBucket\",\n          storage.provider,\n          { _tag: \"InvalidInput\", field: \"location\" },\n          \"not-started\",\n        );\n      yield* request(storage, \"createBucket\", true, (signal) =>\n        storage.client.send(\n          new CreateBucketCommand({\n            Bucket: input.bucket,\n            ...(input.configuration ? { CreateBucketConfiguration: input.configuration } : {}),\n            ...(input.objectLockEnabled ? { ObjectLockEnabledForBucket: true } : {}),\n          }),\n          { abortSignal: signal },\n        ),\n      );\n      return { _tag: \"Accepted\" as const, bucket: input.bucket };\n    }),\n    // The provider's atomic nonempty rejection is authoritative; never enumerate then assume empty.\n    deleteEmpty: Effect.fnUntraced(function* (input: typeof Target.Type) {\n      const value = yield* decodeRequest(Target, input, \"deleteBucket\", storage.provider, true);\n      yield* request(storage, \"deleteBucket\", true, (signal) =>\n        storage.client.send(new DeleteBucketCommand({ Bucket: value.bucket }), {\n          abortSignal: signal,\n        }),\n      );\n    }),\n    configuration: {\n      get: read,\n      plan: Effect.fnUntraced(function* (input: {\n        readonly bucket: string;\n        readonly desired: S3Configuration;\n      }) {\n        yield* decodeRequest(\n          Target,\n          { bucket: input.bucket },\n          \"planConfiguration\",\n          storage.provider,\n        );\n        const desired = structuredClone(yield* validateConfiguration(input.desired));\n        const sections = configurationSections.filter((section) => desired[section] !== undefined);\n        const before = yield* read({ bucket: input.bucket, sections });\n        const changes = before\n          .filter(\n            ({ section, value }) =>\n              configurationState(value) !== configurationState(desiredSection(desired, section)),\n          )\n          .map(({ section, value }) => ({\n            section,\n            before: structuredClone(value),\n            after: structuredClone(desiredSection(desired, section)),\n          }));\n        const plan: ConfigurationPlan = Object.freeze({\n          bucket: input.bucket,\n          changes: Object.freeze(changes),\n          concurrency: \"best-effort\",\n        });\n        issued.set(plan, {\n          bucket: input.bucket,\n          desired,\n          before,\n          snapshot: configurationState(plan),\n        });\n        return plan;\n      }),\n      apply: Effect.fnUntraced(function* (input: {\n        readonly plan: ConfigurationPlan;\n        readonly allowUnconditional: true;\n        readonly protectionChange?: {\n          readonly intent: \"change-storage-protection\";\n          readonly reason: string;\n        };\n      }): Effect.fn.Return<ConfigurationOutcome, StorageError> {\n        const saved = issued.get(input.plan);\n        if (\n          !saved ||\n          configurationState(input.plan) !== saved.snapshot ||\n          consumed.has(input.plan) ||\n          input.allowUnconditional !== true\n        )\n          return yield* storageError(\n            \"applyConfiguration\",\n            storage.provider,\n            { _tag: \"InvalidInput\", field: \"issued-plan-and-concurrency-intent\" },\n            \"not-started\",\n          );\n        if (\n          Object.keys(saved.desired).some((section) =>\n            [\n              \"publicAccess\",\n              \"policy\",\n              \"objectLock\",\n              \"versioning\",\n              \"encryption\",\n              \"lifecycle\",\n            ].includes(section),\n          ) &&\n          (input.protectionChange?.intent !== \"change-storage-protection\" ||\n            !input.protectionChange.reason)\n        )\n          return yield* storageError(\n            \"applyConfiguration\",\n            storage.provider,\n            { _tag: \"InvalidInput\", field: \"protectionChange\" },\n            \"not-started\",\n          );\n        const current = yield* read({\n          bucket: saved.bucket,\n          sections: saved.before.map((entry) => entry.section),\n        });\n        if (configurationState(current) !== configurationState(saved.before))\n          return yield* storageError(\n            \"applyConfiguration\",\n            storage.provider,\n            { _tag: \"PreconditionFailed\" },\n            \"not-started\",\n          );\n        consumed.add(input.plan);\n        const steps: ConfigurationOutcome[\"steps\"][number][] = [];\n        for (const { section, value } of saved.before) {\n          if (\n            configurationState(value) === configurationState(desiredSection(saved.desired, section))\n          )\n            continue;\n          const outcome = yield* Effect.result(\n            putConfiguration(storage, saved.bucket, section, saved.desired),\n          );\n          if (Result.isFailure(outcome)) {\n            steps.push({\n              section,\n              status: outcome.failure.mutationOutcome === \"unknown\" ? \"unknown\" : \"failed\",\n              error: outcome.failure,\n            });\n            break;\n          }\n          const observed = yield* Effect.result(getConfiguration(storage, saved.bucket, section));\n          steps.push({\n            section,\n            status:\n              Result.isSuccess(observed) &&\n              configurationState(observed.success) ===\n                configurationState(desiredSection(saved.desired, section))\n                ? \"applied\"\n                : \"pending\",\n            ...(Result.isFailure(observed) ? { error: observed.failure } : {}),\n          });\n        }\n        return {\n          bucket: saved.bucket,\n          steps,\n          complete:\n            steps.every((step) => step.status === \"applied\") &&\n            steps.length === input.plan.changes.length,\n        };\n      }),\n    },\n  };\n}\nconst make = Effect.fnUntraced(function* (config: S3AdminConfig) {\n  if (!config.credentials)\n    return yield* storageError(\"makeAdministration\", \"s3\", {\n      _tag: \"InvalidConfiguration\",\n      field: \"credentials\",\n    });\n  return makeAdministration(yield* S3Storage.make({ ...config, bucket: \"administration\" }));\n});\nexport type S3AdministrationService = ReturnType<typeof makeAdministration>;\nexport class S3Administration extends Context.Service<S3Administration, S3AdministrationService>()(\n  \"@effect-kit/storage/s3/S3Administration\",\n) {\n  static readonly make = make;\n  static layer(config: S3AdminConfig) {\n    return Layer.effect(S3Administration, make(config));\n  }\n}\n"],"mappings":";;;;;;;;;;AA+BA,MAAM,SAAS,OAAO,OAAO,MAAM,OAAO,UAAU,qCAAqC,CAAC;AAC1F,MAAM,SAAS,OAAO,OAAO,EAAE,QAAQ,OAAO,CAAC;AAoB/C,SAAgB,mBAAmB,SAA2B;CAC5D,MAAM,yBAAS,IAAI,QAQjB;CACF,MAAM,2BAAW,IAAI,QAA2B;CAChD,MAAM,kBACJ,QAAQ,aAAa,QAAQ,QAAQ,aAAa,UAC9C,wBACA,QAAQ,aAAa,WACnB;EAAC;EAAQ;EAAc;EAAa;EAAc;EAAU;CAAa,IACzE,QAAQ,aAAa,WACnB,QAAQ,SAAS,eAAe,SAC9B,CAAC,WAAW,IACZ;EAAC;EAAQ;EAAc;EAAa;CAAQ,IAC9C;EAAC;EAAQ;EAAc;EAAa;EAAc;EAAc;CAAQ;CAClF,MAAM,OAAO,OAAO,WAAW,WAAW,OAGvC;EACD,MAAM,QAAQ,OAAO,cACnB,OAAO,OAAO;GAAE,QAAQ;GAAQ,UAAU,OAAO,MAAM,oBAAoB;EAAE,CAAC,GAC9E,OACA,oBACA,QAAQ,QACV;EACA,IAAI,MAAM,SAAS,MAAM,YAAY,CAAC,gBAAgB,SAAS,OAAO,CAAC,GACrE,OAAO,OAAO,aAAa,oBAAoB,QAAQ,UAAU;GAC/D,MAAM;GACN,YAAY;EACd,CAAC;EACH,OAAO,OAAO,OAAO,QAAQ,MAAM,WAAW,YAC5C,iBAAiB,SAAS,MAAM,QAAQ,OAAO,CAAC,CAAC,KAC/C,OAAO,KAAK,mBAAmB;GAAE;GAAS,OAAO;EAAc,EAAE,CACnE,CACF;CACF,CAAC;CACD,OAAO;EACL,UAAU,OAAO,WAAW,WAC1B,QAA+D,CAAC,GAChE;GACA,MAAM,QAAQ,OAAO,cACnB,OAAO,OAAO;IACZ,QAAQ,OAAO,SAAS,OAAO,cAAc;IAC7C,OAAO,OAAO,SAAS,OAAO,IAAI,MAAM,OAAO,UAAU;KAAE,SAAS;KAAG,SAAS;IAAK,CAAC,CAAC,CAAC;GAC1F,CAAC,GACD,OACA,eACA,QAAQ,QACV;GACA,MAAM,OAAO,OAAO,QAAQ,SAAS,eAAe,QAAQ,WAC1D,QAAQ,OAAO,KACb,IAAI,mBAAmB;IACrB,mBAAmB,MAAM;IACzB,YAAY,MAAM,SAAS;GAC7B,CAAC,GACD,EAAE,aAAa,OAAO,CACxB,CACF;GACA,OAAO;IACL,UAAU,KAAK,WAAW,CAAC,EAAC,CAAE,KAAK,EAAE,MAAM,oBAAoB;KAC7D,MAAM;KACN,WAAW;IACb,EAAE;IACF,QAAQ,KAAK;GACf;EACF,CAAC;EACD,MAAM,OAAO,WAAW,WAAW,OAA2B;GAC5D,MAAM,QAAQ,OAAO,cAAc,QAAQ,OAAO,cAAc,QAAQ,QAAQ;GAChF,MAAM,SAAS,OAAO,QAAQ,SAAS,cAAc,QAAQ,WAC3D,QAAQ,OAAO,KAAK,IAAI,kBAAkB,EAAE,QAAQ,MAAM,OAAO,CAAC,GAAG,EACnE,aAAa,OACf,CAAC,CACH;GACA,OAAO;IAAE,QAAQ,MAAM;IAAQ,QAAQ,OAAO;GAAa;EAC7D,CAAC;EACD,QAAQ,OAAO,WAAW,WAAW,OAIlC;GACD,OAAO,cACL,QACA,EAAE,QAAQ,MAAM,OAAO,GACvB,gBACA,QAAQ,UACR,IACF;GACA,MAAM,SAAS,MAAM,eAAe;GACpC,IACG,UAAU,WAAW,QAAQ,OAAO,UACpC,CAAC,QAAQ,WAAW,QAAQ,OAAO,WAAW,eAAe,CAAC,QAE/D,OAAO,OAAO,aACZ,gBACA,QAAQ,UACR;IAAE,MAAM;IAAgB,OAAO;GAAW,GAC1C,aACF;GACF,OAAO,QAAQ,SAAS,gBAAgB,OAAO,WAC7C,QAAQ,OAAO,KACb,IAAI,oBAAoB;IACtB,QAAQ,MAAM;IACd,GAAI,MAAM,gBAAgB,EAAE,2BAA2B,MAAM,cAAc,IAAI,CAAC;IAChF,GAAI,MAAM,oBAAoB,EAAE,4BAA4B,KAAK,IAAI,CAAC;GACxE,CAAC,GACD,EAAE,aAAa,OAAO,CACxB,CACF;GACA,OAAO;IAAE,MAAM;IAAqB,QAAQ,MAAM;GAAO;EAC3D,CAAC;EAED,aAAa,OAAO,WAAW,WAAW,OAA2B;GACnE,MAAM,QAAQ,OAAO,cAAc,QAAQ,OAAO,gBAAgB,QAAQ,UAAU,IAAI;GACxF,OAAO,QAAQ,SAAS,gBAAgB,OAAO,WAC7C,QAAQ,OAAO,KAAK,IAAI,oBAAoB,EAAE,QAAQ,MAAM,OAAO,CAAC,GAAG,EACrE,aAAa,OACf,CAAC,CACH;EACF,CAAC;EACD,eAAe;GACb,KAAK;GACL,MAAM,OAAO,WAAW,WAAW,OAGhC;IACD,OAAO,cACL,QACA,EAAE,QAAQ,MAAM,OAAO,GACvB,qBACA,QAAQ,QACV;IACA,MAAM,UAAU,gBAAgB,OAAO,sBAAsB,MAAM,OAAO,CAAC;IAC3E,MAAM,WAAW,sBAAsB,QAAQ,YAAY,QAAQ,aAAa,MAAS;IACzF,MAAM,SAAS,OAAO,KAAK;KAAE,QAAQ,MAAM;KAAQ;IAAS,CAAC;IAC7D,MAAM,UAAU,OACb,QACE,EAAE,SAAS,YACV,mBAAmB,KAAK,MAAM,mBAAmB,eAAe,SAAS,OAAO,CAAC,CACrF,CAAC,CACA,KAAK,EAAE,SAAS,aAAa;KAC5B;KACA,QAAQ,gBAAgB,KAAK;KAC7B,OAAO,gBAAgB,eAAe,SAAS,OAAO,CAAC;IACzD,EAAE;IACJ,MAAM,OAA0B,OAAO,OAAO;KAC5C,QAAQ,MAAM;KACd,SAAS,OAAO,OAAO,OAAO;KAC9B,aAAa;IACf,CAAC;IACD,OAAO,IAAI,MAAM;KACf,QAAQ,MAAM;KACd;KACA;KACA,UAAU,mBAAmB,IAAI;IACnC,CAAC;IACD,OAAO;GACT,CAAC;GACD,OAAO,OAAO,WAAW,WAAW,OAOqB;IACvD,MAAM,QAAQ,OAAO,IAAI,MAAM,IAAI;IACnC,IACE,CAAC,SACD,mBAAmB,MAAM,IAAI,MAAM,MAAM,YACzC,SAAS,IAAI,MAAM,IAAI,KACvB,MAAM,uBAAuB,MAE7B,OAAO,OAAO,aACZ,sBACA,QAAQ,UACR;KAAE,MAAM;KAAgB,OAAO;IAAqC,GACpE,aACF;IACF,IACE,OAAO,KAAK,MAAM,OAAO,CAAC,CAAC,MAAM,YAC/B;KACE;KACA;KACA;KACA;KACA;KACA;IACF,CAAC,CAAC,SAAS,OAAO,CACpB,MACC,MAAM,kBAAkB,WAAW,+BAClC,CAAC,MAAM,iBAAiB,SAE1B,OAAO,OAAO,aACZ,sBACA,QAAQ,UACR;KAAE,MAAM;KAAgB,OAAO;IAAmB,GAClD,aACF;IACF,MAAM,UAAU,OAAO,KAAK;KAC1B,QAAQ,MAAM;KACd,UAAU,MAAM,OAAO,KAAK,UAAU,MAAM,OAAO;IACrD,CAAC;IACD,IAAI,mBAAmB,OAAO,MAAM,mBAAmB,MAAM,MAAM,GACjE,OAAO,OAAO,aACZ,sBACA,QAAQ,UACR,EAAE,MAAM,qBAAqB,GAC7B,aACF;IACF,SAAS,IAAI,MAAM,IAAI;IACvB,MAAM,QAAiD,CAAC;IACxD,KAAK,MAAM,EAAE,SAAS,WAAW,MAAM,QAAQ;KAC7C,IACE,mBAAmB,KAAK,MAAM,mBAAmB,eAAe,MAAM,SAAS,OAAO,CAAC,GAEvF;KACF,MAAM,UAAU,OAAO,OAAO,OAC5B,iBAAiB,SAAS,MAAM,QAAQ,SAAS,MAAM,OAAO,CAChE;KACA,IAAI,OAAO,UAAU,OAAO,GAAG;MAC7B,MAAM,KAAK;OACT;OACA,QAAQ,QAAQ,QAAQ,oBAAoB,YAAY,YAAY;OACpE,OAAO,QAAQ;MACjB,CAAC;MACD;KACF;KACA,MAAM,WAAW,OAAO,OAAO,OAAO,iBAAiB,SAAS,MAAM,QAAQ,OAAO,CAAC;KACtF,MAAM,KAAK;MACT;MACA,QACE,OAAO,UAAU,QAAQ,KACzB,mBAAmB,SAAS,OAAO,MACjC,mBAAmB,eAAe,MAAM,SAAS,OAAO,CAAC,IACvD,YACA;MACN,GAAI,OAAO,UAAU,QAAQ,IAAI,EAAE,OAAO,SAAS,QAAQ,IAAI,CAAC;KAClE,CAAC;IACH;IACA,OAAO;KACL,QAAQ,MAAM;KACd;KACA,UACE,MAAM,OAAO,SAAS,KAAK,WAAW,SAAS,KAC/C,MAAM,WAAW,MAAM,KAAK,QAAQ;IACxC;GACF,CAAC;EACH;CACF;AACF;AACA,MAAM,OAAO,OAAO,WAAW,WAAW,QAAuB;CAC/D,IAAI,CAAC,OAAO,aACV,OAAO,OAAO,aAAa,sBAAsB,MAAM;EACrD,MAAM;EACN,OAAO;CACT,CAAC;CACH,OAAO,mBAAmB,OAAO,UAAU,KAAK;EAAE,GAAG;EAAQ,QAAQ;CAAiB,CAAC,CAAC;AAC1F,CAAC;AAED,IAAa,mBAAb,MAAa,yBAAyB,QAAQ,QAAmD,CAAC,CAChG,yCACF,CAAC,CAAC;CACA,OAAgB,OAAO;CACvB,OAAO,MAAM,QAAuB;EAClC,OAAO,MAAM,OAAO,kBAAkB,KAAK,MAAM,CAAC;CACpD;AACF"}

package/dist/s3/archive.d.ts

@@ -0,0 +1,25 @@
+import { ArchiveService } from "../lifecycle.js";
+import { S3Storage, S3StorageService } from "../s3.js";
+import { S3StorageTier } from "../providers/s3/tier.js";
+import { Context, Layer, Schema } from "effect";
+declare const Options: Schema.Union<readonly [Schema.Struct<{
+  readonly days: Schema.Int;
+  readonly tier: Schema.Literals<readonly ["Standard", "Bulk", "Expedited"]>;
+}>, Schema.Struct<{
+  readonly storage: Schema.Literal<"intelligent-tiering">;
+  readonly tier: Schema.Literals<readonly ["Standard", "Bulk", "Expedited"]>;
+}>]>;
+export type S3RestoreOptions = typeof Options.Type;
+declare const S3Archive_base: Context.ServiceClass<S3Archive, "@effect-kit/storage/s3/S3Archive", ArchiveService<{
+  readonly days: number;
+  readonly tier: "Bulk" | "Expedited" | "Standard";
+} | {
+  readonly storage: "intelligent-tiering";
+  readonly tier: "Bulk" | "Expedited" | "Standard";
+}>>;
+export declare class S3Archive extends S3Archive_base {
+  static make(storage: S3StorageService): ArchiveService<S3RestoreOptions>;
+  static readonly layer: Layer.Layer<S3Archive, never, S3Storage>;
+}
+export { S3StorageTier };
+//# sourceMappingURL=archive.d.ts.map

package/dist/s3/archive.js

@@ -0,0 +1,113 @@
+import { ObjectRef } from "../core/object.js";
+import { storageError } from "../core/errors.js";
+import { decodeRequest } from "../internal/request-validation.js";
+import { readEncryption } from "../providers/s3/config.js";
+import { request } from "../providers/s3/transport.js";
+import { S3Storage } from "../s3.js";
+import { lifecycleFeature, lifecycleTarget } from "../providers/s3/lifecycle-validation.js";
+import { S3StorageTier } from "../providers/s3/tier.js";
+import { Context, DateTime, Duration, Effect, Layer, Schema } from "effect";
+import { HeadObjectCommand, RestoreObjectCommand } from "@aws-sdk/client-s3";
+
+// src/providers/s3/archive.ts
+const Options = Schema.Union([Schema.Struct({
+	days: Schema.Int.check(Schema.isBetween({
+		minimum: 1,
+		maximum: 365
+	})),
+	tier: Schema.Literals([
+		"Standard",
+		"Bulk",
+		"Expedited"
+	])
+}), Schema.Struct({
+	storage: Schema.Literal("intelligent-tiering"),
+	tier: Schema.Literals([
+		"Standard",
+		"Bulk",
+		"Expedited"
+	])
+})]);
+var S3Archive = class S3Archive extends Context.Service()("@effect-kit/storage/s3/S3Archive") {
+	static make(storage) {
+		const restoreStatus = Effect.fnUntraced(function* (input) {
+			const { ref } = yield* decodeRequest(Schema.Struct({ ref: ObjectRef }), input, "restoreStatus", storage.provider);
+			yield* lifecycleFeature(storage, "archive");
+			const target = yield* lifecycleTarget(storage, ref, "restoreStatus");
+			const result = yield* request(storage, "restoreStatus", false, (signal) => storage.client.send(new HeadObjectCommand({
+				...target,
+				...readEncryption(storage.config.encryption)
+			}), { abortSignal: signal }));
+			if (result.Restore?.includes("ongoing-request=\"true\"")) return { _tag: "Pending" };
+			const expiry = /expiry-date="([^"]+)"/u.exec(result.Restore ?? "")?.[1];
+			if (expiry) {
+				const parsed = Date.parse(expiry);
+				if (!Number.isFinite(parsed)) return yield* storageError("restoreStatus", storage.provider, {
+					_tag: "ProviderFailure",
+					code: "InvalidRestoreDate"
+				});
+				return {
+					_tag: "Ready",
+					availableUntil: DateTime.makeUnsafe(parsed)
+				};
+			}
+			return { _tag: ["GLACIER", "DEEP_ARCHIVE"].includes(result.StorageClass ?? "") || result.ArchiveStatus ? "Archived" : "Ready" };
+		});
+		return {
+			restoreStatus,
+			requestRestore: Effect.fnUntraced(function* (input) {
+				const value = yield* decodeRequest(Schema.Struct({
+					ref: ObjectRef,
+					options: Options
+				}), input, "requestRestore", storage.provider, true);
+				yield* lifecycleFeature(storage, "archive");
+				if (storage.provider === "tigris" && (!("days" in value.options) || value.options.tier !== "Standard")) return yield* storageError("requestRestore", "tigris", {
+					_tag: "Unsupported",
+					capability: "aws-restore-tier-options"
+				}, "not-started");
+				const target = yield* lifecycleTarget(storage, value.ref, "requestRestore");
+				yield* request(storage, "requestRestore", true, (signal) => storage.client.send(new RestoreObjectCommand({
+					...target,
+					RestoreRequest: storage.provider === "tigris" && "days" in value.options ? { Days: value.options.days } : "days" in value.options ? {
+						Days: value.options.days,
+						GlacierJobParameters: { Tier: value.options.tier }
+					} : { Tier: value.options.tier }
+				}), { abortSignal: signal }));
+				return { _tag: "Pending" };
+			}),
+			awaitReady: Effect.fnUntraced(function* (input) {
+				const polling = yield* Effect.try({
+					try: () => ({
+						timeout: Duration.fromInputUnsafe(input.timeout),
+						interval: Duration.fromInputUnsafe(input.pollInterval)
+					}),
+					catch: () => storageError("awaitRestore", storage.provider, {
+						_tag: "InvalidInput",
+						field: "polling"
+					})
+				});
+				if (!Duration.isFinite(polling.timeout) || !Duration.isFinite(polling.interval) || Duration.toMillis(polling.timeout) <= 0 || Duration.toMillis(polling.interval) <= 0) return yield* storageError("awaitRestore", storage.provider, {
+					_tag: "InvalidInput",
+					field: "polling"
+				});
+				return yield* Effect.gen(function* () {
+					while (true) {
+						const state = yield* restoreStatus({ ref: input.ref });
+						if (state._tag === "Ready") return state;
+						yield* Effect.sleep(input.pollInterval);
+					}
+				}).pipe(Effect.timeoutOrElse({
+					duration: input.timeout,
+					orElse: () => Effect.fail(storageError("awaitRestore", storage.provider, {
+						_tag: "TransportFailure",
+						code: "DeadlineExceeded"
+					}))
+				}));
+			})
+		};
+	}
+	static layer = Layer.effect(S3Archive, Effect.map(S3Storage, S3Archive.make));
+};
+
+export { S3Archive, S3StorageTier };
+//# sourceMappingURL=archive.js.map

package/dist/s3/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","names":[],"sources":["../../src/providers/s3/archive.ts"],"sourcesContent":["import { Context, DateTime, Duration, Effect, Layer, Schema } from \"effect\";\n\nimport { HeadObjectCommand, RestoreObjectCommand } from \"@aws-sdk/client-s3\";\n\nimport { storageError } from \"../../core/errors.js\";\nimport { ObjectRef } from \"../../core/object.js\";\nimport { decodeRequest } from \"../../internal/request-validation.js\";\nimport type { ArchiveService, RestoreStatus } from \"../../lifecycle/index.js\";\nimport { readEncryption } from \"./config.js\";\nimport { S3Storage } from \"./index.js\";\nimport type { S3StorageService } from \"./index.js\";\nimport { lifecycleFeature, lifecycleTarget } from \"./lifecycle-validation.js\";\nimport { request } from \"./transport.js\";\n\nconst Options = Schema.Union([\n  Schema.Struct({\n    days: Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 365 })),\n    tier: Schema.Literals([\"Standard\", \"Bulk\", \"Expedited\"]),\n  }),\n  Schema.Struct({\n    storage: Schema.Literal(\"intelligent-tiering\"),\n    tier: Schema.Literals([\"Standard\", \"Bulk\", \"Expedited\"]),\n  }),\n]);\nexport type S3RestoreOptions = typeof Options.Type;\nexport class S3Archive extends Context.Service<S3Archive, ArchiveService<S3RestoreOptions>>()(\n  \"@effect-kit/storage/s3/S3Archive\",\n) {\n  static make(storage: S3StorageService): ArchiveService<S3RestoreOptions> {\n    const restoreStatus = Effect.fnUntraced(function* (input: {\n      readonly ref: ObjectRef;\n    }): Effect.fn.Return<RestoreStatus, ReturnType<typeof storageError>> {\n      const { ref } = yield* decodeRequest(\n        Schema.Struct({ ref: ObjectRef }),\n        input,\n        \"restoreStatus\",\n        storage.provider,\n      );\n      yield* lifecycleFeature(storage, \"archive\");\n      const target = yield* lifecycleTarget(storage, ref, \"restoreStatus\");\n      const result = yield* request(storage, \"restoreStatus\", false, (signal) =>\n        storage.client.send(\n          new HeadObjectCommand({ ...target, ...readEncryption(storage.config.encryption) }),\n          { abortSignal: signal },\n        ),\n      );\n      if (result.Restore?.includes('ongoing-request=\"true\"')) return { _tag: \"Pending\" };\n      const expiry = /expiry-date=\"([^\"]+)\"/u.exec(result.Restore ?? \"\")?.[1];\n      if (expiry) {\n        const parsed = Date.parse(expiry);\n        if (!Number.isFinite(parsed))\n          return yield* storageError(\"restoreStatus\", storage.provider, {\n            _tag: \"ProviderFailure\",\n            code: \"InvalidRestoreDate\",\n          });\n        return { _tag: \"Ready\", availableUntil: DateTime.makeUnsafe(parsed) };\n      }\n      return {\n        _tag:\n          [\"GLACIER\", \"DEEP_ARCHIVE\"].includes(result.StorageClass ?? \"\") || result.ArchiveStatus\n            ? \"Archived\"\n            : \"Ready\",\n      };\n    });\n    return {\n      restoreStatus,\n      requestRestore: Effect.fnUntraced(function* (input) {\n        const value = yield* decodeRequest(\n          Schema.Struct({ ref: ObjectRef, options: Options }),\n          input,\n          \"requestRestore\",\n          storage.provider,\n          true,\n        );\n        yield* lifecycleFeature(storage, \"archive\");\n        if (\n          storage.provider === \"tigris\" &&\n          (!(\"days\" in value.options) || value.options.tier !== \"Standard\")\n        )\n          return yield* storageError(\n            \"requestRestore\",\n            \"tigris\",\n            { _tag: \"Unsupported\", capability: \"aws-restore-tier-options\" },\n            \"not-started\",\n          );\n        const target = yield* lifecycleTarget(storage, value.ref, \"requestRestore\");\n        yield* request(storage, \"requestRestore\", true, (signal) =>\n          storage.client.send(\n            new RestoreObjectCommand({\n              ...target,\n              RestoreRequest:\n                storage.provider === \"tigris\" && \"days\" in value.options\n                  ? { Days: value.options.days }\n                  : \"days\" in value.options\n                    ? {\n                        Days: value.options.days,\n                        GlacierJobParameters: { Tier: value.options.tier },\n                      }\n                    : { Tier: value.options.tier },\n            }),\n            { abortSignal: signal },\n          ),\n        );\n        return { _tag: \"Pending\" as const };\n      }),\n      awaitReady: Effect.fnUntraced(function* (input) {\n        const polling = yield* Effect.try({\n          try: () => ({\n            timeout: Duration.fromInputUnsafe(input.timeout),\n            interval: Duration.fromInputUnsafe(input.pollInterval),\n          }),\n          catch: () =>\n            storageError(\"awaitRestore\", storage.provider, {\n              _tag: \"InvalidInput\",\n              field: \"polling\",\n            }),\n        });\n        if (\n          !Duration.isFinite(polling.timeout) ||\n          !Duration.isFinite(polling.interval) ||\n          Duration.toMillis(polling.timeout) <= 0 ||\n          Duration.toMillis(polling.interval) <= 0\n        )\n          return yield* storageError(\"awaitRestore\", storage.provider, {\n            _tag: \"InvalidInput\",\n            field: \"polling\",\n          });\n        return yield* Effect.gen(function* () {\n          while (true) {\n            const state = yield* restoreStatus({ ref: input.ref });\n            if (state._tag === \"Ready\") return state;\n            yield* Effect.sleep(input.pollInterval);\n          }\n        }).pipe(\n          Effect.timeoutOrElse({\n            duration: input.timeout,\n            orElse: () =>\n              Effect.fail(\n                storageError(\"awaitRestore\", storage.provider, {\n                  _tag: \"TransportFailure\",\n                  code: \"DeadlineExceeded\",\n                }),\n              ),\n          }),\n        );\n      }),\n    };\n  }\n  static readonly layer = Layer.effect(S3Archive, Effect.map(S3Storage, S3Archive.make));\n}\n\nexport { S3StorageTier } from \"./tier.js\";\n"],"mappings":"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"}

package/dist/s3/events.d.ts

@@ -0,0 +1,42 @@
+import { StorageError } from "../core/errors.js";
+import "../index.js";
+import { Effect, Redacted } from "effect";
+export declare namespace S3Events {
+  const decode: (payload: unknown, options: {
+    readonly bucket: string;
+    readonly storeId: string;
+    readonly provider?: string;
+    readonly messageId?: string;
+  }) => Effect.Effect<{
+    readonly provider: string;
+    readonly kind: "delete-marker-created" | "metadata-updated" | "object-created" | "object-deleted" | "other" | "restore-completed" | "version-archived";
+    readonly ref: {
+      readonly storeId: string;
+      readonly key: string;
+      readonly version?: {
+        readonly _tag: "S3Version";
+        readonly id: string;
+      } | {
+        readonly _tag: "GcsGeneration";
+        readonly id: string;
+        readonly metageneration?: string | undefined;
+      } | {
+        readonly _tag: "AzureVersion";
+        readonly id: string;
+      } | {
+        readonly _tag: "AzureSnapshot";
+        readonly id: string;
+      } | {
+        readonly _tag: "OpaqueVersion";
+        readonly provider: string;
+        readonly id: string;
+      } | undefined;
+    };
+    readonly occurredAt: import("effect/DateTime").Utc;
+    readonly id?: string | undefined;
+    readonly sequencer?: string | undefined;
+    readonly nativeType: string;
+    readonly native?: Redacted.Redacted<unknown> | undefined;
+  }[], StorageError, never>;
+}
+//# sourceMappingURL=events.d.ts.map