@sanity/runtime-cli 14.11.0 → 14.12.1

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

@@ -1,5 +1,6 @@
-import { LocalBlueprintCommand } from '../../baseCommands.js';
-export default class AddCommand extends LocalBlueprintCommand<typeof AddCommand> {
+import { ResolvedCommand } from '../../baseCommands.js';
+export default class AddCommand extends ResolvedCommand<typeof AddCommand> {
+    static needs: readonly ["blueprint"];
     static summary: string;
     static description: string;
     static examples: string[];

package/dist/commands/functions/add.js

@@ -1,14 +1,15 @@
 import { Flags } from '@oclif/core';
-import { LocalBlueprintCommand } from '../../baseCommands.js';
+import { ResolvedCommand } from '../../baseCommands.js';
 import { FUNCTION_TYPES } from '../../constants.js';
 import { functionAddCore } from '../../cores/functions/index.js';
 import { Logger } from '../../utils/logger.js';
 import { INSTALLER_OPTIONS } from '../../utils/types.js';
-export default class AddCommand extends LocalBlueprintCommand {
+export default class AddCommand extends ResolvedCommand {
+    static needs = ['blueprint'];
     static summary = 'Add a Function to your Blueprint';
     static description = `Scaffolds a new Function in the functions/ folder and templates a resource for your Blueprint manifest.
 
-Functions are serverless handlers triggered by document events (create, update, delete, publish) or media library events.
+Functions are serverless handlers triggered by document, live content or media-library events (create, update, delete, publish).
 
 After adding, use 'functions dev' to test locally, then 'blueprints deploy' to publish.`;
     static examples = [

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

@@ -1,5 +1,6 @@
-import { LocalBlueprintCommand } from '../../baseCommands.js';
-export default class BuildCommand extends LocalBlueprintCommand<typeof BuildCommand> {
+import { ResolvedCommand } from '../../baseCommands.js';
+export default class BuildCommand extends ResolvedCommand<typeof BuildCommand> {
+    static needs: readonly ["blueprint"];
     static summary: string;
     static hidden: boolean;
     static args: {

package/dist/commands/functions/build.js

@@ -1,9 +1,10 @@
 import { Args, Flags } from '@oclif/core';
-import { LocalBlueprintCommand } from '../../baseCommands.js';
+import { ResolvedCommand } from '../../baseCommands.js';
 import { functionBuildCore } from '../../cores/functions/build.js';
 import { Logger } from '../../utils/logger.js';
 import { INSTALLER_OPTIONS } from '../../utils/types.js';
-export default class BuildCommand extends LocalBlueprintCommand {
+export default class BuildCommand extends ResolvedCommand {
+    static needs = ['blueprint'];
     static summary = 'Build Sanity Function(s) to zip archives';
     static hidden = true;
     static args = {

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

@@ -1,5 +1,6 @@
-import { LocalBlueprintCommand } from '../../baseCommands.js';
-export default class DevCommand extends LocalBlueprintCommand<typeof DevCommand> {
+import { ResolvedCommand } from '../../baseCommands.js';
+export default class DevCommand extends ResolvedCommand<typeof DevCommand> {
+    static needs: readonly ["blueprint"];
     static summary: string;
     static description: string;
     static examples: string[];

package/dist/commands/functions/dev.js

@@ -1,8 +1,9 @@
 import { Flags } from '@oclif/core';
-import { LocalBlueprintCommand } from '../../baseCommands.js';
+import { ResolvedCommand } from '../../baseCommands.js';
 import { functionDevCore } from '../../cores/functions/dev.js';
 import { Logger } from '../../utils/logger.js';
-export default class DevCommand extends LocalBlueprintCommand {
+export default class DevCommand extends ResolvedCommand {
+    static needs = ['blueprint'];
     static summary = 'Start the Sanity Function emulator';
     static description = `Runs a local, web-based development server to test your functions before deploying.
 

package/dist/commands/functions/env/add.d.ts

@@ -1,5 +1,6 @@
-import { DeployedStackCommand } from '../../../baseCommands.js';
-export default class EnvAddCommand extends DeployedStackCommand<typeof EnvAddCommand> {
+import { ResolvedCommand } from '../../../baseCommands.js';
+export default class EnvAddCommand extends ResolvedCommand<typeof EnvAddCommand> {
+    static needs: readonly ["deployedStack", "blueprint"];
     static summary: string;
     static description: string;
     static args: {

package/dist/commands/functions/env/add.js

@@ -1,8 +1,9 @@
 import { Args } from '@oclif/core';
-import { DeployedStackCommand } from '../../../baseCommands.js';
+import { ResolvedCommand } from '../../../baseCommands.js';
 import { functionEnvAddCore } from '../../../cores/functions/env/add.js';
 import { Logger } from '../../../utils/logger.js';
-export default class EnvAddCommand extends DeployedStackCommand {
+export default class EnvAddCommand extends ResolvedCommand {
+    static needs = ['deployedStack', 'blueprint'];
     static summary = 'Add or set an environment variable for a deployed function';
     static description = `Sets an environment variable in a deployed Sanity Function. If the variable already exists, its value is updated.
 

package/dist/commands/functions/env/list.d.ts

@@ -1,5 +1,6 @@
-import { DeployedStackCommand } from '../../../baseCommands.js';
-export default class EnvListCommand extends DeployedStackCommand<typeof EnvListCommand> {
+import { ResolvedCommand } from '../../../baseCommands.js';
+export default class EnvListCommand extends ResolvedCommand<typeof EnvListCommand> {
+    static needs: readonly ["deployedStack", "blueprint"];
     static summary: string;
     static description: string;
     static args: {

package/dist/commands/functions/env/list.js

@@ -1,8 +1,9 @@
 import { Args } from '@oclif/core';
-import { DeployedStackCommand } from '../../../baseCommands.js';
+import { ResolvedCommand } from '../../../baseCommands.js';
 import { functionEnvListCore } from '../../../cores/functions/env/list.js';
 import { Logger } from '../../../utils/logger.js';
-export default class EnvListCommand extends DeployedStackCommand {
+export default class EnvListCommand extends ResolvedCommand {
+    static needs = ['deployedStack', 'blueprint'];
     static summary = 'List environment variables for a deployed function';
     static description = `Displays all environment variables (keys only) configured in a deployed Sanity Function.
 

package/dist/commands/functions/env/remove.d.ts

@@ -1,5 +1,6 @@
-import { DeployedStackCommand } from '../../../baseCommands.js';
-export default class EnvRemoveCommand extends DeployedStackCommand<typeof EnvRemoveCommand> {
+import { ResolvedCommand } from '../../../baseCommands.js';
+export default class EnvRemoveCommand extends ResolvedCommand<typeof EnvRemoveCommand> {
+    static needs: readonly ["deployedStack", "blueprint"];
     static summary: string;
     static description: string;
     static args: {

package/dist/commands/functions/env/remove.js

@@ -1,8 +1,9 @@
 import { Args } from '@oclif/core';
-import { DeployedStackCommand } from '../../../baseCommands.js';
+import { ResolvedCommand } from '../../../baseCommands.js';
 import { functionEnvRemoveCore } from '../../../cores/functions/env/remove.js';
 import { Logger } from '../../../utils/logger.js';
-export default class EnvRemoveCommand extends DeployedStackCommand {
+export default class EnvRemoveCommand extends ResolvedCommand {
+    static needs = ['deployedStack', 'blueprint'];
     static summary = 'Remove an environment variable from a deployed function';
     static description = `Deletes an environment variable from a deployed Sanity Function. The change takes effect on the next function invocation.
 

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

@@ -1,5 +1,6 @@
-import { DeployedStackCommand } from '../../baseCommands.js';
-export default class LogsCommand extends DeployedStackCommand<typeof LogsCommand> {
+import { ResolvedCommand } from '../../baseCommands.js';
+export default class LogsCommand extends ResolvedCommand<typeof LogsCommand> {
+    static needs: readonly ["deployedStack", "blueprint"];
     static summary: string;
     static description: string;
     static args: {

package/dist/commands/functions/logs.js

@@ -1,8 +1,9 @@
 import { Args, Flags } from '@oclif/core';
-import { DeployedStackCommand, stackFlag, unhide } from '../../baseCommands.js';
+import { ResolvedCommand, stackFlagConfig } from '../../baseCommands.js';
 import { functionLogsCore } from '../../cores/functions/logs.js';
 import { Logger } from '../../utils/logger.js';
-export default class LogsCommand extends DeployedStackCommand {
+export default class LogsCommand extends ResolvedCommand {
+    static needs = ['deployedStack', 'blueprint'];
     static summary = 'Retrieve or delete logs for a Sanity Function';
     static description = `Fetches execution logs from a deployed function, useful for debugging production issues or monitoring activity.
 
@@ -17,7 +18,7 @@ Use --watch (-w) to stream logs in real-time. Use --delete to clear all logs for
         '<%= config.bin %> <%= command.id %> <name> --delete',
     ];
     static flags = {
-        stack: unhide(stackFlag),
+        stack: Flags.string({ ...stackFlagConfig }),
         limit: Flags.integer({
             char: 'l',
             description: 'Total number of log entries to retrieve',

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

@@ -1,5 +1,6 @@
-import { LocalBlueprintCommand } from '../../baseCommands.js';
-export default class TestCommand extends LocalBlueprintCommand<typeof TestCommand> {
+import { ResolvedCommand } from '../../baseCommands.js';
+export default class TestCommand extends ResolvedCommand<typeof TestCommand> {
+    static needs: readonly ["blueprint"];
     static summary: string;
     static description: string;
     static args: {

package/dist/commands/functions/test.js

@@ -1,8 +1,9 @@
 import { Args, Flags } from '@oclif/core';
-import { LocalBlueprintCommand, organizationIdFlagConfig, projectIdFlagConfig, } from '../../baseCommands.js';
+import { organizationIdFlagConfig, projectIdFlagConfig, ResolvedCommand } from '../../baseCommands.js';
 import { functionTestCore } from '../../cores/functions/test.js';
 import { Logger } from '../../utils/logger.js';
-export default class TestCommand extends LocalBlueprintCommand {
+export default class TestCommand extends ResolvedCommand {
+    static needs = ['blueprint'];
     static summary = 'Invoke a local Sanity Function';
     static description = `Executes a function locally with the provided payload, simulating how it would run when deployed. Use this to test your function logic before deploying.
 

package/dist/constants.d.ts

@@ -17,8 +17,20 @@ export declare const EVENT_MEDIA_LIBRARY_ASSET_CREATE = "media-library-asset-cre
 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_SCHEDULED = "scheduled-function";
-export declare const FUNCTION_TYPES: readonly ["document-publish", "document-create", "document-update", "document-delete", "media-library-asset-create", "media-library-asset-update", "media-library-asset-delete", "scheduled-function"];
-export type ARRAY_OF_FUNCTION_TYPES = (typeof FUNCTION_TYPES)[number][];
+export declare const EVENT_SYNC_TAG_INVALIDATE = "sync-tag-invalidate";
+export declare const MAP_EVENT_TO_FUNCTION_TYPE: {
+    readonly "document-publish": "sanity.function.document";
+    readonly "document-create": "sanity.function.document";
+    readonly "document-delete": "sanity.function.document";
+    readonly "document-update": "sanity.function.document";
+    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 "scheduled-function": "sanity.function.cron";
+    readonly "sync-tag-invalidate": "sanity.function.sync-tag-invalidate";
+};
+export declare const FUNCTION_TYPES: (keyof typeof MAP_EVENT_TO_FUNCTION_TYPE)[];
+export type ARRAY_OF_FUNCTION_TYPES = typeof FUNCTION_TYPES;
 export declare const PROJECT_SCOPED_FUNCTION_TYPES: ReadonlySet<string>;
 export declare const ORGANIZATION_SCOPED_FUNCTION_TYPES: ReadonlySet<string>;
 export declare const MAX_ASSET_SIZE = 209715200;
@@ -30,3 +42,4 @@ export declare const LABEL_MEDIA_LIBRARY_ASSET_CREATE = "Media Library Asset Cre
 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_SCHEDULED = "Scheduled";
+export declare const LABEL_SYNC_TAG_INVALIDATE = "Sync Tag Invalidate";

package/dist/constants.js

@@ -17,16 +17,19 @@ 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_SCHEDULED = 'scheduled-function';
-export const FUNCTION_TYPES = [
-    EVENT_DOCUMENT_PUBLISH,
-    EVENT_DOCUMENT_CREATE,
-    EVENT_DOCUMENT_UPDATE,
-    EVENT_DOCUMENT_DELETE,
-    EVENT_MEDIA_LIBRARY_ASSET_CREATE,
-    EVENT_MEDIA_LIBRARY_ASSET_UPDATE,
-    EVENT_MEDIA_LIBRARY_ASSET_DELETE,
-    EVENT_SCHEDULED,
-];
+export const EVENT_SYNC_TAG_INVALIDATE = 'sync-tag-invalidate';
+export const MAP_EVENT_TO_FUNCTION_TYPE = {
+    [EVENT_DOCUMENT_PUBLISH]: SANITY_FUNCTION_DOCUMENT,
+    [EVENT_DOCUMENT_CREATE]: SANITY_FUNCTION_DOCUMENT,
+    [EVENT_DOCUMENT_DELETE]: SANITY_FUNCTION_DOCUMENT,
+    [EVENT_DOCUMENT_UPDATE]: SANITY_FUNCTION_DOCUMENT,
+    [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_SCHEDULED]: SANITY_FUNCTION_SCHEDULED,
+    [EVENT_SYNC_TAG_INVALIDATE]: SANITY_FUNCTION_SYNC_TAG_INVALIDATE,
+};
+export const FUNCTION_TYPES = Object.keys(MAP_EVENT_TO_FUNCTION_TYPE);
 export const PROJECT_SCOPED_FUNCTION_TYPES = new Set([
     SANITY_FUNCTION_DOCUMENT,
     SANITY_FUNCTION_MEDIA_LIBRARY_ASSET,
@@ -44,3 +47,4 @@ 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_SCHEDULED = 'Scheduled';
+export const LABEL_SYNC_TAG_INVALIDATE = 'Sync Tag Invalidate';

package/dist/cores/blueprints/config.js

@@ -9,10 +9,15 @@ export async function blueprintConfigCore(options) {
     const providedConfigFlag = [flagProjectId, flagStack, flagOrganizationId].some(Boolean);
     const { stackId: configStackId, scopeType: configScopeType, scopeId: configScopeId, blueprintConfig, fileInfo, } = blueprint;
     const blueprintFilePath = fileInfo.blueprintFilePath;
+    const hasConfigFile = !!blueprintConfig;
     if (!configStackId && !configScopeType && !configScopeId) {
-        log(warn('Incomplete configuration.'));
+        if (hasConfigFile) {
+            log(warn('Incomplete configuration.'));
+        }
+        else {
+            log('No configuration file found.');
+        }
         if (!editConfig) {
-            // blueprint.json exists but no config JSON
             log(`Run \`npx ${bin} blueprints doctor\` for diagnostics.`);
             return { success: true }; // not necessarily fatal
         }
@@ -61,7 +66,7 @@ export async function blueprintConfigCore(options) {
                 // creates a new config file with the given properties
                 try {
                     const newConfig = writeConfigFile(blueprintFilePath, configUpdate);
-                    printConfig({ configLabel: 'Updated', log, config: newConfig });
+                    printConfig({ configLabel: hasConfigFile ? 'Updated' : 'New', log, config: newConfig });
                     return { success: true, json: { config: newConfig } };
                 }
                 catch {
@@ -98,7 +103,7 @@ export async function blueprintConfigCore(options) {
                 projectId: updatedProjectId,
                 stackId: updatedStackId,
             });
-            printConfig({ configLabel: 'Updated', log, config: newConfig });
+            printConfig({ configLabel: hasConfigFile ? 'Updated' : 'New', log, config: newConfig });
             return { success: true, json: { config: newConfig } };
         }
         catch {

package/dist/cores/blueprints/destroy.js

@@ -8,7 +8,7 @@ import { styleText } from '../../utils/style-text.js';
 export async function blueprintDestroyCore(options) {
     const { bin = 'sanity', log, token, blueprint, flags } = options;
     const { force = false, 'project-id': flagProjectId, 'organization-id': flagOrganizationId, stack: flagStack, 'no-wait': noWait = false, verbose: _verbose = false, } = flags;
-    // 3-flag combo: just destroy it
+    // 3-flag combo: destroy without needing a local blueprint config
     if ((flagProjectId || flagOrganizationId) && flagStack && force) {
         let scopeType;
         let scopeId;
@@ -25,6 +25,7 @@ export async function blueprintDestroyCore(options) {
         }
         const auth = { token, scopeType, scopeId };
         const resolvedId = await resolveStackIdByNameOrId(flagStack, auth, log);
+        const isoNow = new Date().toISOString();
         const { ok, error, stack } = await destroyStack({
             stackId: resolvedId,
             auth,
@@ -32,8 +33,18 @@ export async function blueprintDestroyCore(options) {
         });
         if (!ok)
             return { success: false, error: error || 'Failed to destroy Stack deployment' };
-        log(`Stack deployment "${stack.name}" ${niceId(stack.id)} destroyed`);
-        return { success: true, json: { stackId: stack.id, stackName: stack.name } };
+        if (noWait) {
+            log(styleText(['bold', 'magenta'], 'Stack destruction started!'));
+            return { success: true, json: { stackId: stack.id, stackName: stack.name } };
+        }
+        return waitForDestruction({
+            stackId: stack.id,
+            stackName: stack.name,
+            auth,
+            log,
+            bin,
+            since: isoNow,
+        });
     }
     const { scopeType, scopeId, stackId } = blueprint;
     if (!scopeType || !scopeId)
@@ -103,62 +114,73 @@ export async function blueprintDestroyCore(options) {
             log(styleText(['bold', 'magenta'], 'Stack destruction started!'));
             return { success: true, json: { stackId: stack.id, stackName: stack.name } };
         }
-        log(styleText('dim', 'Stack destruction progress:'));
-        const logHints = createLogHintCollector(bin);
-        let logStreamCleanup = null;
-        try {
-            let lastLogAt = Date.now();
-            let idleMessageShown = false;
-            logStreamCleanup = await setupLogStreaming({
-                stackId: stack.id,
-                after: isoNow,
-                auth,
-                log,
-                onActivity: () => {
-                    lastLogAt = Date.now();
-                },
-                onLogEntry: (logEntry) => logHints.inspect(logEntry),
-            });
-            while (true) {
-                const { ok, stack: currentStack } = await getStack({ stackId: stack.id, auth, logger: log });
-                const operation = currentStack?.recentOperation;
-                if (!ok || !operation || operation?.status === 'COMPLETED') {
-                    // Operation is also marked destroyed when stack is deleted;
-                    // it's possible that the operation is "gone" or available and "COMPLETED"
-                    if (logStreamCleanup)
-                        logStreamCleanup();
-                    log(styleText(['bold', 'magenta'], 'Stack destruction completed!'));
-                    return { success: true, json: { stackId: stack.id, stackName: stack.name } };
-                }
-                if (operation.status === 'FAILED') {
-                    if (logStreamCleanup)
-                        logStreamCleanup();
-                    return {
-                        success: false,
-                        error: 'Stack destruction failed',
-                        suggestions: [
-                            ...logHints.getSuggestions(),
-                            `Run \`npx ${bin} blueprints logs\` to review destruction logs.`,
-                            `Run \`npx ${bin} blueprints info\` to view current Stack status.`,
-                        ],
-                    };
-                }
-                if (!idleMessageShown && Date.now() - lastLogAt > 60_000) {
-                    log(`No new activity for 60 seconds. The destruction is still running on Sanity servers.`);
-                    log(`You can safely exit and check status later with \`npx ${bin} blueprints info\`.`);
-                    idleMessageShown = true;
-                }
-                await sleep(1500);
-            }
-        }
-        catch (error) {
-            if (logStreamCleanup)
-                logStreamCleanup();
-            throw error;
-        }
+        return waitForDestruction({
+            stackId: stack.id,
+            stackName: stack.name,
+            auth,
+            log,
+            bin,
+            since: isoNow,
+        });
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
         return { success: false, error: errorMessage };
     }
 }
+async function waitForDestruction(options) {
+    const { stackId, stackName, auth, log, bin, since } = options;
+    log(styleText('dim', 'Stack destruction progress:'));
+    const logHints = createLogHintCollector(bin);
+    let logStreamCleanup = null;
+    try {
+        let lastLogAt = Date.now();
+        let idleMessageShown = false;
+        logStreamCleanup = await setupLogStreaming({
+            stackId,
+            after: since,
+            auth,
+            log,
+            onActivity: () => {
+                lastLogAt = Date.now();
+            },
+            onLogEntry: (logEntry) => logHints.inspect(logEntry),
+        });
+        while (true) {
+            const { ok, stack: currentStack } = await getStack({ stackId, auth, logger: log });
+            const operation = currentStack?.recentOperation;
+            if (!ok || !operation || operation?.status === 'COMPLETED') {
+                // Operation is also marked destroyed when stack is deleted;
+                // it's possible that the operation is "gone" or available and "COMPLETED"
+                if (logStreamCleanup)
+                    logStreamCleanup();
+                log(styleText(['bold', 'magenta'], 'Stack destruction completed!'));
+                return { success: true, json: { stackId, stackName } };
+            }
+            if (operation.status === 'FAILED') {
+                if (logStreamCleanup)
+                    logStreamCleanup();
+                return {
+                    success: false,
+                    error: 'Stack destruction failed',
+                    suggestions: [
+                        ...logHints.getSuggestions(),
+                        `Run \`npx ${bin} blueprints logs\` to review destruction logs.`,
+                        `Run \`npx ${bin} blueprints info\` to view current Stack status.`,
+                    ],
+                };
+            }
+            if (!idleMessageShown && Date.now() - lastLogAt > 60_000) {
+                log(`No new activity for 60 seconds. The destruction is still running on Sanity servers.`);
+                log(`You can safely exit and check status later with \`npx ${bin} blueprints info\`.`);
+                idleMessageShown = true;
+            }
+            await sleep(1500);
+        }
+    }
+    catch (error) {
+        if (logStreamCleanup)
+            logStreamCleanup();
+        throw error;
+    }
+}

package/dist/cores/blueprints/doctor.js

@@ -2,7 +2,9 @@ import { readFileSync } from 'node:fs';
 import { arch, cwd, env, version as nodeVersion, platform } from 'node:process';
 import * as resolve from 'empathic/resolve';
 import ora from 'ora';
-import { readLocalBlueprint, } from '../../actions/blueprints/blueprint.js';
+import { loadAndParseBlueprint, } from '../../actions/blueprints/blueprint.js';
+import { readConfigFile } from '../../actions/blueprints/config.js';
+import { resolveIds } from '../../actions/blueprints/resolve.js';
 import { getStack } from '../../actions/blueprints/stacks.js';
 import config, { RUNTIME_CLI_VERSION } from '../../config.js';
 import { check, filePathRelativeToCwd, niceId, renderSection, severe, unsure, } from '../../utils/display/presenters.js';
@@ -76,15 +78,27 @@ export async function blueprintDoctorCore(options) {
     // --- BLUEPRINT ---
     let localBlueprint;
     try {
-        localBlueprint = await readLocalBlueprint(log, { resources: options.validateResources || false }, path);
-        envRows.push(['Blueprint', filePathRelativeToCwd(localBlueprint.fileInfo.blueprintFilePath)]);
-        if (localBlueprint.errors.length === 0) {
+        const blueprint = await loadAndParseBlueprint(path, {
+            validateResources: options.validateResources || false,
+        });
+        const blueprintConfig = readConfigFile(blueprint.fileInfo.blueprintFilePath);
+        const resolved = resolveIds({
+            module: blueprint.module,
+            config: blueprintConfig,
+        });
+        localBlueprint = {
+            ...blueprint,
+            blueprintConfig,
+            ...resolved,
+        };
+        envRows.push(['Blueprint', filePathRelativeToCwd(blueprint.fileInfo.blueprintFilePath)]);
+        if (blueprint.errors.length === 0) {
             diagnostics.blueprintValid = { status: true };
         }
         else {
             diagnostics.blueprintValid = {
                 status: false,
-                detail: `${localBlueprint.errors.length} error(s)`,
+                detail: `${blueprint.errors.length} error(s)`,
             };
         }
     }

package/dist/cores/blueprints/init.js

@@ -17,7 +17,7 @@ const SCOPE_PROJECT = 'project';
 const SCOPE_ORGANIZATION = 'organization';
 export async function blueprintInitCore(options) {
     const { bin = 'sanity', log, token, knownProjectId, args, flags, validateResources } = options;
-    const { dir: flagDir, example: flagExample, 'blueprint-type': flagBlueprintType, 'project-id': flagProjectId, 'organization-id': flagOrganizationId, 'stack-id': flagStackId, 'stack-name': flagStackName, verbose: v = false, } = flags;
+    const { dir: flagDir, example: flagExample, 'blueprint-type': flagBlueprintType, 'project-id': flagProjectId, 'organization-id': flagOrganizationId, 'stack-id': flagStackId, 'stack-name': flagStackName, verbose = false, } = flags;
     const { dir: argDir } = args;
     const userProvidedDirName = argDir || flagDir;
     const blueprintDir = userProvidedDirName || '.';
@@ -44,7 +44,7 @@ export async function blueprintInitCore(options) {
                 flagOrganizationId,
                 flagStackId,
                 flagStackName,
-                verbose: v,
+                verbose,
             });
         }
         // --example flag → scaffold from an example template

package/dist/cores/functions/add.js

@@ -5,26 +5,29 @@ 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, 
+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_SYNC_TAG_INVALIDATE, 
 // EVENT_SCHEDULED,
-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, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET, SANITY_FUNCTION_SCHEDULED, } from '../../constants.js';
+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 { check, indent, warn } from '../../utils/display/presenters.js';
 import { styleText } from '../../utils/style-text.js';
 import { validateFunctionName } from '../../utils/validate/resource.js';
 export const generateFunctionBlueprintResourceTemplate = (fnName, eventNames) => {
-    const functionType = eventNames[0].substring(0, eventNames[0].lastIndexOf('-'));
+    const functionType = MAP_EVENT_TO_FUNCTION_TYPE[eventNames[0]];
     let definer = '';
     const eventOns = eventNames.map((e) => `'${e.substring(e.lastIndexOf('-') + 1)}'`);
     switch (functionType) {
-        case 'document':
+        case SANITY_FUNCTION_DOCUMENT:
             definer = `defineDocumentFunction({name: '${fnName}', event: {on: [${eventOns.join(', ')}]}}), // ← add this line`;
             break;
-        case 'media-library-asset':
+        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 'scheduled':
+        case SANITY_FUNCTION_SCHEDULED:
             definer = `defineScheduledFunction({name: '${fnName}', event: {expression: '0 0 * * *'}}), // ← add this line`;
             break;
+        case SANITY_FUNCTION_SYNC_TAG_INVALIDATE:
+            definer = `defineSyncTagInvalidateFunction({name: '${fnName}'}), // ← add this line`;
+            break;
     }
     return `
   export default defineBlueprint({
@@ -154,7 +157,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-*, and/or scheduled-* types.');
+            throw new Error('Invalid function type. Cannot mix document-*, media-library-asset-*, sync-tag-* and/or scheduled-* types.');
         }
         let addHelpers;
         let installCommand;
@@ -238,6 +241,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_SYNC_TAG_INVALIDATE, value: EVENT_SYNC_TAG_INVALIDATE },
             // {name: LABEL_SCHEDULED, value: EVENT_SCHEDULED},
         ],
         validate(choices) {

package/dist/cores/functions/dev.js

@@ -7,7 +7,7 @@ export async function functionDevCore(options) {
         ? { timeout }
         : undefined;
     try {
-        await dev(host, Number(port), log, options.validateResources || false, executionOptions);
+        await dev(host, Number(port), options.validateResources || false, executionOptions);
         log(`Server is running on http://${host}:${port}\n`);
         return {
             success: true,

package/dist/server/app.d.ts

@@ -1,6 +1,5 @@
-import type { Logger } from '../utils/logger.js';
 import { type InvokeExecutionOptions } from '../utils/types.js';
-declare const app: (host: string, port: number, logger: Logger, validateResources: boolean, executionOptions?: Partial<InvokeExecutionOptions>) => void;
+declare const app: (host: string, port: number, validateResources: boolean, executionOptions?: Partial<InvokeExecutionOptions>) => void;
 declare function parseDocumentUrl(url: string): {
     projectId: string;
     dataset: string;