@sanity/runtime-cli 17.15.0-next.ge190195 → 17.16.0-app-functions.ge0a25ea

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.15.0-next.ge190195/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.ge0a25ea/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.15.0-next.ge190195/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.ge0a25ea/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.15.0-next.ge190195/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.ge0a25ea/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.15.0-next.ge190195/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.ge0a25ea/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.15.0-next.ge190195/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.ge0a25ea/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.15.0-next.ge190195/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.ge0a25ea/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.15.0-next.ge190195/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.ge0a25ea/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.15.0-next.ge190195/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.ge0a25ea/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.15.0-next.ge190195/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.ge0a25ea/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.15.0-next.ge190195/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.ge0a25ea/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.15.0-next.ge190195/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.ge0a25ea/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.15.0-next.ge190195/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.ge0a25ea/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.15.0-next.ge190195/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.ge0a25ea/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.15.0-next.ge190195/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.ge0a25ea/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.15.0-next.ge190195/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.ge0a25ea/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.15.0-next.ge190195/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.ge0a25ea/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.15.0-next.ge190195/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.ge0a25ea/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.15.0-next.ge190195/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.ge0a25ea/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.15.0-next.ge190195/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.ge0a25ea/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

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

@@ -1,5 +1,5 @@
 import type { BlueprintResource } from '@sanity/blueprints';
