@kard-financial/sdk 28.1.0 → 29.0.0

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.1.0";
+export declare const SDK_VERSION = "29.0.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.1.0";
+exports.SDK_VERSION = "29.0.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.1.0",
-        "User-Agent": "@kard-financial/sdk/28.1.0",
+        "X-Fern-SDK-Version": "29.0.0",
+        "User-Agent": "@kard-financial/sdk/29.0.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/esm/api/resources/commons/types/NotificationType.d.mts

@@ -6,5 +6,7 @@ export declare const NotificationType: {
     readonly Clawback: "clawback";
     readonly AuditUpdate: "auditUpdate";
     readonly FileProcessingResult: "fileProcessingResult";
+    readonly PushNotificationPlacementFile: "pushNotificationPlacementFile";
+    readonly EmailNotificationPlacementFile: "emailNotificationPlacementFile";
 };
 export type NotificationType = (typeof NotificationType)[keyof typeof NotificationType];

package/dist/esm/api/resources/commons/types/NotificationType.mjs

@@ -7,4 +7,6 @@ export const NotificationType = {
     Clawback: "clawback",
     AuditUpdate: "auditUpdate",
     FileProcessingResult: "fileProcessingResult",
+    PushNotificationPlacementFile: "pushNotificationPlacementFile",
+    EmailNotificationPlacementFile: "emailNotificationPlacementFile",
 };

package/dist/esm/api/resources/notifications/types/EmailNotificationPlacementFileAttributes.d.mts

@@ -0,0 +1,12 @@
+export interface EmailNotificationPlacementFileAttributes {
+    /** The display name of the placement */
+    name: string;
+    /** The issuer organization ID the placement belongs to */
+    organizationId: string;
+    /** The number of offer slots available in the placement */
+    availableSlots: number;
+    /** The delivery cadence of the placement (e.g. MONTHLY) */
+    cadence: string;
+    /** Presigned URL to download the generated placement file (gzipped JSONL) */
+    downloadUrl: string;
+}

package/dist/esm/api/resources/notifications/types/EmailNotificationPlacementFileData.d.mts

@@ -0,0 +1,7 @@
+import type * as KardApi from "../../../index.mjs";
+export interface EmailNotificationPlacementFileData {
+    /** The placement ID, also used as the notification resource ID */
+    id: string;
+    attributes: KardApi.EmailNotificationPlacementFileAttributes;
+    relationships: KardApi.EmailNotificationPlacementFileRelationships;
+}

package/dist/esm/api/resources/notifications/types/EmailNotificationPlacementFileRelationships.d.mts

@@ -0,0 +1,5 @@
+import type * as KardApi from "../../../index.mjs";
+export interface EmailNotificationPlacementFileRelationships {
+    placement: KardApi.RelationshipSingle;
+    contentStrategy?: KardApi.RelationshipSingle | undefined;
+}

package/dist/esm/api/resources/notifications/types/NotificationDataUnion.d.mts

@@ -1,5 +1,5 @@
 import type * as KardApi from "../../../index.mjs";
-export type NotificationDataUnion = KardApi.NotificationDataUnion.EarnedRewardApproved | KardApi.NotificationDataUnion.EarnedRewardSettled | KardApi.NotificationDataUnion.ValidTransaction | KardApi.NotificationDataUnion.FailedTransaction | KardApi.NotificationDataUnion.Clawback | KardApi.NotificationDataUnion.AuditUpdate | KardApi.NotificationDataUnion.FileProcessingResult;
+export type NotificationDataUnion = KardApi.NotificationDataUnion.EarnedRewardApproved | KardApi.NotificationDataUnion.EarnedRewardSettled | KardApi.NotificationDataUnion.ValidTransaction | KardApi.NotificationDataUnion.FailedTransaction | KardApi.NotificationDataUnion.Clawback | KardApi.NotificationDataUnion.AuditUpdate | KardApi.NotificationDataUnion.FileProcessingResult | KardApi.NotificationDataUnion.PushNotificationPlacementFile | KardApi.NotificationDataUnion.EmailNotificationPlacementFile;
 export declare namespace NotificationDataUnion {
     interface EarnedRewardApproved extends KardApi.EarnedRewardApprovedData {
         type: "earnedRewardApproved";
@@ -22,4 +22,10 @@ export declare namespace NotificationDataUnion {
     interface FileProcessingResult extends KardApi.FileResultData {
         type: "fileProcessingResult";
     }
+    interface PushNotificationPlacementFile extends KardApi.PushNotificationPlacementFileData {
+        type: "pushNotificationPlacementFile";
+    }
+    interface EmailNotificationPlacementFile extends KardApi.EmailNotificationPlacementFileData {
+        type: "emailNotificationPlacementFile";
+    }
 }

package/dist/esm/api/resources/notifications/types/NotificationPayload.d.mts

@@ -269,6 +269,63 @@ import type * as KardApi from "../../../index.mjs";
  *             }
  *         }
  *     }
