@velajs/storage 0.3.0 → 0.3.2

package/dist/protocol.types-C5PPBD12.d.ts

@@ -0,0 +1,80 @@
+import { A as UploadResult, b as SignedUpload, j as UploadedPart } from "./storage.types-BJN7Yp1J.js";
+//#region src/http/protocol.types.d.ts
+interface SignUploadRequest {
+  key: string;
+  contentType?: string;
+  size?: number;
+  metadata?: Record<string, string>;
+  expiresIn?: number;
+}
+interface MultipartCreateRequest {
+  key: string;
+  contentType?: string;
+  metadata?: Record<string, string>;
+  partSize?: number;
+}
+interface SignPartRequest {
+  key: string;
+  uploadId: string;
+  partNumber: number;
+}
+interface MultipartCompleteRequest {
+  key: string;
+  uploadId: string;
+  parts: UploadedPart[];
+}
+interface MultipartAbortRequest {
+  key: string;
+  uploadId: string;
+}
+interface DeleteRequest {
+  keys: string[];
+}
+interface SignUploadResponse {
+  key: string;
+  upload: SignedUpload;
+}
+interface MultipartCreateResponse {
+  key: string;
+  uploadId: string;
+  partSize: number;
+}
+interface SignPartResponse {
+  partNumber: number;
+  method: 'PUT';
+  url: string;
+  headers?: Record<string, string>;
+}
+type MultipartCompleteResponse = UploadResult;
+interface OkResponse {
+  ok: true;
+}
+/** JSON-safe {@link StoredFile} projection (no body accessors). */
+interface StoredFileMeta {
+  key: string;
+  name: string;
+  size: number;
+  type: string;
+  lastModified?: number;
+  etag?: string;
+  metadata?: Record<string, string>;
+}
+interface ListResponse {
+  items: StoredFileMeta[];
+  prefixes?: string[];
+  cursor?: string;
+}
+interface SignDownloadResponse {
+  url: string;
+  expiresAt: number;
+}
+type StorageWireErrorCode = 'forbidden' | 'invalid_key' | 'invalid_request' | 'not_found' | 'conflict' | 'rate_limited' | 'capability_unsupported' | 'upstream_error';
+interface StorageErrorBody {
+  error: {
+    code: StorageWireErrorCode;
+    message: string;
+  };
+}
+//#endregion
+export { MultipartCompleteResponse as a, OkResponse as c, SignPartResponse as d, SignUploadRequest as f, StoredFileMeta as g, StorageWireErrorCode as h, MultipartCompleteRequest as i, SignDownloadResponse as l, StorageErrorBody as m, ListResponse as n, MultipartCreateRequest as o, SignUploadResponse as p, MultipartAbortRequest as r, MultipartCreateResponse as s, DeleteRequest as t, SignPartRequest as u };
+//# sourceMappingURL=protocol.types-C5PPBD12.d.ts.map

package/dist/r2.types-Bw4Ft83t.d.ts

