@payloadcms/storage-azure 3.0.0-alpha.62

package/LICENSE.md

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2018-2022 Payload CMS, LLC <info@payloadcms.com>
+Portions Copyright (c) Meta Platforms, Inc. and affiliates.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1 @@
+# Azure Storage

package/dist/generateURL.d.ts

@@ -0,0 +1,8 @@
+import type { GenerateURL } from '@payloadcms/plugin-cloud-storage/types';
+interface Args {
+    baseURL: string;
+    containerName: string;
+}
+export declare const getGenerateURL: ({ baseURL, containerName }: Args) => GenerateURL;
+export {};
+//# sourceMappingURL=generateURL.d.ts.map

package/dist/generateURL.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateURL.d.ts","sourceRoot":"","sources":["../src/generateURL.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAA;AAIzE,UAAU,IAAI;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,eAAO,MAAM,cAAc,+BACI,IAAI,KAAG,WAGnC,CAAA"}

package/dist/generateURL.js

@@ -0,0 +1,6 @@
+import path from 'path';
+export const getGenerateURL = ({ baseURL, containerName })=>({ filename, prefix = '' })=>{
+        return `${baseURL}/${containerName}/${path.posix.join(prefix, filename)}`;
+    };
+
+//# sourceMappingURL=generateURL.js.map

package/dist/generateURL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/generateURL.ts"],"sourcesContent":["import type { GenerateURL } from '@payloadcms/plugin-cloud-storage/types'\n\nimport path from 'path'\n\ninterface Args {\n  baseURL: string\n  containerName: string\n}\n\nexport const getGenerateURL =\n  ({ baseURL, containerName }: Args): GenerateURL =>\n  ({ filename, prefix = '' }) => {\n    return `${baseURL}/${containerName}/${path.posix.join(prefix, filename)}`\n  }\n"],"names":["path","getGenerateURL","baseURL","containerName","filename","prefix","posix","join"],"rangeMappings":";;;","mappings":"AAEA,OAAOA,UAAU,OAAM;AAOvB,OAAO,MAAMC,iBACX,CAAC,EAAEC,OAAO,EAAEC,aAAa,EAAQ,GACjC,CAAC,EAAEC,QAAQ,EAAEC,SAAS,EAAE,EAAE;QACxB,OAAO,CAAC,EAAEH,QAAQ,CAAC,EAAEC,cAAc,CAAC,EAAEH,KAAKM,KAAK,CAACC,IAAI,CAACF,QAAQD,UAAU,CAAC;IAC3E,EAAC"}

package/dist/handleDelete.d.ts

@@ -0,0 +1,10 @@
+import type { ContainerClient } from '@azure/storage-blob';
+import type { HandleDelete } from '@payloadcms/plugin-cloud-storage/types';
+import type { CollectionConfig } from 'payload/types';
+interface Args {
+    collection: CollectionConfig;
+    getStorageClient: () => ContainerClient;
+}
+export declare const getHandleDelete: ({ getStorageClient }: Args) => HandleDelete;
+export {};
+//# sourceMappingURL=handleDelete.d.ts.map

package/dist/handleDelete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleDelete.d.ts","sourceRoot":"","sources":["../src/handleDelete.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAIrD,UAAU,IAAI;IACZ,UAAU,EAAE,gBAAgB,CAAA;IAC5B,gBAAgB,EAAE,MAAM,eAAe,CAAA;CACxC;AAED,eAAO,MAAM,eAAe,yBAA0B,IAAI,KAAG,YAK5D,CAAA"}

package/dist/handleDelete.js

@@ -0,0 +1,9 @@
+import path from 'path';
+export const getHandleDelete = ({ getStorageClient })=>{
+    return async ({ doc: { prefix = '' }, filename })=>{
+        const blockBlobClient = getStorageClient().getBlockBlobClient(path.posix.join(prefix, filename));
+        await blockBlobClient.deleteIfExists();
+    };
+};
+
+//# sourceMappingURL=handleDelete.js.map

package/dist/handleDelete.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/handleDelete.ts"],"sourcesContent":["import type { ContainerClient } from '@azure/storage-blob'\nimport type { HandleDelete } from '@payloadcms/plugin-cloud-storage/types'\nimport type { CollectionConfig } from 'payload/types'\n\nimport path from 'path'\n\ninterface Args {\n  collection: CollectionConfig\n  getStorageClient: () => ContainerClient\n}\n\nexport const getHandleDelete = ({ getStorageClient }: Args): HandleDelete => {\n  return async ({ doc: { prefix = '' }, filename }) => {\n    const blockBlobClient = getStorageClient().getBlockBlobClient(path.posix.join(prefix, filename))\n    await blockBlobClient.deleteIfExists()\n  }\n}\n"],"names":["path","getHandleDelete","getStorageClient","doc","prefix","filename","blockBlobClient","getBlockBlobClient","posix","join","deleteIfExists"],"rangeMappings":";;;;;;","mappings":"AAIA,OAAOA,UAAU,OAAM;AAOvB,OAAO,MAAMC,kBAAkB,CAAC,EAAEC,gBAAgB,EAAQ;IACxD,OAAO,OAAO,EAAEC,KAAK,EAAEC,SAAS,EAAE,EAAE,EAAEC,QAAQ,EAAE;QAC9C,MAAMC,kBAAkBJ,mBAAmBK,kBAAkB,CAACP,KAAKQ,KAAK,CAACC,IAAI,CAACL,QAAQC;QACtF,MAAMC,gBAAgBI,cAAc;IACtC;AACF,EAAC"}

