@kard-financial/sdk 28.1.0 → 29.0.0

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.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/cjs/api/resources/commons/types/NotificationType.d.ts

@@ -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/cjs/api/resources/commons/types/NotificationType.js

@@ -10,4 +10,6 @@ exports.NotificationType = {
     Clawback: "clawback",
     AuditUpdate: "auditUpdate",
     FileProcessingResult: "fileProcessingResult",
+    PushNotificationPlacementFile: "pushNotificationPlacementFile",
+    EmailNotificationPlacementFile: "emailNotificationPlacementFile",
 };

package/dist/cjs/api/resources/notifications/types/EmailNotificationPlacementFileAttributes.d.ts

@@ -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/cjs/api/resources/notifications/types/EmailNotificationPlacementFileData.d.ts

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

package/dist/cjs/api/resources/notifications/types/EmailNotificationPlacementFileRelationships.d.ts

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

package/dist/cjs/api/resources/notifications/types/NotificationDataUnion.d.ts

@@ -1,5 +1,5 @@
 import type * as KardApi from "../../../index.js";
-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/cjs/api/resources/notifications/types/NotificationPayload.d.ts

@@ -269,6 +269,63 @@ import type * as KardApi from "../../../index.js";
  *             }
  *         }
  *     }
+ *
+ * @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/cjs/api/resources/notifications/types/PushNotificationPlacementFileAttributes.d.ts

@@ -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/cjs/api/resources/notifications/types/PushNotificationPlacementFileData.d.ts

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

package/dist/cjs/api/resources/notifications/types/PushNotificationPlacementFileRelationships.d.ts

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

package/dist/cjs/api/resources/notifications/types/index.d.ts

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

package/dist/cjs/api/resources/notifications/types/index.js

@@ -22,6 +22,9 @@ __exportStar(require("./EarnedRewardApprovedData.js"), exports);
 __exportStar(require("./EarnedRewardRelationships.js"), exports);
 __exportStar(require("./EarnedRewardSettledAttributes.js"), exports);
 __exportStar(require("./EarnedRewardSettledData.js"), exports);
+__exportStar(require("./EmailNotificationPlacementFileAttributes.js"), exports);
+__exportStar(require("./EmailNotificationPlacementFileData.js"), exports);
+__exportStar(require("./EmailNotificationPlacementFileRelationships.js"), exports);
 __exportStar(require("./FailedTransactionAttributes.js"), exports);
 __exportStar(require("./FailedTransactionData.js"), exports);
 __exportStar(require("./FailedTransactionRelationships.js"), exports);
@@ -29,6 +32,9 @@ __exportStar(require("./FileResultData.js"), exports);
 __exportStar(require("./NotificationDataUnion.js"), exports);
 __exportStar(require("./NotificationMetadata.js"), exports);
 __exportStar(require("./NotificationPayload.js"), exports);
+__exportStar(require("./PushNotificationPlacementFileAttributes.js"), exports);
+__exportStar(require("./PushNotificationPlacementFileData.js"), exports);
+__exportStar(require("./PushNotificationPlacementFileRelationships.js"), exports);
 __exportStar(require("./RewardNotificationAttributes.js"), exports);
 __exportStar(require("./TransactionRelationships.js"), exports);
 __exportStar(require("./ValidTransactionAttributes.js"), exports);

package/dist/cjs/api/resources/organizations/resources/placements/client/Client.d.ts

@@ -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/cjs/api/resources/organizations/resources/placements/client/Client.js

