npm - uploaderkit - Versions diffs - 1.0.0 → 2.0.0 - Mend

uploaderkit 1.0.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (86) hide show

package/LICENSE +21 -0
package/NOTICE +16 -0
package/README.es.md +1140 -0
package/README.md +1135 -0
package/dist/FileViewer-ChTf7-uY.d.cts +49 -0
package/dist/FileViewer-nuD-GEdJ.d.ts +49 -0
package/dist/adapters/gcs.cjs +83 -0
package/dist/adapters/gcs.cjs.map +1 -0
package/dist/adapters/gcs.d.cts +31 -0
package/dist/adapters/gcs.d.ts +31 -0
package/dist/adapters/gcs.js +81 -0
package/dist/adapters/gcs.js.map +1 -0
package/dist/adapters/memory.cjs +27 -0
package/dist/adapters/memory.cjs.map +1 -0
package/dist/adapters/memory.d.cts +18 -0
package/dist/adapters/memory.d.ts +18 -0
package/dist/adapters/memory.js +25 -0
package/dist/adapters/memory.js.map +1 -0
package/dist/adapters/s3.cjs +75 -0
package/dist/adapters/s3.cjs.map +1 -0
package/dist/adapters/s3.d.cts +27 -0
package/dist/adapters/s3.d.ts +27 -0
package/dist/adapters/s3.js +73 -0
package/dist/adapters/s3.js.map +1 -0
package/dist/chunk-3FI44IOW.js +150 -0
package/dist/chunk-3FI44IOW.js.map +1 -0
package/dist/chunk-H7BRW5IY.js +308 -0
package/dist/chunk-H7BRW5IY.js.map +1 -0
package/dist/chunk-PDKAF4GX.js +707 -0
package/dist/chunk-PDKAF4GX.js.map +1 -0
package/dist/chunk-PTEX7F4R.js +309 -0
package/dist/chunk-PTEX7F4R.js.map +1 -0
package/dist/chunk-T5YZG6JW.js +511 -0
package/dist/chunk-T5YZG6JW.js.map +1 -0
package/dist/index.cjs +220 -27
package/dist/index.cjs.map +1 -1
package/dist/index.d.cts +57 -170
package/dist/index.d.ts +57 -170
package/dist/index.js +1 -324
package/dist/index.js.map +1 -1
package/dist/presets.cjs +1665 -0
package/dist/presets.cjs.map +1 -0
package/dist/presets.d.cts +100 -0
package/dist/presets.d.ts +100 -0
package/dist/presets.js +405 -0
package/dist/presets.js.map +1 -0
package/dist/react.cjs +981 -0
package/dist/react.cjs.map +1 -0
package/dist/react.d.cts +106 -0
package/dist/react.d.ts +106 -0
package/dist/react.js +5 -0
package/dist/react.js.map +1 -0
package/dist/server/express.cjs +179 -0
package/dist/server/express.cjs.map +1 -0
package/dist/server/express.d.cts +64 -0
package/dist/server/express.d.ts +64 -0
package/dist/server/express.js +111 -0
package/dist/server/express.js.map +1 -0
package/dist/server/next.cjs +165 -0
package/dist/server/next.cjs.map +1 -0
package/dist/server/next.d.cts +38 -0
package/dist/server/next.d.ts +38 -0
package/dist/server/next.js +107 -0
package/dist/server/next.js.map +1 -0
package/dist/server.cjs +550 -0
package/dist/server.cjs.map +1 -0
package/dist/server.d.cts +19 -0
package/dist/server.d.ts +19 -0
package/dist/server.js +80 -0
package/dist/server.js.map +1 -0
package/dist/storage-CYkSHWZX.d.cts +133 -0
package/dist/storage-Qc9epG0G.d.ts +133 -0
package/dist/types-BSlJJwti.d.cts +341 -0
package/dist/types-BSlJJwti.d.ts +341 -0
package/dist/ui.cjs +2325 -0
package/dist/ui.cjs.map +1 -0
package/dist/ui.d.cts +331 -0
package/dist/ui.d.ts +331 -0
package/dist/ui.js +749 -0
package/dist/ui.js.map +1 -0
package/dist/useSlottedUploader-BzT5jV8c.d.cts +139 -0
package/dist/useSlottedUploader-IkG5RhEO.d.ts +139 -0
package/dist/useUploader-BiBdS-7y.d.cts +117 -0
package/dist/useUploader-CQHpj_oI.d.ts +117 -0
package/package.json +189 -3
package/tailwind.css +80 -0

package/dist/FileViewer-ChTf7-uY.d.cts ADDED Viewed

@@ -0,0 +1,49 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { U as UploaderLabels } from './types-BSlJJwti.cjs';
+/** What the viewer needs to render a file — a StoredFile satisfies it. */
+type ViewableFile = {
+    url: string;
+    fileName?: string;
+    mimeType?: string;
+};
+type FileViewerProps = {
+    /** File to show; `null` keeps the viewer closed. */
+    file: ViewableFile | null;
+    onClose: () => void;
+    /**
+     * The collection to browse. With more than one entry the viewer gains side
+     * arrows and ←/→ keyboard navigation, starting at `file`'s position.
+     */
+    files?: ViewableFile[];
+    /**
+     * Resolve a fresh URL right before rendering — the hook for private scopes,
+     * where the persisted signed URL may have expired and the app re-signs via
+     * its /storage signed-url endpoint.
+     */
+    resolveUrl?: (file: ViewableFile) => Promise<string>;
+    /**
+     * Replaces the built-in "could not load" panel. Receives the file that
+     * failed and a `retry` that re-resolves and re-renders it, so a custom
+     * panel keeps the recovery the default one offers.
+     */
+    renderError?: (context: {
+        file: ViewableFile;
+        retry: () => void;
+    }) => ReactNode;
+    labels?: Partial<UploaderLabels>;
+};
+/**
+ * Full-screen file preview: images zoomed to fit, PDFs embedded, anything
+ * else offered as a download — no more blind new-tab jumps. Pass `files` and
+ * it becomes a gallery: side arrows, ←/→ on the keyboard, a position counter.
+ * Used internally by `Uploader` and `SlottedUploader`, and exported standalone
+ * so any screen can preview the `StoredFile`s it persisted.
+ *
+ * Portals to `<body>` so an ancestor's stacking context can never trap it,
+ * and traps focus while open.
+ */
+declare const FileViewer: ({ file, onClose, files, resolveUrl, renderError, labels, }: FileViewerProps) => react.ReactPortal | null;
+export { type FileViewerProps as F, type ViewableFile as V, FileViewer as a };

package/dist/FileViewer-nuD-GEdJ.d.ts ADDED Viewed

