@naturalpay/sdk 0.2.1 → 0.4.0

package/src/resources/parties.ts

@@ -4,13 +4,14 @@ import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
 import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
 
 /**
  * Party and organization management
  */
 export class Parties extends APIResource {
   /**
-   * Update the authenticated caller's party details.
+   * Update your party.
    *
    * @example
    * ```ts
@@ -19,7 +20,7 @@ export class Parties extends APIResource {
    */
   update(params: PartyUpdateParams, options?: RequestOptions): APIPromise<PartyUpdateResponse> {
     const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...body } = params;
-    return this._client.put('/parties/me', {
+    return this._client.patch('/parties/me', {
       body,
       ...options,
       headers: buildHeaders([
@@ -33,7 +34,7 @@ export class Parties extends APIResource {
   }
 
   /**
-   * Retrieve the authenticated caller's party details.
+   * Get your party.
    *
    * @example
    * ```ts
@@ -58,7 +59,7 @@ export class Parties extends APIResource {
   }
 
   /**
-   * List members and pending invitations.
+   * List active members of your party.
    *
    * @example
    * ```ts
@@ -82,6 +83,40 @@ export class Parties extends APIResource {
       ]),
     });
   }
+
+  /**
+   * Remove a user from the party membership.
+   *
+   * @example
+   * ```ts
+   * const response = await client.parties.removeMember(
+   *   'usr_ecc2efdd09bd231a9ad9bd2aada37aa7',
+   *   { 'Idempotency-Key': 'Idempotency-Key' },
+   * );
+   * ```
+   */
+  removeMember(
+    userID: string,
+    params: PartyRemoveMemberParams,
+    options?: RequestOptions,
+  ): APIPromise<PartyRemoveMemberResponse> {
+    const {
+      'Idempotency-Key': idempotencyKey,
+      'X-Agent-ID': xAgentID,
+      'X-Instance-ID': xInstanceID,
+    } = params;
+    return this._client.delete(path`/parties/me/members/${userID}`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          'Idempotency-Key': idempotencyKey,
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
 }
 
 export interface PartyUpdateResponse {
@@ -323,8 +358,7 @@ export interface PartyListMembersResponse {
 export namespace PartyListMembersResponse {
   export interface Data {
     /**
-     * Member id: a user id (usr_xxx), or an invitation id (inv_xxx) for pending
-     * invitations
+     * User id (usr_xxx)
      */
     id: string;
 
@@ -359,16 +393,6 @@ export namespace PartyListMembersResponse {
        */
       firstName: string | null;
 
-      /**
-       * Invitation ID (only for type='invitation')
-       */
-      invitationId: string | null;
-
-      /**
-       * User ID who sent the invitation
-       */
-      invitedBy: string | null;
-
       /**
        * Last name of the user
        */
@@ -389,11 +413,6 @@ export namespace PartyListMembersResponse {
        */
       status: 'ACTIVE' | 'REVOKED' | 'DELETED';
 
-      /**
-       * Whether this is an active member or pending invitation
-       */
-      type: 'member' | 'invitation';
-
       /**
        * When the membership was last updated
        */
@@ -414,6 +433,33 @@ export namespace PartyListMembersResponse {
   }
 }
 
+export interface PartyRemoveMemberResponse {
+  data: PartyRemoveMemberResponse.Data;
+
+  meta: PartyRemoveMemberResponse.Meta;
+}
+
+export namespace PartyRemoveMemberResponse {
+  export interface Data {
+    /**
+     * ID of the removed user
+     */
+    id: string;
+
+    /**
+     * Resource type
+     */
+    type: string;
+  }
+
+  export interface Meta {
+    /**
+     * Indicates the resource was deleted
+     */
+    deleted: true;
+  }
+}
+
 export interface PartyUpdateParams {
   /**
    * Body param: Updated display name. Pass null to clear; empty string is rejected
@@ -421,12 +467,6 @@ export interface PartyUpdateParams {
    */
   displayName?: string | null;
 
-  /**
-   * Body param: Updated party persona: INDIVIDUAL or DEVELOPER. Clearing persona to
-   * null is not supported.
-   */
-  persona?: 'INDIVIDUAL' | 'DEVELOPER';
-
   /**
    * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
    */
@@ -458,12 +498,6 @@ export interface PartyListMembersParams {
    */
   cursor?: string;
 
-  /**
-   * Query param: Include pending invitations alongside active members. Defaults to
-   * false.
-   */
-  includeInvitations?: boolean;
-
   /**
    * Query param: Max items per page
    */
@@ -481,13 +515,34 @@ export interface PartyListMembersParams {
   'X-Instance-ID'?: string;
 }
 
+export interface PartyRemoveMemberParams {
+  /**
+   * Unique key for idempotent request handling. If a request with the same key was
+   * already processed, the original response is returned.
+   */
+  'Idempotency-Key': string;
+
+  /**
+   * Agent ID (agt_xxx) identifying which agent is making the request.
+   */
+  'X-Agent-ID'?: string;
+
+  /**
+   * Required when X-Agent-ID is present. Session or conversation ID for agent
+   * observability.
+   */
+  'X-Instance-ID'?: string;
+}
+
 export declare namespace Parties {
   export {
     type PartyUpdateResponse as PartyUpdateResponse,
     type PartyGetResponse as PartyGetResponse,
     type PartyListMembersResponse as PartyListMembersResponse,
+    type PartyRemoveMemberResponse as PartyRemoveMemberResponse,
     type PartyUpdateParams as PartyUpdateParams,
     type PartyGetParams as PartyGetParams,
     type PartyListMembersParams as PartyListMembersParams,
+    type PartyRemoveMemberParams as PartyRemoveMemberParams,
   };
 }