@velajs/storage 0.3.1 → 0.3.2

package/dist/storagesdk/index.js

@@ -1,136 +1,123 @@
-import { byteLengthOf } from "../internal/body.js";
-import { createStoredFile } from "../internal/stored-file.js";
-import { StorageError } from "../storage.error.js";
+import { t as byteLengthOf } from "../body-BMUcBeQ0.js";
+import { t as StorageError } from "../storage.error-DVCOkJhc.js";
+import { t as createStoredFile } from "../stored-file-2Yl07eRc.js";
+//#region src/storagesdk/index.ts
 function toMillis(d) {
-    if (d == null) return undefined;
-    return d instanceof Date ? d.getTime() : d;
+	if (d == null) return void 0;
+	return d instanceof Date ? d.getTime() : d;
 }
 function metaOf(item) {
-    return {
-        key: item.path,
-        size: item.size,
-        type: item.contentType || 'application/octet-stream',
-        etag: item.etag,
-        lastModified: toMillis(item.lastModified),
-        metadata: item.metadata
-    };
+	return {
+		key: item.path,
+		size: item.size,
+		type: item.contentType || "application/octet-stream",
+		etag: item.etag,
+		lastModified: toMillis(item.lastModified),
+		metadata: item.metadata
+	};
 }
 /**
- * Adapt a `@storagesdk/adapters` adapter to a {@link StorageDriver}.
- *
- * storagesdk's shape differs from ours (path-based; `download` returns buffered
- * bytes rather than a stream; no first-class multipart or capability flags),
- * so this is an explicit mapping. Multipart / presigned-multipart are not
- * exposed (the facade will gate them as `Unsupported`).
- */ export function storageSdkDriver(adapter, options) {
-    const hasUploadUrl = typeof adapter.signedUploadUrl === 'function';
-    const driver = {
-        name: `storagesdk:${adapter.name ?? 'adapter'}`,
-        raw: adapter.raw,
-        supportsRange: options?.supportsRange ?? false,
-        supportsDelimiter: options?.supportsDelimiter ?? false,
-        supportsMetadata: options?.supportsMetadata ?? true,
-        supportsCacheControl: options?.supportsCacheControl ?? false,
-        supportsServerSideCopy: true,
-        reportsUploadProgress: false,
-        signedUrl: {
-            supported: typeof adapter.url === 'function',
-            upload: hasUploadUrl
-        },
-        async upload (key, body, opts) {
-            const r = await adapter.upload(key, body, {
-                contentType: opts?.contentType,
-                metadata: opts?.metadata,
-                signal: opts?.signal
-            });
-            return {
-                key,
-                size: r?.size ?? byteLengthOf(body) ?? 0,
-                contentType: opts?.contentType ?? r?.contentType ?? 'application/octet-stream',
-                etag: r?.etag,
-                lastModified: toMillis(r?.lastModified)
-            };
-        },
-        async download (key, opts) {
-            const item = await adapter.download(key, {
-                signal: opts?.signal
-            });
-            return createStoredFile(metaOf(item), {
-                kind: 'bytes',
-                bytes: item.body
-            });
-        },
-        async head (key, opts) {
-            const item = await adapter.head(key, {
-                signal: opts?.signal
-            });
-            return createStoredFile(metaOf(item), {
-                kind: 'lazy',
-                fetch: async ()=>new Response((await adapter.download(key)).body)
-            });
-        },
-        async exists (key, opts) {
-            if (adapter.exists) return adapter.exists(key, {
-                signal: opts?.signal
-            });
-            try {
-                await adapter.head(key, {
-                    signal: opts?.signal
-                });
-                return true;
-            } catch (e) {
-                if (e instanceof StorageError && e.code === 'NotFound') return false;
-                if (e && typeof e === 'object' && e.code === 'NotFound') return false;
-                throw e;
-            }
-        },
-        async delete (key, opts) {
-            await adapter.delete(key, {
-                signal: opts?.signal
-            });
-        },
-        async copy (from, to, opts) {
-            await adapter.copy(from, to, {
-                signal: opts?.signal
-            });
-        },
-        async list (opts) {
-            const r = await adapter.list({
-                prefix: opts?.prefix,
-                cursor: opts?.cursor,
-                limit: opts?.limit,
-                delimiter: opts?.delimiter,
-                signal: opts?.signal
-            });
-            return {
-                items: r.items.map((item)=>createStoredFile(metaOf(item), {
-                        kind: 'lazy',
-                        fetch: async ()=>new Response((await adapter.download(item.path)).body)
-                    })),
-                prefixes: r.prefixes,
-                cursor: r.cursor
-            };
-        },
-        async url (key, opts) {
-            return adapter.url(key, {
-                expiresIn: opts?.expiresIn,
-                signal: opts?.signal
-            });
-        },
-        async signedUploadUrl (key, opts) {
-            if (!adapter.signedUploadUrl) {
-                throw new StorageError('Unsupported', 'storagesdk adapter cannot presign uploads');
-            }
-            return adapter.signedUploadUrl(key, {
-                expiresIn: opts.expiresIn,
-                contentType: opts.contentType
-            });
-        }
-    };
-    if (adapter.move) {
-        driver.move = (from, to, opts)=>adapter.move(from, to, {
-                signal: opts?.signal
-            });
-    }
-    return driver;
+* Adapt a `@storagesdk/adapters` adapter to a {@link StorageDriver}.
+*
+* storagesdk's shape differs from ours (path-based; `download` returns buffered
+* bytes rather than a stream; no first-class multipart or capability flags),
+* so this is an explicit mapping. Multipart / presigned-multipart are not
+* exposed (the facade will gate them as `Unsupported`).
+*/
+function storageSdkDriver(adapter, options) {
+	const hasUploadUrl = typeof adapter.signedUploadUrl === "function";
+	const driver = {
+		name: `storagesdk:${adapter.name ?? "adapter"}`,
+		raw: adapter.raw,
+		supportsRange: options?.supportsRange ?? false,
+		supportsDelimiter: options?.supportsDelimiter ?? false,
+		supportsMetadata: options?.supportsMetadata ?? true,
+		supportsCacheControl: options?.supportsCacheControl ?? false,
+		supportsServerSideCopy: true,
+		reportsUploadProgress: false,
+		signedUrl: {
+			supported: typeof adapter.url === "function",
+			upload: hasUploadUrl
+		},
+		async upload(key, body, opts) {
+			const r = await adapter.upload(key, body, {
+				contentType: opts?.contentType,
+				metadata: opts?.metadata,
+				signal: opts?.signal
+			});
+			return {
+				key,
+				size: r?.size ?? byteLengthOf(body) ?? 0,
+				contentType: opts?.contentType ?? r?.contentType ?? "application/octet-stream",
+				etag: r?.etag,
+				lastModified: toMillis(r?.lastModified)
+			};
+		},
+		async download(key, opts) {
+			const item = await adapter.download(key, { signal: opts?.signal });
+			return createStoredFile(metaOf(item), {
+				kind: "bytes",
+				bytes: item.body
+			});
+		},
+		async head(key, opts) {
+			return createStoredFile(metaOf(await adapter.head(key, { signal: opts?.signal })), {
+				kind: "lazy",
+				fetch: async () => new Response((await adapter.download(key)).body)
+			});
+		},
+		async exists(key, opts) {
+			if (adapter.exists) return adapter.exists(key, { signal: opts?.signal });
+			try {
+				await adapter.head(key, { signal: opts?.signal });
+				return true;
+			} catch (e) {
+				if (e instanceof StorageError && e.code === "NotFound") return false;
+				if (e && typeof e === "object" && e.code === "NotFound") return false;
+				throw e;
+			}
+		},
+		async delete(key, opts) {
+			await adapter.delete(key, { signal: opts?.signal });
+		},
+		async copy(from, to, opts) {
+			await adapter.copy(from, to, { signal: opts?.signal });
+		},
+		async list(opts) {
+			const r = await adapter.list({
+				prefix: opts?.prefix,
+				cursor: opts?.cursor,
+				limit: opts?.limit,
+				delimiter: opts?.delimiter,
+				signal: opts?.signal
+			});
+			return {
+				items: r.items.map((item) => createStoredFile(metaOf(item), {
+					kind: "lazy",
+					fetch: async () => new Response((await adapter.download(item.path)).body)
+				})),
+				prefixes: r.prefixes,
+				cursor: r.cursor
+			};
+		},
+		async url(key, opts) {
+			return adapter.url(key, {
+				expiresIn: opts?.expiresIn,
+				signal: opts?.signal
+			});
+		},
+		async signedUploadUrl(key, opts) {
+			if (!adapter.signedUploadUrl) throw new StorageError("Unsupported", "storagesdk adapter cannot presign uploads");
+			return adapter.signedUploadUrl(key, {
+				expiresIn: opts.expiresIn,
+				contentType: opts.contentType
+			});
+		}
+	};
+	if (adapter.move) driver.move = (from, to, opts) => adapter.move(from, to, { signal: opts?.signal });
+	return driver;
 }
