@augno/sdk 0.7.0 → 0.7.1

package/src/resources/sales/addresses.ts

@@ -13,6 +13,9 @@ export class Addresses extends APIResource {
   /**
    * Returns a paginated list of addresses.
    *
+   * This endpoint requires the permissions: `addresses:read`, `customers:read`,
+   * `suppliers:read`.
+   *
    * @example
    * ```ts
    * const listAddress = await client.sales.addresses.list();
@@ -25,6 +28,9 @@ export class Addresses extends APIResource {
   /**
    * Retrieves an address by ID.
    *
+   * This endpoint requires the permissions: `addresses:read`, `customers:read`,
+   * `suppliers:read`.
+   *
    * @example
    * ```ts
    * const address = await client.sales.addresses.retrieve(
@@ -39,6 +45,9 @@ export class Addresses extends APIResource {
   /**
    * Creates an address.
    *
+   * This endpoint requires the permissions: `addresses:create`, `customers:update`,
+   * `suppliers:update`.
+   *
    * @example
    * ```ts
    * const address = await client.sales.addresses.create({
@@ -61,6 +70,9 @@ export class Addresses extends APIResource {
    * Changing a street, locality, state, postal code, or country field may replace
    * the address's geolocation, so the geolocation `id` in the response can change.
    *
+   * This endpoint requires the permissions: `addresses:update`, `customers:update`,
+   * `suppliers:update`.
+   *
    * @example
    * ```ts
    * const address = await client.sales.addresses.update(
@@ -83,6 +95,9 @@ export class Addresses extends APIResource {
    * Deletion fails if the address is in use as a billing or shipping address on a
    * sales order, invoice, or shipment, or as a default account address.
    *
+   * This endpoint requires the permissions: `addresses:delete`, `customers:update`,
+   * `suppliers:update`.
+   *
    * @example
    * ```ts
    * const address = await client.sales.addresses.delete(
@@ -146,7 +161,7 @@ export interface AddressInput {
   street_line_2?: string;
 
   /**
-   * Address type.
+   * How the address is used.
    *
    * - `standard`: a normal shipping or billing address.
    * - `drop_ship`: an address an order is shipped to directly, typically a third
@@ -233,7 +248,7 @@ export interface UpdateAddressRequest {
   street_line_2?: string | null;
 
   /**
-   * Address type.
+   * How the address is used.
    *
    * - `standard`: a normal shipping or billing address.
    * - `drop_ship`: an address an order is shipped to directly, typically a third
@@ -267,7 +282,7 @@ export interface AddressListParams {
   q?: string;
 
   /**
-   * Filter results to a single address type (`standard` or `drop_ship`).
+   * Filter results to a single address type.
    */
   type?: 'standard' | 'drop_ship';
 }
