@kard-financial/sdk 24.1.0 → 25.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": "24.1.0",
-        "User-Agent": "@kard-financial/sdk/24.1.0",
+        "X-Fern-SDK-Version": "25.0.0",
+        "User-Agent": "@kard-financial/sdk/25.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/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 (allowed value is `contentStrategy`). */
+    /** 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. */
     include?: string;
 }

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

@@ -10,7 +10,7 @@ export interface ListPlacementsRequest {
     "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 (allowed value is `contentStrategy`). */
+    /** 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. */
     include?: string;
     /** Cursor value for the next page of results */
     "page[after]"?: string;

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

@@ -1,6 +1,5 @@
-import type * as KardApi from "../../../../../index.js";
 /**
- * Attributes for a batch-activation placement
+ * Attributes for a batch-activation placement. Slot detail is exposed via `relationships.slots` (resource identifiers) and the `batchActivationSlot` entries in `included`; request `?include=slots` (or a deeper path) to get the slot details.
  */
 export interface BatchActivationPlacementAttributes {
     /** Name of the placement */
@@ -9,6 +8,4 @@ export interface BatchActivationPlacementAttributes {
     organizationId: string;
     /** ISO-8601 duration that controls how often the activation cohort refreshes (e.g. "P7D" for weekly). */
     refreshInterval: string;
-    /** Slots that make up the activation cohort */
-    slots: KardApi.organizations.BatchActivationSlot[];
 }

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

@@ -6,4 +6,6 @@ export interface BatchActivationPlacementData {
     /** Unique identifier of the placement (UUID v7) */
     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;
 }

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

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Relationship block for a batch-activation placement.
+ */
+export interface BatchActivationPlacementRelationships {
+    /** Resource identifiers for the slots that make up the activation cohort. 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/BatchActivationSlotAttributes.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Attributes block for a `batchActivationSlot` resource.
+ */
+export interface BatchActivationSlotAttributes {
+    /** Customer-defined alias for the slot, unique within the placement. */
+    alias: string;
+    /** Optional short description of the slot, limited to 50 characters. */
+    shortDescription?: string | undefined;
+}

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

@@ -0,0 +1,9 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Slot resource as it appears in the `included` array.
+ */
+export interface BatchActivationSlotInclusion {
+    id: string;
+    attributes: KardApi.organizations.BatchActivationSlotAttributes;
+    relationships: KardApi.organizations.BatchActivationSlotRelationships;
+}

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

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Relationship block for a `batchActivationSlot` resource.
+ */
+export interface BatchActivationSlotRelationships {
+    /** Reference to the placement that fills this slot. The referenced placement provides the slot's content strategy and offer-count cap; request `?include=slots.placement` to embed it in `included`. */
+    placement: KardApi.organizations.ToOneRelationship;
+}

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

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Content strategy as it appears in the `included` array.
+ */
+export interface ContentStrategyInclusion {
+    id: string;
+    attributes: KardApi.organizations.ContentStrategyAttributes;
+}

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

@@ -7,8 +7,9 @@ import type * as KardApi from "../../../../../index.js";
  *         name: "Weekly Cohort",
  *         refreshInterval: "P7D",
  *         slots: [{
- *                 contentStrategyId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
- *                 alias: "primary"
+ *                 placementId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+ *                 alias: "primary",
+ *                 shortDescription: "Featured deals refreshed each week"
  *             }]
  *     }
  */

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

@@ -2,8 +2,10 @@
  * A slot in a batch-activation placement at creation time
  */
 export interface CreateBatchActivationSlot {
-    /** ID of the content strategy that fills this slot */
-    contentStrategyId: string;
+    /** 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. */
+    placementId: string;
     /** Customer-defined alias for the slot, unique within the placement */
     alias: string;
+    /** Optional short description of the slot, limited to 50 characters */
+    shortDescription?: string | undefined;
 }

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

@@ -0,0 +1,19 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Discriminated union of every resource type that can appear in the `included` array. The shape of each branch matches the corresponding primary-data resource (same attributes and relationships), keyed on the JSON:API `type` discriminant.
+ */
+export type IncludedResource = KardApi.organizations.IncludedResource.ContentStrategy | KardApi.organizations.IncludedResource.BatchActivationSlot | KardApi.organizations.IncludedResource.PlacementMainPage | KardApi.organizations.IncludedResource.PlacementPushNotification;
+export declare namespace IncludedResource {
+    interface ContentStrategy extends KardApi.organizations.ContentStrategyInclusion {
+        type: "contentStrategy";
+    }
+    interface BatchActivationSlot extends KardApi.organizations.BatchActivationSlotInclusion {
+        type: "batchActivationSlot";
+    }
+    interface PlacementMainPage extends KardApi.organizations.MainPagePlacementData {
+        type: "placementMainPage";
+    }
+    interface PlacementPushNotification extends KardApi.organizations.PushNotificationPlacementData {
+        type: "placementPushNotification";
+    }
+}

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

@@ -8,6 +8,6 @@ export interface MainPagePlacementAttributes {
     organizationId: string;
     /** Number of available slots */
     availableSlots: number;
-    /** ID of the content strategy linked to this placement, if any */
+    /** ID of the content strategy linked to this placement, if any. Retained alongside `relationships.contentStrategy` for backward compatibility. */
     contentStrategyId?: string | undefined;
 }

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

@@ -6,4 +6,6 @@ export interface MainPagePlacementData {
     /** Unique identifier of the placement (UUID v7) */
     id: string;
     attributes: KardApi.organizations.MainPagePlacementAttributes;
+    /** JSON:API relationships for the placement. Omitted entirely when the placement has no linked resources. */
+    relationships?: KardApi.organizations.PlacementRelationships | undefined;
 }

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

@@ -34,12 +34,15 @@ import type * as KardApi from "../../../../../index.js";
  *         attributes: {
  *             name: "Weekly Cohort",
  *             organizationId: "org-123",
- *             refreshInterval: "P7D",
- *             slots: [{
- *                     slotId: "01961e5a-e15f-7d33-bd4f-09c6b8fa3d56",
- *                     contentStrategyId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
- *                     alias: "primary"
- *                 }]
+ *             refreshInterval: "P7D"
+ *         },
+ *         relationships: {
+ *             slots: {
+ *                 data: [{
+ *                         type: "batchActivationSlot",
+ *                         id: "01961e5a-e15f-7d33-bd4f-09c6b8fa3d56"
+ *                     }]
+ *             }
  *         }
  *     }
  */

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

@@ -5,8 +5,8 @@ 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. Only populated when `include=contentStrategy` is supplied and at least one placement in `data` is linked to a content strategy. */
-    included?: KardApi.organizations.ContentStrategyResponse[] | undefined;
+    /** Related resources requested via the `include` query parameter. Each entry is keyed by its `type` discriminant (`contentStrategy`, `batchActivationSlot`, `placementMainPage`, `placementPushNotification`). */
+    included?: KardApi.organizations.IncludedResource[] | undefined;
     links?: KardApi.Links | undefined;
     /** Pagination metadata */
     meta?: KardApi.OrganizationPaginationMetadata | undefined;

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

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Relationship block for non-batch placements. Mirrors the `contentStrategyId` attribute so JSON:API clients can walk the graph.
+ */
+export interface PlacementRelationships {
+    /** Relationship to the content strategy that powers this placement. Present whenever the placement has been linked to a content strategy (`data.id` will be set). Omitted entirely when no content strategy is linked. */
+    contentStrategy?: KardApi.organizations.ToOneRelationship | undefined;
+}

package/dist/cjs/api/resources/organizations/resources/placements/types/PlacementRelationships.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/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. Only populated when `include=contentStrategy` is supplied and the placement is linked to a content strategy. */
-    included?: KardApi.organizations.ContentStrategyResponse[] | undefined;
+    /** Related resources requested via the `include` query parameter. Each entry is keyed by its `type` discriminant (`contentStrategy`, `batchActivationSlot`, `placementMainPage`, `placementPushNotification`). */
+    included?: KardApi.organizations.IncludedResource[] | undefined;
 }

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

