featurebase-node 0.0.2

package/resources/companies/contacts.d.ts

@@ -0,0 +1,236 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+import * as ContactsAPI_ from "../contacts/contacts.js";
+/**
+ * Companies represent organizations or businesses that your users belong to. Use this endpoint to list and retrieve company information.
+ */
+export declare class Contacts extends APIResource {
+    /**
+     * Returns all contacts (customers) attached to a specific company.
+     *
+     * Only returns contacts with type "customer" that have the company in their
+     * `companyIds` array. Uses cursor-based pagination.
+     *
+     * ### Path Parameters
+     *
+     * - `id` - The Featurebase internal ID of the company (MongoDB ObjectId)
+     *
+     * ### Query Parameters
+     *
+     * - `limit` - Number of contacts to return (1-100, default: 10)
+     * - `cursor` - Opaque cursor from a previous response for pagination
+     *
+     * ### Response Structure
+     *
+     * The response includes:
+     *
+     * - `object` - Always "list"
+     * - `data` - Array of contact objects
+     * - `nextCursor` - Cursor for the next page (null if no more results)
+     *
+     * ### Example Response
+     *
+     * ```json
+     * {
+     *   "object": "list",
+     *   "data": [
+     *     {
+     *       "object": "contact",
+     *       "id": "507f1f77bcf86cd799439011",
+     *       "userId": "usr_12345",
+     *       "email": "john@acme.com",
+     *       "name": "John Doe",
+     *       "type": "customer",
+     *       "companies": [...],
+     *       "createdAt": "2025-01-01T12:00:00.000Z"
+     *     }
+     *   ],
+     *   "nextCursor": "eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9"
+     * }
+     * ```
+     *
+     * ### Error Responses
+     *
+     * - **404 Not Found** - Company with the specified ID does not exist
+     *
+     * ### Version Availability
+     *
+     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     *
+     * @example
+     * ```ts
+     * const contactList = await client.companies.contacts.list(
+     *   '507f1f77bcf86cd799439011',
+     * );
+     * ```
+     */
+    list(id: string, params?: ContactListParams | null | undefined, options?: RequestOptions): APIPromise<ContactsAPI_.ContactList>;
+    /**
+     * Attaches a contact (customer) to a company.
+     *
+     * Adds the company to the contact's `companyIds` array and embedded `companies`
+     * array. This operation is **additive** - existing company associations are
+     * preserved. Also increments the `linkedUsers` count on the company.
+     *
+     * ### Path Parameters
+     *
+     * - `id` - The Featurebase internal ID of the company (MongoDB ObjectId)
+     *
+     * ### Request Body
+     *
+     * | Field       | Type   | Required | Description                                                             |
+     * | ----------- | ------ | -------- | ----------------------------------------------------------------------- |
+     * | `contactId` | string | Yes      | The Featurebase internal ID of the contact to attach (MongoDB ObjectId) |
+     *
+     * ### Example Request
+     *
+     * ```json
+     * {
+     *   "contactId": "507f1f77bcf86cd799439012"
+     * }
+     * ```
+     *
+     * ### Response
+     *
+     * Returns the updated contact object with the new company association.
+     *
+     * ### Example Response
+     *
+     * ```json
+     * {
+     *   "object": "contact",
+     *   "id": "507f1f77bcf86cd799439012",
+     *   "userId": "usr_12345",
+     *   "email": "john@acme.com",
+     *   "name": "John Doe",
+     *   "type": "customer",
+     *   "companies": [
+     *     {
+     *       "object": "company",
+     *       "id": "507f1f77bcf86cd799439011",
+     *       "companyId": "comp_12345",
+     *       "name": "Acme Inc"
+     *     }
+     *   ]
+     * }
+     * ```
+     *
+     * ### Error Responses
+     *
+     * - **404 Not Found** - Company or contact does not exist
+     *
+     * ### Version Availability
+     *
+     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     *
+     * @example
+     * ```ts
+     * const response = await client.companies.contacts.attach(
+     *   '507f1f77bcf86cd799439011',
+     *   { contactId: '507f1f77bcf86cd799439012' },
+     * );
+     * ```
+     */
+    attach(id: string, params: ContactAttachParams, options?: RequestOptions): APIPromise<ContactAttachResponse>;
+    /**
+     * Removes a contact (customer) from a company.
+     *
+     * Removes the company from the contact's `companyIds` array and embedded
+     * `companies` array. Also decrements the `linkedUsers` count on the company.
+     *
+     * ### Path Parameters
+     *
+     * - `id` - The Featurebase internal ID of the company (MongoDB ObjectId)
+     * - `contactId` - The Featurebase internal ID of the contact to remove (MongoDB
+     *   ObjectId)
+     *
+     * ### Response
+     *
+     * Returns the updated contact object with the company removed.
+     *
+     * ### Example Response
+     *
+     * ```json
+     * {
+     *   "object": "contact",
+     *   "id": "507f1f77bcf86cd799439012",
+     *   "userId": "usr_12345",
+     *   "email": "john@acme.com",
+     *   "name": "John Doe",
+     *   "type": "customer",
+     *   "companies": []
+     * }
+     * ```
+     *
+     * ### Error Responses
+     *
+     * - **400 Bad Request** - Contact is not attached to this company
+     * - **404 Not Found** - Company or contact does not exist
+     *
+     * ### Version Availability
+     *
+     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     *
+     * @example
+     * ```ts
+     * const contact = await client.companies.contacts.remove(
+     *   '507f1f77bcf86cd799439012',
+     *   { id: '507f1f77bcf86cd799439011' },
+     * );
+     * ```
+     */
+    remove(contactID: string, params: ContactRemoveParams, options?: RequestOptions): APIPromise<ContactRemoveResponse>;
+}
+/**
+ * User who submitted the response
+ */
+export type ContactAttachResponse = ContactsAPI_.Contact | (null & {});
+/**
+ * User who submitted the response
+ */
+export type ContactRemoveResponse = ContactsAPI_.Contact | (null & {});
+export interface ContactListParams {
+    /**
+     * Query param: An opaque cursor for pagination. Use the nextCursor value from a
+     * previous response to fetch the next page of results.
+     */
+    cursor?: string;
+    /**
+     * Query param: A limit on the number of contacts to be returned, between 1
+     * and 100.
+     */
+    limit?: number;
+    /**
+     * Header param: API version for this request. Defaults to your organization's
+     * configured API version if not specified.
+     */
+    'Featurebase-Version'?: string;
+}
+export interface ContactAttachParams {
+    /**
+     * Body param: The Featurebase internal ID of the contact to attach (MongoDB
+     * ObjectId)
+     */
+    contactId: string;
+    /**
+     * Header param: API version for this request. Defaults to your organization's
+     * configured API version if not specified.
+     */
+    'Featurebase-Version'?: string;
+}
+export interface ContactRemoveParams {
+    /**
+     * Path param: The Featurebase internal ID of the company (MongoDB ObjectId)
+     */
+    id: string;
+    /**
+     * Header param: API version for this request. Defaults to your organization's
+     * configured API version if not specified.
+     */
+    'Featurebase-Version'?: string;
+}
+export declare namespace Contacts {
+    export { type ContactAttachResponse as ContactAttachResponse, type ContactRemoveResponse as ContactRemoveResponse, type ContactListParams as ContactListParams, type ContactAttachParams as ContactAttachParams, type ContactRemoveParams as ContactRemoveParams, };
+}
+//# sourceMappingURL=contacts.d.ts.map

