@sanity/runtime-cli 17.16.0-app-functions.ge0a25ea → 17.16.0-app-functions.gab0267c

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.16.0-app-functions.ge0a25ea/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-app-functions.gab0267c/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.16.0-app-functions.ge0a25ea/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-app-functions.gab0267c/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.16.0-app-functions.ge0a25ea/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-app-functions.gab0267c/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.16.0-app-functions.ge0a25ea/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-app-functions.gab0267c/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.16.0-app-functions.ge0a25ea/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-app-functions.gab0267c/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.16.0-app-functions.ge0a25ea/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-app-functions.gab0267c/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.16.0-app-functions.ge0a25ea/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-app-functions.gab0267c/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.16.0-app-functions.ge0a25ea/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-app-functions.gab0267c/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.16.0-app-functions.ge0a25ea/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.16.0-app-functions.gab0267c/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.16.0-app-functions.ge0a25ea/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-app-functions.gab0267c/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.16.0-app-functions.ge0a25ea/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-app-functions.gab0267c/src/commands/blueprints/promote.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -556,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.16.0-app-functions.ge0a25ea/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-app-functions.gab0267c/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -608,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.16.0-app-functions.ge0a25ea/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-app-functions.gab0267c/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -643,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.16.0-app-functions.ge0a25ea/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-app-functions.gab0267c/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -676,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.16.0-app-functions.ge0a25ea/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-app-functions.gab0267c/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -706,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.16.0-app-functions.ge0a25ea/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-app-functions.gab0267c/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -738,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.16.0-app-functions.ge0a25ea/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-app-functions.gab0267c/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -778,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.16.0-app-functions.ge0a25ea/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-app-functions.gab0267c/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -836,7 +836,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.16.0-app-functions.ge0a25ea/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.16.0-app-functions.gab0267c/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

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

@@ -138,9 +138,10 @@ export declare function promoteStack({ stackId, auth, logger, name, }: {
     name?: string;
 }): Promise<PromoteStackResponse>;
 type DestroyStackResponse = UpdateStackResponse;
-export declare function destroyStack({ stackId, auth, logger, }: {
+export declare function destroyStack({ stackId, auth, logger, fetchFn, }: {
     stackId: string;
     auth: AuthParams;
     logger: Logger;
+    fetchFn?: typeof fetch;
 }): Promise<DestroyStackResponse>;
 export {};

package/dist/actions/blueprints/stacks.js

@@ -198,8 +198,7 @@ export async function promoteStack({ stackId, auth, logger, name, }) {
         };
     }
 }
