@sanity/runtime-cli 17.8.0 → 17.9.0

package/README.md

@@ -90,7 +90,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/v17.8.0/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -127,7 +127,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/v17.8.0/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -183,7 +183,7 @@ EXAMPLES
   $ sanity-run blueprints deploy --new-stack-name <new-name>
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -221,7 +221,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/v17.8.0/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -253,7 +253,7 @@ EXAMPLES
   $ sanity-run blueprints doctor --fix
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -291,7 +291,7 @@ EXAMPLES
   $ sanity-run blueprints info --organization-id <orgId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -355,7 +355,7 @@ EXAMPLES
   $ sanity-run blueprints init old-stack --type <json|js|ts> --project-id <projectId> --stack-id <existingStackId>
 ```
 
-_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -401,7 +401,7 @@ EXAMPLES
   $ sanity-run blueprints logs --before 2026-05-01T00:00:00Z
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints mint-deploy-token`
 
@@ -446,7 +446,7 @@ EXAMPLES
   $ sanity-run blueprints mint-deploy-token --organization-id <orgId>
 ```
 
-_See code: [src/commands/blueprints/mint-deploy-token.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/blueprints/mint-deploy-token.ts)_
+_See code: [src/commands/blueprints/mint-deploy-token.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/blueprints/mint-deploy-token.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -479,7 +479,7 @@ EXAMPLES
   $ sanity-run blueprints plan --organization-id <orgId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints promote`
 
@@ -515,7 +515,7 @@ EXAMPLES
   $ sanity-run blueprints promote --new-stack-name <new-name>
 ```
 
-_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/blueprints/promote.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -523,9 +523,11 @@ List remote Stack deployments for your project or organization
 
 ```
 USAGE
-  $ sanity-run blueprints stacks [--json] [--project-id <value> | --organization-id <value> | --include-projects]
+  $ sanity-run blueprints stacks [--json] [--project-id <value> | --organization-id <value> | --include-projects |
+    --all]
 
 FLAGS
+  --all                      List Stacks from every organization and project you have access to
   --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
@@ -539,11 +541,14 @@ 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.
+  Without a scope, prompts for an organization or project. Use --all to list Stacks across every organization and
+  project you can access, or --include-projects with --organization-id for one organization and its projects.
 
 EXAMPLES
   $ sanity-run blueprints stacks
 
+  $ sanity-run blueprints stacks --all
+
   $ sanity-run blueprints stacks --project-id <projectId>
 
   $ sanity-run blueprints stacks --organization-id <organizationId>
@@ -551,7 +556,7 @@ EXAMPLES
   $ sanity-run blueprints stacks --organization-id <organizationId> --include-projects
 ```
 
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -603,7 +608,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/v17.8.0/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -638,7 +643,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -671,7 +676,7 @@ EXAMPLES
   $ sanity-run functions env add --stack <name-or-id> MyFunction API_URL https://api.example.com/
 ```
 