@@ -9,6 +9,6 @@ export interface PushNotificationPlacementAttributes {
     organizationId: string;
     /** Delivery cadence for the notification */
     cadence: KardApi.organizations.Cadence;
-    /** ID of the content strategy linked to this placement, if any */
+    /** ID of the content strategy linked to this placement, if any. Retained alongside `relationships.contentStrategy` for backward compatibility. */
     contentStrategyId?: string | undefined;
 }

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

@@ -6,4 +6,6 @@ export interface PushNotificationPlacementData {
     /** Unique identifier of the placement (UUID v7) */
     id: string;
     attributes: KardApi.organizations.PushNotificationPlacementAttributes;
+    /** JSON:API relationships for the placement. Omitted entirely when the placement has no linked resources. */
+    relationships?: KardApi.organizations.PlacementRelationships | undefined;
 }

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

@@ -0,0 +1,9 @@
+/**
+ * A reference to another resource by type and id.
+ */
+export interface ResourceIdentifier {
+    /** Discriminant of the referenced resource (e.g. `contentStrategy`). */
+    type: string;
+    /** Identifier of the referenced resource. */
+    id: string;
+}

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

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * A JSON:API to-many relationship payload.
+ */
+export interface ToManyRelationship {
+    /** The linked resource identifiers. */
+    data: KardApi.organizations.ResourceIdentifier[];
+}

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

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * A JSON:API to-one relationship payload.
+ */
+export interface ToOneRelationship {
+    /** The linked resource identifier, or null when the relationship is present but unlinked. */
+    data?: KardApi.organizations.ResourceIdentifier | undefined;
+}

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

