@sanity/runtime-cli 14.11.0 → 14.12.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @sanity/runtime-cli
 $ sanity-run COMMAND
 running command...
 $ sanity-run (--version)
-@sanity/runtime-cli/14.11.0 linux-x64 node-v24.14.1
+@sanity/runtime-cli/14.12.0 linux-x64 node-v24.14.1
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -55,9 +55,9 @@ Add a function resource to a Blueprint
 ```
 USAGE
   $ sanity-run blueprints add TYPE [--json] [--validate-resources] [--example <value> | -n <value> | --fn-type
-    document-publish|document-create|document-update|document-delete|media-library-asset-create|media-library-asset-upda
-    te|media-library-asset-delete|scheduled-function... | --language ts|js | --javascript | --fn-helpers |
-    --fn-installer skip|npm|pnpm|yarn] [-i | ]
+    document-publish|document-create|document-delete|document-update|media-library-asset-create|media-library-asset-dele
+    te|media-library-asset-update|scheduled-function|sync-tag-invalidate... | --language ts|js | --javascript |
+    --fn-helpers | --fn-installer skip|npm|pnpm|yarn] [-i | ]
 
 ARGUMENTS
   TYPE  (function) Type of resource to add (only "function" is supported)
@@ -72,9 +72,9 @@ FLAGS
                                  <options: skip|npm|pnpm|yarn>
       --fn-type=<option>...      Document change event(s) that should trigger the function; you can specify multiple
                                  events by specifying this flag multiple times
-                                 <options:
-                                 document-publish|document-create|document-update|document-delete|media-library-asset-cr
-                                 eate|media-library-asset-update|media-library-asset-delete|scheduled-function>
+                                 <options: document-publish|document-create|document-delete|document-update|media-librar
+                                 y-asset-create|media-library-asset-delete|media-library-asset-update|scheduled-function
+                                 |sync-tag-invalidate>
       --javascript               Use JavaScript instead of TypeScript
       --json                     Format output as json
       --language=<option>        [default: ts] Language of the new function
@@ -101,7 +101,7 @@ EXAMPLES
   $ sanity-run blueprints add function --name my-function --fn-type document-create --fn-type document-update --lang js
 ```
 
-_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.11.0/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.0/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -109,8 +109,8 @@ View or edit the local Blueprint configuration
 
 ```
 USAGE
-  $ sanity-run blueprints config [--json] [--validate-resources] [--project-id <value> -e] [--organization-id <value> ]
-    [--stack <value> ]
+  $ sanity-run blueprints config [--json] [--validate-resources] [--stack <value> -e] [--project-id <value> ]
+    [--organization-id <value> ]
 
 FLAGS
   -e, --edit                     Modify the configuration interactively, or directly when combined with ID flags.
@@ -140,7 +140,7 @@ EXAMPLES
   $ sanity-run blueprints config --edit --project-id <projectId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v14.11.0/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.0/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -182,7 +182,7 @@ EXAMPLES
   $ sanity-run blueprints deploy --fn-installer npm
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.11.0/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.0/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -218,7 +218,7 @@ EXAMPLES
   $ sanity-run blueprints destroy --stack <name-or-id> --project-id <projectId> --force --no-wait
 ```
 
-_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.11.0/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.0/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -250,7 +250,7 @@ EXAMPLES
   $ sanity-run blueprints doctor --fix
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v14.11.0/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.0/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -258,11 +258,12 @@ Display the status and resources of the remote Stack deployment
 
 ```
 USAGE
-  $ sanity-run blueprints info [--json] [--validate-resources] [--stack <value>]
+  $ sanity-run blueprints info [--json] [--validate-resources] [--stack <value>] [--project-id <value>]
 
 FLAGS
   --json                     Format output as json
-  --stack=<value>            Stack name or ID to use instead of the locally configured Stack
+  --project-id=<value>       Sanity project ID used to scope Blueprint and Stack
+  --stack=<value>            Stack name or ID
   --[no-]validate-resources  Validate resources
 
 DESCRIPTION
@@ -280,9 +281,11 @@ EXAMPLES
   $ sanity-run blueprints info
 
   $ sanity-run blueprints info --stack <name-or-id>
+
+  $ sanity-run blueprints info --project-id <id> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v14.11.0/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.0/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -336,7 +339,7 @@ EXAMPLES
   $ sanity-run blueprints init --blueprint-type <json|js|ts> --stack-name <stackName>
 ```
 
