medusa-plugin-cloudflare-images 0.1.0

package/.medusa/server/src/providers/cloudflare-images/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("@medusajs/types").ModuleProviderExports;
+export default _default;

package/.medusa/server/src/providers/cloudflare-images/index.js

@@ -0,0 +1,11 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("@medusajs/framework/utils");
+const service_1 = __importDefault(require("./service"));
+exports.default = (0, utils_1.ModuleProvider)(utils_1.Modules.FILE, {
+    services: [service_1.default],
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvcHJvdmlkZXJzL2Nsb3VkZmxhcmUtaW1hZ2VzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7O0FBQUEscURBQW1FO0FBRW5FLHdEQUEyRDtBQUUzRCxrQkFBZSxJQUFBLHNCQUFjLEVBQUMsZUFBTyxDQUFDLElBQUksRUFBRTtJQUMxQyxRQUFRLEVBQUUsQ0FBQyxpQkFBbUMsQ0FBQztDQUNoRCxDQUFDLENBQUEifQ==

package/.medusa/server/src/providers/cloudflare-images/service.d.ts

@@ -0,0 +1,79 @@
+import type { FileTypes, Logger } from "@medusajs/framework/types";
+import { AbstractFileProviderService } from "@medusajs/framework/utils";
+import { PassThrough, Readable } from "node:stream";
+type InjectedDependencies = {
+    logger: Logger;
+};
+type CloudflareImagesBaseOptions = {
+    account_id: string;
+    api_token: string;
+    variant?: string;
+    prefix?: string;
+};
+type CloudflareImagesDeliveryOptions = {
+    account_hash: string;
+    delivery_url?: string;
+} | {
+    account_hash?: string;
+    delivery_url: string;
+};
+type CloudflareImagesFileProviderOptions = CloudflareImagesBaseOptions & CloudflareImagesDeliveryOptions;
+type PartialCloudflareImagesFileProviderOptions = Partial<CloudflareImagesBaseOptions & {
+    account_hash: string;
+    delivery_url: string;
+}>;
+type NormalizedCloudflareImagesFileProviderOptions = {
+    account_id: string;
+    api_token: string;
+    account_hash?: string;
+    delivery_url?: string;
+    variant: string;
+    prefix: string;
+};
+type CloudflareImagesError = {
+    code?: number;
+    message?: string;
+};
+type CloudflareImageResult = {
+    id: string;
+    filename?: string;
+    variants?: string[];
+};
+type UploadBufferInput = {
+    content: Buffer;
+    filename: string;
+    mimeType: string;
+    fileKey?: string;
+};
+declare class CloudflareImagesFileProviderService extends AbstractFileProviderService {
+    static identifier: string;
+    protected readonly logger_: Logger;
+    protected readonly options_: NormalizedCloudflareImagesFileProviderOptions;
+    constructor({ logger }: InjectedDependencies, options: CloudflareImagesFileProviderOptions);
+    static validateOptions(options: PartialCloudflareImagesFileProviderOptions): void;
+    upload(file: FileTypes.ProviderUploadFileDTO): Promise<FileTypes.ProviderFileResultDTO>;
+    getUploadStream(fileData: FileTypes.ProviderUploadStreamDTO): Promise<{
+        writeStream: PassThrough;
+        promise: Promise<FileTypes.ProviderFileResultDTO>;
+        url: string;
+        fileKey: string;
+    }>;
+    delete(files: FileTypes.ProviderDeleteFileDTO | FileTypes.ProviderDeleteFileDTO[]): Promise<void>;
+    getPresignedDownloadUrl(fileData: FileTypes.ProviderGetFileDTO): Promise<string>;
+    getPresignedUploadUrl(fileData: FileTypes.ProviderGetPresignedUploadUrlDTO): Promise<FileTypes.ProviderFileResultDTO>;
+    getDownloadStream(fileData: FileTypes.ProviderGetFileDTO): Promise<Readable>;
+    getAsBuffer(fileData: FileTypes.ProviderGetFileDTO): Promise<Buffer>;
+    protected uploadBuffer(input: UploadBufferInput): Promise<CloudflareImageResult>;
+    protected parseCloudflareResponse<T>(response: Response, action: string): Promise<T>;
+    protected streamToBuffer(stream: Readable): Promise<Buffer>;
+    protected createCustomFileKey(): string | undefined;
+    protected getDeliveryUrl(fileKey: string): string;
+    protected getExpiry(expiresIn: number): string;
+    protected normalizePrefix(prefix?: string): string;
+    protected formatCloudflareErrors(errors?: CloudflareImagesError[]): string;
+    protected imagesEndpoint(): string;
+    protected directUploadEndpoint(): string;
+    protected imageEndpoint(fileKey: string): string;
+    protected authHeaders(): HeadersInit;
+}
+export default CloudflareImagesFileProviderService;

package/.medusa/server/src/providers/cloudflare-images/service.js

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("@medusajs/framework/utils");
+const node_crypto_1 = require("node:crypto");
+const node_stream_1 = require("node:stream");
+class CloudflareImagesFileProviderService extends utils_1.AbstractFileProviderService {
+    constructor({ logger }, options) {
+        super();
+        this.logger_ = logger;
+        this.options_ = {
+            account_id: options.account_id,
+            api_token: options.api_token,
+            account_hash: options.account_hash,
+            delivery_url: options.delivery_url?.replace(/\/$/, ""),
+            variant: options.variant || "public",
+            prefix: this.normalizePrefix(options.prefix),
+        };
+    }
+    static validateOptions(options) {
+        if (!options.account_id) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "Cloudflare Images provider requires account_id");
+        }
+        if (!options.api_token) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "Cloudflare Images provider requires api_token");
+        }
+        if (!options.account_hash && !options.delivery_url) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "Cloudflare Images provider requires account_hash or delivery_url");
+        }
+    }
+    async upload(file) {
+        if (!file?.filename) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "No filename provided");
+        }
+        if (!file.content) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "No file content provided");
+        }
+        const content = Buffer.from(file.content, "base64");
+        const result = await this.uploadBuffer({
+            content,
+            filename: file.filename,
+            mimeType: file.mimeType,
+            fileKey: this.createCustomFileKey(),
+        });
+        return {
+            key: result.id,
+            url: this.getDeliveryUrl(result.id),
+        };
+    }
+    async getUploadStream(fileData) {
+        if (!fileData?.filename) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "No filename provided");
+        }
+        const fileKey = this.createCustomFileKey();
+        if (!fileKey) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.NOT_ALLOWED, "Cloudflare Images upload streams require the prefix option so the file key can be known before upload");
+        }
+        const writeStream = new node_stream_1.PassThrough();
+        const url = this.getDeliveryUrl(fileKey);
+        const promise = this.streamToBuffer(writeStream)
+            .then((content) => this.uploadBuffer({
+            content,
+            filename: fileData.filename,
+            mimeType: fileData.mimeType,
+            fileKey,
+        }))
+            .then((result) => ({
+            key: result.id,
+            url: this.getDeliveryUrl(result.id),
+        }));
+        return {
+            writeStream,
+            promise,
+            url,
+            fileKey,
+        };
+    }
+    async delete(files) {
+        const fileArray = Array.isArray(files) ? files : [files];
+        await Promise.all(fileArray.map(async (file) => {
+            if (!file?.fileKey) {
+                return;
+            }
+            const response = await fetch(this.imageEndpoint(file.fileKey), {
+                method: "DELETE",
+                headers: this.authHeaders(),
+            });
+            if (response.status === 404) {
+                this.logger_.warn(`Cloudflare image ${file.fileKey} was already deleted`);
+                return;
+            }
+            await this.parseCloudflareResponse(response, `delete Cloudflare image ${file.fileKey}`);
+        }));
+    }
+    async getPresignedDownloadUrl(fileData) {
+        if (!fileData?.fileKey) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "No fileKey provided");
+        }
+        return this.getDeliveryUrl(fileData.fileKey);
+    }
+    async getPresignedUploadUrl(fileData) {
+        if (!fileData?.filename) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "No filename provided");
+        }
+        const fileKey = this.createCustomFileKey();
+        const formData = new FormData();
+        formData.append("requireSignedURLs", "false");
+        if (fileKey) {
+            formData.append("id", fileKey);
+        }
+        if (fileData.expiresIn) {
+            formData.append("expiry", this.getExpiry(fileData.expiresIn));
+        }
+        const response = await fetch(this.directUploadEndpoint(), {
+            method: "POST",
+            headers: this.authHeaders(),
+            body: formData,
+        });
+        const result = await this.parseCloudflareResponse(response, "create Cloudflare direct upload URL");
+        return {
+            key: result.id,
+            url: result.uploadURL,
+        };
+    }
+    async getDownloadStream(fileData) {
+        const buffer = await this.getAsBuffer(fileData);
+        return node_stream_1.Readable.from(buffer);
+    }
+    async getAsBuffer(fileData) {
+        if (!fileData?.fileKey) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "No fileKey provided");
+        }
+        const response = await fetch(this.getDeliveryUrl(fileData.fileKey));
+        if (!response.ok) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.UNEXPECTED_STATE, `Failed to fetch Cloudflare image ${fileData.fileKey}: ${response.status} ${response.statusText}`);
+        }
+        return Buffer.from(await response.arrayBuffer());
+    }
+    async uploadBuffer(input) {
+        const formData = new FormData();
+        const blob = new Blob([new Uint8Array(input.content)], { type: input.mimeType });
+        formData.append("file", blob, input.filename);
+        formData.append("requireSignedURLs", "false");
+        if (input.fileKey) {
+            formData.append("id", input.fileKey);
+        }
+        formData.append("metadata", JSON.stringify({
+            original_filename: input.filename,
+            source: "medusa",
+        }));
+        const response = await fetch(this.imagesEndpoint(), {
+            method: "POST",
+            headers: this.authHeaders(),
+            body: formData,
+        });
+        return await this.parseCloudflareResponse(response, "upload Cloudflare image");
+    }
+    async parseCloudflareResponse(response, action) {
+        const body = await response.text();
+        let payload;
+        try {
+            payload = body ? JSON.parse(body) : undefined;
+        }
+        catch {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.UNEXPECTED_STATE, `Cloudflare Images failed to ${action}: invalid JSON response (${response.status})`);
+        }
+        if (!response.ok || !payload?.success) {
+            const details = this.formatCloudflareErrors(payload?.errors) || body;
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.UNEXPECTED_STATE, `Cloudflare Images failed to ${action}: ${response.status} ${details}`);
+        }
+        return payload.result;
+    }
+    async streamToBuffer(stream) {
+        const chunks = [];
+        for await (const chunk of stream) {
+            chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        }
+        return Buffer.concat(chunks);
+    }
+    createCustomFileKey() {
+        if (!this.options_.prefix) {
+            return undefined;
+        }
+        return `${this.options_.prefix}${(0, node_crypto_1.randomUUID)()}`;
+    }
+    getDeliveryUrl(fileKey) {
+        const encodedKey = fileKey.split("/").map(encodeURIComponent).join("/");
+        const baseUrl = this.options_.delivery_url ||
+            `https://imagedelivery.net/${this.options_.account_hash}`;
+        return `${baseUrl}/${encodedKey}/${this.options_.variant}`;
+    }
+    getExpiry(expiresIn) {
+        const minSeconds = 2 * 60;
+        const maxSeconds = 6 * 60 * 60;
+        const seconds = Math.min(Math.max(expiresIn, minSeconds), maxSeconds);
+        return new Date(Date.now() + seconds * 1000).toISOString();
+    }
+    normalizePrefix(prefix) {
+        if (!prefix) {
+            return "";
+        }
+        return prefix.endsWith("/") ? prefix : `${prefix}/`;
+    }
+    formatCloudflareErrors(errors) {
+        if (!errors?.length) {
+            return "";
+        }
+        return errors
+            .map((error) => [error.code, error.message].filter((part) => part !== undefined).join(": "))
+            .join("; ");
+    }
+    imagesEndpoint() {
+        return `https://api.cloudflare.com/client/v4/accounts/${this.options_.account_id}/images/v1`;
+    }
+    directUploadEndpoint() {
+        return `https://api.cloudflare.com/client/v4/accounts/${this.options_.account_id}/images/v2/direct_upload`;
+    }
+    imageEndpoint(fileKey) {
+        return `${this.imagesEndpoint()}/${encodeURIComponent(fileKey)}`;
+    }
+    authHeaders() {
+        return {
+            Authorization: `Bearer ${this.options_.api_token}`,
+        };
+    }
+}
+CloudflareImagesFileProviderService.identifier = "cloudflare-images";
+exports.default = CloudflareImagesFileProviderService;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VydmljZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3NyYy9wcm92aWRlcnMvY2xvdWRmbGFyZS1pbWFnZXMvc2VydmljZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUNBLHFEQUFvRjtBQUNwRiw2Q0FBd0M7QUFDeEMsNkNBQW1EO0FBd0VuRCxNQUFNLG1DQUFvQyxTQUFRLG1DQUEyQjtJQU0zRSxZQUFZLEVBQUUsTUFBTSxFQUF3QixFQUFFLE9BQTRDO1FBQ3hGLEtBQUssRUFBRSxDQUFBO1FBRVAsSUFBSSxDQUFDLE9BQU8sR0FBRyxNQUFNLENBQUE7UUFDckIsSUFBSSxDQUFDLFFBQVEsR0FBRztZQUNkLFVBQVUsRUFBRSxPQUFPLENBQUMsVUFBVTtZQUM5QixTQUFTLEVBQUUsT0FBTyxDQUFDLFNBQVM7WUFDNUIsWUFBWSxFQUFFLE9BQU8sQ0FBQyxZQUFZO1lBQ2xDLFlBQVksRUFBRSxPQUFPLENBQUMsWUFBWSxFQUFFLE9BQU8sQ0FBQyxLQUFLLEVBQUUsRUFBRSxDQUFDO1lBQ3RELE9BQU8sRUFBRSxPQUFPLENBQUMsT0FBTyxJQUFJLFFBQVE7WUFDcEMsTUFBTSxFQUFFLElBQUksQ0FBQyxlQUFlLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQztTQUM3QyxDQUFBO0lBQ0gsQ0FBQztJQUVELE1BQU0sQ0FBQyxlQUFlLENBQUMsT0FBbUQ7UUFDeEUsSUFBSSxDQUFDLE9BQU8sQ0FBQyxVQUFVLEVBQUUsQ0FBQztZQUN4QixNQUFNLElBQUksbUJBQVcsQ0FDbkIsbUJBQVcsQ0FBQyxLQUFLLENBQUMsWUFBWSxFQUM5QixnREFBZ0QsQ0FDakQsQ0FBQTtRQUNILENBQUM7UUFFRCxJQUFJLENBQUMsT0FBTyxDQUFDLFNBQVMsRUFBRSxDQUFDO1lBQ3ZCLE1BQU0sSUFBSSxtQkFBVyxDQUNuQixtQkFBVyxDQUFDLEtBQUssQ0FBQyxZQUFZLEVBQzlCLCtDQUErQyxDQUNoRCxDQUFBO1FBQ0gsQ0FBQztR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

