@payloadcms/figma 0.0.1-alpha.64 → 0.0.1-alpha.65

package/dist/plugin/build-config.js

@@ -220,6 +220,7 @@ export async function buildFigmaConfig(config) {
                 mode: 'apiKey'
             },
             contentSystemId,
+            environmentName: process.env.FIGMA_ENVIRONMENT_NAME,
             url
         });
     } else if (process.env.FIGMA_DEV_JWT === 'true') {
@@ -228,6 +229,7 @@ export async function buildFigmaConfig(config) {
                 mode: 'devJwt'
             },
             contentSystemId,
+            environmentName: process.env.FIGMA_ENVIRONMENT_NAME,
             url
         });
     } else {
@@ -237,6 +239,7 @@ export async function buildFigmaConfig(config) {
                 tokenStore: getTokenStore()
             },
             contentSystemId,
+            environmentName: process.env.FIGMA_ENVIRONMENT_NAME,
             url
         });
     }

package/dist/types.d.ts

@@ -11,11 +11,13 @@ export interface Args extends arg.Spec {
     '--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>;

package/dist/utils/download-template.d.ts

@@ -5,11 +5,19 @@ export declare class TemplateDownloadError extends Error {
     cause?: Error | undefined;
     constructor(message: string, cause?: Error | undefined);
 }
+export type TemplateSource = {
+    owner: string;
+    ref: string;
+    repo: string;
+    templatePath: string;
+};
+export declare const DEFAULT_TEMPLATE_SOURCE: TemplateSource;
 /**
  * Download Payload template from GitHub with retry logic
  *
  * @param projectDir - Directory to extract template into
+ * @param source - Optional override of repo / ref / template path
  * @throws TemplateDownloadError if download fails
  */
-export declare function downloadTemplateFromGitHub(projectDir: string): Promise<void>;
+export declare function downloadTemplateFromGitHub(projectDir: string, source?: Partial<TemplateSource>): Promise<void>;
 //# sourceMappingURL=download-template.d.ts.map

package/dist/utils/download-template.js

@@ -11,23 +11,30 @@ import { x } from 'tar';
         this.name = 'TemplateDownloadError';
     }
 }
-const BRANCH_OR_TAG = 'v3.79.1';
-/** GitHub strips the 'v' prefix in tarball directory names */ const TARBALL_PREFIX = `payload-${BRANCH_OR_TAG.replace(/^v/, '')}`;
-const TEMPLATE_NAME = 'blank';
+export const DEFAULT_TEMPLATE_SOURCE = {
+    owner: 'payloadcms',
+    ref: 'v3.84.1',
+    repo: 'payload',
+    templatePath: 'blank'
+};
 const MAX_RETRIES = 3;