@@ -0,0 +1,71 @@
+//#region src/drivers/r2/r2.types.d.ts
+type R2PutValue = ReadableStream | ArrayBuffer | ArrayBufferView | string | Blob | null;
+interface R2HttpMetadataLike {
+  contentType?: string;
+  cacheControl?: string;
+}
+interface R2PutOptionsLike {
+  httpMetadata?: R2HttpMetadataLike;
+  customMetadata?: Record<string, string>;
+}
+interface R2GetOptionsLike {
+  range?: {
+    offset?: number;
+    length?: number;
+    suffix?: number;
+  };
+}
+interface R2ListOptionsLike {
+  prefix?: string;
+  cursor?: string;
+  limit?: number;
+  delimiter?: string;
+}
+interface R2ObjectLike {
+  key: string;
+  size: number;
+  etag: string;
+  uploaded: Date;
+  httpMetadata?: R2HttpMetadataLike;
+  customMetadata?: Record<string, string>;
+}
+interface R2ObjectBodyLike extends R2ObjectLike {
+  body: ReadableStream;
+  arrayBuffer(): Promise<ArrayBuffer>;
+}
+interface R2ListResultLike {
+  objects: R2ObjectLike[];
+  truncated: boolean;
+  cursor?: string;
+  delimitedPrefixes: string[];
+}
+interface R2UploadedPartLike {
+  partNumber: number;
+  etag: string;
+}
+interface R2MultipartUploadLike {
+  readonly uploadId: string;
+  uploadPart(partNumber: number, value: R2PutValue): Promise<R2UploadedPartLike>;
+  complete(parts: R2UploadedPartLike[]): Promise<R2ObjectLike>;
+  abort(): Promise<void>;
+}
+interface R2BucketLike {
+  put(key: string, value: R2PutValue, options?: R2PutOptionsLike): Promise<R2ObjectLike | null>;
+  get(key: string, options?: R2GetOptionsLike): Promise<R2ObjectBodyLike | null>;
+  head(key: string): Promise<R2ObjectLike | null>;
+  delete(keys: string | string[]): Promise<void>;
+  list(options?: R2ListOptionsLike): Promise<R2ListResultLike>;
+  createMultipartUpload(key: string, options?: R2PutOptionsLike): Promise<R2MultipartUploadLike>;
+  resumeMultipartUpload?(key: string, uploadId: string): R2MultipartUploadLike;
+}
+interface R2DriverOptions {
+  /** The Workers `R2Bucket` binding (e.g. `env.MY_BUCKET` or `R2Service.bucket`). */
+  bucket: R2BucketLike;
+  /** Public origin (r2.dev subdomain / custom domain) so `url()` can return a link. */
+  publicBaseUrl?: string;
+  /** Friendly driver name (defaults to `r2`). */
+  name?: string;
+}
+//#endregion
+export { R2ObjectLike as a, R2ObjectBodyLike as i, R2DriverOptions as n, R2MultipartUploadLike as r, R2BucketLike as t };
+//# sourceMappingURL=r2.types-Bw4Ft83t.d.ts.map

package/dist/retry-DXtO6R9D.js

