@panorama-industries/effect-vercel-blob 0.0.0 → 0.3.0

package/dist/internal/client-token.js

@@ -0,0 +1,80 @@
+import { Effect, Option, Result, Schema } from "effect";
+import { Base64, Hex } from "effect/encoding";
+import { ClientToken } from "../contracts/blob-domain.js";
+/*
+ * Client tokens, as the SDK's `generateClientTokenFromReadWriteToken` builds them:
+ * `vercel_blob_client_<storeId>_<base64("<hex HMAC-SHA256(payload)>.<payload>")>`, where `payload` is
+ * the base64 of the token's JSON and the HMAC is keyed by the store's read-write token. The JSON is
+ * serialized exactly as the SDK does (key order and all), so tokens are byte-identical.
+ */
+/** Prefix of every client token. */
+export const clientTokenPrefix = "vercel_blob_client_";
+/** How long a client token generated without `validUntil` stays valid, as the SDK: 30 seconds. */
+export const defaultClientTokenLifetimeMillis = 30_000;
+/**
+ * The JSON a client token encodes, as the SDK serializes it: the fields in their order, with
+ * `allowOverwrite: true` appended when `ifMatch` is set and `allowOverwrite` is not, and
+ * `validUntil` defaulted to `defaultValidUntil` (kept in place when the fields have it).
+ *
+ * Callers reject `ifMatch` with `allowOverwrite: false` first; see {@link contradictsIfMatch}.
+ */
+export const clientTokenPayloadJson = (fields, defaultValidUntil) => {
+    const args = { ...fields };
+    if (Boolean(args["ifMatch"]) && args["allowOverwrite"] === undefined) {
+        args["allowOverwrite"] = true;
+    }
+    return JSON.stringify({ ...args, validUntil: args["validUntil"] ?? defaultValidUntil });
+};
+/** The SDK's message for an `ifMatch` with `allowOverwrite: false`, which it refuses to sign. */
+export const ifMatchContradictionMessage = "ifMatch and allowOverwrite: false are contradictory. ifMatch is used for conditional overwrites, which requires allowOverwrite to be true.";
+/** Whether the fields set `ifMatch` together with `allowOverwrite: false`, which the SDK rejects. */
+export const contradictsIfMatch = (fields) => Boolean(fields["ifMatch"]) && fields["allowOverwrite"] === false;
+const textEncoder = new TextEncoder();
+/** HMAC-SHA256 of `data` keyed by `secret` (both UTF-8), as lowercase hex. */
+export const hmacSha256Hex = Effect.fnUntraced(function* (secret, data) {
+    const key = yield* Effect.promise(() => globalThis.crypto.subtle.importKey("raw", textEncoder.encode(secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]));
+    const signature = yield* Effect.promise(() => globalThis.crypto.subtle.sign("HMAC", key, textEncoder.encode(data)));
+    return Hex.encode(new Uint8Array(signature));
+});
+/**
+ * Sign a client token's JSON with the store's read-write token.
+ *
+ * @param payloadJson - The token's JSON, from {@link clientTokenPayloadJson}.
+ * @returns `vercel_blob_client_<storeId>_<base64("<hex HMAC>.<base64 payloadJson>")>`.
+ */
+export const signClientToken = Effect.fnUntraced(function* (readWriteToken, storeId, payloadJson) {
+    const payload = Base64.encode(payloadJson);
+    const signature = yield* hmacSha256Hex(readWriteToken, payload);
+    return ClientToken.make(`${clientTokenPrefix}${storeId}_${Base64.encode(`${signature}.${payload}`)}`);
+});
+/** `onUploadCompleted` as a client token carries it. */
+export const ClientTokenCallback = Schema.Struct({
+    callbackUrl: Schema.String,
+    tokenPayload: Schema.optionalKey(Schema.NullOr(Schema.String)),
+});
+/** The JSON a client token encodes, as the SDK's `DecodedClientTokenPayload`. */
+export const ClientTokenPayload = Schema.Struct({
+    pathname: Schema.String,
+    /** Expiry in epoch milliseconds. */
+    validUntil: Schema.Number,
+    onUploadCompleted: Schema.optionalKey(ClientTokenCallback),
+    maximumSizeInBytes: Schema.optionalKey(Schema.Number),
+    allowedContentTypes: Schema.optionalKey(Schema.Array(Schema.String)),
+    addRandomSuffix: Schema.optionalKey(Schema.Boolean),
+    allowOverwrite: Schema.optionalKey(Schema.Boolean),
+    cacheControlMaxAge: Schema.optionalKey(Schema.Number),
+    ifMatch: Schema.optionalKey(Schema.String),
+    /** Set by upload routes, which copy the route's `tokenPayload` into the token as the SDK does. */
+    tokenPayload: Schema.optionalKey(Schema.NullOr(Schema.String)),
+});
+const decodePayload = Schema.decodeUnknownOption(Schema.fromJsonString(ClientTokenPayload));
+const decodeBase64String = (input) => Result.getSuccess(Base64.decodeString(input));
+/**
+ * Read the JSON a client token encodes without verifying its signature, as the SDK's
+ * `getPayloadFromClientToken`: the fifth `_`-separated segment is base64 of `<hmac>.<base64 JSON>`.
+ * Works in browsers.
+ *
+ * @returns None when the token does not have that shape or its JSON is not a client token payload.
+ */
+export const getPayloadFromClientToken = (clientToken) => decodeBase64String(clientToken.split("_")[4] ?? "").pipe(Option.flatMap((secured) => Option.fromUndefinedOr(secured.split(".")[1])), Option.flatMap(decodeBase64String), Option.flatMap(decodePayload));
+//# sourceMappingURL=client-token.js.map

