@primitivedotdev/sdk 0.35.3 → 0.37.0

package/dist/{operations.generated-CgJWP2sH.js → operations.generated-CsHewGFi.js}

@@ -1668,7 +1668,7 @@ const openapiDocument = {
 			"post": {
 				"operationId": "createFunction",
 				"summary": "Deploy a function",
-				"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). Primitive signs\neach delivery and forwards the `Primitive-Signature` header to\nthe handler. Verify the raw request body with\n`PRIMITIVE_WEBHOOK_SECRET` before parsing JSON; after verification\nthe request body parses to an `email.received` event (see\n`EmailReceivedEvent` and the Webhook payload section for the full\nschema). Code is bundled before being uploaded; ship a single\nself-contained file rather than 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, stored with each deployment\nattempt, and sent to the runtime so stack traces can resolve to\noriginal source files.\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 internal runtime URL is not returned by\nthe API and is not a customer-facing integration surface.\n\n**Secrets.** New functions ship with the managed secrets\n(`PRIMITIVE_WEBHOOK_SECRET`, `PRIMITIVE_API_KEY`,\n`PRIMITIVE_API_BASE_URL`) already bound. Add user-set secrets via\n`POST /functions/{id}/secrets`; secret writes only land in the\nrunning handler on the next redeploy.\n",
+				"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). Primitive signs\neach delivery and forwards the `Primitive-Signature` header to\nthe handler. Verify the raw request body with\n`PRIMITIVE_WEBHOOK_SECRET` before parsing JSON; after verification\nthe request body parses to an `email.received` event (see\n`EmailReceivedEvent` and the Webhook payload section for the full\nschema). Code is bundled before being uploaded; ship a single\nself-contained file rather than 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, stored with each deployment\nattempt, and sent to the runtime so stack traces can resolve to\noriginal source files.\n\n**Routing.** On successful deploy, the function code is live\nin the runtime, but inbound mail will not reach it until at\nleast one route is bound. Routes are managed from the Primitive\ndashboard. A `deploy_status` of `deployed` means the script is\ninstalled, not that the function is receiving mail. The\ninternal runtime URL is not returned by the API and is not a\ncustomer-facing integration surface.\n\n**Secrets.** New functions ship with the managed secrets\n(`PRIMITIVE_WEBHOOK_SECRET`, `PRIMITIVE_API_KEY`,\n`PRIMITIVE_API_BASE_URL`) already bound. Add user-set secrets via\n`POST /functions/{id}/secrets`; secret writes only land in the\nrunning handler on the next redeploy.\n",
 				"tags": ["Functions"],
 				"requestBody": {
 					"required": true,
@@ -1747,7 +1747,7 @@ const openapiDocument = {
 			"delete": {
 				"operationId": "deleteFunction",
 				"summary": "Delete a function",
-				"description": "Soft-deletes the function row, removes the script from the edge\nruntime, and deactivates the auto-wired webhook endpoint so no\nfurther inbound mail is delivered. Past deploy history,\ninvocations, and logs are retained.\n\nReturns 502 if the runtime delete fails partway; the function\nrow stays in place and the call is safe to retry until it\nsucceeds.\n",
+				"description": "Soft-deletes the function row, removes the script from the edge\nruntime, and deactivates any route bound to this function so no\nfurther inbound mail is delivered. Past deploy history,\ninvocations, and logs are retained.\n\nReturns 502 if the runtime delete fails partway; the function\nrow stays in place and the call is safe to retry until it\nsucceeds.\n",
 				"tags": ["Functions"],
 				"responses": {
 					"200": { "$ref": "#/components/responses/Deleted" },
@@ -1832,6 +1832,92 @@ const openapiDocument = {
 				}
 			}
 		},
+		"/functions/routing-topology": { "get": {
+			"operationId": "getOrgRoutingTopology",
+			"summary": "Get the org's function routing topology",
+			"description": "Returns a single snapshot of how inbound mail is routed across\nthis org's active domains and functions: which active domain has\nwhich function bound, the org's fallback function (if any), and\nevery deployed function with no route bound. Use this to answer\n\"which of my functions actually receive mail?\" diagnostically.\n",
+			"tags": ["Functions"],
+			"responses": {
+				"200": {
+					"description": "Routing topology",
+					"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
+						"type": "object",
+						"properties": { "data": { "$ref": "#/components/schemas/RoutingTopology" } }
+					}] } } }
+				},
+				"401": { "$ref": "#/components/responses/Unauthorized" },
+				"403": { "$ref": "#/components/responses/Forbidden" }
+			}
+		} },
+		"/functions/{id}/routing": {
+			"parameters": [{ "$ref": "#/components/parameters/ResourceId" }],
+			"get": {
+				"operationId": "getFunctionRouting",
+				"summary": "Get a function's current route binding",
+				"description": "Returns the endpoint binding for the function, or null when no\nroute is currently bound. The binding identifies whether the\nfunction receives mail for a specific domain (scoped) or for any\nactive domain that has no scoped binding (fallback).\n",
+				"tags": ["Functions"],
+				"responses": {
+					"200": {
+						"description": "Function routing",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
+							"type": "object",
+							"properties": { "data": { "oneOf": [{ "$ref": "#/components/schemas/FunctionRouting" }, { "type": "null" }] } }
+						}] } } }
+					},
+					"401": { "$ref": "#/components/responses/Unauthorized" },
+					"404": { "$ref": "#/components/responses/NotFound" }
+				}
+			}
+		},
+		"/functions/{id}/route": {
+			"parameters": [{ "$ref": "#/components/parameters/ResourceId" }],
+			"put": {
+				"operationId": "setFunctionRoute",
+				"summary": "Bind a route to a function",
+				"description": "Binds inbound mail to this function. The route target is either\na specific verified domain (scoped) or the org's fallback (any\nactive domain with no scoped binding). If another function is\nalready bound at the target, returns a `conflict` envelope\ndescribing the holder; re-issue with `takeover: true` to\ndeactivate that prior binding and install this one.\n",
+				"tags": ["Functions"],
+				"requestBody": {
+					"required": true,
+					"content": { "application/json": { "schema": { "$ref": "#/components/schemas/FunctionRouteBody" } } }
+				},
+				"responses": {
+					"200": {
+						"description": "Route bound, or conflict requiring takeover",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
+							"type": "object",
+							"properties": { "data": { "$ref": "#/components/schemas/FunctionRouteResult" } }
+						}] } } }
+					},
+					"400": { "$ref": "#/components/responses/ValidationError" },
+					"401": { "$ref": "#/components/responses/Unauthorized" },
+					"404": { "$ref": "#/components/responses/NotFound" }
+				}
+			},
+			"delete": {
+				"operationId": "unsetFunctionRoute",
+				"summary": "Unbind any route from a function",
+				"description": "Deactivates every active endpoint bound to this function. The\nfunction stays deployed but stops receiving inbound mail. Safe\nto call when no route is currently bound (no-op).\n",
+				"tags": ["Functions"],
+				"responses": {
+					"200": {
+						"description": "Route unbound",
+						"content": { "application/json": { "schema": { "allOf": [{ "$ref": "#/components/schemas/SuccessEnvelope" }, {
+							"type": "object",
+							"properties": { "data": {
+								"type": "object",
+								"properties": { "unrouted": {
+									"type": "boolean",
+									"enum": [true]
+								} },
+								"required": ["unrouted"]
+							} }
+						}] } } }
+					},
+					"401": { "$ref": "#/components/responses/Unauthorized" },
+					"404": { "$ref": "#/components/responses/NotFound" }
+				}
+			}
+		},
 		"/functions/{id}/secrets": {
 			"parameters": [{ "$ref": "#/components/parameters/ResourceId" }],
 			"get": {
@@ -5357,6 +5443,178 @@ const openapiDocument = {
 					"trace_url"
 				]
 			},
+			"FunctionRouting": {
+				"type": "object",
+				"description": "A single route binding for a function. `domain` is null when the\nbinding is the org's fallback (any active domain without a scoped\nbinding); otherwise it carries the scoped domain. `rules` is\nreserved for future routing predicates.\n",
+				"properties": {
+					"endpoint_id": {
+						"type": "string",
+						"format": "uuid"
+					},
+					"enabled": { "type": "boolean" },
+					"domain": {
+						"type": ["object", "null"],
+						"properties": {
+							"id": {
+								"type": "string",
+								"format": "uuid"
+							},
+							"name": { "type": ["string", "null"] }
+						},
+						"required": ["id"]
+					},
+					"rules": {
+						"type": "object",
+						"description": "Future routing predicates. Currently empty."
+					},
+					"delivery_count": { "type": "integer" },
+					"success_count": { "type": "integer" },
+					"failure_count": { "type": "integer" },
+					"consecutive_fails": { "type": "integer" },
+					"last_delivery_at": {
+						"type": ["string", "null"],
+						"format": "date-time"
+					},
+					"last_success_at": {
+						"type": ["string", "null"],
+						"format": "date-time"
+					},
+					"last_failure_at": {
+						"type": ["string", "null"],
+						"format": "date-time"
+					}
+				},
+				"required": [
+					"endpoint_id",
+					"enabled",
+					"domain",
+					"rules"
+				]
+			},
+			"RoutingTopology": {
+				"type": "object",
+				"description": "Org-wide map of function routing: which domain points at which\nfunction, the org's fallback binding (if any), and every\ndeployed function with no route currently bound.\n",
+				"properties": {
+					"domains": {
+						"type": "array",
+						"items": {
+							"type": "object",
+							"properties": {
+								"domain_id": {
+									"type": "string",
+									"format": "uuid"
+								},
+								"domain": { "type": "string" },
+								"routed_function": {
+									"type": ["object", "null"],
+									"properties": {
+										"id": {
+											"type": "string",
+											"format": "uuid"
+										},
+										"name": { "type": "string" }
+									},
+									"required": ["id", "name"]
+								},
+								"endpoint_enabled": { "type": ["boolean", "null"] }
+							},
+							"required": [
+								"domain_id",
+								"domain",
+								"routed_function",
+								"endpoint_enabled"
+							]
+						}
+					},
+					"fallback_function": {
+						"type": ["object", "null"],
+						"properties": {
+							"id": {
+								"type": "string",
+								"format": "uuid"
+							},
+							"name": { "type": "string" }
+						},
+						"required": ["id", "name"]
+					},
+					"fallback_enabled": { "type": ["boolean", "null"] },
+					"unrouted_functions": {
+						"type": "array",
+						"items": {
+							"type": "object",
+							"properties": {
+								"id": {
+									"type": "string",
+									"format": "uuid"
+								},
+								"name": { "type": "string" }
+							},
+							"required": ["id", "name"]
+						}
+					}
+				},
+				"required": [
+					"domains",
+					"fallback_function",
+					"fallback_enabled",
+					"unrouted_functions"
+				]
+			},
+			"FunctionRouteBody": {
+				"type": "object",
+				"description": "Target for a route binding. Either a specific verified domain\n(scoped) or the org-wide fallback. Pass `takeover: true` to\ndeactivate any conflicting binding before installing this one.\n",
+				"properties": {
+					"target": { "oneOf": [{
+						"type": "object",
+						"properties": {
+							"kind": {
+								"type": "string",
+								"enum": ["domain"]
+							},
+							"domainId": {
+								"type": "string",
+								"format": "uuid"
+							}
+						},
+						"required": ["kind", "domainId"]
+					}, {
+						"type": "object",
+						"properties": { "kind": {
+							"type": "string",
+							"enum": ["fallback"]
+						} },
+						"required": ["kind"]
+					}] },
+					"takeover": {
+						"type": "boolean",
+						"description": "When true, deactivate any conflicting binding before installing this one."
+					}
+				},
+				"required": ["target"]
+			},
+			"FunctionRouteResult": {
+				"type": "object",
+				"description": "On success, carries the new `routing`. On conflict, carries\n`conflict` describing the binding holder so the caller can\nre-issue with `takeover: true`.\n",
+				"properties": {
+					"routing": { "oneOf": [{ "$ref": "#/components/schemas/FunctionRouting" }, { "type": "null" }] },
+					"conflict": {
+						"type": "object",
+						"properties": {
+							"kind": {
+								"type": "string",
+								"enum": ["http", "function"]
+							},
+							"functionId": {
+								"type": ["string", "null"],
+								"format": "uuid"
+							},
+							"functionName": { "type": ["string", "null"] },
+							"url": { "type": ["string", "null"] }
+						},
+						"required": ["kind"]
+					}
+				}
+			},
 			"FunctionTestRunState": {
 				"type": "string",
 				"description": "High-level state for a function test run trace:\n  - `send_failed`: the initial test email send failed.\n  - `waiting_for_send`: the test run was created but no send result has been recorded yet.\n  - `waiting_for_inbound`: the test send was queued and the matching inbound email has not arrived yet.\n  - `waiting_for_function`: the inbound email arrived and webhook/function processing is still in flight.\n  - `completed`: the function webhook completed successfully.\n  - `failed`: webhook delivery exhausted retries.\n",
@@ -9072,7 +9330,7 @@ const operationManifest = [
 		"binaryResponse": false,
 		"bodyRequired": true,
 		"command": "create-function",
-		"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). Primitive signs\neach delivery and forwards the `Primitive-Signature` header to\nthe handler. Verify the raw request body with\n`PRIMITIVE_WEBHOOK_SECRET` before parsing JSON; after verification\nthe request body parses to an `email.received` event (see\n`EmailReceivedEvent` and the Webhook payload section for the full\nschema). Code is bundled before being uploaded; ship a single\nself-contained file rather than 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, stored with each deployment\nattempt, and sent to the runtime so stack traces can resolve to\noriginal source files.\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 internal runtime URL is not returned by\nthe API and is not a customer-facing integration surface.\n\n**Secrets.** New functions ship with the managed secrets\n(`PRIMITIVE_WEBHOOK_SECRET`, `PRIMITIVE_API_KEY`,\n`PRIMITIVE_API_BASE_URL`) already bound. Add user-set secrets via\n`POST /functions/{id}/secrets`; secret writes only land in the\nrunning handler on the next redeploy.\n",
+		"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). Primitive signs\neach delivery and forwards the `Primitive-Signature` header to\nthe handler. Verify the raw request body with\n`PRIMITIVE_WEBHOOK_SECRET` before parsing JSON; after verification\nthe request body parses to an `email.received` event (see\n`EmailReceivedEvent` and the Webhook payload section for the full\nschema). Code is bundled before being uploaded; ship a single\nself-contained file rather than 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, stored with each deployment\nattempt, and sent to the runtime so stack traces can resolve to\noriginal source files.\n\n**Routing.** On successful deploy, the function code is live\nin the runtime, but inbound mail will not reach it until at\nleast one route is bound. Routes are managed from the Primitive\ndashboard. A `deploy_status` of `deployed` means the script is\ninstalled, not that the function is receiving mail. The\ninternal runtime URL is not returned by the API and is not a\ncustomer-facing integration surface.\n\n**Secrets.** New functions ship with the managed secrets\n(`PRIMITIVE_WEBHOOK_SECRET`, `PRIMITIVE_API_KEY`,\n`PRIMITIVE_API_BASE_URL`) already bound. Add user-set secrets via\n`POST /functions/{id}/secrets`; secret writes only land in the\nrunning handler on the next redeploy.\n",
 		"hasJsonBody": true,
 		"method": "POST",
 		"operationId": "createFunction",
@@ -9208,7 +9466,7 @@ const operationManifest = [
 		"binaryResponse": false,
 		"bodyRequired": false,
 		"command": "delete-function",
-		"description": "Soft-deletes the function row, removes the script from the edge\nruntime, and deactivates the auto-wired webhook endpoint so no\nfurther inbound mail is delivered. Past deploy history,\ninvocations, and logs are retained.\n\nReturns 502 if the runtime delete fails partway; the function\nrow stays in place and the call is safe to retry until it\nsucceeds.\n",
+		"description": "Soft-deletes the function row, removes the script from the edge\nruntime, and deactivates any route bound to this function so no\nfurther inbound mail is delivered. Past deploy history,\ninvocations, and logs are retained.\n\nReturns 502 if the runtime delete fails partway; the function\nrow stays in place and the call is safe to retry until it\nsucceeds.\n",
 		"hasJsonBody": false,
 		"method": "DELETE",
 		"operationId": "deleteFunction",
@@ -9329,6 +9587,77 @@ const operationManifest = [
 		"tag": "Functions",
 		"tagCommand": "functions"
 	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": false,
+		"command": "get-function-routing",
+		"description": "Returns the endpoint binding for the function, or null when no\nroute is currently bound. The binding identifies whether the\nfunction receives mail for a specific domain (scoped) or for any\nactive domain that has no scoped binding (fallback).\n",
+		"hasJsonBody": false,
+		"method": "GET",
+		"operationId": "getFunctionRouting",
+		"path": "/functions/{id}/routing",
+		"pathParams": [{
+			"description": "Resource UUID",
+			"enum": null,
+			"name": "id",
+			"required": true,
+			"type": "string"
+		}],
+		"queryParams": [],
+		"requestSchema": null,
+		"responseSchema": { "oneOf": [{
+			"type": "object",
+			"description": "A single route binding for a function. `domain` is null when the\nbinding is the org's fallback (any active domain without a scoped\nbinding); otherwise it carries the scoped domain. `rules` is\nreserved for future routing predicates.\n",
+			"properties": {
+				"endpoint_id": {
+					"type": "string",
+					"format": "uuid"
+				},
+				"enabled": { "type": "boolean" },
+				"domain": {
+					"type": ["object", "null"],
+					"properties": {
+						"id": {
+							"type": "string",
+							"format": "uuid"
+						},
+						"name": { "type": ["string", "null"] }
+					},
+					"required": ["id"]
+				},
+				"rules": {
+					"type": "object",
+					"description": "Future routing predicates. Currently empty."
+				},
+				"delivery_count": { "type": "integer" },
+				"success_count": { "type": "integer" },
+				"failure_count": { "type": "integer" },
+				"consecutive_fails": { "type": "integer" },
+				"last_delivery_at": {
+					"type": ["string", "null"],
+					"format": "date-time"
+				},
+				"last_success_at": {
+					"type": ["string", "null"],
+					"format": "date-time"
+				},
+				"last_failure_at": {
+					"type": ["string", "null"],
+					"format": "date-time"
+				}
+			},
+			"required": [
+				"endpoint_id",
+				"enabled",
+				"domain",
+				"rules"
+			]
+		}, { "type": "null" }] },
+		"sdkName": "getFunctionRouting",
+		"summary": "Get a function's current route binding",
+		"tag": "Functions",
+		"tagCommand": "functions"
+	},
 	{
 		"binaryResponse": false,
 		"bodyRequired": false,
@@ -9762,6 +10091,92 @@ const operationManifest = [
 		"tag": "Functions",
 		"tagCommand": "functions"
 	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": false,
+		"command": "get-org-routing-topology",
+		"description": "Returns a single snapshot of how inbound mail is routed across\nthis org's active domains and functions: which active domain has\nwhich function bound, the org's fallback function (if any), and\nevery deployed function with no route bound. Use this to answer\n\"which of my functions actually receive mail?\" diagnostically.\n",
+		"hasJsonBody": false,
+		"method": "GET",
+		"operationId": "getOrgRoutingTopology",
+		"path": "/functions/routing-topology",
+		"pathParams": [],
+		"queryParams": [],
+		"requestSchema": null,
+		"responseSchema": {
+			"type": "object",
+			"description": "Org-wide map of function routing: which domain points at which\nfunction, the org's fallback binding (if any), and every\ndeployed function with no route currently bound.\n",
+			"properties": {
+				"domains": {
+					"type": "array",
+					"items": {
+						"type": "object",
+						"properties": {
+							"domain_id": {
+								"type": "string",
+								"format": "uuid"
+							},
+							"domain": { "type": "string" },
+							"routed_function": {
+								"type": ["object", "null"],
+								"properties": {
+									"id": {
+										"type": "string",
+										"format": "uuid"
+									},
+									"name": { "type": "string" }
+								},
+								"required": ["id", "name"]
+							},
+							"endpoint_enabled": { "type": ["boolean", "null"] }
+						},
+						"required": [
+							"domain_id",
+							"domain",
+							"routed_function",
+							"endpoint_enabled"
+						]
+					}
+				},
+				"fallback_function": {
+					"type": ["object", "null"],
+					"properties": {
+						"id": {
+							"type": "string",
+							"format": "uuid"
+						},
+						"name": { "type": "string" }
+					},
+					"required": ["id", "name"]
+				},
+				"fallback_enabled": { "type": ["boolean", "null"] },
+				"unrouted_functions": {
+					"type": "array",
+					"items": {
+						"type": "object",
+						"properties": {
+							"id": {
+								"type": "string",
+								"format": "uuid"
+							},
+							"name": { "type": "string" }
+						},
+						"required": ["id", "name"]
+					}
+				}
+			},
+			"required": [
+				"domains",
+				"fallback_function",
+				"fallback_enabled",
+				"unrouted_functions"
+			]
+		},
+		"sdkName": "getOrgRoutingTopology",
+		"summary": "Get the org's function routing topology",
+		"tag": "Functions",
+		"tagCommand": "functions"
+	},
 	{
 		"binaryResponse": false,
 		"bodyRequired": false,
@@ -9981,6 +10396,130 @@ const operationManifest = [
 		"tag": "Functions",
 		"tagCommand": "functions"
 	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": true,
+		"command": "set-function-route",
+		"description": "Binds inbound mail to this function. The route target is either\na specific verified domain (scoped) or the org's fallback (any\nactive domain with no scoped binding). If another function is\nalready bound at the target, returns a `conflict` envelope\ndescribing the holder; re-issue with `takeover: true` to\ndeactivate that prior binding and install this one.\n",
+		"hasJsonBody": true,
+		"method": "PUT",
+		"operationId": "setFunctionRoute",
+		"path": "/functions/{id}/route",
+		"pathParams": [{
+			"description": "Resource UUID",
+			"enum": null,
+			"name": "id",
+			"required": true,
+			"type": "string"
+		}],
+		"queryParams": [],
+		"requestSchema": {
+			"type": "object",
+			"description": "Target for a route binding. Either a specific verified domain\n(scoped) or the org-wide fallback. Pass `takeover: true` to\ndeactivate any conflicting binding before installing this one.\n",
+			"properties": {
+				"target": { "oneOf": [{
+					"type": "object",
+					"properties": {
+						"kind": {
+							"type": "string",
+							"enum": ["domain"]
+						},
+						"domainId": {
+							"type": "string",
+							"format": "uuid"
+						}
+					},
+					"required": ["kind", "domainId"]
+				}, {
+					"type": "object",
+					"properties": { "kind": {
+						"type": "string",
+						"enum": ["fallback"]
+					} },
+					"required": ["kind"]
+				}] },
+				"takeover": {
+					"type": "boolean",
+					"description": "When true, deactivate any conflicting binding before installing this one."
+				}
+			},
+			"required": ["target"]
+		},
+		"responseSchema": {
+			"type": "object",
+			"description": "On success, carries the new `routing`. On conflict, carries\n`conflict` describing the binding holder so the caller can\nre-issue with `takeover: true`.\n",
+			"properties": {
+				"routing": { "oneOf": [{
+					"type": "object",
+					"description": "A single route binding for a function. `domain` is null when the\nbinding is the org's fallback (any active domain without a scoped\nbinding); otherwise it carries the scoped domain. `rules` is\nreserved for future routing predicates.\n",
+					"properties": {
+						"endpoint_id": {
+							"type": "string",
+							"format": "uuid"
+						},
+						"enabled": { "type": "boolean" },
+						"domain": {
+							"type": ["object", "null"],
+							"properties": {
+								"id": {
+									"type": "string",
+									"format": "uuid"
+								},
+								"name": { "type": ["string", "null"] }
+							},
+							"required": ["id"]
+						},
+						"rules": {
+							"type": "object",
+							"description": "Future routing predicates. Currently empty."
+						},
+						"delivery_count": { "type": "integer" },
+						"success_count": { "type": "integer" },
+						"failure_count": { "type": "integer" },
+						"consecutive_fails": { "type": "integer" },
+						"last_delivery_at": {
+							"type": ["string", "null"],
+							"format": "date-time"
+						},
+						"last_success_at": {
+							"type": ["string", "null"],
+							"format": "date-time"
+						},
+						"last_failure_at": {
+							"type": ["string", "null"],
+							"format": "date-time"
+						}
+					},
+					"required": [
+						"endpoint_id",
+						"enabled",
+						"domain",
+						"rules"
+					]
+				}, { "type": "null" }] },
+				"conflict": {
+					"type": "object",
+					"properties": {
+						"kind": {
+							"type": "string",
+							"enum": ["http", "function"]
+						},
+						"functionId": {
+							"type": ["string", "null"],
+							"format": "uuid"
+						},
+						"functionName": { "type": ["string", "null"] },
+						"url": { "type": ["string", "null"] }
+					},
+					"required": ["kind"]
+				}
+			}
+		},
+		"sdkName": "setFunctionRoute",
+		"summary": "Bind a route to a function",
+		"tag": "Functions",
+		"tagCommand": "functions"
+	},
 	{
 		"binaryResponse": false,
 		"bodyRequired": true,
@@ -10134,6 +10673,37 @@ const operationManifest = [
 		"tag": "Functions",
 		"tagCommand": "functions"
 	},
+	{
+		"binaryResponse": false,
+		"bodyRequired": false,
+		"command": "unset-function-route",
+		"description": "Deactivates every active endpoint bound to this function. The\nfunction stays deployed but stops receiving inbound mail. Safe\nto call when no route is currently bound (no-op).\n",
+		"hasJsonBody": false,
+		"method": "DELETE",
+		"operationId": "unsetFunctionRoute",
+		"path": "/functions/{id}/route",
+		"pathParams": [{
+			"description": "Resource UUID",
+			"enum": null,
+			"name": "id",
+			"required": true,
+			"type": "string"
+		}],
+		"queryParams": [],
+		"requestSchema": null,
+		"responseSchema": {
+			"type": "object",
+			"properties": { "unrouted": {
+				"type": "boolean",
+				"enum": [true]
+			} },
+			"required": ["unrouted"]
+		},
+		"sdkName": "unsetFunctionRoute",
+		"summary": "Unbind any route from a function",
+		"tag": "Functions",
+		"tagCommand": "functions"
+	},
 	{
 		"binaryResponse": false,
 		"bodyRequired": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primitivedotdev/sdk",
-  "version": "0.35.3",
+  "version": "0.37.0",
   "description": "Official Primitive Node.js SDK: webhook, api, openapi, contract, and parser runtime modules.",
   "type": "module",
   "module": "./dist/index.js",