package/dist/handleUpload.d.ts

@@ -0,0 +1,11 @@
+import type { ContainerClient } from '@azure/storage-blob';
+import type { HandleUpload } from '@payloadcms/plugin-cloud-storage/types';
+import type { CollectionConfig } from 'payload/types';
+interface Args {
+    collection: CollectionConfig;
+    getStorageClient: () => ContainerClient;
+    prefix?: string;
+}
+export declare const getHandleUpload: ({ getStorageClient, prefix }: Args) => HandleUpload;
+export {};
+//# sourceMappingURL=handleUpload.d.ts.map

package/dist/handleUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleUpload.d.ts","sourceRoot":"","sources":["../src/handleUpload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAOrD,UAAU,IAAI;IACZ,UAAU,EAAE,gBAAgB,CAAA;IAC5B,gBAAgB,EAAE,MAAM,eAAe,CAAA;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAGD,eAAO,MAAM,eAAe,iCAAuC,IAAI,KAAG,YAyBzE,CAAA"}

package/dist/handleUpload.js

@@ -0,0 +1,28 @@
+import { AbortController } from '@azure/abort-controller';
+import fs from 'fs';
+import path from 'path';
+import { Readable } from 'stream';
+const multipartThreshold = 1024 * 1024 * 50 // 50MB
+;
+export const getHandleUpload = ({ getStorageClient, prefix = '' })=>{
+    return async ({ data, file })=>{
+        const fileKey = path.posix.join(data.prefix || prefix, file.filename);
+        const blockBlobClient = getStorageClient().getBlockBlobClient(fileKey);
+        // when there are no temp files, or the upload is less than the threshold size, do not stream files
+        if (!file.tempFilePath && file.buffer.length > 0 && file.buffer.length < multipartThreshold) {
+            await blockBlobClient.upload(file.buffer, file.buffer.byteLength, {
+                blobHTTPHeaders: {
+                    blobContentType: file.mimeType
+                }
+            });
+            return data;
+        }
+        const fileBufferOrStream = file.tempFilePath ? fs.createReadStream(file.tempFilePath) : Readable.from(file.buffer);
+        await blockBlobClient.uploadStream(fileBufferOrStream, 4 * 1024 * 1024, 4, {
+            abortSignal: AbortController.timeout(30 * 60 * 1000)
+        });
+        return data;
+    };
+};
+
+//# sourceMappingURL=handleUpload.js.map

