@naturali/sdk 0.40.1 → 0.41.0

package/dist/index.cjs

@@ -1833,6 +1833,126 @@ var Traces = class {
 		});
 	}
 };
+var Webhooks = class {
+	/**
+	* List webhooks
+	*
+	* The endpoints registered in the project, newest first.
+	*/
+	static listWebhooks(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/webhooks",
+			...options
+		});
+	}
+	/**
+	* Create a webhook
+	*
+	* Register an endpoint and subscribe it to one or more event types.
+	* The response carries `secret` — the signing key, in plaintext. **This is the only time it is returned.** Store it where your receiver can read it; if you lose it, rotate rather than re-create, so the endpoint keeps its delivery history.
+	* Returns `501` on a deployment with no credential-sealing key configured, since the secret could not then be stored safely.
+	*
+	*/
+	static createWebhook(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/webhooks",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a webhook
+	*
+	* Removes the endpoint and its delivery records. To stop deliveries while keeping the audit trail, `PATCH` it to `active: false` instead.
+	*
+	*/
+	static deleteWebhook(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/webhooks/{webhook_id}",
+			...options
+		});
+	}
+	/**
+	* Get a webhook
+	*/
+	static getWebhook(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/webhooks/{webhook_id}",
+			...options
+		});
+	}
+	/**
+	* Update a webhook
+	*
+	* Change the destination, the subscription, the label, or whether deliveries are attempted at all. At least one field is required.
+	* Setting `active: false` is the reversible half of `DELETE`: deliveries stop, the endpoint and its history stay. It is what to reach for while a receiver is being repaired.
+	*
+	*/
+	static updateWebhook(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/webhooks/{webhook_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Rotate the signing secret
+	*
+	* Issues a new signing secret for the same endpoint and returns it — the second and last time a secret is ever returned. This is the `…:rotate-secret` action; the path segment is `{webhook_id}:rotate-secret`.
+	* The change takes effect on the next delivery, including retries of deliveries already queued, so roll the new secret out to your receiver promptly. There is no overlap window in which both secrets verify.
+	*
+	*/
+	static rotateWebhookSecret(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/webhooks/{webhook_id}:rotate-secret",
+			...options
+		});
+	}
+	/**
+	* List webhook deliveries
+	*
+	* Every delivery attempted in the project, newest first — what was sent, where, how many times, and what came back. Filter by endpoint, by lifecycle status, or by event type.
+	* Deliveries are per (event, endpoint): an event matching two subscribed endpoints produces two rows, retried and observed independently.
+	*
+	*/
+	static listWebhookDeliveries(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/webhook-deliveries",
+			...options
+		});
+	}
+	/**
+	* Get a webhook delivery
+	*
+	* One delivery, including the exact payload that was signed and sent.
+	*
+	*/
+	static getWebhookDelivery(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/webhook-deliveries/{delivery_id}",
+			...options
+		});
+	}
+	/**
+	* Redeliver an event
+	*
+	* Queue the same event at the same endpoint again — the recovery path for a delivery that failed, or one your receiver dropped. This is the `…:redeliver` action; the path segment is `{delivery_id}:redeliver`.
+	* A **new** delivery is created and returned; the original record is left untouched, because its attempt history is the evidence you redelivered on. The event's `id` is carried over unchanged, so a receiver deduping on the event sees the same event twice while one deduping on `X-Naturali-Delivery` sees a distinct delivery.
+	*
+	*/
+	static redeliverWebhookDelivery(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/webhook-deliveries/{delivery_id}:redeliver",
+			...options
+		});
+	}
+};
 //#endregion
 //#region src/naturaliClient.ts
 /**
@@ -1895,6 +2015,7 @@ var NaturaliClient = class {
 	tasks;
 	tools;
 	traces;
+	webhooks;
 	/** The underlying HTTP client, for interceptors or one-off requests. */
 	http;
 	constructor({ token, headers } = {}) {
@@ -1920,6 +2041,7 @@ var NaturaliClient = class {
 		this.tasks = bindResource(Tasks, this.http);
 		this.tools = bindResource(Tools, this.http);
 		this.traces = bindResource(Traces, this.http);
+		this.webhooks = bindResource(Webhooks, this.http);
 	}
 };
 //#endregion
@@ -1939,5 +2061,6 @@ exports.Sessions = Sessions;
 exports.Tasks = Tasks;
 exports.Tools = Tools;
 exports.Traces = Traces;
+exports.Webhooks = Webhooks;
 exports.createClient = createClient;
 exports.createConfig = createConfig;