-_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v14.11.0/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.0/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -367,7 +370,7 @@ EXAMPLES
   $ sanity-run blueprints logs --watch
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.11.0/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.0/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -395,7 +398,7 @@ EXAMPLES
   $ sanity-run blueprints plan
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v14.11.0/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.0/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -427,7 +430,7 @@ EXAMPLES
   $ sanity-run blueprints stacks --organization-id <organizationId>
 ```
 
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v14.11.0/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.0/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -436,9 +439,9 @@ Add a Function to your Blueprint
 ```
 USAGE
   $ sanity-run functions add [--json] [--validate-resources] [--example <value> | -n <value> |  | --language ts|js
-    | --javascript |  | ] [--type document-publish|document-create|document-update|document-delete|media-library-asset-c
-    reate|media-library-asset-update|media-library-asset-delete|scheduled-function... ] [--helpers] [--installer
-    skip|npm|pnpm|yarn] [-i | ]
+    | --javascript |  | ] [--type document-publish|document-create|document-delete|document-update|media-library-asset-c
+    reate|media-library-asset-delete|media-library-asset-update|scheduled-function|sync-tag-invalidate... ] [--helpers]
+    [--installer skip|npm|pnpm|yarn] [-i | ]
 
 FLAGS
   -i, --install                  Shortcut for --fn-installer npm
@@ -453,9 +456,9 @@ FLAGS
                                  <options: ts|js>
       --type=<option>...         Document change event(s) that should trigger the function; you can specify multiple
                                  events by specifying this flag multiple times
-                                 <options:
-                                 document-publish|document-create|document-update|document-delete|media-library-asset-cr
-                                 eate|media-library-asset-update|media-library-asset-delete|scheduled-function>
+                                 <options: document-publish|document-create|document-delete|document-update|media-librar
+                                 y-asset-create|media-library-asset-delete|media-library-asset-update|scheduled-function
+                                 |sync-tag-invalidate>
       --[no-]validate-resources  Validate resources
 
 DESCRIPTION
@@ -463,8 +466,8 @@ 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.
 
@@ -480,7 +483,7 @@ EXAMPLES
   $ sanity-run functions add --name my-function --type document-create --type document-update --lang js
 ```
 
-_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.11.0/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.0/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -516,7 +519,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v14.11.0/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.0/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -547,7 +550,7 @@ EXAMPLES
   $ sanity-run functions env add MyFunction API_URL https://api.example.com/
 ```
 
-_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.11.0/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.0/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -575,7 +578,7 @@ EXAMPLES
   $ sanity-run functions env list MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v14.11.0/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.0/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -605,7 +608,7 @@ EXAMPLES
   $ sanity-run functions env remove MyFunction API_URL
 ```
 
-_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v14.11.0/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.0/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -647,7 +650,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.11.0/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.0/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -655,11 +658,11 @@ Invoke a local Sanity Function
 
 ```
 USAGE
-  $ sanity-run functions test [NAME] [--json] [--validate-resources] [--data-before <value> | [-d <value> | -f
-    <value> | --document-id <value>] |  |  | --file-before <value> | --file-after <value> | --document-id-before <value>
-    | --document-id-after <value>] [--data-after <value> |  |  |  |  |  |  | ] [-e create|update|delete] [-t <value>]
-    [-a <value>] [--organization-id <value>] [--with-user-token] [--media-library-id <value> | --project-id <value> |
-    --dataset <value>]
+  $ sanity-run functions test [NAME] [--json] [--validate-resources] [--organization-id <value>] [--data-before
+    <value> | [-d <value> | -f <value> | --document-id <value>] |  |  | --file-before <value> | --file-after <value> |
+    --document-id-before <value> | --document-id-after <value>] [--data-after <value> |  |  |  |  |  |  | ] [-e
+    create|update|delete] [-t <value>] [-a <value>] [--with-user-token] [--media-library-id <value> | --project-id
+    <value> | --dataset <value>]
 
 ARGUMENTS
   [NAME]  The name of the Sanity Function