-export async function destroyStack({ stackId, auth, logger, }) {
-    const fetchFn = createTracedFetch(logger);
+export async function destroyStack({ stackId, auth, logger, fetchFn = createTracedFetch(logger), }) {
     try {
         const response = await fetchFn(`${stacksUrl}/${stackId}`, {
             method: 'DELETE',

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

@@ -1,5 +1,5 @@
 import { type LocatedBlueprintsConfig } from '../../actions/blueprints/config.js';
-import type { ScopeType } from '../../utils/types.js';
+import type { AuthParams, ScopeType } from '../../utils/types.js';
 import type { CoreConfig, CoreResult } from '../index.js';
 export interface BlueprintDestroyOptions extends CoreConfig {
     token: string;
@@ -20,3 +20,16 @@ export interface BlueprintDestroyOptions extends CoreConfig {
     };
 }
 export declare function blueprintDestroyCore(options: BlueprintDestroyOptions): Promise<CoreResult>;
+type WaitForDestructionOptions = {
+    stackId: string;
+    stackName: string;
+    operationId: string;
+    requestId?: string;
+    auth: AuthParams;
+    log: CoreConfig['log'];
+    bin: string;
+    verbose?: boolean;
+    fetchFn?: typeof fetch;
+};
+export declare function waitForDestruction(options: WaitForDestructionOptions): Promise<CoreResult>;
+export {};

package/dist/cores/blueprints/destroy.js

@@ -150,7 +150,7 @@ function afterDestroyAccepted(options) {
     }
     return waitForDestruction(options);
 }
-async function waitForDestruction(options) {
+export async function waitForDestruction(options) {
     const { stackId, stackName, operationId, requestId, auth, log, bin, verbose = false } = options;
     log(styleText('dim', 'Stack destruction progress:'));
     log('');
@@ -163,6 +163,7 @@ async function waitForDestruction(options) {
         verbose,
         includeDestroyed: true,
         progressNoun: 'destruction',
+        fetchFn: options.fetchFn,
     });
     if (outcome.type === 'completed') {
         log(styleText(['bold', 'magenta'], 'Stack destruction completed!'));

package/dist/functions/stack.d.ts

@@ -1,3 +1,4 @@
+import type { CoreResult } from '../cores/index.js';
 import type { Stack, StackSummary } from '../utils/types.js';
 interface AppFunctionIdentity {
     appId: string;
@@ -16,3 +17,21 @@ export declare function ensureFunctionStack(options: AppFunctionIdentity & {
     id: string;
 } | null>;
 export { BLUEPRINTS_API_VERSION } from '../config.js';
+/** Scope and transport for looking up an app's function stack. */
+export interface FunctionStackOptions extends AppFunctionIdentity {
+    token: string;
+    fetchFn: typeof fetch;
+    stackId?: string;
+}
+/** Read-only stack metadata for an undeploy plan. */
+export interface FunctionStackInfo {
+    id: string;
+    functions: string[];
+}
+/** Find an app-owned stack without creating one, and verify all resources are app functions. */
+export declare function inspectFunctionStack(options: FunctionStackOptions): Promise<FunctionStackInfo | null>;
+/** Destroy an app's stack using Blueprint deletion and operation polling. Missing stacks are already clean. */
+export declare function destroyFunctionStack(options: FunctionStackOptions & {
+    stackId: string;
+    log: (message: string) => void;
+}): Promise<CoreResult>;

package/dist/functions/stack.js

@@ -1,4 +1,5 @@
-import { createStack, getStack, listStacks } from '../actions/blueprints/stacks.js';
+import { createStack, destroyStack, getStack, listStacks } from '../actions/blueprints/stacks.js';
+import { waitForDestruction } from '../cores/blueprints/destroy.js';
 import { Logger } from '../utils/logger.js';
 /** Shared ownership check for provisioning and deploying an app's function stack. */
 export function assertAppFunctionStack(stack, { appId, organizationId }) {
@@ -82,3 +83,66 @@ function stackRequestError(result) {
     return new Error(`Blueprint stack request failed${status}: ${result.error || result.response?.statusText || 'Unknown error'}`);
 }
 export { BLUEPRINTS_API_VERSION } from '../config.js';
+/** Find an app-owned stack without creating one, and verify all resources are app functions. */
+export async function inspectFunctionStack(options) {
+    const found = await ensureFunctionStack({ ...options, dryRun: true });
+    if (!found)
+        return null;
+    const stack = await readOwnedFunctionStack({ ...options, stackId: found.id });
+    return stack ? { id: stack.id, functions: stack.resources.map((resource) => resource.name) } : null;
+}
+/** Destroy an app's stack using Blueprint deletion and operation polling. Missing stacks are already clean. */
+export async function destroyFunctionStack(options) {
+    try {
+        const stack = await readOwnedFunctionStack(options);
+        if (!stack)
+            return { success: true };
+        const log = Logger(options.log, { json: true });
+        const auth = {
+            token: options.token,
+            scopeType: 'organization',
+            scopeId: options.organizationId,
+        };
+        const result = await destroyStack({
+            stackId: stack.id,
+            auth,
+            logger: log,
+            fetchFn: options.fetchFn,
+        });
+        if (!result.ok) {
+            if (result.response?.status === 404)
+                return { success: true };
+            return { success: false, error: result.error, requestId: result.requestId };
+        }
+        return await waitForDestruction({
+            stackId: stack.id,
+            stackName: stack.name,
+            operationId: result.stack.operationId,
+            requestId: result.requestId,
+            auth,
+            log,
+            bin: 'sanity',
+            fetchFn: options.fetchFn,
+        });
+    }
+    catch (error) {
+        return { success: false, error: error instanceof Error ? error.message : String(error) };
+    }
+}
+async function readOwnedFunctionStack(options) {
+    const auth = {
+        token: options.token,
+        scopeType: 'organization',
+        scopeId: options.organizationId,
+    };
+    const result = await getStack({ stackId: options.stackId, auth, fetchFn: options.fetchFn });
+    if (!result.ok) {
+        if (result.response?.status === 404)
+            return null;
+        throw stackRequestError(result);
+    }
+    assertAppFunctionStack(result.stack, options);
+    if (result.stack.resources.some((resource) => resource.type !== 'sanity.function.pubsub'))
+        throw new Error('The app function stack contains other resource types. Manage it with sanity blueprints instead.');
+    return result.stack;
+}

package/oclif.manifest.json

@@ -3148,5 +3148,5 @@
       ]
     }
   },
-  "version": "17.16.0-app-functions.ge0a25ea"
+  "version": "17.16.0-app-functions.gab0267c"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sanity/runtime-cli",
   "description": "Sanity's Runtime CLI for Blueprints and Functions",
-  "version": "17.16.0-app-functions.ge0a25ea",
+  "version": "17.16.0-app-functions.gab0267c",
   "author": "Sanity Runtime Team",
   "type": "module",
   "license": "MIT",