@sanity/runtime-cli 14.4.0 → 14.5.1

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.4.0 linux-x64 node-v24.14.0
+@sanity/runtime-cli/14.5.1 linux-x64 node-v24.14.0
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -98,7 +98,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.4.0/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -133,7 +133,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.4.0/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -158,15 +158,19 @@ DESCRIPTION
 
   Use --no-wait to queue the deployment and return immediately without waiting for completion.
 
+  Use --fn-installer to force which package manager to use when deploying functions.
+
   Set SANITY_ASSET_TIMEOUT (seconds) to override the 60-second timeout for processing resource assets.
 
 EXAMPLES
   $ sanity-run blueprints deploy
 
   $ sanity-run blueprints deploy --no-wait
+
+  $ sanity-run blueprints deploy --fn-installer npm
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.4.0/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -198,7 +202,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.4.0/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -224,7 +228,7 @@ DESCRIPTION
   issues.
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v14.4.0/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -254,7 +258,7 @@ EXAMPLES
   $ sanity-run blueprints info --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v14.4.0/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -304,7 +308,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.4.0/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -333,7 +337,7 @@ EXAMPLES
   $ sanity-run blueprints logs --watch
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.4.0/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -359,7 +363,7 @@ EXAMPLES
   $ sanity-run blueprints plan
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v14.4.0/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -388,7 +392,7 @@ EXAMPLES
   $ sanity-run blueprints stacks --organization-id <organizationId>
 ```
 
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v14.4.0/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -437,7 +441,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.4.0/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -471,7 +475,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v14.4.0/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -498,7 +502,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.4.0/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -522,7 +526,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.4.0/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -548,7 +552,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.4.0/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -588,7 +592,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.4.0/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -642,7 +646,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.4.0/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v14.5.1/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

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

@@ -1,12 +1,13 @@
 import AdmZip from 'adm-zip';
 import type { Logger } from '../../utils/logger.js';
-import type { AuthParams, CollectionFunction, FunctionResource } from '../../utils/types.js';
+import type { AuthParams, CollectionFunction, FunctionResource, InstallerType } from '../../utils/types.js';
 export declare const ASSET_CHECK_URL: string;
 export declare const ASSET_STASH_URL: string;
-export declare function stashAsset({ resource, auth, logger, }: {
+export declare function stashAsset({ resource, auth, logger, installer, }: {
     resource: FunctionResource | CollectionFunction;
     auth: AuthParams;
     logger: ReturnType<typeof Logger>;
+    installer?: InstallerType;
 }): Promise<{
     success: boolean;
     assetId?: string;

package/dist/actions/blueprints/assets.js

@@ -14,14 +14,14 @@ const { apiUrl } = config;
 const ASSETS_URL = `${apiUrl}vX/blueprints/assets`;
 export const ASSET_CHECK_URL = `${ASSETS_URL}/check`;
 export const ASSET_STASH_URL = `${ASSETS_URL}/stash`;
-export async function stashAsset({ resource, auth, logger, }) {
+export async function stashAsset({ resource, auth, logger, installer, }) {
     const isCollection = isLocalFunctionCollection(resource);
     const functions = isCollection ? resource.functions : [resource];
     const combinedAsset = [];
     const prepareErrors = [];
     try {
         for (const func of functions) {
-            const prepResult = await prepareAsset({ resource: func });
+            const prepResult = await prepareAsset({ resource: func }, { installer });
             if (prepResult.success && prepResult.outputPath && prepResult.cleanup) {
                 combinedAsset.push({
                     name: func.name,
@@ -175,7 +175,18 @@ export function hashBuffer(buffer) {
 }
 export async function pathToZip(path) {
     const stats = await fs.promises.stat(path);
-    const zip = new AdmZip();
+    const zip = new AdmZip(undefined, {
+        fs: {
+            ...fs,
+            // @ts-expect-error monkey patching to return matching mtime for builds
+            statSync(path, options) {
+                const s = fs.statSync(path, options);
+                if (s)
+                    s.mtime = new Date(0);
+                return s;
+            },
+        },
+    });
     if (stats.isDirectory())
         zip.addLocalFolder(path);
     else

package/dist/commands/blueprints/add.js

@@ -8,6 +8,7 @@ import { LocalBlueprintCommand } from '../../baseCommands.js';
 import { FUNCTION_TYPES } from '../../constants.js';
 import { functionAddCore } from '../../cores/functions/index.js';
 import { Logger } from '../../utils/logger.js';
+import { INSTALLER_OPTIONS } from '../../utils/types.js';
 // import {warn} from '../../utils/display/presenters.js'
 export default class AddCommand extends LocalBlueprintCommand {
     // static state = 'deprecated'
@@ -69,7 +70,7 @@ After adding a function, use 'functions dev' to test locally, then 'blueprints d
         'fn-installer': Flags.string({
             description: 'Which package manager to use when installing the @sanity/functions helpers',
             aliases: ['function-installer', 'installer'],
-            options: ['skip', 'npm', 'pnpm', 'yarn'],
+            options: ['skip', ...INSTALLER_OPTIONS],
         }),
         install: Flags.boolean({
             description: 'Shortcut for --fn-installer npm',

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

@@ -5,6 +5,7 @@ export default class DeployCommand extends DeployedStackCommand<typeof DeployCom
     static examples: string[];
     static flags: {
         stack: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'fn-installer': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'no-wait': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'new-stack-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };

package/dist/commands/blueprints/deploy.js

@@ -2,6 +2,7 @@ import { Flags } from '@oclif/core';
 import { DeployedStackCommand, stackFlag, unhide } from '../../baseCommands.js';
 import { blueprintDeployCore } from '../../cores/blueprints/deploy.js';
 import { Logger } from '../../utils/logger.js';
+import { INSTALLER_OPTIONS } from '../../utils/types.js';
 export default class DeployCommand extends DeployedStackCommand {
     static summary = 'Deploy the local Blueprint to the remote Stack';
     static description = `Pushes your local Blueprint configuration to the remote Stack; provisioning, updating, or destroying resources as needed. This is the primary command for applying infrastructure changes.