@@ -0,0 +1,119 @@
+import { n as isAbort, t as StorageError } from "./storage.error-DVCOkJhc.js";
+//#region src/internal/retry.ts
+/**
+* Combine multiple abort signals into one. The result aborts as soon as any
+* input aborts, adopting that input's reason. Listeners are cleaned up on
+* first abort. `undefined` inputs are ignored.
+*/
+function anySignal(signals) {
+	const controller = new AbortController();
+	const live = signals.filter((s) => s != null);
+	const onAbort = (reason) => {
+		cleanup();
+		if (!controller.signal.aborted) controller.abort(reason);
+	};
+	const cleanup = () => {
+		for (const s of live) s.removeEventListener("abort", handlers.get(s));
+	};
+	const handlers = /* @__PURE__ */ new Map();
+	for (const s of live) {
+		if (s.aborted) {
+			controller.abort(s.reason);
+			return controller.signal;
+		}
+		const h = () => onAbort(s.reason);
+		handlers.set(s, h);
+		s.addEventListener("abort", h, { once: true });
+	}
+	return controller.signal;
+}
+/** A controller that aborts after `ms`; call `clear()` to cancel the timer. */
+function timeoutController(ms) {
+	const controller = new AbortController();
+	const timer = setTimeout(() => {
+		controller.abort(new StorageError("Timeout", `operation timed out after ${ms}ms`));
+	}, ms);
+	return {
+		controller,
+		clear: () => clearTimeout(timer)
+	};
+}
+/** Resolve after `ms`, or reject with `Aborted` if `signal` fires first. */
+function sleep(ms, signal) {
+	return new Promise((resolve, reject) => {
+		if (signal?.aborted) {
+			reject(new StorageError("Aborted", "operation aborted"));
+			return;
+		}
+		const timer = setTimeout(() => {
+			signal?.removeEventListener("abort", onAbort);
+			resolve();
+		}, ms);
+		const onAbort = () => {
+			clearTimeout(timer);
+			reject(new StorageError("Aborted", "operation aborted"));
+		};
+		signal?.addEventListener("abort", onAbort, { once: true });
+	});
+}
+const DEFAULT_BASE_MS = 100;
+const DEFAULT_CAP_MS = 2e3;
+function defaultBackoff({ attempt }) {
+	return Math.min(DEFAULT_CAP_MS, DEFAULT_BASE_MS * 2 ** (attempt - 1)) + Math.floor(Math.random() * DEFAULT_BASE_MS);
+}
+function normalizeRetry(retries) {
+	if (retries == null) return {
+		max: 0,
+		backoff: defaultBackoff
+	};
+	if (typeof retries === "number") return {
+		max: Math.max(0, retries),
+		backoff: defaultBackoff
+	};
+	return {
+		max: Math.max(0, retries.max),
+		backoff: retries.backoff ?? defaultBackoff
+	};
+}
+/**
+* Run `fn` with per-attempt timeout, caller-abort propagation, and
+* retryable-error backoff. `fn` receives the combined per-attempt signal.
+*
+* - Caller-abort (`opts.signal`) → `Aborted`, never retried.
+* - Per-attempt timeout → `Timeout` (retryable by default, within budget).
+* - Only errors with `error.retryable` are retried, up to `retries.max`.
+*/
+async function runWithRetry(fn, opts, onRetry) {
+	const { max, backoff } = normalizeRetry(opts.retries);
+	const useTimeout = typeof opts.timeout === "number" && opts.timeout > 0;
+	let attempt = 0;
+	for (;;) {
+		if (opts.signal?.aborted) throw new StorageError("Aborted", "operation aborted");
+		const to = useTimeout ? timeoutController(opts.timeout) : void 0;
+		const signal = to ? anySignal([opts.signal, to.controller.signal]) : opts.signal;
+		try {
+			return await fn(signal);
+		} catch (e) {
+			if (opts.signal?.aborted) throw new StorageError("Aborted", "operation aborted", { cause: e });
+			const error = to?.controller.signal.aborted && isAbort(e) ? new StorageError("Timeout", `operation timed out after ${opts.timeout}ms`, { cause: e }) : StorageError.wrap(e);
+			if (attempt >= max || !error.retryable) throw error;
+			attempt += 1;
+			const delayMs = Math.max(0, backoff({
+				attempt,
+				error
+			}));
+			onRetry?.({
+				attempt,
+				delayMs,
+				error
+			});
+			await sleep(delayMs, opts.signal);
+		} finally {
+			to?.clear();
+		}
+	}
+}
+//#endregion
+export { runWithRetry as n, normalizeRetry as t };
+
+//# sourceMappingURL=retry-DXtO6R9D.js.map