@@ -0,0 +1,49 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { U as UploaderLabels } from './types-BSlJJwti.js';
+/** What the viewer needs to render a file — a StoredFile satisfies it. */
+type ViewableFile = {
+    url: string;
+    fileName?: string;
+    mimeType?: string;
+};
+type FileViewerProps = {
+    /** File to show; `null` keeps the viewer closed. */
+    file: ViewableFile | null;
+    onClose: () => void;
+    /**
+     * The collection to browse. With more than one entry the viewer gains side
+     * arrows and ←/→ keyboard navigation, starting at `file`'s position.
+     */
+    files?: ViewableFile[];
+    /**
+     * Resolve a fresh URL right before rendering — the hook for private scopes,
+     * where the persisted signed URL may have expired and the app re-signs via
+     * its /storage signed-url endpoint.
+     */
+    resolveUrl?: (file: ViewableFile) => Promise<string>;
+    /**
+     * Replaces the built-in "could not load" panel. Receives the file that
+     * failed and a `retry` that re-resolves and re-renders it, so a custom
+     * panel keeps the recovery the default one offers.
+     */
+    renderError?: (context: {
+        file: ViewableFile;
+        retry: () => void;
+    }) => ReactNode;
+    labels?: Partial<UploaderLabels>;
+};
+/**
+ * Full-screen file preview: images zoomed to fit, PDFs embedded, anything
+ * else offered as a download — no more blind new-tab jumps. Pass `files` and
+ * it becomes a gallery: side arrows, ←/→ on the keyboard, a position counter.
+ * Used internally by `Uploader` and `SlottedUploader`, and exported standalone
+ * so any screen can preview the `StoredFile`s it persisted.
+ *
+ * Portals to `<body>` so an ancestor's stacking context can never trap it,
+ * and traps focus while open.
+ */
+declare const FileViewer: ({ file, onClose, files, resolveUrl, renderError, labels, }: FileViewerProps) => react.ReactPortal | null;
+export { type FileViewerProps as F, type ViewableFile as V, FileViewer as a };

package/dist/adapters/gcs.cjs ADDED Viewed

@@ -0,0 +1,83 @@
+'use strict';
+// src/adapters/gcs.ts
+var defaultPublicUrl = (bucketName, key) => `https://storage.googleapis.com/${bucketName}/${encodeURI(key)}`;
+var createGcsProvider = ({
+  publicBucket,
+  privateBucket,
+  publicUrl = defaultPublicUrl
+}) => {
+  let publicAccessChecked = false;
+  const checkPublicAccess = (url, bucketName) => {
+    if (publicAccessChecked) return;
+    publicAccessChecked = true;
+    void fetch(url, { method: "HEAD" }).then((response) => {
+      if (!response.ok) {
+        console.error(
+          `[uploaderkit] gcs: public objects in "${bucketName}" answer ${response.status} \u2014 the bucket is not publicly readable. Grant it once with:
+  gcloud storage buckets add-iam-policy-binding gs://${bucketName} --member=allUsers --role=roles/storage.objectViewer`
+        );
+      }
+    }).catch(() => void 0);
+  };
+  const locate = async (key) => {
+    const [inPrivate] = await privateBucket.file(key).exists();
+    return inPrivate ? privateBucket : publicBucket;
+  };
+  return {
+    name: "gcs",
+    capabilities: { signedUrl: true, resumable: false, rangeRead: true },
+    put: async ({ key, body, contentType, visibility, metadata }) => {
+      const bucket = visibility === "private" ? privateBucket : publicBucket;
+      const file = bucket.file(key);
+      await file.save(Buffer.from(body), {
+        contentType,
+        resumable: false,
+        metadata: { metadata }
+      });
+      if (visibility === "public") {
+        await file.makePublic().catch(() => void 0);
+      }
+      const url = publicUrl(bucket.name, key);
+      if (visibility === "public") checkPublicAccess(url, bucket.name);
+      return { key, url };
+    },
+    get: async (key) => {
+      const bucket = await locate(key);
+      const [data] = await bucket.file(key).download();
+      return new Uint8Array(data);
+    },
+    // `download()` buffers the whole object; a 20MB document costs that per
+    // concurrent request, and materialization serves many at once.
+    getStream: async (key) => {
+      const bucket = await locate(key);
+      return bucket.file(key).createReadStream();
+    },
+    delete: async (key) => {
+      const bucket = await locate(key);
+      return bucket.file(key).delete().then(() => true).catch(() => false);
+    },
+    signedUrl: async (key, { expiresIn, download }) => {
+      const bucket = await locate(key);
+      const [url] = await bucket.file(key).getSignedUrl({
+        version: "v4",
+        action: "read",
+        expires: Date.now() + expiresIn * 1e3,
+        ...download ? { responseDisposition: "attachment" } : {}
+      });
+      return url;
+    },
+    list: async (prefix) => {
+      const [privateFiles] = await privateBucket.getFiles({ prefix });
+      const [publicFiles] = await publicBucket.getFiles({ prefix });
+      return [...privateFiles, ...publicFiles].map((file) => ({
+        key: file.name,
+        size: Number(file.metadata.size ?? 0)
+      }));
+    }
+  };
+};
+exports.createGcsProvider = createGcsProvider;
+//# sourceMappingURL=gcs.cjs.map
+//# sourceMappingURL=gcs.cjs.map