@@ -319,7 +334,7 @@ export interface AddressCreateParams {
   street_line_2?: string;
 
   /**
-   * Address type.
+   * How the address is used.
    *
    * - `standard`: a normal shipping or billing address.
    * - `drop_ship`: an address an order is shipped to directly, typically a third
@@ -381,7 +396,7 @@ export interface AddressUpdateParams {
   street_line_2?: string | null;
 
   /**
-   * Address type.
+   * How the address is used.
    *
    * - `standard`: a normal shipping or billing address.
    * - `drop_ship`: an address an order is shipped to directly, typically a third

package/src/resources/sales/contacts/actions.ts

@@ -0,0 +1,150 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as BlocksAPI from '../../messaging/blocks';
+import * as APIKeysAPI from '../../auth/api-keys/api-keys';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+/**
+ * Look up the people you do business with.
+ */
+export class Actions extends APIResource {
+  /**
+   * Finds the contacts that match an email address.
+   *
+   * Only people on accounts you have a relationship with are returned — your
+   * customers, your suppliers, or your own account. A match's `relationship` says
+   * how you relate to the account it belongs to. Several accounts can share an
+   * email, so this can return more than one match.
+   *
+   * This endpoint requires the permission: `customers:read`.
+   *
+   * @example
+   * ```ts
+   * const listContactMatch =
+   *   await client.sales.contacts.actions.findByEmail({
+   *     email: 'buyer@acme-co.example',
+   *   });
+   * ```
+   */
+  findByEmail(params: ActionFindByEmailParams, options?: RequestOptions): APIPromise<ListContactMatch> {
+    const { include, relationships, ...body } = params;
+    return this._client.post('/v1/sales/contacts/actions/find-by-email', {
+      query: { include, relationships },
+      body,
+      ...options,
+    });
+  }
+}
+
+/**
+ * A contact found by email on an account you have a relationship with — one of
+ * your customers, your suppliers, or your own account.
+ *
+ * The same email can be a contact on many accounts across the platform; only
+ * accounts you relate to are returned. The matched person is available through
+ * `account_user` (and the shared profile through `account_user.user`), and the
+ * account they belong to through `account`.
+ */
+export interface ContactMatch {
+  /**
+   * Resource ID.
+   *
+   * This is the matched account user's ID, so the same value also appears as
+   * `account_user.id`.
+   */
+  id: string;
+
+  /**
+   * A customer account, including its branding and customer portal sub-resources.
+   */
+  account: APIKeysAPI.Account | null;
+
+  /**
+   * A user's membership in an account, carrying the account-specific status, role,
+   * and department.
+   *
+   * Profile fields (name, email, username, image URL) live on the expandable `user`
+   * sub-resource, which is shared across every account the user belongs to.
+   */
+  account_user: BlocksAPI.AccountUser | null;
+
+  /**
+   * The email address that was matched.
+   */
+  email: string;
+
+  /**
+   * Resource type identifier.
+   */
+  object: 'contact_match';
+
+  /**
+   * How you relate to the account this contact belongs to.
+   *
+   * - `customer` — the account is one of your customers.
+   * - `supplier` — the account is one of your suppliers.
+   * - `self` — the account is your own.
+   */
+  relationship: 'customer' | 'supplier' | 'self';
+}
+
+/**
+ * Request to find contacts by email.
+ */
+export interface FindContactByEmailRequest {
+  /**
+   * The email address to look up.
+   */
+  email: string;
+}
+
+/**
+ * List represents a paginated list of resources.
+ */
+export interface ListContactMatch {
+  /**
+   * Resources in this page.
+   */
+  data: Array<ContactMatch>;
+
+  /**
+   * Resource type identifier.
+   */
+  object: 'list';
+
+  /**
+   * PageInfo contains URL-based pagination metadata.
+   */
+  page_info: APIKeysAPI.PageInfo;
+}
+
+export interface ActionFindByEmailParams {
+  /**
+   * Body param: The email address to look up.
+   */
+  email: string;
+
+  /**
+   * Query param: Sub-objects to expand in the response. When omitted, sub-objects
+   * are returned as `null`.
+   */
+  include?: Array<
+    'account_user' | 'account_user.user' | 'account_user.role' | 'account_user.department' | 'account'
+  >;
+
+  /**
+   * Query param: Filter to contacts whose relationship to you is one of these.
+   */
+  relationships?: Array<'customer' | 'supplier' | 'self'>;
+}
+
+export declare namespace Actions {
+  export {
+    type ContactMatch as ContactMatch,
+    type FindContactByEmailRequest as FindContactByEmailRequest,
+    type ListContactMatch as ListContactMatch,
+    type ActionFindByEmailParams as ActionFindByEmailParams,
+  };
+}

package/src/resources/sales/contacts/contacts.ts

@@ -0,0 +1,27 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as ActionsAPI from './actions';
+import {
+  ActionFindByEmailParams,
+  Actions,
+  ContactMatch,
+  FindContactByEmailRequest,
+  ListContactMatch,
+} from './actions';
+
+export class Contacts extends APIResource {
+  actions: ActionsAPI.Actions = new ActionsAPI.Actions(this._client);
+}
+
+Contacts.Actions = Actions;
+
+export declare namespace Contacts {
+  export {
+    Actions as Actions,
+    type ContactMatch as ContactMatch,
+    type FindContactByEmailRequest as FindContactByEmailRequest,
+    type ListContactMatch as ListContactMatch,
+    type ActionFindByEmailParams as ActionFindByEmailParams,
+  };
+}

package/src/resources/sales/contacts/index.ts

@@ -0,0 +1,10 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Actions,
+  type ContactMatch,
+  type FindContactByEmailRequest,
+  type ListContactMatch,
+  type ActionFindByEmailParams,
+} from './actions';
+export { Contacts } from './contacts';

package/src/resources/sales/contacts.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './contacts/index';

package/src/resources/sales/customers/actions.ts

@@ -18,6 +18,8 @@ export class Actions extends APIResource {
    * line access, addresses, and users are consolidated without duplicates; the
    * source customers are then deleted.
    *
+   * This endpoint requires the permissions: `customers:update`, `customers:delete`.
+   *
    * @example
    * ```ts
    * const customer = await client.sales.customers.actions.merge(
@@ -70,6 +72,7 @@ export interface ActionMergeParams {
     | 'type'
     | 'parent_account'
     | 'freight_preferences.carrier'
+    | 'freight_preferences.carrier.service_levels'
     | 'freight_preferences.service_level'
     | 'defaults.payment_term'
     | 'defaults.shipping_term'
@@ -83,6 +86,7 @@ export interface ActionMergeParams {
     | 'price_groups'
     | 'child_accounts'
     | 'credit_limit'
+    | 'credit_limit.unit'
   >;
 }