@payloadcms/figma 0.0.1-alpha.7 → 0.0.1-alpha.71

package/dist/storage-content-api/client-uploads/generateSignedURL.js

@@ -0,0 +1,39 @@
+import { APIError, Forbidden } from 'payload';
+import { getSafeFilename } from '../utilities/index.js';
+const defaultAccess = ({ req })=>!!req.user;
+export const getGenerateSignedURLHandler = ({ access = defaultAccess, client })=>{
+    return async (req)=>{
+        if (!req.json) {
+            throw new APIError('Content-Type expected to be application/json', 400);
+        }
+        const { collectionSlug, filename, mimeType } = await req.json();
+        if (!await access({
+            collectionSlug,
+            req
+        })) {
+            throw new Forbidden();
+        }
+        const safeFilename = await getSafeFilename({
+            collectionSlug,
+            desiredFilename: filename,
+            req
+        });
+        const { data, error } = await client.POST('/api/v0/uploads/sign', {
+            body: {
+                collectionId: collectionSlug,
+                contentType: mimeType,
+                expiresIn: 3600,
+                filename: safeFilename
+            }
+        });
+        if (error || !data) {
+            throw new APIError(`Failed to get presigned upload URL: ${JSON.stringify(error)}`);
+        }
+        return Response.json({
+            filename: safeFilename,
+            url: data.url
+        });
+    };
+};
+
+//# sourceMappingURL=generateSignedURL.js.map

package/dist/storage-content-api/client.d.ts

@@ -0,0 +1,6 @@
+import createClient from 'openapi-fetch';
+import type { UploadPaths } from './api-types.js';
+import type { StorageClientConfig } from './types.js';
+export type StorageClient = ReturnType<typeof createClient<UploadPaths>>;
+export declare function createStorageClient(config: StorageClientConfig): StorageClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/storage-content-api/client.js

@@ -0,0 +1,39 @@
+import createClient from 'openapi-fetch';
+import { getValidProjectToken } from '../auth/project-token.js';
+import { fetchDevJwt } from '../db-content-api/utilities/auth.js';
+export function createStorageClient(config) {
+    const client = createClient({
+        baseUrl: config.baseUrl
+    });
+    client.use(createStorageAuthMiddleware(config));
+    return client;
+}
+function createStorageAuthMiddleware(config) {
+    return {
+        async onRequest ({ request }) {
+            if ('contentApiKey' in config) {
+                request.headers.set('X-Api-Key', config.contentApiKey);
+            } else {
+                const { auth, contentSystemId } = config;
+                if (auth.mode === 'apiKey') {
+                    request.headers.set('X-Api-Key', auth.apiKey);
+                } else if (auth.mode === 'tokenStore') {
+                    const token = await getValidProjectToken({
+                        tenantId: contentSystemId,
+                        tokenStore: auth.tokenStore
+                    });
+                    if (!token) {
+                        throw new Error('Authentication required. Run `npx @payloadcms/figma login` to authenticate.');
+                    }
+                    request.headers.set('Authorization', `Bearer ${token}`);
+                } else {
+                    const token = await fetchDevJwt(config.baseUrl, contentSystemId);
+                    request.headers.set('Authorization', `Bearer ${token}`);
+                }
+            }
+            return request;
+        }
+    };
+}
+
+//# sourceMappingURL=client.js.map

package/dist/storage-content-api/generateURL.d.ts

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

package/dist/storage-content-api/generateURL.js

@@ -0,0 +1,8 @@
+import path from 'path';
+export const getGenerateURL = ({ baseUrl })=>({ collection, filename, prefix = '' })=>{
+        const collectionId = collection.slug;
+        const fileKey = path.posix.join(prefix, filename);
+        return `${baseUrl}/api/v0/uploads/download/${collectionId}/${encodeURIComponent(fileKey)}`;
+    };
+
+//# sourceMappingURL=generateURL.js.map