package/dist/handleUpload.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/handleUpload.ts"],"sourcesContent":["import type { ContainerClient } from '@azure/storage-blob'\nimport type { HandleUpload } from '@payloadcms/plugin-cloud-storage/types'\nimport type { CollectionConfig } from 'payload/types'\n\nimport { AbortController } from '@azure/abort-controller'\nimport fs from 'fs'\nimport path from 'path'\nimport { Readable } from 'stream'\n\ninterface Args {\n  collection: CollectionConfig\n  getStorageClient: () => ContainerClient\n  prefix?: string\n}\n\nconst multipartThreshold = 1024 * 1024 * 50 // 50MB\nexport const getHandleUpload = ({ getStorageClient, prefix = '' }: Args): HandleUpload => {\n  return async ({ data, file }) => {\n    const fileKey = path.posix.join(data.prefix || prefix, file.filename)\n\n    const blockBlobClient = getStorageClient().getBlockBlobClient(fileKey)\n\n    // when there are no temp files, or the upload is less than the threshold size, do not stream files\n    if (!file.tempFilePath && file.buffer.length > 0 && file.buffer.length < multipartThreshold) {\n      await blockBlobClient.upload(file.buffer, file.buffer.byteLength, {\n        blobHTTPHeaders: { blobContentType: file.mimeType },\n      })\n\n      return data\n    }\n\n    const fileBufferOrStream: Readable = file.tempFilePath\n      ? fs.createReadStream(file.tempFilePath)\n      : Readable.from(file.buffer)\n\n    await blockBlobClient.uploadStream(fileBufferOrStream, 4 * 1024 * 1024, 4, {\n      abortSignal: AbortController.timeout(30 * 60 * 1000),\n    })\n\n    return data\n  }\n}\n"],"names":["AbortController","fs","path","Readable","multipartThreshold","getHandleUpload","getStorageClient","prefix","data","file","fileKey","posix","join","filename","blockBlobClient","getBlockBlobClient","tempFilePath","buffer","length","upload","byteLength","blobHTTPHeaders","blobContentType","mimeType","fileBufferOrStream","createReadStream","from","uploadStream","abortSignal","timeout"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAIA,SAASA,eAAe,QAAQ,0BAAyB;AACzD,OAAOC,QAAQ,KAAI;AACnB,OAAOC,UAAU,OAAM;AACvB,SAASC,QAAQ,QAAQ,SAAQ;AAQjC,MAAMC,qBAAqB,OAAO,OAAO,GAAG,OAAO;;AACnD,OAAO,MAAMC,kBAAkB,CAAC,EAAEC,gBAAgB,EAAEC,SAAS,EAAE,EAAQ;IACrE,OAAO,OAAO,EAAEC,IAAI,EAAEC,IAAI,EAAE;QAC1B,MAAMC,UAAUR,KAAKS,KAAK,CAACC,IAAI,CAACJ,KAAKD,MAAM,IAAIA,QAAQE,KAAKI,QAAQ;QAEpE,MAAMC,kBAAkBR,mBAAmBS,kBAAkB,CAACL;QAE9D,mGAAmG;QACnG,IAAI,CAACD,KAAKO,YAAY,IAAIP,KAAKQ,MAAM,CAACC,MAAM,GAAG,KAAKT,KAAKQ,MAAM,CAACC,MAAM,GAAGd,oBAAoB;YAC3F,MAAMU,gBAAgBK,MAAM,CAACV,KAAKQ,MAAM,EAAER,KAAKQ,MAAM,CAACG,UAAU,EAAE;gBAChEC,iBAAiB;oBAAEC,iBAAiBb,KAAKc,QAAQ;gBAAC;YACpD;YAEA,OAAOf;QACT;QAEA,MAAMgB,qBAA+Bf,KAAKO,YAAY,GAClDf,GAAGwB,gBAAgB,CAAChB,KAAKO,YAAY,IACrCb,SAASuB,IAAI,CAACjB,KAAKQ,MAAM;QAE7B,MAAMH,gBAAgBa,YAAY,CAACH,oBAAoB,IAAI,OAAO,MAAM,GAAG;YACzEI,aAAa5B,gBAAgB6B,OAAO,CAAC,KAAK,KAAK;QACjD;QAEA,OAAOrB;IACT;AACF,EAAC"}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import type { CollectionOptions } from '@payloadcms/plugin-cloud-storage/types';
+import type { Plugin } from 'payload/config';
+export type AzureStorageOptions = {
+    allowContainerCreate: boolean;
+    baseURL: string;
+    /**
+     * Collection options to apply the Azure Blob adapter to.
+     */
+    collections: Record<string, Omit<CollectionOptions, 'adapter'> | true>;
+    /**
+     * Azure Blob storage connection string
+     */
+    connectionString: string;
+    /**
+     * Azure Blob storage container name
+     */
+    containerName: string;
+    /**
+     * Whether or not to enable the plugin
+     *
+     * Default: true
+     */
+    enabled?: boolean;
+};
+type AzureStoragePlugin = (azureStorageArgs: AzureStorageOptions) => Plugin;
+export declare const azureStorage: AzureStoragePlugin;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,iBAAiB,EAElB,MAAM,wCAAwC,CAAA;AAC/C,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAUpD,MAAM,MAAM,mBAAmB,GAAG;IAChC,oBAAoB,EAAE,OAAO,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC,CAAA;IAEtE;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAA;IAExB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAA;IAErB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,KAAK,kBAAkB,GAAG,CAAC,gBAAgB,EAAE,mBAAmB,KAAK,MAAM,CAAA;AAE3E,eAAO,MAAM,YAAY,EAAE,kBA0BxB,CAAA"}

package/dist/index.js