@@ -10,13 +11,22 @@ Before deploying, run 'blueprints plan' to preview changes. After deployment, us
 
 Use --no-wait to queue the deployment and return immediately without waiting for completion.
 
+Use --fn-installer to force which package manager to use when deploying functions.
+
 Set SANITY_ASSET_TIMEOUT (seconds) to override the 60-second timeout for processing resource assets.`;
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --no-wait',
+        '<%= config.bin %> <%= command.id %> --fn-installer npm',
     ];
     static flags = {
         stack: unhide(stackFlag),
+        'fn-installer': Flags.string({
+            description: 'Which package manager to use when installing Function dependencies',
+            aliases: ['function-installer', 'installer'],
+            options: [...INSTALLER_OPTIONS],
+            hidden: true,
+        }),
         'no-wait': Flags.boolean({
             description: 'Do not wait for Stack deployment to complete',
             default: false,

package/dist/commands/functions/add.js

@@ -3,6 +3,7 @@ import { LocalBlueprintCommand } from '../../baseCommands.js';
 import { FUNCTION_TYPES } from '../../constants.js';
 import { functionAddCore } from '../../cores/functions/index.js';
 import { Logger } from '../../utils/logger.js';
+import { INSTALLER_OPTIONS } from '../../utils/types.js';
 export default class AddCommand extends LocalBlueprintCommand {
     static summary = 'Add a Function to your Blueprint';
     static description = `Scaffolds a new Function in the functions/ folder and templates a resource for your Blueprint manifest.