@@ -8,8 +8,9 @@ import type * as KardApi from "../../../../../index.js";
  *         refreshInterval: "P14D",
  *         slots: [{
  *                 slotId: "01961e5a-e15f-7d33-bd4f-09c6b8fa3d56",
- *                 contentStrategyId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
- *                 alias: "primary"
+ *                 placementId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+ *                 alias: "primary",
+ *                 shortDescription: "Featured deals refreshed each week"
  *             }]
  *     }
  */

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

@@ -2,10 +2,12 @@
  * A slot in a batch-activation 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 contentStrategyId changes, the slotId is regenerated regardless of what was echoed. */
+    /** 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. */
     slotId?: string | undefined;
-    /** ID of the content strategy that fills this slot */
-    contentStrategyId: string;
+    /** 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. */
+    placementId: string;
     /** Customer-defined alias for the slot, unique within the placement */
     alias: string;
+    /** Optional short description of the slot, limited to 50 characters */
+    shortDescription?: string | undefined;
 }

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

@@ -1,8 +1,12 @@
 export * from "./BatchActivationPlacementAttributes.js";
 export * from "./BatchActivationPlacementData.js";
-export * from "./BatchActivationSlot.js";
+export * from "./BatchActivationPlacementRelationships.js";
+export * from "./BatchActivationSlotAttributes.js";
+export * from "./BatchActivationSlotInclusion.js";
+export * from "./BatchActivationSlotRelationships.js";
 export * from "./Cadence.js";
 export * from "./CadenceFrequency.js";
+export * from "./ContentStrategyInclusion.js";
 export * from "./CreateBatchActivationAttributes.js";
 export * from "./CreateBatchActivationPlacementData.js";
 export * from "./CreateBatchActivationSlot.js";
@@ -13,14 +17,19 @@ export * from "./CreatePlacementRequestBody.js";
 export * from "./CreatePushNotificationAttributes.js";
 export * from "./CreatePushNotificationPlacementData.js";
 export * from "./DayOfWeek.js";