package/resources/companies/contacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../src/resources/companies/contacts.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;OAElB,KAAK,YAAY;AAExB;;GAEG;AACH,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0DG;IACH,IAAI,CACF,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,iBAAiB,GAAG,IAAI,GAAG,SAAc,EACjD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,YAAY,CAAC,WAAW,CAAC;IAYvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiEG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;IAYpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACH,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;CAUrC;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC,OAAO,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC,OAAO,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}

package/resources/companies/contacts.js

@@ -0,0 +1,218 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Contacts = void 0;
+const resource_1 = require("../../core/resource.js");
+const headers_1 = require("../../internal/headers.js");
+const path_1 = require("../../internal/utils/path.js");
+/**
+ * Companies represent organizations or businesses that your users belong to. Use this endpoint to list and retrieve company information.
+ */
+class Contacts extends resource_1.APIResource {
+    /**
+     * Returns all contacts (customers) attached to a specific company.
+     *
+     * Only returns contacts with type "customer" that have the company in their
+     * `companyIds` array. Uses cursor-based pagination.
+     *
+     * ### Path Parameters
+     *
+     * - `id` - The Featurebase internal ID of the company (MongoDB ObjectId)
+     *
+     * ### Query Parameters
+     *
+     * - `limit` - Number of contacts to return (1-100, default: 10)
+     * - `cursor` - Opaque cursor from a previous response for pagination
+     *
+     * ### Response Structure
+     *
+     * The response includes:
+     *
+     * - `object` - Always "list"
+     * - `data` - Array of contact objects
+     * - `nextCursor` - Cursor for the next page (null if no more results)
+     *
+     * ### Example Response
+     *
+     * ```json
+     * {
+     *   "object": "list",
+     *   "data": [
+     *     {
+     *       "object": "contact",
+     *       "id": "507f1f77bcf86cd799439011",
+     *       "userId": "usr_12345",
+     *       "email": "john@acme.com",
+     *       "name": "John Doe",
+     *       "type": "customer",
+     *       "companies": [...],
+     *       "createdAt": "2025-01-01T12:00:00.000Z"
+     *     }
+     *   ],
+     *   "nextCursor": "eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9"
+     * }
+     * ```
+     *
+     * ### Error Responses
+     *
+     * - **404 Not Found** - Company with the specified ID does not exist
+     *
+     * ### Version Availability
+     *
+     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     *
+     * @example
+     * ```ts
+     * const contactList = await client.companies.contacts.list(
+     *   '507f1f77bcf86cd799439011',
+     * );
+     * ```
+     */
+    list(id, params = {}, options) {
+        const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
+        return this._client.get((0, path_1.path) `/v2/companies/${id}/contacts`, {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Attaches a contact (customer) to a company.
+     *
+     * Adds the company to the contact's `companyIds` array and embedded `companies`
+     * array. This operation is **additive** - existing company associations are
+     * preserved. Also increments the `linkedUsers` count on the company.
+     *
+     * ### Path Parameters
+     *
+     * - `id` - The Featurebase internal ID of the company (MongoDB ObjectId)
+     *
+     * ### Request Body
+     *
+     * | Field       | Type   | Required | Description                                                             |
+     * | ----------- | ------ | -------- | ----------------------------------------------------------------------- |
+     * | `contactId` | string | Yes      | The Featurebase internal ID of the contact to attach (MongoDB ObjectId) |
+     *
+     * ### Example Request
+     *
+     * ```json
+     * {
+     *   "contactId": "507f1f77bcf86cd799439012"
+     * }
+     * ```
+     *
+     * ### Response
+     *
+     * Returns the updated contact object with the new company association.
+     *
+     * ### Example Response
+     *
+     * ```json
+     * {
+     *   "object": "contact",
+     *   "id": "507f1f77bcf86cd799439012",
+     *   "userId": "usr_12345",
+     *   "email": "john@acme.com",
+     *   "name": "John Doe",
+     *   "type": "customer",
+     *   "companies": [
+     *     {
+     *       "object": "company",
+     *       "id": "507f1f77bcf86cd799439011",
+     *       "companyId": "comp_12345",
+     *       "name": "Acme Inc"
+     *     }
+     *   ]
+     * }
+     * ```
+     *
+     * ### Error Responses
+     *
+     * - **404 Not Found** - Company or contact does not exist
+     *
+     * ### Version Availability
+     *
+     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     *
+     * @example
+     * ```ts
+     * const response = await client.companies.contacts.attach(
+     *   '507f1f77bcf86cd799439011',
+     *   { contactId: '507f1f77bcf86cd799439012' },
+     * );
+     * ```
+     */
+    attach(id, params, options) {
+        const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
+        return this._client.post((0, path_1.path) `/v2/companies/${id}/contacts`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Removes a contact (customer) from a company.
+     *
+     * Removes the company from the contact's `companyIds` array and embedded
+     * `companies` array. Also decrements the `linkedUsers` count on the company.
+     *
+     * ### Path Parameters
+     *
+     * - `id` - The Featurebase internal ID of the company (MongoDB ObjectId)
+     * - `contactId` - The Featurebase internal ID of the contact to remove (MongoDB
+     *   ObjectId)
+     *
+     * ### Response
+     *
+     * Returns the updated contact object with the company removed.
+     *
+     * ### Example Response
+     *
+     * ```json
+     * {
+     *   "object": "contact",
+     *   "id": "507f1f77bcf86cd799439012",
+     *   "userId": "usr_12345",
+     *   "email": "john@acme.com",
+     *   "name": "John Doe",
+     *   "type": "customer",
+     *   "companies": []
+     * }
+     * ```
+     *
+     * ### Error Responses
+     *
+     * - **400 Bad Request** - Contact is not attached to this company
+     * - **404 Not Found** - Company or contact does not exist
+     *
+     * ### Version Availability
+     *
+     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     *
+     * @example
+     * ```ts
+     * const contact = await client.companies.contacts.remove(
+     *   '507f1f77bcf86cd799439012',
+     *   { id: '507f1f77bcf86cd799439011' },
+     * );
+     * ```
+     */
+    remove(contactID, params, options) {
+        const { id, 'Featurebase-Version': featurebaseVersion } = params;
+        return this._client.delete((0, path_1.path) `/v2/companies/${id}/contacts/${contactID}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+}
+exports.Contacts = Contacts;
+//# sourceMappingURL=contacts.js.map

package/resources/companies/contacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.js","sourceRoot":"","sources":["../../src/resources/companies/contacts.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,uDAAsD;AAEtD,uDAAiD;AAGjD;;GAEG;AACH,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0DG;IACH,IAAI,CACF,EAAU,EACV,SAA+C,EAAE,EACjD,OAAwB;QAExB,MAAM,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC7E,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,iBAAiB,EAAE,WAAW,EAAE;YAC1D,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,kBAAkB,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBAC/F,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiEG;IACH,MAAM,CACJ,EAAU,EACV,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACtE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,iBAAiB,EAAE,WAAW,EAAE;YAC3D,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,kBAAkB,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBAC/F,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACH,MAAM,CACJ,SAAiB,EACjB,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,EAAE,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAAC;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,iBAAiB,EAAE,aAAa,SAAS,EAAE,EAAE;YAC1E,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,kBAAkB,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBAC/F,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF;AA3ND,4BA2NC"}

package/resources/companies/contacts.mjs

@@ -0,0 +1,214 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+import { path } from "../../internal/utils/path.mjs";
+/**
+ * Companies represent organizations or businesses that your users belong to. Use this endpoint to list and retrieve company information.
+ */
+export class Contacts extends APIResource {
+    /**
+     * Returns all contacts (customers) attached to a specific company.
+     *
+     * Only returns contacts with type "customer" that have the company in their
+     * `companyIds` array. Uses cursor-based pagination.
+     *
+     * ### Path Parameters
+     *
+     * - `id` - The Featurebase internal ID of the company (MongoDB ObjectId)
+     *
+     * ### Query Parameters
+     *
+     * - `limit` - Number of contacts to return (1-100, default: 10)
+     * - `cursor` - Opaque cursor from a previous response for pagination
+     *
+     * ### Response Structure
+     *
+     * The response includes:
+     *
+     * - `object` - Always "list"
+     * - `data` - Array of contact objects
+     * - `nextCursor` - Cursor for the next page (null if no more results)
+     *
+     * ### Example Response
+     *
+     * ```json
+     * {
+     *   "object": "list",
+     *   "data": [
+     *     {
+     *       "object": "contact",
+     *       "id": "507f1f77bcf86cd799439011",
+     *       "userId": "usr_12345",
+     *       "email": "john@acme.com",
+     *       "name": "John Doe",
+     *       "type": "customer",
+     *       "companies": [...],
+     *       "createdAt": "2025-01-01T12:00:00.000Z"
+     *     }
+     *   ],
+     *   "nextCursor": "eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9"
+     * }
+     * ```
+     *
+     * ### Error Responses
+     *
+     * - **404 Not Found** - Company with the specified ID does not exist
+     *
+     * ### Version Availability
+     *
+     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     *
+     * @example
+     * ```ts
+     * const contactList = await client.companies.contacts.list(
+     *   '507f1f77bcf86cd799439011',
+     * );
+     * ```
+     */
+    list(id, params = {}, options) {
+        const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
+        return this._client.get(path `/v2/companies/${id}/contacts`, {
+            query,
+            ...options,
+            headers: buildHeaders([
+                { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Attaches a contact (customer) to a company.
+     *
+     * Adds the company to the contact's `companyIds` array and embedded `companies`
+     * array. This operation is **additive** - existing company associations are
+     * preserved. Also increments the `linkedUsers` count on the company.
+     *
+     * ### Path Parameters
+     *
+     * - `id` - The Featurebase internal ID of the company (MongoDB ObjectId)
+     *
+     * ### Request Body
+     *
+     * | Field       | Type   | Required | Description                                                             |
+     * | ----------- | ------ | -------- | ----------------------------------------------------------------------- |
+     * | `contactId` | string | Yes      | The Featurebase internal ID of the contact to attach (MongoDB ObjectId) |
+     *
+     * ### Example Request
+     *
+     * ```json
+     * {
+     *   "contactId": "507f1f77bcf86cd799439012"
+     * }
+     * ```
+     *
+     * ### Response
+     *
+     * Returns the updated contact object with the new company association.
+     *
+     * ### Example Response
+     *
+     * ```json
+     * {
+     *   "object": "contact",
+     *   "id": "507f1f77bcf86cd799439012",
+     *   "userId": "usr_12345",
+     *   "email": "john@acme.com",
+     *   "name": "John Doe",
+     *   "type": "customer",
+     *   "companies": [
+     *     {
+     *       "object": "company",
+     *       "id": "507f1f77bcf86cd799439011",
+     *       "companyId": "comp_12345",
+     *       "name": "Acme Inc"
+     *     }
+     *   ]
+     * }
+     * ```
+     *
+     * ### Error Responses
+     *
+     * - **404 Not Found** - Company or contact does not exist
+     *
+     * ### Version Availability
+     *
+     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     *
+     * @example
+     * ```ts
+     * const response = await client.companies.contacts.attach(
+     *   '507f1f77bcf86cd799439011',
+     *   { contactId: '507f1f77bcf86cd799439012' },
+     * );
+     * ```
+     */
+    attach(id, params, options) {
+        const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
+        return this._client.post(path `/v2/companies/${id}/contacts`, {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Removes a contact (customer) from a company.
+     *
+     * Removes the company from the contact's `companyIds` array and embedded
+     * `companies` array. Also decrements the `linkedUsers` count on the company.
+     *
+     * ### Path Parameters
+     *
+     * - `id` - The Featurebase internal ID of the company (MongoDB ObjectId)
+     * - `contactId` - The Featurebase internal ID of the contact to remove (MongoDB
+     *   ObjectId)
+     *
+     * ### Response
+     *
+     * Returns the updated contact object with the company removed.
+     *
+     * ### Example Response
+     *
+     * ```json
+     * {
+     *   "object": "contact",
+     *   "id": "507f1f77bcf86cd799439012",
+     *   "userId": "usr_12345",
+     *   "email": "john@acme.com",
+     *   "name": "John Doe",
+     *   "type": "customer",
+     *   "companies": []
+     * }
+     * ```
+     *
+     * ### Error Responses
+     *
+     * - **400 Bad Request** - Contact is not attached to this company
+     * - **404 Not Found** - Company or contact does not exist
+     *
+     * ### Version Availability
+     *
+     * This endpoint is only available in API version 2026-01-01.nova and newer.
+     *
+     * @example
+     * ```ts
+     * const contact = await client.companies.contacts.remove(
+     *   '507f1f77bcf86cd799439012',
+     *   { id: '507f1f77bcf86cd799439011' },
+     * );
+     * ```
+     */
+    remove(contactID, params, options) {
+        const { id, 'Featurebase-Version': featurebaseVersion } = params;
+        return this._client.delete(path `/v2/companies/${id}/contacts/${contactID}`, {
+            ...options,
+            headers: buildHeaders([
+                { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+}
+//# sourceMappingURL=contacts.mjs.map

package/resources/companies/contacts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.mjs","sourceRoot":"","sources":["../../src/resources/companies/contacts.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAGf;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0DG;IACH,IAAI,CACF,EAAU,EACV,SAA+C,EAAE,EACjD,OAAwB;QAExB,MAAM,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC7E,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,iBAAiB,EAAE,WAAW,EAAE;YAC1D,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,kBAAkB,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBAC/F,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiEG;IACH,MAAM,CACJ,EAAU,EACV,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACtE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,iBAAiB,EAAE,WAAW,EAAE;YAC3D,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,kBAAkB,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBAC/F,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACH,MAAM,CACJ,SAAiB,EACjB,MAA2B,EAC3B,OAAwB;QAExB,MAAM,EAAE,EAAE,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAAC;QACjE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,iBAAiB,EAAE,aAAa,SAAS,EAAE,EAAE;YAC1E,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,kBAAkB,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBAC/F,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF"}

package/resources/companies/index.d.mts

@@ -0,0 +1,3 @@
+export { Companies, type Company, type DeletedCompany, type CompanyListResponse, type CompanyRetrieveParams, type CompanyListParams, type CompanyDeleteParams, type CompanyCreateOrUpdateParams, type CompanyDeleteByCompanyIDParams, } from "./companies.mjs";
+export { Contacts, type ContactAttachResponse, type ContactRemoveResponse, type ContactListParams, type ContactAttachParams, type ContactRemoveParams, } from "./contacts.mjs";
+//# sourceMappingURL=index.d.mts.map

package/resources/companies/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/companies/index.ts"],"names":[],"mappings":"OAEO,EACL,SAAS,EACT,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,GACpC;OACM,EACL,QAAQ,EACR,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB"}