@terminal3/t3n-sdk 3.10.1 → 3.11.0

package/dist/index.d.ts

@@ -1708,6 +1708,28 @@ declare class T3nClient {
      * @throws {ContractResponseError} when the response is not valid JSON
      */
     executeAndDecode<T = unknown>(payload: unknown, schema?: ContractResponseSchema<T>): Promise<T>;
+    /**
+     * Create a new organisation owned by the authenticated caller.
+     *
+     * Dispatches `organisation-create-self` on `tee:organisation/contracts`
+     * over the standard authenticated `action.execute` path. The node
+     * injects the caller's DID into the contract call context, and the
+     * contract forces the new organisation's sole initial admin to that
+     * caller — the caller cannot nominate a different admin, and the
+     * organisation is always created as a root. The caller must already be
+     * a registered user, and the call is metered against the caller's own
+     * credits.
+     *
+     * The returned DID is the org identifier the org-data and payroll
+     * surfaces expect (e.g. `OrgDataClient.setGrants({ orgDid, … })`).
+     *
+     * @param name - human-readable organisation name (1..=128 bytes)
+     * @returns the new organisation's DID (`did:t3n:<40-hex>`)
+     * @throws if the session is not authenticated, or if the contract
+     *   refuses (e.g. the caller is not a registered user, or the name is
+     *   empty / too long)
+     */
+    createOrganisation(name: string): Promise<Did>;
     /**
      * Build the canonical `ExecuteActionRequest` shape the server
      * expects (`script_name`, `script_version`, `function_name`, `input`,