package/dist/adapters/gcs.cjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../../src/adapters/gcs.ts"],"names":[],"mappings":"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","file":"gcs.cjs","sourcesContent":["import type { Bucket } from '@google-cloud/storage'\n\nimport type { StreamingStorageProvider } from '../server/storage'\n\nexport type GcsProviderOptions = {\n\t/** Objects with `visibility: 'public'` land here and get a direct URL. */\n\tpublicBucket: Bucket\n\t/** Objects with `visibility: 'private'` land here; access is signed-only. */\n\tprivateBucket: Bucket\n\t/**\n\t * Direct URL for a public object.\n\t * @defaultValue `https://storage.googleapis.com/{bucket}/{key}`\n\t */\n\tpublicUrl?: (bucketName: string, key: string) => string\n}\n\nconst defaultPublicUrl = (bucketName: string, key: string): string =>\n\t`https://storage.googleapis.com/${bucketName}/${encodeURI(key)}`\n\n/**\n * Google Cloud Storage provider over a two-bucket layout: public assets on\n * one bucket, sensitive documents on another that is never world-readable.\n *\n * `@google-cloud/storage` is an optional peer — importing this module without\n * it installed fails, but only for the app that chose GCS.\n *\n * Reads probe the private bucket first and fall back to the public one; keys\n * are unique per scope path, so a hit in both cannot happen.\n *\n * @see AGENTS.md §6 — why the probe exists\n */\nexport const createGcsProvider = ({\n\tpublicBucket,\n\tprivateBucket,\n\tpublicUrl = defaultPublicUrl,\n}: GcsProviderOptions): StreamingStorageProvider => {\n\t// Under uniform bucket-level access, per-object `makePublic()` fails\n\t// silently and a \"public\" upload 403s in every <img> — a bug that only\n\t// shows as broken avatars. Probe the first public upload's URL once and\n\t// say exactly how to fix the bucket.\n\tlet publicAccessChecked = false\n\tconst checkPublicAccess = (url: string, bucketName: string): void => {\n\t\tif (publicAccessChecked) return\n\t\tpublicAccessChecked = true\n\t\tvoid fetch(url, { method: 'HEAD' })\n\t\t\t.then(response => {\n\t\t\t\tif (!response.ok) {\n\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t`[uploaderkit] gcs: public objects in \"${bucketName}\" answer ${response.status} — the bucket is not publicly readable. Grant it once with:\\n` +\n\t\t\t\t\t\t\t` gcloud storage buckets add-iam-policy-binding gs://${bucketName} --member=allUsers --role=roles/storage.objectViewer`\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t})\n\t\t\t.catch(() => undefined)\n\t}\n\n\tconst locate = async (key: string): Promise<Bucket> => {\n\t\tconst [inPrivate] = await privateBucket.file(key).exists()\n\t\treturn inPrivate ? privateBucket : publicBucket\n\t}\n\n\treturn {\n\t\tname: 'gcs',\n\t\tcapabilities: { signedUrl: true, resumable: false, rangeRead: true },\n\n\t\tput: async ({ key, body, contentType, visibility, metadata }) => {\n\t\t\tconst bucket = visibility === 'private' ? privateBucket : publicBucket\n\t\t\tconst file = bucket.file(key)\n\n\t\t\tawait file.save(Buffer.from(body), {\n\t\t\t\tcontentType,\n\t\t\t\tresumable: false,\n\t\t\t\tmetadata: { metadata },\n\t\t\t})\n\n\t\t\tif (visibility === 'public') {\n\t\t\t\t// Buckets with uniform public access reject per-object ACLs; when\n\t\t\t\t// the bucket itself grants allUsers read, this failure is benign —\n\t\t\t\t// and when it does not, the probe below reports it loudly.\n\t\t\t\tawait file.makePublic().catch(() => undefined)\n\t\t\t}\n\n\t\t\tconst url = publicUrl(bucket.name, key)\n\t\t\tif (visibility === 'public') checkPublicAccess(url, bucket.name)\n\t\t\treturn { key, url }\n\t\t},\n\n\t\tget: async key => {\n\t\t\tconst bucket = await locate(key)\n\t\t\tconst [data] = await bucket.file(key).download()\n\t\t\treturn new Uint8Array(data)\n\t\t},\n\n\t\t// `download()` buffers the whole object; a 20MB document costs that per\n\t\t// concurrent request, and materialization serves many at once.\n\t\tgetStream: async key => {\n\t\t\tconst bucket = await locate(key)\n\t\t\treturn bucket.file(key).createReadStream()\n\t\t},\n\n\t\tdelete: async key => {\n\t\t\tconst bucket = await locate(key)\n\t\t\treturn bucket\n\t\t\t\t.file(key)\n\t\t\t\t.delete()\n\t\t\t\t.then(() => true)\n\t\t\t\t.catch(() => false)\n\t\t},\n\n\t\tsignedUrl: async (key, { expiresIn, download }) => {\n\t\t\tconst bucket = await locate(key)\n\t\t\tconst [url] = await bucket.file(key).getSignedUrl({\n\t\t\t\tversion: 'v4',\n\t\t\t\taction: 'read',\n\t\t\t\texpires: Date.now() + expiresIn * 1000,\n\t\t\t\t...(download ? { responseDisposition: 'attachment' } : {}),\n\t\t\t})\n\t\t\treturn url\n\t\t},\n\n\t\tlist: async prefix => {\n\t\t\tconst [privateFiles] = await privateBucket.getFiles({ prefix })\n\t\t\tconst [publicFiles] = await publicBucket.getFiles({ prefix })\n\t\t\treturn [...privateFiles, ...publicFiles].map(file => ({\n\t\t\t\tkey: file.name,\n\t\t\t\tsize: Number(file.metadata.size ?? 0),\n\t\t\t}))\n\t\t},\n\t}\n}\n"]}

package/dist/adapters/gcs.d.cts ADDED Viewed

@@ -0,0 +1,31 @@
+import { Bucket } from '@google-cloud/storage';
+import { S as StreamingStorageProvider } from '../storage-CYkSHWZX.cjs';
+import 'node:stream';
+import '../types-BSlJJwti.cjs';
+type GcsProviderOptions = {
+    /** Objects with `visibility: 'public'` land here and get a direct URL. */
+    publicBucket: Bucket;
+    /** Objects with `visibility: 'private'` land here; access is signed-only. */
+    privateBucket: Bucket;
+    /**
+     * Direct URL for a public object.
+     * @defaultValue `https://storage.googleapis.com/{bucket}/{key}`
+     */
+    publicUrl?: (bucketName: string, key: string) => string;
+};
+/**
+ * Google Cloud Storage provider over a two-bucket layout: public assets on
+ * one bucket, sensitive documents on another that is never world-readable.
+ *
+ * `@google-cloud/storage` is an optional peer — importing this module without
+ * it installed fails, but only for the app that chose GCS.
+ *
+ * Reads probe the private bucket first and fall back to the public one; keys
+ * are unique per scope path, so a hit in both cannot happen.
+ *
+ * @see AGENTS.md §6 — why the probe exists
+ */
+declare const createGcsProvider: ({ publicBucket, privateBucket, publicUrl, }: GcsProviderOptions) => StreamingStorageProvider;
+export { type GcsProviderOptions, createGcsProvider };

package/dist/adapters/gcs.d.ts ADDED Viewed

@@ -0,0 +1,31 @@
+import { Bucket } from '@google-cloud/storage';
+import { S as StreamingStorageProvider } from '../storage-Qc9epG0G.js';
+import 'node:stream';
+import '../types-BSlJJwti.js';
+type GcsProviderOptions = {
+    /** Objects with `visibility: 'public'` land here and get a direct URL. */
+    publicBucket: Bucket;
+    /** Objects with `visibility: 'private'` land here; access is signed-only. */
+    privateBucket: Bucket;
+    /**
+     * Direct URL for a public object.
+     * @defaultValue `https://storage.googleapis.com/{bucket}/{key}`
+     */
+    publicUrl?: (bucketName: string, key: string) => string;
+};
+/**
+ * Google Cloud Storage provider over a two-bucket layout: public assets on
+ * one bucket, sensitive documents on another that is never world-readable.
+ *
+ * `@google-cloud/storage` is an optional peer — importing this module without
+ * it installed fails, but only for the app that chose GCS.
+ *
+ * Reads probe the private bucket first and fall back to the public one; keys
+ * are unique per scope path, so a hit in both cannot happen.
+ *
+ * @see AGENTS.md §6 — why the probe exists
+ */
+declare const createGcsProvider: ({ publicBucket, privateBucket, publicUrl, }: GcsProviderOptions) => StreamingStorageProvider;
+export { type GcsProviderOptions, createGcsProvider };

package/dist/adapters/gcs.js ADDED Viewed

@@ -0,0 +1,81 @@
+// src/adapters/gcs.ts
+var defaultPublicUrl = (bucketName, key) => `https://storage.googleapis.com/${bucketName}/${encodeURI(key)}`;
+var createGcsProvider = ({
+  publicBucket,
+  privateBucket,
+  publicUrl = defaultPublicUrl
+}) => {
+  let publicAccessChecked = false;
+  const checkPublicAccess = (url, bucketName) => {
+    if (publicAccessChecked) return;
+    publicAccessChecked = true;
+    void fetch(url, { method: "HEAD" }).then((response) => {
+      if (!response.ok) {
+        console.error(
+          `[uploaderkit] gcs: public objects in "${bucketName}" answer ${response.status} \u2014 the bucket is not publicly readable. Grant it once with:
+  gcloud storage buckets add-iam-policy-binding gs://${bucketName} --member=allUsers --role=roles/storage.objectViewer`
+        );
+      }
+    }).catch(() => void 0);
+  };
+  const locate = async (key) => {
+    const [inPrivate] = await privateBucket.file(key).exists();
+    return inPrivate ? privateBucket : publicBucket;
+  };
+  return {
+    name: "gcs",
+    capabilities: { signedUrl: true, resumable: false, rangeRead: true },
+    put: async ({ key, body, contentType, visibility, metadata }) => {
+      const bucket = visibility === "private" ? privateBucket : publicBucket;
+      const file = bucket.file(key);
+      await file.save(Buffer.from(body), {
+        contentType,
+        resumable: false,
+        metadata: { metadata }
+      });
+      if (visibility === "public") {
+        await file.makePublic().catch(() => void 0);
+      }
+      const url = publicUrl(bucket.name, key);
+      if (visibility === "public") checkPublicAccess(url, bucket.name);
+      return { key, url };
+    },
+    get: async (key) => {
+      const bucket = await locate(key);
+      const [data] = await bucket.file(key).download();
+      return new Uint8Array(data);
+    },
+    // `download()` buffers the whole object; a 20MB document costs that per
+    // concurrent request, and materialization serves many at once.
+    getStream: async (key) => {
+      const bucket = await locate(key);
+      return bucket.file(key).createReadStream();
+    },
+    delete: async (key) => {
+      const bucket = await locate(key);
+      return bucket.file(key).delete().then(() => true).catch(() => false);
+    },
+    signedUrl: async (key, { expiresIn, download }) => {
+      const bucket = await locate(key);
+      const [url] = await bucket.file(key).getSignedUrl({
+        version: "v4",
+        action: "read",
+        expires: Date.now() + expiresIn * 1e3,
+        ...download ? { responseDisposition: "attachment" } : {}
+      });
+      return url;
+    },
+    list: async (prefix) => {
+      const [privateFiles] = await privateBucket.getFiles({ prefix });
+      const [publicFiles] = await publicBucket.getFiles({ prefix });
+      return [...privateFiles, ...publicFiles].map((file) => ({
+        key: file.name,
+        size: Number(file.metadata.size ?? 0)
+      }));
+    }
+  };
+};
+export { createGcsProvider };
+//# sourceMappingURL=gcs.js.map
+//# sourceMappingURL=gcs.js.map

package/dist/adapters/gcs.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../../src/adapters/gcs.ts"],"names":[],"mappings":"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","file":"gcs.js","sourcesContent":["import type { Bucket } from '@google-cloud/storage'\n\nimport type { StreamingStorageProvider } from '../server/storage'\n\nexport type GcsProviderOptions = {\n\t/** Objects with `visibility: 'public'` land here and get a direct URL. */\n\tpublicBucket: Bucket\n\t/** Objects with `visibility: 'private'` land here; access is signed-only. */\n\tprivateBucket: Bucket\n\t/**\n\t * Direct URL for a public object.\n\t * @defaultValue `https://storage.googleapis.com/{bucket}/{key}`\n\t */\n\tpublicUrl?: (bucketName: string, key: string) => string\n}\n\nconst defaultPublicUrl = (bucketName: string, key: string): string =>\n\t`https://storage.googleapis.com/${bucketName}/${encodeURI(key)}`\n\n/**\n * Google Cloud Storage provider over a two-bucket layout: public assets on\n * one bucket, sensitive documents on another that is never world-readable.\n *\n * `@google-cloud/storage` is an optional peer — importing this module without\n * it installed fails, but only for the app that chose GCS.\n *\n * Reads probe the private bucket first and fall back to the public one; keys\n * are unique per scope path, so a hit in both cannot happen.\n *\n * @see AGENTS.md §6 — why the probe exists\n */\nexport const createGcsProvider = ({\n\tpublicBucket,\n\tprivateBucket,\n\tpublicUrl = defaultPublicUrl,\n}: GcsProviderOptions): StreamingStorageProvider => {\n\t// Under uniform bucket-level access, per-object `makePublic()` fails\n\t// silently and a \"public\" upload 403s in every <img> — a bug that only\n\t// shows as broken avatars. Probe the first public upload's URL once and\n\t// say exactly how to fix the bucket.\n\tlet publicAccessChecked = false\n\tconst checkPublicAccess = (url: string, bucketName: string): void => {\n\t\tif (publicAccessChecked) return\n\t\tpublicAccessChecked = true\n\t\tvoid fetch(url, { method: 'HEAD' })\n\t\t\t.then(response => {\n\t\t\t\tif (!response.ok) {\n\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t`[uploaderkit] gcs: public objects in \"${bucketName}\" answer ${response.status} — the bucket is not publicly readable. Grant it once with:\\n` +\n\t\t\t\t\t\t\t` gcloud storage buckets add-iam-policy-binding gs://${bucketName} --member=allUsers --role=roles/storage.objectViewer`\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t})\n\t\t\t.catch(() => undefined)\n\t}\n\n\tconst locate = async (key: string): Promise<Bucket> => {\n\t\tconst [inPrivate] = await privateBucket.file(key).exists()\n\t\treturn inPrivate ? privateBucket : publicBucket\n\t}\n\n\treturn {\n\t\tname: 'gcs',\n\t\tcapabilities: { signedUrl: true, resumable: false, rangeRead: true },\n\n\t\tput: async ({ key, body, contentType, visibility, metadata }) => {\n\t\t\tconst bucket = visibility === 'private' ? privateBucket : publicBucket\n\t\t\tconst file = bucket.file(key)\n\n\t\t\tawait file.save(Buffer.from(body), {\n\t\t\t\tcontentType,\n\t\t\t\tresumable: false,\n\t\t\t\tmetadata: { metadata },\n\t\t\t})\n\n\t\t\tif (visibility === 'public') {\n\t\t\t\t// Buckets with uniform public access reject per-object ACLs; when\n\t\t\t\t// the bucket itself grants allUsers read, this failure is benign —\n\t\t\t\t// and when it does not, the probe below reports it loudly.\n\t\t\t\tawait file.makePublic().catch(() => undefined)\n\t\t\t}\n\n\t\t\tconst url = publicUrl(bucket.name, key)\n\t\t\tif (visibility === 'public') checkPublicAccess(url, bucket.name)\n\t\t\treturn { key, url }\n\t\t},\n\n\t\tget: async key => {\n\t\t\tconst bucket = await locate(key)\n\t\t\tconst [data] = await bucket.file(key).download()\n\t\t\treturn new Uint8Array(data)\n\t\t},\n\n\t\t// `download()` buffers the whole object; a 20MB document costs that per\n\t\t// concurrent request, and materialization serves many at once.\n\t\tgetStream: async key => {\n\t\t\tconst bucket = await locate(key)\n\t\t\treturn bucket.file(key).createReadStream()\n\t\t},\n\n\t\tdelete: async key => {\n\t\t\tconst bucket = await locate(key)\n\t\t\treturn bucket\n\t\t\t\t.file(key)\n\t\t\t\t.delete()\n\t\t\t\t.then(() => true)\n\t\t\t\t.catch(() => false)\n\t\t},\n\n\t\tsignedUrl: async (key, { expiresIn, download }) => {\n\t\t\tconst bucket = await locate(key)\n\t\t\tconst [url] = await bucket.file(key).getSignedUrl({\n\t\t\t\tversion: 'v4',\n\t\t\t\taction: 'read',\n\t\t\t\texpires: Date.now() + expiresIn * 1000,\n\t\t\t\t...(download ? { responseDisposition: 'attachment' } : {}),\n\t\t\t})\n\t\t\treturn url\n\t\t},\n\n\t\tlist: async prefix => {\n\t\t\tconst [privateFiles] = await privateBucket.getFiles({ prefix })\n\t\t\tconst [publicFiles] = await publicBucket.getFiles({ prefix })\n\t\t\treturn [...privateFiles, ...publicFiles].map(file => ({\n\t\t\t\tkey: file.name,\n\t\t\t\tsize: Number(file.metadata.size ?? 0),\n\t\t\t}))\n\t\t},\n\t}\n}\n"]}

package/dist/adapters/memory.cjs ADDED Viewed

@@ -0,0 +1,27 @@
+'use strict';
+// src/adapters/memory.ts
+var createMemoryProvider = () => {
+  const objects = /* @__PURE__ */ new Map();
+  return {
+    name: "memory",
+    capabilities: { signedUrl: true, resumable: false, rangeRead: true },
+    objects,
+    put: async ({ key, body, contentType, visibility }) => {
+      objects.set(key, { body, contentType, visibility });
+      return { key, url: `memory://${key}` };
+    },
+    get: async (key) => {
+      const object = objects.get(key);
+      if (!object) throw new Error(`memory provider: no object at "${key}"`);
+      return object.body;
+    },
+    delete: async (key) => objects.delete(key),
+    signedUrl: async (key, { expiresIn }) => `memory://signed/${key}?expires=${expiresIn}`,
+    list: async (prefix) => [...objects.entries()].filter(([key]) => key.startsWith(prefix)).map(([key, object]) => ({ key, size: object.body.byteLength }))
+  };
+};
+exports.createMemoryProvider = createMemoryProvider;
+//# sourceMappingURL=memory.cjs.map
+//# sourceMappingURL=memory.cjs.map

package/dist/adapters/memory.cjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../../src/adapters/memory.ts"],"names":[],"mappings":";;;AAYO,IAAM,uBAAuB,MAG/B;AACJ,EAAA,MAAM,OAAA,uBAAc,GAAA,EAA0B;AAE9C,EAAA,OAAO;AAAA,IACN,IAAA,EAAM,QAAA;AAAA,IACN,cAAc,EAAE,SAAA,EAAW,MAAM,SAAA,EAAW,KAAA,EAAO,WAAW,IAAA,EAAK;AAAA,IACnE,OAAA;AAAA,IAEA,KAAK,OAAO,EAAE,KAAK,IAAA,EAAM,WAAA,EAAa,YAAW,KAAM;AACtD,MAAA,OAAA,CAAQ,IAAI,GAAA,EAAK,EAAE,IAAA,EAAM,WAAA,EAAa,YAAY,CAAA;AAClD,MAAA,OAAO,EAAE,GAAA,EAAK,GAAA,EAAK,CAAA,SAAA,EAAY,GAAG,CAAA,CAAA,EAAG;AAAA,IACtC,CAAA;AAAA,IAEA,GAAA,EAAK,OAAM,GAAA,KAAO;AACjB,MAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,GAAA,CAAI,GAAG,CAAA;AAC9B,MAAA,IAAI,CAAC,MAAA,EAAQ,MAAM,IAAI,KAAA,CAAM,CAAA,+BAAA,EAAkC,GAAG,CAAA,CAAA,CAAG,CAAA;AACrE,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IACf,CAAA;AAAA,IAEA,MAAA,EAAQ,OAAM,GAAA,KAAO,OAAA,CAAQ,OAAO,GAAG,CAAA;AAAA,IAEvC,SAAA,EAAW,OAAO,GAAA,EAAK,EAAE,WAAU,KAClC,CAAA,gBAAA,EAAmB,GAAG,CAAA,SAAA,EAAY,SAAS,CAAA,CAAA;AAAA,IAE5C,IAAA,EAAM,OAAM,MAAA,KACX,CAAC,GAAG,OAAA,CAAQ,OAAA,EAAS,CAAA,CACnB,MAAA,CAAO,CAAC,CAAC,GAAG,CAAA,KAAM,GAAA,CAAI,UAAA,CAAW,MAAM,CAAC,CAAA,CACxC,GAAA,CAAI,CAAC,CAAC,GAAA,EAAK,MAAM,CAAA,MAAO,EAAE,GAAA,EAAK,IAAA,EAAM,MAAA,CAAO,IAAA,CAAK,YAAW,CAAE;AAAA,GAClE;AACD","file":"memory.cjs","sourcesContent":["import type { StorageProvider, Visibility } from '../types'\ntype StoredObject = {\n\tbody: Uint8Array\n\tcontentType: string\n\tvisibility: Visibility\n}\n\n/**\n * In-memory provider for tests and local development. Signed URLs are fake but\n * carry the expiry, so an assertion can check TTL wiring without a cloud\n * account.\n */\nexport const createMemoryProvider = (): StorageProvider & {\n\t/** Test hook: inspect what was stored without going through `get`. */\n\tobjects: Map<string, StoredObject>\n} => {\n\tconst objects = new Map<string, StoredObject>()\n\n\treturn {\n\t\tname: 'memory',\n\t\tcapabilities: { signedUrl: true, resumable: false, rangeRead: true },\n\t\tobjects,\n\n\t\tput: async ({ key, body, contentType, visibility }) => {\n\t\t\tobjects.set(key, { body, contentType, visibility })\n\t\t\treturn { key, url: `memory://${key}` }\n\t\t},\n\n\t\tget: async key => {\n\t\t\tconst object = objects.get(key)\n\t\t\tif (!object) throw new Error(`memory provider: no object at \"${key}\"`)\n\t\t\treturn object.body\n\t\t},\n\n\t\tdelete: async key => objects.delete(key),\n\n\t\tsignedUrl: async (key, { expiresIn }) =>\n\t\t\t`memory://signed/${key}?expires=${expiresIn}`,\n\n\t\tlist: async prefix =>\n\t\t\t[...objects.entries()]\n\t\t\t\t.filter(([key]) => key.startsWith(prefix))\n\t\t\t\t.map(([key, object]) => ({ key, size: object.body.byteLength })),\n\t}\n}\n"]}

package/dist/adapters/memory.d.cts ADDED Viewed

@@ -0,0 +1,18 @@
+import { S as StorageProvider, V as Visibility } from '../types-BSlJJwti.cjs';
+type StoredObject = {
+    body: Uint8Array;
+    contentType: string;
+    visibility: Visibility;
+};
+/**
+ * In-memory provider for tests and local development. Signed URLs are fake but
+ * carry the expiry, so an assertion can check TTL wiring without a cloud
+ * account.
+ */
+declare const createMemoryProvider: () => StorageProvider & {
+    /** Test hook: inspect what was stored without going through `get`. */
+    objects: Map<string, StoredObject>;
+};
+export { createMemoryProvider };

package/dist/adapters/memory.d.ts ADDED Viewed

@@ -0,0 +1,18 @@
+import { S as StorageProvider, V as Visibility } from '../types-BSlJJwti.js';
+type StoredObject = {
+    body: Uint8Array;
+    contentType: string;
+    visibility: Visibility;
+};
+/**
+ * In-memory provider for tests and local development. Signed URLs are fake but
+ * carry the expiry, so an assertion can check TTL wiring without a cloud
+ * account.
+ */
+declare const createMemoryProvider: () => StorageProvider & {
+    /** Test hook: inspect what was stored without going through `get`. */
+    objects: Map<string, StoredObject>;
+};
+export { createMemoryProvider };

package/dist/adapters/memory.js ADDED Viewed

@@ -0,0 +1,25 @@
+// src/adapters/memory.ts
+var createMemoryProvider = () => {
+  const objects = /* @__PURE__ */ new Map();
+  return {
+    name: "memory",
+    capabilities: { signedUrl: true, resumable: false, rangeRead: true },
+    objects,
+    put: async ({ key, body, contentType, visibility }) => {
+      objects.set(key, { body, contentType, visibility });
+      return { key, url: `memory://${key}` };
+    },
+    get: async (key) => {
+      const object = objects.get(key);
+      if (!object) throw new Error(`memory provider: no object at "${key}"`);
+      return object.body;
+    },
+    delete: async (key) => objects.delete(key),
+    signedUrl: async (key, { expiresIn }) => `memory://signed/${key}?expires=${expiresIn}`,
+    list: async (prefix) => [...objects.entries()].filter(([key]) => key.startsWith(prefix)).map(([key, object]) => ({ key, size: object.body.byteLength }))
+  };
+};
+export { createMemoryProvider };
+//# sourceMappingURL=memory.js.map
+//# sourceMappingURL=memory.js.map

package/dist/adapters/memory.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../../src/adapters/memory.ts"],"names":[],"mappings":";AAYO,IAAM,uBAAuB,MAG/B;AACJ,EAAA,MAAM,OAAA,uBAAc,GAAA,EAA0B;AAE9C,EAAA,OAAO;AAAA,IACN,IAAA,EAAM,QAAA;AAAA,IACN,cAAc,EAAE,SAAA,EAAW,MAAM,SAAA,EAAW,KAAA,EAAO,WAAW,IAAA,EAAK;AAAA,IACnE,OAAA;AAAA,IAEA,KAAK,OAAO,EAAE,KAAK,IAAA,EAAM,WAAA,EAAa,YAAW,KAAM;AACtD,MAAA,OAAA,CAAQ,IAAI,GAAA,EAAK,EAAE,IAAA,EAAM,WAAA,EAAa,YAAY,CAAA;AAClD,MAAA,OAAO,EAAE,GAAA,EAAK,GAAA,EAAK,CAAA,SAAA,EAAY,GAAG,CAAA,CAAA,EAAG;AAAA,IACtC,CAAA;AAAA,IAEA,GAAA,EAAK,OAAM,GAAA,KAAO;AACjB,MAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,GAAA,CAAI,GAAG,CAAA;AAC9B,MAAA,IAAI,CAAC,MAAA,EAAQ,MAAM,IAAI,KAAA,CAAM,CAAA,+BAAA,EAAkC,GAAG,CAAA,CAAA,CAAG,CAAA;AACrE,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IACf,CAAA;AAAA,IAEA,MAAA,EAAQ,OAAM,GAAA,KAAO,OAAA,CAAQ,OAAO,GAAG,CAAA;AAAA,IAEvC,SAAA,EAAW,OAAO,GAAA,EAAK,EAAE,WAAU,KAClC,CAAA,gBAAA,EAAmB,GAAG,CAAA,SAAA,EAAY,SAAS,CAAA,CAAA;AAAA,IAE5C,IAAA,EAAM,OAAM,MAAA,KACX,CAAC,GAAG,OAAA,CAAQ,OAAA,EAAS,CAAA,CACnB,MAAA,CAAO,CAAC,CAAC,GAAG,CAAA,KAAM,GAAA,CAAI,UAAA,CAAW,MAAM,CAAC,CAAA,CACxC,GAAA,CAAI,CAAC,CAAC,GAAA,EAAK,MAAM,CAAA,MAAO,EAAE,GAAA,EAAK,IAAA,EAAM,MAAA,CAAO,IAAA,CAAK,YAAW,CAAE;AAAA,GAClE;AACD","file":"memory.js","sourcesContent":["import type { StorageProvider, Visibility } from '../types'\ntype StoredObject = {\n\tbody: Uint8Array\n\tcontentType: string\n\tvisibility: Visibility\n}\n\n/**\n * In-memory provider for tests and local development. Signed URLs are fake but\n * carry the expiry, so an assertion can check TTL wiring without a cloud\n * account.\n */\nexport const createMemoryProvider = (): StorageProvider & {\n\t/** Test hook: inspect what was stored without going through `get`. */\n\tobjects: Map<string, StoredObject>\n} => {\n\tconst objects = new Map<string, StoredObject>()\n\n\treturn {\n\t\tname: 'memory',\n\t\tcapabilities: { signedUrl: true, resumable: false, rangeRead: true },\n\t\tobjects,\n\n\t\tput: async ({ key, body, contentType, visibility }) => {\n\t\t\tobjects.set(key, { body, contentType, visibility })\n\t\t\treturn { key, url: `memory://${key}` }\n\t\t},\n\n\t\tget: async key => {\n\t\t\tconst object = objects.get(key)\n\t\t\tif (!object) throw new Error(`memory provider: no object at \"${key}\"`)\n\t\t\treturn object.body\n\t\t},\n\n\t\tdelete: async key => objects.delete(key),\n\n\t\tsignedUrl: async (key, { expiresIn }) =>\n\t\t\t`memory://signed/${key}?expires=${expiresIn}`,\n\n\t\tlist: async prefix =>\n\t\t\t[...objects.entries()]\n\t\t\t\t.filter(([key]) => key.startsWith(prefix))\n\t\t\t\t.map(([key, object]) => ({ key, size: object.body.byteLength })),\n\t}\n}\n"]}

package/dist/adapters/s3.cjs ADDED Viewed

@@ -0,0 +1,75 @@
+'use strict';
+var clientS3 = require('@aws-sdk/client-s3');
+var s3RequestPresigner = require('@aws-sdk/s3-request-presigner');
+// src/adapters/s3.ts
+var createS3Provider = ({
+  client,
+  bucket,
+  publicUrl
+}) => ({
+  name: "s3",
+  capabilities: { signedUrl: true, resumable: false, rangeRead: true },
+  put: async ({ key, body, contentType, visibility, metadata }) => {
+    if (visibility === "public" && !publicUrl) {
+      throw new Error(
+        's3 provider: a public scope needs the "publicUrl" option \u2014 per-object ACLs are blocked on modern buckets, so pass the CDN/public-domain mapping'
+      );
+    }
+    await client.send(
+      new clientS3.PutObjectCommand({
+        Bucket: bucket,
+        Key: key,
+        Body: body,
+        ContentType: contentType,
+        Metadata: metadata
+      })
+    );
+    return {
+      key,
+      url: visibility === "public" ? publicUrl(key) : await s3RequestPresigner.getSignedUrl(
+        client,
+        new clientS3.GetObjectCommand({ Bucket: bucket, Key: key }),
+        { expiresIn: 300 }
+      )
+    };
+  },
+  get: async (key) => {
+    const result = await client.send(
+      new clientS3.GetObjectCommand({ Bucket: bucket, Key: key })
+    );
+    if (!result.Body) throw new Error(`s3 provider: no object at "${key}"`);
+    return result.Body.transformToByteArray();
+  },
+  delete: async (key) => {
+    try {
+      await client.send(new clientS3.DeleteObjectCommand({ Bucket: bucket, Key: key }));
+      return true;
+    } catch {
+      return false;
+    }
+  },
+  signedUrl: (key, { expiresIn, download }) => s3RequestPresigner.getSignedUrl(
+    client,
+    new clientS3.GetObjectCommand({
+      Bucket: bucket,
+      Key: key,
+      ...download ? { ResponseContentDisposition: "attachment" } : {}
+    }),
+    { expiresIn }
+  ),
+  list: async (prefix) => {
+    const result = await client.send(
+      new clientS3.ListObjectsV2Command({ Bucket: bucket, Prefix: prefix })
+    );
+    return (result.Contents ?? []).map((object) => ({
+      key: object.Key ?? "",
+      size: object.Size ?? 0
+    }));
+  }
+});
+exports.createS3Provider = createS3Provider;
+//# sourceMappingURL=s3.cjs.map
+//# sourceMappingURL=s3.cjs.map

package/dist/adapters/s3.cjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../../src/adapters/s3.ts"],"names":["PutObjectCommand","getSignedUrl","GetObjectCommand","DeleteObjectCommand","ListObjectsV2Command"],"mappings":";;;;;;AAgCO,IAAM,mBAAmB,CAAC;AAAA,EAChC,MAAA;AAAA,EACA,MAAA;AAAA,EACA;AACD,CAAA,MAA2C;AAAA,EAC1C,IAAA,EAAM,IAAA;AAAA,EACN,cAAc,EAAE,SAAA,EAAW,MAAM,SAAA,EAAW,KAAA,EAAO,WAAW,IAAA,EAAK;AAAA,EAEnE,GAAA,EAAK,OAAO,EAAE,GAAA,EAAK,MAAM,WAAA,EAAa,UAAA,EAAY,UAAS,KAAM;AAChE,IAAA,IAAI,UAAA,KAAe,QAAA,IAAY,CAAC,SAAA,EAAW;AAC1C,MAAA,MAAM,IAAI,KAAA;AAAA,QACT;AAAA,OACD;AAAA,IACD;AAEA,IAAA,MAAM,MAAA,CAAO,IAAA;AAAA,MACZ,IAAIA,yBAAA,CAAiB;AAAA,QACpB,MAAA,EAAQ,MAAA;AAAA,QACR,GAAA,EAAK,GAAA;AAAA,QACL,IAAA,EAAM,IAAA;AAAA,QACN,WAAA,EAAa,WAAA;AAAA,QACb,QAAA,EAAU;AAAA,OACV;AAAA,KACF;AAEA,IAAA,OAAO;AAAA,MACN,GAAA;AAAA,MACA,KACC,UAAA,KAAe,QAAA,GACZ,SAAA,CAAW,GAAG,IACd,MAAMC,+BAAA;AAAA,QACN,MAAA;AAAA,QACA,IAAIC,yBAAA,CAAiB,EAAE,QAAQ,MAAA,EAAQ,GAAA,EAAK,KAAK,CAAA;AAAA,QACjD,EAAE,WAAW,GAAA;AAAI;AAClB,KACJ;AAAA,EACD,CAAA;AAAA,EAEA,GAAA,EAAK,OAAM,GAAA,KAAO;AACjB,IAAA,MAAM,MAAA,GAAS,MAAM,MAAA,CAAO,IAAA;AAAA,MAC3B,IAAIA,yBAAA,CAAiB,EAAE,QAAQ,MAAA,EAAQ,GAAA,EAAK,KAAK;AAAA,KAClD;AACA,IAAA,IAAI,CAAC,OAAO,IAAA,EAAM,MAAM,IAAI,KAAA,CAAM,CAAA,2BAAA,EAA8B,GAAG,CAAA,CAAA,CAAG,CAAA;AACtE,IAAA,OAAO,MAAA,CAAO,KAAK,oBAAA,EAAqB;AAAA,EACzC,CAAA;AAAA,EAEA,MAAA,EAAQ,OAAM,GAAA,KAAO;AACpB,IAAA,IAAI;AACH,MAAA,MAAM,MAAA,CAAO,IAAA,CAAK,IAAIC,4BAAA,CAAoB,EAAE,QAAQ,MAAA,EAAQ,GAAA,EAAK,GAAA,EAAK,CAAC,CAAA;AACvE,MAAA,OAAO,IAAA;AAAA,IACR,CAAA,CAAA,MAAQ;AACP,MAAA,OAAO,KAAA;AAAA,IACR;AAAA,EACD,CAAA;AAAA,EAEA,WAAW,CAAC,GAAA,EAAK,EAAE,SAAA,EAAW,UAAS,KACtCF,+BAAA;AAAA,IACC,MAAA;AAAA,IACA,IAAIC,yBAAA,CAAiB;AAAA,MACpB,MAAA,EAAQ,MAAA;AAAA,MACR,GAAA,EAAK,GAAA;AAAA,MACL,GAAI,QAAA,GAAW,EAAE,0BAAA,EAA4B,YAAA,KAAiB;AAAC,KAC/D,CAAA;AAAA,IACD,EAAE,SAAA;AAAU,GACb;AAAA,EAED,IAAA,EAAM,OAAM,MAAA,KAAU;AACrB,IAAA,MAAM,MAAA,GAAS,MAAM,MAAA,CAAO,IAAA;AAAA,MAC3B,IAAIE,6BAAA,CAAqB,EAAE,QAAQ,MAAA,EAAQ,MAAA,EAAQ,QAAQ;AAAA,KAC5D;AACA,IAAA,OAAA,CAAQ,MAAA,CAAO,QAAA,IAAY,EAAC,EAAG,IAAI,CAAA,MAAA,MAAW;AAAA,MAC7C,GAAA,EAAK,OAAO,GAAA,IAAO,EAAA;AAAA,MACnB,IAAA,EAAM,OAAO,IAAA,IAAQ;AAAA,KACtB,CAAE,CAAA;AAAA,EACH;AACD,CAAA","file":"s3.cjs","sourcesContent":["import {\n\tDeleteObjectCommand,\n\tGetObjectCommand,\n\tListObjectsV2Command,\n\tPutObjectCommand,\n\ttype S3Client,\n} from '@aws-sdk/client-s3'\nimport { getSignedUrl } from '@aws-sdk/s3-request-presigner'\n\nimport type { StorageProvider } from '../types'\nexport type S3ProviderOptions = {\n\tclient: S3Client\n\tbucket: string\n\t/**\n\t * Direct URL for a public object — your CDN, an R2 public domain, or the\n\t * bucket website. Required before the first `visibility: 'public'` upload:\n\t * modern buckets block per-object ACLs, so the adapter cannot invent a\n\t * stable public URL on its own.\n\t */\n\tpublicUrl?: (key: string) => string\n}\n\n/**\n * S3-compatible provider. One adapter covers AWS S3, Cloudflare R2, Backblaze\n * B2, MinIO and Wasabi — they all speak this protocol; only the client's\n * `endpoint`/credentials change.\n *\n * The bucket is treated as private (objects readable through signed URLs);\n * `publicUrl` maps the keys a CDN or public domain exposes. Both `@aws-sdk`\n * packages are optional peers — importing this module without them installed\n * fails, but only for the app that chose S3.\n */\nexport const createS3Provider = ({\n\tclient,\n\tbucket,\n\tpublicUrl,\n}: S3ProviderOptions): StorageProvider => ({\n\tname: 's3',\n\tcapabilities: { signedUrl: true, resumable: false, rangeRead: true },\n\n\tput: async ({ key, body, contentType, visibility, metadata }) => {\n\t\tif (visibility === 'public' && !publicUrl) {\n\t\t\tthrow new Error(\n\t\t\t\t's3 provider: a public scope needs the \"publicUrl\" option — per-object ACLs are blocked on modern buckets, so pass the CDN/public-domain mapping'\n\t\t\t)\n\t\t}\n\n\t\tawait client.send(\n\t\t\tnew PutObjectCommand({\n\t\t\t\tBucket: bucket,\n\t\t\t\tKey: key,\n\t\t\t\tBody: body,\n\t\t\t\tContentType: contentType,\n\t\t\t\tMetadata: metadata,\n\t\t\t})\n\t\t)\n\n\t\treturn {\n\t\t\tkey,\n\t\t\turl:\n\t\t\t\tvisibility === 'public'\n\t\t\t\t\t? publicUrl!(key)\n\t\t\t\t\t: await getSignedUrl(\n\t\t\t\t\t\t\tclient,\n\t\t\t\t\t\t\tnew GetObjectCommand({ Bucket: bucket, Key: key }),\n\t\t\t\t\t\t\t{ expiresIn: 300 }\n\t\t\t\t\t\t),\n\t\t}\n\t},\n\n\tget: async key => {\n\t\tconst result = await client.send(\n\t\t\tnew GetObjectCommand({ Bucket: bucket, Key: key })\n\t\t)\n\t\tif (!result.Body) throw new Error(`s3 provider: no object at \"${key}\"`)\n\t\treturn result.Body.transformToByteArray()\n\t},\n\n\tdelete: async key => {\n\t\ttry {\n\t\t\tawait client.send(new DeleteObjectCommand({ Bucket: bucket, Key: key }))\n\t\t\treturn true\n\t\t} catch {\n\t\t\treturn false\n\t\t}\n\t},\n\n\tsignedUrl: (key, { expiresIn, download }) =>\n\t\tgetSignedUrl(\n\t\t\tclient,\n\t\t\tnew GetObjectCommand({\n\t\t\t\tBucket: bucket,\n\t\t\t\tKey: key,\n\t\t\t\t...(download ? { ResponseContentDisposition: 'attachment' } : {}),\n\t\t\t}),\n\t\t\t{ expiresIn }\n\t\t),\n\n\tlist: async prefix => {\n\t\tconst result = await client.send(\n\t\t\tnew ListObjectsV2Command({ Bucket: bucket, Prefix: prefix })\n\t\t)\n\t\treturn (result.Contents ?? []).map(object => ({\n\t\t\tkey: object.Key ?? '',\n\t\t\tsize: object.Size ?? 0,\n\t\t}))\n\t},\n})\n"]}

package/dist/adapters/s3.d.cts ADDED Viewed

@@ -0,0 +1,27 @@
+import { S3Client } from '@aws-sdk/client-s3';
+import { S as StorageProvider } from '../types-BSlJJwti.cjs';
+type S3ProviderOptions = {
+    client: S3Client;
+    bucket: string;
+    /**
+     * Direct URL for a public object — your CDN, an R2 public domain, or the
+     * bucket website. Required before the first `visibility: 'public'` upload:
+     * modern buckets block per-object ACLs, so the adapter cannot invent a
+     * stable public URL on its own.
+     */
+    publicUrl?: (key: string) => string;
+};
+/**
+ * S3-compatible provider. One adapter covers AWS S3, Cloudflare R2, Backblaze
+ * B2, MinIO and Wasabi — they all speak this protocol; only the client's
+ * `endpoint`/credentials change.
+ *
+ * The bucket is treated as private (objects readable through signed URLs);
+ * `publicUrl` maps the keys a CDN or public domain exposes. Both `@aws-sdk`
+ * packages are optional peers — importing this module without them installed
+ * fails, but only for the app that chose S3.
+ */
+declare const createS3Provider: ({ client, bucket, publicUrl, }: S3ProviderOptions) => StorageProvider;
+export { type S3ProviderOptions, createS3Provider };

package/dist/adapters/s3.d.ts ADDED Viewed

@@ -0,0 +1,27 @@
+import { S3Client } from '@aws-sdk/client-s3';
+import { S as StorageProvider } from '../types-BSlJJwti.js';
+type S3ProviderOptions = {
+    client: S3Client;
+    bucket: string;
+    /**
+     * Direct URL for a public object — your CDN, an R2 public domain, or the
+     * bucket website. Required before the first `visibility: 'public'` upload:
+     * modern buckets block per-object ACLs, so the adapter cannot invent a
+     * stable public URL on its own.
+     */
+    publicUrl?: (key: string) => string;
+};
+/**
+ * S3-compatible provider. One adapter covers AWS S3, Cloudflare R2, Backblaze
+ * B2, MinIO and Wasabi — they all speak this protocol; only the client's
+ * `endpoint`/credentials change.
+ *
+ * The bucket is treated as private (objects readable through signed URLs);
+ * `publicUrl` maps the keys a CDN or public domain exposes. Both `@aws-sdk`
+ * packages are optional peers — importing this module without them installed
+ * fails, but only for the app that chose S3.
+ */
+declare const createS3Provider: ({ client, bucket, publicUrl, }: S3ProviderOptions) => StorageProvider;
+export { type S3ProviderOptions, createS3Provider };