+export * from "./IncludedResource.js";
 export * from "./MainPagePlacementAttributes.js";
 export * from "./MainPagePlacementData.js";
 export * from "./PlacementFormatUnion.js";
 export * from "./PlacementListResponse.js";
+export * from "./PlacementRelationships.js";
 export * from "./PlacementResource.js";
 export * from "./PlacementTypeFilter.js";
 export * from "./PushNotificationPlacementAttributes.js";
 export * from "./PushNotificationPlacementData.js";
+export * from "./ResourceIdentifier.js";
+export * from "./ToManyRelationship.js";
+export * from "./ToOneRelationship.js";
 export * from "./UpdateBatchActivationAttributes.js";
 export * from "./UpdateBatchActivationPlacementData.js";
 export * from "./UpdateBatchActivationSlot.js";

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

@@ -16,9 +16,13 @@ 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("./BatchActivationSlot.js"), exports);
+__exportStar(require("./BatchActivationPlacementRelationships.js"), exports);
+__exportStar(require("./BatchActivationSlotAttributes.js"), exports);
+__exportStar(require("./BatchActivationSlotInclusion.js"), exports);
+__exportStar(require("./BatchActivationSlotRelationships.js"), exports);
 __exportStar(require("./Cadence.js"), exports);
 __exportStar(require("./CadenceFrequency.js"), exports);
+__exportStar(require("./ContentStrategyInclusion.js"), exports);
 __exportStar(require("./CreateBatchActivationAttributes.js"), exports);
 __exportStar(require("./CreateBatchActivationPlacementData.js"), exports);
 __exportStar(require("./CreateBatchActivationSlot.js"), exports);
@@ -29,14 +33,19 @@ __exportStar(require("./CreatePlacementRequestBody.js"), exports);
 __exportStar(require("./CreatePushNotificationAttributes.js"), exports);
 __exportStar(require("./CreatePushNotificationPlacementData.js"), exports);
 __exportStar(require("./DayOfWeek.js"), exports);
+__exportStar(require("./IncludedResource.js"), exports);
 __exportStar(require("./MainPagePlacementAttributes.js"), exports);
 __exportStar(require("./MainPagePlacementData.js"), exports);
 __exportStar(require("./PlacementFormatUnion.js"), exports);
 __exportStar(require("./PlacementListResponse.js"), exports);
+__exportStar(require("./PlacementRelationships.js"), exports);
 __exportStar(require("./PlacementResource.js"), exports);
 __exportStar(require("./PlacementTypeFilter.js"), exports);
 __exportStar(require("./PushNotificationPlacementAttributes.js"), exports);
 __exportStar(require("./PushNotificationPlacementData.js"), exports);
