@naturali/sdk 0.48.0 → 0.49.0

package/dist/index.mjs

@@ -602,6 +602,78 @@ const createClient = (config = {}) => {
 const client = createClient(createConfig());
 //#endregion
 //#region src/generated/sdk.gen.ts
+var Actors = class {
+	/**
+	* List actors
+	*
+	* Lists the project's actors. Filter by `external_id` to resolve your own key to an actor without creating one.
+	*
+	*/
+	static listActors(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/actors",
+			...options
+		});
+	}
+	/**
+	* Create an actor
+	*
+	* Creates the actor, or returns the one that already carries this `external_id`. Idempotent on that key: a retry returns the existing actor with `200` rather than creating a second one, so this is safe as the first call your backend makes when it sees a new user.
+	* `external_id` may not start with a channel prefix (`whatsapp:`, `discord:`, …) or `address:` — those name actors that belong to an [address](/docs/api/addresses/get-address), which owns its own.
+	*
+	*/
+	static createActor(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/actors",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Erase an actor
+	*
+	* Removes the actor and the sessions it holds. Erasure of one identity as this API knows it — narrower than "erase this human everywhere", since naturali does not know that two identities are the same person and does not claim to.
+	* An actor that belongs to an [address](/docs/api/addresses/get-address) responds `409`: erase it through `DELETE /v1/projects/{project_id}/addresses/{identifier}`, which also removes the address and its conversations. Deleting it here would leave those behind, pointing at an identity that no longer exists.
+	*
+	*/
+	static deleteActor(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/actors/{actor_id}",
+			...options
+		});
+	}
+	/**
+	* Get an actor
+	*
+	* Returns one actor. An actor belonging to another project responds `404`, not `403` — the API never confirms that an id exists elsewhere.
+	*
+	*/
+	static getActor(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/actors/{actor_id}",
+			...options
+		});
+	}
+	/**
+	* Update an actor
+	*
+	* Updates the fields present in the body and leaves the rest alone. `external_id` is not updatable: it is the key callers converge on, and moving it would silently orphan every reference they hold.
+	*
+	*/
+	static updateActor(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/actors/{actor_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
 var Channels = class {
 	/**
 	* List addresses
@@ -2133,6 +2205,7 @@ const API_BASE_URL = "https://api.naturali.ai";
 * is available as typed data.
 */
 var NaturaliClient = class {
+	actors;
 	agents;
 	apiKeys;
 	assistant;
@@ -2159,6 +2232,7 @@ var NaturaliClient = class {
 				...headers
 			}
 		}));
+		this.actors = bindResource(Actors, this.http);
 		this.agents = bindResource(Agents, this.http);
 		this.apiKeys = bindResource(ApiKeys, this.http);
 		this.assistant = bindResource(Assistant, this.http);
@@ -2178,4 +2252,4 @@ var NaturaliClient = class {
 	}
 };
 //#endregion
-export { Agents, ApiKeys, Assistant, Auth, Boards, Channels, Generations, Knowledge, Models, NaturaliClient, Projects, Providers, Sessions, Tasks, Tools, Traces, Webhooks, createClient, createConfig };
+export { Actors, Agents, ApiKeys, Assistant, Auth, Boards, Channels, Generations, Knowledge, Models, NaturaliClient, Projects, Providers, Sessions, Tasks, Tools, Traces, Webhooks, createClient, createConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.48.0",
+  "version": "0.49.0",
   "description": "TypeScript SDK for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "sideEffects": false,
@@ -37,7 +37,7 @@
     "tsx": "^4.23.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.10",
-    "@naturali/api": "0.48.0"
+    "@naturali/api": "0.49.0"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",