@sanity/runtime-cli 14.12.1 → 14.13.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.12.1 linux-x64 node-v24.14.1
+@sanity/runtime-cli/14.13.0 linux-x64 node-v24.14.1
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -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.12.1/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.0/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -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.12.1/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.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.12.1/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.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.12.1/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.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.12.1/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.0/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -285,7 +285,7 @@ EXAMPLES
   $ 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.12.1/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.0/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -338,7 +338,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.12.1/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.0/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -369,7 +369,7 @@ EXAMPLES
   $ sanity-run blueprints logs --watch
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.1/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.0/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -397,7 +397,7 @@ EXAMPLES
   $ sanity-run blueprints plan
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.1/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.0/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -405,9 +405,11 @@ List remote Stack deployments for your project or organization
 
 ```
 USAGE
-  $ sanity-run blueprints stacks [--json] [--validate-resources] [--project-id <value> | --organization-id <value>]
+  $ sanity-run blueprints stacks [--json] [--validate-resources] [--project-id <value> | --organization-id <value> |
+    --include-projects]
 
 FLAGS
+  --include-projects         Include Stacks from all projects within the organization. Requires --organization-id.
   --json                     Format output as json
   --organization-id=<value>  Sanity organization ID used to scope Blueprint and Stack
   --project-id=<value>       Sanity project ID used to scope Blueprint and Stack
@@ -421,15 +423,19 @@ DESCRIPTION
   Use this to discover existing Stacks you can scope a local Blueprint to (using 'blueprints config --edit'), or to
   audit what's deployed across your project.
 
+  Use --include-projects with --organization-id to also list Stacks from all projects within the organization.
+
 EXAMPLES
   $ sanity-run blueprints stacks
 
   $ sanity-run blueprints stacks --project-id <projectId>
 
   $ sanity-run blueprints stacks --organization-id <organizationId>
+
+  $ sanity-run blueprints stacks --organization-id <organizationId> --include-projects
 ```
 
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.1/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.0/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -482,7 +488,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.12.1/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.0/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -518,7 +524,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.1/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.0/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -549,7 +555,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.12.1/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.0/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -577,7 +583,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.12.1/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.0/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -607,7 +613,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.12.1/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.0/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -649,7 +655,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.12.1/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.0/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -707,7 +713,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.12.1/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v14.13.0/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

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

