@effect-kit/storage 0.0.0-stage → 0.1.0

package/dist/sessions/upload.js

@@ -0,0 +1,329 @@
+import { StorageError } from "../core/errors.js";
+import { makeReader, sameChecksum } from "../transfers/reader.js";
+import { download } from "../transfers/download.js";
+import { partReceipt } from "../transfers/part-receipts.js";
+import { planUpload } from "../transfers/planner.js";
+import { operationMetadataKey } from "../transfers/upload.js";
+import { sessionError } from "./store.js";
+import { abortNativeUpload, decodeNativeHandle, runNativeUpload } from "./native-upload.js";
+import { Effect } from "effect";
+
+// src/sessions/upload.ts
+const fingerprint = Effect.fnUntraced(function* (environment, source, partBytes) {
+	if (!source.replayable || source.length === void 0) return yield* sessionError("ReplayableKnownSourceRequired");
+	const { runtime } = environment;
+	return yield* Effect.scoped(Effect.gen(function* () {
+		const reader = yield* makeReader(source, {
+			maximumBytes: runtime.policy.maxBytes,
+			maximumChunkBytes: runtime.policy.maxSourceChunkBytes,
+			digest: runtime.input.digest,
+			onRead: () => {}
+		});
+		while ((yield* reader.next(partBytes)) !== void 0);
+		const checksum = reader.checksum();
+		if (!checksum) return yield* sessionError("FingerprintMissing");
+		return checksum;
+	}));
+});
+const runUpload = Effect.fnUntraced(function* (environment, original, source) {
+	if (original.protocol) return yield* runNativeUpload(environment, original, source);
+	const { runtime, store } = environment;
+	if (original.state === "completed") {
+		if (!original.metadata) return yield* sessionError("MissingCompletionReceipt");
+		return original.metadata;
+	}
+	const codec = runtime.endpoint.handles;
+	if (!codec) return yield* sessionError("DurableUploadUnsupported");
+	const multipart = runtime.endpoint.multipart;
+	if (!multipart) return yield* sessionError("MultipartRequired");
+	let checkpoint = original;
+	const operation = yield* runtime.begin("upload", checkpoint.length);
+	operation.progress.attempts = checkpoint.attempts;
+	operation.committed = checkpoint.state === "verifying";
+	const plan = yield* planUpload(runtime.endpoint, runtime.policy, checkpoint.length, runtime.input.digest.workspaceBytes * 2 + (source.workspaceBytes ?? 0), "multipart", false, checkpoint.condition);
+	if (plan.partBytes !== checkpoint.partBytes) return yield* sessionError("ChangedTransferPolicy");
+	const save = Effect.fnUntraced(function* (next) {
+		const saved = yield* store.write(next, checkpoint.revision);
+		if (saved.kind !== "upload") return yield* sessionError("InvalidCheckpoint");
+		checkpoint = saved;
+	});
+	const call = (effect) => Effect.gen(function* () {
+		if (checkpoint.attempts >= runtime.policy.maxAttempts) return yield* sessionError("SessionAttemptLimit");
+		yield* save({
+			...checkpoint,
+			attempts: checkpoint.attempts + 1
+		});
+		return yield* operation.request(effect);
+	});
+	const verification = {
+		...operation,
+		request: (effect) => Effect.gen(function* () {
+			if (checkpoint.attempts >= runtime.policy.maxAttempts) return yield* sessionError("SessionAttemptLimit");
+			yield* save({
+				...checkpoint,
+				attempts: checkpoint.attempts + 1
+			});
+			return yield* operation.request(effect);
+		})
+	};
+	const work = runtime.lease(plan.workspaceBytes, Effect.scoped(Effect.gen(function* () {
+		if ([
+			"aborting",
+			"cleanup-pending",
+			"aborted"
+		].includes(checkpoint.state)) return yield* sessionError("SessionAborting");
+		if ([
+			"initiating",
+			"completing",
+			"completion-unknown"
+		].includes(checkpoint.state)) return yield* sessionError("ReconciliationRequired", true);
+		if (checkpoint.state !== "verifying" && (source.length !== checkpoint.length || !sameChecksum(yield* fingerprint(environment, source, checkpoint.partBytes), checkpoint.checksum))) return yield* sessionError("ChangedSource");
+		if (checkpoint.state === "created") {
+			yield* save({
+				...checkpoint,
+				state: "initiating"
+			});
+			const handle = yield* call(multipart.initiate({
+				key: checkpoint.key,
+				headers: {
+					...checkpoint.headers,
+					customMetadata: {
+						...checkpoint.headers.customMetadata,
+						[operationMetadataKey]: checkpoint.operationId
+					}
+				}
+			}));
+			yield* save({
+				...checkpoint,
+				handle: yield* codec.encode(handle),
+				state: "uploading"
+			});
+		}
+		if (!checkpoint.handle) return yield* sessionError("MissingHandle");
+		const handle = yield* codec.decode(checkpoint.handle);
+		if (handle.ref.storeId !== runtime.endpoint.storage.storeId || handle.ref.key !== checkpoint.key) return yield* sessionError("ForeignHandle");
+		if (checkpoint.state === "uploading") {
+			const observed = /* @__PURE__ */ new Map();
+			const cursors = /* @__PURE__ */ new Set();
+			let cursor;
+			do {
+				const page = yield* call(multipart.listParts({
+					upload: handle,
+					...cursor ? { cursor } : {}
+				}));
+				for (const part of page.parts) {
+					if (observed.has(part.partNumber) || observed.size >= multipart.limits.maximumParts) return yield* sessionError("InvalidPartInventory");
+					observed.set(part.partNumber, part);
+				}
+				cursor = page.cursor;
+				if (cursor && cursors.has(cursor)) return yield* sessionError("RepeatedPartCursor");
+				if (cursor) cursors.add(cursor);
+			} while (cursor);
+			const reader = yield* makeReader(source, {
+				maximumBytes: runtime.policy.maxBytes,
+				maximumChunkBytes: runtime.policy.maxSourceChunkBytes,
+				digest: runtime.input.digest,
+				onRead: () => {}
+			});
+			let number = 0;
+			while (true) {
+				const chunk = yield* reader.next(checkpoint.partBytes);
+				if (!chunk && number > 0) break;
+				const body = chunk ?? /* @__PURE__ */ new Uint8Array();
+				number++;
+				const saved = checkpoint.parts.find((part) => part.partNumber === number);
+				const remote = observed.get(number);
+				const partHash = runtime.input.digest.create();
+				partHash.update(body);
+				const sourceChecksum = partHash.finish();
+				if (!saved || !sameChecksum(sourceChecksum, saved.sourceChecksum) || remote?.etag !== saved.etag || remote.size !== saved.size) {
+					const receipt = yield* partReceipt(yield* call(multipart.uploadPart({
+						upload: handle,
+						partNumber: number,
+						body,
+						contentLength: body.length
+					})), number, body.length, runtime.endpoint.storage.provider);
+					yield* save({
+						...checkpoint,
+						parts: [...checkpoint.parts.filter((part) => part.partNumber !== number), {
+							...receipt,
+							sourceChecksum
+						}].toSorted((a, b) => a.partNumber - b.partNumber)
+					});
+				}
+				if (!chunk) break;
+			}
+			const checksum = reader.checksum();
+			if (!checksum || !sameChecksum(checksum, checkpoint.checksum)) return yield* sessionError("ChangedSource");
+			if (checkpoint.attempts + 3 > runtime.policy.maxAttempts) return yield* sessionError("SessionAttemptLimit");
+			yield* save({
+				...checkpoint,
+				state: "completing"
+			});
+			const metadata = yield* call(Effect.suspend(() => {
+				operation.mutationStarted = true;
+				return multipart.complete({
+					upload: handle,
+					parts: checkpoint.parts.map(({ sourceChecksum: _sourceChecksum, ...part }) => part),
+					...checkpoint.condition ? { condition: checkpoint.condition } : {}
+				});
+			})).pipe(Effect.catch((error) => Effect.gen(function* () {
+				if (error.mutationOutcome === "rejected") {
+					operation.mutationStarted = false;
+					yield* save({
+						...checkpoint,
+						state: "uploading"
+					}).pipe(Effect.result);
+				}
+				return yield* error;
+			})));
+			operation.committed = true;
+			yield* save({
+				...checkpoint,
+				metadata,
+				state: "verifying"
+			});
+		}
+		if (!checkpoint.metadata) return yield* sessionError("MissingCompletionReceipt");
+		return checkpoint.metadata;
+	})));
+	return yield* runtime.deadline(verification, Effect.gen(function* () {
+		const metadata = yield* work;
+		if (!metadata) return yield* sessionError("MissingCompletionReceipt");
+		if (checkpoint.state !== "completed") {
+			const verified = yield* download(runtime, {
+				ref: metadata.ref,
+				expectedChecksum: checkpoint.checksum,
+				target: { write: () => Effect.void }
+			}, operation);
+			yield* save({
+				...checkpoint,
+				state: "completed",
+				metadata: verified.metadata,
+				events: [{
+					id: `${checkpoint.operationId}:completed`,
+					kind: "completed",
+					delivered: false
+				}]
+			});
+		}
+		return checkpoint.metadata ?? metadata;
+	})).pipe(Effect.mapError((error) => error instanceof StorageError && operation.committed ? new StorageError({
+		operation: error.operation,
+		provider: error.provider,
+		reason: error.reason,
+		requestId: error.requestId,
+		mutationOutcome: "succeeded"
+	}) : error));
+});
+const reconcileUpload = Effect.fnUntraced(function* (environment, original) {
+	const { runtime, store } = environment;
+	if (![
+		"initiating",
+		"completing",
+		"completion-unknown"
+	].includes(original.state)) return original;
+	if (original.protocol === "offset" && original.handle && runtime.endpoint.offsets) {
+		const handle = yield* decodeNativeHandle(original.handle);
+		if (handle.ref.storeId !== runtime.endpoint.storage.storeId || handle.ref.key !== original.key) return yield* sessionError("ForeignHandle");
+		const remote = yield* runtime.cleanupRequest(runtime.endpoint.offsets.query(handle)).pipe(Effect.timeoutOrElse({
+			duration: runtime.policy.cleanupTimeoutMillis,
+			orElse: () => Effect.fail(sessionError("ReconciliationTimeout", true))
+		}));
+		if (remote._tag === "Completed") {
+			const metadata = runtime.endpoint.offsets.resolveCompletion ? yield* runtime.cleanupRequest(runtime.endpoint.offsets.resolveCompletion(handle)).pipe(Effect.timeoutOrElse({
+				duration: runtime.policy.cleanupTimeoutMillis,
+				orElse: () => Effect.fail(sessionError("ReconciliationTimeout", true))
+			})) : remote.metadata;
+			return yield* store.write({
+				...original,
+				state: "verifying",
+				metadata
+			}, original.revision);
+		}
+		if (remote._tag === "Uploading") return yield* store.write({
+			...original,
+			state: "uploading",
+			offset: remote.committedOffset
+		}, original.revision);
+		if (remote._tag !== "Expired" || !runtime.endpoint.reconcile) return yield* sessionError(remote._tag === "Expired" ? "SessionExpired" : "ReconciliationRequired", true);
+	}
+	if (original.state === "initiating" || !runtime.endpoint.reconcile) return yield* sessionError("OrphanDiscoveryRequired", true);
+	const metadata = yield* runtime.cleanupRequest(runtime.endpoint.reconcile({
+		key: original.key,
+		operationId: original.operationId,
+		size: original.length
+	})).pipe(Effect.timeoutOrElse({
+		duration: runtime.policy.cleanupTimeoutMillis,
+		orElse: () => Effect.fail(sessionError("ReconciliationTimeout", true))
+	}));
+	const next = metadata ? {
+		...original,
+		state: "verifying",
+		metadata
+	} : {
+		...original,
+		state: "completion-unknown"
+	};
+	return yield* store.write(next, original.revision);
+});
+const abortUpload = Effect.fnUntraced(function* (environment, original) {
+	if (original.protocol) return yield* abortNativeUpload(environment, original);
+	const { runtime, store } = environment;
+	if (original.state === "aborted") return;
+	if ([
+		"completed",
+		"verifying",
+		"completing",
+		"completion-unknown",
+		"initiating"
+	].includes(original.state)) return yield* sessionError("ReconciliationRequired", true);
+	let checkpoint = yield* store.write({
+		...original,
+		state: "aborting"
+	}, original.revision);
+	if (checkpoint.kind !== "upload") return yield* sessionError("InvalidCheckpoint");
+	if (checkpoint.handle) {
+		const codec = runtime.endpoint.handles;
+		if (!codec) return yield* sessionError("DurableUploadUnsupported");
+		const multipart = runtime.endpoint.multipart;
+		if (!multipart) return yield* sessionError("MultipartRequired");
+		const handle = yield* codec.decode(checkpoint.handle);
+		if (handle.ref.storeId !== runtime.endpoint.storage.storeId || handle.ref.key !== checkpoint.key) return yield* sessionError("ForeignHandle");
+		if (original.state === "aborting" || original.state === "cleanup-pending") {
+			const inventory = yield* runtime.cleanupRequest(multipart.listParts({ upload: handle })).pipe(Effect.timeout(runtime.policy.cleanupTimeoutMillis), Effect.result);
+			if (inventory._tag === "Failure" && inventory.failure._tag === "StorageError" && inventory.failure.reason._tag === "InvalidSession") {
+				yield* store.write({
+					...checkpoint,
+					state: "aborted",
+					events: [{
+						id: `${checkpoint.operationId}:aborted`,
+						kind: "aborted",
+						delivered: false
+					}]
+				}, checkpoint.revision);
+				return;
+			}
+		}
+		const result = yield* runtime.cleanupRequest(multipart.abort(handle)).pipe(Effect.timeout(runtime.policy.cleanupTimeoutMillis), Effect.result);
+		if (result._tag === "Failure") {
+			yield* store.write({
+				...checkpoint,
+				state: "cleanup-pending"
+			}, checkpoint.revision);
+			return yield* result.failure._tag === "StorageError" ? result.failure : sessionError("CleanupPending", true);
+		}
+	}
+	checkpoint = yield* store.write({
+		...checkpoint,
+		state: "aborted",
+		events: [{
+			id: `${checkpoint.operationId}:aborted`,
+			kind: "aborted",
+			delivered: false
+		}]
+	}, checkpoint.revision);
+});
+
+export { abortUpload, fingerprint, reconcileUpload, runUpload };
+//# sourceMappingURL=upload.js.map