+//#endregion
+export { storageSdkDriver };
+
+//# sourceMappingURL=index.js.map

package/dist/storagesdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/storagesdk/index.ts"],"sourcesContent":["import { byteLengthOf } from '../internal/body';\nimport { createStoredFile } from '../internal/stored-file';\nimport { StorageError } from '../storage.error';\nimport type {\n  Body,\n  DownloadOptions,\n  ListOptions,\n  ListResult,\n  OperationOptions,\n  SignUploadOptions,\n  StorageDriver,\n  StoredFile,\n  UploadOptions,\n  UploadResult,\n  UrlOptions,\n} from '../storage.types';\n\n// Opt-in bridge for `@storagesdk/adapters`. It is defined against a STRUCTURAL\n// interface (below) — never an import of `@storagesdk/core` — so this file\n// stays edge-clean and adds no dependency. Bring your own storagesdk adapter;\n// it is structurally assignable. NOTE: whichever storagesdk adapter you\n// construct may pull the AWS SDK / node built-ins, so this subpath is for\n// Node/Bun deployments, never the edge path. It is never re-exported from `.`.\n\n/** Metadata for one storagesdk object (path-based). */\nexport interface StorageSdkItemMeta {\n  path: string;\n  size: number;\n  contentType: string;\n  etag: string;\n  lastModified: Date | number;\n  metadata?: Record<string, string>;\n}\n\n/** A storagesdk download result: metadata plus the buffered body. */\nexport interface StorageSdkItem extends StorageSdkItemMeta {\n  body: Uint8Array<ArrayBuffer>;\n}\n\nexport interface StorageSdkListResult {\n  items: StorageSdkItemMeta[];\n  cursor?: string;\n  prefixes?: string[];\n}\n\n/** The structural subset of a `@storagesdk/adapters` adapter we consume. */\nexport interface StorageSdkAdapterLike<Raw = unknown> {\n  readonly name?: string;\n  readonly raw?: Raw;\n  download(path: string, opts?: { signal?: AbortSignal }): Promise<StorageSdkItem>;\n  head(path: string, opts?: { signal?: AbortSignal }): Promise<StorageSdkItemMeta>;\n  list(opts?: {\n    prefix?: string;\n    cursor?: string;\n    limit?: number;\n    delimiter?: string;\n    signal?: AbortSignal;\n  }): Promise<StorageSdkListResult>;\n  url(path: string, opts?: { expiresIn?: number; signal?: AbortSignal }): Promise<string>;\n  upload(\n    path: string,\n    body: Body,\n    opts?: { contentType?: string; metadata?: Record<string, string>; signal?: AbortSignal },\n  ): Promise<StorageSdkItemMeta | void>;\n  delete(path: string, opts?: { signal?: AbortSignal }): Promise<void>;\n  copy(from: string, to: string, opts?: { signal?: AbortSignal }): Promise<void>;\n  move?(from: string, to: string, opts?: { signal?: AbortSignal }): Promise<void>;\n  exists?(path: string, opts?: { signal?: AbortSignal }): Promise<boolean>;\n  signedUploadUrl?(\n    path: string,\n    opts: { expiresIn: number; contentType?: string },\n  ): Promise<{ method: 'PUT'; url: string; headers?: Record<string, string> }>;\n}\n\nexport interface StorageSdkBridgeOptions {\n  /** Advertise range support (only if your adapter honors `range`). Default false. */\n  supportsRange?: boolean;\n  /** Advertise delimiter/prefix support. Default false. */\n  supportsDelimiter?: boolean;\n  /** Advertise arbitrary metadata support. Default true. */\n  supportsMetadata?: boolean;\n  /** Advertise cache-control support. Default false. */\n  supportsCacheControl?: boolean;\n}\n\nfunction toMillis(d: Date | number | undefined): number | undefined {\n  if (d == null) return undefined;\n  return d instanceof Date ? d.getTime() : d;\n}\n\nfunction metaOf(item: StorageSdkItemMeta) {\n  return {\n    key: item.path,\n    size: item.size,\n    type: item.contentType || 'application/octet-stream',\n    etag: item.etag,\n    lastModified: toMillis(item.lastModified),\n    metadata: item.metadata,\n  };\n}\n\n/**\n * Adapt a `@storagesdk/adapters` adapter to a {@link StorageDriver}.\n *\n * storagesdk's shape differs from ours (path-based; `download` returns buffered\n * bytes rather than a stream; no first-class multipart or capability flags),\n * so this is an explicit mapping. Multipart / presigned-multipart are not\n * exposed (the facade will gate them as `Unsupported`).\n */\nexport function storageSdkDriver<Raw = unknown>(\n  adapter: StorageSdkAdapterLike<Raw>,\n  options?: StorageSdkBridgeOptions,\n): StorageDriver<Raw> {\n  const hasUploadUrl = typeof adapter.signedUploadUrl === 'function';\n\n  const driver: StorageDriver<Raw> = {\n    name: `storagesdk:${adapter.name ?? 'adapter'}`,\n    raw: adapter.raw as Raw,\n    supportsRange: options?.supportsRange ?? false,\n    supportsDelimiter: options?.supportsDelimiter ?? false,\n    supportsMetadata: options?.supportsMetadata ?? true,\n    supportsCacheControl: options?.supportsCacheControl ?? false,\n    supportsServerSideCopy: true,\n    reportsUploadProgress: false,\n    signedUrl: { supported: typeof adapter.url === 'function', upload: hasUploadUrl },\n\n    async upload(key: string, body: Body, opts?: UploadOptions): Promise<UploadResult> {\n      const r = await adapter.upload(key, body, {\n        contentType: opts?.contentType,\n        metadata: opts?.metadata,\n        signal: opts?.signal,\n      });\n      return {\n        key,\n        size: r?.size ?? byteLengthOf(body) ?? 0,\n        contentType: opts?.contentType ?? r?.contentType ?? 'application/octet-stream',\n        etag: r?.etag,\n        lastModified: toMillis(r?.lastModified),\n      };\n    },\n\n    async download(key: string, opts?: DownloadOptions): Promise<StoredFile> {\n      const item = await adapter.download(key, { signal: opts?.signal });\n      return createStoredFile(metaOf(item), { kind: 'bytes', bytes: item.body });\n    },\n\n    async head(key: string, opts?: OperationOptions): Promise<StoredFile> {\n      const item = await adapter.head(key, { signal: opts?.signal });\n      return createStoredFile(metaOf(item), {\n        kind: 'lazy',\n        fetch: async () => new Response((await adapter.download(key)).body),\n      });\n    },\n\n    async exists(key: string, opts?: OperationOptions): Promise<boolean> {\n      if (adapter.exists) return adapter.exists(key, { signal: opts?.signal });\n      try {\n        await adapter.head(key, { signal: opts?.signal });\n        return true;\n      } catch (e) {\n        if (e instanceof StorageError && e.code === 'NotFound') return false;\n        if (e && typeof e === 'object' && (e as { code?: string }).code === 'NotFound')\n          return false;\n        throw e;\n      }\n    },\n\n    async delete(key: string, opts?: OperationOptions): Promise<void> {\n      await adapter.delete(key, { signal: opts?.signal });\n    },\n\n    async copy(from: string, to: string, opts?: OperationOptions): Promise<void> {\n      await adapter.copy(from, to, { signal: opts?.signal });\n    },\n\n    async list(opts?: ListOptions): Promise<ListResult> {\n      const r = await adapter.list({\n        prefix: opts?.prefix,\n        cursor: opts?.cursor,\n        limit: opts?.limit,\n        delimiter: opts?.delimiter,\n        signal: opts?.signal,\n      });\n      return {\n        items: r.items.map((item) =>\n          createStoredFile(metaOf(item), {\n            kind: 'lazy',\n            fetch: async () => new Response((await adapter.download(item.path)).body),\n          }),\n        ),\n        prefixes: r.prefixes,\n        cursor: r.cursor,\n      };\n    },\n\n    async url(key: string, opts?: UrlOptions): Promise<string> {\n      return adapter.url(key, { expiresIn: opts?.expiresIn, signal: opts?.signal });\n    },\n\n    async signedUploadUrl(key: string, opts: SignUploadOptions) {\n      if (!adapter.signedUploadUrl) {\n        throw new StorageError('Unsupported', 'storagesdk adapter cannot presign uploads');\n      }\n      return adapter.signedUploadUrl(key, {\n        expiresIn: opts.expiresIn,\n        contentType: opts.contentType,\n      });\n    },\n  };\n\n  if (adapter.move) {\n    driver.move = (from, to, opts) => adapter.move!(from, to, { signal: opts?.signal });\n  }\n  return driver;\n}\n"],"mappings":"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"}