package/dist/internal/client-token.js.map

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

package/dist/internal/env.d.ts

@@ -0,0 +1,34 @@
+import { Config, Effect, Option } from "effect";
+/** A `ConfigError` with a message explaining what to fix. */
+export declare const configError: (message: string) => Config.ConfigError;
+/**
+ * A variable as the SDK's `readEnv` reads it: trimmed, and absent when blank. In browsers these
+ * are usually `NEXT_PUBLIC_*` values inlined by the bundler, or absent.
+ */
+export declare const env: (name: string) => Config.Config<Option.Option<string>>;
+/** The first of several variables that is set, such as a name and its `NEXT_PUBLIC_` twin. */
+export declare const firstEnv: (...names: ReadonlyArray<string>) => Effect.Effect<Option.Option<string>, Config.ConfigError, never>;
+/** Values that replace what {@link requestEnv} reads from the environment. */
+export interface RequestEnvOptions {
+    readonly apiUrl?: URL | string | undefined;
+    readonly headers?: Readonly<Record<string, string>> | undefined;
+    readonly retries?: number | undefined;
+}
+/** How every Blob API request is addressed and retried, shared by the server and browser clients. */
+export interface RequestEnv {
+    readonly apiUrl: URL;
+    readonly apiVersion: string;
+    readonly retries: number;
+    readonly sendContentLength: boolean;
+    readonly headers: Readonly<Record<string, string>>;
+}
+/**
+ * Reads the request settings the SDK's `requestApi` reads on every call: `VERCEL_BLOB_API_URL`,
+ * `VERCEL_BLOB_API_VERSION_OVERRIDE`, `VERCEL_BLOB_PROXY_THROUGH_ALTERNATIVE_API` (each also with a
+ * `NEXT_PUBLIC_` prefix), `VERCEL_BLOB_RETRIES` and `VERCEL_BLOB_USE_X_CONTENT_LENGTH`.
+ *
+ * Fails with a `ConfigError` when the API URL is not absolute or the retry count is not a
+ * non-negative integer.
+ */
+export declare const requestEnv: (options: RequestEnvOptions) => Effect.Effect<RequestEnv, Config.ConfigError, never>;
+//# sourceMappingURL=env.d.ts.map

package/dist/internal/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/internal/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAkB,MAAM,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAC;AAQxE,6DAA6D;AAC7D,eAAO,MAAM,WAAW,YAAa,MAAM,uBAC0B,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,GAAG,SAAU,MAAM,yCAQ7B,CAAC;AAEJ,8FAA8F;AAC9F,eAAO,MAAM,QAAQ,aAAc,aAAa,CAAC,MAAM,CAAC,oEAOpD,CAAC;AAQL,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,qGAAqG;AACrG,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,sFA6DrB,CAAC"}

package/dist/internal/env.js