package/dist/storage-content-api/handleDelete.d.ts

@@ -0,0 +1,8 @@
+import type { HandleDelete } from '@payloadcms/plugin-cloud-storage/types';
+import type { StorageClient } from './client.js';
+type Args = {
+    client: StorageClient;
+};
+export declare const getHandleDelete: ({ client }: Args) => HandleDelete;
+export {};
+//# sourceMappingURL=handleDelete.d.ts.map

package/dist/storage-content-api/handleDelete.js

@@ -0,0 +1,17 @@
+import path from 'path';
+export const getHandleDelete = ({ client })=>{
+    return async ({ collection, doc: { prefix = '' }, filename })=>{
+        const collectionId = collection.slug;
+        const fileKey = path.posix.join(prefix, filename);
+        await client.DELETE('/api/v0/uploads/{collectionId}/{filename}', {
+            params: {
+                path: {
+                    collectionId,
+                    filename: fileKey
+                }
+            }
+        });
+    };
+};
+
+//# sourceMappingURL=handleDelete.js.map

package/dist/storage-content-api/handleUpload.d.ts

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

package/dist/storage-content-api/handleUpload.js

@@ -0,0 +1,144 @@
+import fs from 'fs';
+import path from 'path';
+import { parseClientUploadContext } from './utilities/index.js';
+const PART_SIZE = 64 * 1024 * 1024 // 64MB per part
+;
+const MAX_FILE_SIZE_BEFORE_MULTIPART = 100 * 1024 * 1024 // 100MB
+;
+export const getHandleUpload = ({ client, collection, prefix = '' })=>{
+    return async ({ clientUploadContext, data, file })=>{
+        // Skip if the client already uploaded THIS SPECIFIC file. Resized versions
+        // (different filename) should still be uploaded.
+        const context = parseClientUploadContext(clientUploadContext);
+        const isOriginalClientUploaded = context.clientUploaded === true && file.filename === context.filename;
+        if (isOriginalClientUploaded) {
+            return data;
+        }
+        const collectionId = collection.slug;
+        const fileKey = path.posix.join(data.prefix || prefix, file.filename);
+        const fileData = file.tempFilePath ? fs.readFileSync(file.tempFilePath) : file.buffer;
+        const fileSize = file.filesize || fileData.length;
+        if (fileSize > MAX_FILE_SIZE_BEFORE_MULTIPART) {
+            await uploadMultipart({
+                client,
+                collectionId,
+                fileData,
+                fileKey,
+                mimeType: file.mimeType
+            });
+        } else {
+            await uploadSingleFile({
+                client,
+                collectionId,
+                fileData,
+                fileKey,
+                mimeType: file.mimeType
+            });
+        }
+        return data;
+    };
+};
+async function uploadSingleFile({ client, collectionId, fileData, fileKey, mimeType }) {
+    const { data, error } = await client.POST('/api/v0/uploads/sign', {
+        body: {
+            collectionId,
+            contentType: mimeType,
+            expiresIn: 3600,
+            filename: fileKey
+        }
+    });
+    if (error || !data) {
+        throw new Error(`Failed to get presigned upload URL: ${JSON.stringify(error)}`);
+    }
+    const uploadResponse = await fetch(data.url, {
+        body: fileData,
+        headers: {
+            'Content-Type': mimeType
+        },
+        method: 'PUT'
+    });
+    if (!uploadResponse.ok) {
+        throw new Error(`Failed to upload to S3: ${uploadResponse.status} ${uploadResponse.statusText}`);
+    }
+}
+async function uploadMultipart({ client, collectionId, fileData, fileKey, mimeType }) {
+    const { data: initiateData, error: initiateError } = await client.POST('/api/v0/uploads/multipart/initiate', {
+        body: {
+            collectionId,
+            contentType: mimeType,
+            filename: fileKey
+        }
+    });
+    if (initiateError || !initiateData) {
+        throw new Error(`Failed to initiate multipart upload: ${JSON.stringify(initiateError)}`);
+    }
+    const { uploadId } = initiateData;
+    try {
+        const numParts = Math.ceil(fileData.length / PART_SIZE);
+        const partNumbers = Array.from({
+            length: numParts
+        }, (_, i)=>i + 1);
+        const { data: partsData, error: partsError } = await client.POST('/api/v0/uploads/multipart/parts', {
+            body: {
+                collectionId,
+                expiresIn: 3600,
+                filename: fileKey,
+                partNumbers,
+                uploadId
+            }
+        });
+        if (partsError || !partsData) {
+            throw new Error(`Failed to get part URLs: ${JSON.stringify(partsError)}`);
+        }
+        const { parts } = partsData;
+        if (!parts || !Array.isArray(parts)) {
+            throw new Error('Invalid response from part URLs endpoint: parts is not an array');
+        }
+        const uploadedParts = await Promise.all(parts.map(async ({ partNumber, url })=>{
+            const start = (partNumber - 1) * PART_SIZE;
+            const end = Math.min(start + PART_SIZE, fileData.length);
+            const partData = fileData.slice(start, end);
+            const uploadResponse = await fetch(url, {
+                body: partData,
+                headers: {
+                    'Content-Type': mimeType
+                },
+                method: 'PUT'
+            });
+            const etag = uploadResponse.headers.get('ETag');
+            if (!etag) {
+                throw new Error(`No ETag returned for part ${partNumber}`);
+            }
+            return {
+                ETag: etag,
+                PartNumber: partNumber
+            };
+        }));
+        const { error: completeError } = await client.POST('/api/v0/uploads/multipart/complete', {
+            body: {
+                collectionId,
+                filename: fileKey,
+                parts: uploadedParts,
+                uploadId
+            }
+        });
+        if (completeError) {
+            throw new Error(`Failed to complete multipart upload: ${JSON.stringify(completeError)}`);
+        }
+    } catch (error) {
+        try {
+            await client.POST('/api/v0/uploads/multipart/abort', {
+                body: {
+                    collectionId,
+                    filename: fileKey,
+                    uploadId
+                }
+            });
+        } catch  {
+        // Ignore abort errors
+        }
+        throw error;
+    }
+}
+
+//# sourceMappingURL=handleUpload.js.map