@@ -705,7 +708,7 @@ EXAMPLES
   $ sanity-run functions test <name> --event update --data-before '{ "title": "before" }' --data-after '{ "title": "after" }'
 ```
 
-_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v14.11.0/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.0/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

package/dist/actions/blueprints/blueprint.d.ts

@@ -3,6 +3,7 @@ import { type Blueprint } from '@sanity/blueprints-parser';
 import type { Logger } from '../../utils/logger.js';
 import type { BlueprintParserError, ScopeType } from '../../utils/types.js';
 import { type LocatedBlueprintsConfig } from './config.js';
+import { type ConfigSource } from './resolve.js';
 declare const SUPPORTED_FILE_EXTENSIONS: readonly [".json", ".js", ".mjs", ".ts"];
 type BlueprintFileExtension = (typeof SUPPORTED_FILE_EXTENSIONS)[number];
 export declare const JSON_BLUEPRINT_CONTENT: {
@@ -23,18 +24,26 @@ type FileInfo = {
 };
 /**
  * Finds the blueprint file in the given path or current working directory
- * @param blueprintPath - The path of the blueprint file or directory
  * @returns The path, file name, and extension of the blueprint file
  */
 export declare function findBlueprintFile(blueprintPath?: string): FileInfo | null;
+/** @see resolve.ts for the canonical definition */
+export type { ConfigSource } from './resolve.js';
+/** Result of loading a blueprint file from disk. */
+export interface LoadedBlueprintFile {
+    rawBlueprint: Record<string, unknown>;
+    module?: BlueprintModule;
+}
 /**
- * Source of the config value.
- * - config: from the config file - .sanity.blueprint.config.json most common
- * - env: from the environment - usually CLI var like `SANITY_ORGANIZATION_ID`
- * - module: from the blueprint module - undocumented escape hatch
- * - inferred: legacy `ST-<projectId>` stacks from launch
+ * Normalized result from the parser's {@link BlueprintOutput}
+ * to match the shape returned by {@link readLocalBlueprint}
  */
-export type ConfigSource = 'config' | 'env' | 'module' | 'inferred';
+export interface ParsedBlueprintContent {
+    /** The validated blueprint, or the raw data as fallback when parsing fails */
+    parsedBlueprint: Blueprint | Record<string, unknown>;
+    errors: BlueprintParserError[];
+    resources: BlueprintResource[];
+}
 /** Result of the blueprint read operation */
 export interface ReadBlueprintResult {
     fileInfo: FileInfo;
@@ -46,8 +55,6 @@ export interface ReadBlueprintResult {
     errors: BlueprintParserError[];
     /** Validated resources escaped from parser types */
     resources: BlueprintResource[];
-    /** @deprecated - use blueprintConfig.configPath instead */
-    configPath?: string;
     scopeType?: ScopeType;
     scopeId?: string;
     organizationId?: string;
@@ -59,14 +66,24 @@ export interface ReadBlueprintResult {
         stackId?: ConfigSource;
     };
 }
+/**
+ * Load a blueprint file from disk: read JSON or import+execute a JS/TS module.
+ * Returns the raw blueprint data and the module reference (if dynamic).
+ */
+export declare function loadBlueprintFile(fileInfo: FileInfo): Promise<LoadedBlueprintFile>;
+/**
+ * Run the blueprint parser/validator on raw blueprint data.
+ * Optionally validates function resources.
+ */
+export declare function parseBlueprintContent(rawBlueprint: Record<string, unknown>, options: {
+    validateResources: boolean;
+}): ParsedBlueprintContent;
 /**
  * Reads the blueprint file from disk and parses it.
- * Overrides config file values with shell environment variables.
- * Can infer stackId from projectId if no stackId is provided and legacy ST-<projectId> stacks from launch are used.
- *
- * @param logger The logger instance
- * @param validate Validation options
- * @param blueprintPath - The path of the blueprint file or directory- will search up the directory tree!
+ * Resolves IDs from environment > blueprint module > config file.
+ * Can infer stackId from projectId for legacy ST-<projectId> stacks.
+ * @see {@link loadBlueprintFile} {@link readConfigFile} {@link resolveIds} {@link parseBlueprintContent}
+ * @todo deprecate in favor of decomposed functions
  * @returns Known information about the Blueprint, config, and Stack
  */
 export declare function readLocalBlueprint(logger: Logger, validate: {
@@ -80,4 +97,3 @@ export declare function addResourceToBlueprint<T extends BlueprintResource>({ bl
     blueprintFilePath?: string;
     resource: T;
 }): T | undefined;
-export {};

package/dist/actions/blueprints/blueprint.js

@@ -7,7 +7,8 @@ import * as find from 'empathic/find';
 import { createJiti } from 'jiti';
 import { SANITY_FUNCTION_DOCUMENT, SANITY_FUNCTION_MEDIA_LIBRARY_ASSET, SANITY_FUNCTION_SCHEDULED, } from '../../constants.js';
 import { validateResources } from '../../utils/validate/index.js';
-import { backfillOrganizationId, backfillProjectBasedStackId, readConfigFile, } from './config.js';
+import { backfillProjectBasedStackId, readConfigFile, } from './config.js';
+import { resolveIds } from './resolve.js';
 const SUPPORTED_FILE_EXTENSIONS = ['.json', '.js', '.mjs', '.ts'];
 let SUPPORTED_FILE_NAMES = SUPPORTED_FILE_EXTENSIONS.map((ext) => `blueprint${ext}`);
 SUPPORTED_FILE_NAMES = [
@@ -29,7 +30,6 @@ export default defineBlueprint({
 `.trim();
 /**
  * Finds the blueprint file in the given path or current working directory
- * @param blueprintPath - The path of the blueprint file or directory
  * @returns The path, file name, and extension of the blueprint file
  */
 export function findBlueprintFile(blueprintPath) {
@@ -60,38 +60,29 @@ export function findBlueprintFile(blueprintPath) {
     };
 }
 /**
- * Reads the blueprint file from disk and parses it.
- * Overrides config file values with shell environment variables.
- * Can infer stackId from projectId if no stackId is provided and legacy ST-<projectId> stacks from launch are used.
- *
- * @param logger The logger instance
- * @param validate Validation options
- * @param blueprintPath - The path of the blueprint file or directory- will search up the directory tree!
- * @returns Known information about the Blueprint, config, and Stack
+ * Load a blueprint file from disk: read JSON or import+execute a JS/TS module.
+ * Returns the raw blueprint data and the module reference (if dynamic).
  */
