@v3finance/core-sdk 0.1.0 → 0.2.1

package/dist/cjs/resources/counterparties.js

@@ -50,6 +50,14 @@ class CounterpartiesResource {
         const res = await this.#http.requestRaw('POST', `${this.#base}/${(0, http_js_1.seg)(counterpartyId)}/addresses`, { body: input });
         return (0, gated_js_1.toGated)(res.status, res.data);
     }
+    /**
+     * Narrows any allow-list built on this counterparty, so it is gated like
+     * the rest — under the `counterparty_update` policy, not one of its own.
+     *
+     * Operations already attributed to this address KEEP the counterparty: at
+     * the time they happened the address did belong to it, and that is a
+     * historical fact. Only new operations stop matching.
+     */
     async removeAddress(counterpartyId, addressId) {
         const res = await this.#http.requestRaw('DELETE', `${this.#base}/${(0, http_js_1.seg)(counterpartyId)}/addresses/${(0, http_js_1.seg)(addressId)}`);
         return (0, gated_js_1.toGated)(res.status, res.data);
@@ -92,12 +100,21 @@ class CounterpartyGroupsResource {
         });
         return (0, gated_js_1.toGated)(res.status, res.data);
     }
+    /**
+     * WIDENS any allow-list built on this group, and does so the moment it
+     * applies — which is why it is gated by its own policy
+     * (`counterparty_group_add`) rather than riding on the group's update.
+     */
     async addMember(groupId, counterpartyId) {
         const res = await this.#http.requestRaw('POST', `${this.#base}/${(0, http_js_1.seg)(groupId)}/members`, {
             body: { counterpartyId },
         });
         return (0, gated_js_1.toGated)(res.status, res.data);
     }
+    /**
+     * Payments to this counterparty under the group's allow-list stop at once.
+     * `removed: false` means it was not in the group — not a failure.
+     */
     async removeMember(groupId, counterpartyId) {
         const res = await this.#http.requestRaw('DELETE', `${this.#base}/${(0, http_js_1.seg)(groupId)}/members/${(0, http_js_1.seg)(counterpartyId)}`);
         return (0, gated_js_1.toGated)(res.status, res.data);

package/dist/cjs/resources/counterparties.js.map

@@ -1 +1 @@
-{"version":3,"file":"counterparties.js","sourceRoot":"","sources":["../../../src/resources/counterparties.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"counterparties.js","sourceRoot":"","sources":["../../../src/resources/counterparties.ts"],"names":[],"mappings":"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"}

package/dist/cjs/resources/folders.d.ts

@@ -1,5 +1,5 @@
 import { type HttpClient } from '../core/http.js';
-import type { AddFolderAddressBody, AddressGroup, AddressGroupDetail, AddressGroupsList, CreateAddressGroupBody, GrantGroupBody, ParticipantsResponse, PatchAddressGroupBody, PatchGroupGrantBody } from '../generated/types.js';
+import type { AddFolderAddressBody, AddressAccessGrant, AddressGroup, AddressGroupDetail, AddressGroupsList, AddressSharesList, CreateAddressGroupBody, GrantGroupBody, ParticipantsResponse, PatchAddressGroupBody, PatchGroupGrantBody, ShareGrantCreated } from '../generated/types.js';
 /**
  * Address folders.
  *
@@ -31,15 +31,56 @@ export declare class FoldersResource {
     create(input: CreateAddressGroupBody): Promise<AddressGroup>;
     /** Also where `orderIndex` is set — there is no separate reorder endpoint. */
     update(folderId: string, input: PatchAddressGroupBody): Promise<AddressGroup>;
-    delete(folderId: string): Promise<unknown>;
-    addAddress(folderId: string, input: AddFolderAddressBody): Promise<unknown>;
-    removeAddress(folderId: string, addressId: string): Promise<unknown>;
-    /** Grants on the folder itself — everything in it becomes reachable. */
-    grants(folderId: string): Promise<unknown>;
-    /** Idempotent, and accepts several subjects at once. Check each result. */
-    grant(folderId: string, input: GrantGroupBody): Promise<unknown>;
-    updateGrant(folderId: string, grantId: string, input: PatchGroupGrantBody): Promise<unknown>;
-    revokeGrant(folderId: string, grantId: string): Promise<unknown>;
+    /** Deleting takes the membership rows with it, and the grants on the folder. */
+    delete(folderId: string): Promise<{
+        deleted: boolean;
+    }>;
+    addAddress(folderId: string, input: AddFolderAddressBody): Promise<{
+        added: boolean;
+    }>;
+    /**
+     * Taking an address out ends access that came FROM THE FOLDER. Grants on
+     * the address itself are untouched — they are a separate relationship.
+     */
+    removeAddress(folderId: string, addressId: string): Promise<{
+        removed: boolean;
+    }>;
+    /**
+     * Grants on the folder itself — everything in it becomes reachable,
+     * including addresses added later.
+     *
+     * The same shape as the grants on a single address, and each entry carries
+     * `role`: do not rebuild it from the flags on the client, or you end up
+     * with a second translation that diverges from the first on the next right
+     * that is added.
+     *
+     * Owners of the addresses inside are NOT listed — their access comes from
+     * ownership, not from a grant. For people rather than grants, ask
+     * `participants()`.
+     */
+    grants(folderId: string): Promise<AddressSharesList>;
+    /**
+     * Idempotent: repeating it for the same pair updates the rights and revives
+     * a revoked grant — no 409 to catch, no read-then-PATCH dance.
+     *
+     * With `subjects[]` it answers a batch (`results[]`, one entry per subject,
+     * each independent); with a single subject it answers the grant itself,
+     * hence the union. The all-failed case behaves as it does on
+     * `sharing.share` — 400 carrying the same `results[]` body
+     * (`ShareBatchAllRejected`), which the SDK surfaces as a `CoreError` with
+     * the body in `details`.
+     */
+    grant(folderId: string, input: GrantGroupBody): Promise<ShareGrantCreated>;
+    /**
+     * `role` sets view and transfer together; the individual flags are the
+     * older way in. `canCreateAddress` is not part of either role and is
+     * changed on its own.
+     */
+    updateGrant(folderId: string, grantId: string, input: PatchGroupGrantBody): Promise<AddressAccessGrant>;
+    /** Soft: the row stays as `revoked` for the audit trail. Effective at once. */
+    revokeGrant(folderId: string, grantId: string): Promise<{
+        revoked: boolean;
+    }>;
     /** People who reach the folder, with the source of each person's access. */
     participants(folderId: string): Promise<ParticipantsResponse>;
 }

package/dist/cjs/resources/folders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../../src/resources/folders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,uBAAuB,CAAA;AAE9B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,eAAe;;IAI1B,YAAY,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAG9C;IAED,IAAI,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAEjC;IAED,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAEjD;IAED,mDAAmD;IACnD,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAE3D;IAED,8EAA8E;IAC9E,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CAI5E;IAED,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEzC;IAED,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1E;IAED,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKnE;IAED,wEAAwE;IACxE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEzC;IAED,2EAA2E;IAC3E,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/D;IAED,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAI3F;IAED,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/D;IAED,4EAA4E;IAC5E,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAK5D;CACF"}
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../../src/resources/folders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,uBAAuB,CAAA;AAE9B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,eAAe;;IAI1B,YAAY,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAG9C;IAED,IAAI,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAEjC;IAED,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAEjD;IAED,mDAAmD;IACnD,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAE3D;IAED,8EAA8E;IAC9E,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CAI5E;IAED,gFAAgF;IAChF,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAEtD;IAED,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAMrF;IAED;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAKhF;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAKnD;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAMzE;IAED;;;;OAIG;IACH,WAAW,CACT,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAM7B;IAED,+EAA+E;IAC/E,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAK5E;IAED,4EAA4E;IAC5E,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAK5D;CACF"}

package/dist/cjs/resources/folders.js

@@ -47,28 +47,59 @@ class FoldersResource {
             body: input,
         });
     }
