@naturali/sdk 0.48.1 → 0.49.0

package/dist/index.cjs

@@ -603,6 +603,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
@@ -2134,6 +2206,7 @@ const API_BASE_URL = "https://api.naturali.ai";
 * is available as typed data.
 */
 var NaturaliClient = class {
+	actors;
 	agents;
 	apiKeys;
 	assistant;
@@ -2160,6 +2233,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);
@@ -2179,6 +2253,7 @@ var NaturaliClient = class {
 	}
 };
 //#endregion
+exports.Actors = Actors;
 exports.Agents = Agents;
 exports.ApiKeys = ApiKeys;
 exports.Assistant = Assistant;