@@ -0,0 +1,61 @@
+import { Config, ConfigProvider, Effect, Option, Schema } from "effect";
+import { defaultApiUrl } from "./urls.js";
+const defaultApiVersion = "13";
+const defaultRetries = 10;
+/** A `ConfigError` with a message explaining what to fix. */
+export const configError = (message) => new Config.ConfigError(new ConfigProvider.SourceError({ message }));
+/**
+ * A variable as the SDK's `readEnv` reads it: trimmed, and absent when blank. In browsers these
+ * are usually `NEXT_PUBLIC_*` values inlined by the bundler, or absent.
+ */
+export const env = (name) => Config.option(Config.String(name)).pipe(Config.map((value) => Option.filter(Option.map(value, (value) => value.trim()), (value) => value !== "")));
+/** The first of several variables that is set, such as a name and its `NEXT_PUBLIC_` twin. */
+export const firstEnv = (...names) => Effect.gen(function* () {
+    for (const name of names) {
+        const value = yield* env(name);
+        if (Option.isSome(value))
+            return value;
+    }
+    return Option.none();
+});
+const decodeUrl = Schema.decodeUnknownOption(Schema.URLFromString);
+const decodeRetries = Schema.decodeUnknownOption(Schema.NumberFromString.check(Schema.isInt(), Schema.isGreaterThanOrEqualTo(0)));
+/**
+ * Reads the request settings the SDK's `requestApi` reads on every call: `VERCEL_BLOB_API_URL`,
+ * `VERCEL_BLOB_API_VERSION_OVERRIDE`, `VERCEL_BLOB_PROXY_THROUGH_ALTERNATIVE_API` (each also with a
+ * `NEXT_PUBLIC_` prefix), `VERCEL_BLOB_RETRIES` and `VERCEL_BLOB_USE_X_CONTENT_LENGTH`.
+ *
+ * Fails with a `ConfigError` when the API URL is not absolute or the retry count is not a
+ * non-negative integer.
+ */
+export const requestEnv = Effect.fnUntraced(function* (options) {
+    const apiUrlInput = options.apiUrl ??
+        Option.getOrElse(yield* firstEnv("VERCEL_BLOB_API_URL", "NEXT_PUBLIC_VERCEL_BLOB_API_URL"), () => defaultApiUrl);
+    const apiUrl = yield* Option.match(decodeUrl(String(apiUrlInput)), {
+        onNone: () => Effect.fail(configError(`Invalid Blob API URL "${String(apiUrlInput)}": expected an absolute URL.`)),
+        onSome: Effect.succeed,
+    });
+    const apiVersion = Option.getOrElse(yield* firstEnv("VERCEL_BLOB_API_VERSION_OVERRIDE", "NEXT_PUBLIC_VERCEL_BLOB_API_VERSION_OVERRIDE"), () => defaultApiVersion);
+    const retries = options.retries ??
+        (yield* Option.match(yield* env("VERCEL_BLOB_RETRIES"), {
+            onNone: () => Effect.succeed(defaultRetries),
+            onSome: (value) => Option.match(decodeRetries(value), {
+                onNone: () => Effect.fail(configError(`Invalid VERCEL_BLOB_RETRIES "${value}": expected a non-negative integer.`)),
+                onSome: Effect.succeed,
+            }),
+        }));
+    if (!Number.isInteger(retries) || retries < 0) {
+        return yield* Effect.fail(configError(`Invalid retries ${retries}: expected a non-negative integer.`));
+    }
+    const sendContentLength = Option.contains(yield* env("VERCEL_BLOB_USE_X_CONTENT_LENGTH"), "1");
+    const proxyThroughAlternativeApi = yield* firstEnv("VERCEL_BLOB_PROXY_THROUGH_ALTERNATIVE_API", "NEXT_PUBLIC_VERCEL_BLOB_PROXY_THROUGH_ALTERNATIVE_API");
+    const headers = {
+        ...Option.match(proxyThroughAlternativeApi, {
+            onNone: () => ({}),
+            onSome: (value) => ({ "x-proxy-through-alternative-api": value }),
+        }),
+        ...options.headers,
+    };
+    return { apiUrl, apiVersion, retries, sendContentLength, headers };
+});
+//# sourceMappingURL=env.js.map

package/dist/internal/env.js.map

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

package/dist/internal/multipart.d.ts