-const INITIAL_RETRY_DELAY = 1000 // 1 second
-;
+const INITIAL_RETRY_DELAY = 1000;
 /**
  * Download Payload template from GitHub with retry logic
  *
  * @param projectDir - Directory to extract template into
+ * @param source - Optional override of repo / ref / template path
  * @throws TemplateDownloadError if download fails
- */ export async function downloadTemplateFromGitHub(projectDir) {
+ */ export async function downloadTemplateFromGitHub(projectDir, source) {
+    const resolved = {
+        ...DEFAULT_TEMPLATE_SOURCE,
+        ...source
+    };
     let lastError;
     for(let attempt = 1; attempt <= MAX_RETRIES; attempt++){
         try {
-            await downloadTemplateAttempt(projectDir);
-            return; // Success
+            await downloadTemplateAttempt(projectDir, resolved);
+            return;
         } catch (error) {
             lastError = error instanceof Error ? error : new Error('Unknown error');
             if (attempt < MAX_RETRIES) {
@@ -37,31 +44,29 @@ const INITIAL_RETRY_DELAY = 1000 // 1 second
             }
         }
     }
-    // All retries failed
     throw new TemplateDownloadError(`Failed to download template after ${MAX_RETRIES} attempts`, lastError);
 }
-/**
- * Single attempt to download template (extracted for retry logic)
- */ async function downloadTemplateAttempt(projectDir) {
-    const url = `https://codeload.github.com/payloadcms/payload/tar.gz/${BRANCH_OR_TAG}`;
-    const filter = `${TARBALL_PREFIX}/templates/${TEMPLATE_NAME}/`;
+async function downloadTemplateAttempt(projectDir, source) {
+    const url = `https://codeload.github.com/${source.owner}/${source.repo}/tar.gz/${source.ref}`;
+    // GitHub strips the leading 'v' and replaces '/' with '-' when naming the tarball root dir
+    const refSlug = source.ref.replace(/^v/, '').replace(/\//g, '-');
+    const tarballPrefix = `${source.repo}-${refSlug}`;
+    const filter = `${tarballPrefix}/templates/${source.templatePath}/`;
+    const strip = 2 + source.templatePath.split('/').length;
     try {
-        // Ensure target directory exists
         await fs.mkdir(projectDir, {
             recursive: true
         });
         await pipeline(await downloadTarStream(url), x({
             cwd: projectDir,
             filter: (p)=>p.includes(filter),
-            strip: 2 + TEMPLATE_NAME.split('/').length
+            strip
         }));
     } catch (error) {
         throw new TemplateDownloadError('Failed to download template from GitHub', error instanceof Error ? error : undefined);
     }
 }
-/**
- * Download tar stream from URL
- */ async function downloadTarStream(url) {
+async function downloadTarStream(url) {
     const res = await fetch(url);
     if (!res.ok) {
         throw new Error(`HTTP ${res.status}: ${res.statusText}`);

package/dist/utils/messages.js

@@ -39,6 +39,8 @@ export function helpMessage() {
       ${pc.cyan('@payloadcms/figma init --id <id> --env staging')}    Initialize for specific environment
       ${pc.dim('--name, -n <name>')}                     Set project directory name (skips prompt)
       ${pc.dim('--force')}                               Force reconfiguration of existing project
+      ${pc.dim('--no-skill')}                            Skip installing the Payload skill into .claude/skills/payload/
+      ${pc.dim('--template, -t <spec>')}                  Override scaffold template (e.g. v3.80.0:website, owner/repo#ref:path)
 
   ${pc.bold('BOOTSTRAP COMMAND')}
 

package/dist/utils/parse-template-spec.d.ts

@@ -0,0 +1,12 @@
+import type { TemplateSource } from './download-template.js';
+export declare class TemplateSpecParseError extends Error {
+    constructor(message: string);
+}
+/**
+ * Parse a --template spec string into a partial TemplateSource override.
+ *
+ * Format: [<owner>/<repo>#]<ref>:<template-path>
+ * Shorthand: a bare token with no `#` and no `:` is treated as the template path.
+ */
+export declare function parseTemplateSpec(spec: string): Partial<TemplateSource>;
+//# sourceMappingURL=parse-template-spec.d.ts.map

package/dist/utils/parse-template-spec.js

@@ -0,0 +1,62 @@
+export class TemplateSpecParseError extends Error {
+    constructor(message){
+        super(message);
+        this.name = 'TemplateSpecParseError';
+    }
+}
+/**
+ * Parse a --template spec string into a partial TemplateSource override.
+ *
+ * Format: [<owner>/<repo>#]<ref>:<template-path>
+ * Shorthand: a bare token with no `#` and no `:` is treated as the template path.
+ */ export function parseTemplateSpec(spec) {
+    const trimmed = spec.trim();
+    if (!trimmed) {
+        throw new TemplateSpecParseError('Template spec is empty');
+    }
+    let rest = trimmed;
+    const result = {};
+    const hashIndex = rest.indexOf('#');
+    if (hashIndex !== -1) {
+        const repoPart = rest.slice(0, hashIndex);
+        rest = rest.slice(hashIndex + 1);
+        const slashCount = (repoPart.match(/\//g) ?? []).length;
+        if (slashCount !== 1) {
+            throw new TemplateSpecParseError(`Expected "<owner>/<repo>" before "#", got "${repoPart}"`);
+        }
+        const [owner, repo] = repoPart.split('/');
+        if (!owner || !repo) {
+            throw new TemplateSpecParseError(`Invalid owner/repo: "${repoPart}"`);
+        }
+        result.owner = owner;
+        result.repo = repo;
+    } else {
+        // Check for slash only in the portion before the first colon (the ref part).
+        // Slashes after the colon are valid multi-segment template paths.
+        const beforeColon = rest.includes(':') ? rest.slice(0, rest.indexOf(':')) : rest;
+        if (beforeColon.includes('/')) {
+            throw new TemplateSpecParseError(`"<owner>/<repo>" must be followed by "#<ref>" (got "${trimmed}")`);
+        }
+    }
+    const colonIndex = rest.indexOf(':');
+    if (colonIndex !== -1) {
+        const ref = rest.slice(0, colonIndex);
+        const templatePath = rest.slice(colonIndex + 1);
+        if (!ref) {
+            throw new TemplateSpecParseError('Ref before ":" is empty');
+        }
+        if (!templatePath) {
+            throw new TemplateSpecParseError('Template path after ":" is empty');
+        }
+        result.ref = ref;
+        result.templatePath = templatePath;
+        return result;
+    }
+    if (hashIndex !== -1) {
+        throw new TemplateSpecParseError('Spec with "<owner>/<repo>#<ref>" must include ":<template-path>"');
+    }
+    result.templatePath = rest;
+    return result;
+}
+
+//# sourceMappingURL=parse-template-spec.js.map

package/dist/utils/project.d.ts

@@ -2,6 +2,7 @@
  * Project detection and scaffolding utilities
  */
 import type { ProjectInfo } from '../types/config.js';
+import type { TemplateSource } from './download-template.js';
 import type { PackageManager } from './package-manager.js';
 /**
  * Detect if current directory has a Payload project
@@ -23,7 +24,7 @@ export declare function validatePayloadVersion(version: string): boolean;
  * @param projectPath - Path where to create the project
  * @param projectName - Name for the project
  */
-export declare function scaffoldProject(projectPath: string, projectName: string, packageManager?: PackageManager): Promise<void>;
+export declare function scaffoldProject(projectPath: string, projectName: string, packageManager?: PackageManager, templateSource?: Partial<TemplateSource>): Promise<void>;
 /**
  * Initialize git repository after all setup is complete
  *

package/dist/utils/project.js

@@ -120,13 +120,13 @@ import { getOwnVersion } from './version-check.js';
  *
  * @param projectPath - Path where to create the project
  * @param projectName - Name for the project
- */ export async function scaffoldProject(projectPath, projectName, packageManager = 'npm') {
+ */ export async function scaffoldProject(projectPath, projectName, packageManager = 'npm', templateSource) {
     // Create project directory if it doesn't exist
     await fs.mkdir(projectPath, {
         recursive: true
     });
     // Download template from GitHub
-    await downloadTemplateFromGitHub(projectPath);
+    await downloadTemplateFromGitHub(projectPath, templateSource);
     // Apply Lambda modifications BEFORE updating package.json
     // This ensures we don't overwrite version replacements
     await applyLambdaModifications(projectPath, packageManager);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/figma",
-  "version": "0.0.1-alpha.64",
+  "version": "0.0.1-alpha.65",
   "license": "SEE LICENSE IN LICENSE.md",
   "type": "module",
   "exports": {
@@ -47,10 +47,18 @@
     "uuid": "^10.0.0"
   },
   "devDependencies": {
+    "@payloadcms/eslint-config": "3.28.0",
+    "@payloadcms/eslint-plugin": "3.28.0",
+    "@swc/cli": "0.7.7",
     "@types/archiver": "7.0.0",
     "@types/cross-spawn": "6.0.6",
+    "@types/jsonwebtoken": "^9.0.10",
     "@types/node": "22.12.0",
+    "@types/uuid": "^8.3.4",
+    "copyfiles": "^2.4.1",
+    "eslint": "9.22.0",
     "openapi-typescript": "^7.13.0",
+    "rimraf": "^6.1.3",
     "tsx": "4.20.6",
     "typescript": "5.7.3",
     "vitest": "4.0.15"

package/dist/db-content-api/README.md

@@ -1,98 +0,0 @@
-# Content API Database Adapter Parity
-
-This document explains how the Content API database adapter differs from Payload today and how it will behave once alignment is complete.
-
-The Content API is an internal service built exclusively for Payload. Because of that, the adapter should match Payload by default and only diverge when there is a strong technical reason.
-
-## Where
-
-Now  
-`{ path: "slug", operator: "equals", value: "hello", type: "text" }`
-
-Future  
-`{ path: "slug", operator: "equals", value: "hello", type: "text" }`
-
-The format stays different. This allows the Content API to evolve its filter schema, for example to support composite types like Point, which are not lexicographically sortable. Semantics must remain identical to Payload.
-
-## Pagination
-
-~~Now~~  
-~~`{ limit: 10, offset: 20 }`~~
-
-✅ Partially Implemented  
-`{ limit: 10, page: 3 }`
-
-**Status:**
-
-- ✅ Content API main endpoints use `page` (matches Payload)
-
-- ⚠️ **Issue #1 (Joins):** `JoinClause` still uses `offset` instead of `page`
-  - Payload `JoinQuery`: `{ page?: number, limit?: number }`
-  - Content API `JoinClause`: `{ offset?: number, limit?: number }`
-  - **Inconsistent** with main endpoints which use `page`
-
-**Current workaround for joins:** The adapter converts `page` to `offset`:
-
-```typescript
-// Payload join query
-{ page: 2, limit: 5 }
-// Adapter converts to offset for Content API
-{ offset: 5, limit: 5 }
-```
-
-**Future:**
-
-1. Content API should support `skip` parameter for main endpoints
-2. Content API `JoinClause` should use `page` instead of `offset` (consistent with main endpoints)
-3. Content API pagination response should match Payload's flat structure
-
-### Pagination Response Structure
-
-**Payload format (flat):**
-
-```typescript
-{
-  docs: [...],
-  hasNextPage: boolean,
-  hasPrevPage: boolean,
-  limit: number,
-  nextPage: number | null,
-  page: number,
-  pagingCounter: number,
-  prevPage: number | null,
-  totalDocs: number,
-  totalPages: number
-}
-```
-
-**Content API format (nested):**
-
-```typescript
-{
-  data: [...],
-  pagination: {
-    total: number,
-    current: { limit: number, page: number },
-    next?: { limit: number, page: number },
-    prev?: { limit: number, page: number }
-  }
-}
-```
-
-**Current workaround:** The adapter transforms Content API's nested structure to Payload's flat structure using `getPaginationData()` utility.
-
-## Slugs
-
-Now  
-`{ collection: { key: "posts" } }`
-
-Future  
-`{ collection: { slug: "posts" } }`
-
-Collection identifiers will match Payload. Consumers should not be aware of internal collection IDs.
-
-## Temporary Conversions
-
-Helpers that translate Payload queries into the current Content API format are temporary and placed in the `temp-utilities` folder.
-
-They live in the `temp-utilities` folder until the Content API is fully aligned with Payload.