release: 1.12.0 (#121)

* chore(internal): formatting change

* feat(api): api update

* release: 1.12.0

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.11.8"
+  ".": "1.12.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 89
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/knock%2Fknock-f83c849e3e1c614100e19d79e4bd38ae67353a8316264cf89e4e721f3c1a5739.yml
-openapi_spec_hash: 01ad62e55b345d5c077dad6144249e32
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/knock%2Fknock-e4ea1ded040ebfa923df0d24ef37ae3c742383828cda85e1489bc2cb5e14da29.yml
+openapi_spec_hash: 4cfd1f5f0d42e1b821f70ba12089b606
 config_hash: 5c872aa99cad9b9602e84668f5b38a8a

CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 1.12.0 (2025-08-15)
+
+Full Changelog: [v1.11.8...v1.12.0](https://github.com/knocklabs/knock-node/compare/v1.11.8...v1.12.0)
+
+### Features
+
+* **api:** api update ([edbcbeb](https://github.com/knocklabs/knock-node/commit/edbcbeb76e86071a770f40b7cc1dbaf0f4d1e9fc))
+
+
+### Chores
+
+* **internal:** formatting change ([45c032a](https://github.com/knocklabs/knock-node/commit/45c032aacfd31a5f4985dd9fc3d400e063b33791))
+
 ## 1.11.8 (2025-08-15)
 
 Full Changelog: [v1.11.7...v1.11.8](https://github.com/knocklabs/knock-node/compare/v1.11.7...v1.11.8)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knocklabs/node",
-  "version": "1.11.8",
+  "version": "1.12.0",
   "description": "The official TypeScript library for the Knock API",
   "author": "Knock <[email protected]>",
   "types": "dist/index.d.ts",

src/client.ts

@@ -849,6 +849,7 @@ export class Knock {
   channels: API.Channels = new API.Channels(this);
   audiences: API.Audiences = new API.Audiences(this);
 }
+
 Knock.Shared = Shared;
 Knock.Recipients = Recipients;
 Knock.Users = Users;
@@ -862,6 +863,7 @@ Knock.Workflows = Workflows;
 Knock.Schedules = Schedules;
 Knock.Channels = Channels;
 Knock.Audiences = Audiences;
+
 export declare namespace Knock {
   export type RequestOptions = Opts.RequestOptions;
 

src/resources/objects/objects.ts

@@ -345,11 +345,13 @@ export class Objects extends APIResource {
   }
 
   /**
-   * Sets preferences within the given preference set. This is a destructive
-   * operation and will replace any existing preferences with the preferences given.
-   * If no object exists in the current environment for the given `:collection` and
-   * `:object_id`, Knock will create the object as part of this request. The
-   * preference set `:id` can be either `default` or a `tenant.id`. Learn more about
+   * Sets preferences within the given preference set. By default, this is a
+   * destructive operation and will replace any existing preferences with the
+   * preferences given. Use '\_\_persistence_strategy': 'merge' to merge with
+   * existing preferences instead. If no object exists in the current environment for
+   * the given `:collection` and `:object_id`, Knock will create the object as part
+   * of this request. The preference set `:id` can be either `default` or a
+   * `tenant.id`. Learn more about
    * [per-tenant preferences](/preferences/tenant-preferences).
    *
    * @example
@@ -359,6 +361,7 @@ export class Objects extends APIResource {
    *   'object_id',
    *   'default',
    *   {
+   *     __persistence_strategy__: 'merge',
    *     categories: {
    *       marketing: false,
    *       transactional: { channel_types: { email: false } },
@@ -717,6 +720,12 @@ export interface ObjectSetChannelDataParams {
 }
 
 export interface ObjectSetPreferencesParams {
+  /**
+   * Controls how the preference set is persisted. 'replace' will completely replace
+   * the preference set, 'merge' will merge with existing preferences.
+   */
+  __persistence_strategy__?: 'merge' | 'replace';
+
   /**
    * An object where the key is the category and the values are the preference
    * settings for that category.

src/resources/recipients/preferences.ts

@@ -125,6 +125,12 @@ export interface PreferenceSetChannelTypes {
  * A request to set a preference set for a recipient.
  */
 export interface PreferenceSetRequest {
+  /**
+   * Controls how the preference set is persisted. 'replace' will completely replace
+   * the preference set, 'merge' will merge with existing preferences.
+   */
+  __persistence_strategy__?: 'merge' | 'replace';
+
   /**
    * An object where the key is the category and the values are the preference
    * settings for that category.

src/resources/users/bulk.ts

@@ -57,6 +57,7 @@ export class Bulk extends APIResource {
    * const bulkOperation =
    *   await client.users.bulk.setPreferences({
    *     preferences: {
+   *       __persistence_strategy__: 'merge',
    *       categories: {
    *         marketing: false,
    *         transactional: { channel_types: { email: false } },

src/resources/users/users.ts

@@ -295,15 +295,18 @@ export class Users extends APIResource {
   }
 
   /**
-   * Updates a complete preference set for a user. This is a destructive operation
-   * that will replace the existing preference set for the user.
+   * Updates a complete preference set for a user. By default, this is a destructive
+   * operation and will replace any existing preferences with the preferences given.
+   * Use '**persistence_strategy**': 'merge' to merge with existing preferences
+   * instead.
    *
    * @example
    * ```ts
    * const preferenceSet = await client.users.setPreferences(
    *   'user_id',
    *   'default',
    *   {
+   *     __persistence_strategy__: 'merge',
    *     categories: {
    *       marketing: false,
    *       transactional: { channel_types: { email: false } },
@@ -743,6 +746,12 @@ export interface UserSetChannelDataParams {
 }
 
 export interface UserSetPreferencesParams {
+  /**
+   * Controls how the preference set is persisted. 'replace' will completely replace
+   * the preference set, 'merge' will merge with existing preferences.
+   */
+  __persistence_strategy__?: 'merge' | 'replace';
+
   /**
    * An object where the key is the category and the values are the preference
    * settings for that category.

src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.11.8'; // x-release-please-version
+export const VERSION = '1.12.0'; // x-release-please-version