@sanity/runtime-cli 17.4.0 → 17.6.0

package/dist/actions/blueprints/process-assets.js

@@ -0,0 +1,80 @@
+import { env } from 'node:process';
+import { stashAsset } from './assets.js';
+const DEFAULT_ASSET_CONCURRENCY = 4;
+const DEFAULT_ASSET_TIMEOUT = 180;
+const assetTimeoutS = Number(env.SANITY_ASSET_TIMEOUT) || DEFAULT_ASSET_TIMEOUT;
+const assetTimeoutMs = assetTimeoutS * 1000;
+const warnTimeoutMs = assetTimeoutMs / 3;
+export async function processAssets(options) {
+    const { assetResources, onProgress, onResult } = options;
+    const total = assetResources.length;
+    const processedAssets = [];
+    const concurrency = getAssetConcurrency();
+    let completed = 0;
+    let slow = false;
+    const reportProgress = () => onProgress?.({ completed, total, slow });
+    reportProgress();
+    const warnTimer = setTimeout(() => {
+        slow = true;
+        reportProgress();
+    }, warnTimeoutMs);
+    try {
+        for (let start = 0; start < total; start += concurrency) {
+            const batch = assetResources.slice(start, start + concurrency);
+            const batchResults = await Promise.all(batch.map(async (resource) => {
+                const result = await processAsset(resource, options);
+                completed += 1;
+                reportProgress();
+                onResult?.(result);
+                return result;
+            }));
+            processedAssets.push(...batchResults);
+            if (batchResults.some((result) => !result.success))
+                break;
+        }
+    }
+    finally {
+        clearTimeout(warnTimer);
+    }
+    return processedAssets;
+}
+function getAssetConcurrency() {
+    const configured = Number(env.SANITY_ASSET_CONCURRENCY);
+    return Number.isSafeInteger(configured) && configured > 0 ? configured : DEFAULT_ASSET_CONCURRENCY;
+}
+async function processAsset(resource, options) {
+    const { auth, blueprintFileDir, installer, logger } = options;
+    let assetTimeoutTimer;
+    let result;
+    try {
+        result = await Promise.race([
+            stashAsset({ resource, blueprintFileDir, auth, logger, installer }),
+            new Promise((_, reject) => {
+                assetTimeoutTimer = setTimeout(() => {
+                    reject(new Error(`Processing ${resource.name} timed out after ${assetTimeoutS}s`));
+                }, assetTimeoutMs);
+            }),
+        ]);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { success: false, resource, error: msg, failureKind: 'processing' };
+    }
+    finally {
+        clearTimeout(assetTimeoutTimer);
+    }
+    if (result.success && result.assetId) {
+        return {
+            success: true,
+            resource: { ...resource, src: result.assetId },
+            hash: result.hash,
+            exists: result.exists,
+        };
+    }
+    return {
+        success: false,
+        resource,
+        error: result.error || 'Failed to process asset',
+        failureKind: 'upload',
+    };
+}

package/dist/actions/blueprints/resources.js

@@ -2,7 +2,7 @@ import { spawn } from 'node:child_process';
 import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { cwd } from 'node:process';
-import { MAP_EVENT_TO_FUNCTION_TYPE, SANITY_FUNCTION_DOCUMENT, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET, SANITY_FUNCTION_SCHEDULED, SANITY_FUNCTION_SYNC_TAG_INVALIDATE, } from '../../constants.js';
+import { MAP_EVENT_TO_FUNCTION_TYPE, SANITY_FUNCTION_DOCUMENT, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET, SANITY_FUNCTION_PUBSUB, SANITY_FUNCTION_SCHEDULED, SANITY_FUNCTION_SYNC_TAG_INVALIDATE, } from '../../constants.js';
 import { styleText } from '../../utils/style-text.js';
 import { writeOrUpdateNodeDependency } from '../node.js';
 import { addResourceToBlueprint } from './blueprint.js';
