@humaan/payload-storage-imagekit 2.3.1

package/README.md

@@ -0,0 +1,142 @@
+# payload-storage-imagekit
+
+ImageKit storage adapter plugin for Payload CMS uploads.
+
+This plugin integrates `@payloadcms/plugin-cloud-storage` with ImageKit and provides:
+
+- Uploads to ImageKit per collection
+- Optional client-side uploads for Payload admin to bypass request size limits on platforms like Vercel
+- Required root folder with per-collection subfolders
+- Stored ImageKit references (`imagekit.fileId`, `imagekit.url`, `imagekit.thumbnailUrl`)
+- `crop: false` for configured upload collections
+- Admin thumbnails using ImageKit transforms (`tr=w-300,h-300`)
+- Built-in thumbnail path for videos and PDFs in admin previews
+- Migration utility for copying collection files between ImageKit folders
+
+## Installation
+
+```bash
+pnpm add @humaan/payload-storage-imagekit
+```
+
+## Usage
+
+```ts
+import { buildConfig } from 'payload'
+import { imagekitStorage } from '@humaan/payload-storage-imagekit'
+
+export default buildConfig({
+  collections: [
+    {
+      slug: 'media',
+      upload: true,
+      fields: [],
+    },
+  ],
+  plugins: [
+    imagekitStorage({
+      clientUploads: true,
+      folder: '/payload-uploads',
+      collections: {
+        media: true,
+      },
+      privateKey: process.env.IMAGEKIT_PRIVATE_KEY || '',
+      publicKey: process.env.IMAGEKIT_PUBLIC_KEY || '',
+      urlEndpoint: process.env.IMAGEKIT_URL_ENDPOINT || '',
+    }),
+  ],
+})
+```
+
+## Configuration
+
+`imagekitStorage(options)` options:
+
+- `collections` (required): `Partial<Record<UploadCollectionSlug, true>>`
+- `folder` (required): root upload folder in ImageKit, e.g. `/payload-uploads`
+- `privateKey` (required): ImageKit private API key
+- `publicKey` (required): ImageKit public key
+- `urlEndpoint` (required): ImageKit URL endpoint, e.g. `https://ik.imagekit.io/your_id`
+- `clientUploads` (optional): when `true`, Payload admin uploads go directly from the browser to ImageKit before Payload fetches the file back for persistence and image-size generation. This helps avoid server request body limits such as Vercel's.
+  Duplicate filenames still follow Payload's normal safe-name behavior, so a second `pug.jpg` becomes `pug-1.jpg` instead of overwriting the first asset in ImageKit.
+- `enabled` (optional): enable / disable plugin
+- `alwaysInsertFields` (optional): pass-through to cloud storage plugin
+- `disablePayloadAccessControl` (optional): pass-through to cloud storage plugin
+
+## Exports
+
+- `imagekitStorage` (primary)
+- `migrateFolder`
+- `payloadStorageImagekit` (alias of `imagekitStorage`)
+
+## Folder Migration
+
+Use `migrateFolder` to copy uploads from one ImageKit root folder to another (e.g. staging to production).
+
+Behavior:
+
+- Copies files one-by-one per collection
+- Creates destination folders automatically if they do not exist
+- Optional database update via Payload local API
+- Dry-run is enabled by default (`dryRun: true`)
+- Copies from the configured source folder path first, with stored `imagekit.url` as a fallback only when the source file cannot be found
+
+Example:
+
+```ts
+import { migrateFolder } from '@humaan/payload-storage-imagekit'
+import config from '@payload-config'
+import { getPayload } from 'payload'
+
+const payload = await getPayload({ config })
+
+const results = await migrateFolder({
+  collections: { media: true },
+  dryRun: true,
+  from: process.env.IMAGEKIT_FOLDER!,
+  payload,
+  privateKey: process.env.IMAGEKIT_PRIVATE_KEY!,
+  to: process.env.IMAGEKIT_FOLDER_MIGRATION_DESTINATION!,
+  urlEndpoint: process.env.IMAGEKIT_URL_ENDPOINT!,
+})
+
+console.log(results)
+await payload.destroy()
+```
+
+`migrateFolder(options)` options:
+
+- `collections` (required): `Partial<Record<UploadCollectionSlug, true>>`
+- `from` (required): source root folder, e.g. `/payload-uploads-staging`
+- `to` (required): destination root folder, e.g. `/payload-uploads-production`
+- `privateKey` (required): ImageKit private API key
+- `urlEndpoint` (required): ImageKit URL endpoint
+- `dryRun` (optional, default `true`): when `true`, logs what would happen without writes
+- `payload` (optional): when provided and `dryRun` is `false`, updates `url` + `imagekit.*` fields
+
+Run a migration script:
+
+```bash
+# dry-run (default)
+pnpx tsx --env-file=../.env imagekit-migration.ts
+
+# live run
+DRY_RUN=false pnpx tsx --env-file=../.env imagekit-migration.ts
+```
+
+## Notes
+
+- Files are uploaded under: `<folder>/<collectionSlug>/<filename>`.
+- With `clientUploads: true`, the browser uploads the original file directly to ImageKit, then Payload continues its normal document save flow using the uploaded asset.
+- Deletion prefers stored `imagekit.fileId`, with path lookup fallback.
+- Admin thumbnail behavior:
+  - Images: `<imagekit.url>?tr=w-300,h-300`
+  - Videos / PDFs: `<imagekit.url>/ik-thumbnail.jpg?tr=w-300,h-300`
+
+## Development
+
+```bash
+pnpm dev
+pnpm test:int
+pnpm build
+```

package/dist/clientUploads.d.ts

