@payloadcms/figma 0.1.0-alpha.1 → 0.1.0-alpha.3

package/dist/api/control-plane.d.ts

@@ -77,7 +77,7 @@ export interface PerformDeploymentResponse {
     deploymentId: string;
     /** Status message */
     message: string;
-    /** List of tenant domains */
+    /** SiteDomain hostnames returned through the compatibility tenant_domains key */
     tenantDomains: string[];
 }
 export interface PerformDeploymentApiResponse {

package/dist/api/control-plane.js

@@ -234,7 +234,7 @@ import { parseControlPlaneApiError } from './error-response.js';
             deploymentId: options.deploymentId,
             message: 'Deployment initiated successfully',
             tenantDomains: [
-                'example.figmasource.site'
+                'example.figma.site'
             ]
         };
     }

package/dist/cli.d.ts

@@ -1,3 +1,33 @@
+export declare const cliArgSpec: {
+    readonly '--adapter': StringConstructor;
+    readonly '--all': BooleanConstructor;
+    readonly '--debug': BooleanConstructor;
+    readonly '--dry-run': BooleanConstructor;
+    readonly '--env': StringConstructor;
+    readonly '--force': BooleanConstructor;
+    readonly '--help': BooleanConstructor;
+    readonly '--id': StringConstructor;
+    readonly '--infra-env': StringConstructor;
+    readonly '--json': BooleanConstructor;
+    readonly '--name': StringConstructor;
+    readonly '--no-skill': BooleanConstructor;
+    readonly '--output': StringConstructor;
+    readonly '--payload-version': StringConstructor;
+    readonly '--skip-auth': BooleanConstructor;
+    readonly '--skip-build': BooleanConstructor;
+    readonly '--skip-size-check': BooleanConstructor;
+    readonly '--template': StringConstructor;
+    readonly '--version': BooleanConstructor;
+    readonly '--yes': BooleanConstructor;
+    readonly '--environment': "--env";
+    readonly '-e': "--env";
+    readonly '-f': "--force";
+    readonly '-h': "--help";
+    readonly '-n': "--name";
+    readonly '-t': "--template";
+    readonly '-v': "--version";
+    readonly '-y': "--yes";
+};
 /**
  * Entrypoint for bin/cli.js
  */

package/dist/cli.js

@@ -15,6 +15,37 @@ import { upgradeCommand } from './commands/upgrade.js';
 import { uploadSchemaCommand } from './commands/upload-schema.js';
 import { setInfraEnvironment } from './constants.js';
 import { helpMessage } from './utils/messages.js';