-_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -701,7 +706,7 @@ EXAMPLES
   $ sanity-run functions env list --stack <name-or-id> MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -733,7 +738,7 @@ EXAMPLES
   $ sanity-run functions env remove --stack <name-or-id> MyFunction API_URL
 ```
 
-_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -773,7 +778,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -830,7 +835,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/v17.8.0/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.9.0/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

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

@@ -6,10 +6,12 @@ type ListStacksResponse = {
     ok: true;
     error: null;
     stacks: StackSummary[];
+    response?: Response;
 } | {
     ok: false;
     error: string;
     stacks?: unknown;
+    response?: Response;
 };
 export declare function listStacks(auth: AuthParams, logger: Logger): Promise<ListStacksResponse>;
 type GetStackResponse = {

package/dist/actions/blueprints/stacks.js

@@ -14,6 +14,7 @@ export async function listStacks(auth, logger) {
             ok: response.ok,
             error: response.ok ? null : data.message,
             stacks: data,
+            response,
         };
     }
     catch (error) {

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

@@ -22,6 +22,17 @@ export declare function listProjects({ token, organizationId, logger, }: {
     organizationId?: string;
     logger: Logger;
 }): Promise<ListProjectsResponse>;
+export interface Organization {
+    id: string;
+    name: string;
+}
+interface ListOrganizationsResponse extends ActionResponse {
+    organizations: Organization[];
+}
+export declare function listOrganizations({ token, logger, }: {
+    token: string;
+    logger: Logger;
+}): Promise<ListOrganizationsResponse>;
 interface GroupedProjectsByOrganizationResponse extends ActionResponse {
     organizations: GroupedProjects[];
 }

package/dist/actions/sanity/projects.js

@@ -8,22 +8,52 @@ export async function listProjects({ token, organizationId, logger, }) {
     const url = organizationId
         ? `${projectsApiPath}?organizationId=${encodeURIComponent(organizationId)}`
         : projectsApiPath;
-    const projectsFetch = await fetchFn(url, {
-        method: 'GET',
-        headers: {
-            Authorization: `Bearer ${token}`,
-            'Content-Type': 'application/json',
-        },
-    });
-    const projects = await projectsFetch.json();
-    return {
-        ok: projectsFetch.ok,
-        error: projectsFetch.ok ? null : projects.error?.message,
-        projects,
-    };
+    try {
+        const projectsFetch = await fetchFn(url, {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        const projects = await projectsFetch.json();
+        return {
+            ok: projectsFetch.ok,
+            error: projectsFetch.ok ? null : projects.error?.message,
+            projects,
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            error: error instanceof Error ? error.message : String(error),
+            projects: [],
+        };
+    }
 }
-export async function groupProjectsByOrganization({ token, logger, }) {
+export async function listOrganizations({ token, logger, }) {
     const fetchFn = createTracedFetch(logger);
+    try {
+        const response = await fetchFn(orgsApiPath, {
+            method: 'GET',
+            headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
+        });
+        const organizations = await response.json();
+        return {
+            ok: response.ok,
+            error: response.ok ? null : organizations.error?.message,
+            organizations,
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            error: error instanceof Error ? error.message : String(error),
+            organizations: [],
+        };
+    }
+}
+export async function groupProjectsByOrganization({ token, logger, }) {
     const projectsResponse = await listProjects({ token, logger });
     if (!projectsResponse.ok) {
         return {
@@ -32,19 +62,15 @@ export async function groupProjectsByOrganization({ token, logger, }) {
             organizations: [],
         };
     }
-    const orgsFetch = await fetchFn(orgsApiPath, {
-        method: 'GET',
-        headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
-    });
-    if (!orgsFetch.ok) {
+    const orgsResponse = await listOrganizations({ token, logger });
+    if (!orgsResponse.ok) {
         return {
             ok: false,
-            error: orgsFetch.statusText,
+            error: orgsResponse.error,
             organizations: [],
         };
     }
-    const organizations = await orgsFetch.json();
-    const orgsWithProjects = organizations.map(({ name, id }) => {
+    const orgsWithProjects = orgsResponse.organizations.map(({ name, id }) => {
         const projects = projectsResponse.projects.filter((project) => project.organizationId === id);
         return { organization: { name, id }, projects };
     });

package/dist/baseCommands.d.ts

@@ -131,6 +131,12 @@ export declare abstract class ResolvedCommand<T extends typeof Command> extends
      * populated regardless of `needs` and is never required
      */
     protected resolvedStackId?: string;
+    /**
+     * locally-resolved scope (flags > env > module > config)
+     * populated regardless of `needs` and is never required
+     */
+    protected resolvedScopeType?: ScopeType;
+    protected resolvedScopeId?: string;
     /**
      * the located `.sanity/blueprint.config.json` (if any), populated regardless of
      * `needs`. Lets commands read/update local config without requiring a manifest.

package/dist/baseCommands.js

@@ -213,6 +213,12 @@ export class ResolvedCommand extends RuntimeCommand {
      * populated regardless of `needs` and is never required
      */
     resolvedStackId;
+    /**
+     * locally-resolved scope (flags > env > module > config)
+     * populated regardless of `needs` and is never required
+     */
+    resolvedScopeType;
+    resolvedScopeId;
     /**
      * the located `.sanity/blueprint.config.json` (if any), populated regardless of
      * `needs`. Lets commands read/update local config without requiring a manifest.
@@ -308,8 +314,10 @@ export class ResolvedCommand extends RuntimeCommand {
                 // assumption was wrong; leave stackId undefined
             }
         }
-        // Expose the resolved Stack ID regardless of `needs` (optional, for listings/highlighting)
+        // Expose the resolved Stack ID and scope regardless of `needs` (optional, for listings/highlighting)
         this.resolvedStackId = resolved.stackId;
+        this.resolvedScopeType = resolved.scopeType;
+        this.resolvedScopeId = resolved.scopeId;
         // Backfill resolved IDs onto the blueprint result if it was loaded
         if (this.blueprint) {
             Object.assign(this.blueprint, {

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

@@ -1,6 +1,6 @@
 import { ResolvedCommand } from '../../baseCommands.js';
 export default class StacksCommand extends ResolvedCommand<typeof StacksCommand> {
-    static needs: readonly ['scope'];
+    static needs: readonly ['token'];
     static summary: string;
     static description: string;
     static examples: string[];
@@ -8,6 +8,7 @@ export default class StacksCommand extends ResolvedCommand<typeof StacksCommand>
         '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>;
+        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<Record<string, unknown> | undefined>;
 }

package/dist/commands/blueprints/stacks.js

@@ -3,15 +3,16 @@ import { organizationIdFlagConfig, projectIdFlagConfig, ResolvedCommand } from '
 import { blueprintStacksCore } from '../../cores/blueprints/stacks.js';
 import { Logger } from '../../utils/logger.js';
 export default class StacksCommand extends ResolvedCommand {
-    static needs = ['scope'];
+    static needs = ['token'];
     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 --include-projects with --organization-id to also list Stacks from all projects within the organization.`;