@@ -56,7 +56,7 @@ class PlacementsClient {
         this._options = (0, BaseClient_js_1.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
@@ -71,7 +71,7 @@ class PlacementsClient {
      * @example
      *     await client.organizations.placements.create("org-123", {
      *         data: {
-     *             type: "placementMainPage",
+     *             type: "placement",
      *             attributes: {
      *                 name: "Homepage Banner",
      *                 availableSlots: 5
@@ -92,6 +92,53 @@ 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));
@@ -284,7 +331,7 @@ 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)
@@ -300,7 +347,7 @@ class PlacementsClient {
      * @example
      *     await client.organizations.placements.update("organizationId", "placementId", {
      *         data: {
-     *             type: "placementMainPage",
+     *             type: "placement",
      *             attributes: {
      *                 name: "name",
      *                 availableSlots: 1

package/dist/cjs/api/resources/organizations/resources/placements/client/requests/GetPlacementRequest.d.ts

@@ -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/cjs/api/resources/organizations/resources/placements/client/requests/ListPlacementsRequest.d.ts

@@ -4,13 +4,13 @@ import type * as KardApi from "../../../../../../index.js";
  *     {}
  */
 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/cjs/api/resources/organizations/resources/placements/types/BatchActivationPlacementData.d.ts

@@ -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/cjs/api/resources/organizations/resources/placements/types/Cadence.d.ts

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

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

@@ -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/cjs/api/resources/organizations/resources/placements/types/CadenceFrequency.js

@@ -2,7 +2,7 @@
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CadenceFrequency = void 0;
-/** How often a push notification placement delivers */
+/** How often a push notification or email placement delivers */
 exports.CadenceFrequency = {
     Daily: "DAILY",
     Weekly: "WEEKLY",

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

@@ -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/cjs/api/resources/organizations/resources/placements/types/CreateEmailAttributes.d.ts

@@ -0,0 +1,25 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * 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/cjs/api/resources/organizations/resources/placements/types/CreateEmailPlacementData.d.ts

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

package/dist/cjs/api/resources/organizations/resources/placements/types/CreateEmailPlacementData.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/CreateGroupAttributes.d.ts

@@ -0,0 +1,20 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * 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/cjs/api/resources/organizations/resources/placements/types/CreateGroupAttributes.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/CreateGroupPlacementData.d.ts

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

package/dist/cjs/api/resources/organizations/resources/placements/types/CreateGroupPlacementData.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/CreatePlacementDataUnion.d.ts

@@ -2,15 +2,21 @@ import type * as KardApi from "../../../../../index.js";
 /**
  * Discriminated union for creating a placement
  */
-export type CreatePlacementDataUnion = KardApi.organizations.CreatePlacementDataUnion.PlacementMainPage | KardApi.organizations.CreatePlacementDataUnion.PlacementPushNotification | KardApi.organizations.CreatePlacementDataUnion.PlacementBatchActivation;
+export type CreatePlacementDataUnion = KardApi.organizations.CreatePlacementDataUnion.Placement | KardApi.organizations.CreatePlacementDataUnion.PlacementPushNotification | KardApi.organizations.CreatePlacementDataUnion.PlacementEmail | KardApi.organizations.CreatePlacementDataUnion.PlacementBatchActivation | KardApi.organizations.CreatePlacementDataUnion.PlacementGroup;
 export declare namespace CreatePlacementDataUnion {
-    interface PlacementMainPage extends KardApi.organizations.CreateMainPagePlacementData {
-        type: "placementMainPage";
+    interface Placement extends KardApi.organizations.CreateStandardPlacementData {
+        type: "placement";
     }
     interface PlacementPushNotification extends KardApi.organizations.CreatePushNotificationPlacementData {
         type: "placementPushNotification";
     }
+    interface PlacementEmail extends KardApi.organizations.CreateEmailPlacementData {
+        type: "placementEmail";
+    }
     interface PlacementBatchActivation extends KardApi.organizations.CreateBatchActivationPlacementData {
         type: "placementBatchActivation";
     }
+    interface PlacementGroup extends KardApi.organizations.CreateGroupPlacementData {
+        type: "placementGroup";
+    }
 }

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

@@ -5,7 +5,7 @@ import type * as KardApi from "../../../../../index.js";
  * @example
  *     {
  *         data: {
- *             type: "placementMainPage",
+ *             type: "placement",
  *             attributes: {
  *                 name: "Homepage Banner",
  *                 availableSlots: 5
@@ -26,6 +26,53 @@ import type * as KardApi from "../../../../../index.js";
  *             }
  *         }
  *     }
+ *
+ * @example
+ *     {
+ *         data: {
+ *             type: "placementEmail",
+ *             attributes: {
+ *                 name: "Weekly Deals Email",
+ *                 availableSlots: 10,
+ *                 cadence: {
+ *                     frequency: KardApi.organizations.CadenceFrequency.Weekly,
+ *                     timeOfDay: "10:00",
+ *                     dayOfWeek: KardApi.organizations.DayOfWeek.Mon
+ *                 }
+ *             }
+ *         }
+ *     }
+ *
+ * @example
+ *     {
+ *         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
+ *     {
+ *         data: {
+ *             type: "placementGroup",
+ *             attributes: {
+ *                 name: "Seasonal Collection",
+ *                 slots: [{
+ *                         placementId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+ *                         alias: "primary",
+ *                         shortDescription: "Seasonal picks"
+ *                     }]
+ *             }
+ *         }
+ *     }
  */
 export interface CreatePlacementRequestBody {
     /** Placement data for creation */