@primitivedotdev/cli 0.26.1 → 0.26.2

package/dist/oclif/commands/doctor.js

@@ -81,6 +81,10 @@ function checkProxy() {
     return { status: "ok", message: present.join(", ") };
 }
 function checkApiKey(opts) {
+    // Take env explicitly so the unit test can inject a clean
+    // environment without mutating process.env across cases. Default to
+    // the live process env for real runs.
+    const env = opts.env ?? process.env;
     if (opts.apiKey?.startsWith("prim_")) {
         return { status: "ok", message: "provided via flag/env (prim_ prefix)" };
     }
@@ -91,6 +95,25 @@ function checkApiKey(opts) {
             hint: "Verify the key is a Primitive API key, not a value from another service.",
         };
     }
+    // PRIMITIVE_KEY rename detection. AGX feedback: users on older docs
+    // (or coming from other tools) set PRIMITIVE_KEY and then can't
+    // figure out why the CLI says "no API key found". The CLI reads
+    // PRIMITIVE_API_KEY only. Surface the rename hint when PRIMITIVE_KEY
+    // is set but PRIMITIVE_API_KEY is not, before falling through to
+    // the credentials.json / no-key checks. The hint runs before the
+    // credentials.json branch on purpose: if both PRIMITIVE_KEY and a
+    // valid credentials file are present, the credentials file wins
+    // silently and the user never sees the rename suggestion, which is
+    // the same trap by another name.
+    const primitiveKey = env.PRIMITIVE_KEY;
+    const primitiveApiKey = env.PRIMITIVE_API_KEY;
+    if ((primitiveKey?.length ?? 0) > 0 && (primitiveApiKey?.length ?? 0) === 0) {
+        return {
+            status: "fail",
+            message: "PRIMITIVE_KEY is set but the CLI reads PRIMITIVE_API_KEY",
+            hint: "Rename your env var, or re-run with PRIMITIVE_API_KEY=$PRIMITIVE_KEY.",
+        };
+    }
     const credsPath = join(opts.configDir, "credentials.json");
     if (existsSync(credsPath)) {
         let parsed = null;

package/dist/oclif/commands/functions-init.js

@@ -18,7 +18,7 @@ import { Args, Command, Errors, Flags } from "@oclif/core";
 // the CLI's own @primitivedotdev/sdk dep range in cli-node/package.json
 // so scaffolded projects use the same SDK version the CLI was built
 // and tested against.
-const SDK_VERSION_RANGE = "^0.25.0";
+const SDK_VERSION_RANGE = "^0.26.0";
 // The CLI version range that ships in the scaffolded devDependencies.
 // Pinned separately from SDK_VERSION_RANGE because @primitivedotdev/cli
 // and @primitivedotdev/sdk are independent packages on independent
@@ -184,11 +184,9 @@ export function renderPackageJson(name) {
         devDependencies: {
             // @primitivedotdev/cli ships the primitive bin. Including it as
             // a devDep here means `node_modules/.bin/primitive` resolves to
-            // the real CLI inside the scaffolded project; otherwise the
-            // bin falls through to @primitivedotdev/sdk's deprecated CLI
-            // alias and every `npm run deploy` invocation prints the
-            // "CLI moved" stderr banner. Pinned via CLI_VERSION_RANGE, a
-            // dedicated constant so the version is decoupled from the SDK
+            // the real CLI inside the scaffolded project so `npm run deploy`
+            // works without a global install. Pinned via CLI_VERSION_RANGE,
+            // a dedicated constant so the version is decoupled from the SDK
             // range and bumps are explicit on both ends.
             "@primitivedotdev/cli": CLI_VERSION_RANGE,
             esbuild: ESBUILD_VERSION_RANGE,

package/oclif.manifest.json

@@ -3192,7 +3192,7 @@
     "functions:create-function": {
       "aliases": [],
       "args": {},
-      "description": "Creates and deploys a new function. The handler must be a single\nESM module that exports a default async function receiving the\n`email.received` event (see the Webhook payload section for the\nfull schema). Code is bundled before being uploaded; ship a\nsingle self-contained file rather than relying on external\nimports.\n\n**Code limits.** `code` is capped at 1 MiB UTF-8. `sourceMap`\n(optional) is capped at 5 MiB UTF-8 and is stored only on the\nedge runtime side; it is not persisted in Primitive's database.\n\n**Auto-wiring.** On successful deploy, Primitive automatically\ncreates a webhook endpoint that delivers inbound mail to the\nfunction. There is nothing to configure on the Endpoints API\nfor this to work; the gateway URL returned here is for\nreference only and is not directly callable from outside.\n\n**Secrets.** New functions ship with the managed secrets\n(`PRIMITIVE_WEBHOOK_SECRET`, `PRIMITIVE_API_KEY`) already\nbound. Add user-set secrets via\n`POST /functions/{id}/secrets`; secret writes only land in the\nrunning handler on the next redeploy.\n\n\nTip: prefer `primitive functions:deploy --name <name> --file <bundle>` for file-input ergonomics. This raw command exists for callers passing JSON.",
+      "description": "Creates and deploys a new function. The handler must be a single\nESM module whose default export is an object with an async\n`fetch(request, env)` method (Workers-style). The gateway\nHMAC-verifies the POST against the org's webhook secret before\ninvoking the handler; the request body parses to an\n`email.received` event (see `EmailReceivedEvent` and the\nWebhook payload section for the full schema). Code is bundled\nbefore being uploaded; ship a single self-contained file rather\nthan relying on external imports.\n\n**Code limits.** `code` is capped at 1 MiB UTF-8. `sourceMap`\n(optional) is capped at 5 MiB UTF-8 and is stored only on the\nedge runtime side; it is not persisted in Primitive's database.\n\n**Auto-wiring.** On successful deploy, Primitive automatically\ncreates a webhook endpoint that delivers inbound mail to the\nfunction. There is nothing to configure on the Endpoints API\nfor this to work; the gateway URL returned here is for\nreference only and is not directly callable from outside.\n\n**Secrets.** New functions ship with the managed secrets\n(`PRIMITIVE_WEBHOOK_SECRET`, `PRIMITIVE_API_KEY`) already\nbound. Add user-set secrets via\n`POST /functions/{id}/secrets`; secret writes only land in the\nrunning handler on the next redeploy.\n\n\nTip: prefer `primitive functions:deploy --name <name> --file <bundle>` for file-input ergonomics. This raw command exists for callers passing JSON.",
       "flags": {
         "api-key": {
           "description": "Primitive API key (defaults to PRIMITIVE_API_KEY or saved `primitive login` credentials)",
@@ -3532,6 +3532,78 @@
       "summary": "Get a function",
       "enableJsonFlag": false
     },
+    "functions:list-function-logs": {
+      "aliases": [],
+      "args": {},
+      "description": "Returns the most recent `function_logs` rows for the function,\nnewest first. Each row is a single `console.log` / `console.error`\ninvocation captured from the running handler.\n\nPage through history with the opaque `cursor` returned as\n`next_cursor`; pass it back as the `cursor` query param on the\nnext call. `next_cursor` is `null` when there are no further\nrows. The cursor format is an implementation detail and should\nnot be parsed by callers.\n",
+      "flags": {
+        "api-key": {
+          "description": "Primitive API key (defaults to PRIMITIVE_API_KEY or saved `primitive login` credentials)",
+          "env": "PRIMITIVE_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-base-url-1": {
+          "description": "Override the primary API base URL. Internal testing only; not documented to customers.",
+          "env": "PRIMITIVE_API_BASE_URL_1",
+          "hidden": true,
+          "name": "api-base-url-1",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-base-url-2": {
+          "description": "Override the attachments-supporting send host base URL. Internal testing only; not documented to customers.",
+          "env": "PRIMITIVE_API_BASE_URL_2",
+          "hidden": true,
+          "name": "api-base-url-2",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "time": {
+          "description": "Print the wall-clock duration of this command to stderr after it completes (e.g. `[time: 1.34s]`). Useful for measuring `--wait` send latency, comparing CLI overhead, or capturing timing in scripts.",
+          "name": "time",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "id": {
+          "description": "Resource UUID",
+          "name": "id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "description": "Maximum number of rows to return. Clamped to 1..200; default\n50.\n",
+          "name": "limit",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cursor": {
+          "description": "Opaque pagination cursor from a previous response's\n`next_cursor`. Omit on the first call.\n",
+          "name": "cursor",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "functions:list-function-logs",
+      "pluginAlias": "@primitivedotdev/cli",
+      "pluginName": "@primitivedotdev/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "List a function's execution logs",
+      "enableJsonFlag": false
+    },
     "functions:list-function-secrets": {
       "aliases": [],
       "args": {},
@@ -4386,5 +4458,5 @@
       "enableJsonFlag": false
     }
   },
-  "version": "0.26.1"
+  "version": "0.26.2"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primitivedotdev/cli",
-  "version": "0.26.1",
+  "version": "0.26.2",
   "description": "Official Primitive CLI: deploy Primitive Functions, send and inspect mail, manage endpoints, all from the terminal. Wraps the @primitivedotdev/sdk runtime client with one-shot commands.",
   "type": "module",
   "sideEffects": false,
@@ -92,7 +92,7 @@
     "@oclif/core": "^4.10.5",
     "@oclif/plugin-autocomplete": "^3.2.45",
     "@oclif/plugin-help": "^6.2.44",
-    "@primitivedotdev/sdk": "^0.25.0"
+    "@primitivedotdev/sdk": "^0.26.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.10",