+export const cliArgSpec = {
+    '--adapter': String,
+    '--all': Boolean,
+    '--debug': Boolean,
+    '--dry-run': Boolean,
+    '--env': String,
+    '--force': Boolean,
+    '--help': Boolean,
+    '--id': String,
+    '--infra-env': String,
+    '--json': Boolean,
+    '--name': String,
+    '--no-skill': Boolean,
+    '--output': String,
+    '--payload-version': String,
+    '--skip-auth': Boolean,
+    '--skip-build': Boolean,
+    '--skip-size-check': Boolean,
+    '--template': String,
+    '--version': Boolean,
+    '--yes': Boolean,
+    // Aliases
+    '--environment': '--env',
+    '-e': '--env',
+    '-f': '--force',
+    '-h': '--help',
+    '-n': '--name',
+    '-t': '--template',
+    '-v': '--version',
+    '-y': '--yes'
+};
 /**
  * Entrypoint for bin/cli.js
  */ export async function main() {
@@ -31,39 +62,7 @@ class Main {
     args;
     constructor(){
         // @ts-expect-error bad typings
-        this.args = arg({
-            // Hidden flag — intentionally not displayed in help output yet.
-            // Auto-detection covers most cases; this is an escape hatch for testing.
-            // May expose in help text once multi-framework support is public.
-            '--adapter': String,
-            '--all': Boolean,
-            '--debug': Boolean,
-            '--dry-run': Boolean,
-            '--env': String,
-            '--force': Boolean,
-            '--help': Boolean,
-            '--id': String,
-            '--infra-env': String,
-            '--json': Boolean,
-            '--name': String,
-            '--no-skill': Boolean,
-            '--payload-version': String,
-            '--skip-auth': Boolean,
-            '--skip-build': Boolean,
-            '--skip-size-check': Boolean,
-            '--template': String,
-            '--version': Boolean,
-            '--yes': Boolean,
-            // Aliases
-            '--environment': '--env',
-            '-e': '--env',
-            '-f': '--force',
-            '-h': '--help',
-            '-n': '--name',
-            '-t': '--template',
-            '-v': '--version',
-            '-y': '--yes'
-        }, {
+        this.args = arg(cliArgSpec, {
             permissive: true
         });
         // Set debug flag globally
@@ -136,6 +135,7 @@ class Main {
                         adapter: this.args['--adapter'],
                         debug: this.args['--debug'],
                         env: this.args['--env'],
+                        output: this.args['--output'],
                         skipBuild: this.args['--skip-build'],
                         skipSizeCheck: this.args['--skip-size-check'],
                         yes: this.args['--yes']

package/dist/commands/deploy.d.ts

@@ -11,6 +11,8 @@ export interface DeployCommandOptions {
     env?: string;
     /** CMS Resource ID (overrides FIGMA_PROJECT_ID) */
     id?: string;
+    /** Exact framework build output root */
+    output?: string;
     /** Skip the build step (use existing build) */
     skipBuild?: boolean;
     /** Skip the client-side unzipped bundle size pre-flight check */

package/dist/commands/deploy.js

@@ -1,5 +1,6 @@
 import * as p from '@clack/prompts';
 import spawn from 'cross-spawn';
+import path from 'path';
 import pc from 'picocolors';
 import { ControlPlaneError, createDeployment, getBootstrapInfo, performDeployment } from '../api/control-plane.js';
 import { tryGetCredential } from '../auth/oauth-flow.js';
@@ -64,10 +65,10 @@ import { loginCommand } from './login.js';
     const environmentName = options.env ?? await getEnvVar(projectPath, 'FIGMA_ENVIRONMENT_NAME') ?? undefined;
     try {
         // ===== PRE-FLIGHT CHECKS =====
-        // Check if in project directory
-        if (!await isInProjectDirectory(projectPath)) {
-            p.log.error(pc.red("✗ 'deploy' command is not available outside of a Payload project."));
-            p.note('Create a project or connect an existing one to Figma: npx @payloadcms/figma init', 'Tip');
+        // Building requires package.json, but --skip-build can deploy a prebuilt artifact directly.
+        if (!options.skipBuild && !await isInProjectDirectory(projectPath)) {
+            p.log.error(pc.red('✗ Cannot build because package.json was not found in this directory.'));
+            p.note('Run from a package directory, or deploy prebuilt output with --skip-build --output <path>.', 'Tip');
             process.exit(1);
         }
         // Check authentication
@@ -110,13 +111,18 @@ import { loginCommand } from './login.js';
         process.env.FIGMA_EXTRACT_SCHEDULES = 'true';
         // ===== BUILD =====
         let buildInfo;
+        const buildOptions = {
+            adapter: options.adapter,
+            output: options.output
+        };
         if (options.skipBuild) {
             // User asserts build exists - verify it
             spinner.start('Checking for build...');
-            buildInfo = await detectBuild(projectPath);
+            buildInfo = await detectBuild(projectPath, buildOptions);
             if (!buildInfo) {
                 spinner.stop(pc.red('✗ No build found'));
-                p.log.error('Use deploy without --skip-build to build first.');
+                p.log.error(getMissingBuildMessage(projectPath, options));
+                p.note('Use deploy without --skip-build to build first.', 'Tip');
                 process.exit(1);
             }
             spinner.stop(pc.green('✓ Build found'));
@@ -182,9 +188,9 @@ import { loginCommand } from './login.js';
                 process.exit(1);
             }
             // Verify build output
-            buildInfo = await detectBuild(projectPath);
+            buildInfo = await detectBuild(projectPath, buildOptions);
             if (!buildInfo) {
-                p.log.error(pc.red('✗ Build completed but build output not found'));
+                p.log.error(pc.red(`✗ ${getMissingBuildMessage(projectPath, options)}`));
                 p.note('Ensure your build produces a valid output directory.', 'Check Build Configuration');
                 process.exit(1);
             }
@@ -192,12 +198,12 @@ import { loginCommand } from './login.js';
         // ===== DEPLOYMENT PREPARATION =====
         // Detect framework adapter
         spinner.start('Detecting framework...');
-        const adapter = await detectAdapter(projectPath, options.adapter);
+        const adapter = await detectAdapter(projectPath, options.adapter, options.output);
         spinner.stop(pc.green(`✓ Detected ${adapter.name} adapter`));
         // Collect pages and assets
         spinner.start('Collecting assets...');
-        const pages = await adapter.collectPages(projectPath);
-        const assets = await adapter.collectAssets(projectPath);
+        const pages = await adapter.collectPages(projectPath, options.output);
+        const assets = await adapter.collectAssets(projectPath, options.output);
         spinner.stop(pc.green(`✓ ${pages.routes.length} pages, ${assets.routes.length} assets detected`));
         // Create deployment package (if server adapter)
         let zipPath = null;
@@ -205,7 +211,7 @@ import { loginCommand } from './login.js';
         let unzippedBytes = 0;
         spinner.start('Creating deployment package...');
         try {
-            const bundle = await adapter.prepareLambdaBundle(projectPath);
+            const bundle = await adapter.prepareLambdaBundle(projectPath, options.output);
             if (bundle) {
                 zipPath = bundle.zipPath;
                 unzippedBytes = bundle.unzippedBytes;
@@ -342,3 +348,7 @@ import { loginCommand } from './login.js';
         process.exit(1);
     }
 }
+function getMissingBuildMessage(projectPath, options) {
+    const location = options.output ? ` at ${path.resolve(projectPath, options.output)}` : '';
+    return options.adapter ? `No ${options.adapter} build found${location}.` : `No supported build found${location}.`;
+}

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

@@ -29,7 +29,7 @@ export type ContentAPIAdapter = {
     client: ReturnType<typeof createClient<paths>>;
     clientVersionHeaders: Record<string, string>;
     contentSystemId: string;
-    documentSchema: DocumentSchemaWire;
+    documentSchema: () => DocumentSchemaWire;
     environmentName?: string;
     idType: 'uuid';
     notifyLocalJobQueue: boolean;

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

@@ -1,5 +1,5 @@
 import createClient from 'openapi-fetch';
-import { APIError, createDatabaseAdapter } from 'payload';
+import { APIError, createDatabaseAdapter, ValidationError } from 'payload';
 import { v4 as uuid } from 'uuid';
 import { FigmaApiError } from '../api/figma-api.js';
 import { CONTENT_SYSTEM_NOT_FOUND_MESSAGE } from '../constants.js';
@@ -13,7 +13,7 @@ import { validateRelationshipIds } from './utilities/data/validateRelationships.
 import { convertPayloadJoinsToContentAPI } from './utilities/joins.js';
 import { addFallbackLocale } from './utilities/locale/index.js';
 import { normalizeLocaleInWhere } from './utilities/meta/normalizeLocaleInWhere.js';
-import { buildDocumentSchema } from './utilities/schema/buildDocumentSchema.js';
+import { getDocumentSchema } from './utilities/schema/getDocumentSchema.js';
 import { convertPayloadWhereToContentAPI } from './utilities/where.js';
 /**
  * Heads-up logged locally whenever a job is queued. Queued jobs are executed by Figma's deployed runner, so
@@ -109,7 +109,7 @@ async function createCollection(collectionId) {
             }
         });
         if (error) {
-            throw createContentAPIError('createCollection', error, httpResponse.status);
+            throw createDocumentContentAPIError(this, 'createCollection', error, httpResponse.status, collectionId);
         }
         this.payload.logger.info(`Created collection: ${collectionId}`);
     } catch (error) {
@@ -131,13 +131,13 @@ async function findMany({ collection, joins, limit, locale: localeArg, page, pag
             limit,
             locale,
             page: page ?? 1,
-            schema: this.documentSchema,
+            schema: this.documentSchema(),
             sort: addFallbackSort(sort, this.payload, collection),
             where: convertPayloadWhereToContentAPI(normalizedWhere ?? {})
         }
     });
     if (error) {
-        throw createContentAPIError('findMany', error, httpResponse.status);
+        throw createDocumentContentAPIError(this, 'findMany', error, httpResponse.status, collection);
     }
     if (!response) {
         throw new Error('No response from findMany');
@@ -176,13 +176,13 @@ async function findVersions(args) {
             limit: args.limit,
             locale,
             page: args.page ?? 1,
-            schema: this.documentSchema,
+            schema: this.documentSchema(),
             sort: sortWithFallback,
             where: whereClause
         }
     });
     if (error) {
-        throw createContentAPIError('findVersions', error, httpResponse.status);
+        throw createDocumentContentAPIError(this, 'findVersions', error, httpResponse.status, args.collection);
     }
     if (!response) {
         throw new Error('No response from findVersions');
@@ -230,7 +230,7 @@ async function createVersion(args) {
         body: {
             collection: args.collectionSlug,
             contentSystemId: this.contentSystemId,
-            schema: this.documentSchema,
+            schema: this.documentSchema(),
             versionDoc: {
                 createdAt: args.createdAt,
                 latest: true,
@@ -241,7 +241,7 @@ async function createVersion(args) {
         }
     });
     if (error) {
-        throw createContentAPIError('createVersion', error, httpResponse.status);
+        throw createDocumentContentAPIError(this, 'createVersion', error, httpResponse.status, args.collectionSlug);
     }
     if (!response) {
         throw new Error('No response from createVersion');
@@ -272,7 +272,7 @@ async function updateVersion(args) {
             contentSystemId: this.contentSystemId,
             createOnMissing: false,
             locale,
-            schema: this.documentSchema,
+            schema: this.documentSchema(),
             versionDoc: {
                 createdAt: versionMeta.createdAt,
                 latest: versionMeta.latest,
@@ -284,7 +284,7 @@ async function updateVersion(args) {
         }
     });
     if (error) {
-        throw createContentAPIError('updateVersion', error, httpResponse.status);
+        throw createDocumentContentAPIError(this, 'updateVersion', error, httpResponse.status, args.collection);
     }
     if (!response?.result || !('data' in response.result)) {
         throw new Error('No document data in updateVersion response');
@@ -301,21 +301,22 @@ async function updateVersion(args) {
     });
 }
 async function deleteVersions(args) {
-    if (!args.collection) {
+    const collection = args.collection;
+    if (collection == null) {
         throw new Error('deleteVersions requires a collection');
     }
     const locale = addFallbackLocale(args.locale, this.payload);
     const { error, response: httpResponse } = await this.client.POST('/api/v1/document_versions:delete', {
         body: {
-            collection: args.collection,
+            collection,
             contentSystemId: this.contentSystemId,
             locale,
-            schema: this.documentSchema,
+            schema: this.documentSchema(),
             where: convertPayloadWhereToContentAPI(args.where)
         }
     });
     if (error) {
-        throw createContentAPIError('deleteVersions', error, httpResponse.status);
+        throw createDocumentContentAPIError(this, 'deleteVersions', error, httpResponse.status, collection);
     }
 }
 async function findOne(args) {
@@ -339,13 +340,13 @@ async function findDistinct(args) {
             limit: args.limit,
             locale,
             page: args.page ?? 1,
-            schema: this.documentSchema,
+            schema: this.documentSchema(),
             sort: addFallbackSort(args.sort, this.payload, args.collection),
             where: convertPayloadWhereToContentAPI(args.where ?? {})
         }
     });
     if (error) {
-        throw createContentAPIError('findDistinct', error, httpResponse.status);
+        throw createDocumentContentAPIError(this, 'findDistinct', error, httpResponse.status, args.collection);
     }
     const { data, ...pagination } = response.result;
     return {
@@ -372,13 +373,13 @@ async function updateMany(args) {
             environmentName: this.environmentName,
             limit: args.limit,
             locale,
-            schema: this.documentSchema,
+            schema: this.documentSchema(),
             sort: addFallbackSort(args.sort || '-updatedAt', this.payload, args.collection),
             where: convertPayloadWhereToContentAPI(args.where)
         }
     });
     if (error) {
-        throw createContentAPIError('updateMany', error, httpResponse.status);
+        throw createDocumentContentAPIError(this, 'updateMany', error, httpResponse.status, args.collection);
     }
     if (!contentAPIResponse) {
         throw new Error('No response from updateMany');
@@ -413,12 +414,12 @@ async function updateOne(args) {
             doc: dataToContentAPI(this.payload, args.collection, args.data),
             environmentName: this.environmentName,
             locale,
-            schema: this.documentSchema,
+            schema: this.documentSchema(),
             where: convertPayloadWhereToContentAPI(where)
         }
     });
     if (error) {
-        throw createContentAPIError('updateOne', error, httpResponse.status);
+        throw createDocumentContentAPIError(this, 'updateOne', error, httpResponse.status, args.collection);
     }
     if (!contentAPIResponse) {
         throw new Error('No response from updateOne');
@@ -445,12 +446,12 @@ async function deleteMany(args) {
             contentSystemId: this.contentSystemId,
             environmentName: this.environmentName,
             locale,
-            schema: this.documentSchema,
+            schema: this.documentSchema(),
             where: convertPayloadWhereToContentAPI(args.where)
         }
     });
     if (error) {
-        throw createContentAPIError('deleteMany', error, httpResponse.status);
+        throw createDocumentContentAPIError(this, 'deleteMany', error, httpResponse.status, args.collection);
     }
 }
 async function deleteOne(args) {
@@ -461,12 +462,12 @@ async function deleteOne(args) {
             contentSystemId: this.contentSystemId,
             environmentName: this.environmentName,
             locale,
-            schema: this.documentSchema,
+            schema: this.documentSchema(),
             where: convertPayloadWhereToContentAPI(args.where)
         }
     });
     if (error) {
-        throw createContentAPIError('deleteOne', error, httpResponse.status);
+        throw createDocumentContentAPIError(this, 'deleteOne', error, httpResponse.status, args.collection);
     }
     if (!response?.result || !('data' in response.result)) {
         throw new Error('No document data in deleteOne response');
@@ -516,11 +517,11 @@ async function create(args) {
             },
             environmentName: this.environmentName,
             locale,
-            schema: this.documentSchema
+            schema: this.documentSchema()
         }
     });
     if (error) {
-        throw createContentAPIError('create', error, httpResponse.status);
+        throw createDocumentContentAPIError(this, 'create', error, httpResponse.status, args.collection);
     }
     if (!contentAPIResponse) {
         throw new Error('No response from create');
@@ -568,12 +569,12 @@ async function count(args) {
             collection: args.collection,
             contentSystemId: this.contentSystemId,
             locale,
-            schema: this.documentSchema,
+            schema: this.documentSchema(),
             where: convertPayloadWhereToContentAPI(args.where)
         }
     });
     if (error) {
-        throw createContentAPIError('count', error, httpResponse.status);
+        throw createDocumentContentAPIError(this, 'count', error, httpResponse.status, args.collection);
     }
     if (!response) {
         throw new Error('No response from count');
@@ -589,12 +590,12 @@ async function countVersions(args) {
             collection: args.collection,
             contentSystemId: this.contentSystemId,
             locale,
-            schema: this.documentSchema,
+            schema: this.documentSchema(),
             where: convertPayloadWhereToContentAPI(args.where)
         }
     });
     if (error) {
-        throw createContentAPIError('countVersions', error, httpResponse.status);
+        throw createDocumentContentAPIError(this, 'countVersions', error, httpResponse.status, args.collection);
     }
     if (!response) {
         throw new Error('No response from countVersions');
@@ -633,12 +634,12 @@ async function upsert(args) {
             }),
             environmentName: this.environmentName,
             locale,
-            schema: this.documentSchema,
+            schema: this.documentSchema(),
             where: convertPayloadWhereToContentAPI(args.where)
         }
     });
     if (error) {
-        throw createContentAPIError('upsert', error, httpResponse.status);
+        throw createDocumentContentAPIError(this, 'upsert', error, httpResponse.status, args.collection);
     }
     if (!contentAPIResponse) {
         throw new Error('No response from upsert');
@@ -658,6 +659,7 @@ async function upsert(args) {
     });
 }
 async function updateJobs(args) {
+    const collection = 'payload-jobs';
     const { id, limit, returning, sort, where } = args;
     if (id == null && where == null) {
         throw new Error('updateJobs requires either id or a where clause');
@@ -678,12 +680,12 @@ async function updateJobs(args) {
             equals: String(id)
         }
     } : where;
-    const docData = dataToContentAPI(this.payload, 'payload-jobs', data);
-    const sortClause = addFallbackSort(sort || '-updatedAt', this.payload, 'payload-jobs');
+    const docData = dataToContentAPI(this.payload, collection, data);
+    const sortClause = addFallbackSort(sort || '-updatedAt', this.payload, collection);
     const whereQuery = convertPayloadWhereToContentAPI(whereClause);
     const { data: response, error, response: httpResponse } = await this.client.POST('/api/v1/documents:update', {
         body: {
-            collection: 'payload-jobs',
+            collection,
             contentSystemId: this.contentSystemId,
             createOnMissing: false,
             doc: docData,
@@ -691,13 +693,13 @@ async function updateJobs(args) {
             ...limit != null && {
                 limit
             },
-            schema: this.documentSchema,
+            schema: this.documentSchema(),
             sort: sortClause,
             where: whereQuery
         }
     });
     if (error) {
-        throw createContentAPIError('updateJobs', error, httpResponse.status);
+        throw createDocumentContentAPIError(this, 'updateJobs', error, httpResponse.status, collection);
     }
     if (!response) {
         throw new Error('No response from updateJobs');
@@ -709,7 +711,7 @@ async function updateJobs(args) {
         return [];
     }
     return response.result.data.map((doc)=>unwrapDocument({
-            collectionSlug: 'payload-jobs',
+            collectionSlug: collection,
             doc,
             payload: this.payload
         }));
@@ -809,6 +811,13 @@ function countGlobalVersions(args) {
         where: args.where
     });
 }
+function createDocumentContentAPIError(adapter, operation, error, status, collectionSlug) {
+    const validationError = maybeCreateUniqueValidationError(error, collectionSlug, adapter);
+    if (validationError != null) {
+        return validationError;
+    }
+    return createContentAPIError(operation, error, status);
+}
 function createContentAPIError(operation, error, status) {
     return new APIError(`Content API ${operation} error: ${error.message}`, status, {
         code: error.code,
@@ -816,6 +825,27 @@ function createContentAPIError(operation, error, status) {
         field: error.field
     });
 }
+// A unique-constraint violation from the Content API is Payload's `ValidationError` contract:
+// reconstruct it with the offending field path(s) so callers can map the error back to a field
+// (matching what Payload's other database adapters throw). Falls back to a generic APIError when
+// the collection or offending field is unknown.
+function maybeCreateUniqueValidationError(error, collectionSlug, adapter) {
+    if (error.constraint !== 'unique_constraint') {
+        return null;
+    }
+    const paths = (error.field ?? '').split(',').map((path)=>path.trim()).filter((path)=>path.length > 0);
+    if (paths.length === 0) {
+        adapter.payload.logger.error(`Unique constraint violation but no offending field.`);
+        return null;
+    }
+    return new ValidationError({
+        collection: collectionSlug,
+        errors: paths.map((path)=>({
+                message: error.message,
+                path
+            }))
+    });
+}
 export const contentAPIAdapter = (opts)=>({
         name: 'content-api',
         defaultIDType: 'text',
@@ -855,7 +885,7 @@ export const contentAPIAdapter = (opts)=>({
                 deleteMany: deleteMany,
                 deleteOne: deleteOne,
                 deleteVersions: deleteVersions,
-                documentSchema: buildDocumentSchema(payload.config),
+                documentSchema: ()=>getDocumentSchema(payload.config),
                 environmentName: opts.environmentName,
                 find: find,
                 findDistinct: findDistinct,

package/dist/db-content-api/utilities/schema/getDocumentSchema.d.ts

@@ -0,0 +1,3 @@
+import type { Config, SanitizedConfig } from 'payload';
+import type { DocumentSchemaWire } from './buildDocumentSchema.js';
+export declare function getDocumentSchema(config: Config | SanitizedConfig): DocumentSchemaWire;

package/dist/db-content-api/utilities/schema/getDocumentSchema.js

@@ -0,0 +1,24 @@
+import { buildDocumentSchema } from './buildDocumentSchema.js';
+// The schema built by `getDocumentSchema`, keyed by the config it was built from.
+// Weakly held so a config discarded by HMR takes its schema with it.
+let schemaByConfig = new WeakMap();
+// Retrieves a document schema for the given config, building it if necessary.
+// The last output is memoized, so if this config matches the last config we just return
+// the previous output instead of rebuilding it.
+export function getDocumentSchema(config) {
+    const existing = schemaByConfig.get(config);
+    if (existing != null) {
+        return existing;
+    }
+    const schema = buildDocumentSchema(config);
+    // Clear the cache of any previous config, so only the most recent one is held.
+    // This ensures that we never accidentally leak memory by holding on to more
+    // and more schemas if the configs are never garbage collected.
+    schemaByConfig = new WeakMap([
+        [
+            config,
+            schema
+        ]
+    ]);
+    return schema;
+}

package/dist/exports/client.d.ts

@@ -2,3 +2,5 @@ export { FigmaAvatar } from '../oauth/components/FigmaAvatar/index.js';
 export { FigmaAvatarCell } from '../oauth/components/FigmaAvatarCell/index.js';
 export { DefaultLoginButton } from '../oauth/components/LoginButton/index.js';
 export { LogoutButton } from '../oauth/components/LogoutButton/index.js';
+export { FigmaCloudLimitProvider } from '../plugin/cloud-limits/CloudLimitProvider/index.js';
+export { FigmaCloudLimitSlugTracker } from '../plugin/cloud-limits/SlugTracker/index.js';

package/dist/exports/client.js

@@ -2,3 +2,5 @@ export { FigmaAvatar } from '../oauth/components/FigmaAvatar/index.js';
 export { FigmaAvatarCell } from '../oauth/components/FigmaAvatarCell/index.js';
 export { DefaultLoginButton } from '../oauth/components/LoginButton/index.js';
 export { LogoutButton } from '../oauth/components/LogoutButton/index.js';
+export { FigmaCloudLimitProvider } from '../plugin/cloud-limits/CloudLimitProvider/index.js';
+export { FigmaCloudLimitSlugTracker } from '../plugin/cloud-limits/SlugTracker/index.js';