package/README.md

@@ -0,0 +1,85 @@
+# Medusa Cloudflare Images File Provider
+
+Cloudflare Images File Module Provider for Medusa v2.
+
+This provider stores Medusa uploads in Cloudflare Images and returns delivery
+URLs that can be used by product media and custom file workflows.
+
+## Installation
+
+```bash
+pnpm add medusa-plugin-cloudflare-images
+```
+
+Use the equivalent install command for npm, yarn, or bun if needed.
+
+## Configuration
+
+Register the provider in `medusa-config.ts`:
+
+```ts
+import { defineConfig, loadEnv } from "@medusajs/framework/utils"
+
+loadEnv(process.env.NODE_ENV || "development", process.cwd())
+
+module.exports = defineConfig({
+  modules: [
+    {
+      resolve: "@medusajs/medusa/file",
+      options: {
+        providers: [
+          {
+            resolve: "medusa-plugin-cloudflare-images/providers/cloudflare-images",
+            id: "cloudflare-images",
+            options: {
+              account_id: process.env.CLOUDFLARE_IMAGES_ACCOUNT_ID,
+              api_token: process.env.CLOUDFLARE_IMAGES_API_TOKEN,
+              account_hash: process.env.CLOUDFLARE_IMAGES_ACCOUNT_HASH,
+              delivery_url: process.env.CLOUDFLARE_IMAGES_DELIVERY_URL,
+              variant: process.env.CLOUDFLARE_IMAGES_VARIANT || "public",
+              prefix: process.env.CLOUDFLARE_IMAGES_PREFIX,
+            },
+          },
+        ],
+      },
+    },
+  ],
+})
+```
+
+The Medusa File Module accepts one provider. Register this provider instead of
+the local or S3 file provider.
+
+## Options
+
+Required:
+
+```env
+CLOUDFLARE_IMAGES_ACCOUNT_ID=
+CLOUDFLARE_IMAGES_API_TOKEN=
+```
+
+Delivery configuration, at least one is required:
+
+```env
+CLOUDFLARE_IMAGES_ACCOUNT_HASH=
+CLOUDFLARE_IMAGES_DELIVERY_URL=
+```
+
+Optional:
+
+```env
+CLOUDFLARE_IMAGES_VARIANT=public
+CLOUDFLARE_IMAGES_PREFIX=products
+```
+
+Set `CLOUDFLARE_IMAGES_DELIVERY_URL` when serving through a custom delivery base
+URL. Otherwise the provider builds URLs as:
+
+```txt
+https://imagedelivery.net/<account_hash>/<image_id>/<variant>
+```
+
+`prefix` is optional for regular uploads and direct uploads. It is required for
+stream uploads because Medusa expects the provider to return the final file key
+and URL before the upload stream has completed.

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "medusa-plugin-cloudflare-images",
+  "version": "0.1.0",
+  "description": "Cloudflare Images File Module Provider for Medusa v2.",
+  "license": "MIT",
+  "keywords": [
+    "medusa-plugin-integration",
+    "medusa-v2",
+    "medusa-plugin-other",
+    "medusa",
+    "medusa-plugin",
+    "cloudflare",
+    "cloudflare-images",
+    "file-provider",
+    "image-storage"
+  ],
+  "homepage": "https://github.com/AlekseyMonakhov/medusa-plugin-cloudflare-images#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AlekseyMonakhov/medusa-plugin-cloudflare-images.git"
+  },
+  "bugs": {
+    "url": "https://github.com/AlekseyMonakhov/medusa-plugin-cloudflare-images/issues"
+  },
+  "files": [
+    ".medusa/server/src/providers",
+    "README.md"
+  ],
+  "main": "./.medusa/server/src/providers/cloudflare-images/index.js",
+  "types": "./.medusa/server/src/providers/cloudflare-images/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    "./providers/*": {
+      "types": "./.medusa/server/src/providers/*/index.d.ts",
+      "default": "./.medusa/server/src/providers/*/index.js"
+    },
+    ".": {
+      "types": "./.medusa/server/src/providers/cloudflare-images/index.d.ts",
+      "default": "./.medusa/server/src/providers/cloudflare-images/index.js"
+    }
+  },
+  "scripts": {
+    "build": "medusa plugin:build",
+    "dev": "medusa plugin:develop",
+    "prepublishOnly": "medusa plugin:build"
+  },
+  "peerDependencies": {
+    "@medusajs/framework": ">=2.8.0 <3.0.0",
+    "@medusajs/medusa": ">=2.8.0 <3.0.0"
+  },
+  "devDependencies": {
+    "@medusajs/admin-shared": "2.15.5",
+    "@medusajs/cli": "2.15.5",
+    "@medusajs/framework": "2.15.5",
+    "@medusajs/medusa": "2.15.5",
+    "@swc/core": "^1.7.28",
+    "@types/node": "^20.12.11",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.6.2"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "pnpm@10.33.0+sha512.10568bb4a6afb58c9eb3630da90cc9516417abebd3fabbe6739f0ae795728da1491e9db5a544c76ad8eb7570f5c4bb3d6c637b2cb41bfdcdb47fa823c8649319"
+}