+    /** Deleting takes the membership rows with it, and the grants on the folder. */
     delete(folderId) {
         return this.#http.request('DELETE', `${this.#base}/${(0, http_js_1.seg)(folderId)}`);
     }
     addAddress(folderId, input) {
         return this.#http.request('POST', `${this.#base}/${(0, http_js_1.seg)(folderId)}/members`, { body: input });
     }
+    /**
+     * Taking an address out ends access that came FROM THE FOLDER. Grants on
+     * the address itself are untouched — they are a separate relationship.
+     */
     removeAddress(folderId, addressId) {
         return this.#http.request('DELETE', `${this.#base}/${(0, http_js_1.seg)(folderId)}/members/${(0, http_js_1.seg)(addressId)}`);
     }
-    /** Grants on the folder itself — everything in it becomes reachable. */
+    /**
+     * Grants on the folder itself — everything in it becomes reachable,
+     * including addresses added later.
+     *
+     * The same shape as the grants on a single address, and each entry carries
+     * `role`: do not rebuild it from the flags on the client, or you end up
+     * with a second translation that diverges from the first on the next right
+     * that is added.
+     *
+     * Owners of the addresses inside are NOT listed — their access comes from
+     * ownership, not from a grant. For people rather than grants, ask
+     * `participants()`.
+     */
     grants(folderId) {
         return this.#http.request('GET', `${this.#base}/${(0, http_js_1.seg)(folderId)}/grants`);
     }
-    /** Idempotent, and accepts several subjects at once. Check each result. */
+    /**
+     * Idempotent: repeating it for the same pair updates the rights and revives
+     * a revoked grant — no 409 to catch, no read-then-PATCH dance.
+     *
+     * With `subjects[]` it answers a batch (`results[]`, one entry per subject,
+     * each independent); with a single subject it answers the grant itself,
+     * hence the union. The all-failed case behaves as it does on
+     * `sharing.share` — 400 carrying the same `results[]` body
+     * (`ShareBatchAllRejected`), which the SDK surfaces as a `CoreError` with
+     * the body in `details`.
+     */
     grant(folderId, input) {
         return this.#http.request('POST', `${this.#base}/${(0, http_js_1.seg)(folderId)}/grants`, { body: input });
     }