@@ -36,6 +36,12 @@ export const handler = syncTagInvalidateEventHandler(async ({ context, event, do
     console.error('Error invoking Sanity invalidation done endpoint!', e)
   }
 })`;
+const DEFAULT_PUBSUB_HELPER_FUNCTION_TEMPLATE = /*ts*/ `import { pubSubEventHandler } from '@sanity/functions'
+
+export const handler = pubSubEventHandler(async ({ context, event }) => {
+  const time = new Date().toLocaleTimeString()
+  console.log(\`Your pubsub Sanity Function was called at \${time}\`)
+})`;
 /**
  * Creates a new function resource file and adds it to the blueprint
  */
@@ -68,6 +74,9 @@ export async function createFunctionResource(options, logger) {
     let template = DEFAULT_FUNCTION_TEMPLATE;
     if (addHelpers) {
         switch (functionType) {
+            case SANITY_FUNCTION_PUBSUB:
+                template = DEFAULT_PUBSUB_HELPER_FUNCTION_TEMPLATE;
+                break;
             case SANITY_FUNCTION_SCHEDULED:
                 template = DEFAULT_SCHEDULED_HELPER_FUNCTION_TEMPLATE;
                 break;
@@ -119,6 +128,13 @@ export async function createFunctionResource(options, logger) {
                 },
             };
             break;
+        case SANITY_FUNCTION_PUBSUB:
+            resourceJson = {
+                name,
+                src: `functions/${name}`,
+                type: SANITY_FUNCTION_PUBSUB,
+            };
+            break;
         case SANITY_FUNCTION_SCHEDULED:
             resourceJson = {
                 name,

package/dist/commands/blueprints/deploy.js

@@ -14,7 +14,9 @@ Use --no-wait to queue the deployment and return immediately without waiting for
 
 Use --fn-installer to force which package manager to use when deploying functions.
 
-Set SANITY_ASSET_TIMEOUT (seconds) to override the 60-second timeout for processing resource assets.
+Set SANITY_ASSET_TIMEOUT (seconds) to override the 180-second timeout for processing resource assets.
+
+Set SANITY_ASSET_CONCURRENCY to override how many resource assets are processed at once (default 4).
 
 Exit codes: 0 deployed, 2 deployment failed, 75 deployment accepted but completion could not be confirmed (rerun 'blueprints info' to check).`;
     static examples = [

package/dist/commands/blueprints/destroy.js

@@ -19,7 +19,7 @@ Exit codes: 0 destroyed, 2 destruction failed, 75 destruction accepted but compl
     static flags = {
         force: Flags.boolean({
             description: 'Force Stack destruction (skip confirmation)',
-            aliases: ['f'],
+            char: 'f',
             default: false,
         }),
         'project-id': Flags.string({

package/dist/commands/blueprints/info.d.ts

@@ -8,6 +8,7 @@ export default class InfoCommand extends ResolvedCommand<typeof InfoCommand> {
         stack: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'project-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'organization-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<Record<string, unknown> | undefined>;
 }

package/dist/commands/blueprints/info.js

@@ -23,6 +23,11 @@ Run 'blueprints stacks' to see all available Stacks in your project or organizat
         }),
         'project-id': Flags.string({ ...projectIdFlagConfig }),
         'organization-id': Flags.string({ ...organizationIdFlagConfig }),
+        verbose: Flags.boolean({
+            char: 'v',
+            description: 'Show resource and external IDs',
+            default: false,
+        }),
     };
     async run() {
         const result = await blueprintInfoCore({

package/dist/commands/blueprints/init.js

@@ -6,10 +6,9 @@ import { validTokenOrErrorMessage } from '../../utils/validated-token.js';
 export default class InitCommand extends RuntimeCommand {
     static summary = 'Initialize a Blueprint and create a remote Stack';
     static description = `A Blueprint is your local infrastructure-as-code configuration that defines Sanity resources (datasets, functions, etc.). A Stack is the remote deployment target where your Blueprint is applied.
-[NOTE: Currently, accounts are limited to three (3) Stacks per project scope.]
 
 This is typically the first command you run in a new project. It creates a local Blueprint manifest file (sanity.blueprint.ts, .js, or .json) and provisions a new remote Stack.
-Additionally, a Blueprint configuration file is created in .sanity/ containing the scope and Stack IDs. This is .gitignored by default.
+Additionally, a Blueprint configuration file is created in .sanity/ containing the scope and Stack IDs. A .gitignore covering node_modules, .env, and Function build output is created or updated; the .sanity/ config itself is not ignored.
 
 After initialization, use 'blueprints plan' to preview changes, then 'blueprints deploy' to apply them.
 

package/dist/commands/blueprints/logs.js

@@ -28,6 +28,7 @@ If you're not seeing expected logs, verify your Stack is deployed with 'blueprin
             char: 'w',
             description: 'Watch for new Stack logs',
             aliases: ['follow'],
+            exclusive: ['json'],
         }),
         limit: Flags.integer({
             char: 'l',

package/dist/commands/functions/add.js

@@ -23,7 +23,7 @@ After adding, use 'functions dev' to test locally, then 'blueprints deploy' to p
         example: Flags.string({
             description: 'Example to use for the Function',
             aliases: ['recipe'],
-            exclusive: ['name', 'fn-type', 'language', 'javascript', 'fn-helpers', 'fn-installer'],
+            exclusive: ['name', 'type', 'language', 'javascript', 'helpers', 'installer', 'install'],
         }),
         name: Flags.string({
             description: 'Name of the Function to add',
@@ -56,9 +56,9 @@ After adding, use 'functions dev' to test locally, then 'blueprints deploy' to p
             options: ['skip', ...INSTALLER_OPTIONS],
         }),
         install: Flags.boolean({
-            description: 'Shortcut for --fn-installer npm',
+            description: 'Shortcut for --installer npm',
             char: 'i',
-            exclusive: ['fn-installer'],
+            exclusive: ['installer'],
         }),
     };
     async run() {

package/dist/commands/functions/dev.js

@@ -9,11 +9,11 @@ export default class DevCommand extends ResolvedCommand {
 
 Open the emulator in your browser to interactively test your functions with the payload editor.
 
-Optionally, set the host and port with the --host and --port flags. Function timeout can be configured with the --timeout flag.
+Optionally, set the host and port with the --host and --port flags. Port 8974 is reserved for the emulator's live-reload WebSocket server. Function timeout can be configured with the --timeout flag.
 
 To invoke a function with the CLI, use 'functions test'.`;
     static examples = [
-        '<%= config.bin %> <%= command.id %> --host 127.0.0.1 --port 8974',
+        '<%= config.bin %> <%= command.id %> --host 127.0.0.1 --port 3333',
         '<%= config.bin %> <%= command.id %> --timeout 60',
     ];
     static flags = {

package/dist/commands/functions/logs.d.ts

@@ -15,5 +15,5 @@ export default class LogsCommand extends ResolvedCommand<typeof LogsCommand> {
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         watch: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    run(): Promise<Record<string, unknown> | undefined>;
+    run(): Promise<void | Record<string, unknown>>;
 }

package/dist/commands/functions/logs.js

@@ -46,6 +46,7 @@ Use --watch (-w) to stream logs in real-time. Use --delete to clear all logs for
             char: 'w',
             description: 'Watch for new logs (streaming mode)',
             aliases: ['follow'],
+            exclusive: ['json'],
         }),
     };
     async run() {
@@ -67,6 +68,8 @@ Use --watch (-w) to stream logs in real-time. Use --delete to clear all logs for
         });
         if (!result.success)
             this.coreError(result);
+        if (result.streaming)
+            return result.streaming;
         return result.json;
     }
 }

package/dist/constants.d.ts

@@ -3,8 +3,10 @@ export declare const SANITY_ACCESS_ROBOT = "sanity.access.robot";
 export declare const SANITY_FUNCTION_PREFIX = "sanity.function.";
 export declare const SANITY_FUNCTION_DOCUMENT = "sanity.function.document";
 export declare const SANITY_FUNCTION_MEDIA_LIBRARY_ASSET = "sanity.function.media-library.asset";
+export declare const SANITY_FUNCTION_PUBSUB = "sanity.function.pubsub";
 export declare const SANITY_FUNCTION_SCHEDULED = "sanity.function.cron";
 export declare const SANITY_FUNCTION_SYNC_TAG_INVALIDATE = "sanity.function.sync-tag-invalidate";
+export declare const SANITY_FUNCTION_DURABLE = "sanity.function.durable";
 export declare const SANITY_PROJECT = "sanity.project";
 export declare const SANITY_PROJECT_CORS = "sanity.project.cors";
 export declare const SANITY_PROJECT_DATASET = "sanity.project.dataset";
@@ -17,6 +19,7 @@ export declare const EVENT_DOCUMENT_DELETE = "document-delete";
 export declare const EVENT_MEDIA_LIBRARY_ASSET_CREATE = "media-library-asset-create";
 export declare const EVENT_MEDIA_LIBRARY_ASSET_UPDATE = "media-library-asset-update";
 export declare const EVENT_MEDIA_LIBRARY_ASSET_DELETE = "media-library-asset-delete";
+export declare const EVENT_PUBSUB = "pub-sub";
 export declare const EVENT_SCHEDULED = "scheduled-function";
 export declare const EVENT_SYNC_TAG_INVALIDATE = "sync-tag-invalidate";
 export declare const MAP_EVENT_TO_FUNCTION_TYPE: {
@@ -27,6 +30,7 @@ export declare const MAP_EVENT_TO_FUNCTION_TYPE: {
     readonly "media-library-asset-create": "sanity.function.media-library.asset";
     readonly "media-library-asset-delete": "sanity.function.media-library.asset";
     readonly "media-library-asset-update": "sanity.function.media-library.asset";
+    readonly "pub-sub": "sanity.function.pubsub";
     readonly "scheduled-function": "sanity.function.cron";
     readonly "sync-tag-invalidate": "sanity.function.sync-tag-invalidate";
 };
@@ -42,6 +46,7 @@ export declare const LABEL_DOCUMENT_DELETE = "Document Delete";
 export declare const LABEL_MEDIA_LIBRARY_ASSET_CREATE = "Media Library Asset Create";
 export declare const LABEL_MEDIA_LIBRARY_ASSET_UPDATE = "Media Library Asset Update";
 export declare const LABEL_MEDIA_LIBRARY_ASSET_DELETE = "Media Library Asset Delete";
+export declare const LABEL_PUBSUB = "PubSub";
 export declare const LABEL_SCHEDULED = "Scheduled";
 export declare const LABEL_SYNC_TAG_INVALIDATE = "Sync Tag Invalidate";
 export declare const CI_SETUP_DOCS_URL = "https://www.sanity.io/docs/blueprints/deploy-blueprints-from-ci";

package/dist/constants.js

@@ -3,8 +3,10 @@ export const SANITY_ACCESS_ROBOT = 'sanity.access.robot';
 export const SANITY_FUNCTION_PREFIX = 'sanity.function.';
 export const SANITY_FUNCTION_DOCUMENT = 'sanity.function.document';
 export const SANITY_FUNCTION_MEDIA_LIBRARY_ASSET = 'sanity.function.media-library.asset';
+export const SANITY_FUNCTION_PUBSUB = 'sanity.function.pubsub';
 export const SANITY_FUNCTION_SCHEDULED = 'sanity.function.cron';
 export const SANITY_FUNCTION_SYNC_TAG_INVALIDATE = 'sanity.function.sync-tag-invalidate';
+export const SANITY_FUNCTION_DURABLE = 'sanity.function.durable';
 export const SANITY_PROJECT = 'sanity.project';
 export const SANITY_PROJECT_CORS = 'sanity.project.cors';
 export const SANITY_PROJECT_DATASET = 'sanity.project.dataset';
@@ -17,6 +19,7 @@ export const EVENT_DOCUMENT_DELETE = 'document-delete';
 export const EVENT_MEDIA_LIBRARY_ASSET_CREATE = 'media-library-asset-create';
 export const EVENT_MEDIA_LIBRARY_ASSET_UPDATE = 'media-library-asset-update';
 export const EVENT_MEDIA_LIBRARY_ASSET_DELETE = 'media-library-asset-delete';
+export const EVENT_PUBSUB = 'pub-sub';
 export const EVENT_SCHEDULED = 'scheduled-function';
 export const EVENT_SYNC_TAG_INVALIDATE = 'sync-tag-invalidate';
 export const MAP_EVENT_TO_FUNCTION_TYPE = {
@@ -27,6 +30,7 @@ export const MAP_EVENT_TO_FUNCTION_TYPE = {
     [EVENT_MEDIA_LIBRARY_ASSET_CREATE]: SANITY_FUNCTION_MEDIA_LIBRARY_ASSET,
     [EVENT_MEDIA_LIBRARY_ASSET_DELETE]: SANITY_FUNCTION_MEDIA_LIBRARY_ASSET,
     [EVENT_MEDIA_LIBRARY_ASSET_UPDATE]: SANITY_FUNCTION_MEDIA_LIBRARY_ASSET,
+    [EVENT_PUBSUB]: SANITY_FUNCTION_PUBSUB,
     [EVENT_SCHEDULED]: SANITY_FUNCTION_SCHEDULED,
     [EVENT_SYNC_TAG_INVALIDATE]: SANITY_FUNCTION_SYNC_TAG_INVALIDATE,
 };
@@ -35,6 +39,7 @@ export const PROJECT_SCOPED_FUNCTION_TYPES = new Set([
     SANITY_FUNCTION_DOCUMENT,
     SANITY_FUNCTION_MEDIA_LIBRARY_ASSET,
     SANITY_FUNCTION_SYNC_TAG_INVALIDATE,
+    SANITY_FUNCTION_DURABLE,
 ]);
 export const ORGANIZATION_SCOPED_FUNCTION_TYPES = new Set([
     SANITY_FUNCTION_SCHEDULED,
@@ -47,6 +52,7 @@ export const LABEL_DOCUMENT_DELETE = 'Document Delete';
 export const LABEL_MEDIA_LIBRARY_ASSET_CREATE = 'Media Library Asset Create';
 export const LABEL_MEDIA_LIBRARY_ASSET_UPDATE = 'Media Library Asset Update';
 export const LABEL_MEDIA_LIBRARY_ASSET_DELETE = 'Media Library Asset Delete';
+export const LABEL_PUBSUB = 'PubSub';
 export const LABEL_SCHEDULED = 'Scheduled';
 export const LABEL_SYNC_TAG_INVALIDATE = 'Sync Tag Invalidate';
 export const CI_SETUP_DOCS_URL = 'https://www.sanity.io/docs/blueprints/deploy-blueprints-from-ci';

package/dist/cores/blueprints/deploy.js

@@ -3,22 +3,23 @@ import { preDeploy } from '../../actions/blueprints/pre-deploy.js';
 import { getStack, updateStack } from '../../actions/blueprints/stacks.js';
 import { waitForOperation } from '../../actions/blueprints/wait-for-operation.js';
 import { checkUserPermission } from '../../actions/sanity/access.js';
+import { extractDurableConfig } from '../../utils/blueprints/extract-durable-config.js';
 import { createHintCollector } from '../../utils/blueprints/hints.js';
-import { niceId } from '../../utils/display/presenters.js';
+import { check, niceId, severe } from '../../utils/display/presenters.js';
 import { CODE_OPERATION_UNCONFIRMED, EXIT_OPERATION_UNCONFIRMED } from '../../utils/exit-codes.js';
 import { styleText } from '../../utils/style-text.js';
 import { getWarnings } from '../../utils/warnings.js';
 export async function blueprintDeployCore(options) {
-    const { bin = 'sanity', log, auth, stackId, scopeType, scopeId, deployedStack, blueprint, flags, } = options;
+    const { bin = 'sanity', log: logger, auth, stackId, scopeType, scopeId, deployedStack, blueprint, flags, } = options;
     const { verbose } = flags;
     const noWait = flags['no-wait'] || false;
     const stackName = flags['new-stack-name'] ?? deployedStack.name;
     const installer = flags['fn-installer'] || undefined;
     const blueprintFileDir = dirname(blueprint.fileInfo.blueprintFilePath);
     const workspaceWarnings = getWarnings({ dir: blueprintFileDir });
-    log(`Deploying "${stackName}" ${niceId(deployedStack.id)}...`);
+    logger(`Deploying "${stackName}" ${niceId(deployedStack.id)}...`);
     try {
-        const { ok: checkOk, stack: currentStack } = await getStack({ stackId, auth, logger: log });
+        const { ok: checkOk, stack: currentStack } = await getStack({ stackId, auth, logger });
         if (!checkOk) {
             return { success: false, error: 'Failed to check current Stack status' };
         }
@@ -34,23 +35,24 @@ export async function blueprintDeployCore(options) {
             };
         }
         const resources = [...blueprint.resources];
+        await extractDurableConfig(resources, blueprintFileDir);
         const preDeployResult = await preDeploy({
             scopeType,
             scopeId,
-            resources,
+            resources, // mutated by preDeploy
             stackId,
             stackName,
             auth,
             blueprintFileDir,
             installer,
-            log,
+            logger,
             bin,
             verbose,
+            onAssetEvent: createAssetEventHandler(logger),
         });
-        if (!preDeployResult?.success) {
+        if (!preDeployResult?.success)
             return preDeployResult;
-        }
-        const spinner = log.ora('Deploying...').start();
+        const deploySpinner = logger.ora('Deploying...').start();
         const { ok: deployOk, stack, error: deployError, } = await updateStack({
             stackId,
             stackMutation: {
@@ -61,10 +63,10 @@ export async function blueprintDeployCore(options) {
                 userMessage: flags.message,
             },
             auth,
-            logger: log,
+            logger,
         });
         if (!deployOk) {
-            spinner.fail(`${styleText('red', 'Failed')} to update Stack deployment`);
+            deploySpinner.fail(`${styleText('red', 'Failed')} to update Stack deployment`);
             const hints = createHintCollector(bin);
             if (deployError) {
                 hints.inspectMessage(deployError);
@@ -79,18 +81,18 @@ export async function blueprintDeployCore(options) {
                 ],
             };
         }
-        spinner.stop().clear();
+        deploySpinner.stop().clear();
         const legacyPermissionsNoticePromise = CHECK_LEGACY_DEPLOY_PERMISSION
             ? checkLegacyDeployPermission({
                 auth,
                 scopeType,
                 scopeId,
-                log,
+                log: logger,
             })
             : Promise.resolve(null);
         if (noWait) {
-            log(styleText(['bold', 'green'], 'Stack deployment started!'));
-            log(`Use \`npx ${bin} blueprints info\` to check status`);
+            logger(styleText(['bold', 'green'], 'Stack deployment started!'));
+            logger(`Use \`npx ${bin} blueprints info\` to check status`);
             const legacyWarning = await legacyPermissionsNoticePromise;
             const warnings = [...(legacyWarning ? [legacyWarning] : []), ...workspaceWarnings];
             return {
@@ -100,19 +102,19 @@ export async function blueprintDeployCore(options) {
                 warnings: warnings.length ? warnings : undefined,
             };
         }
-        log(styleText('dim', 'Stack deployment progress:'));
-        log('');
+        logger(styleText('dim', 'Stack deployment progress:'));
+        logger('');
         const outcome = await waitForOperation({
             stackId,
             operationId: stack.operationId,
             auth,
-            log,
+            log: logger,
             bin,
             verbose,
             progressNoun: 'deployment',
         });
         if (outcome.type === 'completed') {
-            log(styleText(['bold', 'green'], 'Stack deployment completed!'));
+            logger(styleText(['bold', 'green'], 'Stack deployment completed!'));
             const legacyWarning = await legacyPermissionsNoticePromise;
             const warnings = [...(legacyWarning ? [legacyWarning] : []), ...workspaceWarnings];
             return {
@@ -151,6 +153,56 @@ export async function blueprintDeployCore(options) {
         return { success: false, error: errorMessage };
     }
 }
+function createAssetEventHandler(logger) {
+    let spinner;
+    const results = [];
+    return (event) => {
+        switch (event.type) {
+            case 'progress': {
+                const { completed, total, slow } = event.progress;
+                const text = [
+                    `Processing assets (${completed}/${total})`,
+                    slow ? ', this can take a moment' : '',
+                ].join('');
+                if (spinner)
+                    spinner.text = text;
+                else
+                    spinner = logger.ora(text).start();
+                return;
+            }
+            case 'result': {
+                results.push(event.result);
+                return;
+            }
+            case 'complete': {
+                spinner?.stop();
+                spinner = undefined;
+                break;
+            }
+        }
+        // done. print report
+        for (const result of results) {
+            const { resource } = result;
+            if (!result.success) {
+                const summary = result.failureKind === 'upload'
+                    ? `Failed uploading ${resource.name} asset`
+                    : `Failed processing ${resource.name} asset`;
+                logger(` ${severe(summary)}`);
+                logger.error(`   ${result.error}`);
+                continue;
+            }
+            logger(` ${check(`${resource.name} ${niceId(resource.src)}`)}`);
+            logger(`   Source: ${resource.src}`);
+            if (result.hash) {
+                const hash = result.hash;
+                const h = hash.length > 24 ? `${hash.slice(0, 8)}...${hash.slice(-12)}` : hash;
+                logger.verbose(`   Hash: ${h}`);
+            }
+            if (result.exists)
+                logger.verbose('   Asset unchanged');
+        }
+    };
+}
 const CHECK_LEGACY_DEPLOY_PERMISSION = false;
 const BLUEPRINTS_PERMISSION_ENFORCEMENT_DATE = 'July 1, 2026';
 async function checkLegacyDeployPermission({ auth, scopeType, scopeId, log, }) {

package/dist/cores/blueprints/plan.js

@@ -1,5 +1,6 @@
 import { dirname } from 'node:path';
 import { planStack, resolveStackIdByNameOrId } from '../../actions/blueprints/stacks.js';
+import { extractDurableConfig } from '../../utils/blueprints/extract-durable-config.js';
 import { createHintCollector } from '../../utils/blueprints/hints.js';
 import { formatDeploymentPlan, formatResourceTree, hasActionableChanges, } from '../../utils/display/blueprints-formatting.js';
 import { styleText } from '../../utils/style-text.js';
@@ -9,6 +10,7 @@ export async function blueprintPlanCore(options) {
     const { verbose: _verbose = false } = flags;
     const { scopeType, scopeId, stackId: blueprintStackId, parsedBlueprint, resources, fileInfo, } = blueprint;
     log(`${styleText(['bold', 'blueBright'], 'Local Blueprint')} ${styleText('dim', `(${fileInfo.fileName})`)}`);
+    await extractDurableConfig(resources, dirname(fileInfo.blueprintFilePath));
     log(formatResourceTree(resources));
     if (!token || !scopeType || !scopeId) {
         log(styleText('dim', 'Unable to retrieve live Stack deployment for comparison'));

package/dist/cores/functions/add.js

@@ -5,7 +5,7 @@ import { checkbox, confirm, input, select } from '@inquirer/prompts';
 import { highlight } from 'cardinal';
 import { createFunctionResource } from '../../actions/blueprints/resources.js';
 import { verifyExampleExists, writeExample } from '../../actions/sanity/examples.js';
-import { EVENT_DOCUMENT_CREATE, EVENT_DOCUMENT_DELETE, EVENT_DOCUMENT_UPDATE, EVENT_MEDIA_LIBRARY_ASSET_CREATE, EVENT_MEDIA_LIBRARY_ASSET_DELETE, EVENT_MEDIA_LIBRARY_ASSET_UPDATE, EVENT_SCHEDULED, EVENT_SYNC_TAG_INVALIDATE, FUNCTION_TYPES, LABEL_DOCUMENT_CREATE, LABEL_DOCUMENT_DELETE, LABEL_DOCUMENT_UPDATE, LABEL_MEDIA_LIBRARY_ASSET_CREATE, LABEL_MEDIA_LIBRARY_ASSET_DELETE, LABEL_MEDIA_LIBRARY_ASSET_UPDATE, LABEL_SCHEDULED, LABEL_SYNC_TAG_INVALIDATE, MAP_EVENT_TO_FUNCTION_TYPE, SANITY_FUNCTION_DOCUMENT, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET, SANITY_FUNCTION_SCHEDULED, SANITY_FUNCTION_SYNC_TAG_INVALIDATE, } from '../../constants.js';
+import { EVENT_DOCUMENT_CREATE, EVENT_DOCUMENT_DELETE, EVENT_DOCUMENT_UPDATE, EVENT_MEDIA_LIBRARY_ASSET_CREATE, EVENT_MEDIA_LIBRARY_ASSET_DELETE, EVENT_MEDIA_LIBRARY_ASSET_UPDATE, EVENT_PUBSUB, EVENT_SCHEDULED, EVENT_SYNC_TAG_INVALIDATE, FUNCTION_TYPES, LABEL_DOCUMENT_CREATE, LABEL_DOCUMENT_DELETE, LABEL_DOCUMENT_UPDATE, LABEL_MEDIA_LIBRARY_ASSET_CREATE, LABEL_MEDIA_LIBRARY_ASSET_DELETE, LABEL_MEDIA_LIBRARY_ASSET_UPDATE, LABEL_PUBSUB, LABEL_SCHEDULED, LABEL_SYNC_TAG_INVALIDATE, MAP_EVENT_TO_FUNCTION_TYPE, SANITY_FUNCTION_DOCUMENT, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET, SANITY_FUNCTION_PUBSUB, SANITY_FUNCTION_SCHEDULED, SANITY_FUNCTION_SYNC_TAG_INVALIDATE, } from '../../constants.js';
 import { check, indent, warn } from '../../utils/display/presenters.js';
 import { validateFunctionName } from '../../utils/functions/validate-name.js';
 import { styleText } from '../../utils/style-text.js';
@@ -21,6 +21,9 @@ export const generateFunctionBlueprintResourceTemplate = (fnName, eventNames) =>
         case SANITY_FUNCTION_MEDIA_LIBRARY_ASSET:
             definer = `defineMediaLibraryAssetFunction({name: '${fnName}', event: {on: [${eventOns.join(', ')}], resource: {type: 'media-library', id: 'my-media-library-id'}}}), // ← add this line`;
             break;
+        case SANITY_FUNCTION_PUBSUB:
+            definer = `definePubSubFunction({name: '${fnName}'}), // ← add this line`;
+            break;
         case SANITY_FUNCTION_SCHEDULED:
             definer = `defineScheduledFunction({name: '${fnName}', event: {expression: '0 0 * * *'}}), // ← add this line`;
             break;
@@ -158,7 +161,7 @@ export async function functionAddCore(options) {
         }
         const eventSources = new Set(fnTypes.map((t) => t.substring(0, t.lastIndexOf('-'))));
         if (eventSources.size > 1) {
-            throw new Error('Invalid function type. Cannot mix document-*, media-library-asset-*, sync-tag-* and/or scheduled-* types.');
+            throw new Error('Invalid function type. Cannot mix document-*, media-library-asset-*, pub-sub, sync-tag-* and/or scheduled-* types.');
         }
         let addHelpers;
         let installCommand;
@@ -224,7 +227,7 @@ async function promptForFunctionName() {
     const functionName = await input({
         message: 'Enter function name:',
         validate: (input) => validateFunctionName(input) ||
-            'Invalid function name. Must be 6+ characters, no special characters, no spaces',
+            'Invalid function name. Must be 3+ characters, no special characters, no spaces',
     });
     return functionName;
 }
@@ -242,6 +245,7 @@ async function promptForFunctionType() {
             { name: LABEL_MEDIA_LIBRARY_ASSET_CREATE, value: EVENT_MEDIA_LIBRARY_ASSET_CREATE },
             { name: LABEL_MEDIA_LIBRARY_ASSET_UPDATE, value: EVENT_MEDIA_LIBRARY_ASSET_UPDATE },
             { name: LABEL_MEDIA_LIBRARY_ASSET_DELETE, value: EVENT_MEDIA_LIBRARY_ASSET_DELETE },
+            { name: LABEL_PUBSUB, value: EVENT_PUBSUB },
             { name: LABEL_SCHEDULED, value: EVENT_SCHEDULED },
             { name: LABEL_SYNC_TAG_INVALIDATE, value: EVENT_SYNC_TAG_INVALIDATE },
         ],
@@ -249,11 +253,10 @@ async function promptForFunctionType() {
             if (choices.length === 0) {
                 return 'You must choose at least one function type / document change event';
             }
-            const hasMedia = choices.some((c) => String(c.value).startsWith('media-library'));
-            const hasDocument = choices.some((c) => String(c.value).startsWith('document'));
-            const hasSchedule = choices.some((c) => String(c.value).startsWith('scheduled'));
-            if ((hasMedia && hasDocument) || (hasMedia && hasSchedule) || (hasDocument && hasSchedule)) {
-                return 'You cannot mix Document, Media Library Asset, and Scheduled events together in one Function';
+            // same grouping as the check in functionAddCore, so the prompt cannot drift from it
+            const eventSources = new Set(choices.map((c) => String(c.value).substring(0, String(c.value).lastIndexOf('-'))));
+            if (eventSources.size > 1) {
+                return 'You cannot mix Document, Media Library Asset, PubSub, Scheduled, and Sync Tag Invalidate events together in one Function';
             }
             return true;
         },

package/dist/server/static/components/api-base.js

@@ -9,6 +9,7 @@ export class ApiBaseElement extends HTMLElement {
     this.api = api
     this.SANITY_FUNCTION_DOCUMENT = 'sanity.function.document'
     this.SANITY_FUNCTION_MEDIA_LIBRARY_ASSET = 'sanity.function.media-library.asset'
+    this.SANITY_FUNCTION_PUBSUB = 'sanity.function.pubsub'
     this.SANITY_FUNCTION_SCHEDULED = 'sanity.function.cron'
     this.SANITY_FUNCTION_SYNC_TAG_INVALIDATE = 'sanity.function.sync-tag-invalidate'
   }

package/dist/server/static/components/filters.js

@@ -79,6 +79,7 @@ class FiltersComponent extends ApiBaseElement {
     const mediaFunction = this.api.store.selectedFunctionType?.startsWith(
       this.SANITY_FUNCTION_MEDIA_LIBRARY_ASSET,
     )
+    const pubsubFunction = this.api.store.selectedFunctionType === this.SANITY_FUNCTION_PUBSUB
     const scheduleFunction = this.api.store.selectedFunctionType === this.SANITY_FUNCTION_SCHEDULED
     const stiFunction =
       this.api.store.selectedFunctionType === this.SANITY_FUNCTION_SYNC_TAG_INVALIDATE
@@ -89,15 +90,16 @@ class FiltersComponent extends ApiBaseElement {
       mediaFunction,
       scheduleFunction,
       stiFunction,
+      pubsubFunction,
     )
   }
 
-  buildFilters = (docFunction, mediaFunction, scheduleFunction, stiFunction) => {
+  buildFilters = (docFunction, mediaFunction, scheduleFunction, stiFunction, pubsubFunction) => {
     return `
     <legend class="config-label">Client Options</legend>
     <div id="dynamic-dropdowns" class="flex gap-2">
       ${
-        docFunction || scheduleFunction || stiFunction
+        docFunction || scheduleFunction || stiFunction || pubsubFunction
           ? `<select-dropdown
         label="Project"
         store-key="projects"

package/dist/server/static/components/payload-panel.js

@@ -164,6 +164,9 @@ class PayloadPanel extends ApiBaseElement {
     const payloadTitle = this.shadowRoot.querySelector('#payloadTitle')
     let title = 'Document'
     switch (selectedFunctionType) {
+      case this.SANITY_FUNCTION_PUBSUB:
+        title = 'PubSub Payload'
+        break
       case this.SANITY_FUNCTION_SYNC_TAG_INVALIDATE:
         title = 'Sync Tag Payload'
         break

package/dist/utils/blueprints/extract-durable-config.d.ts

@@ -0,0 +1,8 @@
+import { type BlueprintResource } from '@sanity/blueprints';
+/**
+ * Extracts the blueprint config from the function source code and mutates it to the resource object.
+ * This is used for durable functions that may not have a config defined in the blueprint.
+ * @param resources
+ * @param blueprintFileDir
+ */
+export declare const extractDurableConfig: (resources: BlueprintResource[], blueprintFileDir: string) => Promise<void>;