@primitivedotdev/sdk 0.23.0 → 0.25.0

package/README.md

@@ -1,13 +1,18 @@
 # `@primitivedotdev/sdk`
 
-The official Node.js SDK and command-line tool for [Primitive](https://primitive.dev), an email API for sending and receiving programmatic mail.
+The official Node.js library for [Primitive](https://primitive.dev), an email API for sending and receiving programmatic mail. Typed client for receiving and verifying inbound webhooks, sending mail, parsing raw MIME, and calling the full HTTP API.
 
-The package ships two things in one install:
+## Looking for the CLI?
 
-- A **`primitive` CLI** for interactive use, scripts, and agent workflows. Sends mail, reads inbound, inspects send history, manages domains and webhook endpoints, all in one binary.
-- A **typed Node library** for programmatic integration in app code. Receives and verifies inbound webhooks, sends mail, parses raw MIME, and exposes the full HTTP API as generated functions.
+The `primitive` CLI now ships as a separate package, [`@primitivedotdev/cli`](https://www.npmjs.com/package/@primitivedotdev/cli). Install it with:
 
-Pick whichever fits the call site. The two share the same auth (`PRIMITIVE_API_KEY`), the same data shapes, and the same OpenAPI spec.
+```bash
+npm install -g @primitivedotdev/cli
+# or, no-install:
+npx @primitivedotdev/cli@latest <command>
+```
+
+This package retains the CLI for a few minor releases for backward compatibility (`npx @primitivedotdev/sdk@latest <command>` still works and prints a one-line migration banner). The retained CLI snapshot will be removed in a future minor release.
 
 ## Install
 
@@ -15,56 +20,16 @@ Pick whichever fits the call site. The two share the same auth (`PRIMITIVE_API_K
 npm install @primitivedotdev/sdk
 ```
 
-For one-off CLI use, `npx @primitivedotdev/sdk@latest <command>` works without installing.
-
 Requires Node.js 22 or newer.
 
 ## Set your API key
 
-Get a key from your [dashboard](https://primitive.dev) and export it. Both the CLI and the library default to reading `PRIMITIVE_API_KEY` from the environment.
+Get a key from your [dashboard](https://primitive.dev) and export it. The library defaults to reading `PRIMITIVE_API_KEY` from the environment.
 
 ```bash
 export PRIMITIVE_API_KEY=prim_...
 ```
 
-## Command line
-
-Everything below assumes `PRIMITIVE_API_KEY` is set. Each command also accepts `--api-key <value>` if you want to pass it explicitly.
-
-```bash
-# Confirm the key is live and see which account it authenticates.
-primitive whoami
-
-# Send an email. --wait blocks until the receiving MTA returns a delivery
-# outcome (a synchronous SMTP 250 from Gmail, etc.); without it, the call
-# returns once Primitive has accepted the message for delivery.
-primitive send --to alice@example.com --body "Hi Alice!" --wait
-
-# See the most recent inbound emails as a compact text table.
-# IDs are full UUIDs when piped, truncated for interactive terminals.
-primitive emails:latest --limit 5
-
-# Read one inbound's full record (body, headers, threading metadata).
-primitive emails:get-email --id <uuid>
-
-# Reply to an inbound. Threading and the "Re:" subject are derived
-# server-side from the parent message; you supply only the body.
-primitive sending:reply-to-email --id <inbound-id> --body-text "..."
-
-# See where you are allowed to send. Returns a typed list of
-# permission rules (managed-zone wildcards, your own verified domains,
-# specific addresses with grants). The send-mail call enforces these
-# at request time.
-primitive sending:get-send-permissions
-
-# Look up an operation's request/response schema, including per-field
-# descriptions sourced from the OpenAPI spec.
-primitive describe emails:get-email
-primitive describe sending:send-email
-```
-
-Run `primitive --help` for the full topic list and `primitive <topic> --help` for the commands within each. Every command accepts `--help`, and the descriptions are detailed enough that the CLI is self-documenting for most workflows.
-
 ## Library
 
 The default root import is intentionally small and centered on the two most common app-code use cases: receiving inbound webhook deliveries and sending mail.

package/bin/run.js

@@ -1,5 +1,20 @@
 #!/usr/bin/env node
 
+// The CLI moved to @primitivedotdev/cli. This bin is retained on
+// @primitivedotdev/sdk for a few minor versions so existing scripts
+// and agent prompts that invoke `npx @primitivedotdev/sdk@latest
+// <command>` keep working. Every invocation prints a one-line stderr
+// banner with the migration command; the actual oclif runtime runs
+// unchanged after that. The CLI surface will be removed from
+// @primitivedotdev/sdk in a future minor release; until then this
+// shipped snapshot is frozen against the 0.23.0 command set.
 import { execute } from "@oclif/core";
 
+process.stderr.write(
+  "[@primitivedotdev/sdk] Heads up: the CLI moved to @primitivedotdev/cli. " +
+    "Switch to `npx @primitivedotdev/cli@latest <command>` " +
+    "(or `npm install -g @primitivedotdev/cli`). " +
+    "The CLI surface will be removed from @primitivedotdev/sdk in a future minor release.\n",
+);
+
 await execute({ dir: import.meta.url });

package/dist/api/generated/sdk.gen.js

@@ -28,7 +28,7 @@ export const pollCliLogin = (options) => (options.client ?? client).post({
     url: '/cli/login/poll',
     ...options,
     headers: {
-        'Content-Type': 'application/json',
+        ...(options.body !== undefined && { 'Content-Type': 'application/json' }),
         ...options.headers
     }
 });
@@ -64,7 +64,7 @@ export const updateAccount = (options) => (options.client ?? client).patch({
     url: '/account',
     ...options,
     headers: {
-        'Content-Type': 'application/json',
+        ...(options.body !== undefined && { 'Content-Type': 'application/json' }),
         ...options.headers
     }
 });
@@ -143,7 +143,7 @@ export const addDomain = (options) => (options.client ?? client).post({
     url: '/domains',
     ...options,
     headers: {
-        'Content-Type': 'application/json',
+        ...(options.body !== undefined && { 'Content-Type': 'application/json' }),
         ...options.headers
     }
 });
@@ -169,7 +169,7 @@ export const updateDomain = (options) => (options.client ?? client).patch({
     url: '/domains/{id}',
     ...options,
     headers: {
-        'Content-Type': 'application/json',
+        ...(options.body !== undefined && { 'Content-Type': 'application/json' }),
         ...options.headers
     }
 });
@@ -327,7 +327,7 @@ export const replyToEmail = (options) => (options.client ?? client).post({
     url: '/emails/{id}/reply',
     ...options,
     headers: {
-        'Content-Type': 'application/json',
+        ...(options.body !== undefined && { 'Content-Type': 'application/json' }),
         ...options.headers
     }
 });
@@ -405,7 +405,7 @@ export const createEndpoint = (options) => (options.client ?? client).post({
     url: '/endpoints',
     ...options,
     headers: {
-        'Content-Type': 'application/json',
+        ...(options.body !== undefined && { 'Content-Type': 'application/json' }),
         ...options.headers
     }
 });
@@ -434,7 +434,7 @@ export const updateEndpoint = (options) => (options.client ?? client).patch({
     url: '/endpoints/{id}',
     ...options,
     headers: {
-        'Content-Type': 'application/json',
+        ...(options.body !== undefined && { 'Content-Type': 'application/json' }),
         ...options.headers
     }
 });
@@ -475,7 +475,7 @@ export const createFilter = (options) => (options.client ?? client).post({
     url: '/filters',
     ...options,
     headers: {
-        'Content-Type': 'application/json',
+        ...(options.body !== undefined && { 'Content-Type': 'application/json' }),
         ...options.headers
     }
 });
@@ -497,7 +497,7 @@ export const updateFilter = (options) => (options.client ?? client).patch({
     url: '/filters/{id}',
     ...options,
     headers: {
-        'Content-Type': 'application/json',
+        ...(options.body !== undefined && { 'Content-Type': 'application/json' }),
         ...options.headers
     }
 });
@@ -590,7 +590,7 @@ export const sendEmail = (options) => (options.client ?? client).post({
     url: '/send-mail',
     ...options,
     headers: {
-        'Content-Type': 'application/json',
+        ...(options.body !== undefined && { 'Content-Type': 'application/json' }),
         ...options.headers
     }
 });
@@ -683,7 +683,7 @@ export const createFunction = (options) => (options.client ?? client).post({
     url: '/functions',
     ...options,
     headers: {
-        'Content-Type': 'application/json',
+        ...(options.body !== undefined && { 'Content-Type': 'application/json' }),
         ...options.headers
     }
 });
@@ -739,7 +739,7 @@ export const updateFunction = (options) => (options.client ?? client).put({
     url: '/functions/{id}',
     ...options,
     headers: {
-        'Content-Type': 'application/json',
+        ...(options.body !== undefined && { 'Content-Type': 'application/json' }),
         ...options.headers
     }
 });
@@ -747,8 +747,14 @@ export const updateFunction = (options) => (options.client ?? client).put({
  * Send a test invocation
  *
  * Sends a real test email from a Primitive-controlled sender to a
- * synthetic local-part on one of the org's verified inbound
- * domains. The function fires through the normal MX delivery
+ * local-part on one of the org's verified inbound domains. By
+ * default the recipient is a synthetic
+ * `__primitive_function_test+<random>@<domain>` address that
+ * every handler's catch-all routing receives identically; pass
+ * `local_part` to override and exercise routing logic that
+ * branches on a specific recipient (the common pattern when one
+ * function handles multiple inboxes like `summarize@` and
+ * `action@`). The function fires through the normal MX delivery
  * path, so reply / send-mail calls from inside the handler
  * against the inbound's `email.id` work the same as in
  * production. Returns immediately after the send is queued; the
@@ -758,12 +764,18 @@ export const updateFunction = (options) => (options.client ?? client).put({
  * Requires that the function is currently `deployed`. Returns 422
  * if the function is in `pending` or `failed` state, or if the
  * org has no verified inbound domain to receive the test mail.
+ * Returns 400 if `local_part` is set to a value that does not
+ * match the local-part character set.
  *
  */
 export const testFunction = (options) => (options.client ?? client).post({
     security: [{ scheme: 'bearer', type: 'http' }],
     url: '/functions/{id}/test',
-    ...options
+    ...options,
+    headers: {
+        ...(options.body !== undefined && { 'Content-Type': 'application/json' }),
+        ...options.headers
+    }
 });
 /**
  * List a function's secrets
@@ -804,7 +816,7 @@ export const createFunctionSecret = (options) => (options.client ?? client).post
     url: '/functions/{id}/secrets',
     ...options,
     headers: {
-        'Content-Type': 'application/json',
+        ...(options.body !== undefined && { 'Content-Type': 'application/json' }),
         ...options.headers
     }
 });
@@ -838,7 +850,7 @@ export const setFunctionSecret = (options) => (options.client ?? client).put({
     url: '/functions/{id}/secrets/{key}',
     ...options,
     headers: {
-        'Content-Type': 'application/json',
+        ...(options.body !== undefined && { 'Content-Type': 'application/json' }),
         ...options.headers
     }
 });

package/dist/api/index.d.ts

@@ -1,2 +1,2 @@
-import { $ as replyToEmail, $a as TestEndpointError, $i as ReplayDeliveryResponses, $n as EmailDetail, $o as RequestOptions, $r as GetWebhookSecretResponses, $t as CreateFunctionSecretInput, A as deleteFunction, Aa as SendPermissionAnyRecipient, Ai as ListFunctionSecretsResponse, An as DeleteFunctionSecretErrors, Ao as UpdateFilterError, Ar as GetFunctionError, At as ClientOptions, B as getStorageStats, Ba as SetFunctionSecretErrors, Bi as ListSentEmailsResponse, Bn as DiscardEmailContentResponses, Bo as UpdateFunctionResponses, Br as GetSentEmailError, Bt as CreateFilterInput, C as createFilter, Ca as SendEmailError, Ci as ListFiltersError, Cn as DeleteFunctionData, Co as UpdateEndpointData, Cr as GetAccountResponses, Ct as CliLogoutData, D as deleteEmail, Da as SendMailInput, Di as ListFunctionSecretsData, Dn as DeleteFunctionResponses, Do as UpdateEndpointResponse, Dr as GetEmailResponse, Dt as CliLogoutResponse, E as deleteDomain, Ea as SendEmailResponses, Ei as ListFiltersResponses, En as DeleteFunctionResponse, Eo as UpdateEndpointInput, Er as GetEmailErrors, Et as CliLogoutInput, F as getAccount, Fa as SentEmailDetail, Fi as ListFunctionsResponse, Fn as DiscardContentResult, Fo as UpdateFunctionData, Fr as GetSendPermissionsError, Ft as CreateEndpointResponse, G as listEndpoints, Ga as StartCliLoginError, Gi as PollCliLoginErrors, Gn as DownloadAttachmentsErrors, Go as VerifyDomainResponse, Gr as GetStorageStatsError, Gt as CreateFunctionErrors, H as listDeliveries, Ha as SetFunctionSecretResponse, Hi as PaginationMeta, Hn as DomainVerifyResult, Ho as VerifyDomainData, Hr as GetSentEmailResponse, Ht as CreateFilterResponses, I as getEmail, Ia as SentEmailStatus, Ii as ListFunctionsResponses, In as DiscardEmailContentData, Io as UpdateFunctionError, Ir as GetSendPermissionsErrors, It as CreateEndpointResponses, J as listFunctions, Ja as StartCliLoginResponse, Ji as PollCliLoginResponses, Jn as DownloadRawEmailData, Jo as Client, Jr as GetStorageStatsResponses, Jt as CreateFunctionResponses, K as listFilters, Ka as StartCliLoginErrors, Ki as PollCliLoginInput, Kn as DownloadAttachmentsResponse, Ko as VerifyDomainResponses, Kr as GetStorageStatsErrors, Kt as CreateFunctionInput, L as getFunction, La as SentEmailSummary, Li as ListSentEmailsData, Ln as DiscardEmailContentError, Lo as UpdateFunctionErrors, Lr as GetSendPermissionsResponse, Lt as CreateFilterData, M as discardEmailContent, Ma as SendPermissionRule, Mi as ListFunctionsData, Mn as DeleteFunctionSecretResponses, Mo as UpdateFilterInput, Mr as GetFunctionResponse, Mt as CreateEndpointError, N as downloadAttachments, Na as SendPermissionYourDomain, Ni as ListFunctionsError, Nn as DeliveryStatus, No as UpdateFilterResponse, Nr as GetFunctionResponses, Nt as CreateEndpointErrors, O as deleteEndpoint, Oa as SendMailResult, Oi as ListFunctionSecretsError, On as DeleteFunctionSecretData, Oo as UpdateEndpointResponses, Or as GetEmailResponses, Ot as CliLogoutResponses, P as downloadRawEmail, Pa as SendPermissionsMeta, Pi as ListFunctionsErrors, Pn as DeliverySummary, Po as UpdateFilterResponses, Pr as GetSendPermissionsData, Pt as CreateEndpointInput, Q as replayEmailWebhooks, Qa as TestEndpointData, Qi as ReplayDeliveryResponse, Qn as DownloadRawEmailResponses, Qo as Options$1, Qr as GetWebhookSecretResponse, Qt as CreateFunctionSecretErrors, R as getSendPermissions, Ra as SetFunctionSecretData, Ri as ListSentEmailsError, Rn as DiscardEmailContentErrors, Ro as UpdateFunctionInput, Rr as GetSendPermissionsResponses, Rt as CreateFilterError, S as createEndpoint, Sa as SendEmailData, Si as ListFiltersData, Sn as DeleteFilterResponses, So as UpdateDomainResponses, Sr as GetAccountResponse, St as CliLoginStartResult, T as createFunctionSecret, Ta as SendEmailResponse, Ti as ListFiltersResponse, Tn as DeleteFunctionErrors, To as UpdateEndpointErrors, Tr as GetEmailError, Tt as CliLogoutErrors, U as listDomains, Ua as SetFunctionSecretResponses, Ui as PollCliLoginData, Un as DownloadAttachmentsData, Uo as VerifyDomainError, Ur as GetSentEmailResponses, Ut as CreateFunctionData, V as getWebhookSecret, Va as SetFunctionSecretInput, Vi as ListSentEmailsResponses, Vn as Domain, Vo as VerifiedDomain, Vr as GetSentEmailErrors, Vt as CreateFilterResponse, W as listEmails, Wa as StartCliLoginData, Wi as PollCliLoginError, Wn as DownloadAttachmentsError, Wo as VerifyDomainErrors, Wr as GetStorageStatsData, Wt as CreateFunctionError, X as pollCliLogin, Xa as StorageStats, Xi as ReplayDeliveryError, Xn as DownloadRawEmailErrors, Xo as Config, Xr as GetWebhookSecretError, Xt as CreateFunctionSecretData, Y as listSentEmails, Ya as StartCliLoginResponses, Yi as ReplayDeliveryData, Yn as DownloadRawEmailError, Yo as ClientOptions$1, Yr as GetWebhookSecretData, Yt as CreateFunctionResult, Z as replayDelivery, Za as SuccessEnvelope, Zi as ReplayDeliveryErrors, Zn as DownloadRawEmailResponse, Zo as CreateClientConfig, Zr as GetWebhookSecretErrors, Zt as CreateFunctionSecretError, _ as createPrimitiveClient, _a as SearchEmailsData, _i as ListEndpointsError, _n as DeleteEndpointResponses, _o as UpdateDomainData, _r as GateDenial, _t as AddDomainErrors, a as PrimitiveApiClientOptions, aa as ReplayResult, ai as ListDeliveriesResponses, an as DeleteDomainErrors, ao as TestFunctionErrors, ar as EmailSearchResult, at as testEndpoint, b as addDomain, ba as SearchEmailsResponse, bi as ListEndpointsResponses, bn as DeleteFilterErrors, bo as UpdateDomainInput, br as GetAccountError, bt as AddDomainResponses, c as PrimitiveClient, ca as ReplyToEmailErrors, ci as ListDomainsErrors, cn as DeleteEmailData, co as TestInvocationResult, cr as EmailWebhookStatus, ct as updateDomain, d as RequestOptions$1, da as ResourceId, di as ListEmailsData, dn as DeleteEmailResponse, do as UpdateAccountData, dr as Filter, dt as updateFunction, ea as ReplayEmailWebhooksData, ei as Limit, en as CreateFunctionSecretResponse, eo as TestEndpointErrors, er as EmailDetailReply, es as RequestResult, et as rotateWebhookSecret, f as SendInput, fa as RotateWebhookSecretData, fi as ListEmailsError, fn as DeleteEmailResponses, fo as UpdateAccountError, fr as FunctionDeployStatus, ft as verifyDomain, g as createPrimitiveApiClient, ga as RotateWebhookSecretResponses, gi as ListEndpointsData, gn as DeleteEndpointResponse, go as UpdateAccountResponses, gr as FunctionSecretWriteResult, gt as AddDomainError, h as client, ha as RotateWebhookSecretResponse, hi as ListEmailsResponses, hn as DeleteEndpointErrors, ho as UpdateAccountResponse, hr as FunctionSecretListItem, ht as AddDomainData, i as PrimitiveApiClient, ia as ReplayEmailWebhooksResponses, ii as ListDeliveriesResponse, in as DeleteDomainError, io as TestFunctionError, ir as EmailSearchMeta, it as startCliLogin, j as deleteFunctionSecret, ja as SendPermissionManagedZone, ji as ListFunctionSecretsResponses, jn as DeleteFunctionSecretResponse, jo as UpdateFilterErrors, jr as GetFunctionErrors, jt as CreateEndpointData, k as deleteFilter, ka as SendPermissionAddress, ki as ListFunctionSecretsErrors, kn as DeleteFunctionSecretError, ko as UpdateFilterData, kr as GetFunctionData, kt as CliLogoutResult, l as PrimitiveClientOptions, la as ReplyToEmailResponse, li as ListDomainsResponse, ln as DeleteEmailError, lo as TestResult, lr as Endpoint, lt as updateEndpoint, m as SendThreadInput, ma as RotateWebhookSecretErrors, mi as ListEmailsResponse, mn as DeleteEndpointError, mo as UpdateAccountInput, mr as FunctionListItem, mt as AccountUpdated, n as DEFAULT_API_BASE_URL_2, na as ReplayEmailWebhooksErrors, ni as ListDeliveriesError, nn as Cursor, no as TestEndpointResponses, nr as EmailSearchFacets, ns as Auth, nt as sendEmail, o as PrimitiveApiError, oa as ReplyToEmailData, oi as ListDomainsData, on as DeleteDomainResponse, oo as TestFunctionResponse, or as EmailStatus, ot as testFunction, p as SendResult, pa as RotateWebhookSecretError, pi as ListEmailsErrors, pn as DeleteEndpointData, po as UpdateAccountErrors, pr as FunctionDetail, pt as Account, q as listFunctionSecrets, qa as StartCliLoginInput, qi as PollCliLoginResponse, qn as DownloadAttachmentsResponses, qo as WebhookSecret, qr as GetStorageStatsResponse, qt as CreateFunctionResponse, r as ForwardInput, ra as ReplayEmailWebhooksResponse, ri as ListDeliveriesErrors, rn as DeleteDomainData, ro as TestFunctionData, rr as EmailSearchHighlights, rt as setFunctionSecret, s as PrimitiveApiErrorDetails, sa as ReplyToEmailError, si as ListDomainsError, sn as DeleteDomainResponses, so as TestFunctionResponses, sr as EmailSummary, st as updateAccount, t as DEFAULT_API_BASE_URL_1, ta as ReplayEmailWebhooksError, ti as ListDeliveriesData, tn as CreateFunctionSecretResponses, to as TestEndpointResponse, tr as EmailSearchFacetBucket, ts as ResponseStyle, tt as searchEmails, u as ReplyInput, ua as ReplyToEmailResponses, ui as ListDomainsResponses, un as DeleteEmailErrors, uo as UnverifiedDomain, ur as ErrorResponse, ut as updateFilter, v as operations, va as SearchEmailsError, vi as ListEndpointsErrors, vn as DeleteFilterData, vo as UpdateDomainError, vr as GateFix, vt as AddDomainInput, w as createFunction, wa as SendEmailErrors, wi as ListFiltersErrors, wn as DeleteFunctionError, wo as UpdateEndpointError, wr as GetEmailData, wt as CliLogoutError, x as cliLogout, xa as SearchEmailsResponses, xi as ListEnvelope, xn as DeleteFilterResponse, xo as UpdateDomainResponse, xr as GetAccountErrors, xt as CliLoginPollResult, y as Options, ya as SearchEmailsErrors, yi as ListEndpointsResponse, yn as DeleteFilterError, yo as UpdateDomainErrors, yr as GetAccountData, yt as AddDomainResponse, z as getSentEmail, za as SetFunctionSecretError, zi as ListSentEmailsErrors, zn as DiscardEmailContentResponse, zo as UpdateFunctionResponse, zr as GetSentEmailData, zt as CreateFilterErrors } from "../index-QTYQpSFt.js";
+import { $ as replyToEmail, $a as TestEndpointError, $i as ReplayDeliveryResponses, $n as EmailDetail, $o as RequestOptions, $r as GetWebhookSecretResponses, $t as CreateFunctionSecretInput, A as deleteFunction, Aa as SendPermissionAnyRecipient, Ai as ListFunctionSecretsResponse, An as DeleteFunctionSecretErrors, Ao as UpdateFilterError, Ar as GetFunctionError, At as ClientOptions, B as getStorageStats, Ba as SetFunctionSecretErrors, Bi as ListSentEmailsResponse, Bn as DiscardEmailContentResponses, Bo as UpdateFunctionResponses, Br as GetSentEmailError, Bt as CreateFilterInput, C as createFilter, Ca as SendEmailError, Ci as ListFiltersError, Cn as DeleteFunctionData, Co as UpdateEndpointData, Cr as GetAccountResponses, Ct as CliLogoutData, D as deleteEmail, Da as SendMailInput, Di as ListFunctionSecretsData, Dn as DeleteFunctionResponses, Do as UpdateEndpointResponse, Dr as GetEmailResponse, Dt as CliLogoutResponse, E as deleteDomain, Ea as SendEmailResponses, Ei as ListFiltersResponses, En as DeleteFunctionResponse, Eo as UpdateEndpointInput, Er as GetEmailErrors, Et as CliLogoutInput, F as getAccount, Fa as SentEmailDetail, Fi as ListFunctionsResponse, Fn as DiscardContentResult, Fo as UpdateFunctionData, Fr as GetSendPermissionsError, Ft as CreateEndpointResponse, G as listEndpoints, Ga as StartCliLoginError, Gi as PollCliLoginErrors, Gn as DownloadAttachmentsErrors, Go as VerifyDomainResponse, Gr as GetStorageStatsError, Gt as CreateFunctionErrors, H as listDeliveries, Ha as SetFunctionSecretResponse, Hi as PaginationMeta, Hn as DomainVerifyResult, Ho as VerifyDomainData, Hr as GetSentEmailResponse, Ht as CreateFilterResponses, I as getEmail, Ia as SentEmailStatus, Ii as ListFunctionsResponses, In as DiscardEmailContentData, Io as UpdateFunctionError, Ir as GetSendPermissionsErrors, It as CreateEndpointResponses, J as listFunctions, Ja as StartCliLoginResponse, Ji as PollCliLoginResponses, Jn as DownloadRawEmailData, Jo as Client, Jr as GetStorageStatsResponses, Jt as CreateFunctionResponses, K as listFilters, Ka as StartCliLoginErrors, Ki as PollCliLoginInput, Kn as DownloadAttachmentsResponse, Ko as VerifyDomainResponses, Kr as GetStorageStatsErrors, Kt as CreateFunctionInput, L as getFunction, La as SentEmailSummary, Li as ListSentEmailsData, Ln as DiscardEmailContentError, Lo as UpdateFunctionErrors, Lr as GetSendPermissionsResponse, Lt as CreateFilterData, M as discardEmailContent, Ma as SendPermissionRule, Mi as ListFunctionsData, Mn as DeleteFunctionSecretResponses, Mo as UpdateFilterInput, Mr as GetFunctionResponse, Mt as CreateEndpointError, N as downloadAttachments, Na as SendPermissionYourDomain, Ni as ListFunctionsError, Nn as DeliveryStatus, No as UpdateFilterResponse, Nr as GetFunctionResponses, Nt as CreateEndpointErrors, O as deleteEndpoint, Oa as SendMailResult, Oi as ListFunctionSecretsError, On as DeleteFunctionSecretData, Oo as UpdateEndpointResponses, Or as GetEmailResponses, Ot as CliLogoutResponses, P as downloadRawEmail, Pa as SendPermissionsMeta, Pi as ListFunctionsErrors, Pn as DeliverySummary, Po as UpdateFilterResponses, Pr as GetSendPermissionsData, Pt as CreateEndpointInput, Q as replayEmailWebhooks, Qa as TestEndpointData, Qi as ReplayDeliveryResponse, Qn as DownloadRawEmailResponses, Qo as Options$1, Qr as GetWebhookSecretResponse, Qt as CreateFunctionSecretErrors, R as getSendPermissions, Ra as SetFunctionSecretData, Ri as ListSentEmailsError, Rn as DiscardEmailContentErrors, Ro as UpdateFunctionInput, Rr as GetSendPermissionsResponses, Rt as CreateFilterError, S as createEndpoint, Sa as SendEmailData, Si as ListFiltersData, Sn as DeleteFilterResponses, So as UpdateDomainResponses, Sr as GetAccountResponse, St as CliLoginStartResult, T as createFunctionSecret, Ta as SendEmailResponse, Ti as ListFiltersResponse, Tn as DeleteFunctionErrors, To as UpdateEndpointErrors, Tr as GetEmailError, Tt as CliLogoutErrors, U as listDomains, Ua as SetFunctionSecretResponses, Ui as PollCliLoginData, Un as DownloadAttachmentsData, Uo as VerifyDomainError, Ur as GetSentEmailResponses, Ut as CreateFunctionData, V as getWebhookSecret, Va as SetFunctionSecretInput, Vi as ListSentEmailsResponses, Vn as Domain, Vo as VerifiedDomain, Vr as GetSentEmailErrors, Vt as CreateFilterResponse, W as listEmails, Wa as StartCliLoginData, Wi as PollCliLoginError, Wn as DownloadAttachmentsError, Wo as VerifyDomainErrors, Wr as GetStorageStatsData, Wt as CreateFunctionError, X as pollCliLogin, Xa as StorageStats, Xi as ReplayDeliveryError, Xn as DownloadRawEmailErrors, Xo as Config, Xr as GetWebhookSecretError, Xt as CreateFunctionSecretData, Y as listSentEmails, Ya as StartCliLoginResponses, Yi as ReplayDeliveryData, Yn as DownloadRawEmailError, Yo as ClientOptions$1, Yr as GetWebhookSecretData, Yt as CreateFunctionResult, Z as replayDelivery, Za as SuccessEnvelope, Zi as ReplayDeliveryErrors, Zn as DownloadRawEmailResponse, Zo as CreateClientConfig, Zr as GetWebhookSecretErrors, Zt as CreateFunctionSecretError, _ as createPrimitiveClient, _a as SearchEmailsData, _i as ListEndpointsError, _n as DeleteEndpointResponses, _o as UpdateDomainData, _r as GateDenial, _t as AddDomainErrors, a as PrimitiveApiClientOptions, aa as ReplayResult, ai as ListDeliveriesResponses, an as DeleteDomainErrors, ao as TestFunctionErrors, ar as EmailSearchResult, at as testEndpoint, b as addDomain, ba as SearchEmailsResponse, bi as ListEndpointsResponses, bn as DeleteFilterErrors, bo as UpdateDomainInput, br as GetAccountError, bt as AddDomainResponses, c as PrimitiveClient, ca as ReplyToEmailErrors, ci as ListDomainsErrors, cn as DeleteEmailData, co as TestInvocationResult, cr as EmailWebhookStatus, ct as updateDomain, d as RequestOptions$1, da as ResourceId, di as ListEmailsData, dn as DeleteEmailResponse, do as UpdateAccountData, dr as Filter, dt as updateFunction, ea as ReplayEmailWebhooksData, ei as Limit, en as CreateFunctionSecretResponse, eo as TestEndpointErrors, er as EmailDetailReply, es as RequestResult, et as rotateWebhookSecret, f as SendInput, fa as RotateWebhookSecretData, fi as ListEmailsError, fn as DeleteEmailResponses, fo as UpdateAccountError, fr as FunctionDeployStatus, ft as verifyDomain, g as createPrimitiveApiClient, ga as RotateWebhookSecretResponses, gi as ListEndpointsData, gn as DeleteEndpointResponse, go as UpdateAccountResponses, gr as FunctionSecretWriteResult, gt as AddDomainError, h as client, ha as RotateWebhookSecretResponse, hi as ListEmailsResponses, hn as DeleteEndpointErrors, ho as UpdateAccountResponse, hr as FunctionSecretListItem, ht as AddDomainData, i as PrimitiveApiClient, ia as ReplayEmailWebhooksResponses, ii as ListDeliveriesResponse, in as DeleteDomainError, io as TestFunctionError, ir as EmailSearchMeta, it as startCliLogin, j as deleteFunctionSecret, ja as SendPermissionManagedZone, ji as ListFunctionSecretsResponses, jn as DeleteFunctionSecretResponse, jo as UpdateFilterErrors, jr as GetFunctionErrors, jt as CreateEndpointData, k as deleteFilter, ka as SendPermissionAddress, ki as ListFunctionSecretsErrors, kn as DeleteFunctionSecretError, ko as UpdateFilterData, kr as GetFunctionData, kt as CliLogoutResult, l as PrimitiveClientOptions, la as ReplyToEmailResponse, li as ListDomainsResponse, ln as DeleteEmailError, lo as TestResult, lr as Endpoint, lt as updateEndpoint, m as SendThreadInput, ma as RotateWebhookSecretErrors, mi as ListEmailsResponse, mn as DeleteEndpointError, mo as UpdateAccountInput, mr as FunctionListItem, mt as AccountUpdated, n as DEFAULT_API_BASE_URL_2, na as ReplayEmailWebhooksErrors, ni as ListDeliveriesError, nn as Cursor, no as TestEndpointResponses, nr as EmailSearchFacets, ns as Auth, nt as sendEmail, o as PrimitiveApiError, oa as ReplyToEmailData, oi as ListDomainsData, on as DeleteDomainResponse, oo as TestFunctionResponse, or as EmailStatus, ot as testFunction, p as SendResult, pa as RotateWebhookSecretError, pi as ListEmailsErrors, pn as DeleteEndpointData, po as UpdateAccountErrors, pr as FunctionDetail, pt as Account, q as listFunctionSecrets, qa as StartCliLoginInput, qi as PollCliLoginResponse, qn as DownloadAttachmentsResponses, qo as WebhookSecret, qr as GetStorageStatsResponse, qt as CreateFunctionResponse, r as ForwardInput, ra as ReplayEmailWebhooksResponse, ri as ListDeliveriesErrors, rn as DeleteDomainData, ro as TestFunctionData, rr as EmailSearchHighlights, rt as setFunctionSecret, s as PrimitiveApiErrorDetails, sa as ReplyToEmailError, si as ListDomainsError, sn as DeleteDomainResponses, so as TestFunctionResponses, sr as EmailSummary, st as updateAccount, t as DEFAULT_API_BASE_URL_1, ta as ReplayEmailWebhooksError, ti as ListDeliveriesData, tn as CreateFunctionSecretResponses, to as TestEndpointResponse, tr as EmailSearchFacetBucket, ts as ResponseStyle, tt as searchEmails, u as ReplyInput, ua as ReplyToEmailResponses, ui as ListDomainsResponses, un as DeleteEmailErrors, uo as UnverifiedDomain, ur as ErrorResponse, ut as updateFilter, v as operations, va as SearchEmailsError, vi as ListEndpointsErrors, vn as DeleteFilterData, vo as UpdateDomainError, vr as GateFix, vt as AddDomainInput, w as createFunction, wa as SendEmailErrors, wi as ListFiltersErrors, wn as DeleteFunctionError, wo as UpdateEndpointError, wr as GetEmailData, wt as CliLogoutError, x as cliLogout, xa as SearchEmailsResponses, xi as ListEnvelope, xn as DeleteFilterResponse, xo as UpdateDomainResponse, xr as GetAccountErrors, xt as CliLoginPollResult, y as Options, ya as SearchEmailsErrors, yi as ListEndpointsResponse, yn as DeleteFilterError, yo as UpdateDomainErrors, yr as GetAccountData, yt as AddDomainResponse, z as getSentEmail, za as SetFunctionSecretError, zi as ListSentEmailsErrors, zn as DiscardEmailContentResponse, zo as UpdateFunctionResponse, zr as GetSentEmailData, zt as CreateFilterErrors } from "../index-jLAAV6Sq.js";
 export { Account, AccountUpdated, AddDomainData, AddDomainError, AddDomainErrors, AddDomainInput, AddDomainResponse, AddDomainResponses, Auth, CliLoginPollResult, CliLoginStartResult, CliLogoutData, CliLogoutError, CliLogoutErrors, CliLogoutInput, CliLogoutResponse, CliLogoutResponses, CliLogoutResult, ClientOptions, CreateClientConfig, CreateEndpointData, CreateEndpointError, CreateEndpointErrors, CreateEndpointInput, CreateEndpointResponse, CreateEndpointResponses, CreateFilterData, CreateFilterError, CreateFilterErrors, CreateFilterInput, CreateFilterResponse, CreateFilterResponses, CreateFunctionData, CreateFunctionError, CreateFunctionErrors, CreateFunctionInput, CreateFunctionResponse, CreateFunctionResponses, CreateFunctionResult, CreateFunctionSecretData, CreateFunctionSecretError, CreateFunctionSecretErrors, CreateFunctionSecretInput, CreateFunctionSecretResponse, CreateFunctionSecretResponses, Cursor, DEFAULT_API_BASE_URL_1, DEFAULT_API_BASE_URL_2, DeleteDomainData, DeleteDomainError, DeleteDomainErrors, DeleteDomainResponse, DeleteDomainResponses, DeleteEmailData, DeleteEmailError, DeleteEmailErrors, DeleteEmailResponse, DeleteEmailResponses, DeleteEndpointData, DeleteEndpointError, DeleteEndpointErrors, DeleteEndpointResponse, DeleteEndpointResponses, DeleteFilterData, DeleteFilterError, DeleteFilterErrors, DeleteFilterResponse, DeleteFilterResponses, DeleteFunctionData, DeleteFunctionError, DeleteFunctionErrors, DeleteFunctionResponse, DeleteFunctionResponses, DeleteFunctionSecretData, DeleteFunctionSecretError, DeleteFunctionSecretErrors, DeleteFunctionSecretResponse, DeleteFunctionSecretResponses, DeliveryStatus, DeliverySummary, DiscardContentResult, DiscardEmailContentData, DiscardEmailContentError, DiscardEmailContentErrors, DiscardEmailContentResponse, DiscardEmailContentResponses, Domain, DomainVerifyResult, DownloadAttachmentsData, DownloadAttachmentsError, DownloadAttachmentsErrors, DownloadAttachmentsResponse, DownloadAttachmentsResponses, DownloadRawEmailData, DownloadRawEmailError, DownloadRawEmailErrors, DownloadRawEmailResponse, DownloadRawEmailResponses, EmailDetail, EmailDetailReply, EmailSearchFacetBucket, EmailSearchFacets, EmailSearchHighlights, EmailSearchMeta, EmailSearchResult, EmailStatus, EmailSummary, EmailWebhookStatus, Endpoint, ErrorResponse, Filter, ForwardInput, FunctionDeployStatus, FunctionDetail, FunctionListItem, FunctionSecretListItem, FunctionSecretWriteResult, GateDenial, GateFix, GetAccountData, GetAccountError, GetAccountErrors, GetAccountResponse, GetAccountResponses, GetEmailData, GetEmailError, GetEmailErrors, GetEmailResponse, GetEmailResponses, GetFunctionData, GetFunctionError, GetFunctionErrors, GetFunctionResponse, GetFunctionResponses, GetSendPermissionsData, GetSendPermissionsError, GetSendPermissionsErrors, GetSendPermissionsResponse, GetSendPermissionsResponses, GetSentEmailData, GetSentEmailError, GetSentEmailErrors, GetSentEmailResponse, GetSentEmailResponses, GetStorageStatsData, GetStorageStatsError, GetStorageStatsErrors, GetStorageStatsResponse, GetStorageStatsResponses, GetWebhookSecretData, GetWebhookSecretError, GetWebhookSecretErrors, GetWebhookSecretResponse, GetWebhookSecretResponses, Limit, ListDeliveriesData, ListDeliveriesError, ListDeliveriesErrors, ListDeliveriesResponse, ListDeliveriesResponses, ListDomainsData, ListDomainsError, ListDomainsErrors, ListDomainsResponse, ListDomainsResponses, ListEmailsData, ListEmailsError, ListEmailsErrors, ListEmailsResponse, ListEmailsResponses, ListEndpointsData, ListEndpointsError, ListEndpointsErrors, ListEndpointsResponse, ListEndpointsResponses, ListEnvelope, ListFiltersData, ListFiltersError, ListFiltersErrors, ListFiltersResponse, ListFiltersResponses, ListFunctionSecretsData, ListFunctionSecretsError, ListFunctionSecretsErrors, ListFunctionSecretsResponse, ListFunctionSecretsResponses, ListFunctionsData, ListFunctionsError, ListFunctionsErrors, ListFunctionsResponse, ListFunctionsResponses, ListSentEmailsData, ListSentEmailsError, ListSentEmailsErrors, ListSentEmailsResponse, ListSentEmailsResponses, Options, PaginationMeta, PollCliLoginData, PollCliLoginError, PollCliLoginErrors, PollCliLoginInput, PollCliLoginResponse, PollCliLoginResponses, PrimitiveApiClient, PrimitiveApiClientOptions, PrimitiveApiError, PrimitiveApiErrorDetails, PrimitiveClient, PrimitiveClientOptions, Client as PrimitiveGeneratedApiClient, ClientOptions$1 as PrimitiveGeneratedApiClientOptions, Config as PrimitiveGeneratedApiConfig, Options$1 as PrimitiveGeneratedApiOptions, RequestOptions as PrimitiveGeneratedApiRequestOptions, RequestResult as PrimitiveGeneratedApiRequestResult, ReplayDeliveryData, ReplayDeliveryError, ReplayDeliveryErrors, ReplayDeliveryResponse, ReplayDeliveryResponses, ReplayEmailWebhooksData, ReplayEmailWebhooksError, ReplayEmailWebhooksErrors, ReplayEmailWebhooksResponse, ReplayEmailWebhooksResponses, ReplayResult, ReplyInput, ReplyToEmailData, ReplyToEmailError, ReplyToEmailErrors, ReplyToEmailResponse, ReplyToEmailResponses, RequestOptions$1 as RequestOptions, ResourceId, ResponseStyle, RotateWebhookSecretData, RotateWebhookSecretError, RotateWebhookSecretErrors, RotateWebhookSecretResponse, RotateWebhookSecretResponses, SearchEmailsData, SearchEmailsError, SearchEmailsErrors, SearchEmailsResponse, SearchEmailsResponses, SendEmailData, SendEmailError, SendEmailErrors, SendEmailResponse, SendEmailResponses, SendInput, SendMailInput, SendMailResult, SendPermissionAddress, SendPermissionAnyRecipient, SendPermissionManagedZone, SendPermissionRule, SendPermissionYourDomain, SendPermissionsMeta, SendResult, SendThreadInput, SentEmailDetail, SentEmailStatus, SentEmailSummary, SetFunctionSecretData, SetFunctionSecretError, SetFunctionSecretErrors, SetFunctionSecretInput, SetFunctionSecretResponse, SetFunctionSecretResponses, StartCliLoginData, StartCliLoginError, StartCliLoginErrors, StartCliLoginInput, StartCliLoginResponse, StartCliLoginResponses, StorageStats, SuccessEnvelope, TestEndpointData, TestEndpointError, TestEndpointErrors, TestEndpointResponse, TestEndpointResponses, TestFunctionData, TestFunctionError, TestFunctionErrors, TestFunctionResponse, TestFunctionResponses, TestInvocationResult, TestResult, UnverifiedDomain, UpdateAccountData, UpdateAccountError, UpdateAccountErrors, UpdateAccountInput, UpdateAccountResponse, UpdateAccountResponses, UpdateDomainData, UpdateDomainError, UpdateDomainErrors, UpdateDomainInput, UpdateDomainResponse, UpdateDomainResponses, UpdateEndpointData, UpdateEndpointError, UpdateEndpointErrors, UpdateEndpointInput, UpdateEndpointResponse, UpdateEndpointResponses, UpdateFilterData, UpdateFilterError, UpdateFilterErrors, UpdateFilterInput, UpdateFilterResponse, UpdateFilterResponses, UpdateFunctionData, UpdateFunctionError, UpdateFunctionErrors, UpdateFunctionInput, UpdateFunctionResponse, UpdateFunctionResponses, VerifiedDomain, VerifyDomainData, VerifyDomainError, VerifyDomainErrors, VerifyDomainResponse, VerifyDomainResponses, WebhookSecret, addDomain, cliLogout, client, createEndpoint, createFilter, createFunction, createFunctionSecret, createPrimitiveApiClient, createPrimitiveClient, deleteDomain, deleteEmail, deleteEndpoint, deleteFilter, deleteFunction, deleteFunctionSecret, discardEmailContent, downloadAttachments, downloadRawEmail, getAccount, getEmail, getFunction, getSendPermissions, getSentEmail, getStorageStats, getWebhookSecret, listDeliveries, listDomains, listEmails, listEndpoints, listFilters, listFunctionSecrets, listFunctions, listSentEmails, operations, pollCliLogin, replayDelivery, replayEmailWebhooks, replyToEmail, rotateWebhookSecret, searchEmails, sendEmail, setFunctionSecret, startCliLogin, testEndpoint, testFunction, updateAccount, updateDomain, updateEndpoint, updateFilter, updateFunction, verifyDomain };

package/dist/{api-BjzvA2Fy.js → api-C3X14uId.js}

@@ -689,7 +689,7 @@ const pollCliLogin = (options) => (options.client ?? client$1).post({
 	url: "/cli/login/poll",
 	...options,
 	headers: {
-		"Content-Type": "application/json",
+		...options.body !== void 0 && { "Content-Type": "application/json" },
 		...options.headers
 	}
 });
@@ -734,7 +734,7 @@ const updateAccount = (options) => (options.client ?? client$1).patch({
 	url: "/account",
 	...options,
 	headers: {
-		"Content-Type": "application/json",
+		...options.body !== void 0 && { "Content-Type": "application/json" },
 		...options.headers
 	}
 });
@@ -828,7 +828,7 @@ const addDomain = (options) => (options.client ?? client$1).post({
 	url: "/domains",
 	...options,
 	headers: {
-		"Content-Type": "application/json",
+		...options.body !== void 0 && { "Content-Type": "application/json" },
 		...options.headers
 	}
 });
@@ -860,7 +860,7 @@ const updateDomain = (options) => (options.client ?? client$1).patch({
 	url: "/domains/{id}",
 	...options,
 	headers: {
-		"Content-Type": "application/json",
+		...options.body !== void 0 && { "Content-Type": "application/json" },
 		...options.headers
 	}
 });
@@ -1042,7 +1042,7 @@ const replyToEmail = (options) => (options.client ?? client$1).post({
 	url: "/emails/{id}/reply",
 	...options,
 	headers: {
-		"Content-Type": "application/json",
+		...options.body !== void 0 && { "Content-Type": "application/json" },
 		...options.headers
 	}
 });
@@ -1132,7 +1132,7 @@ const createEndpoint = (options) => (options.client ?? client$1).post({
 	url: "/endpoints",
 	...options,
 	headers: {
-		"Content-Type": "application/json",
+		...options.body !== void 0 && { "Content-Type": "application/json" },
 		...options.headers
 	}
 });
@@ -1167,7 +1167,7 @@ const updateEndpoint = (options) => (options.client ?? client$1).patch({
 	url: "/endpoints/{id}",
 	...options,
 	headers: {
-		"Content-Type": "application/json",
+		...options.body !== void 0 && { "Content-Type": "application/json" },
 		...options.headers
 	}
 });
@@ -1217,7 +1217,7 @@ const createFilter = (options) => (options.client ?? client$1).post({
 	url: "/filters",
 	...options,
 	headers: {
-		"Content-Type": "application/json",
+		...options.body !== void 0 && { "Content-Type": "application/json" },
 		...options.headers
 	}
 });
@@ -1245,7 +1245,7 @@ const updateFilter = (options) => (options.client ?? client$1).patch({
 	url: "/filters/{id}",
 	...options,
 	headers: {
-		"Content-Type": "application/json",
+		...options.body !== void 0 && { "Content-Type": "application/json" },
 		...options.headers
 	}
 });
@@ -1350,7 +1350,7 @@ const sendEmail = (options) => (options.client ?? client$1).post({
 	url: "/send-mail",
 	...options,
 	headers: {
-		"Content-Type": "application/json",
+		...options.body !== void 0 && { "Content-Type": "application/json" },
 		...options.headers
 	}
 });
@@ -1455,7 +1455,7 @@ const createFunction = (options) => (options.client ?? client$1).post({
 	url: "/functions",
 	...options,
 	headers: {
-		"Content-Type": "application/json",
+		...options.body !== void 0 && { "Content-Type": "application/json" },
 		...options.headers
 	}
 });
@@ -1520,7 +1520,7 @@ const updateFunction = (options) => (options.client ?? client$1).put({
 	url: "/functions/{id}",
 	...options,
 	headers: {
-		"Content-Type": "application/json",
+		...options.body !== void 0 && { "Content-Type": "application/json" },
 		...options.headers
 	}
 });
@@ -1528,8 +1528,14 @@ const updateFunction = (options) => (options.client ?? client$1).put({
 * Send a test invocation
 *
 * Sends a real test email from a Primitive-controlled sender to a
-* synthetic local-part on one of the org's verified inbound
-* domains. The function fires through the normal MX delivery
+* local-part on one of the org's verified inbound domains. By
+* default the recipient is a synthetic
+* `__primitive_function_test+<random>@<domain>` address that
+* every handler's catch-all routing receives identically; pass
+* `local_part` to override and exercise routing logic that
+* branches on a specific recipient (the common pattern when one
+* function handles multiple inboxes like `summarize@` and
+* `action@`). The function fires through the normal MX delivery
 * path, so reply / send-mail calls from inside the handler
 * against the inbound's `email.id` work the same as in
 * production. Returns immediately after the send is queued; the
@@ -1539,6 +1545,8 @@ const updateFunction = (options) => (options.client ?? client$1).put({
 * Requires that the function is currently `deployed`. Returns 422
 * if the function is in `pending` or `failed` state, or if the
 * org has no verified inbound domain to receive the test mail.
+* Returns 400 if `local_part` is set to a value that does not
+* match the local-part character set.
 *
 */
 const testFunction = (options) => (options.client ?? client$1).post({
@@ -1547,7 +1555,11 @@ const testFunction = (options) => (options.client ?? client$1).post({
 		type: "http"
 	}],
 	url: "/functions/{id}/test",
-	...options
+	...options,
+	headers: {
+		...options.body !== void 0 && { "Content-Type": "application/json" },
+		...options.headers
+	}
 });
 /**
 * List a function's secrets
@@ -1594,7 +1606,7 @@ const createFunctionSecret = (options) => (options.client ?? client$1).post({
 	url: "/functions/{id}/secrets",
 	...options,
 	headers: {
-		"Content-Type": "application/json",
+		...options.body !== void 0 && { "Content-Type": "application/json" },
 		...options.headers
 	}
 });
@@ -1634,7 +1646,7 @@ const setFunctionSecret = (options) => (options.client ?? client$1).put({
 	url: "/functions/{id}/secrets/{key}",
 	...options,
 	headers: {
-		"Content-Type": "application/json",
+		...options.body !== void 0 && { "Content-Type": "application/json" },
 		...options.headers
 	}
 });

package/dist/{index-QTYQpSFt.d.ts → index-jLAAV6Sq.d.ts}

@@ -3369,7 +3369,19 @@ type UpdateFunctionResponses = {
 };
 type UpdateFunctionResponse = UpdateFunctionResponses[keyof UpdateFunctionResponses];
 type TestFunctionData = {
-  body?: never;
+  body?: {
+    /**
+     * Override the synthetic local-part. When set, the
+     * test email is sent to `<local_part>@<picked-domain>`
+     * instead of the default
+     * `__primitive_function_test+<random>@<picked-domain>`.
+     * Must start with an alphanumeric and contain only
+     * letters, digits, dots, plus signs, hyphens, or
+     * underscores; 1-64 characters total.
+     *
+     */
+    local_part?: string;
+  };
   path: {
     /**
      * Resource UUID
@@ -4104,8 +4116,14 @@ declare const updateFunction: <ThrowOnError extends boolean = false>(options: Op
  * Send a test invocation
  *
  * Sends a real test email from a Primitive-controlled sender to a
- * synthetic local-part on one of the org's verified inbound
- * domains. The function fires through the normal MX delivery
+ * local-part on one of the org's verified inbound domains. By
+ * default the recipient is a synthetic
+ * `__primitive_function_test+<random>@<domain>` address that
+ * every handler's catch-all routing receives identically; pass
+ * `local_part` to override and exercise routing logic that
+ * branches on a specific recipient (the common pattern when one
+ * function handles multiple inboxes like `summarize@` and
+ * `action@`). The function fires through the normal MX delivery
  * path, so reply / send-mail calls from inside the handler
  * against the inbound's `email.id` work the same as in
  * production. Returns immediately after the send is queued; the
@@ -4115,6 +4133,8 @@ declare const updateFunction: <ThrowOnError extends boolean = false>(options: Op
  * Requires that the function is currently `deployed`. Returns 422
  * if the function is in `pending` or `failed` state, or if the
  * org has no verified inbound domain to receive the test mail.
+ * Returns 400 if `local_part` is set to a value that does not
+ * match the local-part character set.
  *
  */
 declare const testFunction: <ThrowOnError extends boolean = false>(options: Options<TestFunctionData, ThrowOnError>) => RequestResult<TestFunctionResponses, TestFunctionErrors, ThrowOnError, "fields">;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { A as UnknownEvent, C as ParsedDataFailed, D as RawContentDownloadOnly, E as RawContent, M as WebhookAttachment, N as WebhookEvent, O as RawContentInline, S as ParsedDataComplete, T as ParsedStatus, _ as ForwardResultInline, a as DmarcPolicy, b as KnownWebhookEvent, c as EmailAnalysis, d as EventType, f as ForwardAnalysis, g as ForwardResultAttachmentSkipped, h as ForwardResultAttachmentAnalyzed, i as DkimSignature, j as ValidateEmailAuthResult, k as SpfResult, l as EmailAuth, m as ForwardResult, n as AuthVerdict, o as DmarcResult, p as ForwardOriginalSender, r as DkimResult, s as EmailAddress, t as AuthConfidence, u as EmailReceivedEvent, v as ForwardVerdict, w as ParsedError, x as ParsedData, y as ForwardVerification } from "./types-9vXGZjPd.js";
 import { a as buildReplySubject, c as parseHeaderAddress, i as buildForwardSubject, n as ReceivedEmailAddress, o as formatAddress, r as ReceivedEmailThread, s as normalizeReceivedEmail, t as ReceivedEmail } from "./received-email-DNjpq_Wt.js";
-import { _ as createPrimitiveClient, c as PrimitiveClient, f as SendInput, h as client, l as PrimitiveClientOptions, m as SendThreadInput, o as PrimitiveApiError, p as SendResult, r as ForwardInput, u as ReplyInput } from "./index-QTYQpSFt.js";
+import { _ as createPrimitiveClient, c as PrimitiveClient, f as SendInput, h as client, l as PrimitiveClientOptions, m as SendThreadInput, o as PrimitiveApiError, p as SendResult, r as ForwardInput, u as ReplyInput } from "./index-jLAAV6Sq.js";
 import { A as VerifyOptions, B as PAYLOAD_ERRORS, C as signStandardWebhooksPayload, D as PRIMITIVE_CONFIRMED_HEADER, E as LEGACY_SIGNATURE_HEADER, F as VerifyDownloadTokenResult, G as VERIFICATION_ERRORS, H as RAW_EMAIL_ERRORS, I as generateDownloadToken, J as WebhookPayloadErrorCode, K as WebhookErrorCode, L as verifyDownloadToken, M as verifyWebhookSignature, N as GenerateDownloadTokenOptions, O as PRIMITIVE_SIGNATURE_HEADER, P as VerifyDownloadTokenOptions, Q as WebhookVerificationErrorCode, R as safeValidateEmailReceivedEvent, S as StandardWebhooksVerifyOptions, T as LEGACY_CONFIRMED_HEADER, U as RawEmailDecodeError, V as PrimitiveWebhookError, W as RawEmailDecodeErrorCode, X as WebhookValidationErrorCode, Y as WebhookValidationError, Z as WebhookVerificationError, _ as emailReceivedEventJsonSchema, a as confirmedHeaders, b as STANDARD_WEBHOOK_TIMESTAMP_HEADER, c as handleWebhook, d as isRawIncluded, f as parseWebhookEvent, g as validateEmailAuth, h as WEBHOOK_VERSION, i as WebhookHeaders, j as signWebhookPayload, k as SignResult, l as isDownloadExpired, m as verifyRawEmailDownload, n as HandleWebhookOptions, o as decodeRawEmail, p as receive, q as WebhookPayloadError, r as ReceiveRequestOptions, s as getDownloadTimeRemaining, t as DecodeRawEmailOptions, u as isEmailReceivedEvent, v as STANDARD_WEBHOOK_ID_HEADER, w as verifyStandardWebhooksSignature, x as StandardWebhooksSignResult, y as STANDARD_WEBHOOK_SIGNATURE_HEADER, z as validateEmailReceivedEvent } from "./index-CDlwyxdp.js";
 
 //#region src/index.d.ts

package/dist/index.js

@@ -1,5 +1,5 @@
 import { a as parseHeaderAddress, i as normalizeReceivedEmail, n as buildReplySubject, r as formatAddress, t as buildForwardSubject } from "./received-email-D6tKtWwW.js";
-import { a as PrimitiveClient, c as createPrimitiveClient, i as PrimitiveApiError, o as client } from "./api-BjzvA2Fy.js";
+import { a as PrimitiveClient, c as createPrimitiveClient, i as PrimitiveApiError, o as client } from "./api-C3X14uId.js";
 import { A as PRIMITIVE_CONFIRMED_HEADER, B as RAW_EMAIL_ERRORS, C as STANDARD_WEBHOOK_ID_HEADER, D as verifyStandardWebhooksSignature, E as signStandardWebhooksPayload, F as verifyDownloadToken, G as WebhookVerificationError, H as VERIFICATION_ERRORS, I as safeValidateEmailReceivedEvent, L as validateEmailReceivedEvent, M as signWebhookPayload, N as verifyWebhookSignature, O as LEGACY_CONFIRMED_HEADER, P as generateDownloadToken, R as PAYLOAD_ERRORS, S as emailReceivedEventJsonSchema, T as STANDARD_WEBHOOK_TIMESTAMP_HEADER, U as WebhookPayloadError, V as RawEmailDecodeError, W as WebhookValidationError, _ as DmarcResult, a as isDownloadExpired, b as ParsedStatus, c as parseWebhookEvent, d as WEBHOOK_VERSION, f as validateEmailAuth, g as DmarcPolicy, h as DkimResult, i as handleWebhook, j as PRIMITIVE_SIGNATURE_HEADER, k as LEGACY_SIGNATURE_HEADER, l as receive, m as AuthVerdict, n as decodeRawEmail, o as isEmailReceivedEvent, p as AuthConfidence, r as getDownloadTimeRemaining, s as isRawIncluded, t as confirmedHeaders, u as verifyRawEmailDownload, v as EventType, w as STANDARD_WEBHOOK_SIGNATURE_HEADER, x as SpfResult, y as ForwardVerdict, z as PrimitiveWebhookError } from "./webhook-rUjGV6Zu.js";
 //#region src/index.ts
 const primitive = {

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

@@ -3,6 +3,7 @@ import { createFunction } from "../../api/generated/sdk.gen.js";
 import { PrimitiveApiClient } from "../../api/index.js";
 import { extractErrorPayload, readTextFileFlag, removeStaleSavedCredentialOnUnauthorized, runWithTiming, TIME_FLAG_DESCRIPTION, writeErrorWithHints, } from "../api-command.js";
 import { resolveCliAuth } from "../auth.js";
+import { emitRawSendMailFetchWarning } from "../lint/raw-send-mail-fetch.js";
 // `primitive functions:deploy` is the agent-grade shortcut for
 // `functions:create-function`. The underlying operation takes `code`
 // as a string in the JSON body, which is awkward at the CLI for
@@ -72,6 +73,12 @@ class FunctionsDeployCommand extends Command {
             const sourceMap = flags["source-map-file"]
                 ? readTextFileFlag(flags["source-map-file"], "--source-map-file")
                 : undefined;
+            // Non-blocking deploy-time lint: if the bundle has a raw
+            // fetch(...) call against /send-mail, nudge the author toward
+            // `createPrimitiveClient` from `@primitivedotdev/sdk/api`.
+            // The warning lands on stderr so it never contaminates the
+            // JSON stdout the caller may pipe into jq.
+            emitRawSendMailFetchWarning(code, (chunk) => process.stderr.write(chunk));
             const baseUrlOverridden = flags["api-base-url-1"] !== undefined ||
                 flags["api-base-url-2"] !== undefined;
             const auth = resolveCliAuth({

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

@@ -3,6 +3,7 @@ import { updateFunction } from "../../api/generated/sdk.gen.js";
 import { PrimitiveApiClient } from "../../api/index.js";
 import { extractErrorPayload, readTextFileFlag, removeStaleSavedCredentialOnUnauthorized, runWithTiming, TIME_FLAG_DESCRIPTION, writeErrorWithHints, } from "../api-command.js";
 import { resolveCliAuth } from "../auth.js";
+import { emitRawSendMailFetchWarning } from "../lint/raw-send-mail-fetch.js";
 // `primitive functions:redeploy` is the agent-grade shortcut for
 // `functions:update-function`. Same file-reading ergonomic as
 // functions:deploy but for an existing function. Use this to push a
@@ -61,6 +62,12 @@ class FunctionsRedeployCommand extends Command {
             const sourceMap = flags["source-map-file"]
                 ? readTextFileFlag(flags["source-map-file"], "--source-map-file")
                 : undefined;
+            // Non-blocking deploy-time lint: if the bundle has a raw
+            // fetch(...) call against /send-mail, nudge the author toward
+            // `createPrimitiveClient` from `@primitivedotdev/sdk/api`.
+            // Same check as functions:deploy; warning goes to stderr and
+            // the deploy continues regardless.
+            emitRawSendMailFetchWarning(code, (chunk) => process.stderr.write(chunk));
             const baseUrlOverridden = flags["api-base-url-1"] !== undefined ||
                 flags["api-base-url-2"] !== undefined;
             const auth = resolveCliAuth({

package/dist/oclif/lint/raw-send-mail-fetch.js

@@ -0,0 +1,98 @@
+// Deploy-time lint for `functions:deploy --file <bundle>` and
+// `functions:redeploy --file <bundle>`. Looks for a raw
+// `fetch("...primitive.dev/.../send-mail", ...)` call in the bundle
+// text and, on a match, emits a stderr warning telling the author
+// to prefer `createPrimitiveClient` from `@primitivedotdev/sdk/api`.
+//
+// Why: a recurring pattern in agent-assisted Function deploys is to
+// copy the REST snippet from the docs and call `fetch` directly
+// against the Primitive send-mail endpoint, even after the docs
+// switched to leading with the SDK and `functions:init` ships a
+// scaffold that uses `createPrimitiveClient`. The SDK already
+// handles dual-host routing, error envelopes, and send-permission
+// gate denials; raw `fetch` re-discovers each of those by hand. The
+// warning is the catch-net at deploy time: the deploy still
+// proceeds.
+//
+// Scope by design:
+// - We only flag the empirically observed footgun: `/send-mail`.
+//   Not arbitrary calls to api.primitive.dev. Other endpoints have
+//   not surfaced the same pattern.
+// - We require the URL string literal to immediately follow the
+//   `fetch(` token (allowing whitespace) so we don't trip on a
+//   comment that merely mentions the URL. esbuild strips most
+//   comments anyway, but anchoring on `fetch(` keeps the rule
+//   honest without trying to parse JS.
+// - We only look at the bundle text passed in. Source maps and
+//   sibling files are not scanned.
+// - Variable-URL cases (`fetch(url, ...)` where `url` was assembled
+//   elsewhere) are accepted false negatives. The value here is
+//   catching the obvious inline-literal case, not full taint
+//   analysis.
+// Match `fetch(` then a string literal (single, double, or backtick)
+// whose contents include `primitive.dev` and end with `/send-mail`
+// (optionally with a query string or trailing path boundary). Examples
+// matched:
+//   fetch("https://api.primitive.dev/v1/send-mail", {...})
+//   fetch(`https://www.primitive.dev/api/v1/send-mail`, {...})
+//   fetch('https://primitive.dev/api/v1/send-mail?wait=1')
+//
+// The `[^`'"]*` inside the literal forbids the closing quote
+// character itself so we can't accidentally span across two adjacent
+// string literals. The trailing `(?![A-Za-z0-9_-])` forbids any
+// letter, digit, underscore, or hyphen immediately after `send-mail`
+// so `/send-mail-template-preview` does not trip the rule. (Plain
+// `\b` does not help here because `-` is itself a non-word character,
+// so `mail\b` still matches `mail-...`.)
+const RAW_SEND_MAIL_FETCH_REGEX = /fetch\s*\(\s*[`'"][^`'"]*primitive\.dev[^`'"]*\/send-mail(?![A-Za-z0-9_-])/g;
+// How much surrounding text to include on either side of the match
+// when building the sample snippet. Kept short on purpose: bundles
+// are minified and a 120-char window is enough to spot the call
+// without flooding stderr.
+const SNIPPET_PADDING = 60;
+export function detectRawSendMailFetch(bundleText) {
+    // Reset lastIndex defensively: this regex is module-scoped with
+    // the /g flag, so a prior call's state would skip the next match.
+    RAW_SEND_MAIL_FETCH_REGEX.lastIndex = 0;
+    const match = RAW_SEND_MAIL_FETCH_REGEX.exec(bundleText);
+    if (!match) {
+        return { found: false, sampleSnippet: null };
+    }
+    const start = Math.max(0, match.index - SNIPPET_PADDING);
+    const end = Math.min(bundleText.length, match.index + match[0].length + SNIPPET_PADDING);
+    const raw = bundleText.slice(start, end);
+    // Collapse newlines and runs of whitespace so the snippet is one
+    // readable line on stderr regardless of how the bundle was
+    // formatted.
+    const sampleSnippet = raw.replace(/\s+/g, " ").trim();
+    return { found: true, sampleSnippet };
+}
+// The stderr warning copy. Three beats: name the issue, name the
+// SDK alternative, link the docs. Plus a one-line "deploy proceeds"
+// reassurance. Kept punctuation simple (commas, periods, line
+// breaks) so it doesn't trip the no-em-dashes hook and so the lines
+// wrap predictably in a terminal.
+export const RAW_SEND_MAIL_FETCH_WARNING_LINES = [
+    "warning: this bundle calls fetch(...) against /send-mail directly.",
+    "The Primitive SDK exposes createPrimitiveClient from",
+    "@primitivedotdev/sdk/api which handles host routing, error envelopes,",
+    "and gate denials for you. See https://www.primitive.dev/docs/functions",
+    "for the recommended in-handler pattern. Continuing with deploy.",
+];
+export function formatRawSendMailFetchWarning(finding) {
+    const lines = [...RAW_SEND_MAIL_FETCH_WARNING_LINES];
+    if (finding.sampleSnippet) {
+        lines.push(`  found: ${finding.sampleSnippet}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+// Convenience: run the detector and, on a match, write the warning
+// to a stderr-shaped writer. Pulled out so both deploy and redeploy
+// share one code path and so the unit tests can pass a fake writer.
+export function emitRawSendMailFetchWarning(bundleText, write) {
+    const finding = detectRawSendMailFetch(bundleText);
+    if (finding.found) {
+        write(formatRawSendMailFetchWarning(finding));
+    }
+    return finding;
+}

package/dist/openapi/openapi.generated.js

@@ -2569,10 +2569,30 @@ export const openapiDocument = {
             "post": {
                 "operationId": "testFunction",
                 "summary": "Send a test invocation",
-                "description": "Sends a real test email from a Primitive-controlled sender to a\nsynthetic local-part on one of the org's verified inbound\ndomains. The function fires through the normal MX delivery\npath, so reply / send-mail calls from inside the handler\nagainst the inbound's `email.id` work the same as in\nproduction. Returns immediately after the send is queued; the\ninvocation appears on the function's invocations list within a\nfew seconds.\n\nRequires that the function is currently `deployed`. Returns 422\nif the function is in `pending` or `failed` state, or if the\norg has no verified inbound domain to receive the test mail.\n",
+                "description": "Sends a real test email from a Primitive-controlled sender to a\nlocal-part on one of the org's verified inbound domains. By\ndefault the recipient is a synthetic\n`__primitive_function_test+<random>@<domain>` address that\nevery handler's catch-all routing receives identically; pass\n`local_part` to override and exercise routing logic that\nbranches on a specific recipient (the common pattern when one\nfunction handles multiple inboxes like `summarize@` and\n`action@`). The function fires through the normal MX delivery\npath, so reply / send-mail calls from inside the handler\nagainst the inbound's `email.id` work the same as in\nproduction. Returns immediately after the send is queued; the\ninvocation appears on the function's invocations list within a\nfew seconds.\n\nRequires that the function is currently `deployed`. Returns 422\nif the function is in `pending` or `failed` state, or if the\norg has no verified inbound domain to receive the test mail.\nReturns 400 if `local_part` is set to a value that does not\nmatch the local-part character set.\n",
                 "tags": [
                     "Functions"
                 ],
+                "requestBody": {
+                    "required": false,
+                    "content": {
+                        "application/json": {
+                            "schema": {
+                                "type": "object",
+                                "properties": {
+                                    "local_part": {
+                                        "type": "string",
+                                        "description": "Override the synthetic local-part. When set, the\ntest email is sent to `<local_part>@<picked-domain>`\ninstead of the default\n`__primitive_function_test+<random>@<picked-domain>`.\nMust start with an alphanumeric and contain only\nletters, digits, dots, plus signs, hyphens, or\nunderscores; 1-64 characters total.\n",
+                                        "minLength": 1,
+                                        "maxLength": 64,
+                                        "pattern": "^[A-Za-z0-9][A-Za-z0-9._+-]{0,63}$",
+                                        "example": "summarize"
+                                    }
+                                }
+                            }
+                        }
+                    }
+                },
                 "responses": {
                     "200": {
                         "description": "Test send queued",

package/dist/openapi/operations.generated.js

@@ -3034,8 +3034,8 @@ export const operationManifest = [
         "binaryResponse": false,
         "bodyRequired": false,
         "command": "test-function",
-        "description": "Sends a real test email from a Primitive-controlled sender to a\nsynthetic local-part on one of the org's verified inbound\ndomains. The function fires through the normal MX delivery\npath, so reply / send-mail calls from inside the handler\nagainst the inbound's `email.id` work the same as in\nproduction. Returns immediately after the send is queued; the\ninvocation appears on the function's invocations list within a\nfew seconds.\n\nRequires that the function is currently `deployed`. Returns 422\nif the function is in `pending` or `failed` state, or if the\norg has no verified inbound domain to receive the test mail.\n",
-        "hasJsonBody": false,
+        "description": "Sends a real test email from a Primitive-controlled sender to a\nlocal-part on one of the org's verified inbound domains. By\ndefault the recipient is a synthetic\n`__primitive_function_test+<random>@<domain>` address that\nevery handler's catch-all routing receives identically; pass\n`local_part` to override and exercise routing logic that\nbranches on a specific recipient (the common pattern when one\nfunction handles multiple inboxes like `summarize@` and\n`action@`). The function fires through the normal MX delivery\npath, so reply / send-mail calls from inside the handler\nagainst the inbound's `email.id` work the same as in\nproduction. Returns immediately after the send is queued; the\ninvocation appears on the function's invocations list within a\nfew seconds.\n\nRequires that the function is currently `deployed`. Returns 422\nif the function is in `pending` or `failed` state, or if the\norg has no verified inbound domain to receive the test mail.\nReturns 400 if `local_part` is set to a value that does not\nmatch the local-part character set.\n",
+        "hasJsonBody": true,
         "method": "POST",
         "operationId": "testFunction",
         "path": "/functions/{id}/test",
@@ -3049,7 +3049,19 @@ export const operationManifest = [
             }
         ],
         "queryParams": [],
-        "requestSchema": null,
+        "requestSchema": {
+            "type": "object",
+            "properties": {
+                "local_part": {
+                    "type": "string",
+                    "description": "Override the synthetic local-part. When set, the\ntest email is sent to `<local_part>@<picked-domain>`\ninstead of the default\n`__primitive_function_test+<random>@<picked-domain>`.\nMust start with an alphanumeric and contain only\nletters, digits, dots, plus signs, hyphens, or\nunderscores; 1-64 characters total.\n",
+                    "minLength": 1,
+                    "maxLength": 64,
+                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._+-]{0,63}$",
+                    "example": "summarize"
+                }
+            }
+        },
         "responseSchema": {
             "type": "object",
             "description": "Metadata returned by POST /functions/{id}/test. The send is\nqueued; the actual invocation lands on the function's\ninvocations list a few seconds later as the inbound mail\ntraverses the MX path.\n",

package/oclif.manifest.json

@@ -3565,7 +3565,7 @@
     "functions:test-function": {
       "aliases": [],
       "args": {},
-      "description": "Sends a real test email from a Primitive-controlled sender to a\nsynthetic local-part on one of the org's verified inbound\ndomains. The function fires through the normal MX delivery\npath, so reply / send-mail calls from inside the handler\nagainst the inbound's `email.id` work the same as in\nproduction. Returns immediately after the send is queued; the\ninvocation appears on the function's invocations list within a\nfew seconds.\n\nRequires that the function is currently `deployed`. Returns 422\nif the function is in `pending` or `failed` state, or if the\norg has no verified inbound domain to receive the test mail.\n",
+      "description": "Sends a real test email from a Primitive-controlled sender to a\nlocal-part on one of the org's verified inbound domains. By\ndefault the recipient is a synthetic\n`__primitive_function_test+<random>@<domain>` address that\nevery handler's catch-all routing receives identically; pass\n`local_part` to override and exercise routing logic that\nbranches on a specific recipient (the common pattern when one\nfunction handles multiple inboxes like `summarize@` and\n`action@`). The function fires through the normal MX delivery\npath, so reply / send-mail calls from inside the handler\nagainst the inbound's `email.id` work the same as in\nproduction. Returns immediately after the send is queued; the\ninvocation appears on the function's invocations list within a\nfew seconds.\n\nRequires that the function is currently `deployed`. Returns 422\nif the function is in `pending` or `failed` state, or if the\norg has no verified inbound domain to receive the test mail.\nReturns 400 if `local_part` is set to a value that does not\nmatch the local-part character set.\n",
       "flags": {
         "api-key": {
           "description": "Primitive API key (defaults to PRIMITIVE_API_KEY or saved `primitive login` credentials)",
@@ -3606,6 +3606,27 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "raw-body": {
+          "description": "Full request body as raw JSON. Escape hatch for nested or complex fields (e.g. arrays); prefer per-field flags (e.g. --to, --from, --body-text) when available.",
+          "name": "raw-body",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "body-file": {
+          "description": "Path to a JSON file used as the request body. Same role as --raw-body for callers passing a saved payload.",
+          "name": "body-file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "local-part": {
+          "description": "Override the synthetic local-part. When set, the test email is sent to `<local_part>@<picked-domain>` instead of the default `__primitive_function_test+<random>@<picked-domain>`. Must start with an alphanumeric and contain only letters, digits, dots, plus signs, hyphens, or underscores; 1-64 characters total.",
+          "name": "local-part",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -4283,5 +4304,5 @@
       "enableJsonFlag": false
     }
   },
-  "version": "0.23.0"
+  "version": "0.25.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@primitivedotdev/sdk",
-  "version": "0.23.0",
-  "description": "Official Primitive Node.js SDK: webhook, api, openapi, contract, and parser modules",
+  "version": "0.25.0",
+  "description": "Official Primitive Node.js SDK: webhook, api, openapi, contract, and parser runtime modules. The CLI moved to @primitivedotdev/cli; this package retains the CLI as a deprecated alias for a few minor releases.",
   "type": "module",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",