featurebase-node 0.0.2

package/resources/contacts/by-user-id/by-user-id.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"by-user-id.mjs","sourceRoot":"","sources":["../../../src/resources/contacts/by-user-id/by-user-id.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,KAAK,mBAAmB;OACxB,EAGL,gBAAgB,GACjB;OAEM,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IAAzC;;QACE,qBAAgB,GAAyC,IAAI,mBAAmB,CAAC,gBAAgB,CAC/F,IAAI,CAAC,OAAO,CACb,CAAC;IA6IJ,CAAC;IA3IC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyDG;IACH,QAAQ,CACN,MAAc,EACd,SAAoD,EAAE,EACtD,OAAwB;QAExB,MAAM,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACnE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,2BAA2B,MAAM,EAAE,EAAE;YAC/D,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmDG;IACH,MAAM,CACJ,MAAc,EACd,SAAkD,EAAE,EACpD,OAAwB;QAExB,MAAM,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACnE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,2BAA2B,MAAM,EAAE,EAAE;YAClE,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;AAuBD,QAAQ,CAAC,gBAAgB,GAAG,gBAAgB,CAAC"}

package/resources/contacts/by-user-id/email-preferences.d.mts

@@ -0,0 +1,199 @@
+import { APIResource } from "../../../core/resource.mjs";
+import * as EmailPreferencesAPI from "../email-preferences.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+/**
+ * Contacts are the customers and leads in your Featurebase organization. Use this endpoint to list and retrieve contact information.
+ */
+export declare class EmailPreferences extends APIResource {
+    /**
+     * Retrieves the email preference state for a customer contact by their external
+     * user ID.
+     *
+     * This endpoint only supports customer contacts and mirrors the existing
+     * `by-user-id` lookup pattern used across the contact API.
+     *
+     * ### Path Parameters
+     *
+     * - `userId` - The external user ID from your system
+     *
+     * ### Example Response
+     *
+     * ```json
+     * {
+     *   "object": "contact_email_preferences",
+     *   "contactId": "676f0f6765bdaa7d7d760f88",
+     *   "userId": "usr_12345",
+     *   "email": "john@example.com",
+     *   "preferences": {
+     *     "all": {
+     *       "status": "unsubscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     },
+     *     "postUpdates": {
+     *       "status": "subscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     },
+     *     "postComments": {
+     *       "status": "subscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     },
+     *     "commentReplies": {
+     *       "status": "subscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     },
+     *     "changelog": {
+     *       "status": "subscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     }
+     *   }
+     * }
+     * ```
+     *
+     * @example
+     * ```ts
+     * const preferencesOutput =
+     *   await client.contacts.byUserID.emailPreferences.retrieve(
+     *     'usr_12345',
+     *   );
+     * ```
+     */
+    retrieve(userID: string, params?: EmailPreferenceRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<EmailPreferencesAPI.PreferencesOutput>;
+    /**
+     * Updates one or more email preferences for a customer contact by their external
+     * user ID.
+     *
+     * This endpoint only supports customer contacts and mirrors the existing
+     * `by-user-id` lookup pattern used across the contact API.
+     *
+     * ### Path Parameters
+     *
+     * - `userId` - The external user ID from your system
+     *
+     * ### Request Body
+     *
+     * - `preferences` - A partial map of preference keys to their desired stored
+     *   status. Only the preferences included in the request are updated; any
+     *   preferences omitted are left unchanged. At least one preference must be
+     *   provided.
+     *
+     * See `PATCH /v2/contacts/{id}/email-preferences` for the full list of supported
+     * preference keys and per-key values, the `all` delivery-gate semantics, and
+     * details on combining `all` with per-category keys in a single request.
+     *
+     * ### Example Request (partial update)
+     *
+     * ```json
+     * {
+     *   "preferences": {
+     *     "postUpdates": "unsubscribed",
+     *     "changelog": "subscribed"
+     *   }
+     * }
+     * ```
+     *
+     * ### Example Request (full preference-center submit)
+     *
+     * ```json
+     * {
+     *   "preferences": {
+     *     "all": "subscribed",
+     *     "postUpdates": "subscribed",
+     *     "postComments": "unsubscribed",
+     *     "commentReplies": "unsubscribed",
+     *     "changelog": "unsubscribed"
+     *   }
+     * }
+     * ```
+     *
+     * ### Example Response
+     *
+     * ```json
+     * {
+     *   "object": "contact_email_preferences",
+     *   "contactId": "676f0f6765bdaa7d7d760f88",
+     *   "userId": "usr_12345",
+     *   "email": "john@example.com",
+     *   "preferences": {
+     *     "all": {
+     *       "status": "subscribed",
+     *       "effectiveStatus": "subscribed"
+     *     },
+     *     "postUpdates": {
+     *       "status": "subscribed",
+     *       "effectiveStatus": "subscribed"
+     *     },
+     *     "postComments": {
+     *       "status": "unsubscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     },
+     *     "commentReplies": {
+     *       "status": "unsubscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     },
+     *     "changelog": {
+     *       "status": "unsubscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     }
+     *   }
+     * }
+     * ```
+     *
+     * @example
+     * ```ts
+     * const preferencesOutput =
+     *   await client.contacts.byUserID.emailPreferences.update(
+     *     'usr_12345',
+     *     { preferences: {} },
+     *   );
+     * ```
+     */
+    update(userID: string, params: EmailPreferenceUpdateParams, options?: RequestOptions): APIPromise<EmailPreferencesAPI.PreferencesOutput>;
+}
+export interface EmailPreferenceRetrieveParams {
+    /**
+     * API version for this request. Defaults to your organization's configured API
+     * version if not specified.
+     */
+    'Featurebase-Version'?: string;
+}
+export interface EmailPreferenceUpdateParams {
+    /**
+     * Body param
+     */
+    preferences: EmailPreferenceUpdateParams.Preferences;
+    /**
+     * Header param: API version for this request. Defaults to your organization's
+     * configured API version if not specified.
+     */
+    'Featurebase-Version'?: string;
+}
+export declare namespace EmailPreferenceUpdateParams {
+    interface Preferences {
+        /**
+         * Master delivery gate. When `unsubscribed`, the contact receives no emails
+         * regardless of the per-category values. Per-category values are preserved.
+         */
+        all?: 'subscribed' | 'unsubscribed';
+        /**
+         * Stored status for new changelog release notifications.
+         */
+        changelog?: 'subscribed' | 'unsubscribed';
+        /**
+         * Stored status for replies to the contact’s own comments.
+         */
+        commentReplies?: 'subscribed' | 'unsubscribed';
+        /**
+         * Stored status for new comments on posts the contact follows.
+         */
+        postComments?: 'subscribed' | 'unsubscribed';
+        /**
+         * Stored status for post status changes and updates on posts the contact follows.
+         */
+        postUpdates?: 'subscribed' | 'unsubscribed';
+    }
+}
+export declare namespace EmailPreferences {
+    export { type EmailPreferenceRetrieveParams as EmailPreferenceRetrieveParams, type EmailPreferenceUpdateParams as EmailPreferenceUpdateParams, };
+}
+//# sourceMappingURL=email-preferences.d.mts.map

package/resources/contacts/by-user-id/email-preferences.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-preferences.d.mts","sourceRoot":"","sources":["../../../src/resources/contacts/by-user-id/email-preferences.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,mBAAmB;OACxB,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;AAGzB;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmDG;IACH,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,6BAA6B,GAAG,IAAI,GAAG,SAAc,EAC7D,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,mBAAmB,CAAC,iBAAiB,CAAC;IAWpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwFG;IACH,MAAM,CACJ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,2BAA2B,EACnC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,mBAAmB,CAAC,iBAAiB,CAAC;CAWrD;AAED,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,WAAW,EAAE,2BAA2B,CAAC,WAAW,CAAC;IAErD;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,yBAAiB,2BAA2B,CAAC;IAC3C,UAAiB,WAAW;QAC1B;;;WAGG;QACH,GAAG,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC;QAEpC;;WAEG;QACH,SAAS,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC;QAE1C;;WAEG;QACH,cAAc,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC;QAE/C;;WAEG;QACH,YAAY,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC;QAE7C;;WAEG;QACH,WAAW,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC;KAC7C;CACF;AAED,MAAM,CAAC,OAAO,WAAW,gBAAgB,CAAC;IACxC,OAAO,EACL,KAAK,6BAA6B,IAAI,6BAA6B,EACnE,KAAK,2BAA2B,IAAI,2BAA2B,GAChE,CAAC;CACH"}

package/resources/contacts/by-user-id/email-preferences.d.ts

@@ -0,0 +1,199 @@
+import { APIResource } from "../../../core/resource.js";
+import * as EmailPreferencesAPI from "../email-preferences.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+/**
+ * Contacts are the customers and leads in your Featurebase organization. Use this endpoint to list and retrieve contact information.
+ */
+export declare class EmailPreferences extends APIResource {
+    /**
+     * Retrieves the email preference state for a customer contact by their external
+     * user ID.
+     *
+     * This endpoint only supports customer contacts and mirrors the existing
+     * `by-user-id` lookup pattern used across the contact API.
+     *
+     * ### Path Parameters
+     *
+     * - `userId` - The external user ID from your system
+     *
+     * ### Example Response
+     *
+     * ```json
+     * {
+     *   "object": "contact_email_preferences",
+     *   "contactId": "676f0f6765bdaa7d7d760f88",
+     *   "userId": "usr_12345",
+     *   "email": "john@example.com",
+     *   "preferences": {
+     *     "all": {
+     *       "status": "unsubscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     },
+     *     "postUpdates": {
+     *       "status": "subscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     },
+     *     "postComments": {
+     *       "status": "subscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     },
+     *     "commentReplies": {
+     *       "status": "subscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     },
+     *     "changelog": {
+     *       "status": "subscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     }
+     *   }
+     * }
+     * ```
+     *
+     * @example
+     * ```ts
+     * const preferencesOutput =
+     *   await client.contacts.byUserID.emailPreferences.retrieve(
+     *     'usr_12345',
+     *   );
+     * ```
+     */
+    retrieve(userID: string, params?: EmailPreferenceRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<EmailPreferencesAPI.PreferencesOutput>;
+    /**
+     * Updates one or more email preferences for a customer contact by their external
+     * user ID.
+     *
+     * This endpoint only supports customer contacts and mirrors the existing
+     * `by-user-id` lookup pattern used across the contact API.
+     *
+     * ### Path Parameters
+     *
+     * - `userId` - The external user ID from your system
+     *
+     * ### Request Body
+     *
+     * - `preferences` - A partial map of preference keys to their desired stored
+     *   status. Only the preferences included in the request are updated; any
+     *   preferences omitted are left unchanged. At least one preference must be
+     *   provided.
+     *
+     * See `PATCH /v2/contacts/{id}/email-preferences` for the full list of supported
+     * preference keys and per-key values, the `all` delivery-gate semantics, and
+     * details on combining `all` with per-category keys in a single request.
+     *
+     * ### Example Request (partial update)
+     *
+     * ```json
+     * {
+     *   "preferences": {
+     *     "postUpdates": "unsubscribed",
+     *     "changelog": "subscribed"
+     *   }
+     * }
+     * ```
+     *
+     * ### Example Request (full preference-center submit)
+     *
+     * ```json
+     * {
+     *   "preferences": {
+     *     "all": "subscribed",
+     *     "postUpdates": "subscribed",
+     *     "postComments": "unsubscribed",
+     *     "commentReplies": "unsubscribed",
+     *     "changelog": "unsubscribed"
+     *   }
+     * }
+     * ```
+     *
+     * ### Example Response
+     *
+     * ```json
+     * {
+     *   "object": "contact_email_preferences",
+     *   "contactId": "676f0f6765bdaa7d7d760f88",
+     *   "userId": "usr_12345",
+     *   "email": "john@example.com",
+     *   "preferences": {
+     *     "all": {
+     *       "status": "subscribed",
+     *       "effectiveStatus": "subscribed"
+     *     },
+     *     "postUpdates": {
+     *       "status": "subscribed",
+     *       "effectiveStatus": "subscribed"
+     *     },
+     *     "postComments": {
+     *       "status": "unsubscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     },
+     *     "commentReplies": {
+     *       "status": "unsubscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     },
+     *     "changelog": {
+     *       "status": "unsubscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     }
+     *   }
+     * }
+     * ```
+     *
+     * @example
+     * ```ts
+     * const preferencesOutput =
+     *   await client.contacts.byUserID.emailPreferences.update(
+     *     'usr_12345',
+     *     { preferences: {} },
+     *   );
+     * ```
+     */
+    update(userID: string, params: EmailPreferenceUpdateParams, options?: RequestOptions): APIPromise<EmailPreferencesAPI.PreferencesOutput>;
+}
+export interface EmailPreferenceRetrieveParams {
+    /**
+     * API version for this request. Defaults to your organization's configured API
+     * version if not specified.
+     */
+    'Featurebase-Version'?: string;
+}
+export interface EmailPreferenceUpdateParams {
+    /**
+     * Body param
+     */
+    preferences: EmailPreferenceUpdateParams.Preferences;
+    /**
+     * Header param: API version for this request. Defaults to your organization's
+     * configured API version if not specified.
+     */
+    'Featurebase-Version'?: string;
+}
+export declare namespace EmailPreferenceUpdateParams {
+    interface Preferences {
+        /**
+         * Master delivery gate. When `unsubscribed`, the contact receives no emails
+         * regardless of the per-category values. Per-category values are preserved.
+         */
+        all?: 'subscribed' | 'unsubscribed';
+        /**
+         * Stored status for new changelog release notifications.
+         */
+        changelog?: 'subscribed' | 'unsubscribed';
+        /**
+         * Stored status for replies to the contact’s own comments.
+         */
+        commentReplies?: 'subscribed' | 'unsubscribed';
+        /**
+         * Stored status for new comments on posts the contact follows.
+         */
+        postComments?: 'subscribed' | 'unsubscribed';
+        /**
+         * Stored status for post status changes and updates on posts the contact follows.
+         */
+        postUpdates?: 'subscribed' | 'unsubscribed';
+    }
+}
+export declare namespace EmailPreferences {
+    export { type EmailPreferenceRetrieveParams as EmailPreferenceRetrieveParams, type EmailPreferenceUpdateParams as EmailPreferenceUpdateParams, };
+}
+//# sourceMappingURL=email-preferences.d.ts.map

package/resources/contacts/by-user-id/email-preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-preferences.d.ts","sourceRoot":"","sources":["../../../src/resources/contacts/by-user-id/email-preferences.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,mBAAmB;OACxB,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;AAGzB;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmDG;IACH,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,6BAA6B,GAAG,IAAI,GAAG,SAAc,EAC7D,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,mBAAmB,CAAC,iBAAiB,CAAC;IAWpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwFG;IACH,MAAM,CACJ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,2BAA2B,EACnC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,mBAAmB,CAAC,iBAAiB,CAAC;CAWrD;AAED,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,WAAW,EAAE,2BAA2B,CAAC,WAAW,CAAC;IAErD;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,yBAAiB,2BAA2B,CAAC;IAC3C,UAAiB,WAAW;QAC1B;;;WAGG;QACH,GAAG,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC;QAEpC;;WAEG;QACH,SAAS,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC;QAE1C;;WAEG;QACH,cAAc,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC;QAE/C;;WAEG;QACH,YAAY,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC;QAE7C;;WAEG;QACH,WAAW,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC;KAC7C;CACF;AAED,MAAM,CAAC,OAAO,WAAW,gBAAgB,CAAC;IACxC,OAAO,EACL,KAAK,6BAA6B,IAAI,6BAA6B,EACnE,KAAK,2BAA2B,IAAI,2BAA2B,GAChE,CAAC;CACH"}

package/resources/contacts/by-user-id/email-preferences.js

@@ -0,0 +1,176 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailPreferences = void 0;
+const resource_1 = require("../../../core/resource.js");
+const headers_1 = require("../../../internal/headers.js");
+const path_1 = require("../../../internal/utils/path.js");
+/**
+ * Contacts are the customers and leads in your Featurebase organization. Use this endpoint to list and retrieve contact information.
+ */
+class EmailPreferences extends resource_1.APIResource {
+    /**
+     * Retrieves the email preference state for a customer contact by their external
+     * user ID.
+     *
+     * This endpoint only supports customer contacts and mirrors the existing
+     * `by-user-id` lookup pattern used across the contact API.
+     *
+     * ### Path Parameters
+     *
+     * - `userId` - The external user ID from your system
+     *
+     * ### Example Response
+     *
+     * ```json
+     * {
+     *   "object": "contact_email_preferences",
+     *   "contactId": "676f0f6765bdaa7d7d760f88",
+     *   "userId": "usr_12345",
+     *   "email": "john@example.com",
+     *   "preferences": {
+     *     "all": {
+     *       "status": "unsubscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     },
+     *     "postUpdates": {
+     *       "status": "subscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     },
+     *     "postComments": {
+     *       "status": "subscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     },
+     *     "commentReplies": {
+     *       "status": "subscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     },
+     *     "changelog": {
+     *       "status": "subscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     }
+     *   }
+     * }
+     * ```
+     *
+     * @example
+     * ```ts
+     * const preferencesOutput =
+     *   await client.contacts.byUserID.emailPreferences.retrieve(
+     *     'usr_12345',
+     *   );
+     * ```
+     */
+    retrieve(userID, params = {}, options) {
+        const { 'Featurebase-Version': featurebaseVersion } = params ?? {};
+        return this._client.get((0, path_1.path) `/v2/contacts/by-user-id/${userID}/email-preferences`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Updates one or more email preferences for a customer contact by their external
+     * user ID.
+     *
+     * This endpoint only supports customer contacts and mirrors the existing
+     * `by-user-id` lookup pattern used across the contact API.
+     *
+     * ### Path Parameters
+     *
+     * - `userId` - The external user ID from your system
+     *
+     * ### Request Body
+     *
+     * - `preferences` - A partial map of preference keys to their desired stored
+     *   status. Only the preferences included in the request are updated; any
+     *   preferences omitted are left unchanged. At least one preference must be
+     *   provided.
+     *
+     * See `PATCH /v2/contacts/{id}/email-preferences` for the full list of supported
+     * preference keys and per-key values, the `all` delivery-gate semantics, and
+     * details on combining `all` with per-category keys in a single request.
+     *
+     * ### Example Request (partial update)
+     *
+     * ```json
+     * {
+     *   "preferences": {
+     *     "postUpdates": "unsubscribed",
+     *     "changelog": "subscribed"
+     *   }
+     * }
+     * ```
+     *
+     * ### Example Request (full preference-center submit)
+     *
+     * ```json
+     * {
+     *   "preferences": {
+     *     "all": "subscribed",
+     *     "postUpdates": "subscribed",
+     *     "postComments": "unsubscribed",
+     *     "commentReplies": "unsubscribed",
+     *     "changelog": "unsubscribed"
+     *   }
+     * }
+     * ```
+     *
+     * ### Example Response
+     *
+     * ```json
+     * {
+     *   "object": "contact_email_preferences",
+     *   "contactId": "676f0f6765bdaa7d7d760f88",
+     *   "userId": "usr_12345",
+     *   "email": "john@example.com",
+     *   "preferences": {
+     *     "all": {
+     *       "status": "subscribed",
+     *       "effectiveStatus": "subscribed"
+     *     },
+     *     "postUpdates": {
+     *       "status": "subscribed",
+     *       "effectiveStatus": "subscribed"
+     *     },
+     *     "postComments": {
+     *       "status": "unsubscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     },
+     *     "commentReplies": {
+     *       "status": "unsubscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     },
+     *     "changelog": {
+     *       "status": "unsubscribed",
+     *       "effectiveStatus": "unsubscribed"
+     *     }
+     *   }
+     * }
+     * ```
+     *
+     * @example
+     * ```ts
+     * const preferencesOutput =
+     *   await client.contacts.byUserID.emailPreferences.update(
+     *     'usr_12345',
+     *     { preferences: {} },
+     *   );
+     * ```
+     */
+    update(userID, params, options) {
+        const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
+        return this._client.patch((0, path_1.path) `/v2/contacts/by-user-id/${userID}/email-preferences`, {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+}
+exports.EmailPreferences = EmailPreferences;
+//# sourceMappingURL=email-preferences.js.map

package/resources/contacts/by-user-id/email-preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-preferences.js","sourceRoot":"","sources":["../../../src/resources/contacts/by-user-id/email-preferences.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAGrD,0DAAyD;AAEzD,0DAAoD;AAEpD;;GAEG;AACH,MAAa,gBAAiB,SAAQ,sBAAW;IAC/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmDG;IACH,QAAQ,CACN,MAAc,EACd,SAA2D,EAAE,EAC7D,OAAwB;QAExB,MAAM,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACnE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,2BAA2B,MAAM,oBAAoB,EAAE;YACjF,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwFG;IACH,MAAM,CACJ,MAAc,EACd,MAAmC,EACnC,OAAwB;QAExB,MAAM,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACtE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,2BAA2B,MAAM,oBAAoB,EAAE;YACnF,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;CACF;AA5KD,4CA4KC"}