@@ -17,8 +17,9 @@ export interface Project {
 interface ListProjectsResponse extends ActionResponse {
     projects: Project[];
 }
-export declare function listProjects({ token, logger, }: {
+export declare function listProjects({ token, organizationId, logger, }: {
     token: string;
+    organizationId?: string;
     logger: Logger;
 }): Promise<ListProjectsResponse>;
 interface GroupedProjectsByOrganizationResponse extends ActionResponse {

package/dist/actions/sanity/projects.js

@@ -3,9 +3,12 @@ import { createTracedFetch } from '../../utils/traced-fetch.js';
 const { populusApiUrl } = config;
 export const projectsApiPath = `${populusApiUrl}v2021-06-07/projects`;
 export const orgsApiPath = `${populusApiUrl}v2021-06-07/organizations`;
-export async function listProjects({ token, logger, }) {
+export async function listProjects({ token, organizationId, logger, }) {
     const fetchFn = createTracedFetch(logger);
-    const projectsFetch = await fetchFn(projectsApiPath, {
+    const url = organizationId
+        ? `${projectsApiPath}?organizationId=${encodeURIComponent(organizationId)}`
+        : projectsApiPath;
+    const projectsFetch = await fetchFn(url, {
         method: 'GET',
         headers: {
             Authorization: `Bearer ${token}`,

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

@@ -7,6 +7,7 @@ export default class StacksCommand extends ResolvedCommand<typeof StacksCommand>
     static flags: {
         '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>;
+        'include-projects': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<Record<string, unknown> | undefined>;
 }

package/dist/commands/blueprints/stacks.js

@@ -7,15 +7,25 @@ export default class StacksCommand extends ResolvedCommand {
     static summary = 'List remote Stack deployments for your project or organization';
     static description = `Shows all Stacks associated with a project or organization. By default, lists Stacks scoped to the local Blueprint.
 
-Use this to discover existing Stacks you can scope a local Blueprint to (using 'blueprints config --edit'), or to audit what's deployed across your project.`;
+Use this to discover existing Stacks you can scope a local Blueprint to (using 'blueprints config --edit'), or to audit what's deployed across your project.
+
+Use --include-projects with --organization-id to also list Stacks from all projects within the organization.`;
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --project-id <projectId>',
         '<%= config.bin %> <%= command.id %> --organization-id <organizationId>',
+        '<%= config.bin %> <%= command.id %> --organization-id <organizationId> --include-projects',
     ];
     static flags = {
-        'project-id': Flags.string({ ...projectIdFlagConfig, exclusive: ['organization-id'] }),
+        'project-id': Flags.string({
+            ...projectIdFlagConfig,
+            exclusive: ['organization-id', 'include-projects'],
+        }),
         'organization-id': Flags.string({ ...organizationIdFlagConfig, exclusive: ['project-id'] }),
+        'include-projects': Flags.boolean({
+            description: 'Include Stacks from all projects within the organization. Requires --organization-id.',
+            dependsOn: ['organization-id'],
+        }),
     };
     async run() {
         const result = await blueprintStacksCore({

package/dist/cores/blueprints/stacks.d.ts

@@ -3,6 +3,7 @@ export interface BlueprintStacksOptions extends BlueprintConfig {
     flags: {
         'project-id'?: string;
         'organization-id'?: string;
+        'include-projects'?: boolean;
         verbose?: boolean;
     };
 }

package/dist/cores/blueprints/stacks.js

@@ -1,11 +1,14 @@
 import { listStacks } from '../../actions/blueprints/stacks.js';
+import { listProjects } from '../../actions/sanity/projects.js';
 import { formatStacksListing } from '../../utils/display/blueprints-formatting.js';
-import { capitalize, niceId } from '../../utils/display/presenters.js';
+import { capitalize, niceId, warn } from '../../utils/display/presenters.js';
 import { styleText } from '../../utils/style-text.js';
+/** Max projects to query for stacks during --include-projects */
+const PROJECT_LIMIT = 50;
 export async function blueprintStacksCore(options) {
     const { log, token, blueprint, flags } = options;
     const { scopeType: blueprintScopeType, scopeId: blueprintScopeId, stackId: blueprintStackId, } = blueprint;
-    const { 'project-id': flagProjectId, 'organization-id': flagOrganizationId, verbose: _verbose = false, } = flags;
+    const { 'project-id': flagProjectId, 'organization-id': flagOrganizationId, 'include-projects': includeProjects = false, verbose: _verbose = false, } = flags;
     if (flagOrganizationId && flagProjectId) {
         log.error('Cannot specify both --organization-id and --project-id');
         return { success: false, error: 'Cannot specify both --organization-id and --project-id' };
@@ -27,6 +30,9 @@ export async function blueprintStacksCore(options) {
             suggestions: ['Run in a Blueprint directory or provide a project with --project-id.'],
         };
     }
+    if (includeProjects && scopeType === 'organization') {
+        return deepListStacks({ organizationId: scopeId, token, log, blueprintStackId });
+    }
     try {
         const spinner = log.ora('Fetching Stacks...').start();
         const { ok, stacks, error } = await listStacks({ token, scopeType, scopeId }, log);
@@ -57,3 +63,68 @@ export async function blueprintStacksCore(options) {
         return { success: false, error: errorMessage };
     }
 }
+async function deepListStacks(options) {
+    const { organizationId, token, log, blueprintStackId } = options;
+    const allStacks = [];
+    const spinner = log.ora('Fetching Stacks...').start();
+    try {
+        // 1. Org-scoped stacks
+        const orgResult = await listStacks({ token, scopeType: 'organization', scopeId: organizationId }, log);
+        const orgStacks = orgResult.ok ? orgResult.stacks : [];
+        // 2. Get projects in the organization
+        const projectsResult = await listProjects({ token, organizationId, logger: log });
+        if (!projectsResult.ok) {
+            spinner.fail('Failed to list projects');
+            return { success: false, error: projectsResult.error || 'Failed to list projects' };
+        }
+        const projects = projectsResult.projects;
+        const totalProjects = projects.length;
+        const cappedProjects = projects.slice(0, PROJECT_LIMIT);
+        // 3. Fetch stacks for each project
+        const projectGroups = [];
+        for (let i = 0; i < cappedProjects.length; i++) {
+            const project = cappedProjects[i];
+            spinner.text = `Fetching Stacks... (project ${i + 1}/${cappedProjects.length})`;
+            const result = await listStacks({ token, scopeType: 'project', scopeId: project.id }, log);
+            if (result.ok && result.stacks.length > 0) {
+                projectGroups.push({
+                    projectId: project.id,
+                    displayName: project.displayName,
+                    stacks: result.stacks,
+                });
+                allStacks.push(...result.stacks);
+            }
+        }
+        spinner.stop().clear();
+        // 4. Print results
+        if (orgStacks.length > 0) {
+            log(`${styleText('bold', 'Organization')} ${niceId(organizationId)} ${styleText('bold', 'Stacks')}:\n`);
+            log(formatStacksListing(orgStacks, blueprintStackId));
+            if (projectGroups.length > 0)
+                log(''); // blank line between sections
+        }
+        for (const group of projectGroups) {
+            log(`${styleText('bold', 'Project')} "${group.displayName}" ${niceId(group.projectId)} ${styleText('bold', 'Stacks')}:`);
+            log(formatStacksListing(group.stacks, blueprintStackId));
+            log('');
+        }
+        if (totalProjects > PROJECT_LIMIT) {
+            log(warn(`Organization has ${totalProjects} projects, only checked the first ${PROJECT_LIMIT}.`));
+        }
+        if (orgStacks.length === 0 && allStacks.length === 0) {
+            log('No stacks found');
+            return { success: true };
+        }
+        allStacks.push(...orgStacks);
+        return {
+            success: true,
+            json: { stacks: allStacks, scopeType: 'organization', scopeId: organizationId },
+        };
+    }
+    catch (error) {
+        spinner.stop().clear();
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        log.error(`Error: ${errorMessage}`);
+        return { success: false, error: errorMessage };
+    }
+}

package/oclif.manifest.json

@@ -1289,11 +1289,12 @@
     "blueprints:stacks": {
       "aliases": [],
       "args": {},
-      "description": "Shows all Stacks associated with a project or organization. By default, lists Stacks scoped to the local Blueprint.\n\nUse this to discover existing Stacks you can scope a local Blueprint to (using 'blueprints config --edit'), or to audit what's deployed across your project.",
+      "description": "Shows all Stacks associated with a project or organization. By default, lists Stacks scoped to the local Blueprint.\n\nUse this to discover existing Stacks you can scope a local Blueprint to (using 'blueprints config --edit'), or to audit what's deployed across your project.\n\nUse --include-projects with --organization-id to also list Stacks from all projects within the organization.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --project-id <projectId>",
-        "<%= config.bin %> <%= command.id %> --organization-id <organizationId>"
+        "<%= config.bin %> <%= command.id %> --organization-id <organizationId>",
+        "<%= config.bin %> <%= command.id %> --organization-id <organizationId> --include-projects"
       ],
       "flags": {
         "json": {
@@ -1350,7 +1351,8 @@
           ],
           "description": "Sanity project ID used to scope Blueprint and Stack",
           "exclusive": [
-            "organization-id"
+            "organization-id",
+            "include-projects"
           ],
           "name": "project-id",
           "hasDynamicHelp": false,
@@ -1371,6 +1373,15 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "include-projects": {
+          "dependsOn": [
+            "organization-id"
+          ],
+          "description": "Include Stacks from all projects within the organization. Requires --organization-id.",
+          "name": "include-projects",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -2677,5 +2688,5 @@
       ]
     }
   },
-  "version": "14.12.1"
+  "version": "14.13.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sanity/runtime-cli",
   "description": "Sanity's Runtime CLI for Blueprints and Functions",
-  "version": "14.12.1",
+  "version": "14.13.0",
   "author": "Sanity Runtime Team",
   "type": "module",
   "license": "MIT",