-import type { AuthParams, InstallerType, PrepAssetFn } from '../../utils/types.js';
+import type { AuthParams, InstallerType, PrepAssetFn, ResolvedResource } from '../../utils/types.js';
 export declare const assetCheckUrl: string;
 export declare const assetStashUrl: string;
 export type StashAssetResult = {
@@ -18,8 +18,8 @@ export type StashAssetResult = {
     success: false;
     error: string;
 };
-export declare function stashAsset<R extends BlueprintResource>({ resource, prepAsset, auth, blueprintFileDir, fetchFn, installer, }: {
-    resource: R;
+export declare function stashAsset<R extends BlueprintResource>({ resolvedResource, prepAsset, auth, blueprintFileDir, fetchFn, installer, }: {
+    resolvedResource: ResolvedResource<R>;
     prepAsset: PrepAssetFn<R>;
     auth: AuthParams;
     blueprintFileDir: string;

package/dist/actions/blueprints/assets.js

@@ -4,10 +4,10 @@ import getHeaders from '../../utils/get-headers.js';
 const assetsUrl = blueprintsUrl('assets');
 export const assetCheckUrl = `${assetsUrl}/check`;
 export const assetStashUrl = `${assetsUrl}/stash`;
-export async function stashAsset({ resource, prepAsset, auth, blueprintFileDir, fetchFn, installer, }) {
+export async function stashAsset({ resolvedResource, prepAsset, auth, blueprintFileDir, fetchFn, installer, }) {
     let cleanup = async () => { };
     try {
-        const prepResult = await prepAsset({ resource, blueprintFileDir, installer });
+        const prepResult = await prepAsset({ resolvedResource, blueprintFileDir, installer });
         if (prepResult.success === false) {
             await prepResult.cleanup();
             return {
@@ -26,7 +26,7 @@ export async function stashAsset({ resource, prepAsset, auth, blueprintFileDir,
             assetParameter: prepResult.assetParameter,
             metadata: prepResult.metadata,
             cleanup,
-            resourceName: resource.name,
+            resourceName: resolvedResource.resource.name,
             auth,
             fetchFn,
         });

package/dist/actions/blueprints/pre-deploy.js

@@ -18,7 +18,7 @@ const preDeployConfigs = [
         resourceType: (type) => type in BUNDLE_SPECS,
         async prepareAsset(options) {
             return prepareBundleAsset({
-                resource: options.resource,
+                resolvedResource: options.resolvedResource,
                 blueprintFileDir: options.blueprintFileDir,
             });
         },
@@ -30,7 +30,7 @@ const preDeployConfigs = [
         resourceType: (type) => type.startsWith(SANITY_FUNCTION_PREFIX),
         async prepareAsset(options) {
             return prepareFunctionAsset({
-                resource: options.resource,
+                resource: options.resolvedResource.resource,
                 blueprintFileDir: options.blueprintFileDir,
                 installer: options.installer,
             });
@@ -74,7 +74,7 @@ export async function preDeploy(options) {
         });
         const assetResources = [];
         for (const r of resolvedResources) {
-            const config = getPredeployConfig(r);
+            const config = getPredeployConfig(r.resource);
             if (typeof config !== 'undefined' && typeof config.prepareAsset === 'function') {
                 assetResources.push({ resource: r, prepareAsset: config.prepareAsset });
             }

package/dist/actions/blueprints/process-assets.js

@@ -42,13 +42,14 @@ function getAssetConcurrency() {
     const configured = Number(env.SANITY_ASSET_CONCURRENCY);
     return Number.isSafeInteger(configured) && configured > 0 ? configured : DEFAULT_ASSET_CONCURRENCY;
 }
-async function processAsset(resource, prepAsset, options) {
+async function processAsset(resolvedResource, prepAsset, options) {
+    const { resource } = resolvedResource;
     const { auth, blueprintFileDir, installer, fetchFn } = options;
     let assetTimeoutTimer;
     let result;
     try {
         result = await Promise.race([
-            stashAsset({ resource, prepAsset, blueprintFileDir, auth, fetchFn, installer }),
+            stashAsset({ resolvedResource, prepAsset, blueprintFileDir, auth, fetchFn, installer }),
             new Promise((_, reject) => {
                 assetTimeoutTimer = setTimeout(() => {
                     reject(new Error(`Processing ${resource.name} timed out after ${assetTimeoutS}s`));

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

@@ -13,7 +13,11 @@ type ListStacksResponse = {
     stacks?: unknown;
     response?: Response;
 };
-export declare function listStacks(auth: AuthParams, logger: Logger): Promise<ListStacksResponse>;
+export declare function listStacks(auth: AuthParams, logger: Logger, options?: {
+    fetchFn?: typeof fetch;
+    cursor?: string;
+    limit?: number;
+}): Promise<ListStacksResponse>;
 type GetStackResponse = {
     ok: true;
     error: null;
@@ -31,10 +35,11 @@ export declare function getStack({ stackId, auth, fetchFn, }: {
     fetchFn: typeof fetch;
 }): Promise<GetStackResponse>;
 type CreateStackResponse = GetStackResponse;
-export declare function createStack({ stackMutation, auth, logger, }: {
+export declare function createStack({ stackMutation, auth, logger, fetchFn, }: {
     stackMutation: StackMutation;
     auth: AuthParams;
     logger: Logger;
+    fetchFn?: typeof fetch;
 }): Promise<CreateStackResponse>;
 export declare function createEmptyStack({ token, scopeType, scopeId, name, logger, }: {
     token: string;

package/dist/actions/blueprints/stacks.js

@@ -3,10 +3,15 @@ import getHeaders from '../../utils/get-headers.js';
 import { getRequestId } from '../../utils/request-id.js';
 import { createTracedFetch } from '../../utils/traced-fetch.js';
 export const stacksUrl = blueprintsUrl('stacks');
-export async function listStacks(auth, logger) {
-    const fetchFn = createTracedFetch(logger);
+export async function listStacks(auth, logger, options = {}) {
+    const fetchFn = options.fetchFn ?? createTracedFetch(logger);
+    const url = new URL(stacksUrl);
+    if (options.cursor)
+        url.searchParams.set('cursor', options.cursor);
+    if (options.limit !== undefined)
+        url.searchParams.set('limit', String(options.limit));
     try {
-        const response = await fetchFn(stacksUrl, {
+        const response = await fetchFn(url.toString(), {
             method: 'GET',
             headers: getHeaders(auth),
         });
@@ -27,7 +32,7 @@ export async function listStacks(auth, logger) {
 }
 export async function getStack({ stackId, auth, fetchFn, }) {
     try {
-        const response = await fetchFn(`${stacksUrl}/${stackId}`, {
+        const response = await fetchFn(`${stacksUrl}/${encodeURIComponent(stackId)}`, {
             method: 'GET',
             headers: getHeaders(auth),
         });
@@ -46,9 +51,8 @@ export async function getStack({ stackId, auth, fetchFn, }) {
         };
     }
 }
-export async function createStack({ stackMutation, auth, logger, }) {
+export async function createStack({ stackMutation, auth, logger, fetchFn = createTracedFetch(logger), }) {
     try {
-        const fetchFn = createTracedFetch(logger);
         const response = await fetchFn(stacksUrl, {
             method: 'POST',
             headers: getHeaders(auth),

package/dist/actions/blueprints/wait-for-operation.d.ts

@@ -8,6 +8,7 @@ export interface WaitForOperationOptions {
     log: Logger;
     bin: string;
     verbose?: boolean;
+    fetchFn?: typeof fetch;
     /** Keep the operation queryable after the stack is gone (destroy). */
     includeDestroyed?: boolean;
     /** Noun for the idle message, e.g. "deployment" or "destruction". */

package/dist/actions/blueprints/wait-for-operation.js

@@ -9,7 +9,7 @@ import { classifyOperationPoll, getOperation } from './operations.js';
  */
 export async function waitForOperation(options) {
     const { stackId, operationId, auth, log, bin, verbose = false, includeDestroyed, progressNoun, } = options;
-    const fetchFn = createTracedFetch(log);
+    const fetchFn = options.fetchFn ?? createTracedFetch(log);
     const waitFor = createWaitFor({
         bin,
         log,

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

@@ -1,3 +1,4 @@
+import type { BlueprintResource } from '@sanity/blueprints';
 import type { ReadBlueprintResult } from '../../actions/blueprints/blueprint.js';
 import type { AuthParams, ScopeType, Stack } from '../../utils/types.js';
 import type { CoreConfig, CoreResult } from '../index.js';
@@ -19,3 +20,10 @@ export interface BlueprintDeployOptions extends CoreConfig {
     };
 }
 export declare function blueprintDeployCore(options: BlueprintDeployOptions): Promise<CoreResult>;
+export interface ResourceDeployOptions extends Omit<BlueprintDeployOptions, 'blueprint'> {
+    resources: BlueprintResource[];
+    workDir: string;
+    fetchFn?: typeof fetch;
+}
+/** Deploy an in-memory resource list using the same pipeline as a Blueprint file. */
+export declare function deployResourcesCore(options: ResourceDeployOptions): Promise<CoreResult>;

package/dist/cores/blueprints/deploy.js

@@ -14,16 +14,23 @@ import { styleText } from '../../utils/style-text.js';
 import { createTracedFetch } from '../../utils/traced-fetch.js';
 import { getWarnings } from '../../utils/warnings.js';
 export async function blueprintDeployCore(options) {
-    const { bin = 'sanity', log: logger, auth, stackId, scopeType, scopeId, deployedStack, blueprint, cliVersion, flags, } = options;
+    return deployResourcesCore({
+        ...options,
+        resources: options.blueprint.resources,
+        workDir: dirname(options.blueprint.fileInfo.blueprintFilePath),
+    });
+}
+/** Deploy an in-memory resource list using the same pipeline as a Blueprint file. */
+export async function deployResourcesCore(options) {
+    const { bin = 'sanity', log: logger, auth, stackId, scopeType, scopeId, deployedStack, workDir: blueprintFileDir, cliVersion, flags, } = options;
     const { verbose } = flags;
     const noWait = flags['no-wait'] || false;
     const stackName = flags['new-stack-name'] ?? deployedStack.name;
     const installer = flags['fn-installer'] || undefined;
-    const blueprintFileDir = dirname(blueprint.fileInfo.blueprintFilePath);
     const workspaceWarnings = getWarnings({ dir: blueprintFileDir });
     logger(`Deploying "${stackName}" ${niceId(deployedStack.id)}...`);
     try {
-        const fetchFn = createTracedFetch(logger);
+        const fetchFn = options.fetchFn ?? createTracedFetch(logger);
         const { ok: checkOk, stack: currentStack } = await getStack({ stackId, auth, fetchFn });
         if (!checkOk) {
             return { success: false, error: 'Failed to check current Stack status' };
@@ -39,7 +46,7 @@ export async function blueprintDeployCore(options) {
                 ],
             };
         }
-        const resources = [...blueprint.resources];
+        const resources = [...options.resources];
         let spinner;
         const preDeployResult = await preDeploy({
             scopeType,
@@ -143,6 +150,7 @@ export async function blueprintDeployCore(options) {
             bin,
             verbose,
             progressNoun: 'deployment',
+            fetchFn,
         });
         if (outcome.type === 'completed') {
             logger(styleText(['bold', 'green'], 'Stack deployment completed!'));

package/dist/cores/functions/test.js

@@ -55,7 +55,7 @@ export async function functionTestCore(options) {
             apiHost: config.apiUrl,
             token: config.token || undefined,
             withUserToken,
-            resources: resolvedResources,
+            resolvedResources,
             blueprintFileDir: dirname(blueprint.fileInfo.blueprintFilePath),
             log,
         };
@@ -116,7 +116,9 @@ export async function functionTestCore(options) {
             }
         };
         const logNestedRuns = () => {
-            for (const run of [...nestedRuns].sort((a, b) => a.order - b.order)) {
+            // Remove buffered logs for durable runs
+            const runs = plan.isDurable ? nestedRuns.splice(0) : [...nestedRuns];
+            for (const run of runs.sort((a, b) => a.order - b.order)) {
                 // Skip if is Durable so log ordering is retained
                 if (run.isLiveDurable)
                     continue;
@@ -155,10 +157,19 @@ export async function functionTestCore(options) {
                 if (event.kind === 'delegate') {
                     logNestedRuns();
                 }
-                const glyph = STEP_PHASE_GLYPH[event.phase] ?? '•';
+                const willRetry = event.phase === 'error' && typeof event.retryDelayMs === 'number';
+                const glyph = willRetry ? '⟳' : (STEP_PHASE_GLYPH[event.phase] ?? '•');
                 const duration = typeof event.durationMs === 'number' ? ` (${Math.round(event.durationMs)}ms)` : '';
+                const retriesPerformed = (event.attempt ?? 1) - 1;
+                let retryNote = '';
+                if (willRetry) {
+                    retryNote = ` retry ${event.attempt} of ${event.maxAttempts}`;
+                }
+                else if (event.phase === 'error' && retriesPerformed > 0) {
+                    retryNote = ` failed after ${retriesPerformed} retries`;
+                }
                 const detail = event.phase === 'error' && event.error ? ` ${event.error.message}` : '';
-                lines.push(`  ${glyph} ${event.name} [${event.kind}]${duration}${detail}`);
+                lines.push(`  ${glyph} ${event.name} [${event.kind}]${duration}${detail}${retryNote}`);
             }
             return lines;
         }

package/dist/functions/artifacts.d.ts

@@ -0,0 +1,13 @@
+export declare const functionOutputFileName = "index.js";
+/** Metadata for a compiled function, resolved without loading its handler. */
+export interface FunctionBuild {
+    name: string;
+    src: string;
+    entryPoint: string;
+}
+/** Validate artifacts produced by buildFunction before packaging or deployment. */
+export declare function readFunctionBuild(options: {
+    name: string;
+    src: string;
+    workDir: string;
+}): Promise<FunctionBuild>;

package/dist/functions/artifacts.js

@@ -0,0 +1,26 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { findFunctionEntryPoint } from '../utils/functions/find-entry-point.js';
+export const functionOutputFileName = 'index.js';
+/** Validate artifacts produced by buildFunction before packaging or deployment. */
+export async function readFunctionBuild(options) {
+    const { name, workDir } = options;
+    const src = path.resolve(workDir, options.src);
+    try {
+        const pkg = JSON.parse(await readFile(path.join(src, 'package.json'), 'utf8'));
+        if (!pkg ||
+            typeof pkg !== 'object' ||
+            !('main' in pkg) ||
+            pkg.main !== functionOutputFileName ||
+            !('type' in pkg) ||
+            pkg.type !== 'module')
+            throw new Error('The function package metadata does not match its build format.');
+        const entryPoint = await findFunctionEntryPoint(src, name);
+        if (entryPoint !== path.join(src, functionOutputFileName))
+            throw new Error(`The compiled entry ${functionOutputFileName} is missing.`);
+        return { name, src, entryPoint };
+    }
+    catch (error) {
+        throw new Error(`Function "${name}" is not built. Run sanity build first.`, { cause: error });
+    }
+}

package/dist/functions/build.d.ts

@@ -0,0 +1,15 @@
+import { type FunctionContract } from './contracts.js';
+export interface BuildFunctionOptions {
+    name: string;
+    contract?: FunctionContract;
+    /** Function directory or entry file, relative to workDir. */
+    src: string;
+    workDir: string;
+    /** Build output directory, relative to workDir. Its contents are replaced. */
+    outDir: string;
+}
+/** Build a standalone ESM function bundle without a blueprint, stack, or ZIP. */
+export declare function buildFunction({ name, src, workDir, outDir, contract, }: BuildFunctionOptions): Promise<{
+    outputDir: string;
+}>;
+export { type FunctionBuild, readFunctionBuild } from './artifacts.js';

package/dist/functions/build.js

@@ -0,0 +1,27 @@
+import path from 'node:path';
+import { findFunctionEntryPoint } from '../utils/functions/find-entry-point.js';
+import { transpileFunction } from '../utils/functions/transpile/function.js';
+import { functionOutputFileName } from './artifacts.js';
+import { functionContractPlugin } from './contractPlugin.js';
+import { generateFunctionContracts } from './contracts.js';
+/** Build a standalone ESM function bundle without a blueprint, stack, or ZIP. */
+export async function buildFunction({ name, src, workDir, outDir, contract, }) {
+    const functionPath = path.resolve(workDir, src);
+    const entryPoint = await findFunctionEntryPoint(functionPath, name);
+    const resolvedContract = contract ?? (await generateFunctionContracts({ workDir, functions: [{ name, src }] }))[0];
+    if (resolvedContract.entryPoint !== entryPoint || resolvedContract.name !== name)
+        throw new Error(`Function contract does not match "${name}".`);
+    const validation = functionContractPlugin(resolvedContract);
+    const result = await transpileFunction({
+        resource: { name, src, type: 'sanity.function.pubsub' },
+        functionPath,
+        entryPoint: validation.entryPoint,
+        plugins: [validation.plugin],
+        workDir,
+        outDir: path.resolve(workDir, outDir),
+        outputFileName: functionOutputFileName,
+        bundle: true,
+    });
+    return { outputDir: result.outputDir };
+}
+export { readFunctionBuild } from './artifacts.js';

package/dist/functions/contractPlugin.d.ts

@@ -0,0 +1,7 @@
+import type { Plugin } from 'vite';
+import type { FunctionContract } from './contracts.js';
+/** Build a validating PubSub entry around the original handler. */
+export declare function functionContractPlugin(contract: FunctionContract): {
+    entryPoint: string;
+    plugin: Plugin;
+};

package/dist/functions/contractPlugin.js

@@ -0,0 +1,32 @@
+import { jsonGuard, validatorSource } from './contracts/validation.js';
+/** Build a validating PubSub entry around the original handler. */
+export function functionContractPlugin(contract) {
+    const entryPoint = `virtual:sanity-function-contract:${contract.name}`;
+    const resolvedId = `\0${entryPoint}`;
+    const source = `import {handler as implementation} from ${JSON.stringify(contract.entryPoint.replaceAll('\\', '/'))}
+${jsonGuard}
+const validateInput = ${validatorSource(contract.input)}
+const validateOutput = ${validatorSource(contract.output)}
+export async function handler(envelope) {
+  let input = envelope?.event?.data
+  ${contract.input.kind === 'void' ? "if (input !== null && typeof input === 'object' && !Array.isArray(input) && Object.keys(input).length === 0) input = undefined" : ''}
+  if (!validateInput(input)) throw new TypeError(${JSON.stringify(`Invalid input for function "${contract.name}". Match its declared input type.`)})
+  const result = await implementation(envelope)
+  if (!validateOutput(result)) throw new TypeError(${JSON.stringify(`Function "${contract.name}" returned data that does not match its declared return type.`)})
+  return result
+}`;
+    return {
+        entryPoint,
+        plugin: {
+            name: 'sanity/function-contract',
+            resolveId(id) {
+                if (id === entryPoint)
+                    return resolvedId;
+            },
+            load(id) {
+                if (id === resolvedId)
+                    return source;
+            },
+        },
+    };
+}

package/dist/functions/contracts/schema.d.ts

@@ -0,0 +1,22 @@
+import ts from 'typescript-compiler';
+export type ContractSchema = {
+    kind: 'string' | 'number' | 'boolean' | 'null' | 'void' | 'never';
+} | {
+    kind: 'literal';
+    value: string | number | boolean;
+} | {
+    kind: 'array';
+    items: ContractSchema;
+} | {
+    kind: 'union';
+    variants: ContractSchema[];
+} | {
+    kind: 'object';
+    properties: Record<string, {
+        optional: boolean;
+        schema: ContractSchema;
+    }>;
+    additional?: ContractSchema;
+};
+export declare function schemaFromType(checker: ts.TypeChecker, type: ts.Type, location: string, allowVoid?: boolean, parents?: Set<ts.Type>): ContractSchema;
+export declare function contractType(schema: ContractSchema): string;