package/dist/storage-content-api/index.d.ts

@@ -0,0 +1,5 @@
+import type { Adapter } from '@payloadcms/plugin-cloud-storage/types';
+import type { StorageClientConfig } from './types.js';
+export type { StorageClientConfig } from './types.js';
+export declare function contentApiStorageAdapter(config: StorageClientConfig): Adapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/storage-content-api/index.js

@@ -0,0 +1,31 @@
+import { createStorageClient } from './client.js';
+import { getGenerateURL } from './generateURL.js';
+import { getHandleDelete } from './handleDelete.js';
+import { getHandleUpload } from './handleUpload.js';
+import { getHandler } from './staticHandler.js';
+export function contentApiStorageAdapter(config) {
+    return ({ collection, prefix })=>{
+        const client = createStorageClient(config);
+        const baseUrl = config.baseUrl;
+        return {
+            name: 'content-api',
+            generateURL: getGenerateURL({
+                baseUrl
+            }),
+            handleDelete: getHandleDelete({
+                client
+            }),
+            handleUpload: getHandleUpload({
+                client,
+                collection,
+                prefix
+            }),
+            staticHandler: getHandler({
+                client,
+                collection
+            })
+        };
+    };
+}
+
+//# sourceMappingURL=index.js.map

package/dist/storage-content-api/staticHandler.d.ts

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

package/dist/storage-content-api/staticHandler.js