@@ -0,0 +1,110 @@
+import { Duration, Effect } from "effect";
+import type { BlobBody, OnUploadProgress, PutBlobResult } from "../contracts/blob-domain.ts";
+import type { BlobApiError, BlobDomainErrorTag } from "./blob-errors.ts";
+import type { BlobRequestAuth, BlobRequester } from "./blob-request.ts";
+import type { WriteHeaderOptions, WriteOption } from "./write-headers.ts";
+import { MultipartUpload, UploadedPart } from "../contracts/blob-domain.ts";
+import { BlobUploadRejected } from "../contracts/blob-errors.ts";
+/** Size of the parts an automatic multipart upload sends, as the SDK's `partSizeInBytes`. */
+export declare const multipartPartSize: number;
+/** Minimum time between progress events of an automatic multipart upload, as in the SDK. */
+export declare const multipartProgressInterval: Duration.Duration;
+/**
+ * How many parts an automatic multipart upload sends at once, as the SDK's `maxConcurrentUploads`:
+ * 6 in browsers (where `window` is defined), which allow about six connections per host, and 8
+ * elsewhere. Read on every call.
+ */
+export declare const maxConcurrentPartUploads: () => number;
+/**
+ * Which write options become headers at each step. Creation (and every request of an automatic
+ * upload, which the SDK sends with the `put` headers throughout) uses `create`; `uploadPart` and
+ * `completeMultipartUpload` rebuild their headers from the {@link MultipartUpload} handle with
+ * `part`.
+ */
+export interface MultipartWriteOptions {
+    readonly create: ReadonlyArray<WriteOption>;
+    readonly part: ReadonlyArray<WriteOption>;
+}
+/** The SDK's server lists: every option at creation, all but `ifMatch` for parts and completion. */
+export declare const serverMultipartWriteOptions: MultipartWriteOptions;
+/** The SDK's client-token lists: only `contentType` (and `access`); the token fixes the rest. */
+export declare const clientMultipartWriteOptions: MultipartWriteOptions;
+/**
+ * Where and how multipart requests are sent. Build it once per layer for the server; the browser
+ * client builds one per call because its auth (client token or presigned payload) is per upload.
+ *
+ * @template EA - Failure of `auth`, such as `OidcTokenUnavailable`.
+ * @template RA - Requirements of `auth`.
+ * @template K - Domain errors the calling service's contract declares for writes.
+ */
+export interface MultipartTarget<EA, RA, K extends BlobDomainErrorTag> {
+    readonly requester: BlobRequester;
+    /** Evaluated once per request, so refreshed OIDC tokens are picked up between parts. */
+    readonly auth: Effect.Effect<BlobRequestAuth, EA, RA>;
+    /**
+     * Prefix of the operation names in errors and spans: `BlobStore` or `BlobClient`. Requests are
+     * named `<service>.createMultipartUpload`, `<service>.uploadPart` and
+     * `<service>.completeMultipartUpload`.
+     */
+    readonly service: string;
+    readonly domainErrors: ReadonlyArray<K>;
+    readonly writeOptions: MultipartWriteOptions;
+}
+/** A part as the complete request sends it; `UploadedPart` and plain records both fit. */
+export interface CompletedPart {
+    readonly etag: string;
+    readonly partNumber: number;
+}
+/**
+ * Start a multipart upload: `POST /mpu?pathname=…` with `x-mpu-action: create` and the
+ * `writeOptions.create` headers.
+ *
+ * @returns The handle: pathname, the store's key and upload id, `access` and every write option
+ *   creation sent (cache lifetime in seconds), so parts and completion resend the same headers.
+ */
+export declare const createMultipartUpload: <EA, RA, K extends BlobDomainErrorTag>(target: MultipartTarget<EA, RA, K>, pathname: string & import("effect/Brand").Brand<"BlobPathname">, options: WriteHeaderOptions) => Effect.Effect<MultipartUpload, EA | BlobApiError<K>, RA>;
+/**
+ * Upload one part: `POST /mpu?pathname=…` with `x-mpu-action: upload`, `x-mpu-key`
+ * (URI-encoded), `x-mpu-upload-id`, `x-mpu-part-number` and the `writeOptions.part` headers
+ * rebuilt from the handle. The body is sent as given; a `Stream` body is not retried.
+ */
+export declare const uploadPart: <EA, RA, K extends BlobDomainErrorTag, E = never, R = never>(target: MultipartTarget<EA, RA, K>, upload: MultipartUpload, partNumber: number & import("effect/Brand").Brand<"PartNumber">, body: BlobBody<E, R>) => Effect.Effect<UploadedPart, E | EA | BlobApiError<K>, R | RA>;
+/**
+ * Assemble the parts into the blob: `POST /mpu?pathname=…` with `x-mpu-action: complete`, the
+ * `writeOptions.part` headers rebuilt from the handle, and the JSON array
+ * `[{"etag","partNumber"}, …]` in the order given.
+ */
+export declare const completeMultipartUpload: <EA, RA, K extends BlobDomainErrorTag>(target: MultipartTarget<EA, RA, K>, upload: MultipartUpload, parts: ReadonlyArray<CompletedPart>) => Effect.Effect<PutBlobResult, EA | BlobApiError<K>, RA>;
+/** Options of an automatic multipart upload. */
+export type MultipartPutOptions = WriteHeaderOptions & {
+    /**
+     * Fail with `BlobUploadRejected` / `FileTooLarge` before any request when the body's known size
+     * is larger. Streams are not checked.
+     */
+    readonly maximumSizeInBytes?: number | undefined;
+    readonly onUploadProgress?: OnUploadProgress | undefined;
+    /** Parts sent at once; {@link maxConcurrentPartUploads} by default. */
+    readonly concurrency?: number | undefined;
+};
+/**
+ * Upload a body with a multipart upload, as the SDK's `uncontrolledMultipartUpload`: create it,
+ * send the body in {@link multipartPartSize} parts (the last one smaller) with bounded concurrency,
+ * then complete it with the parts in part-number order. Every request carries the
+ * `writeOptions.create` headers, as the SDK resends the `put` headers.
+ *
+ * - `maximumSizeInBytes` is checked against the known size before any request.
+ * - Memory stays bounded: a part's bytes are produced only when an upload slot is free, so at most
+ *   `concurrency` parts (plus the parts cut from the stream chunk being read) are held at once.
+ * - The first failure, of a part or of the body stream, interrupts the parts in flight; the upload
+ *   is then not completed.
+ * - An empty body uploads no part and completes with an empty part list, as the SDK does.
+ * - Progress: 0 % once the upload is created, then the bytes sent by all parts summed and
+ *   throttled to one event per {@link multipartProgressInterval} (the SDK's numbers, rounded to two
+ *   decimals). The event in which every byte has been acknowledged is held back, and
+ *   `{ loaded, total: loaded, percentage: 100 }` is reported once the upload is completed instead.
+ *
+ * @returns The stored blob; fails with `BlobUploadRejected` for an oversized body, the requests'
+ *   errors, or the body stream's error.
+ */
+export declare const multipartPut: <EA, RA, K extends BlobDomainErrorTag, E = never, R = never>(target: MultipartTarget<EA, RA, K>, pathname: string & import("effect/Brand").Brand<"BlobPathname">, body: BlobBody<E, R>, options: MultipartPutOptions) => Effect.Effect<PutBlobResult, E | EA | BlobUploadRejected | BlobApiError<K>, R | RA>;
+//# sourceMappingURL=multipart.d.ts.map