+ *
+ * @example
+ *     {
+ *         data: {
+ *             type: "pushNotificationPlacementFile",
+ *             id: "669e3823-1688-4d6e-b46e-cf1999d4a25d",
+ *             attributes: {
+ *                 placementName: "Top gas cashback",
+ *                 availableSlots: 3,
+ *                 cadence: "WEEKLY",
+ *                 downloadUrl: "https://example.com/placements/669e3823-1688-4d6e-b46e-cf1999d4a25d.jsonl.gz"
+ *             },
+ *             relationships: {
+ *                 placement: {
+ *                     data: {
+ *                         type: "placement",
+ *                         id: "669e3823-1688-4d6e-b46e-cf1999d4a25d"
+ *                     }
+ *                 },
+ *                 contentStrategy: {
+ *                     data: {
+ *                         type: "contentStrategy",
+ *                         id: "8df56d4f-0dbf-47ab-b081-0c6534dddd34"
+ *                     }
+ *                 }
+ *             }
+ *         }
+ *     }
+ *
+ * @example
+ *     {
+ *         data: {
+ *             type: "emailNotificationPlacementFile",
+ *             id: "0192a1b2-c3d4-7e8f-9012-3456789abc01",
+ *             attributes: {
+ *                 name: "Monthly Top Cashback Email",
+ *                 organizationId: "00004321",
+ *                 availableSlots: 3,
+ *                 cadence: "MONTHLY",
+ *                 downloadUrl: "https://example.com/placements/0192a1b2-c3d4-7e8f-9012-3456789abc01.jsonl.gz"
+ *             },
+ *             relationships: {
+ *                 placement: {
+ *                     data: {
+ *                         type: "placement",
+ *                         id: "0192a1b2-c3d4-7e8f-9012-aaaa5678cccc"
+ *                     }
+ *                 },
+ *                 contentStrategy: {
+ *                     data: {
+ *                         type: "contentStrategy",
+ *                         id: "8df56d4f-0dbf-47ab-b081-0c6534dddd34"
+ *                     }
+ *                 }
+ *             }
+ *         }
+ *     }
  */
 export interface NotificationPayload {
     data: KardApi.NotificationDataUnion;

package/dist/esm/api/resources/notifications/types/PushNotificationPlacementFileAttributes.d.mts

@@ -0,0 +1,10 @@
+export interface PushNotificationPlacementFileAttributes {
+    /** The display name of the placement */
+    placementName: string;
+    /** The number of offer slots available in the placement */
+    availableSlots: number;
+    /** The delivery cadence of the placement (e.g. WEEKLY) */
+    cadence: string;
+    /** Presigned URL to download the generated placement file (gzipped JSONL) */
+    downloadUrl: string;
+}

package/dist/esm/api/resources/notifications/types/PushNotificationPlacementFileData.d.mts

@@ -0,0 +1,7 @@
+import type * as KardApi from "../../../index.mjs";
+export interface PushNotificationPlacementFileData {
+    /** The placement ID, also used as the notification resource ID */
+    id: string;
+    attributes: KardApi.PushNotificationPlacementFileAttributes;
+    relationships: KardApi.PushNotificationPlacementFileRelationships;
+}

package/dist/esm/api/resources/notifications/types/PushNotificationPlacementFileRelationships.d.mts

@@ -0,0 +1,5 @@
+import type * as KardApi from "../../../index.mjs";
+export interface PushNotificationPlacementFileRelationships {
+    placement: KardApi.RelationshipSingle;
+    contentStrategy?: KardApi.RelationshipSingle | undefined;
+}

package/dist/esm/api/resources/notifications/types/index.d.mts

@@ -6,6 +6,9 @@ export * from "./EarnedRewardApprovedData.mjs";
 export * from "./EarnedRewardRelationships.mjs";
 export * from "./EarnedRewardSettledAttributes.mjs";
 export * from "./EarnedRewardSettledData.mjs";
+export * from "./EmailNotificationPlacementFileAttributes.mjs";
+export * from "./EmailNotificationPlacementFileData.mjs";
+export * from "./EmailNotificationPlacementFileRelationships.mjs";
 export * from "./FailedTransactionAttributes.mjs";
 export * from "./FailedTransactionData.mjs";
 export * from "./FailedTransactionRelationships.mjs";
@@ -13,6 +16,9 @@ export * from "./FileResultData.mjs";
 export * from "./NotificationDataUnion.mjs";
 export * from "./NotificationMetadata.mjs";
 export * from "./NotificationPayload.mjs";
+export * from "./PushNotificationPlacementFileAttributes.mjs";
+export * from "./PushNotificationPlacementFileData.mjs";
+export * from "./PushNotificationPlacementFileRelationships.mjs";
 export * from "./RewardNotificationAttributes.mjs";
 export * from "./TransactionRelationships.mjs";
 export * from "./ValidTransactionAttributes.mjs";

package/dist/esm/api/resources/notifications/types/index.mjs

@@ -6,6 +6,9 @@ export * from "./EarnedRewardApprovedData.mjs";
 export * from "./EarnedRewardRelationships.mjs";
 export * from "./EarnedRewardSettledAttributes.mjs";
 export * from "./EarnedRewardSettledData.mjs";
+export * from "./EmailNotificationPlacementFileAttributes.mjs";
+export * from "./EmailNotificationPlacementFileData.mjs";
+export * from "./EmailNotificationPlacementFileRelationships.mjs";
 export * from "./FailedTransactionAttributes.mjs";
 export * from "./FailedTransactionData.mjs";
 export * from "./FailedTransactionRelationships.mjs";
@@ -13,6 +16,9 @@ export * from "./FileResultData.mjs";
 export * from "./NotificationDataUnion.mjs";
 export * from "./NotificationMetadata.mjs";
 export * from "./NotificationPayload.mjs";
+export * from "./PushNotificationPlacementFileAttributes.mjs";
+export * from "./PushNotificationPlacementFileData.mjs";
+export * from "./PushNotificationPlacementFileRelationships.mjs";
 export * from "./RewardNotificationAttributes.mjs";
 export * from "./TransactionRelationships.mjs";
 export * from "./ValidTransactionAttributes.mjs";

package/dist/esm/api/resources/organizations/resources/placements/client/Client.d.mts

@@ -11,7 +11,7 @@ export declare class PlacementsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<PlacementsClient.Options>;
     constructor(options?: PlacementsClient.Options);
     /**
-     * Create a placement for the organization. Use type "placementMainPage" for main-page placements (requires name and availableSlots) or "placementPushNotification" for push-notification placements (requires name and cadence; availableSlots is automatically set to 1).
+     * Create a placement for the organization. Use type "placement" for standard placements (requires name and availableSlots), "placementPushNotification" for push-notification placements (requires name and cadence; availableSlots is automatically set to 1), "placementEmail" for email placements (requires name, cadence, and availableSlots), "placementBatchActivation" for batch-activation placements (requires name, refreshInterval, and slots), or "placementGroup" for group placements (requires name and slots).
      *
      * @param {string} organizationId - Unique identifier of the organization
      * @param {KardApi.organizations.CreatePlacementRequestBody} request
@@ -26,7 +26,7 @@ export declare class PlacementsClient {
      * @example
      *     await client.organizations.placements.create("org-123", {
      *         data: {
-     *             type: "placementMainPage",
+     *             type: "placement",
      *             attributes: {
      *                 name: "Homepage Banner",
      *                 availableSlots: 5
@@ -47,6 +47,53 @@ export declare class PlacementsClient {
      *             }
      *         }
      *     })
+     *
+     * @example
+     *     await client.organizations.placements.create("org-123", {
+     *         data: {
+     *             type: "placementEmail",
+     *             attributes: {
+     *                 name: "Weekly Deals Email",
+     *                 availableSlots: 10,
+     *                 cadence: {
+     *                     frequency: "WEEKLY",
+     *                     timeOfDay: "10:00",
+     *                     dayOfWeek: "MON"
+     *                 }
+     *             }
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.organizations.placements.create("org-123", {
+     *         data: {
+     *             type: "placementBatchActivation",
+     *             attributes: {
+     *                 name: "Weekly Cohort",
+     *                 refreshInterval: "P7D",
+     *                 slots: [{
+     *                         placementId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+     *                         alias: "primary",
+     *                         shortDescription: "Featured deals refreshed each week"
+     *                     }]
+     *             }
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.organizations.placements.create("org-123", {
+     *         data: {
+     *             type: "placementGroup",
+     *             attributes: {
+     *                 name: "Seasonal Collection",
+     *                 slots: [{
+     *                         placementId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+     *                         alias: "primary",
+     *                         shortDescription: "Seasonal picks"
+     *                     }]
+     *             }
+     *         }
+     *     })
      */
     create(organizationId: string, request: KardApi.organizations.CreatePlacementRequestBody, requestOptions?: PlacementsClient.RequestOptions): core.HttpResponsePromise<KardApi.organizations.PlacementFormatUnion>;
     private __create;
@@ -87,7 +134,7 @@ export declare class PlacementsClient {
     get(organizationId: string, placementId: string, request?: KardApi.organizations.GetPlacementRequest, requestOptions?: PlacementsClient.RequestOptions): core.HttpResponsePromise<KardApi.organizations.PlacementResource>;
     private __get;
     /**
-     * Replace a placement. All fields must be provided. Use type "placementMainPage" or "placementPushNotification" to set the placement kind. If the type is "placementPushNotification", availableSlots is automatically set to 1.
+     * Replace a placement. All fields must be provided. Use type "placement", "placementPushNotification", "placementEmail", "placementBatchActivation", or "placementGroup" to set the placement kind. If the type is "placementPushNotification", availableSlots is automatically set to 1.
      *
      * @param {string} organizationId - Unique identifier of the organization
      * @param {string} placementId - Unique identifier of the placement (UUID v7)
@@ -103,7 +150,7 @@ export declare class PlacementsClient {
      * @example
      *     await client.organizations.placements.update("organizationId", "placementId", {
      *         data: {
-     *             type: "placementMainPage",
+     *             type: "placement",
      *             attributes: {
      *                 name: "name",
      *                 availableSlots: 1

package/dist/esm/api/resources/organizations/resources/placements/client/Client.mjs

@@ -20,7 +20,7 @@ export class PlacementsClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
-     * Create a placement for the organization. Use type "placementMainPage" for main-page placements (requires name and availableSlots) or "placementPushNotification" for push-notification placements (requires name and cadence; availableSlots is automatically set to 1).
+     * Create a placement for the organization. Use type "placement" for standard placements (requires name and availableSlots), "placementPushNotification" for push-notification placements (requires name and cadence; availableSlots is automatically set to 1), "placementEmail" for email placements (requires name, cadence, and availableSlots), "placementBatchActivation" for batch-activation placements (requires name, refreshInterval, and slots), or "placementGroup" for group placements (requires name and slots).
      *
      * @param {string} organizationId - Unique identifier of the organization
      * @param {KardApi.organizations.CreatePlacementRequestBody} request
@@ -35,7 +35,7 @@ export class PlacementsClient {
      * @example
      *     await client.organizations.placements.create("org-123", {
      *         data: {
-     *             type: "placementMainPage",
+     *             type: "placement",
      *             attributes: {
      *                 name: "Homepage Banner",
      *                 availableSlots: 5
@@ -56,6 +56,53 @@ export class PlacementsClient {
      *             }
      *         }
      *     })
+     *
+     * @example
+     *     await client.organizations.placements.create("org-123", {
+     *         data: {
+     *             type: "placementEmail",
+     *             attributes: {
+     *                 name: "Weekly Deals Email",
+     *                 availableSlots: 10,
+     *                 cadence: {
+     *                     frequency: "WEEKLY",
+     *                     timeOfDay: "10:00",
+     *                     dayOfWeek: "MON"
+     *                 }
+     *             }
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.organizations.placements.create("org-123", {
+     *         data: {
+     *             type: "placementBatchActivation",
+     *             attributes: {
+     *                 name: "Weekly Cohort",
+     *                 refreshInterval: "P7D",
+     *                 slots: [{
+     *                         placementId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+     *                         alias: "primary",
+     *                         shortDescription: "Featured deals refreshed each week"
+     *                     }]
+     *             }
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.organizations.placements.create("org-123", {
+     *         data: {
+     *             type: "placementGroup",
+     *             attributes: {
+     *                 name: "Seasonal Collection",
+     *                 slots: [{
+     *                         placementId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+     *                         alias: "primary",
+     *                         shortDescription: "Seasonal picks"
+     *                     }]
+     *             }
+     *         }
+     *     })
      */
     create(organizationId, request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__create(organizationId, request, requestOptions));
@@ -248,7 +295,7 @@ export class PlacementsClient {
         });
     }
     /**
-     * Replace a placement. All fields must be provided. Use type "placementMainPage" or "placementPushNotification" to set the placement kind. If the type is "placementPushNotification", availableSlots is automatically set to 1.
+     * Replace a placement. All fields must be provided. Use type "placement", "placementPushNotification", "placementEmail", "placementBatchActivation", or "placementGroup" to set the placement kind. If the type is "placementPushNotification", availableSlots is automatically set to 1.
      *
      * @param {string} organizationId - Unique identifier of the organization
      * @param {string} placementId - Unique identifier of the placement (UUID v7)
@@ -264,7 +311,7 @@ export class PlacementsClient {
      * @example
      *     await client.organizations.placements.update("organizationId", "placementId", {
      *         data: {
-     *             type: "placementMainPage",
+     *             type: "placement",
      *             attributes: {
      *                 name: "name",
      *                 availableSlots: 1

package/dist/esm/api/resources/organizations/resources/placements/client/requests/GetPlacementRequest.d.mts

@@ -3,6 +3,6 @@
  *     {}
  */
 export interface GetPlacementRequest {
-    /** CSV list of related resources to embed in the `included` array. Supported paths: `contentStrategy` (the direct content strategy of a non-batch placement), `slots` (the slot resources of a batch-activation placement), `slots.placement` (and the placement each slot references), and `slots.placement.contentStrategy` (and the content strategy of each referenced placement). Dotted paths implicitly include all intermediate resources. */
+    /** CSV list of related resources to embed in the `included` array. Supported paths: `contentStrategy` (the direct content strategy of a non-batch placement), `slots` (the slot resources of a batch-activation or group placement), `slots.placement` (and the placement each slot references), and `slots.placement.contentStrategy` (and the content strategy of each referenced placement). Dotted paths implicitly include all intermediate resources. */
     include?: string;
 }