@@ -0,0 +1,63 @@
+import { getFilePrefix } from '@payloadcms/plugin-cloud-storage/utilities';
+import path from 'path';
+import { isImage } from 'payload/shared';
+import { parseClientUploadContext } from './utilities/index.js';
+export const getHandler = ({ client, collection })=>{
+    return async (req, { params: { clientUploadContext, filename } })=>{
+        try {
+            const prefix = await getFilePrefix({
+                clientUploadContext,
+                collection,
+                filename,
+                req
+            });
+            const key = path.posix.join(prefix, filename);
+            const { data, error } = await client.POST('/api/v0/uploads/download/sign', {
+                body: {
+                    collectionId: collection.slug,
+                    expiresIn: 7200,
+                    filename: key
+                }
+            });
+            if (error || !data) {
+                req.payload.logger.error(`Failed to get signed download URL: ${JSON.stringify(error)}`);
+                return new Response('Internal Server Error', {
+                    status: 500
+                });
+            }
+            // On a client-upload fetch-back, core reads this response body into req.file.data to
+            // size the image; a 302's empty body crashes getImageSize. Return real bytes for
+            // images (and unknown mimetypes, to be safe), but keep the redirect otherwise so we
+            // don't download large non-images server-side.
+            if (clientUploadContext) {
+                const { mimeType } = parseClientUploadContext(clientUploadContext);
+                if (!mimeType || isImage(mimeType)) {
+                    const fileResponse = await fetch(data.url);
+                    if (!fileResponse.ok) {
+                        req.payload.logger.error(`Failed to fetch file for client-upload buffer fetch-back: ${fileResponse.status}`);
+                        return new Response('Internal Server Error', {
+                            status: 500
+                        });
+                    }
+                    const contentType = fileResponse.headers.get('Content-Type') ?? mimeType ?? 'application/octet-stream';
+                    return new Response(await fileResponse.arrayBuffer(), {
+                        headers: {
+                            'Content-Type': contentType
+                        }
+                    });
+                }
+            }
+            return Response.redirect(data.url, 302);
+        } catch (err) {
+            req.payload.logger.error({
+                err,
+                msg: 'Error in staticHandler'
+            });
+            return new Response('Internal Server Error', {
+                status: 500
+            });
+        }
+    };
+};
+
+//# sourceMappingURL=staticHandler.js.map

package/dist/storage-content-api/types.d.ts