@@ -0,0 +1,16 @@
+export declare const imageKitUploadAuthBasePath = "/imagekit-upload-auth";
+export declare const getImageKitUploadAuthPath: (collectionSlug: string) => `/${string}`;
+export type ImageKitClientUploadContext = {
+    fileId?: string;
+    filePath?: string;
+    name?: string;
+    thumbnailUrl?: string;
+    url?: string;
+};
+export type ImageKitUploadHandlerProps = {
+    authPath: `/${string}`;
+    collectionSlug: string;
+    folder: string;
+    publicKey: string;
+};
+export declare const isImageKitClientUploadContext: (value: unknown) => value is ImageKitClientUploadContext;

package/dist/clientUploads.js

@@ -0,0 +1,10 @@
+export const imageKitUploadAuthBasePath = '/imagekit-upload-auth';
+export const getImageKitUploadAuthPath = (collectionSlug)=>`${imageKitUploadAuthBasePath}/${collectionSlug}`;
+export const isImageKitClientUploadContext = (value)=>{
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    return 'fileId' in value || 'thumbnailUrl' in value || 'url' in value;
+};
+
+//# sourceMappingURL=clientUploads.js.map

package/dist/clientUploads.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/clientUploads.ts"],"sourcesContent":["export const imageKitUploadAuthBasePath = '/imagekit-upload-auth'\n\nexport const getImageKitUploadAuthPath = (collectionSlug: string): `/${string}` =>\n  `${imageKitUploadAuthBasePath}/${collectionSlug}`\n\nexport type ImageKitClientUploadContext = {\n  fileId?: string\n  filePath?: string\n  name?: string\n  thumbnailUrl?: string\n  url?: string\n}\n\nexport type ImageKitUploadHandlerProps = {\n  authPath: `/${string}`\n  collectionSlug: string\n  folder: string\n  publicKey: string\n}\n\nexport const isImageKitClientUploadContext = (\n  value: unknown,\n): value is ImageKitClientUploadContext => {\n  if (!value || typeof value !== 'object') {\n    return false\n  }\n\n  return 'fileId' in value || 'thumbnailUrl' in value || 'url' in value\n}\n"],"names":["imageKitUploadAuthBasePath","getImageKitUploadAuthPath","collectionSlug","isImageKitClientUploadContext","value"],"mappings":"AAAA,OAAO,MAAMA,6BAA6B,wBAAuB;AAEjE,OAAO,MAAMC,4BAA4B,CAACC,iBACxC,GAAGF,2BAA2B,CAAC,EAAEE,gBAAgB,CAAA;AAiBnD,OAAO,MAAMC,gCAAgC,CAC3CC;IAEA,IAAI,CAACA,SAAS,OAAOA,UAAU,UAAU;QACvC,OAAO;IACT;IAEA,OAAO,YAAYA,SAAS,kBAAkBA,SAAS,SAASA;AAClE,EAAC"}

package/dist/components/BeforeDashboardClient.d.ts

@@ -0,0 +1 @@
+export declare const BeforeDashboardClient: () => import("react").JSX.Element;

package/dist/components/BeforeDashboardClient.js

@@ -0,0 +1,40 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useConfig } from '@payloadcms/ui';
+import { formatAdminURL } from 'payload/shared';
+import { useEffect, useState } from 'react';
+export const BeforeDashboardClient = ()=>{
+    const { config } = useConfig();
+    const [message, setMessage] = useState('');
+    useEffect(()=>{
+        const fetchMessage = async ()=>{
+            const response = await fetch(formatAdminURL({
+                apiRoute: config.routes.api,
+                path: '/my-plugin-endpoint'
+            }));
+            const result = await response.json();
+            setMessage(result.message);
+        };
+        void fetchMessage();
+    }, [
+        config.serverURL,
+        config.routes.api
+    ]);
+    return /*#__PURE__*/ _jsxs("div", {
+        children: [
+            /*#__PURE__*/ _jsx("h1", {
+                children: "Added by the plugin: Before Dashboard Client"
+            }),
+            /*#__PURE__*/ _jsxs("div", {
+                children: [
+                    "Message from the endpoint:",
+                    /*#__PURE__*/ _jsx("div", {
+                        children: message || 'Loading...'
+                    })
+                ]
+            })
+        ]
+    });
+};
+
+//# sourceMappingURL=BeforeDashboardClient.js.map

package/dist/components/BeforeDashboardClient.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/BeforeDashboardClient.tsx"],"sourcesContent":["'use client'\nimport { useConfig } from '@payloadcms/ui'\nimport { formatAdminURL } from 'payload/shared'\nimport { useEffect, useState } from 'react'\n\nexport const BeforeDashboardClient = () => {\n  const { config } = useConfig()\n\n  const [message, setMessage] = useState('')\n\n  useEffect(() => {\n    const fetchMessage = async () => {\n      const response = await fetch(\n        formatAdminURL({\n          apiRoute: config.routes.api,\n          path: '/my-plugin-endpoint',\n        }),\n      )\n      const result = await response.json()\n      setMessage(result.message)\n    }\n\n    void fetchMessage()\n  }, [config.serverURL, config.routes.api])\n\n  return (\n    <div>\n      <h1>Added by the plugin: Before Dashboard Client</h1>\n      <div>\n        Message from the endpoint:\n        <div>{message || 'Loading...'}</div>\n      </div>\n    </div>\n  )\n}\n"],"names":["useConfig","formatAdminURL","useEffect","useState","BeforeDashboardClient","config","message","setMessage","fetchMessage","response","fetch","apiRoute","routes","api","path","result","json","serverURL","div","h1"],"mappings":"AAAA;;AACA,SAASA,SAAS,QAAQ,iBAAgB;AAC1C,SAASC,cAAc,QAAQ,iBAAgB;AAC/C,SAASC,SAAS,EAAEC,QAAQ,QAAQ,QAAO;AAE3C,OAAO,MAAMC,wBAAwB;IACnC,MAAM,EAAEC,MAAM,EAAE,GAAGL;IAEnB,MAAM,CAACM,SAASC,WAAW,GAAGJ,SAAS;IAEvCD,UAAU;QACR,MAAMM,eAAe;YACnB,MAAMC,WAAW,MAAMC,MACrBT,eAAe;gBACbU,UAAUN,OAAOO,MAAM,CAACC,GAAG;gBAC3BC,MAAM;YACR;YAEF,MAAMC,SAAS,MAAMN,SAASO,IAAI;YAClCT,WAAWQ,OAAOT,OAAO;QAC3B;QAEA,KAAKE;IACP,GAAG;QAACH,OAAOY,SAAS;QAAEZ,OAAOO,MAAM,CAACC,GAAG;KAAC;IAExC,qBACE,MAACK;;0BACC,KAACC;0BAAG;;0BACJ,MAACD;;oBAAI;kCAEH,KAACA;kCAAKZ,WAAW;;;;;;AAIzB,EAAC"}

