@kard-financial/sdk 28.2.0 → 29.1.0

package/dist/cjs/api/resources/organizations/resources/placements/types/PlacementFormatUnion.d.ts

@@ -4,7 +4,7 @@ import type * as KardApi from "../../../../../index.js";
  *
  * @example
  *     {
- *         type: "placementMainPage",
+ *         type: "placement",
  *         id: "01961e5a-b74c-7d42-8456-d3a1f2c90e71",
  *         attributes: {
  *             name: "Homepage Banner",
@@ -29,6 +29,22 @@ import type * as KardApi from "../../../../../index.js";
  *
  * @example
  *     {
+ *         type: "placementEmail",
+ *         id: "01961e5a-f37a-7b55-9d6a-2be8d1ac5f78",
+ *         attributes: {
+ *             name: "Weekly Deals Email",
+ *             organizationId: "org-123",
+ *             availableSlots: 10,
+ *             cadence: {
+ *                 frequency: KardApi.organizations.CadenceFrequency.Weekly,
+ *                 timeOfDay: "10:00",
+ *                 dayOfWeek: KardApi.organizations.DayOfWeek.Mon
+ *             }
+ *         }
+ *     }
+ *
+ * @example
+ *     {
  *         type: "placementBatchActivation",
  *         id: "01961e5a-d94e-7c22-ac3f-f8b5a7e92c45",
  *         attributes: {
@@ -45,16 +61,40 @@ import type * as KardApi from "../../../../../index.js";
  *             }
  *         }
  *     }
+ *
+ * @example
+ *     {
+ *         type: "placementGroup",
+ *         id: "01961e5a-a48b-7e66-8c7b-3cf9e2bd6a89",
+ *         attributes: {
+ *             name: "Seasonal Collection",
+ *             organizationId: "org-123"
+ *         },
+ *         relationships: {
+ *             slots: {
+ *                 data: [{
+ *                         type: "batchActivationSlot",
+ *                         id: "01961e5a-b59c-7f77-9d8c-4d0af3ce7b9a"
+ *                     }]
+ *             }
+ *         }
+ *     }
  */
-export type PlacementFormatUnion = KardApi.organizations.PlacementFormatUnion.PlacementMainPage | KardApi.organizations.PlacementFormatUnion.PlacementPushNotification | KardApi.organizations.PlacementFormatUnion.PlacementBatchActivation;
+export type PlacementFormatUnion = KardApi.organizations.PlacementFormatUnion.Placement | KardApi.organizations.PlacementFormatUnion.PlacementPushNotification | KardApi.organizations.PlacementFormatUnion.PlacementEmail | KardApi.organizations.PlacementFormatUnion.PlacementBatchActivation | KardApi.organizations.PlacementFormatUnion.PlacementGroup;
 export declare namespace PlacementFormatUnion {
-    interface PlacementMainPage extends KardApi.organizations.MainPagePlacementData {
-        type: "placementMainPage";
+    interface Placement extends KardApi.organizations.PlacementData {
+        type: "placement";
     }
     interface PlacementPushNotification extends KardApi.organizations.PushNotificationPlacementData {
         type: "placementPushNotification";
     }
+    interface PlacementEmail extends KardApi.organizations.EmailPlacementData {
+        type: "placementEmail";
+    }
     interface PlacementBatchActivation extends KardApi.organizations.BatchActivationPlacementData {
         type: "placementBatchActivation";
     }
+    interface PlacementGroup extends KardApi.organizations.GroupPlacementData {
+        type: "placementGroup";
+    }
 }

package/dist/cjs/api/resources/organizations/resources/placements/types/PlacementListResponse.d.ts

@@ -5,7 +5,7 @@ import type * as KardApi from "../../../../../index.js";
 export interface PlacementListResponse {
     /** Array of placement resources */
     data: KardApi.organizations.PlacementFormatUnion[];
-    /** Related resources requested via the `include` query parameter. Each entry is keyed by its `type` discriminant (`contentStrategy`, `batchActivationSlot`, `placementMainPage`, `placementPushNotification`). */
+    /** Related resources requested via the `include` query parameter. Each entry is keyed by its `type` discriminant (`contentStrategy`, `batchActivationSlot`, `placement`, `placementPushNotification`, `placementEmail`). */
     included?: KardApi.organizations.IncludedResource[] | undefined;
     links?: KardApi.Links | undefined;
     /** Pagination metadata */

package/dist/cjs/api/resources/organizations/resources/placements/types/PlacementResource.d.ts

@@ -5,6 +5,6 @@ import type * as KardApi from "../../../../../index.js";
 export interface PlacementResource {
     /** Placement resource */
     data: KardApi.organizations.PlacementFormatUnion;
-    /** Related resources requested via the `include` query parameter. Each entry is keyed by its `type` discriminant (`contentStrategy`, `batchActivationSlot`, `placementMainPage`, `placementPushNotification`). */
+    /** Related resources requested via the `include` query parameter. Each entry is keyed by its `type` discriminant (`contentStrategy`, `batchActivationSlot`, `placement`, `placementPushNotification`, `placementEmail`). */
     included?: KardApi.organizations.IncludedResource[] | undefined;
 }

package/dist/cjs/api/resources/organizations/resources/placements/types/PlacementTypeFilter.d.ts

@@ -1,7 +1,9 @@
 /** Placement type discriminator used as a list filter */
 export declare const PlacementTypeFilter: {
-    readonly PlacementMainPage: "placementMainPage";
+    readonly Placement: "placement";
     readonly PlacementPushNotification: "placementPushNotification";
+    readonly PlacementEmail: "placementEmail";
     readonly PlacementBatchActivation: "placementBatchActivation";
+    readonly PlacementGroup: "placementGroup";
 };
 export type PlacementTypeFilter = (typeof PlacementTypeFilter)[keyof typeof PlacementTypeFilter];

package/dist/cjs/api/resources/organizations/resources/placements/types/PlacementTypeFilter.js

@@ -4,7 +4,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PlacementTypeFilter = void 0;
 /** Placement type discriminator used as a list filter */
 exports.PlacementTypeFilter = {
-    PlacementMainPage: "placementMainPage",
+    Placement: "placement",
     PlacementPushNotification: "placementPushNotification",
+    PlacementEmail: "placementEmail",
     PlacementBatchActivation: "placementBatchActivation",
+    PlacementGroup: "placementGroup",
 };

package/dist/cjs/api/resources/organizations/resources/placements/types/SlottedPlacementRelationships.d.ts

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Relationship block for a batch-activation or group placement.
+ */
+export interface SlottedPlacementRelationships {
+    /** Resource identifiers for the slots that make up the placement. Each entry corresponds to a `batchActivationSlot` resource that appears in `included` when the request asks for `slots` (or any deeper path that implies it). */
+    slots: KardApi.organizations.ToManyRelationship;
+}

package/dist/cjs/api/resources/organizations/resources/placements/types/SlottedPlacementRelationships.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/organizations/resources/placements/types/UpdateBatchActivationSlot.d.ts

@@ -1,5 +1,5 @@
 /**
- * A slot in a batch-activation placement at update time
+ * A slot in a batch-activation or group placement at update time
  */
 export interface UpdateBatchActivationSlot {
     /** Existing slot identifier. Echo the value from a prior GET to keep the slot stable; omit to mint a fresh slot. If the placementId changes, the slotId is regenerated regardless of what was echoed. */

package/dist/cjs/api/resources/organizations/resources/placements/types/UpdateEmailAttributes.d.ts

@@ -0,0 +1,25 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Attributes for updating an email placement. All fields are required.
+ *
+ * @example
+ *     {
+ *         name: "Updated Email",
+ *         availableSlots: 8,
+ *         cadence: {
+ *             frequency: KardApi.organizations.CadenceFrequency.Monthly,
+ *             timeOfDay: "08:00",
+ *             dayOfMonth: 1
+ *         }
+ *     }
+ */
+export interface UpdateEmailAttributes {
+    /** Name of the placement */
+    name: string;
+    /** Number of available slots (minimum 1) */
+    availableSlots: number;
+    /** Delivery cadence for the email */
+    cadence: KardApi.organizations.Cadence;
+    /** ID of the content strategy to link this placement to. Omit to clear any existing link (PUT requires the full attribute set, so a missing value unlinks the placement). */
+    contentStrategyId?: string | undefined;
+}

package/dist/cjs/api/resources/organizations/resources/placements/types/UpdateEmailAttributes.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/organizations/resources/placements/types/UpdateEmailPlacementData.d.ts

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Data for updating an email placement
+ */
+export interface UpdateEmailPlacementData {
+    /** Email placement attributes for update */
+    attributes: KardApi.organizations.UpdateEmailAttributes;
+}

package/dist/cjs/api/resources/organizations/resources/placements/types/UpdateEmailPlacementData.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/organizations/resources/placements/types/UpdateGroupAttributes.d.ts

@@ -0,0 +1,21 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Attributes for updating a group placement. All fields are required.
+ *
+ * @example
+ *     {
+ *         name: "Updated Collection",
+ *         slots: [{
+ *                 slotId: "01961e5a-b59c-7f77-9d8c-4d0af3ce7b9a",
+ *                 placementId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+ *                 alias: "primary",
+ *                 shortDescription: "Seasonal picks"
+ *             }]
+ *     }
+ */
+export interface UpdateGroupAttributes {
+    /** Name of the placement */
+    name: string;
+    /** Slots that make up the group. Slots present in the prior state but absent from this list are removed. */
+    slots: KardApi.organizations.UpdateBatchActivationSlot[];
+}

package/dist/cjs/api/resources/organizations/resources/placements/types/UpdateGroupAttributes.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/organizations/resources/placements/types/UpdateGroupPlacementData.d.ts

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Data for updating a group placement
+ */
+export interface UpdateGroupPlacementData {
+    /** Group placement attributes for update */
+    attributes: KardApi.organizations.UpdateGroupAttributes;
+}

package/dist/cjs/api/resources/organizations/resources/placements/types/UpdateGroupPlacementData.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/organizations/resources/placements/types/UpdatePlacementDataUnion.d.ts

@@ -2,15 +2,21 @@ import type * as KardApi from "../../../../../index.js";
 /**
  * Discriminated union for updating a placement
  */
-export type UpdatePlacementDataUnion = KardApi.organizations.UpdatePlacementDataUnion.PlacementMainPage | KardApi.organizations.UpdatePlacementDataUnion.PlacementPushNotification | KardApi.organizations.UpdatePlacementDataUnion.PlacementBatchActivation;
+export type UpdatePlacementDataUnion = KardApi.organizations.UpdatePlacementDataUnion.Placement | KardApi.organizations.UpdatePlacementDataUnion.PlacementPushNotification | KardApi.organizations.UpdatePlacementDataUnion.PlacementEmail | KardApi.organizations.UpdatePlacementDataUnion.PlacementBatchActivation | KardApi.organizations.UpdatePlacementDataUnion.PlacementGroup;
 export declare namespace UpdatePlacementDataUnion {
-    interface PlacementMainPage extends KardApi.organizations.UpdateMainPagePlacementData {
-        type: "placementMainPage";
+    interface Placement extends KardApi.organizations.UpdateStandardPlacementData {
+        type: "placement";
     }
     interface PlacementPushNotification extends KardApi.organizations.UpdatePushNotificationPlacementData {
         type: "placementPushNotification";
     }
+    interface PlacementEmail extends KardApi.organizations.UpdateEmailPlacementData {
+        type: "placementEmail";
+    }
     interface PlacementBatchActivation extends KardApi.organizations.UpdateBatchActivationPlacementData {
         type: "placementBatchActivation";
     }
+    interface PlacementGroup extends KardApi.organizations.UpdateGroupPlacementData {
+        type: "placementGroup";
+    }
 }

package/dist/cjs/api/resources/organizations/resources/placements/types/{UpdateMainPageAttributes.d.ts → UpdateStandardAttributes.d.ts}

@@ -1,5 +1,5 @@
 /**
- * Attributes for updating a main-page placement. All fields are required.
+ * Attributes for updating a standard placement. All fields are required.
  *
  * @example
  *     {
@@ -7,7 +7,7 @@
  *         availableSlots: 10
  *     }
  */
-export interface UpdateMainPageAttributes {
+export interface UpdateStandardAttributes {
     /** Name of the placement */
     name: string;
     /** Number of available slots (minimum 1) */

package/dist/cjs/api/resources/organizations/resources/placements/types/UpdateStandardAttributes.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/organizations/resources/placements/types/UpdateStandardPlacementData.d.ts

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Data for updating a standard placement
+ */
+export interface UpdateStandardPlacementData {
+    /** Standard placement attributes for update */
+    attributes: KardApi.organizations.UpdateStandardAttributes;
+}

package/dist/cjs/api/resources/organizations/resources/placements/types/UpdateStandardPlacementData.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/organizations/resources/placements/types/index.d.ts

@@ -1,6 +1,5 @@
 export * from "./BatchActivationPlacementAttributes.js";
 export * from "./BatchActivationPlacementData.js";
-export * from "./BatchActivationPlacementRelationships.js";
 export * from "./BatchActivationSlotAttributes.js";
 export * from "./BatchActivationSlotInclusion.js";
 export * from "./BatchActivationSlotRelationships.js";
@@ -10,16 +9,24 @@ export * from "./ContentStrategyInclusion.js";
 export * from "./CreateBatchActivationAttributes.js";
 export * from "./CreateBatchActivationPlacementData.js";
 export * from "./CreateBatchActivationSlot.js";
-export * from "./CreateMainPageAttributes.js";
-export * from "./CreateMainPagePlacementData.js";
+export * from "./CreateEmailAttributes.js";
+export * from "./CreateEmailPlacementData.js";
+export * from "./CreateGroupAttributes.js";
+export * from "./CreateGroupPlacementData.js";
 export * from "./CreatePlacementDataUnion.js";
 export * from "./CreatePlacementRequestBody.js";
 export * from "./CreatePushNotificationAttributes.js";
 export * from "./CreatePushNotificationPlacementData.js";
+export * from "./CreateStandardAttributes.js";
+export * from "./CreateStandardPlacementData.js";
 export * from "./DayOfWeek.js";
+export * from "./EmailPlacementAttributes.js";
+export * from "./EmailPlacementData.js";
+export * from "./GroupPlacementAttributes.js";
+export * from "./GroupPlacementData.js";
 export * from "./IncludedResource.js";
-export * from "./MainPagePlacementAttributes.js";
-export * from "./MainPagePlacementData.js";
+export * from "./PlacementAttributes.js";
+export * from "./PlacementData.js";
 export * from "./PlacementFormatUnion.js";
 export * from "./PlacementListResponse.js";
 export * from "./PlacementRelationships.js";
@@ -28,14 +35,19 @@ export * from "./PlacementTypeFilter.js";
 export * from "./PushNotificationPlacementAttributes.js";
 export * from "./PushNotificationPlacementData.js";
 export * from "./ResourceIdentifier.js";
+export * from "./SlottedPlacementRelationships.js";
 export * from "./ToManyRelationship.js";
 export * from "./ToOneRelationship.js";
 export * from "./UpdateBatchActivationAttributes.js";
 export * from "./UpdateBatchActivationPlacementData.js";
 export * from "./UpdateBatchActivationSlot.js";
-export * from "./UpdateMainPageAttributes.js";
-export * from "./UpdateMainPagePlacementData.js";
+export * from "./UpdateEmailAttributes.js";
+export * from "./UpdateEmailPlacementData.js";
+export * from "./UpdateGroupAttributes.js";
+export * from "./UpdateGroupPlacementData.js";
 export * from "./UpdatePlacementDataUnion.js";
 export * from "./UpdatePlacementRequestBody.js";
 export * from "./UpdatePushNotificationAttributes.js";
 export * from "./UpdatePushNotificationPlacementData.js";
+export * from "./UpdateStandardAttributes.js";
+export * from "./UpdateStandardPlacementData.js";

package/dist/cjs/api/resources/organizations/resources/placements/types/index.js

@@ -16,7 +16,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./BatchActivationPlacementAttributes.js"), exports);
 __exportStar(require("./BatchActivationPlacementData.js"), exports);
-__exportStar(require("./BatchActivationPlacementRelationships.js"), exports);
 __exportStar(require("./BatchActivationSlotAttributes.js"), exports);
 __exportStar(require("./BatchActivationSlotInclusion.js"), exports);
 __exportStar(require("./BatchActivationSlotRelationships.js"), exports);
@@ -26,16 +25,24 @@ __exportStar(require("./ContentStrategyInclusion.js"), exports);
 __exportStar(require("./CreateBatchActivationAttributes.js"), exports);
 __exportStar(require("./CreateBatchActivationPlacementData.js"), exports);
 __exportStar(require("./CreateBatchActivationSlot.js"), exports);
-__exportStar(require("./CreateMainPageAttributes.js"), exports);
-__exportStar(require("./CreateMainPagePlacementData.js"), exports);
+__exportStar(require("./CreateEmailAttributes.js"), exports);
+__exportStar(require("./CreateEmailPlacementData.js"), exports);
+__exportStar(require("./CreateGroupAttributes.js"), exports);
+__exportStar(require("./CreateGroupPlacementData.js"), exports);
 __exportStar(require("./CreatePlacementDataUnion.js"), exports);
 __exportStar(require("./CreatePlacementRequestBody.js"), exports);
 __exportStar(require("./CreatePushNotificationAttributes.js"), exports);
 __exportStar(require("./CreatePushNotificationPlacementData.js"), exports);
+__exportStar(require("./CreateStandardAttributes.js"), exports);
+__exportStar(require("./CreateStandardPlacementData.js"), exports);
 __exportStar(require("./DayOfWeek.js"), exports);
+__exportStar(require("./EmailPlacementAttributes.js"), exports);
+__exportStar(require("./EmailPlacementData.js"), exports);
+__exportStar(require("./GroupPlacementAttributes.js"), exports);
+__exportStar(require("./GroupPlacementData.js"), exports);
 __exportStar(require("./IncludedResource.js"), exports);
-__exportStar(require("./MainPagePlacementAttributes.js"), exports);
-__exportStar(require("./MainPagePlacementData.js"), exports);
+__exportStar(require("./PlacementAttributes.js"), exports);
+__exportStar(require("./PlacementData.js"), exports);
 __exportStar(require("./PlacementFormatUnion.js"), exports);
 __exportStar(require("./PlacementListResponse.js"), exports);
 __exportStar(require("./PlacementRelationships.js"), exports);
@@ -44,14 +51,19 @@ __exportStar(require("./PlacementTypeFilter.js"), exports);
 __exportStar(require("./PushNotificationPlacementAttributes.js"), exports);
 __exportStar(require("./PushNotificationPlacementData.js"), exports);
 __exportStar(require("./ResourceIdentifier.js"), exports);
+__exportStar(require("./SlottedPlacementRelationships.js"), exports);
 __exportStar(require("./ToManyRelationship.js"), exports);
 __exportStar(require("./ToOneRelationship.js"), exports);
 __exportStar(require("./UpdateBatchActivationAttributes.js"), exports);
 __exportStar(require("./UpdateBatchActivationPlacementData.js"), exports);
 __exportStar(require("./UpdateBatchActivationSlot.js"), exports);
-__exportStar(require("./UpdateMainPageAttributes.js"), exports);
-__exportStar(require("./UpdateMainPagePlacementData.js"), exports);
+__exportStar(require("./UpdateEmailAttributes.js"), exports);
+__exportStar(require("./UpdateEmailPlacementData.js"), exports);
+__exportStar(require("./UpdateGroupAttributes.js"), exports);
+__exportStar(require("./UpdateGroupPlacementData.js"), exports);
 __exportStar(require("./UpdatePlacementDataUnion.js"), exports);
 __exportStar(require("./UpdatePlacementRequestBody.js"), exports);
 __exportStar(require("./UpdatePushNotificationAttributes.js"), exports);
 __exportStar(require("./UpdatePushNotificationPlacementData.js"), exports);
+__exportStar(require("./UpdateStandardAttributes.js"), exports);
+__exportStar(require("./UpdateStandardPlacementData.js"), exports);

package/dist/cjs/api/resources/transactions/types/TransactionsAttributes.d.ts

@@ -56,4 +56,6 @@ export interface TransactionsAttributes {
     userZipCode?: string | undefined;
     /** Network specific merchant IDs (MIDs) associated with the transaction */
     processorMids?: KardApi.ProcessorMid | undefined;
+    /** An account identifier associated to transaction */
+    accountId?: string | undefined;
 }

package/dist/cjs/api/resources/users/resources/rewards/client/Client.d.ts

@@ -57,14 +57,18 @@ export declare class RewardsClient {
     placementOffers(organizationId: KardApi.OrganizationId, userId: KardApi.UserId, placementId: string, request?: KardApi.users.GetOffersByPlacementRequest, requestOptions?: RewardsClient.RequestOptions): core.HttpResponsePromise<KardApi.users.OffersResponseObject>;
     private __placementOffers;
     /**
-     * Retrieve batches for a batch-activation placement. Returns each slot in slot
-     * order with its current offer set, alias, and freshness fields (`isActive`,
-     * `lastActivatedAt`, `expiresAt`). Applies the same per-user eligibility and
-     * per-slot content-strategy filter as Get Offers By Placement, independently
-     * per slot. A slot only flips to `isActive: false` when its refresh interval
-     * has elapsed AND its post-eligibility `offers[]` is non-empty; otherwise the
-     * slot is still returned and stays active so the partner UI does not promote
-     * "refresh" with nothing to show.<br/>
+     * Retrieve batches for a batch-activation or group placement. Returns each
+     * slot in slot order with its current offer set, alias, and freshness fields
+     * (`isActive`, `lastActivatedAt`, `expiresAt`). Applies the same per-user
+     * eligibility and per-slot content-strategy filter as Get Offers By
+     * Placement, independently per slot. For a batch-activation placement, a
+     * slot only flips to `isActive: false` when its refresh interval has elapsed
+     * AND its post-eligibility `offers[]` is non-empty; otherwise the slot is
+     * still returned and stays active so the partner UI does not promote
+     * "refresh" with nothing to show. For a group placement, slots are always
+     * active and each slot returns its offers regardless of activation state,
+     * hiding only offers that require activation (`requiredInBatch`) and have
+     * no activation record.<br/>
      * <b>Required scopes:</b> `rewards:read`
      *
      * @param {KardApi.OrganizationId} organizationId

package/dist/cjs/api/resources/users/resources/rewards/client/Client.js

@@ -215,14 +215,18 @@ class RewardsClient {
         });
     }
     /**
-     * Retrieve batches for a batch-activation placement. Returns each slot in slot
-     * order with its current offer set, alias, and freshness fields (`isActive`,
-     * `lastActivatedAt`, `expiresAt`). Applies the same per-user eligibility and
-     * per-slot content-strategy filter as Get Offers By Placement, independently
-     * per slot. A slot only flips to `isActive: false` when its refresh interval
-     * has elapsed AND its post-eligibility `offers[]` is non-empty; otherwise the
-     * slot is still returned and stays active so the partner UI does not promote
-     * "refresh" with nothing to show.<br/>
+     * Retrieve batches for a batch-activation or group placement. Returns each
+     * slot in slot order with its current offer set, alias, and freshness fields
+     * (`isActive`, `lastActivatedAt`, `expiresAt`). Applies the same per-user
+     * eligibility and per-slot content-strategy filter as Get Offers By
+     * Placement, independently per slot. For a batch-activation placement, a
+     * slot only flips to `isActive: false` when its refresh interval has elapsed
+     * AND its post-eligibility `offers[]` is non-empty; otherwise the slot is
+     * still returned and stays active so the partner UI does not promote
+     * "refresh" with nothing to show. For a group placement, slots are always
+     * active and each slot returns its offers regardless of activation state,
+     * hiding only offers that require activation (`requiredInBatch`) and have
+     * no activation record.<br/>
      * <b>Required scopes:</b> `rewards:read`
      *
      * @param {KardApi.OrganizationId} organizationId

package/dist/cjs/api/resources/users/resources/rewards/types/BatchesResponseObject.d.ts

@@ -1,6 +1,6 @@
 import type * as KardApi from "../../../../../index.js";
 /**
- * Ordered list of slots for a batch-activation placement, with freshness fields and per-slot offer sets.
+ * Ordered list of slots for a batch-activation or group placement, with freshness fields and per-slot offer sets.
  */
 export interface BatchesResponseObject {
     data: KardApi.users.PlacementBatchData[];

package/dist/cjs/api/resources/users/resources/rewards/types/PlacementBatchAttributes.d.ts

@@ -5,13 +5,13 @@ import type * as KardApi from "../../../../../index.js";
 export interface PlacementBatchAttributes {
     /** Display name for the slot. Falls back to the slot's customer-defined alias, or — when the alias is absent — the name of the placement referenced by the slot. */
     name: string;
-    /** Whether the slot is still considered "fresh" for the user. Set to false only when the slot's `expiresAt` is in the past AND the slot resolves to a non-empty offer set; an empty offer set keeps the slot active so partner UIs do not promote "tap to refresh" with nothing to show. */
+    /** Whether the slot is still considered "fresh" for the user. Set to false only when the slot's `expiresAt` is in the past AND the slot resolves to a non-empty offer set; an empty offer set keeps the slot active so partner UIs do not promote "tap to refresh" with nothing to show. Always true for slots of a group placement, which has no activation cycle. */
     isActive: boolean;
     /** Timestamp of the most recent placementSlotAttribution ACTIVATE event for this (user, placement, slot). Absent for cold slots that have never been activated. */
     lastActivatedAt?: string | undefined;
     /** Computed as `lastActivatedAt + placement.refreshInterval`. Absent for cold slots that have never been activated. */
     expiresAt?: string | undefined;
-    /** Slot-level UI components. Carries `shortDescription` and `longDescription` (activation copy derived from the parent placement's `refreshInterval`), plus either a `cta` (POST to the slot's activate endpoint) when the slot has no active (non-expired) activation, or a `logoFlare` decoration when it does — `cta` and `logoFlare` are mutually exclusive on a single slot. */
+    /** Slot-level UI components. Carries `shortDescription` and `longDescription` (activation copy derived from the parent placement's `refreshInterval`), plus either a `cta` (POST to the slot's activate endpoint) when the slot has no active (non-expired) activation, or a `logoFlare` decoration when it does — `cta` and `logoFlare` are mutually exclusive on a single slot. Omitted for slots of a group placement, which has no activation cycle. */
     components?: KardApi.users.OfferComponents | undefined;
     /** Slot-level visual assets. Currently a single `IMG_VIEW` SVG showing the slot's initials, themed via the `--icon-fill` CSS custom property. */
     assets?: KardApi.users.Asset[] | undefined;

package/dist/cjs/api/resources/users/resources/rewards/types/PlacementBatchData.d.ts

@@ -1,6 +1,6 @@
 import type * as KardApi from "../../../../../index.js";
 /**
- * One slot in a batch-activation placement, with freshness fields and the offers that resolve under the slot's content strategy.
+ * One slot in a batch-activation or group placement, with freshness fields and the offers that resolve under the slot's content strategy.
  */
 export interface PlacementBatchData {
     /** Stable identifier for the slot within the placement */

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "28.2.0";
+export declare const SDK_VERSION = "29.1.0";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "28.2.0";
+exports.SDK_VERSION = "29.1.0";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@kard-financial/sdk",
-        "X-Fern-SDK-Version": "28.2.0",
-        "User-Agent": "@kard-financial/sdk/28.2.0",
+        "X-Fern-SDK-Version": "29.1.0",
+        "User-Agent": "@kard-financial/sdk/29.1.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);