package/dist/retry-DXtO6R9D.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-DXtO6R9D.js","names":[],"sources":["../src/internal/retry.ts"],"sourcesContent":["import { StorageError, isAbort } from '../storage.error';\nimport type { RetryOptions } from '../storage.types';\n\n// Retry/timeout/abort plumbing. Deliberately does NOT use `AbortSignal.any`\n// (only added in Node 20.3 — `engines.node >= 20` allows 20.0–20.2) nor\n// `AbortSignal.timeout`; both are re-implemented from `AbortController` +\n// `setTimeout` so the package runs on every target from 20.0 up.\n\n/**\n * Combine multiple abort signals into one. The result aborts as soon as any\n * input aborts, adopting that input's reason. Listeners are cleaned up on\n * first abort. `undefined` inputs are ignored.\n */\nexport function anySignal(signals: Array<AbortSignal | undefined>): AbortSignal {\n  const controller = new AbortController();\n  const live = signals.filter((s): s is AbortSignal => s != null);\n\n  const onAbort = (reason: unknown) => {\n    cleanup();\n    if (!controller.signal.aborted) controller.abort(reason);\n  };\n  const cleanup = () => {\n    for (const s of live) s.removeEventListener('abort', handlers.get(s)!);\n  };\n  const handlers = new Map<AbortSignal, () => void>();\n\n  for (const s of live) {\n    if (s.aborted) {\n      controller.abort(s.reason);\n      return controller.signal;\n    }\n    const h = () => onAbort(s.reason);\n    handlers.set(s, h);\n    s.addEventListener('abort', h, { once: true });\n  }\n  return controller.signal;\n}\n\n/** A controller that aborts after `ms`; call `clear()` to cancel the timer. */\nexport function timeoutController(ms: number): { controller: AbortController; clear: () => void } {\n  const controller = new AbortController();\n  const timer = setTimeout(() => {\n    controller.abort(new StorageError('Timeout', `operation timed out after ${ms}ms`));\n  }, ms);\n  return { controller, clear: () => clearTimeout(timer) };\n}\n\n/** Resolve after `ms`, or reject with `Aborted` if `signal` fires first. */\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new StorageError('Aborted', 'operation aborted'));\n      return;\n    }\n    const timer = setTimeout(() => {\n      signal?.removeEventListener('abort', onAbort);\n      resolve();\n    }, ms);\n    const onAbort = () => {\n      clearTimeout(timer);\n      reject(new StorageError('Aborted', 'operation aborted'));\n    };\n    signal?.addEventListener('abort', onAbort, { once: true });\n  });\n}\n\nexport interface NormalizedRetry {\n  max: number;\n  backoff: (ctx: { attempt: number; error: StorageError }) => number;\n}\n\nconst DEFAULT_BASE_MS = 100;\nconst DEFAULT_CAP_MS = 2000;\n\nfunction defaultBackoff({ attempt }: { attempt: number }): number {\n  const expo = Math.min(DEFAULT_CAP_MS, DEFAULT_BASE_MS * 2 ** (attempt - 1));\n  return expo + Math.floor(Math.random() * DEFAULT_BASE_MS); // full-ish jitter\n}\n\nexport function normalizeRetry(retries: RetryOptions | undefined): NormalizedRetry {\n  if (retries == null) return { max: 0, backoff: defaultBackoff };\n  if (typeof retries === 'number') return { max: Math.max(0, retries), backoff: defaultBackoff };\n  return { max: Math.max(0, retries.max), backoff: retries.backoff ?? defaultBackoff };\n}\n\nexport interface RunOptions {\n  retries?: RetryOptions;\n  timeout?: number;\n  signal?: AbortSignal;\n}\n\n/**\n * Run `fn` with per-attempt timeout, caller-abort propagation, and\n * retryable-error backoff. `fn` receives the combined per-attempt signal.\n *\n * - Caller-abort (`opts.signal`) → `Aborted`, never retried.\n * - Per-attempt timeout → `Timeout` (retryable by default, within budget).\n * - Only errors with `error.retryable` are retried, up to `retries.max`.\n */\nexport async function runWithRetry<T>(\n  fn: (signal: AbortSignal | undefined) => Promise<T>,\n  opts: RunOptions,\n  onRetry?: (info: { attempt: number; delayMs: number; error: StorageError }) => void,\n): Promise<T> {\n  const { max, backoff } = normalizeRetry(opts.retries);\n  const useTimeout = typeof opts.timeout === 'number' && opts.timeout > 0;\n\n  let attempt = 0;\n  for (;;) {\n    if (opts.signal?.aborted) throw new StorageError('Aborted', 'operation aborted');\n\n    const to = useTimeout ? timeoutController(opts.timeout!) : undefined;\n    const signal = to ? anySignal([opts.signal, to.controller.signal]) : opts.signal;\n\n    try {\n      return await fn(signal);\n    } catch (e) {\n      // Hard caller cancellation: never retried.\n      if (opts.signal?.aborted)\n        throw new StorageError('Aborted', 'operation aborted', { cause: e });\n\n      const error =\n        to?.controller.signal.aborted && isAbort(e)\n          ? new StorageError('Timeout', `operation timed out after ${opts.timeout}ms`, { cause: e })\n          : StorageError.wrap(e);\n\n      if (attempt >= max || !error.retryable) throw error;\n\n      attempt += 1;\n      const delayMs = Math.max(0, backoff({ attempt, error }));\n      onRetry?.({ attempt, delayMs, error });\n      await sleep(delayMs, opts.signal);\n    } finally {\n      to?.clear();\n    }\n  }\n}\n"],"mappings":"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"}