package/dist/sessions/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.js","names":[],"sources":["../../src/sessions/upload.ts"],"sourcesContent":["import { Effect } from \"effect\";\n\nimport { StorageError } from \"../core/errors.js\";\nimport { download } from \"../transfers/download.js\";\nimport { partReceipt } from \"../transfers/part-receipts.js\";\nimport { planUpload } from \"../transfers/planner.js\";\nimport { makeReader, sameChecksum } from \"../transfers/reader.js\";\nimport type { TransferRuntime } from \"../transfers/runtime.js\";\nimport type { UploadSource } from \"../transfers/sources.js\";\nimport { operationMetadataKey } from \"../transfers/upload.js\";\nimport type { UploadCheckpoint } from \"./checkpoint.js\";\nimport { abortNativeUpload, runNativeUpload, decodeNativeHandle } from \"./native-upload.js\";\nimport type { UploadSessionStore } from \"./store.js\";\nimport { sessionError } from \"./store.js\";\n\nexport interface SessionOptions {\n  readonly configurationId: string;\n  readonly expiresInMillis?: number;\n}\nexport interface UploadEnvironment {\n  readonly runtime: TransferRuntime;\n  readonly store: UploadSessionStore[\"Service\"];\n  readonly options: SessionOptions;\n}\n\nexport const fingerprint = Effect.fnUntraced(function* <E, R>(\n  environment: UploadEnvironment,\n  source: UploadSource<E, R>,\n  partBytes: number,\n) {\n  if (!source.replayable || source.length === undefined)\n    return yield* sessionError(\"ReplayableKnownSourceRequired\");\n  const { runtime } = environment;\n  return yield* Effect.scoped(\n    Effect.gen(function* () {\n      const reader = yield* makeReader(source, {\n        maximumBytes: runtime.policy.maxBytes,\n        maximumChunkBytes: runtime.policy.maxSourceChunkBytes,\n        digest: runtime.input.digest,\n        onRead: () => {},\n      });\n      while ((yield* reader.next(partBytes)) !== undefined) {\n        /* Hash in source order. */\n      }\n      const checksum = reader.checksum();\n      if (!checksum) return yield* sessionError(\"FingerprintMissing\");\n      return checksum;\n    }),\n  );\n});\n\nexport const runUpload = Effect.fnUntraced(function* <E, R>(\n  environment: UploadEnvironment,\n  original: UploadCheckpoint,\n  source: UploadSource<E, R>,\n) {\n  if (original.protocol) return yield* runNativeUpload(environment, original, source);\n  const { runtime, store } = environment;\n  if (original.state === \"completed\") {\n    if (!original.metadata) return yield* sessionError(\"MissingCompletionReceipt\");\n    return original.metadata;\n  }\n  const codec = runtime.endpoint.handles;\n  if (!codec) return yield* sessionError(\"DurableUploadUnsupported\");\n  const multipart = runtime.endpoint.multipart;\n  if (!multipart) return yield* sessionError(\"MultipartRequired\");\n  let checkpoint = original;\n  const operation = yield* runtime.begin(\"upload\", checkpoint.length);\n  operation.progress.attempts = checkpoint.attempts;\n  operation.committed = checkpoint.state === \"verifying\";\n  const plan = yield* planUpload(\n    runtime.endpoint,\n    runtime.policy,\n    checkpoint.length,\n    runtime.input.digest.workspaceBytes * 2 + (source.workspaceBytes ?? 0),\n    \"multipart\",\n    false,\n    checkpoint.condition,\n  );\n  if (plan.partBytes !== checkpoint.partBytes) return yield* sessionError(\"ChangedTransferPolicy\");\n  const save = Effect.fnUntraced(function* (next: UploadCheckpoint) {\n    const saved = yield* store.write(next, checkpoint.revision);\n    if (saved.kind !== \"upload\") return yield* sessionError(\"InvalidCheckpoint\");\n    checkpoint = saved;\n  });\n  const call = <A>(effect: Effect.Effect<A, StorageError>) =>\n    Effect.gen(function* () {\n      if (checkpoint.attempts >= runtime.policy.maxAttempts)\n        return yield* sessionError(\"SessionAttemptLimit\");\n      yield* save({ ...checkpoint, attempts: checkpoint.attempts + 1 });\n      return yield* operation.request(effect);\n    });\n  const verification = {\n    ...operation,\n    request: <A, EX = never, RX = never>(effect: Effect.Effect<A, StorageError | EX, RX>) =>\n      Effect.gen(function* () {\n        if (checkpoint.attempts >= runtime.policy.maxAttempts)\n          return yield* sessionError(\"SessionAttemptLimit\");\n        yield* save({ ...checkpoint, attempts: checkpoint.attempts + 1 });\n        return yield* operation.request(effect);\n      }),\n  };\n  const work = runtime.lease(\n    plan.workspaceBytes,\n    Effect.scoped(\n      Effect.gen(function* () {\n        if ([\"aborting\", \"cleanup-pending\", \"aborted\"].includes(checkpoint.state))\n          return yield* sessionError(\"SessionAborting\");\n        if ([\"initiating\", \"completing\", \"completion-unknown\"].includes(checkpoint.state))\n          return yield* sessionError(\"ReconciliationRequired\", true);\n\n        if (\n          checkpoint.state !== \"verifying\" &&\n          (source.length !== checkpoint.length ||\n            !sameChecksum(\n              yield* fingerprint(environment, source, checkpoint.partBytes),\n              checkpoint.checksum,\n            ))\n        )\n          return yield* sessionError(\"ChangedSource\");\n        if (checkpoint.state === \"created\") {\n          yield* save({ ...checkpoint, state: \"initiating\" });\n          const handle = yield* call(\n            multipart.initiate({\n              key: checkpoint.key,\n              headers: {\n                ...checkpoint.headers,\n                customMetadata: {\n                  ...checkpoint.headers.customMetadata,\n                  [operationMetadataKey]: checkpoint.operationId,\n                },\n              },\n            }),\n          );\n          yield* save({\n            ...checkpoint,\n            handle: yield* codec.encode(handle),\n            state: \"uploading\",\n          });\n        }\n        if (!checkpoint.handle) return yield* sessionError(\"MissingHandle\");\n        const handle = yield* codec.decode(checkpoint.handle);\n        if (\n          handle.ref.storeId !== runtime.endpoint.storage.storeId ||\n          handle.ref.key !== checkpoint.key\n        )\n          return yield* sessionError(\"ForeignHandle\");\n        if (checkpoint.state === \"uploading\") {\n          const observed = new Map<number, { etag: string; size?: number | undefined }>();\n          const cursors = new Set<string>();\n          let cursor: string | undefined;\n          do {\n            const page = yield* call(\n              multipart.listParts({ upload: handle, ...(cursor ? { cursor } : {}) }),\n            );\n            for (const part of page.parts) {\n              if (observed.has(part.partNumber) || observed.size >= multipart.limits.maximumParts)\n                return yield* sessionError(\"InvalidPartInventory\");\n              observed.set(part.partNumber, part);\n            }\n            cursor = page.cursor;\n            if (cursor && cursors.has(cursor)) return yield* sessionError(\"RepeatedPartCursor\");\n            if (cursor) cursors.add(cursor);\n          } while (cursor);\n          const reader = yield* makeReader(source, {\n            maximumBytes: runtime.policy.maxBytes,\n            maximumChunkBytes: runtime.policy.maxSourceChunkBytes,\n            digest: runtime.input.digest,\n            onRead: () => {},\n          });\n          let number = 0;\n          while (true) {\n            const chunk = yield* reader.next(checkpoint.partBytes);\n            if (!chunk && number > 0) break;\n            const body = chunk ?? new Uint8Array();\n            number++;\n            const saved = checkpoint.parts.find((part) => part.partNumber === number);\n            const remote = observed.get(number);\n            const partHash = runtime.input.digest.create();\n            partHash.update(body);\n            const sourceChecksum = partHash.finish();\n            if (\n              !saved ||\n              !sameChecksum(sourceChecksum, saved.sourceChecksum) ||\n              remote?.etag !== saved.etag ||\n              remote.size !== saved.size\n            ) {\n              const receipt = yield* partReceipt(\n                yield* call(\n                  multipart.uploadPart({\n                    upload: handle,\n                    partNumber: number,\n                    body,\n                    contentLength: body.length,\n                  }),\n                ),\n                number,\n                body.length,\n                runtime.endpoint.storage.provider,\n              );\n              yield* save({\n                ...checkpoint,\n                parts: [\n                  ...checkpoint.parts.filter((part) => part.partNumber !== number),\n                  { ...receipt, sourceChecksum },\n                ].toSorted((a, b) => a.partNumber - b.partNumber),\n              });\n            }\n            if (!chunk) break;\n          }\n          const checksum = reader.checksum();\n          if (!checksum || !sameChecksum(checksum, checkpoint.checksum))\n            return yield* sessionError(\"ChangedSource\");\n          if (checkpoint.attempts + 3 > runtime.policy.maxAttempts)\n            return yield* sessionError(\"SessionAttemptLimit\");\n          yield* save({ ...checkpoint, state: \"completing\" });\n          const metadata = yield* call(\n            Effect.suspend(() => {\n              operation.mutationStarted = true;\n              return multipart.complete({\n                upload: handle,\n                parts: checkpoint.parts.map(({ sourceChecksum: _sourceChecksum, ...part }) => part),\n                ...(checkpoint.condition ? { condition: checkpoint.condition } : {}),\n              });\n            }),\n          ).pipe(\n            Effect.catch((error) =>\n              Effect.gen(function* () {\n                if (error.mutationOutcome === \"rejected\") {\n                  operation.mutationStarted = false;\n                  yield* save({ ...checkpoint, state: \"uploading\" }).pipe(Effect.result);\n                }\n                return yield* error;\n              }),\n            ),\n          );\n          operation.committed = true;\n          yield* save({ ...checkpoint, metadata, state: \"verifying\" });\n        }\n        if (!checkpoint.metadata) return yield* sessionError(\"MissingCompletionReceipt\");\n        return checkpoint.metadata;\n      }),\n    ),\n  );\n  return yield* runtime\n    .deadline(\n      verification,\n      Effect.gen(function* () {\n        const metadata = yield* work;\n        if (!metadata) return yield* sessionError(\"MissingCompletionReceipt\");\n        if (checkpoint.state !== \"completed\") {\n          const verified = yield* download(\n            runtime,\n            {\n              ref: metadata.ref,\n              expectedChecksum: checkpoint.checksum,\n              target: { write: () => Effect.void },\n            },\n            operation,\n          );\n          yield* save({\n            ...checkpoint,\n            state: \"completed\",\n            metadata: verified.metadata,\n            events: [\n              { id: `${checkpoint.operationId}:completed`, kind: \"completed\", delivered: false },\n            ],\n          });\n        }\n        return checkpoint.metadata ?? metadata;\n      }),\n    )\n    .pipe(\n      Effect.mapError((error) =>\n        error instanceof StorageError && operation.committed\n          ? new StorageError({\n              operation: error.operation,\n              provider: error.provider,\n              reason: error.reason,\n              requestId: error.requestId,\n              mutationOutcome: \"succeeded\",\n            })\n          : error,\n      ),\n    );\n});\n\nexport const reconcileUpload = Effect.fnUntraced(function* (\n  environment: UploadEnvironment,\n  original: UploadCheckpoint,\n) {\n  const { runtime, store } = environment;\n  if (![\"initiating\", \"completing\", \"completion-unknown\"].includes(original.state)) return original;\n  if (original.protocol === \"offset\" && original.handle && runtime.endpoint.offsets) {\n    const handle = yield* decodeNativeHandle(original.handle);\n    if (handle.ref.storeId !== runtime.endpoint.storage.storeId || handle.ref.key !== original.key)\n      return yield* sessionError(\"ForeignHandle\");\n    const remote = yield* runtime.cleanupRequest(runtime.endpoint.offsets.query(handle)).pipe(\n      Effect.timeoutOrElse({\n        duration: runtime.policy.cleanupTimeoutMillis,\n        orElse: () => Effect.fail(sessionError(\"ReconciliationTimeout\", true)),\n      }),\n    );\n    if (remote._tag === \"Completed\") {\n      const metadata = runtime.endpoint.offsets.resolveCompletion\n        ? yield* runtime.cleanupRequest(runtime.endpoint.offsets.resolveCompletion(handle)).pipe(\n            Effect.timeoutOrElse({\n              duration: runtime.policy.cleanupTimeoutMillis,\n              orElse: () => Effect.fail(sessionError(\"ReconciliationTimeout\", true)),\n            }),\n          )\n        : remote.metadata;\n      return yield* store.write({ ...original, state: \"verifying\", metadata }, original.revision);\n    }\n    if (remote._tag === \"Uploading\")\n      return yield* store.write(\n        { ...original, state: \"uploading\", offset: remote.committedOffset },\n        original.revision,\n      );\n    // Some tus servers remove a finished URL. Only the saved operation marker can recover that completion.\n    if (remote._tag !== \"Expired\" || !runtime.endpoint.reconcile)\n      return yield* sessionError(\n        remote._tag === \"Expired\" ? \"SessionExpired\" : \"ReconciliationRequired\",\n        true,\n      );\n  }\n  // An unknown initiation has no safely observed handle. Never adopt an upload by key alone.\n  if (original.state === \"initiating\" || !runtime.endpoint.reconcile)\n    return yield* sessionError(\"OrphanDiscoveryRequired\", true);\n  const metadata = yield* runtime\n    .cleanupRequest(\n      runtime.endpoint.reconcile({\n        key: original.key,\n        operationId: original.operationId,\n        size: original.length,\n      }),\n    )\n    .pipe(\n      Effect.timeoutOrElse({\n        duration: runtime.policy.cleanupTimeoutMillis,\n        orElse: () => Effect.fail(sessionError(\"ReconciliationTimeout\", true)),\n      }),\n    );\n  const next = metadata\n    ? { ...original, state: \"verifying\" as const, metadata }\n    : { ...original, state: \"completion-unknown\" as const };\n  return yield* store.write(next, original.revision);\n});\n\nexport const abortUpload = Effect.fnUntraced(function* (\n  environment: UploadEnvironment,\n  original: UploadCheckpoint,\n) {\n  if (original.protocol) return yield* abortNativeUpload(environment, original);\n  const { runtime, store } = environment;\n  if (original.state === \"aborted\") return;\n  if (\n    [\"completed\", \"verifying\", \"completing\", \"completion-unknown\", \"initiating\"].includes(\n      original.state,\n    )\n  )\n    return yield* sessionError(\"ReconciliationRequired\", true);\n  let checkpoint = yield* store.write({ ...original, state: \"aborting\" }, original.revision);\n  if (checkpoint.kind !== \"upload\") return yield* sessionError(\"InvalidCheckpoint\");\n  if (checkpoint.handle) {\n    const codec = runtime.endpoint.handles;\n    if (!codec) return yield* sessionError(\"DurableUploadUnsupported\");\n    const multipart = runtime.endpoint.multipart;\n    if (!multipart) return yield* sessionError(\"MultipartRequired\");\n    const handle = yield* codec.decode(checkpoint.handle);\n    if (\n      handle.ref.storeId !== runtime.endpoint.storage.storeId ||\n      handle.ref.key !== checkpoint.key\n    )\n      return yield* sessionError(\"ForeignHandle\");\n    if (original.state === \"aborting\" || original.state === \"cleanup-pending\") {\n      const inventory = yield* runtime\n        .cleanupRequest(multipart.listParts({ upload: handle }))\n        .pipe(Effect.timeout(runtime.policy.cleanupTimeoutMillis), Effect.result);\n      if (\n        inventory._tag === \"Failure\" &&\n        inventory.failure._tag === \"StorageError\" &&\n        inventory.failure.reason._tag === \"InvalidSession\"\n      ) {\n        yield* store.write(\n          {\n            ...checkpoint,\n            state: \"aborted\",\n            events: [\n              { id: `${checkpoint.operationId}:aborted`, kind: \"aborted\", delivered: false },\n            ],\n          },\n          checkpoint.revision,\n        );\n        return;\n      }\n    }\n    const result = yield* runtime\n      .cleanupRequest(multipart.abort(handle))\n      .pipe(Effect.timeout(runtime.policy.cleanupTimeoutMillis), Effect.result);\n    if (result._tag === \"Failure\") {\n      yield* store.write({ ...checkpoint, state: \"cleanup-pending\" }, checkpoint.revision);\n      return yield* result.failure._tag === \"StorageError\"\n        ? result.failure\n        : sessionError(\"CleanupPending\", true);\n    }\n  }\n  checkpoint = yield* store.write(\n    {\n      ...checkpoint,\n      state: \"aborted\",\n      events: [{ id: `${checkpoint.operationId}:aborted`, kind: \"aborted\", delivered: false }],\n    },\n    checkpoint.revision,\n  );\n});\n"],"mappings":"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"}