+__exportStar(require("./ResourceIdentifier.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);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "24.1.0";
+export declare const SDK_VERSION = "25.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 = "24.1.0";
+exports.SDK_VERSION = "25.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": "24.1.0",
-        "User-Agent": "@kard-financial/sdk/24.1.0",
+        "X-Fern-SDK-Version": "25.0.0",
+        "User-Agent": "@kard-financial/sdk/25.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/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 (allowed value is `contentStrategy`). */
+    /** 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. */
     include?: string;
 }

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

@@ -10,7 +10,7 @@ export interface ListPlacementsRequest {
     "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 (allowed value is `contentStrategy`). */
+    /** 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. */
     include?: string;
     /** Cursor value for the next page of results */
     "page[after]"?: string;

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

@@ -1,6 +1,5 @@
-import type * as KardApi from "../../../../../index.mjs";
 /**
- * Attributes for a batch-activation placement
+ * Attributes for a batch-activation placement. Slot detail is exposed via `relationships.slots` (resource identifiers) and the `batchActivationSlot` entries in `included`; request `?include=slots` (or a deeper path) to get the slot details.
  */
 export interface BatchActivationPlacementAttributes {
     /** Name of the placement */
@@ -9,6 +8,4 @@ export interface BatchActivationPlacementAttributes {
     organizationId: string;
     /** ISO-8601 duration that controls how often the activation cohort refreshes (e.g. "P7D" for weekly). */
     refreshInterval: string;
-    /** Slots that make up the activation cohort */
-    slots: KardApi.organizations.BatchActivationSlot[];
 }

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

@@ -6,4 +6,6 @@ export interface BatchActivationPlacementData {
     /** Unique identifier of the placement (UUID v7) */
     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;
 }

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

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Relationship block for a batch-activation placement.
+ */
+export interface BatchActivationPlacementRelationships {
+    /** Resource identifiers for the slots that make up the activation cohort. 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/esm/api/resources/organizations/resources/placements/types/BatchActivationSlotAttributes.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Attributes block for a `batchActivationSlot` resource.
+ */
+export interface BatchActivationSlotAttributes {
+    /** Customer-defined alias for the slot, unique within the placement. */
+    alias: string;
+    /** Optional short description of the slot, limited to 50 characters. */
+    shortDescription?: string | undefined;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/BatchActivationSlotAttributes.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/BatchActivationSlotInclusion.d.mts

@@ -0,0 +1,9 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Slot resource as it appears in the `included` array.
+ */
+export interface BatchActivationSlotInclusion {
+    id: string;
+    attributes: KardApi.organizations.BatchActivationSlotAttributes;
+    relationships: KardApi.organizations.BatchActivationSlotRelationships;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/BatchActivationSlotInclusion.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/BatchActivationSlotRelationships.d.mts

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Relationship block for a `batchActivationSlot` resource.
+ */
+export interface BatchActivationSlotRelationships {
+    /** Reference to the placement that fills this slot. The referenced placement provides the slot's content strategy and offer-count cap; request `?include=slots.placement` to embed it in `included`. */
+    placement: KardApi.organizations.ToOneRelationship;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/BatchActivationSlotRelationships.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/ContentStrategyInclusion.d.mts

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Content strategy as it appears in the `included` array.
+ */
+export interface ContentStrategyInclusion {
+    id: string;
+    attributes: KardApi.organizations.ContentStrategyAttributes;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/ContentStrategyInclusion.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/CreateBatchActivationAttributes.d.mts

@@ -7,8 +7,9 @@ import type * as KardApi from "../../../../../index.mjs";
  *         name: "Weekly Cohort",
  *         refreshInterval: "P7D",
  *         slots: [{
- *                 contentStrategyId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
- *                 alias: "primary"
+ *                 placementId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+ *                 alias: "primary",
+ *                 shortDescription: "Featured deals refreshed each week"
  *             }]
  *     }
  */

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

@@ -2,8 +2,10 @@
  * A slot in a batch-activation placement at creation time
  */
 export interface CreateBatchActivationSlot {
-    /** ID of the content strategy that fills this slot */
-    contentStrategyId: string;
+    /** 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. */
+    placementId: string;
     /** Customer-defined alias for the slot, unique within the placement */
     alias: string;
+    /** Optional short description of the slot, limited to 50 characters */
+    shortDescription?: string | undefined;
 }

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

@@ -0,0 +1,19 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Discriminated union of every resource type that can appear in the `included` array. The shape of each branch matches the corresponding primary-data resource (same attributes and relationships), keyed on the JSON:API `type` discriminant.
+ */
+export type IncludedResource = KardApi.organizations.IncludedResource.ContentStrategy | KardApi.organizations.IncludedResource.BatchActivationSlot | KardApi.organizations.IncludedResource.PlacementMainPage | KardApi.organizations.IncludedResource.PlacementPushNotification;
+export declare namespace IncludedResource {
+    interface ContentStrategy extends KardApi.organizations.ContentStrategyInclusion {
+        type: "contentStrategy";
+    }
+    interface BatchActivationSlot extends KardApi.organizations.BatchActivationSlotInclusion {
+        type: "batchActivationSlot";
+    }
+    interface PlacementMainPage extends KardApi.organizations.MainPagePlacementData {
+        type: "placementMainPage";
+    }
+    interface PlacementPushNotification extends KardApi.organizations.PushNotificationPlacementData {
+        type: "placementPushNotification";
+    }
+}

package/dist/esm/api/resources/organizations/resources/placements/types/IncludedResource.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/MainPagePlacementAttributes.d.mts

@@ -8,6 +8,6 @@ export interface MainPagePlacementAttributes {
     organizationId: string;
     /** Number of available slots */
     availableSlots: number;
-    /** ID of the content strategy linked to this placement, if any */
+    /** ID of the content strategy linked to this placement, if any. Retained alongside `relationships.contentStrategy` for backward compatibility. */
     contentStrategyId?: string | undefined;
 }

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

@@ -6,4 +6,6 @@ export interface MainPagePlacementData {
     /** Unique identifier of the placement (UUID v7) */
     id: string;
     attributes: KardApi.organizations.MainPagePlacementAttributes;
+    /** JSON:API relationships for the placement. Omitted entirely when the placement has no linked resources. */
+    relationships?: KardApi.organizations.PlacementRelationships | undefined;
 }

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

@@ -34,12 +34,15 @@ import type * as KardApi from "../../../../../index.mjs";
  *         attributes: {
  *             name: "Weekly Cohort",
  *             organizationId: "org-123",
- *             refreshInterval: "P7D",
- *             slots: [{
- *                     slotId: "01961e5a-e15f-7d33-bd4f-09c6b8fa3d56",
- *                     contentStrategyId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
- *                     alias: "primary"
- *                 }]
+ *             refreshInterval: "P7D"
+ *         },
+ *         relationships: {
+ *             slots: {
+ *                 data: [{
+ *                         type: "batchActivationSlot",
+ *                         id: "01961e5a-e15f-7d33-bd4f-09c6b8fa3d56"
+ *                     }]
+ *             }
  *         }
  *     }
  */

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

@@ -5,8 +5,8 @@ import type * as KardApi from "../../../../../index.mjs";
 export interface PlacementListResponse {
     /** Array of placement resources */
     data: KardApi.organizations.PlacementFormatUnion[];
-    /** Related resources requested via the `include` query parameter. Only populated when `include=contentStrategy` is supplied and at least one placement in `data` is linked to a content strategy. */
-    included?: KardApi.organizations.ContentStrategyResponse[] | undefined;
+    /** Related resources requested via the `include` query parameter. Each entry is keyed by its `type` discriminant (`contentStrategy`, `batchActivationSlot`, `placementMainPage`, `placementPushNotification`). */
+    included?: KardApi.organizations.IncludedResource[] | undefined;
     links?: KardApi.Links | undefined;
     /** Pagination metadata */
     meta?: KardApi.OrganizationPaginationMetadata | undefined;

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

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Relationship block for non-batch placements. Mirrors the `contentStrategyId` attribute so JSON:API clients can walk the graph.
+ */
+export interface PlacementRelationships {
+    /** Relationship to the content strategy that powers this placement. Present whenever the placement has been linked to a content strategy (`data.id` will be set). Omitted entirely when no content strategy is linked. */
+    contentStrategy?: KardApi.organizations.ToOneRelationship | undefined;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/PlacementRelationships.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/PlacementResource.d.mts

@@ -5,6 +5,6 @@ import type * as KardApi from "../../../../../index.mjs";
 export interface PlacementResource {
     /** Placement resource */
     data: KardApi.organizations.PlacementFormatUnion;
-    /** Related resources requested via the `include` query parameter. Only populated when `include=contentStrategy` is supplied and the placement is linked to a content strategy. */
-    included?: KardApi.organizations.ContentStrategyResponse[] | undefined;
+    /** Related resources requested via the `include` query parameter. Each entry is keyed by its `type` discriminant (`contentStrategy`, `batchActivationSlot`, `placementMainPage`, `placementPushNotification`). */
+    included?: KardApi.organizations.IncludedResource[] | undefined;
 }

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

@@ -9,6 +9,6 @@ export interface PushNotificationPlacementAttributes {
     organizationId: string;
     /** Delivery cadence for the notification */
     cadence: KardApi.organizations.Cadence;
-    /** ID of the content strategy linked to this placement, if any */
+    /** ID of the content strategy linked to this placement, if any. Retained alongside `relationships.contentStrategy` for backward compatibility. */
     contentStrategyId?: string | undefined;
 }

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

@@ -6,4 +6,6 @@ export interface PushNotificationPlacementData {
     /** Unique identifier of the placement (UUID v7) */
     id: string;
     attributes: KardApi.organizations.PushNotificationPlacementAttributes;
+    /** JSON:API relationships for the placement. Omitted entirely when the placement has no linked resources. */
+    relationships?: KardApi.organizations.PlacementRelationships | undefined;
 }

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

@@ -0,0 +1,9 @@
+/**
+ * A reference to another resource by type and id.
+ */
+export interface ResourceIdentifier {
+    /** Discriminant of the referenced resource (e.g. `contentStrategy`). */
+    type: string;
+    /** Identifier of the referenced resource. */
+    id: string;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/ResourceIdentifier.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/ToManyRelationship.d.mts

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * A JSON:API to-many relationship payload.
+ */
+export interface ToManyRelationship {
+    /** The linked resource identifiers. */
+    data: KardApi.organizations.ResourceIdentifier[];
+}

package/dist/esm/api/resources/organizations/resources/placements/types/ToManyRelationship.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/ToOneRelationship.d.mts

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * A JSON:API to-one relationship payload.
+ */
+export interface ToOneRelationship {
+    /** The linked resource identifier, or null when the relationship is present but unlinked. */
+    data?: KardApi.organizations.ResourceIdentifier | undefined;
+}

package/dist/esm/api/resources/organizations/resources/placements/types/ToOneRelationship.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/UpdateBatchActivationAttributes.d.mts

@@ -8,8 +8,9 @@ import type * as KardApi from "../../../../../index.mjs";
  *         refreshInterval: "P14D",
  *         slots: [{
  *                 slotId: "01961e5a-e15f-7d33-bd4f-09c6b8fa3d56",
- *                 contentStrategyId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
- *                 alias: "primary"
+ *                 placementId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+ *                 alias: "primary",
+ *                 shortDescription: "Featured deals refreshed each week"
  *             }]
  *     }
  */

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

@@ -2,10 +2,12 @@
  * A slot in a batch-activation 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 contentStrategyId changes, the slotId is regenerated regardless of what was echoed. */
+    /** 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. */
     slotId?: string | undefined;
-    /** ID of the content strategy that fills this slot */
-    contentStrategyId: string;
+    /** 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. */
+    placementId: string;
     /** Customer-defined alias for the slot, unique within the placement */
     alias: string;
+    /** Optional short description of the slot, limited to 50 characters */
+    shortDescription?: string | undefined;
 }

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

@@ -1,8 +1,12 @@
 export * from "./BatchActivationPlacementAttributes.mjs";
 export * from "./BatchActivationPlacementData.mjs";
-export * from "./BatchActivationSlot.mjs";
+export * from "./BatchActivationPlacementRelationships.mjs";
+export * from "./BatchActivationSlotAttributes.mjs";
+export * from "./BatchActivationSlotInclusion.mjs";
+export * from "./BatchActivationSlotRelationships.mjs";
 export * from "./Cadence.mjs";
 export * from "./CadenceFrequency.mjs";
+export * from "./ContentStrategyInclusion.mjs";
 export * from "./CreateBatchActivationAttributes.mjs";
 export * from "./CreateBatchActivationPlacementData.mjs";
 export * from "./CreateBatchActivationSlot.mjs";
@@ -13,14 +17,19 @@ export * from "./CreatePlacementRequestBody.mjs";
 export * from "./CreatePushNotificationAttributes.mjs";
 export * from "./CreatePushNotificationPlacementData.mjs";
 export * from "./DayOfWeek.mjs";
+export * from "./IncludedResource.mjs";
 export * from "./MainPagePlacementAttributes.mjs";
 export * from "./MainPagePlacementData.mjs";
 export * from "./PlacementFormatUnion.mjs";
 export * from "./PlacementListResponse.mjs";
+export * from "./PlacementRelationships.mjs";
 export * from "./PlacementResource.mjs";
 export * from "./PlacementTypeFilter.mjs";
 export * from "./PushNotificationPlacementAttributes.mjs";
 export * from "./PushNotificationPlacementData.mjs";
+export * from "./ResourceIdentifier.mjs";
+export * from "./ToManyRelationship.mjs";
+export * from "./ToOneRelationship.mjs";
 export * from "./UpdateBatchActivationAttributes.mjs";
 export * from "./UpdateBatchActivationPlacementData.mjs";
 export * from "./UpdateBatchActivationSlot.mjs";

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

@@ -1,8 +1,12 @@
 export * from "./BatchActivationPlacementAttributes.mjs";
 export * from "./BatchActivationPlacementData.mjs";
-export * from "./BatchActivationSlot.mjs";
+export * from "./BatchActivationPlacementRelationships.mjs";
+export * from "./BatchActivationSlotAttributes.mjs";
+export * from "./BatchActivationSlotInclusion.mjs";
+export * from "./BatchActivationSlotRelationships.mjs";
 export * from "./Cadence.mjs";
 export * from "./CadenceFrequency.mjs";
+export * from "./ContentStrategyInclusion.mjs";
 export * from "./CreateBatchActivationAttributes.mjs";
 export * from "./CreateBatchActivationPlacementData.mjs";
 export * from "./CreateBatchActivationSlot.mjs";
@@ -13,14 +17,19 @@ export * from "./CreatePlacementRequestBody.mjs";
 export * from "./CreatePushNotificationAttributes.mjs";
 export * from "./CreatePushNotificationPlacementData.mjs";
 export * from "./DayOfWeek.mjs";
+export * from "./IncludedResource.mjs";
 export * from "./MainPagePlacementAttributes.mjs";
 export * from "./MainPagePlacementData.mjs";
 export * from "./PlacementFormatUnion.mjs";
 export * from "./PlacementListResponse.mjs";
+export * from "./PlacementRelationships.mjs";
 export * from "./PlacementResource.mjs";
 export * from "./PlacementTypeFilter.mjs";
 export * from "./PushNotificationPlacementAttributes.mjs";
 export * from "./PushNotificationPlacementData.mjs";
+export * from "./ResourceIdentifier.mjs";
+export * from "./ToManyRelationship.mjs";
+export * from "./ToOneRelationship.mjs";
 export * from "./UpdateBatchActivationAttributes.mjs";
 export * from "./UpdateBatchActivationPlacementData.mjs";
 export * from "./UpdateBatchActivationSlot.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "24.1.0";
+export declare const SDK_VERSION = "25.0.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "24.1.0";
+export const SDK_VERSION = "25.0.0";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kard-financial/sdk",
-    "version": "24.1.0",
+    "version": "25.0.0",
     "private": false,
     "repository": {
         "type": "git",

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

@@ -1,11 +0,0 @@
-/**
- * A slot within a batch-activation placement
- */
-export interface BatchActivationSlot {
-    /** Stable identifier for the slot within the placement */
-    slotId: string;
-    /** ID of the content strategy linked to this slot */
-    contentStrategyId: string;
-    /** Customer-defined alias for the slot, unique within the placement */
-    alias: string;
-}

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

@@ -1,11 +0,0 @@
-/**
- * A slot within a batch-activation placement
- */
-export interface BatchActivationSlot {
-    /** Stable identifier for the slot within the placement */
-    slotId: string;
-    /** ID of the content strategy linked to this slot */
-    contentStrategyId: string;
-    /** Customer-defined alias for the slot, unique within the placement */
-    alias: string;
-}