-export async function readLocalBlueprint(logger, validate, blueprintPath) {
-    const blueprintFile = findBlueprintFile(blueprintPath);
-    if (!blueprintFile)
-        throw Error('Could not find Blueprint file! Use the `blueprints init` command.');
-    const { blueprintFilePath: foundFilePath, fileName, extension } = blueprintFile;
+export async function loadBlueprintFile(fileInfo) {
+    const { blueprintFilePath, fileName, extension } = fileInfo;
     let rawBlueprint;
     let blueprintModule;
     try {
         switch (extension) {
             case '.json': {
-                const blueprintString = readFileSync(foundFilePath, 'utf8').toString();
+                const blueprintString = readFileSync(blueprintFilePath, 'utf8').toString();
                 rawBlueprint = JSON.parse(blueprintString);
                 break;
             }
             case '.js':
             case '.mjs': {
-                const module = await import(foundFilePath);
-                blueprintModule = module.default;
+                const mod = await import(blueprintFilePath);
+                blueprintModule = mod.default;
                 break;
             }
             case '.ts': {
-                const jiti = createJiti(dirname(foundFilePath));
-                const modDefault = await jiti.import(pathToFileURL(foundFilePath).href, { default: true });
+                const jiti = createJiti(dirname(blueprintFilePath));
+                const modDefault = await jiti.import(pathToFileURL(blueprintFilePath).href, { default: true });
                 blueprintModule = modDefault;
                 break;
             }
@@ -102,22 +93,10 @@ export async function readLocalBlueprint(logger, validate, blueprintPath) {
     catch (err) {
         throw Error(`Unable to parse Blueprint file: ${fileName}\n${err}`);
     }
-    /**
-     * Org, Project, Stack IDs can be set...
-     * - in the environment,
-     * - on the blueprint module,
-     * - and in the config file.
-     * The precedence is: environment > blueprint module > config file
-     */
-    let moduleOrganizationId;
-    let moduleProjectId;
-    let moduleStackId;
+    // Dynamic modules: extract attached properties, then execute to get raw blueprint
     if (blueprintModule) {
         if (typeof blueprintModule === 'function') {
             try {
-                moduleOrganizationId = blueprintModule.organizationId;
-                moduleProjectId = blueprintModule.projectId;
-                moduleStackId = blueprintModule.stackId;
                 rawBlueprint = blueprintModule();
             }
             catch {
@@ -131,89 +110,14 @@ export async function readLocalBlueprint(logger, validate, blueprintPath) {
     if (typeof rawBlueprint === 'undefined') {
         throw Error('Unable to read Blueprint');
     }
-    const { SANITY_ORGANIZATION_ID: envOrganizationId, SANITY_PROJECT_ID: envProjectId, SANITY_BLUEPRINT_STACK_ID: envStackId, } = env;
-    const blueprintConfig = readConfigFile(foundFilePath);
-    // passively heal config on disk by getting organizationId from projectId
-    if (blueprintConfig?.projectId && !blueprintConfig.organizationId) {
-        try {
-            await backfillOrganizationId({
-                projectId: blueprintConfig.projectId,
-                blueprintFilePath: foundFilePath,
-                logger,
-            });
-        }
-        catch { }
-    }
-    const sources = {};
-    let organizationId;
-    if (envOrganizationId) {
-        organizationId = envOrganizationId;
-        sources.organizationId = 'env';
-    }
-    else if (moduleOrganizationId) {
-        organizationId = moduleOrganizationId;
-        sources.organizationId = 'module';
-    }
-    else if (blueprintConfig?.organizationId) {
-        organizationId = blueprintConfig.organizationId;
-        sources.organizationId = 'config';
-    }
-    let projectId;
-    if (envProjectId) {
-        projectId = envProjectId;
-        sources.projectId = 'env';
-    }
-    else if (moduleProjectId) {
-        projectId = moduleProjectId;
-        sources.projectId = 'module';
-    }
-    else if (blueprintConfig?.projectId) {
-        projectId = blueprintConfig.projectId;
-        sources.projectId = 'config';
-    }
-    let stackId;
-    if (envStackId) {
-        stackId = envStackId;
-        sources.stackId = 'env';
-    }
-    else if (moduleStackId) {
-        stackId = moduleStackId;
-        sources.stackId = 'module';
-    }
-    else if (blueprintConfig?.stackId) {
-        stackId = blueprintConfig.stackId;
-        sources.stackId = 'config';
-    }
-    // LAUNCH LIMIT: 1 Stack per Project - infer stackId from projectId
-    // this code path exists to handle project-based stacks from initial Blueprints/Functions launch
-    if (!stackId && projectId) {
-        try {
-            // try to assume project-based stack if no stackId is provided
-            stackId = await backfillProjectBasedStackId({
-                blueprintFilePath: foundFilePath,
-                projectId,
-                logger,
-            });
-            if (stackId)
-                sources.stackId = 'inferred';
-        }
-        catch {
-            // our assumption was wrong, so we'll leave stackId undefined
-        }
-    }
-    let scopeType;
-    let scopeId;
-    // Scope is as specific as possible; project > organization
-    if (projectId) {
-        scopeType = 'project';
-        scopeId = projectId;
-    }
-    else if (organizationId) {
-        scopeType = 'organization';
-        scopeId = organizationId;
-    }
+    return { rawBlueprint, module: blueprintModule };
+}
+/**
+ * Run the blueprint parser/validator on raw blueprint data.
+ * Optionally validates function resources.
+ */
+export function parseBlueprintContent(rawBlueprint, options) {
     const parserResult = blueprintParserValidator(rawBlueprint, {
-        // Prevents the following resources from being referenced.
         invalidReferenceTypes: [
             SANITY_FUNCTION_DOCUMENT,
             SANITY_FUNCTION_MEDIA_LIBRARY_ASSET,
@@ -222,34 +126,84 @@ export async function readLocalBlueprint(logger, validate, blueprintPath) {
     });
     const parsedBlueprint = parserResult.result === 'valid' ? parserResult.blueprint : undefined;
     const errors = parserResult.result !== 'valid' ? parserResult.errors : [];
-    // resource validation
-    if (parsedBlueprint?.resources) {
-        if (validate?.resources) {
-            // validate function resources
-            errors.push(...validateResources(parsedBlueprint.resources));
-        }
+    if (parsedBlueprint?.resources && options.validateResources) {
+        errors.push(...validateResources(parsedBlueprint.resources));
     }
-    // Ceremony to cross from parser's Resource type to BlueprintResource
-    // widen from the parser's Resource type assignable to BlueprintResource
+    // Widen from the parser's Resource type to BlueprintResource
     const parserResources = parsedBlueprint?.resources ?? [];
-    // filter to valid resources typed as BlueprintResource
-    const validResources = parserResources.filter((r) => !!r.type);
+    const resources = parserResources.filter((r) => !!r.type);
     return {
-        fileInfo: { blueprintFilePath: foundFilePath, fileName, extension },
+        parsedBlueprint: parsedBlueprint || rawBlueprint,
+        errors,
+        resources,
+    };
+}
+/**
+ * Reads the blueprint file from disk and parses it.
+ * Resolves IDs from environment > blueprint module > config file.
+ * Can infer stackId from projectId for legacy ST-<projectId> stacks.
+ * @see {@link loadBlueprintFile} {@link readConfigFile} {@link resolveIds} {@link parseBlueprintContent}
+ * @todo deprecate in favor of decomposed functions
+ * @returns Known information about the Blueprint, config, and Stack
+ */
+export async function readLocalBlueprint(logger, validate, blueprintPath) {
+    const fileInfo = findBlueprintFile(blueprintPath);
+    if (!fileInfo)
+        throw Error('Could not find Blueprint file! Use the `blueprints init` command.');
+    // 1. Load blueprint from disk
+    const loaded = await loadBlueprintFile(fileInfo);
+    const { rawBlueprint } = loaded;
+    // 2. Read the config file
+    const blueprintConfig = readConfigFile(fileInfo.blueprintFilePath);
+    // 3. Resolve IDs: env > module > config
+    const resolved = resolveIds({
+        env: {
+            organizationId: env.SANITY_ORGANIZATION_ID,
+            projectId: env.SANITY_PROJECT_ID,
+            stackId: env.SANITY_BLUEPRINT_STACK_ID,
+        },
+        module: loaded.module
+            ? {
+                organizationId: loaded.module.organizationId,
+                projectId: loaded.module.projectId,
+                stackId: loaded.module.stackId,
+            }
+            : undefined,
+        config: blueprintConfig
+            ? {
+                organizationId: blueprintConfig.organizationId,
+                projectId: blueprintConfig.projectId,
+                stackId: blueprintConfig.stackId,
+            }
+            : undefined,
+    });
+    // 4. Legacy stack ID inference: ST-<projectId>
+    let { stackId } = resolved;
+    if (!stackId && resolved.projectId) {
+        try {
+            stackId = await backfillProjectBasedStackId({
+                blueprintFilePath: fileInfo.blueprintFilePath,
+                projectId: resolved.projectId,
+                logger,
+            });
+            if (stackId)
+                resolved.sources.stackId = 'inferred';
+        }
+        catch {
+            // assumption was wrong; leave stackId undefined
+        }
+    }
+    // 5. Parse + validate blueprint content
+    const parsed = parseBlueprintContent(rawBlueprint, {
+        validateResources: validate.resources,
+    });
+    return {
+        fileInfo,
         blueprintConfig,
         rawBlueprint,
-        resources: validResources,
-        errors,
-        scopeType,
-        scopeId,
-        organizationId,
-        projectId,
-        stackId,
-        sources,
-        /** @deprecated */
-        configPath: blueprintConfig?.configPath,
-        // fallback to the raw blueprint if the parser found errors
-        parsedBlueprint: parsedBlueprint || rawBlueprint,
+        ...parsed,
+        ...resolved,
+        stackId: stackId ?? resolved.stackId,
     };
 }
 export function writeBlueprintToDisk({ blueprintFilePath, jsonContent = JSON_BLUEPRINT_CONTENT, }) {