+Without a scope, prompts for an organization or project. Use --all to list Stacks across every organization and project you can access, or --include-projects with --organization-id for one organization and its projects.`;
     static examples = [
         '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --all',
         '<%= config.bin %> <%= command.id %> --project-id <projectId>',
         '<%= config.bin %> <%= command.id %> --organization-id <organizationId>',
         '<%= config.bin %> <%= command.id %> --organization-id <organizationId> --include-projects',
@@ -19,21 +20,28 @@ Use --include-projects with --organization-id to also list Stacks from all proje
     static flags = {
         'project-id': Flags.string({
             ...projectIdFlagConfig,
-            exclusive: ['organization-id', 'include-projects'],
+            exclusive: ['organization-id', 'include-projects', 'all'],
+        }),
+        'organization-id': Flags.string({
+            ...organizationIdFlagConfig,
+            exclusive: ['project-id', 'all'],
         }),
-        'organization-id': Flags.string({ ...organizationIdFlagConfig }),
         'include-projects': Flags.boolean({
             description: 'Include Stacks from all projects within the organization. Requires --organization-id.',
             dependsOn: ['organization-id'],
         }),
+        all: Flags.boolean({
+            description: 'List Stacks from every organization and project you have access to',
+            exclusive: ['project-id', 'organization-id', 'include-projects'],
+        }),
     };
     async run() {
         const result = await blueprintStacksCore({
             bin: this.config.bin,
             log: Logger(this.log.bind(this), this.flags),
             token: this.sanityToken,
-            scopeType: this.scopeType,
-            scopeId: this.scopeId,
+            scopeType: this.resolvedScopeType,
+            scopeId: this.resolvedScopeId,
             localStackId: this.resolvedStackId,
             flags: this.flags,
         });

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

@@ -2,13 +2,18 @@ import type { ScopeType } from '../../utils/types.js';
 import type { CoreConfig, CoreResult } from '../index.js';
 export interface BlueprintStacksOptions extends CoreConfig {
     token: string;
-    /** Scope to list Stacks for, resolved by the base command (flags > env > config). */
-    scopeType: ScopeType;
-    scopeId: string;
+    /**
+     * Scope to list Stacks for, resolved by the base command (flags > env > config).
+     * Prompted for when absent.
+     */
+    scopeType?: ScopeType;
+    scopeId?: string;
     /** Locally-configured Stack ID, used only to highlight the current Stack in listings. */
     localStackId?: string;
     flags: {
+        all?: boolean;
         'include-projects'?: boolean;
+        json?: boolean;
         verbose?: boolean;
     };
 }