@@ -0,0 +1,63 @@
+import { BlobServiceClient } from '@azure/storage-blob';
+import { cloudStorage } from '@payloadcms/plugin-cloud-storage';
+import { getGenerateURL } from './generateURL.js';
+import { getHandleDelete } from './handleDelete.js';
+import { getHandleUpload } from './handleUpload.js';
+import { getHandler } from './staticHandler.js';
+export const azureStorage = (azureStorageOptions)=>(incomingConfig)=>{
+        if (azureStorageOptions.enabled === false) {
+            return incomingConfig;
+        }
+        const adapter = azureStorageInternal(azureStorageOptions);
+        // Add adapter to each collection option object
+        const collectionsWithAdapter = Object.entries(azureStorageOptions.collections).reduce((acc, [slug, collOptions])=>({
+                ...acc,
+                [slug]: {
+                    ...collOptions === true ? {} : collOptions,
+                    adapter
+                }
+            }), {});
+        return cloudStorage({
+            collections: collectionsWithAdapter
+        })(incomingConfig);
+    };
+function azureStorageInternal({ allowContainerCreate, baseURL, connectionString, containerName }) {
+    let storageClient = null;
+    const getStorageClient = ()=>{
+        if (storageClient) return storageClient;
+        const blobServiceClient = BlobServiceClient.fromConnectionString(connectionString);
+        storageClient = blobServiceClient.getContainerClient(containerName);
+        return storageClient;
+    };
+    const createContainerIfNotExists = ()=>{
+        void getStorageClient().createIfNotExists({
+            access: 'blob'
+        });
+    };
+    return ({ collection, prefix })=>{
+        return {
+            generateURL: getGenerateURL({
+                baseURL,
+                containerName
+            }),
+            handleDelete: getHandleDelete({
+                collection,
+                getStorageClient
+            }),
+            handleUpload: getHandleUpload({
+                collection,
+                getStorageClient,
+                prefix
+            }),
+            staticHandler: getHandler({
+                collection,
+                getStorageClient
+            }),
+            ...allowContainerCreate && {
+                onInit: createContainerIfNotExists
+            }
+        };
+    };
+}
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { ContainerClient } from '@azure/storage-blob'\nimport type {\n  Adapter,\n  PluginOptions as CloudStoragePluginOptions,\n  CollectionOptions,\n  GeneratedAdapter,\n} from '@payloadcms/plugin-cloud-storage/types'\nimport type { Config, Plugin } from 'payload/config'\n\nimport { BlobServiceClient } from '@azure/storage-blob'\nimport { cloudStorage } from '@payloadcms/plugin-cloud-storage'\n\nimport { getGenerateURL } from './generateURL.js'\nimport { getHandleDelete } from './handleDelete.js'\nimport { getHandleUpload } from './handleUpload.js'\nimport { getHandler } from './staticHandler.js'\n\nexport type AzureStorageOptions = {\n  allowContainerCreate: boolean\n  baseURL: string\n  /**\n   * Collection options to apply the Azure Blob adapter to.\n   */\n  collections: Record<string, Omit<CollectionOptions, 'adapter'> | true>\n\n  /**\n   * Azure Blob storage connection string\n   */\n  connectionString: string\n\n  /**\n   * Azure Blob storage container name\n   */\n  containerName: string\n\n  /**\n   * Whether or not to enable the plugin\n   *\n   * Default: true\n   */\n  enabled?: boolean\n}\n\ntype AzureStoragePlugin = (azureStorageArgs: AzureStorageOptions) => Plugin\n\nexport const azureStorage: AzureStoragePlugin =\n  (azureStorageOptions: AzureStorageOptions) =>\n  (incomingConfig: Config): Config => {\n    if (azureStorageOptions.enabled === false) {\n      return incomingConfig\n    }\n\n    const adapter = azureStorageInternal(azureStorageOptions)\n\n    // Add adapter to each collection option object\n    const collectionsWithAdapter: CloudStoragePluginOptions['collections'] = Object.entries(\n      azureStorageOptions.collections,\n    ).reduce(\n      (acc, [slug, collOptions]) => ({\n        ...acc,\n        [slug]: {\n          ...(collOptions === true ? {} : collOptions),\n          adapter,\n        },\n      }),\n      {} as Record<string, CollectionOptions>,\n    )\n\n    return cloudStorage({\n      collections: collectionsWithAdapter,\n    })(incomingConfig)\n  }\n\nfunction azureStorageInternal({\n  allowContainerCreate,\n  baseURL,\n  connectionString,\n  containerName,\n}: AzureStorageOptions): Adapter {\n  let storageClient: ContainerClient | null = null\n  const getStorageClient = () => {\n    if (storageClient) return storageClient\n\n    const blobServiceClient = BlobServiceClient.fromConnectionString(connectionString)\n    storageClient = blobServiceClient.getContainerClient(containerName)\n    return storageClient\n  }\n\n  const createContainerIfNotExists = () => {\n    void getStorageClient().createIfNotExists({ access: 'blob' })\n  }\n\n  return ({ collection, prefix }): GeneratedAdapter => {\n    return {\n      generateURL: getGenerateURL({ baseURL, containerName }),\n      handleDelete: getHandleDelete({ collection, getStorageClient }),\n      handleUpload: getHandleUpload({\n        collection,\n        getStorageClient,\n        prefix,\n      }),\n      staticHandler: getHandler({ collection, getStorageClient }),\n      ...(allowContainerCreate && { onInit: createContainerIfNotExists }),\n    }\n  }\n}\n"],"names":["BlobServiceClient","cloudStorage","getGenerateURL","getHandleDelete","getHandleUpload","getHandler","azureStorage","azureStorageOptions","incomingConfig","enabled","adapter","azureStorageInternal","collectionsWithAdapter","Object","entries","collections","reduce","acc","slug","collOptions","allowContainerCreate","baseURL","connectionString","containerName","storageClient","getStorageClient","blobServiceClient","fromConnectionString","getContainerClient","createContainerIfNotExists","createIfNotExists","access","collection","prefix","generateURL","handleDelete","handleUpload","staticHandler","onInit"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AASA,SAASA,iBAAiB,QAAQ,sBAAqB;AACvD,SAASC,YAAY,QAAQ,mCAAkC;AAE/D,SAASC,cAAc,QAAQ,mBAAkB;AACjD,SAASC,eAAe,QAAQ,oBAAmB;AACnD,SAASC,eAAe,QAAQ,oBAAmB;AACnD,SAASC,UAAU,QAAQ,qBAAoB;AA8B/C,OAAO,MAAMC,eACX,CAACC,sBACD,CAACC;QACC,IAAID,oBAAoBE,OAAO,KAAK,OAAO;YACzC,OAAOD;QACT;QAEA,MAAME,UAAUC,qBAAqBJ;QAErC,+CAA+C;QAC/C,MAAMK,yBAAmEC,OAAOC,OAAO,CACrFP,oBAAoBQ,WAAW,EAC/BC,MAAM,CACN,CAACC,KAAK,CAACC,MAAMC,YAAY,GAAM,CAAA;gBAC7B,GAAGF,GAAG;gBACN,CAACC,KAAK,EAAE;oBACN,GAAIC,gBAAgB,OAAO,CAAC,IAAIA,WAAW;oBAC3CT;gBACF;YACF,CAAA,GACA,CAAC;QAGH,OAAOT,aAAa;YAClBc,aAAaH;QACf,GAAGJ;IACL,EAAC;AAEH,SAASG,qBAAqB,EAC5BS,oBAAoB,EACpBC,OAAO,EACPC,gBAAgB,EAChBC,aAAa,EACO;IACpB,IAAIC,gBAAwC;IAC5C,MAAMC,mBAAmB;QACvB,IAAID,eAAe,OAAOA;QAE1B,MAAME,oBAAoB1B,kBAAkB2B,oBAAoB,CAACL;QACjEE,gBAAgBE,kBAAkBE,kBAAkB,CAACL;QACrD,OAAOC;IACT;IAEA,MAAMK,6BAA6B;QACjC,KAAKJ,mBAAmBK,iBAAiB,CAAC;YAAEC,QAAQ;QAAO;IAC7D;IAEA,OAAO,CAAC,EAAEC,UAAU,EAAEC,MAAM,EAAE;QAC5B,OAAO;YACLC,aAAahC,eAAe;gBAAEmB;gBAASE;YAAc;YACrDY,cAAchC,gBAAgB;gBAAE6B;gBAAYP;YAAiB;YAC7DW,cAAchC,gBAAgB;gBAC5B4B;gBACAP;gBACAQ;YACF;YACAI,eAAehC,WAAW;gBAAE2B;gBAAYP;YAAiB;YACzD,GAAIL,wBAAwB;gBAAEkB,QAAQT;YAA2B,CAAC;QACpE;IACF;AACF"}

package/dist/staticHandler.d.ts

@@ -0,0 +1,10 @@
+import type { ContainerClient } from '@azure/storage-blob';
+import type { StaticHandler } from '@payloadcms/plugin-cloud-storage/types';
+import type { CollectionConfig } from 'payload/types';
+interface Args {
+    collection: CollectionConfig;
+    getStorageClient: () => ContainerClient;
+}
+export declare const getHandler: ({ collection, getStorageClient }: Args) => StaticHandler;
+export {};
+//# sourceMappingURL=staticHandler.d.ts.map

package/dist/staticHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staticHandler.d.ts","sourceRoot":"","sources":["../src/staticHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAOrD,UAAU,IAAI;IACZ,UAAU,EAAE,gBAAgB,CAAA;IAC5B,gBAAgB,EAAE,MAAM,eAAe,CAAA;CACxC;AAED,eAAO,MAAM,UAAU,qCAAsC,IAAI,KAAG,aA8CnE,CAAA"}

package/dist/staticHandler.js

@@ -0,0 +1,48 @@
+import { getFilePrefix } from '@payloadcms/plugin-cloud-storage/utilities';
+import path from 'path';
+import { getRangeFromHeader } from './utils/getRangeFromHeader.js';
+export const getHandler = ({ collection, getStorageClient })=>{
+    return async (req, { params: { filename } })=>{
+        try {
+            const prefix = await getFilePrefix({
+                collection,
+                filename,
+                req
+            });
+            const blockBlobClient = getStorageClient().getBlockBlobClient(path.posix.join(prefix, filename));
+            const { end, start } = await getRangeFromHeader(blockBlobClient, String(req.headers.get('range')));
+            const blob = await blockBlobClient.download(start, end);
+            // eslint-disable-next-line no-underscore-dangle
+            const response = blob._response;
+            // Manually create a ReadableStream for the web from a Node.js stream.
+            const readableStream = new ReadableStream({
+                start (controller) {
+                    const nodeStream = blob.readableStreamBody;
+                    if (!nodeStream) {
+                        throw new Error('No readable stream body');
+                    }
+                    nodeStream.on('data', (chunk)=>{
+                        controller.enqueue(new Uint8Array(chunk));
+                    });
+                    nodeStream.on('end', ()=>{
+                        controller.close();
+                    });
+                    nodeStream.on('error', (err)=>{
+                        controller.error(err);
+                    });
+                }
+            });
+            return new Response(readableStream, {
+                headers: response.headers.rawHeaders(),
+                status: response.status
+            });
+        } catch (err) {
+            req.payload.logger.error(err);
+            return new Response('Internal Server Error', {
+                status: 500
+            });
+        }
+    };
+};
+
+//# sourceMappingURL=staticHandler.js.map

package/dist/staticHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/staticHandler.ts"],"sourcesContent":["import type { ContainerClient } from '@azure/storage-blob'\nimport type { StaticHandler } from '@payloadcms/plugin-cloud-storage/types'\nimport type { CollectionConfig } from 'payload/types'\n\nimport { getFilePrefix } from '@payloadcms/plugin-cloud-storage/utilities'\nimport path from 'path'\n\nimport { getRangeFromHeader } from './utils/getRangeFromHeader.js'\n\ninterface Args {\n  collection: CollectionConfig\n  getStorageClient: () => ContainerClient\n}\n\nexport const getHandler = ({ collection, getStorageClient }: Args): StaticHandler => {\n  return async (req, { params: { filename } }) => {\n    try {\n      const prefix = await getFilePrefix({ collection, filename, req })\n      const blockBlobClient = getStorageClient().getBlockBlobClient(\n        path.posix.join(prefix, filename),\n      )\n\n      const { end, start } = await getRangeFromHeader(\n        blockBlobClient,\n        String(req.headers.get('range')),\n      )\n\n      const blob = await blockBlobClient.download(start, end)\n      // eslint-disable-next-line no-underscore-dangle\n      const response = blob._response\n\n      // Manually create a ReadableStream for the web from a Node.js stream.\n      const readableStream = new ReadableStream({\n        start(controller) {\n          const nodeStream = blob.readableStreamBody\n          if (!nodeStream) {\n            throw new Error('No readable stream body')\n          }\n\n          nodeStream.on('data', (chunk) => {\n            controller.enqueue(new Uint8Array(chunk))\n          })\n          nodeStream.on('end', () => {\n            controller.close()\n          })\n          nodeStream.on('error', (err) => {\n            controller.error(err)\n          })\n        },\n      })\n\n      return new Response(readableStream, {\n        headers: response.headers.rawHeaders(),\n        status: response.status,\n      })\n    } catch (err: unknown) {\n      req.payload.logger.error(err)\n      return new Response('Internal Server Error', { status: 500 })\n    }\n  }\n}\n"],"names":["getFilePrefix","path","getRangeFromHeader","getHandler","collection","getStorageClient","req","params","filename","prefix","blockBlobClient","getBlockBlobClient","posix","join","end","start","String","headers","get","blob","download","response","_response","readableStream","ReadableStream","controller","nodeStream","readableStreamBody","Error","on","chunk","enqueue","Uint8Array","close","err","error","Response","rawHeaders","status","payload","logger"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAIA,SAASA,aAAa,QAAQ,6CAA4C;AAC1E,OAAOC,UAAU,OAAM;AAEvB,SAASC,kBAAkB,QAAQ,gCAA+B;AAOlE,OAAO,MAAMC,aAAa,CAAC,EAAEC,UAAU,EAAEC,gBAAgB,EAAQ;IAC/D,OAAO,OAAOC,KAAK,EAAEC,QAAQ,EAAEC,QAAQ,EAAE,EAAE;QACzC,IAAI;YACF,MAAMC,SAAS,MAAMT,cAAc;gBAAEI;gBAAYI;gBAAUF;YAAI;YAC/D,MAAMI,kBAAkBL,mBAAmBM,kBAAkB,CAC3DV,KAAKW,KAAK,CAACC,IAAI,CAACJ,QAAQD;YAG1B,MAAM,EAAEM,GAAG,EAAEC,KAAK,EAAE,GAAG,MAAMb,mBAC3BQ,iBACAM,OAAOV,IAAIW,OAAO,CAACC,GAAG,CAAC;YAGzB,MAAMC,OAAO,MAAMT,gBAAgBU,QAAQ,CAACL,OAAOD;YACnD,gDAAgD;YAChD,MAAMO,WAAWF,KAAKG,SAAS;YAE/B,sEAAsE;YACtE,MAAMC,iBAAiB,IAAIC,eAAe;gBACxCT,OAAMU,UAAU;oBACd,MAAMC,aAAaP,KAAKQ,kBAAkB;oBAC1C,IAAI,CAACD,YAAY;wBACf,MAAM,IAAIE,MAAM;oBAClB;oBAEAF,WAAWG,EAAE,CAAC,QAAQ,CAACC;wBACrBL,WAAWM,OAAO,CAAC,IAAIC,WAAWF;oBACpC;oBACAJ,WAAWG,EAAE,CAAC,OAAO;wBACnBJ,WAAWQ,KAAK;oBAClB;oBACAP,WAAWG,EAAE,CAAC,SAAS,CAACK;wBACtBT,WAAWU,KAAK,CAACD;oBACnB;gBACF;YACF;YAEA,OAAO,IAAIE,SAASb,gBAAgB;gBAClCN,SAASI,SAASJ,OAAO,CAACoB,UAAU;gBACpCC,QAAQjB,SAASiB,MAAM;YACzB;QACF,EAAE,OAAOJ,KAAc;YACrB5B,IAAIiC,OAAO,CAACC,MAAM,CAACL,KAAK,CAACD;YACzB,OAAO,IAAIE,SAAS,yBAAyB;gBAAEE,QAAQ;YAAI;QAC7D;IACF;AACF,EAAC"}

package/dist/utils/getRangeFromHeader.d.ts

@@ -0,0 +1,6 @@
+import type { BlockBlobClient } from '@azure/storage-blob';
+export declare const getRangeFromHeader: (blockBlobClient: BlockBlobClient, rangeHeader?: string) => Promise<{
+    end: number | undefined;
+    start: number;
+}>;
+//# sourceMappingURL=getRangeFromHeader.d.ts.map

package/dist/utils/getRangeFromHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRangeFromHeader.d.ts","sourceRoot":"","sources":["../../src/utils/getRangeFromHeader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAI1D,eAAO,MAAM,kBAAkB,oBACZ,eAAe,gBAClB,MAAM,KACnB,QAAQ;IAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAkBpD,CAAA"}

package/dist/utils/getRangeFromHeader.js

@@ -0,0 +1,21 @@
+import parseRange from 'range-parser';
+export const getRangeFromHeader = async (blockBlobClient, rangeHeader)=>{
+    const fullRange = {
+        end: undefined,
+        start: 0
+    };
+    if (!rangeHeader) {
+        return fullRange;
+    }
+    const size = await blockBlobClient.getProperties().then((props)=>props.contentLength);
+    if (size === undefined) {
+        return fullRange;
+    }
+    const range = parseRange(size, rangeHeader);
+    if (range === -1 || range === -2 || range.type !== 'bytes' || range.length !== 1) {
+        return fullRange;
+    }
+    return range[0];
+};
+
+//# sourceMappingURL=getRangeFromHeader.js.map

package/dist/utils/getRangeFromHeader.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/getRangeFromHeader.ts"],"sourcesContent":["import type { BlockBlobClient } from '@azure/storage-blob'\n\nimport parseRange from 'range-parser'\n\nexport const getRangeFromHeader = async (\n  blockBlobClient: BlockBlobClient,\n  rangeHeader?: string,\n): Promise<{ end: number | undefined; start: number }> => {\n  const fullRange = { end: undefined, start: 0 }\n\n  if (!rangeHeader) {\n    return fullRange\n  }\n\n  const size = await blockBlobClient.getProperties().then((props) => props.contentLength)\n  if (size === undefined) {\n    return fullRange\n  }\n\n  const range = parseRange(size, rangeHeader)\n  if (range === -1 || range === -2 || range.type !== 'bytes' || range.length !== 1) {\n    return fullRange\n  }\n\n  return range[0]\n}\n"],"names":["parseRange","getRangeFromHeader","blockBlobClient","rangeHeader","fullRange","end","undefined","start","size","getProperties","then","props","contentLength","range","type","length"],"rangeMappings":";;;;;;;;;;;;;;;;;;","mappings":"AAEA,OAAOA,gBAAgB,eAAc;AAErC,OAAO,MAAMC,qBAAqB,OAChCC,iBACAC;IAEA,MAAMC,YAAY;QAAEC,KAAKC;QAAWC,OAAO;IAAE;IAE7C,IAAI,CAACJ,aAAa;QAChB,OAAOC;IACT;IAEA,MAAMI,OAAO,MAAMN,gBAAgBO,aAAa,GAAGC,IAAI,CAAC,CAACC,QAAUA,MAAMC,aAAa;IACtF,IAAIJ,SAASF,WAAW;QACtB,OAAOF;IACT;IAEA,MAAMS,QAAQb,WAAWQ,MAAML;IAC/B,IAAIU,UAAU,CAAC,KAAKA,UAAU,CAAC,KAAKA,MAAMC,IAAI,KAAK,WAAWD,MAAME,MAAM,KAAK,GAAG;QAChF,OAAOX;IACT;IAEA,OAAOS,KAAK,CAAC,EAAE;AACjB,EAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@payloadcms/storage-azure",
+  "version": "3.0.0-alpha.62",
+  "description": "Payload storage adapter for Azure Blob Storage",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/payloadcms/payload.git",
+    "directory": "packages/storage-azure"
+  },
+  "license": "MIT",
+  "homepage": "https://payloadcms.com",
+  "author": "Payload CMS, Inc.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@azure/abort-controller": "^1.1.0",
+    "@azure/storage-blob": "^12.11.0",
+    "range-parser": "^1.2.1",
+    "@payloadcms/plugin-cloud-storage": "3.0.0-alpha.62"
+  },
+  "devDependencies": {
+    "@types/range-parser": "^1.2.7",
+    "payload": "3.0.0-alpha.62"
+  },
+  "peerDependencies": {
+    "payload": "3.0.0-alpha.62"
+  },
+  "engines": {
+    "node": ">=18.20.2"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "pnpm build:swc && pnpm build:types",
+    "build:swc": "swc ./src -d ./dist --config-file .swcrc",
+    "build:types": "tsc --emitDeclarationOnly --outDir dist",
+    "build:clean": "find . \\( -type d \\( -name build -o -name dist -o -name .cache \\) -o -type f -name tsconfig.tsbuildinfo \\) -exec rm -rf {} + && pnpm build",
+    "clean": "rimraf {dist,*.tsbuildinfo}"
+  }
+}

package/src/index.ts

@@ -0,0 +1,106 @@
+import type { ContainerClient } from '@azure/storage-blob'
+import type {
+  Adapter,
+  PluginOptions as CloudStoragePluginOptions,
+  CollectionOptions,
+  GeneratedAdapter,
+} from '@payloadcms/plugin-cloud-storage/types'
+import type { Config, Plugin } from 'payload/config'
+
+import { BlobServiceClient } from '@azure/storage-blob'
+import { cloudStorage } from '@payloadcms/plugin-cloud-storage'
+
+import { getGenerateURL } from './generateURL.js'
+import { getHandleDelete } from './handleDelete.js'
+import { getHandleUpload } from './handleUpload.js'
+import { getHandler } from './staticHandler.js'
+
+export type AzureStorageOptions = {
+  allowContainerCreate: boolean
+  baseURL: string
+  /**
+   * Collection options to apply the Azure Blob adapter to.
+   */
+  collections: Record<string, Omit<CollectionOptions, 'adapter'> | true>
+
+  /**
+   * Azure Blob storage connection string
+   */
+  connectionString: string
+
+  /**
+   * Azure Blob storage container name
+   */
+  containerName: string
+
+  /**
+   * Whether or not to enable the plugin
+   *
+   * Default: true
+   */
+  enabled?: boolean
+}
+
+type AzureStoragePlugin = (azureStorageArgs: AzureStorageOptions) => Plugin
+
+export const azureStorage: AzureStoragePlugin =
+  (azureStorageOptions: AzureStorageOptions) =>
+  (incomingConfig: Config): Config => {
+    if (azureStorageOptions.enabled === false) {
+      return incomingConfig
+    }
+
+    const adapter = azureStorageInternal(azureStorageOptions)
+
+    // Add adapter to each collection option object
+    const collectionsWithAdapter: CloudStoragePluginOptions['collections'] = Object.entries(
+      azureStorageOptions.collections,
+    ).reduce(
+      (acc, [slug, collOptions]) => ({
+        ...acc,
+        [slug]: {
+          ...(collOptions === true ? {} : collOptions),
+          adapter,
+        },
+      }),
+      {} as Record<string, CollectionOptions>,
+    )
+
+    return cloudStorage({
+      collections: collectionsWithAdapter,
+    })(incomingConfig)
+  }
+
+function azureStorageInternal({
+  allowContainerCreate,
+  baseURL,
+  connectionString,
+  containerName,
+}: AzureStorageOptions): Adapter {
+  let storageClient: ContainerClient | null = null
+  const getStorageClient = () => {
+    if (storageClient) return storageClient
+
+    const blobServiceClient = BlobServiceClient.fromConnectionString(connectionString)
+    storageClient = blobServiceClient.getContainerClient(containerName)
+    return storageClient
+  }
+
+  const createContainerIfNotExists = () => {
+    void getStorageClient().createIfNotExists({ access: 'blob' })
+  }
+
+  return ({ collection, prefix }): GeneratedAdapter => {
+    return {
+      generateURL: getGenerateURL({ baseURL, containerName }),
+      handleDelete: getHandleDelete({ collection, getStorageClient }),
+      handleUpload: getHandleUpload({
+        collection,
+        getStorageClient,
+        prefix,
+      }),
+      staticHandler: getHandler({ collection, getStorageClient }),
+      ...(allowContainerCreate && { onInit: createContainerIfNotExists }),
+    }
+  }
+}