@sanity/runtime-cli 7.6.7 → 8.0.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/7.6.7 linux-x64 node-v22.16.0
+@sanity/runtime-cli/8.0.1 linux-x64 node-v22.16.0
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -37,6 +37,7 @@ USAGE
 * [`sanity-run blueprints init [DIR]`](#sanity-run-blueprints-init-dir)
 * [`sanity-run blueprints logs`](#sanity-run-blueprints-logs)
 * [`sanity-run blueprints plan`](#sanity-run-blueprints-plan)
+* [`sanity-run blueprints stacks`](#sanity-run-blueprints-stacks)
 * [`sanity-run functions dev`](#sanity-run-functions-dev)
 * [`sanity-run functions env add NAME KEY VALUE`](#sanity-run-functions-env-add-name-key-value)
 * [`sanity-run functions env list NAME`](#sanity-run-functions-env-list-name)
@@ -51,7 +52,7 @@ Add a Resource to a Blueprint
 
 ```
 USAGE
-  $ sanity-run blueprints add TYPE [--fn-type document-publish -n <value>] [--language ts|js] [--javascript]
+  $ sanity-run blueprints add TYPE [--fn-type document-publish -n <value>] [--fn-language ts|js] [--javascript]
     [--fn-helpers] [-i | --fn-installer skip|npm|pnpm|yarn]
 
 ARGUMENTS
@@ -63,11 +64,11 @@ FLAGS
       --[no-]fn-helpers        Add helpers to the new Function
       --fn-installer=<option>  How to install the @sanity/functions helpers
                                <options: skip|npm|pnpm|yarn>
+      --fn-language=<option>   [default: ts] Language of the new Function
+                               <options: ts|js>
       --fn-type=<option>       Type of new Function
                                <options: document-publish>
       --javascript             Use JavaScript instead of TypeScript
-      --language=<option>      [default: ts] Language of the new Function
-                               <options: ts|js>
 
 DESCRIPTION
   Add a Resource to a Blueprint
@@ -84,7 +85,7 @@ EXAMPLES
   $ sanity-run blueprints add function --name my-function --fn-type document-publish --lang js
 ```
 
-_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v7.6.7/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v8.0.1/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -92,12 +93,13 @@ View or edit Blueprint configuration
 
 ```
 USAGE
-  $ sanity-run blueprints config [-t] [--project-id <value> -e]
+  $ sanity-run blueprints config [-t] [--project-id <value> -e] [--stack-id <value> ]
 
 FLAGS
   -e, --edit                Edit the configuration
   -t, --test-config         Validate the configuration
       --project-id=<value>  Update the Project ID in the configuration. Requires --edit flag
+      --stack-id=<value>    Update the Stack ID in the configuration. Requires --edit flag
 
 DESCRIPTION
   View or edit Blueprint configuration
@@ -110,9 +112,11 @@ EXAMPLES
   $ sanity-run blueprints config --edit
 
   $ sanity-run blueprints config --edit --project-id <projectId>
+
+  $ sanity-run blueprints config --edit --project-id <projectId> --stack-id <stackId>
 ```
 
-_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v7.6.7/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v8.0.1/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -134,7 +138,7 @@ EXAMPLES
   $ sanity-run blueprints deploy --no-wait
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v7.6.7/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v8.0.1/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -142,20 +146,24 @@ Destroy a Blueprint deployment (will not delete local files)
 
 ```
 USAGE
-  $ sanity-run blueprints destroy [--force] [--no-wait]
+  $ sanity-run blueprints destroy [--project-id <value> --stack-id <value> --force] [--no-wait]
 
 FLAGS
-  --force    Force destroy (skip confirmation)
-  --no-wait  Do not wait for destruction to complete
+  --force               Force destroy (skip confirmation)
+  --no-wait             Do not wait for destruction to complete
+  --project-id=<value>  Project associated with the Stack (defaults to current Project)
+  --stack-id=<value>    Stack ID to destroy (defaults to current Stack)
 
 DESCRIPTION
   Destroy a Blueprint deployment (will not delete local files)
 
 EXAMPLES
   $ sanity-run blueprints destroy
+
+  $ sanity-run blueprints destroy --stack-id <stackId> --project-id <projectId> --force --no-wait
 ```
 
-_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v7.6.7/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v8.0.1/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -163,16 +171,21 @@ Show information about a Blueprint deployment
 
 ```
 USAGE
-  $ sanity-run blueprints info
+  $ sanity-run blueprints info [--id <value>]
+
+FLAGS
+  --id=<value>  Stack ID to show info for (defaults to current stack)
 
 DESCRIPTION
   Show information about a Blueprint deployment
 
 EXAMPLES
   $ sanity-run blueprints info
+
+  $ sanity-run blueprints info --stack-id <stackId>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v7.6.7/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v8.0.1/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -180,7 +193,8 @@ Initialize a new Blueprint
 
 ```
 USAGE
-  $ sanity-run blueprints init [DIR] [--dir <value>] [--blueprint-type json|js|ts] [--project-id <value>]
+  $ sanity-run blueprints init [DIR] [--dir <value>] [--blueprint-type json|js|ts] [--stack-name <value> |
+    [--stack-id <value> --project-id <value>]]
 
 ARGUMENTS
   DIR  Directory to create the Blueprint in
@@ -190,6 +204,8 @@ FLAGS
                              <options: json|js|ts>
   --dir=<value>              Directory to create the Blueprint in
   --project-id=<value>       Sanity Project ID to use for the Blueprint
+  --stack-id=<value>         Existing Stack ID to use for the Blueprint
+  --stack-name=<value>       Name to use for a NEW Stack
 
 DESCRIPTION
   Initialize a new Blueprint
@@ -201,10 +217,12 @@ EXAMPLES
 
   $ sanity-run blueprints init --blueprint-type <json|js|ts>
 
-  $ sanity-run blueprints init --blueprint-type <json|js|ts> --project-id <projectId>
+  $ sanity-run blueprints init --blueprint-type <json|js|ts> --project-id <projectId> --stack-id <stackId>
+
+  $ 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/v7.6.7/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v8.0.1/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -226,7 +244,7 @@ EXAMPLES
   $ sanity-run blueprints logs --watch
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v7.6.7/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v8.0.1/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -243,7 +261,29 @@ EXAMPLES
   $ sanity-run blueprints plan
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v7.6.7/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v8.0.1/src/commands/blueprints/plan.ts)_
+
+## `sanity-run blueprints stacks`
+
+List all Blueprint stacks
+
+```
+USAGE
+  $ sanity-run blueprints stacks [--project-id <value>]
+
+FLAGS
+  --project-id=<value>  Project ID to show stacks for
+
+DESCRIPTION
+  List all Blueprint stacks
+
+EXAMPLES
+  $ sanity-run blueprints stacks
+
+  $ sanity-run blueprints stacks --project-id <projectId>
+```
+
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v8.0.1/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions dev`
 
@@ -263,7 +303,7 @@ EXAMPLES
   $ sanity-run functions dev --port 8974
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v7.6.7/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v8.0.1/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -285,7 +325,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/v7.6.7/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v8.0.1/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -305,7 +345,7 @@ EXAMPLES
   $ sanity-run functions env list MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v7.6.7/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v8.0.1/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -326,7 +366,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/v7.6.7/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v8.0.1/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs NAME`
 
@@ -360,7 +400,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v7.6.7/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v8.0.1/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test NAME`
 
@@ -393,7 +433,7 @@ EXAMPLES
   $ sanity-run functions test <name> --data '{ "id": 1 }' --timeout 60
 ```
 
-_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v7.6.7/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v8.0.1/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

package/bin/dev.cmd

@@ -1,3 +1,3 @@
 @echo off
 
-node --import tsx --no-warnings=ExperimentalWarning "%~dp0\dev" %*
+node --import jiti/register --no-warnings=ExperimentalWarning "%~dp0\dev" %*

package/bin/dev.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env -S node --import tsx --disable-warning=ExperimentalWarning
+#!/usr/bin/env -S node --import jiti/register --disable-warning=ExperimentalWarning
 
 import {execute} from '@oclif/core'
 

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

@@ -1,8 +1,19 @@
 import type { BlueprintParserError, LocalBlueprint, LocalResource } from '../../utils/types.js';
 export { BLUEPRINT_CONFIG_FILE, BLUEPRINT_CONFIG_VERSION, BLUEPRINT_DIR } from '../../config.js';
-declare const SUPPORTED_FILE_EXTENSIONS: readonly [".json", ".js", ".mjs", ".cjs", ".ts"];
+declare const SUPPORTED_FILE_EXTENSIONS: readonly [".json", ".js", ".mjs", ".ts"];
 type BlueprintFileExtension = (typeof SUPPORTED_FILE_EXTENSIONS)[number];
-export declare const DEFAULT_BLUEPRINT_CONTENT: LocalBlueprint;
+export declare const JSON_BLUEPRINT_CONTENT: {
+    blueprintVersion: string;
+    resources: never[];
+};
+export declare const TS_BLUEPRINT_CONTENT = "import {defineBlueprint, defineDocumentFunction} from '@sanity/blueprints'\n\nexport default defineBlueprint({\n  resources: [\n    // defineDocumentFunction({name: 'my-function'}),\n  ],\n})\n";
+export declare const GITIGNORE_FOR_FUNCTIONS = "\n# Sanity Functions\nfunctions/**/.env*\nfunctions/**/.build/\nfunctions/**/node_modules/\n";
+export declare const GITIGNORE_TEMPLATE = "node_modules\n.env\n\n# Sanity Functions\nfunctions/**/.env*\nfunctions/**/.build/\nfunctions/**/node_modules/\n\n";
+export type BlueprintModule = ((args?: unknown) => Record<string, unknown>) & {
+    organizationId?: string;
+    projectId?: string;
+    stackId?: string;
+};
 /**
  * Finds the blueprint file in the given path or current working directory
  * @param blueprintPath - The path of the blueprint file or directory
@@ -35,10 +46,14 @@ export interface ReadBlueprintResult {
  * @returns Known information about the Blueprint, config, and Stack
  */
 export declare function readLocalBlueprint(blueprintPath?: string): Promise<ReadBlueprintResult>;
-export declare function writeBlueprintToDisk({ blueprintFilePath, content, }: {
+export declare function writeBlueprintToDisk({ blueprintFilePath, jsonContent, }: {
     blueprintFilePath: string;
-    content?: LocalBlueprint;
+    jsonContent?: LocalBlueprint;
 }): string;
+export declare function writeOrUpdateNodeDependency({ blueprintFilePath, dependency, }: {
+    blueprintFilePath: string;
+    dependency: string;
+}): Promise<void>;
 export declare function readConfigFile(blueprintFilePath?: string | undefined): {
     configPath?: string;
     projectId?: string;
@@ -49,6 +64,9 @@ export declare function writeConfigFile({ blueprintFilePath, projectId, stackId,
     projectId: string;
     stackId?: string;
 }): void;
+export declare function writeGitignoreFile({ blueprintFilePath, }: {
+    blueprintFilePath: string;
+}): string | null;
 export declare function addResourceToBlueprint({ blueprintFilePath, resource, }: {
     blueprintFilePath?: string;
     resource: LocalResource;

package/dist/actions/blueprints/blueprint.js

@@ -1,19 +1,42 @@
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
-import { createRequire } from 'node:module';
 import { basename, dirname, extname, join } from 'node:path';
 import { cwd, env } from 'node:process';
 import { findUpSync } from 'find-up';
+import { createJiti } from 'jiti';
 import { BLUEPRINT_CONFIG_FILE, BLUEPRINT_CONFIG_VERSION, BLUEPRINT_DIR } from '../../config.js';
+import { getLatestNpmVersion } from '../../utils/other/npmjs.js';
 import { isLocalFunctionResource } from '../../utils/types.js';
 import { validateFunctionResource } from '../../utils/validate/resource.js';
 import { blueprintParserValidator } from '../../utils/vendor/parser-validator.js';
 export { BLUEPRINT_CONFIG_FILE, BLUEPRINT_CONFIG_VERSION, BLUEPRINT_DIR } from '../../config.js';
-const SUPPORTED_FILE_EXTENSIONS = ['.json', '.js', '.mjs', '.cjs', '.ts'];
-const SUPPORTED_FILE_NAMES_IN_PRIORITY_ORDER = SUPPORTED_FILE_EXTENSIONS.map((ext) => `blueprint${ext}`);
-export const DEFAULT_BLUEPRINT_CONTENT = {
+const SUPPORTED_FILE_EXTENSIONS = ['.json', '.js', '.mjs', '.ts'];
+let SUPPORTED_FILE_NAMES = SUPPORTED_FILE_EXTENSIONS.map((ext) => `blueprint${ext}`);
+SUPPORTED_FILE_NAMES = [
+    ...SUPPORTED_FILE_NAMES,
+    ...SUPPORTED_FILE_NAMES.map((name) => `sanity.${name}`),
+];
+export const JSON_BLUEPRINT_CONTENT = {
     blueprintVersion: '2024-10-01',
     resources: [],
 };
+export const TS_BLUEPRINT_CONTENT = `import {defineBlueprint, defineDocumentFunction} from '@sanity/blueprints'
+
+export default defineBlueprint({
+  resources: [
+    // defineDocumentFunction({name: 'my-function'}),
+  ],
+})
+`;
+export const GITIGNORE_FOR_FUNCTIONS = `
+# Sanity Functions
+functions/**/.env*
+functions/**/.build/
+functions/**/node_modules/
+`;
+export const GITIGNORE_TEMPLATE = `node_modules
+.env
+${GITIGNORE_FOR_FUNCTIONS}
+`;
 /**
  * Finds the blueprint file in the given path or current working directory
  * @param blueprintPath - The path of the blueprint file or directory
@@ -37,7 +60,7 @@ export function findBlueprintFile(blueprintPath) {
             dirToSearch = blueprintPath;
         }
     }
-    const blueprintFile = findUpSync(SUPPORTED_FILE_NAMES_IN_PRIORITY_ORDER, {
+    const blueprintFile = findUpSync(SUPPORTED_FILE_NAMES, {
         cwd: dirToSearch,
         type: 'file',
         allowSymlinks: false,
@@ -75,23 +98,10 @@ export async function readLocalBlueprint(blueprintPath) {
                 blueprintModule = module.default;
                 break;
             }
-            case '.cjs': {
-                const require = createRequire(import.meta.url);
-                blueprintModule = require(foundFilePath);
-                break;
-            }
             case '.ts': {
-                try {
-                    const { tsImport } = await import('tsx/esm/api');
-                    const module = await tsImport(`file://${foundFilePath}`, dirname(foundFilePath));
-                    blueprintModule = module.default;
-                }
-                catch (err) {
-                    if (err instanceof Error && err.message.includes('Cannot find module')) {
-                        throw Error(`TypeScript support requires 'tsx' to be installed. Run: npm install -D tsx`);
-                    }
-                    throw err;
-                }
+                const jiti = createJiti(dirname(foundFilePath));
+                const modDefault = await jiti.import(`file://${foundFilePath}`, { default: true });
+                blueprintModule = modDefault;
                 break;
             }
             default:
@@ -99,16 +109,23 @@ export async function readLocalBlueprint(blueprintPath) {
         }
     }
     catch (err) {
-        throw Error(`Error parsing Blueprint file: ${fileName}`);
+        throw Error(`Unable to parse Blueprint file: ${fileName}\n${err}`);
     }
+    let moduleProjectId;
+    let moduleStackId;
     if (blueprintModule) {
-        if (typeof blueprintModule !== 'function')
-            throw Error(`Blueprint ${fileName} must export a default function`);
-        try {
-            rawBlueprint = blueprintModule();
+        if (typeof blueprintModule === 'function') {
+            try {
+                moduleProjectId = blueprintModule.projectId;
+                moduleStackId = blueprintModule.stackId;
+                rawBlueprint = blueprintModule();
+            }
+            catch {
+                throw Error(`Error executing Blueprint file: ${fileName}`);
+            }
         }
-        catch {
-            throw Error(`Error executing Blueprint file: ${fileName}`);
+        else {
+            throw Error(`Blueprint ${fileName} must export a default function`);
         }
     }
     const parserResult = blueprintParserValidator(rawBlueprint);
@@ -127,11 +144,15 @@ export async function readLocalBlueprint(blueprintPath) {
     let projectId;
     if (envProjectId)
         projectId = envProjectId;
+    else if (moduleProjectId)
+        projectId = moduleProjectId;
     else if (configIds?.projectId)
         projectId = configIds.projectId;
     let stackId;
     if (envStackId)
         stackId = envStackId;
+    else if (moduleStackId)
+        stackId = moduleStackId;
     else if (configIds?.stackId)
         stackId = configIds.stackId;
     // LAUNCH LIMIT: 1 Stack per Project - infer stackId from projectId
@@ -147,27 +168,19 @@ export async function readLocalBlueprint(blueprintPath) {
         parsedBlueprint,
     };
 }
-export function writeBlueprintToDisk({ blueprintFilePath, content = DEFAULT_BLUEPRINT_CONTENT, }) {
+export function writeBlueprintToDisk({ blueprintFilePath, jsonContent = JSON_BLUEPRINT_CONTENT, }) {
     const dir = dirname(blueprintFilePath);
     const extension = extname(blueprintFilePath);
     let blueprintContent;
     switch (extension) {
         case '.json': {
-            blueprintContent = JSON.stringify(content, null, 2);
+            blueprintContent = JSON.stringify(jsonContent, null, 2);
             break;
         }
         case '.js':
         case '.mjs':
         case '.ts': {
-            blueprintContent = `export default function() {
-  return ${JSON.stringify(content, null, 2)}
-}`;
-            break;
-        }
-        case '.cjs': {
-            blueprintContent = `module.exports = function() {
-  return ${JSON.stringify(content, null, 2)}
-}`;
+            blueprintContent = TS_BLUEPRINT_CONTENT;
             break;
         }
         default: {
@@ -178,6 +191,33 @@ export function writeBlueprintToDisk({ blueprintFilePath, content = DEFAULT_BLUE
     writeFileSync(blueprintFilePath, blueprintContent);
     return blueprintContent;
 }
+export async function writeOrUpdateNodeDependency({ blueprintFilePath, dependency, }) {
+    const dir = dirname(blueprintFilePath);
+    const extension = extname(blueprintFilePath);
+    if (extension === '.json')
+        return;
+    const version = await getLatestNpmVersion(dependency);
+    const packageJsonPath = join(dir, 'package.json');
+    const packageExists = existsSync(packageJsonPath);
+    if (!packageExists) {
+        writeFileSync(packageJsonPath, JSON.stringify({ devDependencies: { [dependency]: version } }, null, 2));
+        return;
+    }
+    const packageJson = readFileSync(packageJsonPath, 'utf8');
+    let packageJsonObject;
+    try {
+        packageJsonObject = JSON.parse(packageJson);
+    }
+    catch (err) {
+        throw Error(`Unable to parse package.json: ${err}`);
+    }
+    const allDependencies = { ...packageJsonObject.dependencies, ...packageJsonObject.devDependencies };
+    if (allDependencies[dependency])
+        return;
+    packageJsonObject.devDependencies = packageJsonObject.devDependencies || {};
+    packageJsonObject.devDependencies[dependency] = version;
+    writeFileSync(packageJsonPath, JSON.stringify(packageJsonObject, null, 2));
+}
 export function readConfigFile(blueprintFilePath) {
     if (blueprintFilePath) {
         const blueprintDir = dirname(blueprintFilePath);
@@ -225,6 +265,21 @@ export function writeConfigFile({ blueprintFilePath, projectId, stackId, }) {
     config.updatedAt = Date.now();
     writeFileSync(configPath, JSON.stringify(config, null, 2));
 }
+export function writeGitignoreFile({ blueprintFilePath, }) {
+    const blueprintDir = blueprintFilePath ? dirname(blueprintFilePath) : cwd();
+    const gitignorePath = join(blueprintDir, '.gitignore');
+    const gitignoreExists = existsSync(gitignorePath);
+    let content = GITIGNORE_TEMPLATE;
+    if (gitignoreExists) {
+        // append GITIGNORE_FOR_FUNCTIONS to existing .gitignore
+        const existingContent = readFileSync(gitignorePath, 'utf8').toString();
+        if (existingContent.includes(GITIGNORE_FOR_FUNCTIONS))
+            return null;
+        content = `${existingContent}\n${GITIGNORE_FOR_FUNCTIONS}`;
+    }
+    writeFileSync(gitignorePath, content);
+    return content;
+}
 export function addResourceToBlueprint({ blueprintFilePath, resource, }) {
     const blueprintFile = findBlueprintFile(blueprintFilePath);
     if (!blueprintFile)

package/dist/actions/blueprints/resources.js

@@ -4,6 +4,7 @@ import { existsSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { cwd } from 'node:process';
 import chalk from 'chalk';
+import { getLatestNpmVersion } from '../../utils/other/npmjs.js';
 import { addResourceToBlueprint } from './blueprint.js';
 const DEFAULT_FUNCTION_TEMPLATE = /*js*/ `export async function handler({context, event}) {
   const time = new Date().toLocaleTimeString()
@@ -89,19 +90,6 @@ export async function createFunctionResource(options) {
         resource: resource || resourceJson,
     };
 }
-async function getLatestNpmVersion(pkg) {
-    const url = `https://registry.npmjs.org/${pkg}/latest`;
-    try {
-        const res = await fetch(url);
-        if (!res.ok)
-            throw new Error(`Failed to fetch version for ${pkg}`);
-        const data = await res.json();
-        return data.version;
-    }
-    catch (error) {
-        return 'latest';
-    }
-}
 async function runPackageInstall(cwd, command) {
     return new Promise((resolve) => {
         const install = spawn(command, ['install'], { cwd });

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

@@ -24,6 +24,12 @@ export declare function createStack({ stackPayload, auth, }: {
     stackPayload: StackPayload;
     auth: AuthParams;
 }): Promise<CreateStackResponse>;
+export declare function createEmptyStack({ token, projectId, name, projectBased, }: {
+    token: string;
+    projectId: string;
+    name: string;
+    projectBased?: boolean;
+}): Promise<Stack>;
 interface UpdateStackResponse {
     ok: boolean;
     error: string | null;

package/dist/actions/blueprints/stacks.js

@@ -10,7 +10,7 @@ export async function listStacks(auth) {
     const stacks = await response.json();
     return {
         ok: response.ok,
-        error: response.ok ? null : stacks.error?.message,
+        error: response.ok ? null : stacks.message,
         stacks,
     };
 }
@@ -22,7 +22,7 @@ export async function getStack({ stackId, auth, }) {
     const stack = await response.json();
     return {
         ok: response.ok,
-        error: response.ok ? null : stack.message || stack.error?.message,
+        error: response.ok ? null : stack.message,
         stack,
     };
 }
@@ -35,10 +35,24 @@ export async function createStack({ stackPayload, auth, }) {
     const stack = await response.json();
     return {
         ok: response.ok,
-        error: response.ok ? null : stack.message || stack.error,
+        error: response.ok ? null : stack.message,
         stack,
     };
 }
+export async function createEmptyStack({ token, projectId, name, projectBased = true, }) {
+    const stackPayload = {
+        name,
+        projectId,
+        useProjectBasedId: projectBased,
+        document: { resources: [] },
+    };
+    const auth = { token, projectId };
+    const response = await createStack({ stackPayload, auth });
+    if (!response.ok) {
+        throw new Error(response.error || 'Failed to create new Stack');
+    }
+    return response.stack;
+}
 export async function updateStack({ stackId, stackPayload, auth, }) {
     const response = await fetch(`${stacksUrl}/${stackId}`, {
         method: 'PUT',

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

@@ -8,7 +8,7 @@ export default class AddCommand extends BlueprintCommand<typeof AddCommand> {
     static flags: {
         name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'fn-type': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        language: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'fn-language': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         javascript: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'fn-helpers': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'fn-installer': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/blueprints/add.js

@@ -26,14 +26,11 @@ export default class AddCommand extends BlueprintCommand {
             description: 'Type of new Function',
             options: ['document-publish' /*, 'document-create', 'document-delete'*/],
             aliases: ['function-type'],
-            // default: 'document-publish', // prompting informs user of default
             dependsOn: ['name'],
         }),
-        // TODO: this should be 'fn-language'
-        language: Flags.string({
+        'fn-language': Flags.string({
             description: 'Language of the new Function',
-            // TODO: remove 'fn-language'
-            aliases: ['fn-language', 'function-language', 'language', 'lang'],
+            aliases: ['function-language', 'language', 'lang'],
             options: ['ts', 'js'],
             default: 'ts',
         }),