package/dist/esm/api/resources/organizations/resources/placements/client/requests/ListPlacementsRequest.d.mts

@@ -4,13 +4,13 @@ import type * as KardApi from "../../../../../../index.mjs";
  *     {}
  */
 export interface ListPlacementsRequest {
-    /** Filter by placement type (placementMainPage or placementPushNotification) */
+    /** Filter by placement type (placement, placementPushNotification, placementEmail, placementBatchActivation, or placementGroup) */
     "filter[type]"?: KardApi.organizations.PlacementTypeFilter;
     /** Filter by exact placement name (unique within an organization per type) */
     "filter[name]"?: string;
     /** Filter by the ID of the content strategy linked to the placement */
     "filter[contentStrategyId]"?: string;
-    /** CSV list of related resources to embed in the `included` array. Supported paths: `contentStrategy` (the direct content strategy of a non-batch placement), `slots` (the slot resources of a batch-activation placement), `slots.placement` (and the placement each slot references), and `slots.placement.contentStrategy` (and the content strategy of each referenced placement). Dotted paths implicitly include all intermediate resources. */
+    /** CSV list of related resources to embed in the `included` array. Supported paths: `contentStrategy` (the direct content strategy of a non-batch placement), `slots` (the slot resources of a batch-activation or group placement), `slots.placement` (and the placement each slot references), and `slots.placement.contentStrategy` (and the content strategy of each referenced placement). Dotted paths implicitly include all intermediate resources. */
     include?: string;
     /** Cursor value for the next page of results */
     "page[after]"?: string;

package/dist/esm/api/resources/organizations/resources/placements/types/BatchActivationPlacementData.d.mts

@@ -7,5 +7,5 @@ export interface BatchActivationPlacementData {
     id: string;
     attributes: KardApi.organizations.BatchActivationPlacementAttributes;
     /** JSON:API relationships for the placement. Always present on a batch-activation placement; the `slots` to-many relationship lists the slot resource identifiers. */
-    relationships: KardApi.organizations.BatchActivationPlacementRelationships;
+    relationships: KardApi.organizations.SlottedPlacementRelationships;
 }

package/dist/esm/api/resources/organizations/resources/placements/types/Cadence.d.mts

@@ -1,6 +1,6 @@
 import type * as KardApi from "../../../../../index.mjs";
 /**
- * Cadence schedule for push notification placements
+ * Cadence schedule for push notification and email placements
  */
 export interface Cadence {
     /** Delivery frequency */

package/dist/esm/api/resources/organizations/resources/placements/types/CadenceFrequency.d.mts

@@ -1,4 +1,4 @@
-/** How often a push notification placement delivers */
+/** How often a push notification or email placement delivers */
 export declare const CadenceFrequency: {
     readonly Daily: "DAILY";
     readonly Weekly: "WEEKLY";

package/dist/esm/api/resources/organizations/resources/placements/types/CadenceFrequency.mjs

@@ -1,5 +1,5 @@
 // This file was auto-generated by Fern from our API Definition.
-/** How often a push notification placement delivers */
+/** How often a push notification or email placement delivers */
 export const CadenceFrequency = {
     Daily: "DAILY",
     Weekly: "WEEKLY",

package/dist/esm/api/resources/organizations/resources/placements/types/CreateBatchActivationSlot.d.mts

@@ -1,5 +1,5 @@
 /**
- * A slot in a batch-activation placement at creation time
+ * A slot in a batch-activation or group placement at creation time
  */
 export interface CreateBatchActivationSlot {
     /** ID of another placement that fills this slot. The referenced placement provides both the content strategy and the limit on the number of offers available to the slot. */

package/dist/esm/api/resources/organizations/resources/placements/types/CreateEmailAttributes.d.mts

@@ -0,0 +1,25 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Attributes for creating an email placement
+ *
+ * @example
+ *     {
+ *         name: "Weekly Deals Email",
+ *         availableSlots: 10,
+ *         cadence: {
+ *             frequency: KardApi.organizations.CadenceFrequency.Weekly,
+ *             timeOfDay: "10:00",
+ *             dayOfWeek: KardApi.organizations.DayOfWeek.Mon
+ *         }
+ *     }
+ */
+export interface CreateEmailAttributes {
+    /** 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 */
+    contentStrategyId?: string | undefined;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/CreateEmailPlacementData.d.mts

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Data for creating an email placement
+ */
+export interface CreateEmailPlacementData {
+    /** Email placement attributes for creation */
+    attributes: KardApi.organizations.CreateEmailAttributes;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/CreateEmailPlacementData.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/organizations/resources/placements/types/CreateGroupAttributes.d.mts

@@ -0,0 +1,20 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Attributes for creating a group placement
+ *
+ * @example
+ *     {
+ *         name: "Seasonal Collection",
+ *         slots: [{
+ *                 placementId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+ *                 alias: "primary",
+ *                 shortDescription: "Seasonal picks"
+ *             }]
+ *     }
+ */
+export interface CreateGroupAttributes {
+    /** Name of the placement */
+    name: string;
+    /** Slots that make up the group */
+    slots: KardApi.organizations.CreateBatchActivationSlot[];
+}

package/dist/esm/api/resources/organizations/resources/placements/types/CreateGroupAttributes.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/organizations/resources/placements/types/CreateGroupPlacementData.d.mts

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Data for creating a group placement
+ */
+export interface CreateGroupPlacementData {
+    /** Group placement attributes for creation */
+    attributes: KardApi.organizations.CreateGroupAttributes;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/CreateGroupPlacementData.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};