package/dist/components/BeforeDashboardServer.d.ts

@@ -0,0 +1,2 @@
+import type { ServerComponentProps } from 'payload';
+export declare const BeforeDashboardServer: (props: ServerComponentProps) => Promise<import("react").JSX.Element>;

package/dist/components/BeforeDashboardServer.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import styles from './BeforeDashboardServer.module.css';
+export const BeforeDashboardServer = async (props)=>{
+    const { payload } = props;
+    const { docs } = await payload.find({
+        collection: 'plugin-collection'
+    });
+    return /*#__PURE__*/ _jsxs("div", {
+        className: styles.wrapper,
+        children: [
+            /*#__PURE__*/ _jsx("h1", {
+                children: "Added by the plugin: Before Dashboard Server"
+            }),
+            "Docs from Local API:",
+            docs.map((doc)=>/*#__PURE__*/ _jsx("div", {
+                    children: doc.id
+                }, doc.id))
+        ]
+    });
+};
+
+//# sourceMappingURL=BeforeDashboardServer.js.map

package/dist/components/BeforeDashboardServer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/BeforeDashboardServer.tsx"],"sourcesContent":["import type { ServerComponentProps } from 'payload'\n\nimport styles from './BeforeDashboardServer.module.css'\n\nexport const BeforeDashboardServer = async (props: ServerComponentProps) => {\n  const { payload } = props\n\n  const { docs } = await payload.find({ collection: 'plugin-collection' })\n\n  return (\n    <div className={styles.wrapper}>\n      <h1>Added by the plugin: Before Dashboard Server</h1>\n      Docs from Local API:\n      {docs.map((doc) => (\n        <div key={doc.id}>{doc.id}</div>\n      ))}\n    </div>\n  )\n}\n"],"names":["styles","BeforeDashboardServer","props","payload","docs","find","collection","div","className","wrapper","h1","map","doc","id"],"mappings":";AAEA,OAAOA,YAAY,qCAAoC;AAEvD,OAAO,MAAMC,wBAAwB,OAAOC;IAC1C,MAAM,EAAEC,OAAO,EAAE,GAAGD;IAEpB,MAAM,EAAEE,IAAI,EAAE,GAAG,MAAMD,QAAQE,IAAI,CAAC;QAAEC,YAAY;IAAoB;IAEtE,qBACE,MAACC;QAAIC,WAAWR,OAAOS,OAAO;;0BAC5B,KAACC;0BAAG;;YAAiD;YAEpDN,KAAKO,GAAG,CAAC,CAACC,oBACT,KAACL;8BAAkBK,IAAIC,EAAE;mBAAfD,IAAIC,EAAE;;;AAIxB,EAAC"}

package/dist/components/BeforeDashboardServer.module.css

@@ -0,0 +1,5 @@
+.wrapper {
+  display: flex;
+  gap: 5px;
+  flex-direction: column;
+}

package/dist/components/ImageKitUploadHandler.d.ts

@@ -0,0 +1,2 @@
+import type { ImageKitUploadHandlerProps } from '../clientUploads.js';
+export declare const ImageKitUploadHandler: ({ authPath, collectionSlug, folder, publicKey, }: ImageKitUploadHandlerProps) => null;

package/dist/components/ImageKitUploadHandler.js

@@ -0,0 +1,77 @@
+'use client';
+import { useConfig, useUploadHandlers } from '@payloadcms/ui';
+import { formatAdminURL } from 'payload/shared';
+import { useEffect } from 'react';
+const uploadAPIURL = 'https://upload.imagekit.io/api/v1/files/upload';
+const readErrorMessage = async (response, fallback)=>{
+    try {
+        const result = await response.json();
+        if (typeof result.message === 'string' && result.message.trim().length > 0) {
+            return result.message;
+        }
+    } catch  {
+    // Ignore non-JSON responses and fall back to the default message.
+    }
+    return fallback;
+};
+export const ImageKitUploadHandler = ({ authPath, collectionSlug, folder, publicKey })=>{
+    const { config } = useConfig();
+    const { setUploadHandler } = useUploadHandlers();
+    useEffect(()=>{
+        const authURL = formatAdminURL({
+            apiRoute: config.routes.api,
+            path: authPath
+        });
+        setUploadHandler({
+            collectionSlug,
+            handler: async ({ file, updateFilename })=>{
+                const authRequestURL = new URL(authURL, window.location.origin);
+                authRequestURL.searchParams.set('filename', file.name);
+                const authResponse = await fetch(authRequestURL, {
+                    credentials: 'include'
+                });
+                if (!authResponse.ok) {
+                    throw new Error(await readErrorMessage(authResponse, 'Failed to authenticate direct ImageKit upload.'));
+                }
+                const auth = await authResponse.json();
+                const safeFilename = typeof auth.fileName === 'string' && auth.fileName.length > 0 ? auth.fileName : file.name;
+                const formData = new FormData();
+                formData.set('expire', String(auth.expire));
+                formData.set('file', file);
+                formData.set('fileName', safeFilename);
+                formData.set('folder', folder);
+                formData.set('publicKey', publicKey);
+                formData.set('signature', auth.signature);
+                formData.set('token', auth.token);
+                formData.set('useUniqueFileName', 'false');
+                const uploadResponse = await fetch(uploadAPIURL, {
+                    body: formData,
+                    method: 'POST'
+                });
+                if (!uploadResponse.ok) {
+                    throw new Error(await readErrorMessage(uploadResponse, 'Failed to upload file to ImageKit.'));
+                }
+                const uploaded = await uploadResponse.json();
+                const uploadedFilename = typeof uploaded.name === 'string' && uploaded.name.length > 0 ? uploaded.name : safeFilename;
+                updateFilename(uploadedFilename);
+                return {
+                    name: uploadedFilename,
+                    fileId: uploaded.fileId,
+                    filePath: uploaded.filePath,
+                    thumbnailUrl: uploaded.thumbnailUrl,
+                    url: uploaded.url
+                };
+            }
+        });
+    }, [
+        authPath,
+        collectionSlug,
+        config.routes.api,
+        folder,
+        publicKey,
+        setUploadHandler
+    ]);
+    return null;
+};
+
+//# sourceMappingURL=ImageKitUploadHandler.js.map