@@ -0,0 +1,10 @@
+import type { AuthMode } from '../db-content-api/utilities/auth.js';
+export type StorageClientConfig = {
+    auth: AuthMode;
+    baseUrl: string;
+    contentSystemId: string;
+} | {
+    baseUrl: string;
+    contentApiKey: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/storage-content-api/types.js

@@ -0,0 +1,3 @@
+export { };
+
+//# sourceMappingURL=types.js.map

package/dist/storage-content-api/utilities/getSafeFilename.d.ts

@@ -0,0 +1,12 @@
+import type { PayloadRequest } from 'payload';
+/**
+ * Get a safe filename that doesn't collide with existing documents
+ * Similar to Payload's getSafeFileName
+ */
+export declare function getSafeFilename({ collectionSlug, desiredFilename, prefix, req, }: {
+    collectionSlug: string;
+    desiredFilename: string;
+    prefix?: string;
+    req: PayloadRequest;
+}): Promise<string>;
+//# sourceMappingURL=getSafeFilename.d.ts.map

package/dist/storage-content-api/utilities/getSafeFilename.js

@@ -0,0 +1,61 @@
+import sanitize from 'sanitize-filename';
+/**
+ * Check if a document with the given filename already exists in the database
+ * Matches Payload's docWithFilenameExists
+ */ async function docWithFilenameExists({ collectionSlug, filename, prefix, req }) {
+    const where = {
+        filename: {
+            equals: filename
+        }
+    };
+    if (prefix) {
+        where.prefix = {
+            equals: prefix
+        };
+    }
+    const doc = await req.payload.db.findOne({
+        collection: collectionSlug,
+        req,
+        where
+    });
+    return !!doc;
+}
+/**
+ * Increment filename by adding -1, -2, etc. suffix
+ * photo.jpg → photo-1.jpg
+ * photo-1.jpg → photo-2.jpg
+ * Matches Payload's incrementName
+ */ function incrementFilename(name) {
+    const extension = name.split('.').pop();
+    const baseFilename = sanitize(name.substring(0, name.lastIndexOf('.')) || name);
+    let incrementedName = baseFilename;
+    const regex = /(.*)-(\d+)$/;
+    const found = baseFilename.match(regex);
+    if (found === null) {
+        incrementedName += '-1';
+    } else {
+        const matchedName = found[1];
+        const matchedNumber = found[2];
+        const incremented = Number(matchedNumber) + 1;
+        incrementedName = `${matchedName}-${incremented}`;
+    }
+    return `${incrementedName}.${extension}`;
+}
+/**
+ * Get a safe filename that doesn't collide with existing documents
+ * Similar to Payload's getSafeFileName
+ */ export async function getSafeFilename({ collectionSlug, desiredFilename, prefix, req }) {
+    let modifiedFilename = desiredFilename;
+    // Keep incrementing until we find a filename that doesn't exist
+    while(await docWithFilenameExists({
+        collectionSlug,
+        filename: modifiedFilename,
+        prefix,
+        req
+    })){
+        modifiedFilename = incrementFilename(modifiedFilename);
+    }
+    return modifiedFilename;
+}
+
+//# sourceMappingURL=getSafeFilename.js.map

package/dist/storage-content-api/utilities/index.d.ts

@@ -0,0 +1,3 @@
+export { getSafeFilename } from './getSafeFilename.js';
+export { type ContentApiClientUploadContext, parseClientUploadContext, } from './parseClientUploadContext.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage-content-api/utilities/index.js

@@ -0,0 +1,4 @@
+export { getSafeFilename } from './getSafeFilename.js';
+export { parseClientUploadContext } from './parseClientUploadContext.js';
+
+//# sourceMappingURL=index.js.map

package/dist/storage-content-api/utilities/parseClientUploadContext.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The shape of the `clientUploadContext` produced by this adapter's client upload
+ * handler. The plugin's `StaticHandler`/`HandleUpload` types expose it as `unknown`
+ * (it is deserialized from a JSON form field and is adapter-specific), so it must be
+ * narrowed at runtime before use.
+ */
+export type ContentApiClientUploadContext = {
+    clientUploaded?: boolean;
+    filename?: string;
+    mimeType?: string;
+    prefix?: string;
+};
+/**
+ * Safely narrows an `unknown` clientUploadContext into the adapter's known shape,
+ * keeping only properties that are actually present with the expected type. Returns
+ * an empty object for any non-object input.
+ */
+export declare const parseClientUploadContext: (context: unknown) => ContentApiClientUploadContext;
+//# sourceMappingURL=parseClientUploadContext.d.ts.map

package/dist/storage-content-api/utilities/parseClientUploadContext.js

@@ -0,0 +1,30 @@
+/**
+ * The shape of the `clientUploadContext` produced by this adapter's client upload
+ * handler. The plugin's `StaticHandler`/`HandleUpload` types expose it as `unknown`
+ * (it is deserialized from a JSON form field and is adapter-specific), so it must be
+ * narrowed at runtime before use.
+ */ /**
+ * Safely narrows an `unknown` clientUploadContext into the adapter's known shape,
+ * keeping only properties that are actually present with the expected type. Returns
+ * an empty object for any non-object input.
+ */ export const parseClientUploadContext = (context)=>{
+    if (!context || typeof context !== 'object') {
+        return {};
+    }
+    const result = {};
+    if ('clientUploaded' in context && typeof context.clientUploaded === 'boolean') {
+        result.clientUploaded = context.clientUploaded;
+    }
+    if ('filename' in context && typeof context.filename === 'string') {
+        result.filename = context.filename;
+    }
+    if ('mimeType' in context && typeof context.mimeType === 'string') {
+        result.mimeType = context.mimeType;
+    }
+    if ('prefix' in context && typeof context.prefix === 'string') {
+        result.prefix = context.prefix;
+    }
+    return result;
+};
+
+//# sourceMappingURL=parseClientUploadContext.js.map

package/dist/templates/.env.example

@@ -0,0 +1,5 @@
+# Figma Project ID (CMS Resource ID)
+FIGMA_PROJECT_ID=
+
+# Environment name (e.g., production, staging)
+FIGMA_ENVIRONMENT_NAME=production

package/dist/templates/README.md

@@ -0,0 +1,19 @@
+# {{PROJECT_NAME}}
+
+A Payload project configured for running on Figma infrastructure.
+
+## Getting Started
+
+{{RUN_COMMAND}} dev
+
+Open http://localhost:3000/admin to access the admin panel.
+
+## Deployment
+
+npx @payloadcms/figma deploy
+
+Deploys to Figma infrastructure.
+
+## Resources
+
+- [Payload Docs](https://payloadcms.com/docs)

package/dist/types/config.d.ts

@@ -1,6 +1,7 @@
 /**
  * Figma CMS Configuration Types
  */
+import type { PackageManager } from '../utils/package-manager.js';
 /**
  * Tenant instance from Control Plane API
  */
@@ -25,7 +26,7 @@ export interface ProjectInfo {
     /** Whether Payload is installed */
     hasPayload: boolean;
     /** Package manager detected (npm, pnpm, yarn) */
-    packageManager?: 'npm' | 'pnpm' | 'yarn';
+    packageManager?: PackageManager;
     /** Project root path */
     path: string;
     /** Payload version if installed */

package/dist/types/config.js

@@ -1,8 +1,6 @@
 /**
  * Figma CMS Configuration Types
  */ /**
- * Tenant instance from Control Plane API
- */ /**
  * Project information from detection
  */ export { };
 

package/dist/types.d.ts

@@ -1,13 +1,23 @@
 import type arg from 'arg';
 export interface Args extends arg.Spec {
     '--debug': BooleanConstructor;
+    '--dry-run': BooleanConstructor;
+    '--env': StringConstructor;
+    '--environment': string;
     '--force': BooleanConstructor;
     '--help': BooleanConstructor;
+    '--id': StringConstructor;
+    '--infra-env': StringConstructor;
     '--list': BooleanConstructor;
     '--logout': BooleanConstructor;
+    '--name': StringConstructor;
+    '--template': StringConstructor;
     '--yes': BooleanConstructor;
+    '-e': string;
     '-f': string;
     '-h': string;
+    '-n': string;
+    '-t': string;
     '-y': string;
 }
 export type CliArgs = arg.Result<Args>;
@@ -37,7 +47,6 @@ interface Template {
     name: string;
     type: ProjectTemplate['type'];
 }
-export type PackageManager = 'bun' | 'npm' | 'pnpm' | 'yarn';
 export type DbType = 'd1-sqlite' | 'mongodb' | 'postgres' | 'sqlite' | 'vercel-postgres';
 export type DbDetails = {
     dbUri?: string;

package/dist/utils/adapters/nextjs.d.ts

@@ -0,0 +1,9 @@
+import type { AssetCollection, DeployAdapter, PageCollection } from '../deploy-adapter.js';
+export declare class NextjsAdapter implements DeployAdapter {
+    name: "nextjs";
+    collectAssets(projectPath: string): Promise<AssetCollection>;
+    collectPages(projectPath: string): Promise<PageCollection>;
+    prepareLambdaBundle(projectPath: string): Promise<string>;
+}
+export declare const nextjsAdapter: NextjsAdapter;
+//# sourceMappingURL=nextjs.d.ts.map