+    /**
+     * `role` sets view and transfer together; the individual flags are the
+     * older way in. `canCreateAddress` is not part of either role and is
+     * changed on its own.
+     */
     updateGrant(folderId, grantId, input) {
-        return this.#http.request('PATCH', `${this.#base}/${(0, http_js_1.seg)(folderId)}/grants/${(0, http_js_1.seg)(grantId)}`, {
-            body: input,
-        });
+        return this.#http.request('PATCH', `${this.#base}/${(0, http_js_1.seg)(folderId)}/grants/${(0, http_js_1.seg)(grantId)}`, { body: input });
     }
+    /** Soft: the row stays as `revoked` for the audit trail. Effective at once. */
     revokeGrant(folderId, grantId) {
         return this.#http.request('DELETE', `${this.#base}/${(0, http_js_1.seg)(folderId)}/grants/${(0, http_js_1.seg)(grantId)}`);
     }

package/dist/cjs/resources/folders.js.map

@@ -1 +1 @@
-{"version":3,"file":"folders.js","sourceRoot":"","sources":["../../../src/resources/folders.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"folders.js","sourceRoot":"","sources":["../../../src/resources/folders.ts"],"names":[],"mappings":"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"}

package/dist/cjs/resources/history.d.ts

@@ -8,9 +8,26 @@ import type { HistoryItem } from '../generated/types.js';
  * Splitting them would force "show everything" to be stitched together on the
  * client from two cursors.
  */
+/**
+ * The statuses the feed can be FILTERED by.
+ *
+ * One value short of `TransactionStatus`, which is the right set for reading
+ * a transfer: `submitted` is missing here. It is a legacy status — still the
+ * column default in the schema, so old rows carry it — and the endpoint's
+ * enum does not accept it, so filtering by it is a 400 rather than an empty
+ * page. Hence a separate type: taking the reader's union would have the
+ * package suggest a value its own filter rejects.
+ */
+export type HistoryStatusFilter = 'awaiting_approval' | 'pending' | 'confirmed' | 'failed' | 'rejected' | 'cancelled';
 export interface HistoryParams extends PageParams {
     direction?: 'in' | 'out' | undefined;
-    status?: string | undefined;
+    /**
+     * Outgoing only, whichever value you pass: a status belongs to a transfer,
+     * so setting this EXCLUDES the incoming side of the feed even without
+     * `direction: 'out'`. The same goes for `awaitingMyApproval` and
+     * `decisionPolicyId`.
+     */
+    status?: HistoryStatusFilter | undefined;
     /** Only what awaits MY signature. For the approvals screen. */
     awaitingMyApproval?: boolean | undefined;
     asset?: string | undefined;
@@ -21,7 +38,8 @@ export interface HistoryParams extends PageParams {
     counterpartyId?: string | undefined;
     counterpartyGroupId?: string | undefined;
     counterpartyAddressId?: string | undefined;
-    flowType?: string | undefined;
+    /** `internal` — the other side is an address of this vault; `external` — it is not. */
+    flowType?: 'internal' | 'external' | undefined;
     category?: string | undefined;
     paymentPurpose?: string | undefined;
     decisionPolicyId?: string | undefined;

package/dist/cjs/resources/history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../src/resources/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD;;;;;;GAMG;AAEH,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,SAAS,CAAA;IACpC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACxC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,uEAAuE;IACvE,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACnC,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5B;AAED,qBAAa,eAAe;;IAI1B,YAAY,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAG9C;IAED,IAAI,CAAC,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAE3D;CACF"}
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../src/resources/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD;;;;;;GAMG;AAEH;;;;;;;;;GASG;AACH,MAAM,MAAM,mBAAmB,GAC3B,mBAAmB,GACnB,SAAS,GACT,WAAW,GACX,QAAQ,GACR,UAAU,GACV,WAAW,CAAA;AAEf,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,SAAS,CAAA;IACpC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAA;IACxC,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACxC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1C,uFAAuF;IACvF,QAAQ,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAA;IAC9C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,uEAAuE;IACvE,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACnC,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5B;AAED,qBAAa,eAAe;;IAI1B,YAAY,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAG9C;IAED,IAAI,CAAC,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAE3D;CACF"}

package/dist/cjs/resources/history.js.map

@@ -1 +1 @@
-{"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/resources/history.ts"],"names":[],"mappings":";;;AAAA,6CAAsD;AAsCtD;IACW,KAAK,CAAY;IACjB,KAAK,CAAQ;IAEtB,YAAY,IAAgB,EAAE,SAAiB;QAC7C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,IAAI,CAAC,KAAK,GAAG,kBAAkB,IAAA,aAAG,EAAC,SAAS,CAAC,UAAU,CAAA;IACzD,CAAC;IAED,IAAI,CAAC,MAAM,GAAkB,EAAE;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,CAAA;IAC3F,CAAC;CACF"}
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/resources/history.ts"],"names":[],"mappings":";;;AAAA,6CAAsD;AA+DtD;IACW,KAAK,CAAY;IACjB,KAAK,CAAQ;IAEtB,YAAY,IAAgB,EAAE,SAAiB;QAC7C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,IAAI,CAAC,KAAK,GAAG,kBAAkB,IAAA,aAAG,EAAC,SAAS,CAAC,UAAU,CAAA;IACzD,CAAC;IAED,IAAI,CAAC,MAAM,GAAkB,EAAE;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,CAAA;IAC3F,CAAC;CACF"}

package/dist/cjs/resources/me.d.ts

@@ -1,10 +1,18 @@
 import type { HttpClient } from '../core/http.js';
-import type { AllowedSegmentsResponse, PatchProfileBody, PushToken, RegisterPushTokenBody, UserProfile } from '../generated/types.js';
+import type { AllowedSegmentsResponse, MeVaultResponse, PatchProfileBody, PushToken, RegisterPushTokenBody, UserProfile } from '../generated/types.js';
 /** The caller's own profile, devices and permissions. Not scoped to a vault. */
 export declare class MeResource {
     #private;
     constructor(http: HttpClient);
     profile(): Promise<UserProfile>;
+    /**
+     * Partial update of your own profile: `name`, `username`, `image`, `color`,
+     * `emoji`. `null` clears a field (except `name`). `username` is unique
+     * across the whole platform — taken answers 409 `USERNAME_TAKEN`.
+     *
+     * Answers with the full profile, the same shape `profile()` returns —
+     * `needsEmail` included, so there is no need to re-read it after an update.
+     */
     updateProfile(input: PatchProfileBody): Promise<UserProfile>;
     /**
      * Binds a real email to an account created from an invitation link.
@@ -17,8 +25,20 @@ export declare class MeResource {
     bindEmail(email: string): Promise<{
         email: string;
     }>;
-    /** The vault the caller belongs to — where most screens start. */
-    vault(): Promise<unknown>;
+    /**
+     * The vault the caller belongs to — where most screens start. Carries the
+     * derivation-path structure (`routes`, enabled variants only), which is
+     * what an address-creation form is built from.
+     *
+     * ONE vault, even if there are several memberships: the first one found is
+     * returned. Membership is a `VaultMembership`, not "has at least one policy
+     * group", so somebody with no groups still gets their vault here — they can
+     * open the application and will simply be refused every action.
+     *
+     * No membership anywhere answers 404, which is a legitimate state for a
+     * brand-new account rather than an error to report as a fault.
+     */
+    vault(): Promise<MeVaultResponse>;
     /**
      * Derivation-path segments this person may use for a given action.
      *
@@ -32,6 +52,9 @@ export declare class MeResource {
         action: string;
     }): Promise<AllowedSegmentsResponse>;
     registerPushToken(input: RegisterPushTokenBody): Promise<PushToken>;
-    removePushToken(token: string): Promise<unknown>;
+    /** `deleted: false` simply means the token was not registered — not a failure. */
+    removePushToken(token: string): Promise<{
+        deleted: boolean;
+    }>;
 }
 //# sourceMappingURL=me.d.ts.map

package/dist/cjs/resources/me.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"me.d.ts","sourceRoot":"","sources":["../../../src/resources/me.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EAChB,SAAS,EACT,qBAAqB,EACrB,WAAW,EACZ,MAAM,uBAAuB,CAAA;AAE9B,gFAAgF;AAChF,qBAAa,UAAU;;IAGrB,YAAY,IAAI,EAAE,UAAU,EAE3B;IAED,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,CAE9B;IAED,aAAa,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAE3D;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAInD;IAED,kEAAkE;IAClE,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAExB;IAED;;;;;;;OAOG;IACH,eAAe,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAI7F;IAED,iBAAiB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CAElE;IAED,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/C;CACF"}
+{"version":3,"file":"me.d.ts","sourceRoot":"","sources":["../../../src/resources/me.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EACV,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,qBAAqB,EACrB,WAAW,EACZ,MAAM,uBAAuB,CAAA;AAE9B,gFAAgF;AAChF,qBAAa,UAAU;;IAGrB,YAAY,IAAI,EAAE,UAAU,EAE3B;IAED,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,CAE9B;IAED;;;;;;;OAOG;IACH,aAAa,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAE3D;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAInD;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,IAAI,OAAO,CAAC,eAAe,CAAC,CAEhC;IAED;;;;;;;OAOG;IACH,eAAe,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAI7F;IAED,iBAAiB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CAElE;IAED,kFAAkF;IAClF,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAK5D;CACF"}

package/dist/cjs/resources/me.js

@@ -10,6 +10,14 @@ class MeResource {
     profile() {
         return this.#http.request('GET', '/api/v1/me/profile');
     }
+    /**
+     * Partial update of your own profile: `name`, `username`, `image`, `color`,
+     * `emoji`. `null` clears a field (except `name`). `username` is unique
+     * across the whole platform — taken answers 409 `USERNAME_TAKEN`.
+     *
+     * Answers with the full profile, the same shape `profile()` returns —
+     * `needsEmail` included, so there is no need to re-read it after an update.
+     */
     updateProfile(input) {
         return this.#http.request('PATCH', '/api/v1/me/profile', { body: input });
     }
@@ -26,7 +34,19 @@ class MeResource {
             body: { email },
         });
     }
-    /** The vault the caller belongs to — where most screens start. */
+    /**
+     * The vault the caller belongs to — where most screens start. Carries the
+     * derivation-path structure (`routes`, enabled variants only), which is
+     * what an address-creation form is built from.
+     *
+     * ONE vault, even if there are several memberships: the first one found is
+     * returned. Membership is a `VaultMembership`, not "has at least one policy
+     * group", so somebody with no groups still gets their vault here — they can
+     * open the application and will simply be refused every action.
+     *
+     * No membership anywhere answers 404, which is a legitimate state for a
+     * brand-new account rather than an error to report as a fault.
+     */
     vault() {
         return this.#http.request('GET', '/api/v1/me/vault');
     }
@@ -46,6 +66,7 @@ class MeResource {
     registerPushToken(input) {
         return this.#http.request('POST', '/api/v1/me/push-tokens', { body: input });
     }
+    /** `deleted: false` simply means the token was not registered — not a failure. */
     removePushToken(token) {
         return this.#http.request('DELETE', `/api/v1/me/push-tokens/${encodeURIComponent(token)}`);
     }

package/dist/cjs/resources/me.js.map

@@ -1 +1 @@
-{"version":3,"file":"me.js","sourceRoot":"","sources":["../../../src/resources/me.ts"],"names":[],"mappings":";;;AASA,gFAAgF;AAChF;IACW,KAAK,CAAY;IAE1B,YAAY,IAAgB;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;IACnB,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,KAAK,EAAE,oBAAoB,CAAC,CAAA;IACrE,CAAC;IAED,aAAa,CAAC,KAAuB;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,OAAO,EAAE,oBAAoB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACxF,CAAC;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,KAAa;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,MAAM,EAAE,0BAA0B,EAAE;YAC/E,IAAI,EAAE,EAAE,KAAK,EAAE;SAChB,CAAC,CAAA;IACJ,CAAC;IAED,kEAAkE;IAClE,KAAK;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAA;IACtD,CAAC;IAED;;;;;;;OAOG;IACH,eAAe,CAAC,MAA2C;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAA0B,KAAK,EAAE,6BAA6B,EAAE;YACvF,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE;SACrB,CAAC,CAAA;IACJ,CAAC;IAED,iBAAiB,CAAC,KAA4B;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,MAAM,EAAE,wBAAwB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACzF,CAAC;IAED,eAAe,CAAC,KAAa;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,0BAA0B,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC5F,CAAC;CACF"}
+{"version":3,"file":"me.js","sourceRoot":"","sources":["../../../src/resources/me.ts"],"names":[],"mappings":";;;AAUA,gFAAgF;AAChF;IACW,KAAK,CAAY;IAE1B,YAAY,IAAgB;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;IACnB,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,KAAK,EAAE,oBAAoB,CAAC,CAAA;IACrE,CAAC;IAED;;;;;;;OAOG;IACH,aAAa,CAAC,KAAuB;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,OAAO,EAAE,oBAAoB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACxF,CAAC;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,KAAa;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,MAAM,EAAE,0BAA0B,EAAE;YAC/E,IAAI,EAAE,EAAE,KAAK,EAAE;SAChB,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAkB,KAAK,EAAE,kBAAkB,CAAC,CAAA;IACvE,CAAC;IAED;;;;;;;OAOG;IACH,eAAe,CAAC,MAA2C;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAA0B,KAAK,EAAE,6BAA6B,EAAE;YACvF,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE;SACrB,CAAC,CAAA;IACJ,CAAC;IAED,iBAAiB,CAAC,KAA4B;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,MAAM,EAAE,wBAAwB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACzF,CAAC;IAED,kFAAkF;IAClF,eAAe,CAAC,KAAa;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CACvB,QAAQ,EACR,0BAA0B,kBAAkB,CAAC,KAAK,CAAC,EAAE,CACtD,CAAA;IACH,CAAC;CACF"}

package/dist/cjs/resources/members.d.ts

@@ -1,6 +1,6 @@
 import { type HttpClient } from '../core/http.js';
 import type { PageParams } from '../core/pagination.js';
-import type { MemberDetail, MembersPage, UserGroupDetail, UserGroupMembers } from '../generated/types.js';
+import type { MemberCard, MemberDetail, MembersPage, UserGroup, UserGroupDetail, UserGroupMembers } from '../generated/types.js';
 /**
  * People in the vault, and the groups they belong to.
  *
@@ -22,10 +22,25 @@ export declare class MembersResource {
      * By username only — an email address will not resolve. This is the step
      * before granting access to someone: you need their id, and you can only
      * resolve people you are allowed to see.
+     *
+     * A person you cannot see answers 404, the same as one who does not exist.
+     * That is deliberate: a distinguishable answer would let anyone probe which
+     * usernames are taken. So a 404 here means "no such visible member", and
+     * the fix may be a visibility grant rather than a different spelling.
+     */
+    resolve(username: string): Promise<MemberCard>;
+    /**
+     * Policy groups as a member sees them: id, name, icon and `memberCount`
+     * only — enough to pick one as the subject of a grant. `search` matches the
+     * name.
+     *
+     * No cursor: the whole list comes back at once.
      */
-    resolve(username: string): Promise<unknown>;
-    /** Policy groups as a member sees them. */
-    groups(): Promise<unknown>;
+    groups(params?: {
+        search?: string | undefined;
+    }): Promise<{
+        items: UserGroup[];
+    }>;
     /**
      * Group detail. Deliberately includes a read-only summary of the group's
      * policies — code, name, action and effect, but no rules or thresholds.

package/dist/cjs/resources/members.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"members.d.ts","sourceRoot":"","sources":["../../../src/resources/members.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,gBAAgB,EACjB,MAAM,uBAAuB,CAAA;AAE9B;;;;;;;GAOG;AACH,qBAAa,eAAe;;IAI1B,YAAY,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAG9C;IAED,IAAI,CAAC,MAAM,GAAE,UAAU,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAIxE;IAED,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAKzC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI1C;IAED,2CAA2C;IAC3C,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAEzB;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAK/C;IAED,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAKvD;CACF"}
+{"version":3,"file":"members.d.ts","sourceRoot":"","sources":["../../../src/resources/members.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,eAAe,EACf,gBAAgB,EACjB,MAAM,uBAAuB,CAAA;AAE9B;;;;;;;GAOG;AACH,qBAAa,eAAe;;IAI1B,YAAY,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAG9C;IAED,IAAI,CAAC,MAAM,GAAE,UAAU,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAIxE;IAED,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAKzC;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAM7C;IAED;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAO,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC,CAMpF;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAK/C;IAED,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAKvD;CACF"}

package/dist/cjs/resources/members.js

@@ -31,15 +31,24 @@ class MembersResource {
      * By username only — an email address will not resolve. This is the step
      * before granting access to someone: you need their id, and you can only
      * resolve people you are allowed to see.
+     *
+     * A person you cannot see answers 404, the same as one who does not exist.
+     * That is deliberate: a distinguishable answer would let anyone probe which
+     * usernames are taken. So a 404 here means "no such visible member", and
+     * the fix may be a visibility grant rather than a different spelling.
      */
     resolve(username) {
-        return this.#http.request('GET', `/api/v1/vaults/${this.#vault}/members/resolve`, {
-            query: { username },
-        });
+        return this.#http.request('GET', `/api/v1/vaults/${this.#vault}/members/resolve`, { query: { username } });
     }
-    /** Policy groups as a member sees them. */
-    groups() {
-        return this.#http.request('GET', `/api/v1/vaults/${this.#vault}/user-groups`);
+    /**
+     * Policy groups as a member sees them: id, name, icon and `memberCount`
+     * only — enough to pick one as the subject of a grant. `search` matches the
+     * name.
+     *
+     * No cursor: the whole list comes back at once.
+     */
+    groups(params = {}) {
+        return this.#http.request('GET', `/api/v1/vaults/${this.#vault}/user-groups`, { query: { ...params } });
     }
     /**
      * Group detail. Deliberately includes a read-only summary of the group's

package/dist/cjs/resources/members.js.map

@@ -1 +1 @@
-{"version":3,"file":"members.js","sourceRoot":"","sources":["../../../src/resources/members.ts"],"names":[],"mappings":";;;AAAA,6CAAsD;AAStD;;;;;;;GAOG;AACH;IACW,KAAK,CAAY;IACjB,MAAM,CAAQ;IAEvB,YAAY,IAAgB,EAAE,SAAiB;QAC7C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,IAAI,CAAC,MAAM,GAAG,IAAA,aAAG,EAAC,SAAS,CAAC,CAAA;IAC9B,CAAC;IAED,IAAI,CAAC,MAAM,GAAqC,EAAE;QAChD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,KAAK,EAAE,kBAAkB,IAAI,CAAC,MAAM,UAAU,EAAE;YACrF,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE;SACrB,CAAC,CAAA;IACJ,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CACvB,KAAK,EACL,kBAAkB,IAAI,CAAC,MAAM,YAAY,IAAA,aAAG,EAAC,MAAM,CAAC,EAAE,CACvD,CAAA;IACH,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,QAAgB;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,IAAI,CAAC,MAAM,kBAAkB,EAAE;YAChF,KAAK,EAAE,EAAE,QAAQ,EAAE;SACpB,CAAC,CAAA;IACJ,CAAC;IAED,2CAA2C;IAC3C,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,IAAI,CAAC,MAAM,cAAc,CAAC,CAAA;IAC/E,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAe;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CACvB,KAAK,EACL,kBAAkB,IAAI,CAAC,MAAM,gBAAgB,IAAA,aAAG,EAAC,OAAO,CAAC,EAAE,CAC5D,CAAA;IACH,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CACvB,KAAK,EACL,kBAAkB,IAAI,CAAC,MAAM,gBAAgB,IAAA,aAAG,EAAC,OAAO,CAAC,UAAU,CACpE,CAAA;IACH,CAAC;CACF"}
+{"version":3,"file":"members.js","sourceRoot":"","sources":["../../../src/resources/members.ts"],"names":[],"mappings":";;;AAAA,6CAAsD;AAWtD;;;;;;;GAOG;AACH;IACW,KAAK,CAAY;IACjB,MAAM,CAAQ;IAEvB,YAAY,IAAgB,EAAE,SAAiB;QAC7C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,IAAI,CAAC,MAAM,GAAG,IAAA,aAAG,EAAC,SAAS,CAAC,CAAA;IAC9B,CAAC;IAED,IAAI,CAAC,MAAM,GAAqC,EAAE;QAChD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,KAAK,EAAE,kBAAkB,IAAI,CAAC,MAAM,UAAU,EAAE;YACrF,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE;SACrB,CAAC,CAAA;IACJ,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CACvB,KAAK,EACL,kBAAkB,IAAI,CAAC,MAAM,YAAY,IAAA,aAAG,EAAC,MAAM,CAAC,EAAE,CACvD,CAAA;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,QAAgB;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CACvB,KAAK,EACL,kBAAkB,IAAI,CAAC,MAAM,kBAAkB,EAC/C,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,CACxB,CAAA;IACH,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,GAAoC,EAAE;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CACvB,KAAK,EACL,kBAAkB,IAAI,CAAC,MAAM,cAAc,EAC3C,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CACzB,CAAA;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAe;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CACvB,KAAK,EACL,kBAAkB,IAAI,CAAC,MAAM,gBAAgB,IAAA,aAAG,EAAC,OAAO,CAAC,EAAE,CAC5D,CAAA;IACH,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CACvB,KAAK,EACL,kBAAkB,IAAI,CAAC,MAAM,gBAAgB,IAAA,aAAG,EAAC,OAAO,CAAC,UAAU,CACpE,CAAA;IACH,CAAC;CACF"}

package/dist/cjs/resources/operations.d.ts

@@ -1,8 +1,31 @@
 import { type HttpClient } from '../core/http.js';
 import type { PageParams } from '../core/pagination.js';
-import type { ApprovalRelations, CreateOperationRelationBody, OperationMetadata, OperationRelation, OperationRelationsPage, PatchOperationMetadataBody } from '../generated/types.js';
-/** Operation kind in a path: `transfer`, `deposit`, … */
-export type OperationKind = string;
+import type { ApprovalRelations, CreateOperationRelationBody, IncomingTransactionDetail, OperationMetadata, OperationRelation, OperationRelationsPage, OperationType, PatchOperationMetadataBody } from '../generated/types.js';
+/**
+ * Operation kind in a path. Exactly two values exist.
+ *
+ * The document has no schema of this name, so nothing was being shadowed —
+ * but `= string` was still wider than the contract, and the endpoints below
+ * answer 400 to anything but these two. Kept as a name of its own rather than
+ * dropped, because it is exported from the package root; it is now the same
+ * type as `OperationType`, which the relation records themselves carry, so
+ * the two can be mixed freely.
+ */
+export type OperationKind = OperationType;
+export interface ListRelationsParams extends PageParams {
+    relationType?: 'refund' | 'reversal' | 'correction' | 'replacement' | undefined;
+    sourceOperationId?: string | undefined;
+    targetOperationId?: string | undefined;
+    /** Links that carry a partial amount in this token. */
+    tokenId?: string | undefined;
+    /**
+     * Window over when the LINK was recorded, not over the operations it joins.
+     * Half-open: `from` is inclusive, `to` exclusive, so consecutive days can
+     * be paged without double-counting the boundary.
+     */
+    from?: string | undefined;
+    to?: string | undefined;
+}
 /**
  * Everything hanging off a single operation: free-form metadata, links to
  * other operations, and how its status changed over time.
@@ -27,13 +50,46 @@ export declare class OperationsResource {
      * How the operation's status changed, with timestamps. For a transfer this
      * is the honest record of the path through approval, reservation and
      * settlement — useful when "why is it still pending" needs an answer.
+     *
+     * Ordered oldest first. Operations that predate this log have a single
+     * baseline row, so one entry does not mean only one transition happened.
+     * `changedById` is `null` where no person made the move — the wallet
+     * webhook crediting a deposit, a confirmed broadcast, reconciliation by
+     * hash — so do not render it as an unknown user. Read `reason` instead; it
+     * carries the machine code (`webhook_topup`, `broadcast_confirmed`,
+     * `approval_threshold_reached`, …). The row has no schema name of its own
+     * in the document, which is why it is spelled out here.
      */
-    statusHistory(kind: OperationKind, operationId: string): Promise<unknown>;
-    /** All links in the vault. */
-    listRelations(params?: PageParams): Promise<OperationRelationsPage>;
+    statusHistory(kind: OperationKind, operationId: string): Promise<{
+        items: Array<{
+            id: string;
+            fromStatus: string | null;
+            toStatus: string;
+            reason: string | null;
+            changedById: string | null;
+            changedAt: string;
+        }>;
+    }>;
+    /**
+     * All links in the vault. Both directions: an operation appears here when
+     * it is the source AND when it is the target, so filtering by
+     * `sourceOperationId` alone will miss half of its links.
+     */
+    listRelations(params?: ListRelationsParams): Promise<OperationRelationsPage>;
     createRelation(input: CreateOperationRelationBody): Promise<OperationRelation>;
-    /** An incoming payment in detail. */
-    deposit(depositId: string): Promise<unknown>;
+    /**
+     * An incoming payment in detail.
+     *
+     * `amlLevel`/`amlScore`/`amlCheckedAt` are a SNAPSHOT of what was known
+     * about the SENDER when the money landed, not the sender's risk today. A
+     * `null` level means nobody checked — not that there is no risk — so it
+     * must not be drawn as a clean result; `/aml/score` answers for the present.
+     *
+     * `amount` is raw smallest units and `amountDecimal` is the same number
+     * scaled by the token's decimals. `usdRate` is the rate at the moment of
+     * the deposit and is `null` when no rate was available.
+     */
+    deposit(depositId: string): Promise<IncomingTransactionDetail>;
     /**
      * Who approves whom in this vault: the people whose requests you sign, and
      * the people who sign yours.

package/dist/cjs/resources/operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../src/resources/operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,0BAA0B,EAC3B,MAAM,uBAAuB,CAAA;AAE9B,yDAAyD;AACzD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAA;AAElC;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;;IAI7B,YAAY,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAG9C;IAMD;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAKpF;IAED,WAAW,CACT,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAM5B;IAED,sEAAsE;IACtE,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAKhF;IAED;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAExE;IAED,8BAA8B;IAC9B,aAAa,CAAC,MAAM,GAAE,UAAe,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAMtE;IAED,cAAc,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAM7E;IAED,qCAAqC;IACrC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE3C;IAED;;;;;;;OAOG;IACH,iBAAiB,CAAC,MAAM,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAM9E;CACF"}
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../src/resources/operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,0BAA0B,EAC3B,MAAM,uBAAuB,CAAA;AAE9B;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,aAAa,CAAA;AAEzC,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACrD,YAAY,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,aAAa,GAAG,SAAS,CAAA;IAC/E,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACxB;AAED;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;;IAI7B,YAAY,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAG9C;IAMD;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAKpF;IAED,WAAW,CACT,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAM5B;IAED,sEAAsE;IACtE,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAKhF;IAED;;;;;;;;;;;;;OAaG;IACH,aAAa,CACX,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QACT,KAAK,EAAE,KAAK,CAAC;YACX,EAAE,EAAE,MAAM,CAAA;YACV,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;YACzB,QAAQ,EAAE,MAAM,CAAA;YAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;YACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;YAC1B,SAAS,EAAE,MAAM,CAAA;SAClB,CAAC,CAAA;KACH,CAAC,CAED;IAED;;;;OAIG;IACH,aAAa,CAAC,MAAM,GAAE,mBAAwB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAM/E;IAED,cAAc,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAM7E;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAK7D;IAED;;;;;;;OAOG;IACH,iBAAiB,CAAC,MAAM,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAM9E;CACF"}

package/dist/cjs/resources/operations.js

@@ -39,18 +39,42 @@ class OperationsResource {
      * How the operation's status changed, with timestamps. For a transfer this
      * is the honest record of the path through approval, reservation and
      * settlement — useful when "why is it still pending" needs an answer.
+     *
+     * Ordered oldest first. Operations that predate this log have a single
+     * baseline row, so one entry does not mean only one transition happened.
+     * `changedById` is `null` where no person made the move — the wallet
+     * webhook crediting a deposit, a confirmed broadcast, reconciliation by
+     * hash — so do not render it as an unknown user. Read `reason` instead; it
+     * carries the machine code (`webhook_topup`, `broadcast_confirmed`,
+     * `approval_threshold_reached`, …). The row has no schema name of its own
+     * in the document, which is why it is spelled out here.
      */
     statusHistory(kind, operationId) {
         return this.#http.request('GET', `${this.#op(kind, operationId)}/status-history`);
     }
-    /** All links in the vault. */
+    /**
+     * All links in the vault. Both directions: an operation appears here when
+     * it is the source AND when it is the target, so filtering by
+     * `sourceOperationId` alone will miss half of its links.
+     */
     listRelations(params = {}) {
         return this.#http.request('GET', `/api/v1/vaults/${this.#vault}/operation-relations`, { query: { ...params } });
     }
     createRelation(input) {
         return this.#http.request('POST', `/api/v1/vaults/${this.#vault}/operation-relations`, { body: input });
     }
-    /** An incoming payment in detail. */
+    /**
+     * An incoming payment in detail.
+     *
+     * `amlLevel`/`amlScore`/`amlCheckedAt` are a SNAPSHOT of what was known
+     * about the SENDER when the money landed, not the sender's risk today. A
+     * `null` level means nobody checked — not that there is no risk — so it
+     * must not be drawn as a clean result; `/aml/score` answers for the present.
+     *
+     * `amount` is raw smallest units and `amountDecimal` is the same number
+     * scaled by the token's decimals. `usdRate` is the rate at the moment of
+     * the deposit and is `null` when no rate was available.
+     */
     deposit(depositId) {
         return this.#http.request('GET', `/api/v1/vaults/${this.#vault}/deposits/${(0, http_js_1.seg)(depositId)}`);
     }