package/dist/components/ImageKitUploadHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/ImageKitUploadHandler.tsx"],"sourcesContent":["'use client'\n\nimport { useConfig, useUploadHandlers } from '@payloadcms/ui'\nimport { formatAdminURL } from 'payload/shared'\nimport { useEffect } from 'react'\n\nimport type {\n  ImageKitClientUploadContext,\n  ImageKitUploadHandlerProps,\n} from '../clientUploads.js'\n\ntype ImageKitAuthResponse = {\n  expire: number\n  fileName?: string\n  signature: string\n  token: string\n}\n\ntype ImageKitUploadResponse = {\n  message?: string\n  name?: string\n} & ImageKitClientUploadContext\n\nconst uploadAPIURL = 'https://upload.imagekit.io/api/v1/files/upload'\n\nconst readErrorMessage = async (response: Response, fallback: string): Promise<string> => {\n  try {\n    const result = (await response.json()) as { message?: string }\n\n    if (typeof result.message === 'string' && result.message.trim().length > 0) {\n      return result.message\n    }\n  } catch {\n    // Ignore non-JSON responses and fall back to the default message.\n  }\n\n  return fallback\n}\n\nexport const ImageKitUploadHandler = ({\n  authPath,\n  collectionSlug,\n  folder,\n  publicKey,\n}: ImageKitUploadHandlerProps) => {\n  const { config } = useConfig()\n  const { setUploadHandler } = useUploadHandlers()\n\n  useEffect(() => {\n    const authURL = formatAdminURL({\n      apiRoute: config.routes.api,\n      path: authPath,\n    })\n\n    setUploadHandler({\n      collectionSlug,\n      handler: async ({ file, updateFilename }) => {\n        const authRequestURL = new URL(authURL, window.location.origin)\n\n        authRequestURL.searchParams.set('filename', file.name)\n\n        const authResponse = await fetch(authRequestURL, {\n          credentials: 'include',\n        })\n\n        if (!authResponse.ok) {\n          throw new Error(\n            await readErrorMessage(\n              authResponse,\n              'Failed to authenticate direct ImageKit upload.',\n            ),\n          )\n        }\n\n        const auth = (await authResponse.json()) as ImageKitAuthResponse\n        const safeFilename =\n          typeof auth.fileName === 'string' && auth.fileName.length > 0 ? auth.fileName : file.name\n        const formData = new FormData()\n\n        formData.set('expire', String(auth.expire))\n        formData.set('file', file)\n        formData.set('fileName', safeFilename)\n        formData.set('folder', folder)\n        formData.set('publicKey', publicKey)\n        formData.set('signature', auth.signature)\n        formData.set('token', auth.token)\n        formData.set('useUniqueFileName', 'false')\n\n        const uploadResponse = await fetch(uploadAPIURL, {\n          body: formData,\n          method: 'POST',\n        })\n\n        if (!uploadResponse.ok) {\n          throw new Error(\n            await readErrorMessage(uploadResponse, 'Failed to upload file to ImageKit.'),\n          )\n        }\n\n        const uploaded = (await uploadResponse.json()) as ImageKitUploadResponse\n        const uploadedFilename =\n          typeof uploaded.name === 'string' && uploaded.name.length > 0 ? uploaded.name : safeFilename\n\n        updateFilename(uploadedFilename)\n\n        return {\n          name: uploadedFilename,\n          fileId: uploaded.fileId,\n          filePath: uploaded.filePath,\n          thumbnailUrl: uploaded.thumbnailUrl,\n          url: uploaded.url,\n        }\n      },\n    })\n  }, [authPath, collectionSlug, config.routes.api, folder, publicKey, setUploadHandler])\n\n  return null\n}\n"],"names":["useConfig","useUploadHandlers","formatAdminURL","useEffect","uploadAPIURL","readErrorMessage","response","fallback","result","json","message","trim","length","ImageKitUploadHandler","authPath","collectionSlug","folder","publicKey","config","setUploadHandler","authURL","apiRoute","routes","api","path","handler","file","updateFilename","authRequestURL","URL","window","location","origin","searchParams","set","name","authResponse","fetch","credentials","ok","Error","auth","safeFilename","fileName","formData","FormData","String","expire","signature","token","uploadResponse","body","method","uploaded","uploadedFilename","fileId","filePath","thumbnailUrl","url"],"mappings":"AAAA;AAEA,SAASA,SAAS,EAAEC,iBAAiB,QAAQ,iBAAgB;AAC7D,SAASC,cAAc,QAAQ,iBAAgB;AAC/C,SAASC,SAAS,QAAQ,QAAO;AAmBjC,MAAMC,eAAe;AAErB,MAAMC,mBAAmB,OAAOC,UAAoBC;IAClD,IAAI;QACF,MAAMC,SAAU,MAAMF,SAASG,IAAI;QAEnC,IAAI,OAAOD,OAAOE,OAAO,KAAK,YAAYF,OAAOE,OAAO,CAACC,IAAI,GAAGC,MAAM,GAAG,GAAG;YAC1E,OAAOJ,OAAOE,OAAO;QACvB;IACF,EAAE,OAAM;IACN,kEAAkE;IACpE;IAEA,OAAOH;AACT;AAEA,OAAO,MAAMM,wBAAwB,CAAC,EACpCC,QAAQ,EACRC,cAAc,EACdC,MAAM,EACNC,SAAS,EACkB;IAC3B,MAAM,EAAEC,MAAM,EAAE,GAAGlB;IACnB,MAAM,EAAEmB,gBAAgB,EAAE,GAAGlB;IAE7BE,UAAU;QACR,MAAMiB,UAAUlB,eAAe;YAC7BmB,UAAUH,OAAOI,MAAM,CAACC,GAAG;YAC3BC,MAAMV;QACR;QAEAK,iBAAiB;YACfJ;YACAU,SAAS,OAAO,EAAEC,IAAI,EAAEC,cAAc,EAAE;gBACtC,MAAMC,iBAAiB,IAAIC,IAAIT,SAASU,OAAOC,QAAQ,CAACC,MAAM;gBAE9DJ,eAAeK,YAAY,CAACC,GAAG,CAAC,YAAYR,KAAKS,IAAI;gBAErD,MAAMC,eAAe,MAAMC,MAAMT,gBAAgB;oBAC/CU,aAAa;gBACf;gBAEA,IAAI,CAACF,aAAaG,EAAE,EAAE;oBACpB,MAAM,IAAIC,MACR,MAAMnC,iBACJ+B,cACA;gBAGN;gBAEA,MAAMK,OAAQ,MAAML,aAAa3B,IAAI;gBACrC,MAAMiC,eACJ,OAAOD,KAAKE,QAAQ,KAAK,YAAYF,KAAKE,QAAQ,CAAC/B,MAAM,GAAG,IAAI6B,KAAKE,QAAQ,GAAGjB,KAAKS,IAAI;gBAC3F,MAAMS,WAAW,IAAIC;gBAErBD,SAASV,GAAG,CAAC,UAAUY,OAAOL,KAAKM,MAAM;gBACzCH,SAASV,GAAG,CAAC,QAAQR;gBACrBkB,SAASV,GAAG,CAAC,YAAYQ;gBACzBE,SAASV,GAAG,CAAC,UAAUlB;gBACvB4B,SAASV,GAAG,CAAC,aAAajB;gBAC1B2B,SAASV,GAAG,CAAC,aAAaO,KAAKO,SAAS;gBACxCJ,SAASV,GAAG,CAAC,SAASO,KAAKQ,KAAK;gBAChCL,SAASV,GAAG,CAAC,qBAAqB;gBAElC,MAAMgB,iBAAiB,MAAMb,MAAMjC,cAAc;oBAC/C+C,MAAMP;oBACNQ,QAAQ;gBACV;gBAEA,IAAI,CAACF,eAAeX,EAAE,EAAE;oBACtB,MAAM,IAAIC,MACR,MAAMnC,iBAAiB6C,gBAAgB;gBAE3C;gBAEA,MAAMG,WAAY,MAAMH,eAAezC,IAAI;gBAC3C,MAAM6C,mBACJ,OAAOD,SAASlB,IAAI,KAAK,YAAYkB,SAASlB,IAAI,CAACvB,MAAM,GAAG,IAAIyC,SAASlB,IAAI,GAAGO;gBAElFf,eAAe2B;gBAEf,OAAO;oBACLnB,MAAMmB;oBACNC,QAAQF,SAASE,MAAM;oBACvBC,UAAUH,SAASG,QAAQ;oBAC3BC,cAAcJ,SAASI,YAAY;oBACnCC,KAAKL,SAASK,GAAG;gBACnB;YACF;QACF;IACF,GAAG;QAAC5C;QAAUC;QAAgBG,OAAOI,MAAM,CAACC,GAAG;QAAEP;QAAQC;QAAWE;KAAiB;IAErF,OAAO;AACT,EAAC"}

package/dist/endpoints/createImageKitUploadAuthHandler.d.ts

@@ -0,0 +1,8 @@
+import type ImageKit from '@imagekit/nodejs';
+import type { PayloadHandler, UploadCollectionSlug } from 'payload';
+type CreateImageKitUploadAuthHandlerArgs = {
+    client: ImageKit;
+    collections: Partial<Record<UploadCollectionSlug, true>>;
+};
+export declare const createImageKitUploadAuthHandler: ({ client, collections, }: CreateImageKitUploadAuthHandlerArgs) => PayloadHandler;
+export {};

package/dist/endpoints/createImageKitUploadAuthHandler.js

@@ -0,0 +1,47 @@
+import { getSafeFileName } from 'payload/internal';
+export const createImageKitUploadAuthHandler = ({ client, collections })=>{
+    return async (req)=>{
+        const collectionSlug = req.routeParams?.collection;
+        if (typeof collectionSlug !== 'string' || !(collectionSlug in collections) || collections[collectionSlug] !== true) {
+            return Response.json({
+                message: 'Collection not found.'
+            }, {
+                status: 404
+            });
+        }
+        if (!req.user) {
+            return Response.json({
+                message: 'Unauthorized.'
+            }, {
+                status: 401
+            });
+        }
+        const authenticationParameters = client.helper.getAuthenticationParameters();
+        const requestURL = new URL(req.url || 'http://localhost');
+        const requestedFilename = requestURL.searchParams.get('filename')?.trim();
+        const collection = req.payload.collections[collectionSlug];
+        if (!requestedFilename || typeof collection?.config.upload !== 'object' || typeof collection.config.upload.staticDir !== 'string') {
+            return Response.json(authenticationParameters, {
+                headers: {
+                    'Cache-Control': 'no-store'
+                }
+            });
+        }
+        const safeFilename = await getSafeFileName({
+            collectionSlug,
+            desiredFilename: requestedFilename,
+            req,
+            staticPath: collection.config.upload.staticDir
+        });
+        return Response.json({
+            ...authenticationParameters,
+            fileName: safeFilename
+        }, {
+            headers: {
+                'Cache-Control': 'no-store'
+            }
+        });
+    };
+};
+
+//# sourceMappingURL=createImageKitUploadAuthHandler.js.map

package/dist/endpoints/createImageKitUploadAuthHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/endpoints/createImageKitUploadAuthHandler.ts"],"sourcesContent":["import type ImageKit from '@imagekit/nodejs'\nimport type { PayloadHandler, UploadCollectionSlug } from 'payload'\n\nimport { getSafeFileName } from 'payload/internal'\n\ntype CreateImageKitUploadAuthHandlerArgs = {\n  client: ImageKit\n  collections: Partial<Record<UploadCollectionSlug, true>>\n}\n\nexport const createImageKitUploadAuthHandler = ({\n  client,\n  collections,\n}: CreateImageKitUploadAuthHandlerArgs): PayloadHandler => {\n  return async (req) => {\n    const collectionSlug = req.routeParams?.collection\n\n    if (typeof collectionSlug !== 'string' || !(collectionSlug in collections) || collections[collectionSlug] !== true) {\n      return Response.json({ message: 'Collection not found.' }, { status: 404 })\n    }\n\n    if (!req.user) {\n      return Response.json({ message: 'Unauthorized.' }, { status: 401 })\n    }\n\n    const authenticationParameters = client.helper.getAuthenticationParameters()\n    const requestURL = new URL(req.url || 'http://localhost')\n    const requestedFilename = requestURL.searchParams.get('filename')?.trim()\n    const collection = req.payload.collections[collectionSlug]\n\n    if (\n      !requestedFilename ||\n      typeof collection?.config.upload !== 'object' ||\n      typeof collection.config.upload.staticDir !== 'string'\n    ) {\n      return Response.json(authenticationParameters, {\n        headers: {\n          'Cache-Control': 'no-store',\n        },\n      })\n    }\n\n    const safeFilename = await getSafeFileName({\n      collectionSlug,\n      desiredFilename: requestedFilename,\n      req,\n      staticPath: collection.config.upload.staticDir,\n    })\n\n    return Response.json({ ...authenticationParameters, fileName: safeFilename }, {\n      headers: {\n        'Cache-Control': 'no-store',\n      },\n    })\n  }\n}\n"],"names":["getSafeFileName","createImageKitUploadAuthHandler","client","collections","req","collectionSlug","routeParams","collection","Response","json","message","status","user","authenticationParameters","helper","getAuthenticationParameters","requestURL","URL","url","requestedFilename","searchParams","get","trim","payload","config","upload","staticDir","headers","safeFilename","desiredFilename","staticPath","fileName"],"mappings":"AAGA,SAASA,eAAe,QAAQ,mBAAkB;AAOlD,OAAO,MAAMC,kCAAkC,CAAC,EAC9CC,MAAM,EACNC,WAAW,EACyB;IACpC,OAAO,OAAOC;QACZ,MAAMC,iBAAiBD,IAAIE,WAAW,EAAEC;QAExC,IAAI,OAAOF,mBAAmB,YAAY,CAAEA,CAAAA,kBAAkBF,WAAU,KAAMA,WAAW,CAACE,eAAe,KAAK,MAAM;YAClH,OAAOG,SAASC,IAAI,CAAC;gBAAEC,SAAS;YAAwB,GAAG;gBAAEC,QAAQ;YAAI;QAC3E;QAEA,IAAI,CAACP,IAAIQ,IAAI,EAAE;YACb,OAAOJ,SAASC,IAAI,CAAC;gBAAEC,SAAS;YAAgB,GAAG;gBAAEC,QAAQ;YAAI;QACnE;QAEA,MAAME,2BAA2BX,OAAOY,MAAM,CAACC,2BAA2B;QAC1E,MAAMC,aAAa,IAAIC,IAAIb,IAAIc,GAAG,IAAI;QACtC,MAAMC,oBAAoBH,WAAWI,YAAY,CAACC,GAAG,CAAC,aAAaC;QACnE,MAAMf,aAAaH,IAAImB,OAAO,CAACpB,WAAW,CAACE,eAAe;QAE1D,IACE,CAACc,qBACD,OAAOZ,YAAYiB,OAAOC,WAAW,YACrC,OAAOlB,WAAWiB,MAAM,CAACC,MAAM,CAACC,SAAS,KAAK,UAC9C;YACA,OAAOlB,SAASC,IAAI,CAACI,0BAA0B;gBAC7Cc,SAAS;oBACP,iBAAiB;gBACnB;YACF;QACF;QAEA,MAAMC,eAAe,MAAM5B,gBAAgB;YACzCK;YACAwB,iBAAiBV;YACjBf;YACA0B,YAAYvB,WAAWiB,MAAM,CAACC,MAAM,CAACC,SAAS;QAChD;QAEA,OAAOlB,SAASC,IAAI,CAAC;YAAE,GAAGI,wBAAwB;YAAEkB,UAAUH;QAAa,GAAG;YAC5ED,SAAS;gBACP,iBAAiB;YACnB;QACF;IACF;AACF,EAAC"}

package/dist/endpoints/customEndpointHandler.d.ts

@@ -0,0 +1,8 @@
+import type ImageKit from '@imagekit/nodejs';
+import type { PayloadHandler, UploadCollectionSlug } from 'payload';
+type CreateImageKitUploadAuthHandlerArgs = {
+    client: ImageKit;
+    collections: Partial<Record<UploadCollectionSlug, true>>;
+};
+export declare const createImageKitUploadAuthHandler: ({ client, collections, }: CreateImageKitUploadAuthHandlerArgs) => PayloadHandler;
+export {};

package/dist/endpoints/customEndpointHandler.js

@@ -0,0 +1,26 @@
+export const createImageKitUploadAuthHandler = ({ client, collections })=>{
+    return async (req)=>{
+        const collectionSlug = req.routeParams?.collection;
+        if (typeof collectionSlug !== 'string' || !(collectionSlug in collections) || collections[collectionSlug] !== true) {
+            return Response.json({
+                message: 'Collection not found.'
+            }, {
+                status: 404
+            });
+        }
+        if (!req.user) {
+            return Response.json({
+                message: 'Unauthorized.'
+            }, {
+                status: 401
+            });
+        }
+        return Response.json(client.helper.getAuthenticationParameters(), {
+            headers: {
+                'Cache-Control': 'no-store'
+            }
+        });
+    };
+};
+
+//# sourceMappingURL=customEndpointHandler.js.map

package/dist/endpoints/customEndpointHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/endpoints/customEndpointHandler.ts"],"sourcesContent":["import type { UploadCollectionSlug, PayloadHandler } from 'payload'\n\nimport type ImageKit from '@imagekit/nodejs'\n\ntype CreateImageKitUploadAuthHandlerArgs = {\n  client: ImageKit\n  collections: Partial<Record<UploadCollectionSlug, true>>\n}\n\nexport const createImageKitUploadAuthHandler = ({\n  client,\n  collections,\n}: CreateImageKitUploadAuthHandlerArgs): PayloadHandler => {\n  return async (req) => {\n    const collectionSlug = req.routeParams?.collection\n\n    if (\n      typeof collectionSlug !== 'string' ||\n      !(collectionSlug in collections) ||\n      collections[collectionSlug as UploadCollectionSlug] !== true\n    ) {\n      return Response.json({ message: 'Collection not found.' }, { status: 404 })\n    }\n\n    if (!req.user) {\n      return Response.json({ message: 'Unauthorized.' }, { status: 401 })\n    }\n\n    return Response.json(client.helper.getAuthenticationParameters(), {\n      headers: {\n        'Cache-Control': 'no-store',\n      },\n    })\n  }\n}\n"],"names":["createImageKitUploadAuthHandler","client","collections","req","collectionSlug","routeParams","collection","Response","json","message","status","user","helper","getAuthenticationParameters","headers"],"mappings":"AASA,OAAO,MAAMA,kCAAkC,CAAC,EAC9CC,MAAM,EACNC,WAAW,EACyB;IACpC,OAAO,OAAOC;QACZ,MAAMC,iBAAiBD,IAAIE,WAAW,EAAEC;QAExC,IACE,OAAOF,mBAAmB,YAC1B,CAAEA,CAAAA,kBAAkBF,WAAU,KAC9BA,WAAW,CAACE,eAAuC,KAAK,MACxD;YACA,OAAOG,SAASC,IAAI,CAAC;gBAAEC,SAAS;YAAwB,GAAG;gBAAEC,QAAQ;YAAI;QAC3E;QAEA,IAAI,CAACP,IAAIQ,IAAI,EAAE;YACb,OAAOJ,SAASC,IAAI,CAAC;gBAAEC,SAAS;YAAgB,GAAG;gBAAEC,QAAQ;YAAI;QACnE;QAEA,OAAOH,SAASC,IAAI,CAACP,OAAOW,MAAM,CAACC,2BAA2B,IAAI;YAChEC,SAAS;gBACP,iBAAiB;YACnB;QACF;IACF;AACF,EAAC"}

package/dist/exports/client.d.ts

@@ -0,0 +1,3 @@
+export type { ImageKitClientUploadContext, ImageKitUploadHandlerProps, } from '../clientUploads.js';
+export { BeforeDashboardClient } from '../components/BeforeDashboardClient.js';
+export { ImageKitUploadHandler } from '../components/ImageKitUploadHandler.js';

package/dist/exports/client.js

@@ -0,0 +1,4 @@
+export { BeforeDashboardClient } from '../components/BeforeDashboardClient.js';
+export { ImageKitUploadHandler } from '../components/ImageKitUploadHandler.js';
+
+//# sourceMappingURL=client.js.map

package/dist/exports/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/exports/client.ts"],"sourcesContent":["export type {\n  ImageKitClientUploadContext,\n  ImageKitUploadHandlerProps,\n} from '../clientUploads.js'\nexport { BeforeDashboardClient } from '../components/BeforeDashboardClient.js'\nexport { ImageKitUploadHandler } from '../components/ImageKitUploadHandler.js'\n"],"names":["BeforeDashboardClient","ImageKitUploadHandler"],"mappings":"AAIA,SAASA,qBAAqB,QAAQ,yCAAwC;AAC9E,SAASC,qBAAqB,QAAQ,yCAAwC"}

package/dist/exports/rsc.d.ts

@@ -0,0 +1 @@
+export { BeforeDashboardServer } from '../components/BeforeDashboardServer.js';

package/dist/exports/rsc.js

@@ -0,0 +1,3 @@
+export { BeforeDashboardServer } from '../components/BeforeDashboardServer.js';
+
+//# sourceMappingURL=rsc.js.map

package/dist/exports/rsc.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/exports/rsc.ts"],"sourcesContent":["export { BeforeDashboardServer } from '../components/BeforeDashboardServer.js'\n"],"names":["BeforeDashboardServer"],"mappings":"AAAA,SAASA,qBAAqB,QAAQ,yCAAwC"}

package/dist/getAdminThumbnailURL.d.ts

@@ -0,0 +1 @@
+export declare const getAdminThumbnailURL: (doc: unknown) => string;

package/dist/getAdminThumbnailURL.js

@@ -0,0 +1,22 @@
+export const getAdminThumbnailURL = (doc)=>{
+    const file = doc;
+    const baseURL = file.imagekit?.url;
+    if (!baseURL) {
+        return '';
+    }
+    const isVideo = file.mimeType?.startsWith('video');
+    const isPDF = file.mimeType === 'application/pdf' || file.mimeType?.endsWith('/pdf');
+    let thumbnailBaseURL = baseURL;
+    if (isVideo || isPDF) {
+        try {
+            const parsedURL = new URL(baseURL);
+            thumbnailBaseURL = `${parsedURL.origin}${parsedURL.pathname}/ik-thumbnail.jpg`;
+        } catch  {
+            const normalizedBaseURL = baseURL.split('?')[0].split('#')[0];
+            thumbnailBaseURL = `${normalizedBaseURL}/ik-thumbnail.jpg`;
+        }
+    }
+    return `${thumbnailBaseURL}${thumbnailBaseURL.includes('?') ? '&' : '?'}tr=w-300,h-300`;
+};
+
+//# sourceMappingURL=getAdminThumbnailURL.js.map

package/dist/getAdminThumbnailURL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/getAdminThumbnailURL.ts"],"sourcesContent":["type ImagekitReference = {\n  imagekit?: {\n    url?: string\n  }\n}\n\nexport const getAdminThumbnailURL = (doc: unknown): string => {\n  const file = doc as { mimeType?: string } & ImagekitReference\n  const baseURL = file.imagekit?.url\n\n  if (!baseURL) {\n    return ''\n  }\n\n  const isVideo = file.mimeType?.startsWith('video')\n  const isPDF = file.mimeType === 'application/pdf' || file.mimeType?.endsWith('/pdf')\n\n  let thumbnailBaseURL = baseURL\n\n  if (isVideo || isPDF) {\n    try {\n      const parsedURL = new URL(baseURL)\n      thumbnailBaseURL = `${parsedURL.origin}${parsedURL.pathname}/ik-thumbnail.jpg`\n    } catch {\n      const normalizedBaseURL = baseURL.split('?')[0].split('#')[0]\n      thumbnailBaseURL = `${normalizedBaseURL}/ik-thumbnail.jpg`\n    }\n  }\n\n  return `${thumbnailBaseURL}${thumbnailBaseURL.includes('?') ? '&' : '?'}tr=w-300,h-300`\n}\n"],"names":["getAdminThumbnailURL","doc","file","baseURL","imagekit","url","isVideo","mimeType","startsWith","isPDF","endsWith","thumbnailBaseURL","parsedURL","URL","origin","pathname","normalizedBaseURL","split","includes"],"mappings":"AAMA,OAAO,MAAMA,uBAAuB,CAACC;IACnC,MAAMC,OAAOD;IACb,MAAME,UAAUD,KAAKE,QAAQ,EAAEC;IAE/B,IAAI,CAACF,SAAS;QACZ,OAAO;IACT;IAEA,MAAMG,UAAUJ,KAAKK,QAAQ,EAAEC,WAAW;IAC1C,MAAMC,QAAQP,KAAKK,QAAQ,KAAK,qBAAqBL,KAAKK,QAAQ,EAAEG,SAAS;IAE7E,IAAIC,mBAAmBR;IAEvB,IAAIG,WAAWG,OAAO;QACpB,IAAI;YACF,MAAMG,YAAY,IAAIC,IAAIV;YAC1BQ,mBAAmB,GAAGC,UAAUE,MAAM,GAAGF,UAAUG,QAAQ,CAAC,iBAAiB,CAAC;QAChF,EAAE,OAAM;YACN,MAAMC,oBAAoBb,QAAQc,KAAK,CAAC,IAAI,CAAC,EAAE,CAACA,KAAK,CAAC,IAAI,CAAC,EAAE;YAC7DN,mBAAmB,GAAGK,kBAAkB,iBAAiB,CAAC;QAC5D;IACF;IAEA,OAAO,GAAGL,mBAAmBA,iBAAiBO,QAAQ,CAAC,OAAO,MAAM,IAAI,cAAc,CAAC;AACzF,EAAC"}

package/dist/imagekitTransforms.d.ts

@@ -0,0 +1,15 @@
+type ImageKitCropMode = 'at_least' | 'at_max' | 'extract' | 'force' | 'maintain_ratio' | 'pad_extract' | 'pad_resize';
+type ImageKitFocalStrategy = 'coordinates' | 'custom';
+export type BuildImageKitTransformOptions = {
+    additionalTransforms?: string[];
+    cropMode?: ImageKitCropMode;
+    extractZoomOut?: number;
+    focalStrategy?: ImageKitFocalStrategy;
+    height?: number;
+    width?: number;
+};
+export declare const getImageKitCustomCoordinates: (doc: unknown) => string | undefined;
+export declare const getImageKitThumbnailTransform: (doc: unknown) => string;
+export declare const buildImageKitTransform: (doc: unknown, options: BuildImageKitTransformOptions) => string;
+export declare const buildImageKitURL: (doc: unknown, options: BuildImageKitTransformOptions) => string;
+export {};

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import type { Config, UploadCollectionSlug } from 'payload';
+type ImageKitCollectionMap = Partial<Record<UploadCollectionSlug, true>>;
+export type PayloadStorageImagekitConfig = {
+    alwaysInsertFields?: boolean;
+    clientUploads?: boolean;
+    collections: ImageKitCollectionMap;
+    disablePayloadAccessControl?: true;
+    enabled?: boolean;
+    folder: string;
+    privateKey: string;
+    publicKey: string;
+    urlEndpoint: string;
+};
+export declare const imagekitStorage: (pluginOptions: PayloadStorageImagekitConfig) => (config: Config) => Config;
+export { migrateFolder } from './migrate.js';
+export type { MigrateFolderOptions, MigrationJobResult } from './migrate.js';
+export declare const payloadStorageImagekit: (pluginOptions: PayloadStorageImagekitConfig) => (config: Config) => Config;