@wtfalch/files 0.8.0 → 0.9.1

package/README.md

@@ -4,6 +4,10 @@ Public client SDK and API types for the Files service. Requires Node 22+ or a
 browser with Fetch and AbortSignal.timeout support. The client has no runtime
 package dependencies.
 
+## Status
+
+Published: yes, v0.9.1, 2026-09-28.
+
 ```sh
 npm install @wtfalch/files
 ```
@@ -344,6 +348,10 @@ for, so a reader falls back to the id.
 host; use `updateOrganisationCeiling()` to change them. Byte and money totals
 remain decimal strings, including values above JavaScript's safe integer range.
 
+Pass `name` and `owner` (a subject id) to onboard Agora for a new organisation.
+The 201 result then carries `agoraKey: { id, secret }` once. Store the secret at
+once: a repeat call returns 200 without it.
+
 For the operator application's existing transport, compose the SDK on the server:
 
 ```ts

package/dist/types.d.ts

@@ -206,7 +206,8 @@ export interface OrganisationShare {
     expiresAt: string | null;
     createdAt: string;
 }
-/** Operator management contracts (ADR 0021 signed requests only). A GB-day
+/** Operator management contracts (app-template ADR 0021 signed requests
+ * only). A GB-day
  * rate is a small price and travels as a JSON number; ceilings, usage and
  * spend are cumulative totals and travel as bigint-safe strings, `null`
  * meaning uncapped. */
@@ -254,10 +255,19 @@ export interface ProvisionOrganisationInput {
     ceilingMicros: string | null;
     /** Omitted or `null`: provisioned with no share domain. */
     shareHost?: string | null;
+    /** With `owner`: onboards Agora for the new organisation. */
+    name?: string;
+    /** Subject id of the organisation's first, permanent owner. */
+    owner?: string;
 }
 export interface ProvisionOrganisationResult extends OrganisationSummary {
     /** False when already provisioned: existing ceilings and share host were retained. */
     created: boolean;
+    /** Agora's service key, returned once on a 201 that passed `name` and `owner`. */
+    agoraKey?: {
+        id: string;
+        secret: string;
+    };
 }
 export interface UpdateOrganisationCeilingInput {
     ceilingBytes?: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wtfalch/files",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "type": "module",
   "license": "MIT",
   "description": "Public client SDK and API types for the Files service.",