@primitivedotdev/sdk 0.19.0 → 0.21.0

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

@@ -617,15 +617,20 @@ var sdk_gen_exports = /* @__PURE__ */ __exportAll({
 	cliLogout: () => cliLogout,
 	createEndpoint: () => createEndpoint,
 	createFilter: () => createFilter,
+	createFunction: () => createFunction,
+	createFunctionSecret: () => createFunctionSecret,
 	deleteDomain: () => deleteDomain,
 	deleteEmail: () => deleteEmail,
 	deleteEndpoint: () => deleteEndpoint,
 	deleteFilter: () => deleteFilter,
+	deleteFunction: () => deleteFunction,
+	deleteFunctionSecret: () => deleteFunctionSecret,
 	discardEmailContent: () => discardEmailContent,
 	downloadAttachments: () => downloadAttachments,
 	downloadRawEmail: () => downloadRawEmail,
 	getAccount: () => getAccount,
 	getEmail: () => getEmail,
+	getFunction: () => getFunction,
 	getSendPermissions: () => getSendPermissions,
 	getSentEmail: () => getSentEmail,
 	getStorageStats: () => getStorageStats,
@@ -635,19 +640,25 @@ var sdk_gen_exports = /* @__PURE__ */ __exportAll({
 	listEmails: () => listEmails,
 	listEndpoints: () => listEndpoints,
 	listFilters: () => listFilters,
+	listFunctionSecrets: () => listFunctionSecrets,
+	listFunctions: () => listFunctions,
 	listSentEmails: () => listSentEmails,
 	pollCliLogin: () => pollCliLogin,
 	replayDelivery: () => replayDelivery,
 	replayEmailWebhooks: () => replayEmailWebhooks,
 	replyToEmail: () => replyToEmail,
 	rotateWebhookSecret: () => rotateWebhookSecret,
+	searchEmails: () => searchEmails,
 	sendEmail: () => sendEmail,
+	setFunctionSecret: () => setFunctionSecret,
 	startCliLogin: () => startCliLogin,
 	testEndpoint: () => testEndpoint,
+	testFunction: () => testFunction,
 	updateAccount: () => updateAccount,
 	updateDomain: () => updateDomain,
 	updateEndpoint: () => updateEndpoint,
 	updateFilter: () => updateFilter,
+	updateFunction: () => updateFunction,
 	verifyDomain: () => verifyDomain
 });
 /**
@@ -898,6 +909,30 @@ const listEmails = (options) => (options?.client ?? client$1).get({
 	...options
 });
 /**
+* Search inbound emails
+*
+* Searches inbound emails with structured filters and optional
+* full-text matching across parsed email fields. This endpoint is
+* optimized for filtered inbox views and CLI polling workflows:
+* callers that only need new accepted mail can pass
+* `sort=received_at_asc`, `snippet=false`, `include_facets=false`,
+* and a `date_from` timestamp.
+*
+* `q`, `subject`, and `body` use the same English full-text index
+* as the web inbox search. Structured filters such as `from`, `to`,
+* `domain_id`, status, attachment presence, and spam score bounds
+* are combined with the text query.
+*
+*/
+const searchEmails = (options) => (options?.client ?? client$1).get({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/emails/search",
+	...options
+});
+/**
 * Delete an email
 */
 const deleteEmail = (options) => (options.client ?? client$1).delete({
@@ -1297,6 +1332,15 @@ const getSendPermissions = (options) => (options?.client ?? client$1).get({
 * the request returns once the relay accepts the message for delivery.
 * Set `wait: true` to wait for the first downstream SMTP delivery outcome.
 *
+* **Host routing.** /send-mail is served by the attachments-
+* supporting host (`https://api.primitive.dev/v1`) so the
+* request body can carry inline attachments up to ~30 MiB raw.
+* The primary host (`https://www.primitive.dev/api/v1`) also
+* accepts /send-mail for attachment-free sends; sends WITH
+* attachments to the primary host return 413
+* `attachments_unsupported_on_this_endpoint`. The typed SDKs
+* route /send-mail to the attachments host automatically.
+*
 */
 const sendEmail = (options) => (options.client ?? client$1).post({
 	security: [{
@@ -1359,9 +1403,245 @@ const getSentEmail = (options) => (options.client ?? client$1).get({
 	url: "/sent-emails/{id}",
 	...options
 });
+/**
+* List functions
+*
+* Returns every active (non-deleted) function in the org, newest
+* first. Each entry carries the deploy status and the gateway URL
+* that the platform's webhook delivery loop posts to. To inspect
+* the source code or deploy errors, use `GET /functions/{id}`.
+*
+*/
+const listFunctions = (options) => (options?.client ?? client$1).get({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/functions",
+	...options
+});
+/**
+* Deploy a function
+*
+* Creates and deploys a new function. The handler must be a single
+* ESM module that exports a default async function receiving the
+* `email.received` event (see the Webhook payload section for the
+* full schema). Code is bundled before being uploaded; ship a
+* single self-contained file rather than relying on external
+* imports.
+*
+* **Code limits.** `code` is capped at 1 MiB UTF-8. `sourceMap`
+* (optional) is capped at 5 MiB UTF-8 and is stored only on the
+* edge runtime side; it is not persisted in Primitive's database.
+*
+* **Auto-wiring.** On successful deploy, Primitive automatically
+* creates a webhook endpoint that delivers inbound mail to the
+* function. There is nothing to configure on the Endpoints API
+* for this to work; the gateway URL returned here is for
+* reference only and is not directly callable from outside.
+*
+* **Secrets.** New functions ship with the managed secrets
+* (`PRIMITIVE_WEBHOOK_SECRET`, `PRIMITIVE_API_KEY`) already
+* bound. Add user-set secrets via
+* `POST /functions/{id}/secrets`; secret writes only land in the
+* running handler on the next redeploy.
+*
+*/
+const createFunction = (options) => (options.client ?? client$1).post({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/functions",
+	...options,
+	headers: {
+		"Content-Type": "application/json",
+		...options.headers
+	}
+});
+/**
+* Delete a function
+*
+* Soft-deletes the function row, removes the script from the edge
+* runtime, and deactivates the auto-wired webhook endpoint so no
+* further inbound mail is delivered. Past deploy history,
+* invocations, and logs are retained.
+*
+* Returns 502 if the runtime delete fails partway; the function
+* row stays in place and the call is safe to retry until it
+* succeeds.
+*
+*/
+const deleteFunction = (options) => (options.client ?? client$1).delete({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/functions/{id}",
+	...options
+});
+/**
+* Get a function
+*
+* Returns the full record for a function, including its current
+* source code and the deploy status / error from the most recent
+* deploy attempt.
+*
+*/
+const getFunction = (options) => (options.client ?? client$1).get({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/functions/{id}",
+	...options
+});
+/**
+* Update and redeploy a function
+*
+* Replaces the function's source code with the body's `code` and
+* triggers a redeploy. Same size limits as `POST /functions`.
+* Use this verb to push secret writes into the running handler:
+* passing the same `code` re-runs the deploy and refreshes the
+* binding set with the latest values from the secrets table.
+*
+* On a 502 deploy failure, the previously-deployed code stays
+* live; the runtime never serves a half-built bundle. The
+* `deploy_error` field on the returned record carries the error
+* that came back from the runtime so you can surface it to users
+* without polling.
+*
+*/
+const updateFunction = (options) => (options.client ?? client$1).put({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/functions/{id}",
+	...options,
+	headers: {
+		"Content-Type": "application/json",
+		...options.headers
+	}
+});
+/**
+* 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
+* 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
+* invocation appears on the function's invocations list within a
+* few seconds.
+*
+* 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.
+*
+*/
+const testFunction = (options) => (options.client ?? client$1).post({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/functions/{id}/test",
+	...options
+});
+/**
+* List a function's secrets
+*
+* Returns metadata for every secret bound to the function, with
+* managed entries (provisioned by Primitive) listed first and
+* user-set entries listed alphabetically after. **Values are
+* never returned.** Secret writes are write-only.
+*
+* Managed entries (e.g. `PRIMITIVE_WEBHOOK_SECRET`,
+* `PRIMITIVE_API_KEY`) carry a `description` instead of
+* `created_at` / `updated_at`. They cannot be created, updated,
+* or deleted via this API.
+*
+*/
+const listFunctionSecrets = (options) => (options.client ?? client$1).get({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/functions/{id}/secrets",
+	...options
+});
+/**
+* Create or update a secret
+*
+* Idempotent insert-or-update keyed on `(function_id, key)`.
+* Returns 201 the first time the key is set, 200 on subsequent
+* updates. Values are encrypted at rest and only become visible
+* to the running handler on the next deploy (`PUT /functions/{id}`
+* with the existing code is sufficient to refresh bindings).
+*
+* Keys must match `^[A-Z_][A-Z0-9_]*$` (uppercase letters,
+* digits, underscores; first character is a letter or
+* underscore). Values are at most 4096 UTF-8 bytes. System-
+* managed keys are reserved and rejected.
+*
+*/
+const createFunctionSecret = (options) => (options.client ?? client$1).post({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/functions/{id}/secrets",
+	...options,
+	headers: {
+		"Content-Type": "application/json",
+		...options.headers
+	}
+});
+/**
+* Delete a secret
+*
+* Removes the secret. The binding stays live in the running
+* handler until the next deploy refreshes the binding set
+* (`PUT /functions/{id}` with the existing code is sufficient).
+* Returns 404 if the key did not exist. Managed system keys
+* cannot be deleted.
+*
+*/
+const deleteFunctionSecret = (options) => (options.client ?? client$1).delete({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/functions/{id}/secrets/{key}",
+	...options
+});
+/**
+* Set a secret by key
+*
+* Path-keyed companion to `POST /functions/{id}/secrets`.
+* Idempotent: returns 201 the first time the key is set, 200 on
+* subsequent updates. Same validation rules and same write-only
+* guarantees as the POST verb; the new value lands in the running
+* handler on the next deploy.
+*
+*/
+const setFunctionSecret = (options) => (options.client ?? client$1).put({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}],
+	url: "/functions/{id}/secrets/{key}",
+	...options,
+	headers: {
+		"Content-Type": "application/json",
+		...options.headers
+	}
+});
 //#endregion
 //#region src/api/index.ts
-const DEFAULT_BASE_URL = "https://www.primitive.dev/api/v1";
+const DEFAULT_API_BASE_URL_1 = "https://www.primitive.dev/api/v1";
+const DEFAULT_API_BASE_URL_2 = "https://api.primitive.dev/v1";
 const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
 const MAX_THREAD_REFERENCES = 100;
 const MAX_THREAD_HEADER_BYTES = 8 * 1024;
@@ -1467,13 +1747,35 @@ function parseRetryAfterHeader(response) {
 	return Number.isFinite(seconds) ? seconds : void 0;
 }
 var PrimitiveApiClient = class {
+	/**
+	* Generated client targeting the primary API host (apiBaseUrl1). Use
+	* this when passing `client: ...` to a generated operation function
+	* for every endpoint EXCEPT /send-mail. The hand-written
+	* PrimitiveClient.send / .reply / .forward methods on the subclass
+	* route /send-mail to the host-2 client internally.
+	*/
 	client;
+	/**
+	* @internal Generated client targeting the attachments-supporting
+	* send host (apiBaseUrl2). Used by PrimitiveClient.send() under the
+	* hood. Exposed for the CLI's hand-rolled send command, which calls
+	* the generated sendEmail directly; not part of the publicly-
+	* documented SDK surface. Customer code should call .send() on the
+	* subclass instead.
+	*/
+	_sendClient;
 	constructor(options = {}) {
-		const { apiKey, auth, baseUrl = DEFAULT_BASE_URL, ...config } = options;
+		const { apiKey, auth, apiBaseUrl1 = DEFAULT_API_BASE_URL_1, apiBaseUrl2 = DEFAULT_API_BASE_URL_2, ...config } = options;
+		const resolvedAuth = auth ?? createDefaultAuth(apiKey);
 		this.client = createClient(createConfig({
 			...config,
-			auth: auth ?? createDefaultAuth(apiKey),
-			baseUrl
+			auth: resolvedAuth,
+			baseUrl: apiBaseUrl1
+		}));
+		this._sendClient = createClient(createConfig({
+			...config,
+			auth: resolvedAuth,
+			baseUrl: apiBaseUrl2
 		}));
 	}
 	getConfig() {
@@ -1513,7 +1815,7 @@ var PrimitiveClient = class extends PrimitiveApiClient {
 				...input.waitTimeoutMs !== void 0 ? { wait_timeout_ms: input.waitTimeoutMs } : {}
 			},
 			...resolveRequestOptions(options),
-			client: this.client,
+			client: this._sendClient,
 			responseStyle: "fields"
 		}));
 	}
@@ -1625,4 +1927,4 @@ function client(options = {}) {
 }
 const operations = sdk_gen_exports;
 //#endregion
-export { listFilters as A, updateAccount as B, getSentEmail as C, listDomains as D, listDeliveries as E, replyToEmail as F, updateEndpoint as H, rotateWebhookSecret as I, sendEmail as L, pollCliLogin as M, replayDelivery as N, listEmails as O, replayEmailWebhooks as P, startCliLogin as R, getSendPermissions as S, getWebhookSecret as T, updateFilter as U, updateDomain as V, verifyDomain as W, discardEmailContent as _, client as a, getAccount as b, operations as c, createEndpoint as d, createFilter as f, deleteFilter as g, deleteEndpoint as h, PrimitiveClient as i, listSentEmails as j, listEndpoints as k, addDomain as l, deleteEmail as m, PrimitiveApiClient as n, createPrimitiveApiClient as o, deleteDomain as p, PrimitiveApiError as r, createPrimitiveClient as s, DEFAULT_BASE_URL as t, cliLogout as u, downloadAttachments as v, getStorageStats as w, getEmail as x, downloadRawEmail as y, testEndpoint as z };
+export { updateEndpoint as $, getStorageStats as A, pollCliLogin as B, downloadAttachments as C, getFunction as D, getEmail as E, listEndpoints as F, searchEmails as G, replayEmailWebhooks as H, listFilters as I, startCliLogin as J, sendEmail as K, listFunctionSecrets as L, listDeliveries as M, listDomains as N, getSendPermissions as O, listEmails as P, updateDomain as Q, listFunctions as R, discardEmailContent as S, getAccount as T, replyToEmail as U, replayDelivery as V, rotateWebhookSecret as W, testFunction as X, testEndpoint as Y, updateAccount as Z, deleteEmail as _, PrimitiveClient as a, deleteFunction as b, createPrimitiveClient as c, cliLogout as d, updateFilter as et, createEndpoint as f, deleteDomain as g, createFunctionSecret as h, PrimitiveApiError as i, getWebhookSecret as j, getSentEmail as k, operations as l, createFunction as m, DEFAULT_API_BASE_URL_2 as n, verifyDomain as nt, client as o, createFilter as p, setFunctionSecret as q, PrimitiveApiClient as r, createPrimitiveApiClient as s, DEFAULT_API_BASE_URL_1 as t, updateFunction as tt, addDomain as u, deleteEndpoint as v, downloadRawEmail as w, deleteFunctionSecret as x, deleteFilter as y, listSentEmails as z };