@sanity/runtime-cli 4.5.0 → 5.0.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/4.5.0 linux-x64 node-v22.15.0
+@sanity/runtime-cli/5.0.0 linux-x64 node-v22.15.0
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -34,10 +34,9 @@ USAGE
 * [`sanity-run blueprints deploy`](#sanity-run-blueprints-deploy)
 * [`sanity-run blueprints destroy`](#sanity-run-blueprints-destroy)
 * [`sanity-run blueprints info`](#sanity-run-blueprints-info)
-* [`sanity-run blueprints init`](#sanity-run-blueprints-init)
+* [`sanity-run blueprints init [DIR]`](#sanity-run-blueprints-init-dir)
 * [`sanity-run blueprints logs`](#sanity-run-blueprints-logs)
 * [`sanity-run blueprints plan`](#sanity-run-blueprints-plan)
-* [`sanity-run blueprints stacks`](#sanity-run-blueprints-stacks)
 * [`sanity-run functions dev`](#sanity-run-functions-dev)
 * [`sanity-run functions env add NAME KEY VALUE`](#sanity-run-functions-env-add-name-key-value)
 * [`sanity-run functions env list NAME`](#sanity-run-functions-env-list-name)
@@ -49,32 +48,37 @@ USAGE
 
 ## `sanity-run blueprints add TYPE`
 
-Add a resource to a Blueprint
+Add a (function) resource to a Blueprint
 
 ```
 USAGE
-  $ sanity-run blueprints add TYPE [--function-type document-publish -n <value>]
+  $ sanity-run blueprints add TYPE [--fn-type document-publish -n <value>] [--language ts|js] [--javascript]
 
 ARGUMENTS
   TYPE  (function) Type of resource to add (e.g. function)
 
 FLAGS
-  -n, --name=<value>            Name of the resource to add
-      --function-type=<option>  Type of function to add (e.g. document-publish)
-                                <options: document-publish>
+  -n, --name=<value>       Name of the resource to add
+      --fn-type=<option>   Type of new function
+                           <options: document-publish>
+      --javascript         Use JavaScript instead of TypeScript
+      --language=<option>  [default: ts] Language of the new function
+                           <options: ts|js>
 
 DESCRIPTION
-  Add a resource to a Blueprint
+  Add a (function) resource to a Blueprint
 
 EXAMPLES
   $ sanity-run blueprints add function
 
   $ sanity-run blueprints add function --name my-function
 
-  $ sanity-run blueprints add function --name my-function --function-type document-publish
+  $ sanity-run blueprints add function --name my-function --fn-type document-publish
+
+  $ sanity-run blueprints add function --name my-function --fn-type document-publish --lang js
 ```
 
-_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v4.5.0/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v5.0.0/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -82,13 +86,12 @@ View or edit Blueprint configuration
 
 ```
 USAGE
-  $ sanity-run blueprints config [-t] [--project-id <value> -e] [--stack-id <value> ]
+  $ sanity-run blueprints config [-t] [--project-id <value> -e]
 
 FLAGS
   -e, --edit                Edit the configuration
   -t, --test-config         Validate the configuration
       --project-id=<value>  Update the Project ID in the configuration. Requires --edit flag
-      --stack-id=<value>    Update the Stack ID in the configuration. Requires --edit flag
 
 DESCRIPTION
   View or edit Blueprint configuration
@@ -100,10 +103,10 @@ EXAMPLES
 
   $ sanity-run blueprints config --edit
 
-  $ sanity-run blueprints config --edit --project-id <projectId> --stack-id <stackId>
+  $ sanity-run blueprints config --edit --project-id <projectId>
 ```
 
-_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v4.5.0/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v5.0.0/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -121,69 +124,65 @@ DESCRIPTION
 
 EXAMPLES
   $ sanity-run blueprints deploy
+
+  $ sanity-run blueprints deploy --no-wait
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v4.5.0/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v5.0.0/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
-Destroy a deployed Blueprint Stack
+Destroy a Blueprint deployment (will not delete local files)
 
 ```
 USAGE
-  $ sanity-run blueprints destroy [--id <value>] [--force]
+  $ sanity-run blueprints destroy [--force]
 
 FLAGS
-  --force       Force destroy (skip confirmation)
-  --id=<value>  Stack ID to destroy (defaults to current Stack)
+  --force  Force destroy (skip confirmation)
 
 DESCRIPTION
-  Destroy a deployed Blueprint Stack
+  Destroy a Blueprint deployment (will not delete local files)
 
 EXAMPLES
   $ sanity-run blueprints destroy
-
-  $ sanity-run blueprints destroy --id ST-a1b2c3
 ```
 
-_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v4.5.0/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v5.0.0/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints info`
 
-Show information about a deployed Blueprint Stack
+Show information about a Blueprint deployment
 
 ```
 USAGE
-  $ sanity-run blueprints info [--id <value>]
-
-FLAGS
-  --id=<value>  Stack ID to show info for (defaults to current stack)
+  $ sanity-run blueprints info
 
 DESCRIPTION
-  Show information about a deployed Blueprint Stack
+  Show information about a Blueprint deployment
 
 EXAMPLES
   $ sanity-run blueprints info
-
-  $ sanity-run blueprints info --id ST-a1b2c3
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v4.5.0/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v5.0.0/src/commands/blueprints/info.ts)_
 
-## `sanity-run blueprints init`
+## `sanity-run blueprints init [DIR]`
 
 Initialize a new Blueprint
 
 ```
 USAGE
-  $ sanity-run blueprints init [--blueprint-type json|js|ts] [--stack-id <value> --project-id <value>] [-n <value> ]
+  $ sanity-run blueprints init [DIR] [--dir <value>] [--blueprint-type json|js|ts] [--project-id <value>]
+
+ARGUMENTS
+  DIR  Directory to create the Blueprint in
 
 FLAGS
-  -n, --stack-name=<value>       Name to use for a NEW Stack
-      --blueprint-type=<option>  Blueprint manifest type to use for the Blueprint
-                                 <options: json|js|ts>
-      --project-id=<value>       Sanity Project ID to use for the Blueprint
-      --stack-id=<value>         Existing Stack ID to use for the Blueprint
+  --blueprint-type=<option>  Blueprint manifest type to use for the Blueprint
+                             <options: json|js|ts>
+  --dir=<value>              Directory to create the Blueprint in
+  --project-id=<value>       Sanity Project ID to use for the Blueprint
 
 DESCRIPTION
   Initialize a new Blueprint
@@ -191,18 +190,18 @@ DESCRIPTION
 EXAMPLES
   $ sanity-run blueprints init
 
-  $ sanity-run blueprints init --blueprint-type <json|js|ts>
+  $ sanity-run blueprints init [directory]
 
-  $ sanity-run blueprints init --blueprint-type <json|js|ts> --project-id <projectId> --stack-id <stackId>
+  $ sanity-run blueprints init --blueprint-type <json|js|ts>
 
-  $ sanity-run blueprints init --blueprint-type <json|js|ts> --project-id <projectId> --stack-name <stackName>
+  $ sanity-run blueprints init --blueprint-type <json|js|ts> --project-id <projectId>
 ```
 
-_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v4.5.0/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v5.0.0/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
-Display logs for a Blueprint stack
+Display logs for a Blueprint deployment
 
 ```
 USAGE
@@ -212,7 +211,7 @@ FLAGS
   -w, --watch  Watch for new logs (streaming mode)
 
 DESCRIPTION
-  Display logs for a Blueprint stack
+  Display logs for a Blueprint deployment
 
 EXAMPLES
   $ sanity-run blueprints logs
@@ -220,7 +219,7 @@ EXAMPLES
   $ sanity-run blueprints logs --watch
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v4.5.0/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v5.0.0/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -237,29 +236,7 @@ EXAMPLES
   $ sanity-run blueprints plan
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v4.5.0/src/commands/blueprints/plan.ts)_
-
-## `sanity-run blueprints stacks`
-
-List all Blueprint stacks
-
-```
-USAGE
-  $ sanity-run blueprints stacks [--projectId <value>]
-
-FLAGS
-  --projectId=<value>  Project ID to show stacks for
-
-DESCRIPTION
-  List all Blueprint stacks
-
-EXAMPLES
-  $ sanity-run blueprints stacks
-
-  $ sanity-run blueprints stacks --projectId a1b2c3
-```
-
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v4.5.0/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v5.0.0/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run functions dev`
 
@@ -279,7 +256,7 @@ EXAMPLES
   $ sanity-run functions dev --port 8974
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v4.5.0/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v5.0.0/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -301,7 +278,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/v4.5.0/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v5.0.0/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -321,7 +298,7 @@ EXAMPLES
   $ sanity-run functions env list MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v4.5.0/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v5.0.0/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -342,7 +319,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/v4.5.0/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v5.0.0/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions invoke NAME`
 
@@ -368,7 +345,7 @@ EXAMPLES
   $ sanity-run functions invoke <name> --file 'payload.json'
 ```
 
-_See code: [src/commands/functions/invoke.ts](https://github.com/sanity-io/runtime-cli/blob/v4.5.0/src/commands/functions/invoke.ts)_
+_See code: [src/commands/functions/invoke.ts](https://github.com/sanity-io/runtime-cli/blob/v5.0.0/src/commands/functions/invoke.ts)_
 
 ## `sanity-run functions logs NAME`
 
@@ -400,7 +377,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v4.5.0/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v5.0.0/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test NAME`
 
@@ -409,18 +386,18 @@ Invoke a local Sanity Function
 ```
 USAGE
   $ sanity-run functions test NAME [-d <value>] [-f <value>] [-t <value>] [-a <value>] [--dataset <value>]
-    [--project <value>]
+    [--project-id <value>]
 
 ARGUMENTS
   NAME  The name of the Sanity Function
 
 FLAGS
-  -a, --api=<value>      Sanity API Version to use
-  -d, --data=<value>     Data to send to the function
-  -f, --file=<value>     Read data from file and send to the function
-  -t, --timeout=<value>  Execution timeout value in seconds
-      --dataset=<value>  The Sanity dataset to use
-      --project=<value>  The Sanity project to use
+  -a, --api=<value>         Sanity API Version to use
+  -d, --data=<value>        Data to send to the function
+  -f, --file=<value>        Read data from file and send to the function
+  -t, --timeout=<value>     Execution timeout value in seconds
+      --dataset=<value>     The Sanity dataset to use
+      --project-id=<value>  Sanity Project ID to use
 
 DESCRIPTION
   Invoke a local Sanity Function
@@ -433,7 +410,7 @@ EXAMPLES
   $ sanity-run functions test <name> --data '{ "id": 1 }' --timeout 60
 ```
 
-_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v4.5.0/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v5.0.0/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

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

@@ -1,28 +1,23 @@
-import type { BlueprintParserError, LocalBlueprint, LocalResource, Stack } from '../../utils/types.js';
+import type { BlueprintParserError, LocalBlueprint, LocalResource } from '../../utils/types.js';
 declare const SUPPORTED_FILE_EXTENSIONS: readonly [".json", ".js", ".mjs", ".cjs", ".ts"];
 type BlueprintFileExtension = (typeof SUPPORTED_FILE_EXTENSIONS)[number];
 export declare const DEFAULT_BLUEPRINT_CONTENT: LocalBlueprint;
 /**
  * Finds the blueprint file in the given path or current working directory
- * @param blueprintFilePath - The full path of the blueprint file
+ * @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(blueprintFilePath?: string): {
+export declare function findBlueprintFile(blueprintPath?: string): {
     blueprintFilePath: string;
     fileName: string;
     extension: BlueprintFileExtension;
 } | null;
 /**
- * Reads the blueprint file from disk and parses it
- * @todo rename to loadBlueprint or similar
- * @todo extract "getStack" into a separate function
+ * Reads the blueprint file from disk and parses it. Greedily looks for project and stack config
+ * @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
  */
-export declare function readBlueprintOnDisk({ blueprintFilePath, getStack, token, }?: {
-    blueprintFilePath?: string;
-    getStack?: boolean;
-    token?: string;
-}): Promise<{
+export declare function readLocalBlueprint(blueprintPath?: string): Promise<{
     fileInfo: {
         blueprintFilePath: string;
         fileName: string;
@@ -34,7 +29,6 @@ export declare function readBlueprintOnDisk({ blueprintFilePath, getStack, token
     configPath?: string;
     projectId?: string;
     stackId?: string;
-    deployedStack?: Stack;
 }>;
 export declare function writeBlueprintToDisk({ blueprintFilePath, content, }: {
     blueprintFilePath: string;

package/dist/actions/blueprints/blueprint.js

@@ -2,8 +2,9 @@ import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'no
 import { createRequire } from 'node:module';
 import { basename, dirname, extname, join } from 'node:path';
 import { cwd } from 'node:process';
+import { findUpSync } from 'find-up';
+import { BlueprintParserErrorType, isLocalFunctionResource } from '../../utils/types.js';
 import { blueprintParserValidator } from '../../utils/vendor/parser-validator.js';
-import { getStack as getStackById } from './stacks.js';
 const SUPPORTED_FILE_EXTENSIONS = ['.json', '.js', '.mjs', '.cjs', '.ts'];
 const SUPPORTED_FILE_NAMES_IN_PRIORITY_ORDER = SUPPORTED_FILE_EXTENSIONS.map((ext) => `blueprint${ext}`);
 export const DEFAULT_BLUEPRINT_CONTENT = {
@@ -12,49 +13,47 @@ export const DEFAULT_BLUEPRINT_CONTENT = {
 };
 /**
  * Finds the blueprint file in the given path or current working directory
- * @param blueprintFilePath - The full path of the blueprint file
+ * @param blueprintPath - The path of the blueprint file or directory
  * @returns The path, file name, and extension of the blueprint file
  */
-export function findBlueprintFile(blueprintFilePath) {
+export function findBlueprintFile(blueprintPath) {
     let dirToSearch = cwd();
-    if (blueprintFilePath) {
-        try {
-            const stat = statSync(blueprintFilePath);
-            if (stat.isFile()) {
-                return {
-                    blueprintFilePath: blueprintFilePath,
-                    fileName: basename(blueprintFilePath),
-                    extension: extname(blueprintFilePath),
-                };
-            }
-            if (stat.isDirectory()) {
-                dirToSearch = blueprintFilePath;
-            }
-        }
-        catch {
-            throw Error(`Blueprint file not found: ${blueprintFilePath}`);
-        }
-    }
-    for (const fileName of SUPPORTED_FILE_NAMES_IN_PRIORITY_ORDER) {
-        const filePath = join(dirToSearch, fileName);
-        if (existsSync(filePath)) {
+    if (blueprintPath) {
+        const pathExists = existsSync(blueprintPath);
+        if (!pathExists)
+            return null;
+        const stat = statSync(blueprintPath);
+        if (stat.isFile()) {
             return {
-                blueprintFilePath: filePath,
-                fileName,
-                extension: extname(filePath),
+                blueprintFilePath: blueprintPath,
+                fileName: basename(blueprintPath),
+                extension: extname(blueprintPath),
             };
         }
+        if (stat.isDirectory()) {
+            dirToSearch = blueprintPath;
+        }
     }
-    return null;
+    const blueprintFile = findUpSync(SUPPORTED_FILE_NAMES_IN_PRIORITY_ORDER, {
+        cwd: dirToSearch,
+        type: 'file',
+        allowSymlinks: false,
+    });
+    if (!blueprintFile)
+        return null;
+    return {
+        blueprintFilePath: blueprintFile,
+        fileName: basename(blueprintFile),
+        extension: extname(blueprintFile),
+    };
 }
 /**
- * Reads the blueprint file from disk and parses it
- * @todo rename to loadBlueprint or similar
- * @todo extract "getStack" into a separate function
+ * Reads the blueprint file from disk and parses it. Greedily looks for project and stack config
+ * @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
  */
-export async function readBlueprintOnDisk({ blueprintFilePath, getStack, token, } = {}) {
-    const blueprintFile = findBlueprintFile(blueprintFilePath);
+export async function readLocalBlueprint(blueprintPath) {
+    const blueprintFile = findBlueprintFile(blueprintPath);
     if (!blueprintFile)
         throw Error('Could not find Blueprint file! Use the init command.');
     const { blueprintFilePath: foundPath, fileName, extension } = blueprintFile;
@@ -79,7 +78,6 @@ export async function readBlueprintOnDisk({ blueprintFilePath, getStack, token,
                 break;
             }
             case '.ts': {
-                console.warn('\x1b[2mSupport for Typescript blueprints is experimental.\x1b[0m');
                 try {
                     const { tsImport } = await import('tsx/esm/api');
                     const module = await tsImport(foundPath, dirname(foundPath));
@@ -113,10 +111,26 @@ export async function readBlueprintOnDisk({ blueprintFilePath, getStack, token,
     const parserResult = blueprintParserValidator(rawBlueprint);
     const { blueprint: parsedBlueprint } = parserResult;
     const errors = parserResult.errors || [];
+    // further validation - remove once validator is updated
+    if (parsedBlueprint.resources) {
+        const functionResources = parsedBlueprint.resources.filter(isLocalFunctionResource);
+        for (const fnR of functionResources) {
+            if (!fnR.event?.on) {
+                errors.push({
+                    message: 'Function resource must have an event "on" property',
+                    type: BlueprintParserErrorType.InvalidProperty,
+                });
+            }
+            // if (!fnR.src) {
+            //   // this could be a good spot to infer the src from the name
+            //   // for now anyway
+            // }
+        }
+    }
     const configIds = readConfigFile(foundPath);
     const configPath = configIds?.configPath;
     const blueprintMetadata = parsedBlueprint.metadata;
-    // find/create project resource
+    // find projectId
     let projectId;
     if (configIds?.projectId) {
         projectId = configIds.projectId;
@@ -129,7 +143,7 @@ export async function readBlueprintOnDisk({ blueprintFilePath, getStack, token,
         if (projectResource)
             projectId = projectResource.id;
     }
-    // find/create stack resource
+    // find stackId
     let stackId;
     if (configIds?.stackId) {
         stackId = configIds.stackId;
@@ -142,14 +156,9 @@ export async function readBlueprintOnDisk({ blueprintFilePath, getStack, token,
         if (stackResource)
             stackId = stackResource.id;
     }
-    let deployedStack;
-    if (getStack && token && stackId && projectId) {
-        const { stack, ok, error } = await getStackById({ stackId, auth: { token, projectId } });
-        if (!ok) {
-            throw Error(error || 'Unable to retrieve Stack');
-        }
-        deployedStack = stack;
-    }
+    // LAUNCH LIMIT: 1 Stack per Project - infer stackId from projectId
+    if (!stackId && projectId)
+        stackId = `ST-${projectId}`;
     return {
         fileInfo: { blueprintFilePath: foundPath, fileName, extension },
         rawBlueprint: rawBlueprint,
@@ -157,11 +166,11 @@ export async function readBlueprintOnDisk({ blueprintFilePath, getStack, token,
         projectId,
         stackId,
         configPath,
-        deployedStack,
         parsedBlueprint,
     };
 }
 export function writeBlueprintToDisk({ blueprintFilePath, content = DEFAULT_BLUEPRINT_CONTENT, }) {
+    const dir = dirname(blueprintFilePath);
     const extension = extname(blueprintFilePath);
     let blueprintContent;
     switch (extension) {
@@ -187,6 +196,7 @@ export function writeBlueprintToDisk({ blueprintFilePath, content = DEFAULT_BLUE
             throw Error(`Unsupported blueprint file extension: ${extension}`);
         }
     }
+    mkdirSync(dir, { recursive: true });
     writeFileSync(blueprintFilePath, blueprintContent);
     return blueprintContent;
 }

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

@@ -5,3 +5,36 @@ export * as operations from './operations.js';
 export * as projects from './projects.js';
 export * as resources from './resources.js';
 export * as stacks from './stacks.js';
+import type { Stack } from '../../utils/types.js';
+import type { BlueprintParserError } from '../../utils/types.js';
+import { readLocalBlueprint } from './blueprint.js';
+export type BlueprintIssue = {
+    code: 'NO_STACK_ID' | 'NO_PROJECT_ID' | 'NO_STACK' | 'PARSE_ERROR';
+    message: string;
+    errors?: BlueprintParserError[];
+};
+type LocalBlueprintWithIds = Awaited<ReturnType<typeof readLocalBlueprint>> & {
+    projectId: string;
+    stackId: string;
+};
+type BlueprintSuccess = {
+    localBlueprint: LocalBlueprintWithIds;
+    deployedStack: Stack;
+    issues?: never;
+};
+type BlueprintFailure = {
+    localBlueprint: Awaited<ReturnType<typeof readLocalBlueprint>>;
+    issues: BlueprintIssue[];
+    deployedStack?: never;
+};
+type BlueprintResult = BlueprintSuccess | BlueprintFailure;
+/**
+ * Get the local Blueprint and deployed Stack
+ * @param blueprintPath - The path of the Blueprint file or directory- will search up the directory tree if not provided
+ * @param token - The Sanity API token
+ * @returns The local Blueprint and deployed Stack
+ */
+export declare function getBlueprintAndStack({ token, blueprintPath, }: {
+    token: string;
+    blueprintPath?: string;
+}): Promise<BlueprintResult>;

package/dist/actions/blueprints/index.js

@@ -5,3 +5,35 @@ export * as operations from './operations.js';
 export * as projects from './projects.js';
 export * as resources from './resources.js';
 export * as stacks from './stacks.js';
+import { readLocalBlueprint } from './blueprint.js';
+import { getStack } from './stacks.js';
+/**
+ * Get the local Blueprint and deployed Stack
+ * @param blueprintPath - The path of the Blueprint file or directory- will search up the directory tree if not provided
+ * @param token - The Sanity API token
+ * @returns The local Blueprint and deployed Stack
+ */
+export async function getBlueprintAndStack({ token, blueprintPath, }) {
+    if (!token)
+        throw new Error('Auth is required');
+    const localBlueprint = await readLocalBlueprint(blueprintPath);
+    const { projectId, stackId, errors } = localBlueprint;
+    const issues = [];
+    if (errors.length > 0) {
+        issues.push({ code: 'PARSE_ERROR', message: 'Blueprint parse errors', errors });
+    }
+    if (!(stackId && projectId)) {
+        if (!projectId)
+            issues.push({ code: 'NO_PROJECT_ID', message: 'Project ID not found' });
+        if (!stackId)
+            issues.push({ code: 'NO_STACK_ID', message: 'Stack ID not found' });
+        return { localBlueprint, issues };
+    }
+    const auth = { token, projectId };
+    const { error, ok, stack: deployedStack } = await getStack({ stackId, auth });
+    if (!ok) {
+        issues.push({ code: 'NO_STACK', message: error || 'Unknown error' });
+        return { localBlueprint, issues };
+    }
+    return { localBlueprint: localBlueprint, deployedStack };
+}

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

@@ -18,4 +18,13 @@ interface ListProjectsResponse {
 export declare function listProjects({ token }: {
     token: string;
 }): Promise<ListProjectsResponse>;
+interface GetProjectResponse {
+    ok: boolean;
+    error: string | null;
+    project: Project;
+}
+export declare function getProject({ token, projectId, }: {
+    token: string;
+    projectId: string;
+}): Promise<GetProjectResponse>;
 export {};

package/dist/actions/blueprints/projects.js

@@ -16,3 +16,15 @@ export async function listProjects({ token }) {
         projects,
     };
 }
+export async function getProject({ token, projectId, }) {
+    const response = await fetch(`${projectsUrl}/${projectId}`, {
+        method: 'GET',
+        headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
+    });
+    const project = await response.json();
+    return {
+        ok: response.ok,
+        error: response.ok ? null : project.error?.message,
+        project,
+    };
+}