package/dist/stored-file-2Yl07eRc.js

@@ -0,0 +1,105 @@
+import { t as StorageError } from "./storage.error-DVCOkJhc.js";
+//#region src/internal/stored-file.ts
+function nameFromKey(key) {
+	const i = key.lastIndexOf("/");
+	return i === -1 ? key : key.slice(i + 1);
+}
+function bytesToStream(bytes) {
+	return new ReadableStream({ start(controller) {
+		controller.enqueue(bytes);
+		controller.close();
+	} });
+}
+function toArrayBuffer(bytes) {
+	const ab = new ArrayBuffer(bytes.byteLength);
+	new Uint8Array(ab).set(bytes);
+	return ab;
+}
+var StoredFileImpl = class {
+	key;
+	name;
+	size;
+	type;
+	lastModified;
+	etag;
+	metadata;
+	#source;
+	#bytes;
+	#streamTaken = false;
+	constructor(meta, source) {
+		this.key = meta.key;
+		this.name = meta.name ?? nameFromKey(meta.key);
+		this.size = meta.size;
+		this.type = meta.type ?? "application/octet-stream";
+		this.lastModified = meta.lastModified;
+		this.etag = meta.etag;
+		this.metadata = meta.metadata;
+		this.#source = source;
+		if (source.kind === "bytes") this.#bytes = source.bytes;
+	}
+	async #buffer() {
+		if (this.#bytes) return this.#bytes;
+		const s = this.#source;
+		if (s.kind === "bytes") {
+			this.#bytes = s.bytes;
+			return this.#bytes;
+		}
+		if (s.kind === "stream") {
+			if (this.#streamTaken) throw new StorageError("Provider", `body of ${this.key} already consumed`);
+			this.#streamTaken = true;
+			this.#bytes = new Uint8Array(await new Response(s.stream).arrayBuffer());
+			return this.#bytes;
+		}
+		const res = await s.fetch();
+		if (!res.ok) throw StorageError.fromStatus(res.status, `download failed: ${this.key}`);
+		this.#bytes = new Uint8Array(await res.arrayBuffer());
+		return this.#bytes;
+	}
+	async arrayBuffer() {
+		return toArrayBuffer(await this.#buffer());
+	}
+	async text() {
+		return new TextDecoder().decode(await this.#buffer());
+	}
+	async blob() {
+		const b = await this.#buffer();
+		return new Blob([toArrayBuffer(b)], { type: this.type });
+	}
+	stream() {
+		if (this.#bytes) return bytesToStream(this.#bytes);
+		const s = this.#source;
+		if (s.kind === "bytes") return bytesToStream(s.bytes);
+		if (s.kind === "stream") {
+			if (this.#streamTaken) throw new StorageError("Provider", `body of ${this.key} already consumed`);
+			this.#streamTaken = true;
+			return s.stream;
+		}
+		let reader;
+		const fetchFn = s.fetch;
+		const key = this.key;
+		return new ReadableStream({
+			async pull(controller) {
+				let r = reader;
+				if (!r) {
+					const res = await fetchFn();
+					if (!res.ok || !res.body) throw StorageError.fromStatus(res.status, `download failed: ${key}`);
+					r = res.body.getReader();
+					reader = r;
+				}
+				const { done, value } = await r.read();
+				if (done) controller.close();
+				else controller.enqueue(value);
+			},
+			cancel(reason) {
+				return reader?.cancel(reason);
+			}
+		});
+	}
+};
+function createStoredFile(meta, source) {
+	return new StoredFileImpl(meta, source);
+}
+//#endregion
+export { createStoredFile as t };
+
+//# sourceMappingURL=stored-file-2Yl07eRc.js.map

package/dist/stored-file-2Yl07eRc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-file-2Yl07eRc.js","names":["#source","#bytes","#buffer","#streamTaken"],"sources":["../src/internal/stored-file.ts"],"sourcesContent":["import { StorageError } from '../storage.error';\nimport type { StoredFile } from '../storage.types';\n\nexport interface StoredFileMeta {\n  key: string;\n  name?: string;\n  size: number;\n  type?: string;\n  lastModified?: number;\n  etag?: string;\n  metadata?: Record<string, string>;\n}\n\n/**\n * Where a {@link StoredFile}'s bytes come from:\n * - `bytes`  — already in memory (memory driver, buffered reads).\n * - `stream` — a single-use byte stream (a live download response body).\n * - `lazy`   — a thunk that issues the GET on first body access (head()).\n */\nexport type StoredFileSource =\n  | { kind: 'bytes'; bytes: Uint8Array }\n  | { kind: 'stream'; stream: ReadableStream<Uint8Array> }\n  | { kind: 'lazy'; fetch: () => Promise<Response> };\n\nfunction nameFromKey(key: string): string {\n  const i = key.lastIndexOf('/');\n  return i === -1 ? key : key.slice(i + 1);\n}\n\nfunction bytesToStream(bytes: Uint8Array): ReadableStream<Uint8Array> {\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      controller.enqueue(bytes);\n      controller.close();\n    },\n  });\n}\n\nfunction toArrayBuffer(bytes: Uint8Array): ArrayBuffer {\n  const ab = new ArrayBuffer(bytes.byteLength);\n  new Uint8Array(ab).set(bytes);\n  return ab;\n}\n\nclass StoredFileImpl implements StoredFile {\n  readonly key: string;\n  readonly name: string;\n  readonly size: number;\n  readonly type: string;\n  readonly lastModified?: number;\n  readonly etag?: string;\n  readonly metadata?: Record<string, string>;\n\n  #source: StoredFileSource;\n  #bytes: Uint8Array | undefined;\n  #streamTaken = false;\n\n  constructor(meta: StoredFileMeta, source: StoredFileSource) {\n    this.key = meta.key;\n    this.name = meta.name ?? nameFromKey(meta.key);\n    this.size = meta.size;\n    this.type = meta.type ?? 'application/octet-stream';\n    this.lastModified = meta.lastModified;\n    this.etag = meta.etag;\n    this.metadata = meta.metadata;\n    this.#source = source;\n    if (source.kind === 'bytes') this.#bytes = source.bytes;\n  }\n\n  async #buffer(): Promise<Uint8Array> {\n    if (this.#bytes) return this.#bytes;\n    const s = this.#source;\n    if (s.kind === 'bytes') {\n      this.#bytes = s.bytes;\n      return this.#bytes;\n    }\n    if (s.kind === 'stream') {\n      if (this.#streamTaken) {\n        throw new StorageError('Provider', `body of ${this.key} already consumed`);\n      }\n      this.#streamTaken = true;\n      this.#bytes = new Uint8Array(await new Response(s.stream).arrayBuffer());\n      return this.#bytes;\n    }\n    // s.kind === 'lazy'\n    const res = await s.fetch();\n    if (!res.ok) throw StorageError.fromStatus(res.status, `download failed: ${this.key}`);\n    this.#bytes = new Uint8Array(await res.arrayBuffer());\n    return this.#bytes;\n  }\n\n  async arrayBuffer(): Promise<ArrayBuffer> {\n    return toArrayBuffer(await this.#buffer());\n  }\n\n  async text(): Promise<string> {\n    return new TextDecoder().decode(await this.#buffer());\n  }\n\n  async blob(): Promise<Blob> {\n    const b = await this.#buffer();\n    return new Blob([toArrayBuffer(b)], { type: this.type });\n  }\n\n  stream(): ReadableStream<Uint8Array> {\n    if (this.#bytes) return bytesToStream(this.#bytes);\n    const s = this.#source;\n    if (s.kind === 'bytes') return bytesToStream(s.bytes);\n    if (s.kind === 'stream') {\n      if (this.#streamTaken) {\n        throw new StorageError('Provider', `body of ${this.key} already consumed`);\n      }\n      this.#streamTaken = true;\n      return s.stream;\n    }\n    // lazy: fetch on first pull\n    let reader: ReadableStreamDefaultReader<Uint8Array> | undefined;\n    const fetchFn = s.fetch;\n    const key = this.key;\n    return new ReadableStream<Uint8Array>({\n      async pull(controller) {\n        let r = reader;\n        if (!r) {\n          const res = await fetchFn();\n          if (!res.ok || !res.body) {\n            throw StorageError.fromStatus(res.status, `download failed: ${key}`);\n          }\n          r = res.body.getReader();\n          reader = r;\n        }\n        const { done, value } = await r.read();\n        if (done) controller.close();\n        else controller.enqueue(value);\n      },\n      cancel(reason) {\n        return reader?.cancel(reason);\n      },\n    });\n  }\n}\n\nexport function createStoredFile(meta: StoredFileMeta, source: StoredFileSource): StoredFile {\n  return new StoredFileImpl(meta, source);\n}\n"],"mappings":"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"}

package/dist/testing/index.d.ts

@@ -1,17 +1,21 @@
-import type { ListOptions, ListResult, OperationOptions } from '../storage.types';
+import { c as ListOptions, f as OperationOptions, l as ListResult } from "../storage.types-BJN7Yp1J.js";
+//#region src/testing/index.d.ts
 /**
  * The read surface the assertions need. Satisfied by `StorageService`, the
  * `Storage` facade, and a bare `StorageDriver` — anything memory-backed works.
  */
-export interface StorageTarget {
-    exists(key: string, opts?: OperationOptions): Promise<boolean>;
-    list(opts?: ListOptions): Promise<ListResult>;
+interface StorageTarget {
+  exists(key: string, opts?: OperationOptions): Promise<boolean>;
+  list(opts?: ListOptions): Promise<ListResult>;
 }
 /** Assert an object exists at `key`; throws a diagnostic `Error` otherwise. */
-export declare function assertExists(storage: StorageTarget, key: string): Promise<void>;
+declare function assertExists(storage: StorageTarget, key: string): Promise<void>;
 /** Assert nothing is stored at `key`; throws a diagnostic `Error` otherwise. */
-export declare function assertMissing(storage: StorageTarget, key: string): Promise<void>;
+declare function assertMissing(storage: StorageTarget, key: string): Promise<void>;
 /** Assert the disk holds exactly `expected` objects. */
-export declare function assertCount(storage: StorageTarget, expected: number): Promise<void>;
+declare function assertCount(storage: StorageTarget, expected: number): Promise<void>;
 /** Assert exactly `expected` objects exist under `prefix`. */
-export declare function assertCount(storage: StorageTarget, prefix: string, expected: number): Promise<void>;
+declare function assertCount(storage: StorageTarget, prefix: string, expected: number): Promise<void>;
+//#endregion
+export { StorageTarget, assertCount, assertExists, assertMissing };
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.js

@@ -1,57 +1,40 @@
-// @velajs/storage/testing — assertion helpers for tests.
-//
-// Vela has no separate storage fake: the in-package **memory driver IS the
-// fake**. Build a test disk in one obvious line and assert against it —
-// no bootstrap, no subclass:
-//
-//   import { createStorage } from '@velajs/storage';
-//   import { memoryDriver } from '@velajs/storage/drivers/memory';
-//   import { assertExists, assertCount } from '@velajs/storage/testing';
-//
-//   const storage = createStorage({ driver: memoryDriver() });
-//   await storage.upload('avatar.png', bytes);
-//   await assertExists(storage, 'avatar.png');
-//   await assertCount(storage, 'avatars/', 1);
-//
-// For DI/integration tests, register the same driver on the module instead —
-// `StorageModule.forRoot({ driver: memoryDriver() })` — then inject the
-// `StorageService` and pass it to these helpers. Both a `Storage` facade and a
-// `StorageService` satisfy the {@link StorageTarget} surface below.
-//
-// The helpers are thin and framework-free: they throw a plain `Error` with a
-// diagnostic message on failure (no vitest/`expect` dependency), and drive the
-// public `exists`/`list` API so prefix scoping and drivers stay honest.
-/** Assert an object exists at `key`; throws a diagnostic `Error` otherwise. */ export async function assertExists(storage, key) {
-    if (!await storage.exists(key)) {
-        const keys = await collectKeys(storage);
-        throw new Error(`assertExists: expected an object at "${key}" to exist, but it is missing. ` + `Stored: ${keys.length ? keys.join(', ') : '(none)'}`);
-    }
+//#region src/testing/index.ts
+/** Assert an object exists at `key`; throws a diagnostic `Error` otherwise. */
+async function assertExists(storage, key) {
+	if (!await storage.exists(key)) {
+		const keys = await collectKeys(storage);
+		throw new Error(`assertExists: expected an object at "${key}" to exist, but it is missing. Stored: ${keys.length ? keys.join(", ") : "(none)"}`);
+	}
 }
-/** Assert nothing is stored at `key`; throws a diagnostic `Error` otherwise. */ export async function assertMissing(storage, key) {
-    if (await storage.exists(key)) {
-        throw new Error(`assertMissing: expected no object at "${key}", but one exists`);
-    }
+/** Assert nothing is stored at `key`; throws a diagnostic `Error` otherwise. */
+async function assertMissing(storage, key) {
+	if (await storage.exists(key)) throw new Error(`assertMissing: expected no object at "${key}", but one exists`);
 }
-export async function assertCount(storage, prefixOrExpected, maybeExpected) {
-    const prefix = typeof prefixOrExpected === 'string' ? prefixOrExpected : undefined;
-    const expected = typeof prefixOrExpected === 'number' ? prefixOrExpected : maybeExpected;
-    const keys = await collectKeys(storage, prefix);
-    if (keys.length !== expected) {
-        const scope = prefix ? ` under prefix "${prefix}"` : '';
-        const found = keys.length ? `: ${keys.join(', ')}` : '';
-        throw new Error(`assertCount: expected ${expected} object(s)${scope}, but found ${keys.length}${found}`);
-    }
+async function assertCount(storage, prefixOrExpected, maybeExpected) {
+	const prefix = typeof prefixOrExpected === "string" ? prefixOrExpected : void 0;
+	const expected = typeof prefixOrExpected === "number" ? prefixOrExpected : maybeExpected;
+	const keys = await collectKeys(storage, prefix);
+	if (keys.length !== expected) {
+		const scope = prefix ? ` under prefix "${prefix}"` : "";
+		const found = keys.length ? `: ${keys.join(", ")}` : "";
+		throw new Error(`assertCount: expected ${expected} object(s)${scope}, but found ${keys.length}${found}`);
+	}
 }
-/** Walk every listing page (following the cursor) and collect the object keys. */ async function collectKeys(storage, prefix) {
-    const keys = [];
-    let cursor;
-    do {
-        const page = await storage.list({
-            prefix,
-            cursor
-        });
-        for (const item of page.items)keys.push(item.key);
-        cursor = page.cursor;
-    }while (cursor)
-    return keys;
+/** Walk every listing page (following the cursor) and collect the object keys. */
+async function collectKeys(storage, prefix) {
+	const keys = [];
+	let cursor;
+	do {
+		const page = await storage.list({
+			prefix,
+			cursor
+		});
+		for (const item of page.items) keys.push(item.key);
+		cursor = page.cursor;
+	} while (cursor);
+	return keys;
 }
+//#endregion
+export { assertCount, assertExists, assertMissing };
+
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/testing/index.ts"],"sourcesContent":["// @velajs/storage/testing — assertion helpers for tests.\n//\n// Vela has no separate storage fake: the in-package **memory driver IS the\n// fake**. Build a test disk in one obvious line and assert against it —\n// no bootstrap, no subclass:\n//\n//   import { createStorage } from '@velajs/storage';\n//   import { memoryDriver } from '@velajs/storage/drivers/memory';\n//   import { assertExists, assertCount } from '@velajs/storage/testing';\n//\n//   const storage = createStorage({ driver: memoryDriver() });\n//   await storage.upload('avatar.png', bytes);\n//   await assertExists(storage, 'avatar.png');\n//   await assertCount(storage, 'avatars/', 1);\n//\n// For DI/integration tests, register the same driver on the module instead —\n// `StorageModule.forRoot({ driver: memoryDriver() })` — then inject the\n// `StorageService` and pass it to these helpers. Both a `Storage` facade and a\n// `StorageService` satisfy the {@link StorageTarget} surface below.\n//\n// The helpers are thin and framework-free: they throw a plain `Error` with a\n// diagnostic message on failure (no vitest/`expect` dependency), and drive the\n// public `exists`/`list` API so prefix scoping and drivers stay honest.\n\nimport type { ListOptions, ListResult, OperationOptions } from '../storage.types';\n\n/**\n * The read surface the assertions need. Satisfied by `StorageService`, the\n * `Storage` facade, and a bare `StorageDriver` — anything memory-backed works.\n */\nexport interface StorageTarget {\n  exists(key: string, opts?: OperationOptions): Promise<boolean>;\n  list(opts?: ListOptions): Promise<ListResult>;\n}\n\n/** Assert an object exists at `key`; throws a diagnostic `Error` otherwise. */\nexport async function assertExists(storage: StorageTarget, key: string): Promise<void> {\n  if (!(await storage.exists(key))) {\n    const keys = await collectKeys(storage);\n    throw new Error(\n      `assertExists: expected an object at \"${key}\" to exist, but it is missing. ` +\n        `Stored: ${keys.length ? keys.join(', ') : '(none)'}`,\n    );\n  }\n}\n\n/** Assert nothing is stored at `key`; throws a diagnostic `Error` otherwise. */\nexport async function assertMissing(storage: StorageTarget, key: string): Promise<void> {\n  if (await storage.exists(key)) {\n    throw new Error(`assertMissing: expected no object at \"${key}\", but one exists`);\n  }\n}\n\n/** Assert the disk holds exactly `expected` objects. */\nexport function assertCount(storage: StorageTarget, expected: number): Promise<void>;\n/** Assert exactly `expected` objects exist under `prefix`. */\nexport function assertCount(\n  storage: StorageTarget,\n  prefix: string,\n  expected: number,\n): Promise<void>;\nexport async function assertCount(\n  storage: StorageTarget,\n  prefixOrExpected: string | number,\n  maybeExpected?: number,\n): Promise<void> {\n  const prefix = typeof prefixOrExpected === 'string' ? prefixOrExpected : undefined;\n  const expected = typeof prefixOrExpected === 'number' ? prefixOrExpected : maybeExpected!;\n  const keys = await collectKeys(storage, prefix);\n  if (keys.length !== expected) {\n    const scope = prefix ? ` under prefix \"${prefix}\"` : '';\n    const found = keys.length ? `: ${keys.join(', ')}` : '';\n    throw new Error(\n      `assertCount: expected ${expected} object(s)${scope}, but found ${keys.length}${found}`,\n    );\n  }\n}\n\n/** Walk every listing page (following the cursor) and collect the object keys. */\nasync function collectKeys(storage: StorageTarget, prefix?: string): Promise<string[]> {\n  const keys: string[] = [];\n  let cursor: string | undefined;\n  do {\n    const page = await storage.list({ prefix, cursor });\n    for (const item of page.items) keys.push(item.key);\n    cursor = page.cursor;\n  } while (cursor);\n  return keys;\n}\n"],"mappings":";;AAoCA,eAAsB,aAAa,SAAwB,KAA4B;CACrF,IAAI,CAAE,MAAM,QAAQ,OAAO,GAAG,GAAI;EAChC,MAAM,OAAO,MAAM,YAAY,OAAO;EACtC,MAAM,IAAI,MACR,wCAAwC,IAAI,yCAC/B,KAAK,SAAS,KAAK,KAAK,IAAI,IAAI,UAC/C;CACF;AACF;;AAGA,eAAsB,cAAc,SAAwB,KAA4B;CACtF,IAAI,MAAM,QAAQ,OAAO,GAAG,GAC1B,MAAM,IAAI,MAAM,yCAAyC,IAAI,kBAAkB;AAEnF;AAUA,eAAsB,YACpB,SACA,kBACA,eACe;CACf,MAAM,SAAS,OAAO,qBAAqB,WAAW,mBAAmB,KAAA;CACzE,MAAM,WAAW,OAAO,qBAAqB,WAAW,mBAAmB;CAC3E,MAAM,OAAO,MAAM,YAAY,SAAS,MAAM;CAC9C,IAAI,KAAK,WAAW,UAAU;EAC5B,MAAM,QAAQ,SAAS,kBAAkB,OAAO,KAAK;EACrD,MAAM,QAAQ,KAAK,SAAS,KAAK,KAAK,KAAK,IAAI,MAAM;EACrD,MAAM,IAAI,MACR,yBAAyB,SAAS,YAAY,MAAM,cAAc,KAAK,SAAS,OAClF;CACF;AACF;;AAGA,eAAe,YAAY,SAAwB,QAAoC;CACrF,MAAM,OAAiB,CAAC;CACxB,IAAI;CACJ,GAAG;EACD,MAAM,OAAO,MAAM,QAAQ,KAAK;GAAE;GAAQ;EAAO,CAAC;EAClD,KAAK,MAAM,QAAQ,KAAK,OAAO,KAAK,KAAK,KAAK,GAAG;EACjD,SAAS,KAAK;CAChB,SAAS;CACT,OAAO;AACT"}