@elevasis/sdk 0.5.4 → 0.5.6

package/dist/cli.cjs

@@ -43695,15 +43695,23 @@ var esbuild = __toESM(require("esbuild"), 1);
 // src/cli/config.ts
 var DEV_API_URL = "http://localhost:5170";
 var PROD_API_URL = "https://api.elevasis.io";
-function resolveApiUrl(cliOverride) {
+function resolveApiUrl(cliOverride, prod) {
   if (cliOverride) return cliOverride;
+  if (prod) return PROD_API_URL;
   if (process.env.ELEVASIS_API_URL) return process.env.ELEVASIS_API_URL;
   if (process.env.NODE_ENV === "development") return DEV_API_URL;
   return PROD_API_URL;
 }
-function resolveEnvironment() {
+function resolveEnvironment(prod) {
+  if (prod) return "production";
   return process.env.NODE_ENV === "development" ? "development" : "production";
 }
+function resolveApiKey(prod) {
+  if (!prod && process.env.NODE_ENV === "development") {
+    return process.env.ELEVASIS_API_KEY_DEV ?? process.env.ELEVASIS_API_KEY ?? "";
+  }
+  return process.env.ELEVASIS_API_KEY ?? "";
+}
 
 // src/cli/api-client.ts
 function getApiKey() {
@@ -43785,7 +43793,7 @@ async function apiDelete(endpoint, apiUrl = resolveApiUrl()) {
 // package.json
 var package_default = {
   name: "@elevasis/sdk",
-  version: "0.5.4",
+  version: "0.5.6",
   description: "SDK for building Elevasis organization resources",
   "comment:bin": "IMPORTANT: This package shares the 'elevasis' binary name with @repo/cli. They never conflict because @elevasis/sdk must NEVER be added as a dependency of any workspace package (apps/*, packages/*, organizations/*). Workspace projects use @repo/cli for the 'elevasis' binary. External developers (outside the workspace) get this SDK's binary via npm install.",
   type: "module",
@@ -44304,10 +44312,10 @@ async function generateProjectMap(org) {
   await (0, import_promises.writeFile)((0, import_path.resolve)("docs/project-map.mdx"), lines.join("\n"), "utf-8");
 }
 function registerDeployCommand(program3) {
-  program3.command("deploy").description("Validate, bundle, upload, and deploy project resources\n  Example: elevasis deploy --api-url http://localhost:5170").option("--api-url <url>", "API URL").option("--entry <path>", "Path to entry file (default: ./src/index.ts)").action(wrapAction("deploy", async (options2) => {
+  program3.command("deploy").description("Validate, bundle, upload, and deploy project resources\n  Example: elevasis deploy --api-url http://localhost:5170").option("--api-url <url>", "API URL").option("--entry <path>", "Path to entry file (default: ./src/index.ts)").option("--prod", "Deploy to production (overrides NODE_ENV=development)").action(wrapAction("deploy", async (options2) => {
     const startTime = Date.now();
-    const apiUrl = resolveApiUrl(options2.apiUrl);
-    const env2 = resolveEnvironment();
+    const apiUrl = resolveApiUrl(options2.apiUrl, options2.prod);
+    const env2 = resolveEnvironment(options2.prod);
     const entryPath = options2.entry ?? "./src/index.ts";
     const authSpinner = ora("Authenticating...").start();
     let orgName;
@@ -44321,11 +44329,12 @@ function registerDeployCommand(program3) {
       authSpinner.fail(source_default.red("Authentication failed"));
       const errMsg = error46 instanceof Error ? error46.message : String(error46);
       if (errMsg.includes("401") || errMsg.toLowerCase().includes("unauthorized")) {
+        const keyVar = !options2.prod && process.env.NODE_ENV === "development" && process.env.ELEVASIS_API_KEY_DEV ? "ELEVASIS_API_KEY_DEV" : "ELEVASIS_API_KEY";
         console.error(source_default.red("  Invalid API key."));
-        console.error(source_default.gray("  Your ELEVASIS_API_KEY was rejected by the server."));
+        console.error(source_default.gray(`  Your ${keyVar} was rejected by the server.`));
         console.error(source_default.gray("  Check your .env file and verify the key in the Elevasis dashboard."));
       } else {
-        console.error(source_default.gray("  Check your ELEVASIS_API_KEY and API URL."));
+        console.error(source_default.gray("  Check your API key and API URL."));
       }
       throw error46;
     }
@@ -44480,12 +44489,16 @@ startWorker(org)
     const uploadSpinner = ora("Uploading...").start();
     try {
       const bundleBuffer = await (0, import_promises.readFile)(bundleOutfile);
-      const apiKey = process.env.ELEVASIS_API_KEY;
+      const apiKey = resolveApiKey(options2.prod);
       if (!apiKey) {
-        uploadSpinner.fail(source_default.red("Missing ELEVASIS_API_KEY environment variable"));
+        uploadSpinner.fail(source_default.red("Missing API key environment variable"));
         console.error(source_default.gray("  Set it in your .env file or shell environment:"));
-        console.error(source_default.gray("    ELEVASIS_API_KEY=sk_..."));
-        throw new Error("Missing ELEVASIS_API_KEY environment variable");
+        if (!options2.prod && process.env.NODE_ENV === "development") {
+          console.error(source_default.gray("    ELEVASIS_API_KEY_DEV=sk_...  (or ELEVASIS_API_KEY as fallback)"));
+        } else {
+          console.error(source_default.gray("    ELEVASIS_API_KEY=sk_..."));
+        }
+        throw new Error("Missing API key environment variable");
       }
       const metadata = {
         sdkVersion: SDK_VERSION,
@@ -45440,6 +45453,19 @@ proactivity -- to their assessed levels.
 
 All \`reference/\` paths resolve to \`node_modules/@elevasis/sdk/reference/\`.
 
+## Elevasis CLI
+
+**MANDATORY:** Use the \`elevasis\` CLI for all operations -- never \`npx\`, \`curl\`, or any other tool.
+
+- \`elevasis exec <resource-id> --input '{...}'\` -- run a resource synchronously
+- \`elevasis exec <resource-id> --input '{...}' --async\` -- run async, returns execution ID
+- \`elevasis execution <resource-id> <execution-id>\` -- inspect execution detail
+- \`elevasis check\` -- validate resource definitions without deploying
+- \`elevasis deploy\` -- deploy to the platform
+
+Organization is derived from your API key -- no org prefix needed in the resource ID.
+For full CLI reference: \`reference/cli/index.mdx\`
+
 ## Rules
 
 SDK patterns (imports, source structure, platform tools) are auto-loaded from

package/dist/templates.js

@@ -244,6 +244,19 @@ proactivity -- to their assessed levels.
 
 All \`reference/\` paths resolve to \`node_modules/@elevasis/sdk/reference/\`.
 
+## Elevasis CLI
+
+**MANDATORY:** Use the \`elevasis\` CLI for all operations -- never \`npx\`, \`curl\`, or any other tool.
+
+- \`elevasis exec <resource-id> --input '{...}'\` -- run a resource synchronously
+- \`elevasis exec <resource-id> --input '{...}' --async\` -- run async, returns execution ID
+- \`elevasis execution <resource-id> <execution-id>\` -- inspect execution detail
+- \`elevasis check\` -- validate resource definitions without deploying
+- \`elevasis deploy\` -- deploy to the platform
+
+Organization is derived from your API key -- no org prefix needed in the resource ID.
+For full CLI reference: \`reference/cli/index.mdx\`
+
 ## Rules
 
 SDK patterns (imports, source structure, platform tools) are auto-loaded from

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/sdk",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "description": "SDK for building Elevasis organization resources",
   "comment:bin": "IMPORTANT: This package shares the 'elevasis' binary name with @repo/cli. They never conflict because @elevasis/sdk must NEVER be added as a dependency of any workspace package (apps/*, packages/*, organizations/*). Workspace projects use @repo/cli for the 'elevasis' binary. External developers (outside the workspace) get this SDK's binary via npm install.",
   "type": "module",

package/reference/cli/index.mdx

@@ -131,6 +131,7 @@ elevasis deploy
 | Flag | Description |
 | ---- | ----------- |
 | `--api-url <url>` | Override the API base URL (default: production) |
+| `--prod` | Force production target, overriding `NODE_ENV=development` (internal use) |
 
 **Environment variables:**
 
@@ -491,7 +492,8 @@ These flags are accepted by all commands:
 - Production (default): `https://api.elevasis.io`
 - Development (`NODE_ENV=development`): `http://localhost:<port>`
 - Override: set `ELEVASIS_API_URL` or pass `--api-url`
+- Force production: pass `--prod` on `deploy` (overrides `NODE_ENV=development`)
 
 ---
 
-**Last Updated:** 2026-02-25
+**Last Updated:** 2026-03-03