package/dist/internal/multipart.d.ts.map

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

package/dist/internal/multipart.js

@@ -0,0 +1,290 @@
+import { Duration, Effect, Stream, SynchronizedRef } from "effect";
+import { MultipartUpload, UploadedPart } from "../contracts/blob-domain.js";
+import { BlobUploadRejected, FileTooLarge } from "../contracts/blob-errors.js";
+import { bodyLength, uploadProgressThrottle } from "./blob-request.js";
+import { CreateMultipartUploadResponse, PutBlobResponse, UploadPartResponse } from "./wire.js";
+import { allowedWriteOptions, cacheControlMaxAgeSeconds, writeHeaders } from "./write-headers.js";
+/*
+ * Multipart uploads, shared by the server `BlobStore` and the browser `BlobClient`: the manual
+ * primitives (create, upload a part, complete) and the automatic upload behind `put({ multipart })`,
+ * ported from the SDK's `multipart/*.ts` and `uncontrolledMultipartUpload`.
+ */
+/** Size of the parts an automatic multipart upload sends, as the SDK's `partSizeInBytes`. */
+export const multipartPartSize = 8 * 1024 * 1024;
+/** Minimum time between progress events of an automatic multipart upload, as in the SDK. */
+export const multipartProgressInterval = Duration.millis(150);
+/**
+ * How many parts an automatic multipart upload sends at once, as the SDK's `maxConcurrentUploads`:
+ * 6 in browsers (where `window` is defined), which allow about six connections per host, and 8
+ * elsewhere. Read on every call.
+ */
+export const maxConcurrentPartUploads = () => globalThis.window === undefined ? 8 : 6;
+/** The SDK's server lists: every option at creation, all but `ifMatch` for parts and completion. */
+export const serverMultipartWriteOptions = {
+    create: allowedWriteOptions.put,
+    part: allowedWriteOptions.multipartPart,
+};
+/** The SDK's client-token lists: only `contentType` (and `access`); the token fixes the rest. */
+export const clientMultipartWriteOptions = {
+    create: allowedWriteOptions.client,
+    part: allowedWriteOptions.client,
+};
+const mpuPath = (pathname) => `/mpu?${new URLSearchParams({ pathname }).toString()}`;
+/** The handle's write options, filtered to what creation sent, with the cache lifetime in seconds. */
+const handleWriteOptions = (allowed, options) => ({
+    access: options.access,
+    ...(allowed.includes("addRandomSuffix") && options.addRandomSuffix !== undefined
+        ? { addRandomSuffix: options.addRandomSuffix }
+        : {}),
+    ...(allowed.includes("allowOverwrite") && options.allowOverwrite !== undefined
+        ? { allowOverwrite: options.allowOverwrite }
+        : {}),
+    ...(allowed.includes("contentType") && options.contentType
+        ? { contentType: options.contentType }
+        : {}),
+    ...(allowed.includes("cacheControlMaxAge") && options.cacheControlMaxAge !== undefined
+        ? { cacheControlMaxAge: cacheControlMaxAgeSeconds(options.cacheControlMaxAge) }
+        : {}),
+});
+/** The write options a handle carries, back in the form `writeHeaders` reads. */
+const uploadWriteOptions = (upload) => ({
+    access: upload.access,
+    addRandomSuffix: upload.addRandomSuffix,
+    allowOverwrite: upload.allowOverwrite,
+    contentType: upload.contentType,
+    cacheControlMaxAge: upload.cacheControlMaxAge === undefined
+        ? undefined
+        : Duration.seconds(upload.cacheControlMaxAge),
+});
+const createRequest = ({ target, pathname, headers, }) => target.requester.call({
+    operation: `${target.service}.createMultipartUpload`,
+    method: "POST",
+    path: mpuPath(pathname),
+    auth: target.auth,
+    response: CreateMultipartUploadResponse,
+    headers: { ...headers, "x-mpu-action": "create" },
+    locator: pathname,
+    domainErrors: target.domainErrors,
+});
+const uploadPartRequest = ({ target, pathname, headers }, part) => target.requester.call({
+    operation: `${target.service}.uploadPart`,
+    method: "POST",
+    path: mpuPath(pathname),
+    auth: target.auth,
+    response: UploadPartResponse,
+    headers: {
+        ...headers,
+        "x-mpu-action": "upload",
+        // The key can hold any UTF-8 character, and header values must be US-ASCII.
+        "x-mpu-key": encodeURIComponent(part.key),
+        "x-mpu-upload-id": part.uploadId,
+        "x-mpu-part-number": String(part.partNumber),
+        ...(part.contentType === undefined ? {} : { "content-type": part.contentType }),
+    },
+    body: part.body,
+    locator: pathname,
+    domainErrors: target.domainErrors,
+    onUploadProgress: part.onUploadProgress,
+});
+const completeRequest = ({ target, pathname, headers }, upload) => target.requester.call({
+    operation: `${target.service}.completeMultipartUpload`,
+    method: "POST",
+    path: mpuPath(pathname),
+    auth: target.auth,
+    response: PutBlobResponse,
+    headers: {
+        ...headers,
+        "x-mpu-action": "complete",
+        "x-mpu-upload-id": upload.uploadId,
+        "x-mpu-key": encodeURIComponent(upload.key),
+    },
+    // `content-type: application/json` comes with `json`; fields in the SDK's order.
+    json: upload.parts.map(({ etag, partNumber }) => upload.partNumberFirst === true ? { partNumber, etag } : { etag, partNumber }),
+    locator: pathname,
+    domainErrors: target.domainErrors,
+});
+/**
+ * Start a multipart upload: `POST /mpu?pathname=…` with `x-mpu-action: create` and the
+ * `writeOptions.create` headers.
+ *
+ * @returns The handle: pathname, the store's key and upload id, `access` and every write option
+ *   creation sent (cache lifetime in seconds), so parts and completion resend the same headers.
+ */
+export const createMultipartUpload = Effect.fnUntraced(function* (target, pathname, options) {
+    const allowed = target.writeOptions.create;
+    const { key, uploadId } = yield* createRequest({
+        target,
+        pathname,
+        headers: writeHeaders(allowed, options),
+    });
+    return new MultipartUpload({
+        pathname,
+        key,
+        uploadId,
+        ...handleWriteOptions(allowed, options),
+    });
+});
+/**
+ * Upload one part: `POST /mpu?pathname=…` with `x-mpu-action: upload`, `x-mpu-key`
+ * (URI-encoded), `x-mpu-upload-id`, `x-mpu-part-number` and the `writeOptions.part` headers
+ * rebuilt from the handle. The body is sent as given; a `Stream` body is not retried.
+ */
+export const uploadPart = Effect.fnUntraced(function* (target, upload, partNumber, body) {
+    const { etag } = yield* uploadPartRequest({
+        target,
+        pathname: upload.pathname,
+        headers: writeHeaders(target.writeOptions.part, uploadWriteOptions(upload)),
+    }, { key: upload.key, uploadId: upload.uploadId, partNumber, body });
+    return new UploadedPart({ etag, partNumber });
+});
+/**
+ * Assemble the parts into the blob: `POST /mpu?pathname=…` with `x-mpu-action: complete`, the
+ * `writeOptions.part` headers rebuilt from the handle, and the JSON array
+ * `[{"etag","partNumber"}, …]` in the order given.
+ */
+export const completeMultipartUpload = (target, upload, parts) => completeRequest({
+    target,
+    pathname: upload.pathname,
+    headers: writeHeaders(target.writeOptions.part, uploadWriteOptions(upload)),
+}, { key: upload.key, uploadId: upload.uploadId, parts });
+/**
+ * Regroup a byte stream into parts of exactly `size` bytes, the last one smaller, copying each
+ * byte once into its part (the SDK cuts parts the same way, because R2 refuses uneven parts).
+ */
+const regroupParts = (size) => (stream) => Stream.mapAccum(stream, () => ({
+    part: undefined,
+    filled: 0,
+}), (state, chunk) => {
+    let { part, filled } = state;
+    const full = [];
+    let position = 0;
+    while (position < chunk.length) {
+        part ??= new Uint8Array(size);
+        const count = Math.min(size - filled, chunk.length - position);
+        part.set(chunk.subarray(position, position + count), filled);
+        filled += count;
+        position += count;
+        if (filled === size) {
+            full.push(part);
+            part = undefined;
+            filled = 0;
+        }
+    }
+    return [{ part, filled }, full];
+}, {
+    onHalt: ({ part, filled }) => part === undefined || filled === 0 ? [] : [part.slice(0, filled)],
+});
+const partRanges = (length, size) => Array.from({ length: Math.ceil(length / size) }, (_, index) => [
+    index * size,
+    Math.min(length, (index + 1) * size),
+]);
+const textEncoder = new TextEncoder();
+const isBlob = (body) => typeof globalThis.Blob !== "undefined" && body instanceof globalThis.Blob;
+/**
+ * The body cut into parts, each one plain bytes so it can be retried and sent by browsers that
+ * cannot stream request bodies. In-memory bodies are cut into views without copying; a `Blob` is
+ * sliced and each slice read only when its upload starts; a stream is regrouped as it is read.
+ */
+const bodyParts = (body, size) => {
+    if (typeof body === "string" || body instanceof Uint8Array) {
+        const bytes = typeof body === "string" ? textEncoder.encode(body) : body;
+        return Stream.fromIterable(partRanges(bytes.length, size).map(([start, end]) => Effect.succeed(bytes.subarray(start, end))));
+    }
+    if (isBlob(body)) {
+        // A Blob that cannot be read is a defect, as in `bodyStream`.
+        return Stream.fromIterable(partRanges(body.size, size).map(([start, end]) => Effect.map(Effect.promise(() => body.slice(start, end).arrayBuffer()), (buffer) => new Uint8Array(buffer))));
+    }
+    return body.pipe(regroupParts(size), Stream.map(Effect.succeed));
+};
+const sumLoaded = (loadedByPart) => {
+    let loaded = 0;
+    for (const partLoaded of loadedByPart.values())
+        loaded += partLoaded;
+    return loaded;
+};
+/** The SDK's aggregate event: bytes sent by every part, against the body's known size. */
+const aggregateProgress = (loadedByPart, totalToLoad) => {
+    const loaded = sumLoaded(loadedByPart);
+    return {
+        loaded,
+        total: totalToLoad || loaded,
+        percentage: totalToLoad > 0 ? Number(((loaded / totalToLoad) * 100).toFixed(2)) : 0,
+    };
+};
+/**
+ * Upload a body with a multipart upload, as the SDK's `uncontrolledMultipartUpload`: create it,
+ * send the body in {@link multipartPartSize} parts (the last one smaller) with bounded concurrency,
+ * then complete it with the parts in part-number order. Every request carries the
+ * `writeOptions.create` headers, as the SDK resends the `put` headers.
+ *
+ * - `maximumSizeInBytes` is checked against the known size before any request.
+ * - Memory stays bounded: a part's bytes are produced only when an upload slot is free, so at most
+ *   `concurrency` parts (plus the parts cut from the stream chunk being read) are held at once.
+ * - The first failure, of a part or of the body stream, interrupts the parts in flight; the upload
+ *   is then not completed.
+ * - An empty body uploads no part and completes with an empty part list, as the SDK does.
+ * - Progress: 0 % once the upload is created, then the bytes sent by all parts summed and
+ *   throttled to one event per {@link multipartProgressInterval} (the SDK's numbers, rounded to two
+ *   decimals). The event in which every byte has been acknowledged is held back, and
+ *   `{ loaded, total: loaded, percentage: 100 }` is reported once the upload is completed instead.
+ *
+ * @returns The stored blob; fails with `BlobUploadRejected` for an oversized body, the requests'
+ *   errors, or the body stream's error.
+ */
+export const multipartPut = Effect.fnUntraced(function* (target, pathname, body, options) {
+    const totalToLoad = bodyLength(body);
+    const maximum = options.maximumSizeInBytes;
+    if (maximum !== undefined && !Stream.isStream(body) && totalToLoad > maximum) {
+        return yield* new BlobUploadRejected({
+            reason: new FileTooLarge({
+                message: `Body size of ${totalToLoad} bytes exceeds the maximum allowed size of ${maximum} bytes`,
+            }),
+        });
+    }
+    const step = {
+        target,
+        pathname,
+        headers: writeHeaders(target.writeOptions.create, options),
+    };
+    const service = target.service;
+    const { key, uploadId } = yield* createRequest(step).pipe(Effect.withSpan(`${service}.createMultipartUpload`));
+    const onUploadProgress = options.onUploadProgress;
+    const loadedByPart = yield* SynchronizedRef.make(new Map());
+    const uploadParts = (report) => bodyParts(body, multipartPartSize).pipe(Stream.mapEffect((source, index) => Effect.gen(function* () {
+        const partNumber = index + 1;
+        const bytes = yield* source;
+        const { etag } = yield* uploadPartRequest(step, {
+            key,
+            uploadId,
+            partNumber,
+            body: bytes,
+            onUploadProgress: report?.(partNumber),
+            contentType: "application/octet-stream",
+        });
+        return { etag, partNumber };
+    }).pipe(Effect.withSpan(`${service}.uploadPart`, { attributes: { partNumber: index + 1 } })), { concurrency: options.concurrency ?? maxConcurrentPartUploads(), unordered: true }), Stream.runCollect);
+    const complete = (parts) => completeRequest(step, {
+        key,
+        uploadId,
+        parts: [...parts].sort((a, b) => a.partNumber - b.partNumber),
+        partNumberFirst: true,
+    }).pipe(Effect.withSpan(`${service}.completeMultipartUpload`));
+    if (onUploadProgress === undefined) {
+        return yield* Effect.flatMap(uploadParts(undefined), complete);
+    }
+    yield* onUploadProgress({ loaded: 0, total: totalToLoad, percentage: 0 });
+    const reporter = yield* uploadProgressThrottle(onUploadProgress, multipartProgressInterval);
+    // Updating the sums and offering the event under one lock keeps events in sending order. The SDK
+    // also reports the aggregate in which every byte is acknowledged; it is left for the final event.
+    const partProgress = (partNumber) => (progress) => SynchronizedRef.updateEffect(loadedByPart, (current) => {
+        const next = new Map(current).set(partNumber, progress.loaded);
+        const event = aggregateProgress(next, totalToLoad);
+        const acknowledged = totalToLoad > 0 && event.loaded >= totalToLoad;
+        return Effect.as(acknowledged ? Effect.void : reporter.report(event), next);
+    });
+    const blob = yield* uploadParts(partProgress).pipe(Effect.flatMap(complete), Effect.ensuring(reporter.stop));
+    const loaded = sumLoaded(yield* SynchronizedRef.get(loadedByPart));
+    yield* onUploadProgress({ loaded, total: loaded, percentage: 100 });
+    return blob;
+});
+//# sourceMappingURL=multipart.js.map

package/dist/internal/multipart.js.map

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