@@ -51,7 +52,7 @@ After adding, use 'functions dev' to test locally, then 'blueprints deploy' to p
         }),
         installer: Flags.string({
             description: 'How to install the @sanity/functions helpers',
-            options: ['skip', 'npm', 'pnpm', 'yarn'],
+            options: ['skip', ...INSTALLER_OPTIONS],
         }),
         install: Flags.boolean({
             description: 'Shortcut for --fn-installer npm',

package/dist/commands/functions/build.d.ts

@@ -6,6 +6,7 @@ export default class BuildCommand extends LocalBlueprintCommand<typeof BuildComm
         name: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
+        'fn-installer': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'out-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;

package/dist/commands/functions/build.js

@@ -2,6 +2,7 @@ import { Args, Flags } from '@oclif/core';
 import { LocalBlueprintCommand } from '../../baseCommands.js';
 import { functionBuildCore } from '../../cores/functions/build.js';
 import { Logger } from '../../utils/logger.js';
+import { INSTALLER_OPTIONS } from '../../utils/types.js';
 export default class BuildCommand extends LocalBlueprintCommand {
     static summary = 'Build Sanity Function(s) to zip archives';
     static hidden = true;
@@ -9,6 +10,12 @@ export default class BuildCommand extends LocalBlueprintCommand {
         name: Args.string({ description: 'The name of the Sanity Function', required: false }),
     };
     static flags = {
+        'fn-installer': Flags.string({
+            description: 'Which package manager to use when building Functions',
+            aliases: ['function-installer', 'installer'],
+            options: [...INSTALLER_OPTIONS],
+            hidden: true,
+        }),
         'out-dir': Flags.string({ char: 'o', description: 'Output directory for zip files' }),
     };
     async run() {

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

@@ -9,6 +9,7 @@ export interface BlueprintDeployOptions extends CoreConfig {
     deployedStack: Stack;
     blueprint: ReadBlueprintResult;
     flags: {
+        'fn-installer'?: string;
         'no-wait'?: boolean;
         'new-stack-name'?: string;
         verbose?: boolean;

package/dist/cores/blueprints/deploy.js

@@ -14,6 +14,7 @@ export async function blueprintDeployCore(options) {
     const { verbose } = flags;
     const noWait = flags['no-wait'] || false;
     const stackName = flags['new-stack-name'] ?? deployedStack.name;
+    const installer = flags['fn-installer'] || undefined;
     log(`Deploying "${stackName}" ${niceId(deployedStack.id)}...`);
     try {
         const { ok: checkOk, stack: currentStack } = await getStack({ stackId, auth, logger: log });
@@ -44,7 +45,7 @@ export async function blueprintDeployCore(options) {
                 let result;
                 try {
                     result = await Promise.race([
-                        stashAsset({ resource, auth, logger: log }),
+                        stashAsset({ resource, auth, logger: log, installer }),
                         new Promise((_, reject) => {
                             assetTimeoutTimer = setTimeout(() => {
                                 reject(new Error(`Processing ${resource.name} timed out after ${assetTimeoutS}s`));

package/dist/cores/functions/build.d.ts

@@ -6,6 +6,7 @@ export interface FunctionBuildOptions extends CoreConfig {
         name: string | undefined;
     };
     flags: {
+        'fn-installer'?: string;
         'out-dir'?: string;
     };
 }

package/dist/cores/functions/build.js

@@ -20,13 +20,14 @@ export async function functionBuildCore(options) {
     else {
         functions = allFunctions;
     }
+    const installer = flags['fn-installer'] || undefined;
     const outDir = flags['out-dir'] || path.join(path.dirname(blueprint.fileInfo.blueprintFilePath), '.build');
     await fs.promises.mkdir(outDir, { recursive: true });
     const errors = [];
     const built = [];
     for (const resource of functions) {
         const spinner = log.ora(`Building ${resource.name}...`).start();
-        const prepResult = await prepareAsset({ resource });
+        const prepResult = await prepareAsset({ resource }, { installer });
         if (!prepResult.success || !prepResult.outputPath) {
             spinner.fail(`Failed to build ${resource.name}`);
             errors.push({ name: resource.name, error: prepResult.error ?? 'Unknown error' });

package/dist/cores/functions/logs.js

@@ -111,9 +111,18 @@ function formatLog(time, level, message, utc) {
     ].join(' ');
 }
 function logLevel(level) {
-    if (level === 'ERROR')
-        return styleText('red', level);
-    if (level === 'WARN')
-        return styleText('yellow', level);
-    return styleText('green', level);
+    switch (level) {
+        case 'ERROR':
+            return styleText('red', level);
+        case 'WARN':
+            return styleText('yellow', level);
+        case 'TRACE':
+            return styleText('grey', level);
+        case 'DEBUG':
+            return styleText('blue', level);
+        case 'FATAL':
+            return styleText(['bold', 'red'], level);
+        default:
+            return styleText('green', level);
+    }
 }

package/dist/utils/display/blueprints-formatting.js

@@ -19,7 +19,7 @@ const RESOURCE_CATEGORIES = {
         },
     },
     [SANITY_ACCESS_ROBOT]: {
-        label: 'Robots',
+        label: 'Robot Tokens',
         displayNameAttribute: 'label',
         formatDetails(res) {
             return isRobotResource(res) ? arrayifyRobot(res) : [];

package/dist/utils/functions/detect-native-modules.d.ts

@@ -1,6 +1,12 @@
 import type AdmZip from 'adm-zip';
+import type { FunctionResource } from '../types.js';
 /**
- * Scan zip entries of dependencies for native modules.
+ * Recurse node_modules for native modules.
  * Native modules built on one platform may not work on another (e.g., macOS vs Linux)
  */
 export declare const detectNativeModules: (zip: AdmZip) => string[];
+/**
+ * Finds the dependencies of the function and compares to the workspace root to see if any native modules are included.
+ * Due to how PNPM with workspaces symlinks dependencies, we have to check the workspace root for native modules prior to the bundle step.
+ */
+export declare const detectNativeModulesForBundle: (resource: FunctionResource) => string[];

package/dist/utils/functions/detect-native-modules.js

@@ -1,9 +1,13 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { cwd } from 'node:process';
+import { createPnpmRequire } from '../pnpm.js';
 /**
  * Patterns to identify native modules based on common file types and build configurations.
  */
 const KNOWN_MODULE_PATTERNS = [/binding\.gyp$/, /\.node$/];
 /**
- * Scan zip entries of dependencies for native modules.
+ * Recurse node_modules for native modules.
  * Native modules built on one platform may not work on another (e.g., macOS vs Linux)
  */
 export const detectNativeModules = (zip) => {
@@ -24,3 +28,67 @@ export const detectNativeModules = (zip) => {
         throw new Error(`Failed to scan zip for native modules: ${message}`);
     }
 };
+/**
+ * Recursively checks a directory for files that match known native module patterns.
+ */
+const hasNativeFiles = (directory) => {
+    for (const name of readdirSync(directory)) {
+        // don't recurse back into node_modules.
+        if (name === 'node_modules')
+            continue;
+        const fullPath = path.join(directory, name);
+        if (statSync(fullPath).isDirectory()) {
+            if (hasNativeFiles(fullPath))
+                return true;
+        }
+        else if (KNOWN_MODULE_PATTERNS.some((pattern) => pattern.test(name))) {
+            return true;
+        }
+    }
+    return false;
+};
+/**
+ * Finds the dependencies of the function and compares to the workspace root to see if any native modules are included.
+ * Due to how PNPM with workspaces symlinks dependencies, we have to check the workspace root for native modules prior to the bundle step.
+ */
+export const detectNativeModulesForBundle = (resource) => {
+    if (!resource.src)
+        throw new Error('Resource src is required');
+    const hasWorkspace = existsSync(path.join(cwd(), 'pnpm-workspace.yaml'));
+    if (!hasWorkspace) {
+        return [];
+    }
+    const sourcePath = path.resolve(cwd(), resource.src);
+    const stats = statSync(sourcePath);
+    const entryDir = stats.isFile() ? path.dirname(sourcePath) : sourcePath;
+    const hasPackageJson = existsSync(path.join(entryDir, 'package.json'));
+    if (!hasPackageJson) {
+        throw new Error('pnpm workspace detected but no package.json found in function src');
+    }
+    // gets package.json dependencies of the function. We use these function deps to compare against the workspace root modules.
+    const pkgJsonPath = path.join(entryDir, 'package.json');
+    // a function should always have deps, but this will just be a little safer.
+    const functionDeps = JSON.parse(readFileSync(pkgJsonPath, 'utf-8')).dependencies ?? {};
+    const workspaceModules = createPnpmRequire(cwd());
+    const nativeModules = [];
+    for (const depName of Object.keys(functionDeps)) {
+        try {
+            const resolved = workspaceModules.resolve(depName);
+            let currentDir = path.dirname(resolved);
+            while (currentDir !== cwd() && currentDir !== path.parse(currentDir).root) {
+                // look for node_module package.json to locate top level
+                if (existsSync(path.join(currentDir, 'package.json'))) {
+                    if (hasNativeFiles(currentDir)) {
+                        nativeModules.push(depName);
+                        break;
+                    }
+                }
+                currentDir = path.dirname(currentDir);
+            }
+        }
+        catch (_e) {
+            // If we fail to resolve, just skip
+        }
+    }
+    return nativeModules;
+};

package/dist/utils/functions/prepare-asset.d.ts

@@ -1,6 +1,8 @@
-import type { CollectionFunction, FunctionResource } from '../types.js';
+import type { CollectionFunction, FunctionResource, InstallerType } from '../types.js';
 export declare function prepareAsset({ resource, }: {
     resource: FunctionResource | CollectionFunction;
+}, { installer }?: {
+    installer?: InstallerType;
 }): Promise<{
     success: boolean;
     outputPath?: string;

package/dist/utils/functions/prepare-asset.js

@@ -1,12 +1,14 @@
+import { rm, stat } from 'node:fs/promises';
 import path from 'node:path';
 import { cwd } from 'node:process';
 import { MAX_ASSET_SIZE } from '../../constants.js';
 import { transpileFunction } from '../transpile/transpile-function.js';
+import { detectNativeModulesForBundle } from './detect-native-modules.js';
 import { getFolderSize } from './getFolderSize.js';
 import { resolveResourceDependencies } from './resolve-dependencies.js';
 import { shouldAutoResolveDependencies } from './should-auto-resolve-deps.js';
 import { shouldTranspileFunction } from './should-transpile.js';
-export async function prepareAsset({ resource, }) {
+export async function prepareAsset({ resource, }, { installer } = {}) {
     if (!resource.src)
         throw new Error('Resource src is required');
     let functionPath = path.join(cwd(), resource.src);
@@ -15,7 +17,13 @@ export async function prepareAsset({ resource, }) {
     const shouldTranspile = await shouldTranspileFunction(resource);
     if (shouldTranspile) {
         try {
-            const result = await transpileFunction(resource);
+            const hasNativeModules = detectNativeModulesForBundle(resource);
+            if (hasNativeModules.length) {
+                const errorMsg = `Native modules detected:\n${hasNativeModules.join('\n')}\n\n` +
+                    `Please replace with JavaScript alternatives.`;
+                throw new Error(errorMsg);
+            }
+            const result = await transpileFunction(resource, { installer });
             functionPath = result.outputDir;
             cleanup = result.cleanup;
             wasBundled = result.bundled;
@@ -26,7 +34,8 @@ export async function prepareAsset({ resource, }) {
     }
     const shouldResolveDependencies = await shouldAutoResolveDependencies(resource);
     if (shouldResolveDependencies && !wasBundled) {
-        await resolveResourceDependencies(resource, shouldTranspile);
+        await resolveResourceDependencies(resource, { transpiled: shouldTranspile, installer });
+        await removeArcAutoInstallPackageJson(functionPath);
     }
     try {
         const size = getFolderSize(functionPath);
@@ -39,3 +48,19 @@ export async function prepareAsset({ resource, }) {
         return { success: false, error: err instanceof Error ? err.message : `${err}` };
     }
 }
+/**
+ * Remove file that contains the current date to prevent the hash from changing in the final asset.
+ * @param functionPath The path to the built function
+ */
+async function removeArcAutoInstallPackageJson(functionPath) {
+    const arcAutoInstallPackageJson = path.join(functionPath, 'node_modules', '_arc-autoinstall', 'package.json');
+    try {
+        const fileStat = await stat(arcAutoInstallPackageJson);
+        if (fileStat.isFile()) {
+            await rm(arcAutoInstallPackageJson);
+        }
+    }
+    catch {
+        // ignore errors
+    }
+}

package/dist/utils/functions/resolve-dependencies.d.ts

@@ -1,2 +1,5 @@
-import type { FunctionResource } from '../types.js';
-export declare function resolveResourceDependencies(resource: FunctionResource, transpiled: boolean): Promise<void>;
+import type { FunctionResource, InstallerType } from '../types.js';
+export declare function resolveResourceDependencies(resource: FunctionResource, { transpiled, installer, }: {
+    transpiled: boolean;
+    installer?: InstallerType;
+}): Promise<void>;

package/dist/utils/functions/resolve-dependencies.js

@@ -3,25 +3,22 @@ import { join } from 'node:path';
 import hydrate from '@architect/hydrate';
 import inventory from '@architect/inventory';
 import { convertResourceToArcFormat } from './resource-to-arc.js';
-export async function resolveResourceDependencies(resource, transpiled) {
+export async function resolveResourceDependencies(resource, { transpiled, installer, }) {
     const rawArc = await convertResourceToArcFormat(resource, transpiled);
     const inv = await inventory({ rawArc });
     const cwd = inv.inv._project.cwd;
-    const installOptions = {
-        inventory: inv,
-        hydrateShared: false,
-        quiet: true,
-        pnpm: false,
-        yarn: false,
-    };
-    if (existsSync(join(cwd, 'pnpm-lock.yaml'))) {
-        installOptions.pnpm = true;
+    let installType = 'npm';
+    if (installer) {
+        installType = installer;
+    }
+    else if (existsSync(join(cwd, 'pnpm-lock.yaml'))) {
+        installType = 'pnpm';
     }
     else if (existsSync(join(cwd, 'yarn.lock'))) {
-        installOptions.yarn = true;
+        installType = 'yarn';
     }
     try {
-        await hydrate.install(installOptions);
+        await hydrate.install(toInstallerOptions(inv, installType));
     }
     catch (err) {
         // This is a temporary fix.
@@ -32,3 +29,13 @@ export async function resolveResourceDependencies(resource, transpiled) {
         }
     }
 }
+function toInstallerOptions(inv, type) {
+    return {
+        inventory: inv,
+        hydrateShared: false,
+        quiet: true,
+        npm: type === 'npm',
+        pnpm: type === 'pnpm',
+        yarn: type === 'yarn',
+    };
+}

package/dist/utils/invoke-local.js

@@ -84,7 +84,7 @@ export default async function invoke(resource, payload, context, options) {
     }
     const shouldResolveDependencies = await shouldAutoResolveDependencies(resource);
     if (shouldResolveDependencies && existingPackageJson) {
-        await resolveResourceDependencies(resource, shouldTranspile);
+        await resolveResourceDependencies(resource, { transpiled: shouldTranspile });
     }
     if (!existingPackageJson) {
         createTempPackageJson(functionPath);

package/dist/utils/pnpm.d.ts

@@ -0,0 +1 @@
+export declare const createPnpmRequire: (workspaceRoot: string) => NodeJS.Require;

package/dist/utils/pnpm.js

@@ -0,0 +1,9 @@
+import { createRequire } from 'node:module';
+import path from 'node:path';
+export const createPnpmRequire = (workspaceRoot) => {
+    const pnpmModulesPath = path.join(workspaceRoot, 'node_modules', '.pnpm', 'node_modules');
+    // createRequire gives us Node's full module resolution algorithm rooted at
+    // the pnpm virtual store — it reads package.json exports/main and returns
+    // the absolute path to the actual entry file, not just the directory.
+    return createRequire(path.join(pnpmModulesPath, '_virtual.js'));
+};

package/dist/utils/transpile/transpile-function.d.ts

@@ -1,5 +1,7 @@
-import type { FunctionResource } from '../types.js';
-export declare function transpileFunction(resource: FunctionResource): Promise<{
+import type { FunctionResource, InstallerType } from '../types.js';
+export declare function transpileFunction(resource: FunctionResource, { installer }?: {
+    installer?: InstallerType;
+}): Promise<{
     type: string;
     outputDir: string;
     warnings: string[];

package/dist/utils/transpile/transpile-function.js

@@ -1,6 +1,5 @@
 import { existsSync } from 'node:fs';
 import { mkdir, readFile, rm, stat, writeFile } from 'node:fs/promises';
-import { createRequire } from 'node:module';
 import path from 'node:path';
 import { performance } from 'node:perf_hooks';
 import { cwd } from 'node:process';
@@ -8,9 +7,10 @@ import * as find from 'empathic/find';
 import { build as viteBuild } from 'vite';
 import tsConfigPaths from 'vite-tsconfig-paths';
 import { findFunctionEntryPoint } from '../functions/find-entry-point.js';
+import { createPnpmRequire } from '../pnpm.js';
 import { cleanupSourceMaps } from './cleanup-source-maps.js';
 import { verifyHandler } from './verify-handler.js';
-export async function transpileFunction(resource) {
+export async function transpileFunction(resource, { installer } = {}) {
     if (!resource.src)
         throw new Error('Resource src is required');
     if (!resource.name)
@@ -35,7 +35,8 @@ export async function transpileFunction(resource) {
     }
     try {
         const viteStart = performance.now();
-        const bundle = existsSync(path.join(cwd(), 'pnpm-workspace.yaml'));
+        // Always bundle the code if pnpm usage is detected or specified by the user
+        const bundle = existsSync(path.join(cwd(), 'pnpm-workspace.yaml')) || installer === 'pnpm';
         const result = await viteBuild({
             root: fnRootDir,
             logLevel: 'silent',
@@ -140,11 +141,7 @@ function logCleanupFailure(err) {
  * which isn't reachable via standard Node resolution.
  */
 function pnpmResolvePlugin(workspaceRoot) {
-    const pnpmModulesPath = path.join(workspaceRoot, 'node_modules', '.pnpm', 'node_modules');
-    // createRequire gives us Node's full module resolution algorithm rooted at
-    // the pnpm virtual store — it reads package.json exports/main and returns
-    // the absolute path to the actual entry file, not just the directory.
-    const pnpmRequire = createRequire(path.join(pnpmModulesPath, '_virtual.js'));
+    const pnpmRequire = createPnpmRequire(workspaceRoot);
     return {
         name: 'pnpm-resolve',
         async resolveId(source, importer, options) {

package/dist/utils/types.d.ts

@@ -255,4 +255,6 @@ export declare interface FetchConfig {
     apiHost?: string;
     apiVersion?: string;
 }
+export declare const INSTALLER_OPTIONS: readonly ["npm", "pnpm", "yarn"];
+export type InstallerType = 'npm' | 'pnpm' | 'yarn';
 export {};

package/dist/utils/types.js

@@ -57,3 +57,4 @@ export var BlueprintParserErrorType;
     BlueprintParserErrorType["InvalidInput"] = "invalid_input";
     BlueprintParserErrorType["MissingParameter"] = "missing_parameter";
 })(BlueprintParserErrorType || (BlueprintParserErrorType = {}));
+export const INSTALLER_OPTIONS = ['npm', 'pnpm', 'yarn'];

package/oclif.manifest.json

@@ -319,10 +319,11 @@
     "blueprints:deploy": {
       "aliases": [],
       "args": {},
-      "description": "Pushes your local Blueprint configuration to the remote Stack; provisioning, updating, or destroying resources as needed. This is the primary command for applying infrastructure changes.\n\nBefore deploying, run 'blueprints plan' to preview changes. After deployment, use 'blueprints info' to verify Stack status or 'blueprints logs' to monitor activity.\n\nUse --no-wait to queue the deployment and return immediately without waiting for completion.\n\nSet SANITY_ASSET_TIMEOUT (seconds) to override the 60-second timeout for processing resource assets.",
+      "description": "Pushes your local Blueprint configuration to the remote Stack; provisioning, updating, or destroying resources as needed. This is the primary command for applying infrastructure changes.\n\nBefore deploying, run 'blueprints plan' to preview changes. After deployment, use 'blueprints info' to verify Stack status or 'blueprints logs' to monitor activity.\n\nUse --no-wait to queue the deployment and return immediately without waiting for completion.\n\nUse --fn-installer to force which package manager to use when deploying functions.\n\nSet SANITY_ASSET_TIMEOUT (seconds) to override the 60-second timeout for processing resource assets.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --no-wait"
+        "<%= config.bin %> <%= command.id %> --no-wait",
+        "<%= config.bin %> <%= command.id %> --fn-installer npm"
       ],
       "flags": {
         "json": {
@@ -374,6 +375,23 @@
           "multiple": false,
           "type": "option"
         },
+        "fn-installer": {
+          "aliases": [
+            "function-installer",
+            "installer"
+          ],
+          "description": "Which package manager to use when installing Function dependencies",
+          "hidden": true,
+          "name": "fn-installer",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "npm",
+            "pnpm",
+            "yarn"
+          ],
+          "type": "option"
+        },
         "no-wait": {
           "description": "Do not wait for Stack deployment to complete",
           "name": "no-wait",
@@ -1336,6 +1354,23 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "fn-installer": {
+          "aliases": [
+            "function-installer",
+            "installer"
+          ],
+          "description": "Which package manager to use when building Functions",
+          "hidden": true,
+          "name": "fn-installer",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "npm",
+            "pnpm",
+            "yarn"
+          ],
+          "type": "option"
+        },
         "out-dir": {
           "char": "o",
           "description": "Output directory for zip files",
@@ -2163,5 +2198,5 @@
       ]
     }
   },
-  "version": "14.4.0"
+  "version": "14.5.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sanity/runtime-cli",
   "description": "Sanity's Runtime CLI for Blueprints and Functions",
-  "version": "14.4.0",
+  "version": "14.5.1",
   "author": "Sanity Runtime Team",
   "type": "module",
   "license": "MIT",
@@ -90,9 +90,10 @@
     "lint:fix": "npm run lint:write",
     "prepare": "npm run build",
     "postpack": "shx rm -f oclif.manifest.json",
-    "test": "vitest run && npm run lint",
-    "test:depmgmt": "vitest run --config ./test-depmgmt/vitest.config.ts",
+    "test": "npm run test:vitest && npm run lint",
     "test:api": "cd test/api-types && npm it",
+    "test:depmgmt": "vitest run --config ./test-depmgmt/vitest.config.ts",
+    "test:vitest": "vitest run",
     "typecheck": "tsc --project tsconfig.typecheck.json",
     "watch": "tsc --watch"
   },