package/dist/sessions.d.ts

@@ -0,0 +1,98 @@
+import { Checksum, ObjectHeaders, ObjectMetadata, ObjectRef } from "./core/object.js";
+import { StorageError } from "./core/errors.js";
+import { WriteCondition } from "./core/requests.js";
+import { UploadSource } from "./transfers/sources.js";
+import { BatchCheckpoint, DownloadCheckpoint, SessionCheckpoint, SessionId, SessionStatus, UploadCheckpoint } from "./sessions/checkpoint.js";
+import { CheckpointProtection, SessionOwnership, SessionStoreOptions, UploadSessionStore } from "./sessions/store.js";
+import { SessionOptions } from "./sessions/upload.js";
+import { RestartableDownloadTarget } from "./sessions/download.js";
+import { ManagedTransferRuntime } from "./transfers/managed-runtime.js";
+import { Context, Effect, Layer } from "effect";
+export interface CreateUpload<E = never, R = never> {
+  readonly id?: string;
+  readonly key: string;
+  readonly source: UploadSource<E, R>;
+  readonly headers?: ObjectHeaders;
+  readonly condition?: WriteCondition;
+}
+export interface SessionsService {
+  readonly create: <E, R>(request: CreateUpload<E, R>) => Effect.Effect<string, StorageError | E, R>;
+  readonly resume: <E, R>(id: string, source: UploadSource<E, R>) => Effect.Effect<ObjectMetadata, StorageError | E, R>;
+  readonly complete: <E, R>(id: string, source: UploadSource<E, R>) => Effect.Effect<ObjectMetadata, StorageError | E, R>;
+  readonly status: (id: string) => Effect.Effect<SessionStatus, StorageError>;
+  readonly reconcile: (id: string) => Effect.Effect<SessionStatus, StorageError>;
+  readonly abort: (id: string) => Effect.Effect<void, StorageError>;
+  readonly forget: (id: string) => Effect.Effect<void, StorageError>;
+  readonly deliverEvents: <E, R>(id: string, deliver: (event: {
+    readonly id: string;
+    readonly kind: "completed" | "aborted";
+    readonly sessionId: string;
+    readonly metadata?: ObjectMetadata | undefined;
+  }) => Effect.Effect<void, E, R>) => Effect.Effect<void, StorageError | E, R>;
+  readonly createDownload: (request: {
+    readonly id: string;
+    readonly ref: ObjectRef;
+    readonly expectedChecksum?: Checksum;
+  }) => Effect.Effect<string, StorageError>;
+  readonly resumeDownload: <E, R>(id: string, target: RestartableDownloadTarget<E, R>) => Effect.Effect<ObjectMetadata, StorageError | E, R>;
+  readonly abortDownload: <E, R>(id: string, target: RestartableDownloadTarget<E, R>) => Effect.Effect<void, StorageError | E, R>;
+  readonly createBatch: (sessionIds: ReadonlyArray<string>) => Effect.Effect<string, StorageError>;
+  readonly processBatch: <E, R>(id: string, run: (sessionId: string) => Effect.Effect<unknown, E, R>) => Effect.Effect<ReadonlyArray<{
+    readonly sessionId: string;
+    readonly state: string;
+  }>, StorageError, R>;
+}
+declare const UploadSessions_base: Context.ServiceClass<UploadSessions, "@effect-kit/storage/UploadSessions", SessionsService>;
+export declare class UploadSessions extends UploadSessions_base {
+  static readonly make: (options: SessionOptions) => Effect.Effect<SessionsService, StorageError, ManagedTransferRuntime | UploadSessionStore>;
+  static create<E, R>(request: CreateUpload<E, R>): Effect.Effect<string, E | StorageError, R | UploadSessions>;
+  static resume<E, R>(id: string, source: UploadSource<E, R>): Effect.Effect<{
+    readonly contentType?: string | undefined;
+    readonly contentEncoding?: string | undefined;
+    readonly contentLanguage?: string | undefined;
+    readonly contentDisposition?: string | undefined;
+    readonly cacheControl?: string | undefined;
+    readonly customMetadata?: {
+      readonly [x: string]: string;
+    } | undefined;
+    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 size?: number | undefined;
+    readonly etag?: string | undefined;
+    readonly lastModified?: import("effect/DateTime").Utc | undefined;
+    readonly checksums?: readonly {
+      readonly algorithm: string;
+      readonly encoding: "base64" | "hex";
+      readonly scope: "composite" | "full-object";
+      readonly value: string;
+      readonly partCount?: number | undefined;
+    }[] | undefined;
+    readonly storageClass?: string | undefined;
+  }, E | StorageError, R | UploadSessions>;
+  static status(id: string): Effect.Effect<SessionStatus, StorageError, UploadSessions>;
+  static reconcile(id: string): Effect.Effect<SessionStatus, StorageError, UploadSessions>;
+  static abort(id: string): Effect.Effect<void, StorageError, UploadSessions>;
+  static layer(options: SessionOptions): Layer.Layer<UploadSessions, StorageError, ManagedTransferRuntime | UploadSessionStore>;
+}
+export { BatchCheckpoint, type CheckpointProtection, DownloadCheckpoint, type RestartableDownloadTarget, SessionCheckpoint, SessionId, type SessionOptions, type SessionOwnership, type SessionStatus, type SessionStoreOptions, UploadCheckpoint, UploadSessionStore };
+//# sourceMappingURL=sessions.d.ts.map