@kard-financial/sdk 22.1.0 → 22.3.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": "22.1.0",
-        "User-Agent": "@kard-financial/sdk/22.1.0",
+        "X-Fern-SDK-Version": "22.3.0",
+        "User-Agent": "@kard-financial/sdk/22.3.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/types/BatchActivationPlacementAttributes.d.ts

@@ -0,0 +1,14 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Attributes for a batch-activation placement
+ */
+export interface BatchActivationPlacementAttributes {
+    /** Name of the placement */
+    name: string;
+    /** ID of the organization this placement belongs to */
+    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/BatchActivationPlacementAttributes.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/BatchActivationPlacementData.d.ts

@@ -0,0 +1,9 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Batch-activation placement resource data
+ */
+export interface BatchActivationPlacementData {
+    /** Unique identifier of the placement (UUID v7) */
+    id: string;
+    attributes: KardApi.organizations.BatchActivationPlacementAttributes;
+}

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

@@ -0,0 +1,11 @@
+/**
+ * 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/cjs/api/resources/organizations/resources/placements/types/BatchActivationSlot.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

@@ -0,0 +1,22 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Attributes for creating a batch-activation placement
+ *
+ * @example
+ *     {
+ *         name: "Weekly Cohort",
+ *         refreshInterval: "P7D",
+ *         slots: [{
+ *                 contentStrategyId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+ *                 alias: "primary"
+ *             }]
+ *     }
+ */
+export interface CreateBatchActivationAttributes {
+    /** Name of the placement */
+    name: string;
+    /** ISO-8601 duration controlling how often the activation cohort refreshes */
+    refreshInterval: string;
+    /** Slots that make up the activation cohort */
+    slots: KardApi.organizations.CreateBatchActivationSlot[];
+}

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

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Data for creating a batch-activation placement
+ */
+export interface CreateBatchActivationPlacementData {
+    /** Batch-activation placement attributes for creation */
+    attributes: KardApi.organizations.CreateBatchActivationAttributes;
+}

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

@@ -0,0 +1,9 @@
+/**
+ * A slot in a batch-activation placement at creation time
+ */
+export interface CreateBatchActivationSlot {
+    /** ID of the content strategy that fills this slot */
+    contentStrategyId: string;
+    /** Customer-defined alias for the slot, unique within the placement */
+    alias: string;
+}

package/dist/cjs/api/resources/organizations/resources/placements/types/CreateBatchActivationSlot.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,7 +2,7 @@ import type * as KardApi from "../../../../../index.js";
 /**
  * Discriminated union for creating a placement
  */
-export type CreatePlacementDataUnion = KardApi.organizations.CreatePlacementDataUnion.PlacementMainPage | KardApi.organizations.CreatePlacementDataUnion.PlacementPushNotification;
+export type CreatePlacementDataUnion = KardApi.organizations.CreatePlacementDataUnion.PlacementMainPage | KardApi.organizations.CreatePlacementDataUnion.PlacementPushNotification | KardApi.organizations.CreatePlacementDataUnion.PlacementBatchActivation;
 export declare namespace CreatePlacementDataUnion {
     interface PlacementMainPage extends KardApi.organizations.CreateMainPagePlacementData {
         type: "placementMainPage";
@@ -10,4 +10,7 @@ export declare namespace CreatePlacementDataUnion {
     interface PlacementPushNotification extends KardApi.organizations.CreatePushNotificationPlacementData {
         type: "placementPushNotification";
     }
+    interface PlacementBatchActivation extends KardApi.organizations.CreateBatchActivationPlacementData {
+        type: "placementBatchActivation";
+    }
 }

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

@@ -26,8 +26,24 @@ import type * as KardApi from "../../../../../index.js";
  *             }
  *         }
  *     }
+ *
+ * @example
+ *     {
+ *         type: "placementBatchActivation",
+ *         id: "01961e5a-d94e-7c22-ac3f-f8b5a7e92c45",
+ *         attributes: {
+ *             name: "Weekly Cohort",
+ *             organizationId: "org-123",
+ *             refreshInterval: "P7D",
+ *             slots: [{
+ *                     slotId: "01961e5a-e15f-7d33-bd4f-09c6b8fa3d56",
+ *                     contentStrategyId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+ *                     alias: "primary"
+ *                 }]
+ *         }
+ *     }
  */
-export type PlacementFormatUnion = KardApi.organizations.PlacementFormatUnion.PlacementMainPage | KardApi.organizations.PlacementFormatUnion.PlacementPushNotification;
+export type PlacementFormatUnion = KardApi.organizations.PlacementFormatUnion.PlacementMainPage | KardApi.organizations.PlacementFormatUnion.PlacementPushNotification | KardApi.organizations.PlacementFormatUnion.PlacementBatchActivation;
 export declare namespace PlacementFormatUnion {
     interface PlacementMainPage extends KardApi.organizations.MainPagePlacementData {
         type: "placementMainPage";
@@ -35,4 +51,7 @@ export declare namespace PlacementFormatUnion {
     interface PlacementPushNotification extends KardApi.organizations.PushNotificationPlacementData {
         type: "placementPushNotification";
     }
+    interface PlacementBatchActivation extends KardApi.organizations.BatchActivationPlacementData {
+        type: "placementBatchActivation";
+    }
 }

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

@@ -2,5 +2,6 @@
 export declare const PlacementTypeFilter: {
     readonly PlacementMainPage: "placementMainPage";
     readonly PlacementPushNotification: "placementPushNotification";
+    readonly PlacementBatchActivation: "placementBatchActivation";
 };
 export type PlacementTypeFilter = (typeof PlacementTypeFilter)[keyof typeof PlacementTypeFilter];

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

@@ -6,4 +6,5 @@ exports.PlacementTypeFilter = void 0;
 exports.PlacementTypeFilter = {
     PlacementMainPage: "placementMainPage",
     PlacementPushNotification: "placementPushNotification",
+    PlacementBatchActivation: "placementBatchActivation",
 };

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

@@ -0,0 +1,23 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Attributes for updating a batch-activation placement. All fields are required.
+ *
+ * @example
+ *     {
+ *         name: "Updated Cohort",
+ *         refreshInterval: "P14D",
+ *         slots: [{
+ *                 slotId: "01961e5a-e15f-7d33-bd4f-09c6b8fa3d56",
+ *                 contentStrategyId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+ *                 alias: "primary"
+ *             }]
+ *     }
+ */
+export interface UpdateBatchActivationAttributes {
+    /** Name of the placement */
+    name: string;
+    /** ISO-8601 duration controlling how often the activation cohort refreshes */
+    refreshInterval: string;
+    /** Slots that make up the activation cohort. Slots present in the prior state but absent from this list are removed. */
+    slots: KardApi.organizations.UpdateBatchActivationSlot[];
+}

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

@@ -0,0 +1,8 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Data for updating a batch-activation placement
+ */
+export interface UpdateBatchActivationPlacementData {
+    /** Batch-activation placement attributes for update */
+    attributes: KardApi.organizations.UpdateBatchActivationAttributes;
+}

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * 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. */
+    slotId?: string | undefined;
+    /** ID of the content strategy that fills this slot */
+    contentStrategyId: string;
+    /** Customer-defined alias for the slot, unique within the placement */
+    alias: string;
+}

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

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

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

@@ -2,7 +2,7 @@ import type * as KardApi from "../../../../../index.js";
 /**
  * Discriminated union for updating a placement
  */
-export type UpdatePlacementDataUnion = KardApi.organizations.UpdatePlacementDataUnion.PlacementMainPage | KardApi.organizations.UpdatePlacementDataUnion.PlacementPushNotification;
+export type UpdatePlacementDataUnion = KardApi.organizations.UpdatePlacementDataUnion.PlacementMainPage | KardApi.organizations.UpdatePlacementDataUnion.PlacementPushNotification | KardApi.organizations.UpdatePlacementDataUnion.PlacementBatchActivation;
 export declare namespace UpdatePlacementDataUnion {
     interface PlacementMainPage extends KardApi.organizations.UpdateMainPagePlacementData {
         type: "placementMainPage";
@@ -10,4 +10,7 @@ export declare namespace UpdatePlacementDataUnion {
     interface PlacementPushNotification extends KardApi.organizations.UpdatePushNotificationPlacementData {
         type: "placementPushNotification";
     }
+    interface PlacementBatchActivation extends KardApi.organizations.UpdateBatchActivationPlacementData {
+        type: "placementBatchActivation";
+    }
 }

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

@@ -1,5 +1,11 @@
+export * from "./BatchActivationPlacementAttributes.js";
+export * from "./BatchActivationPlacementData.js";
+export * from "./BatchActivationSlot.js";
 export * from "./Cadence.js";
 export * from "./CadenceFrequency.js";
+export * from "./CreateBatchActivationAttributes.js";
+export * from "./CreateBatchActivationPlacementData.js";
+export * from "./CreateBatchActivationSlot.js";
 export * from "./CreateMainPageAttributes.js";
 export * from "./CreateMainPagePlacementData.js";
 export * from "./CreatePlacementDataUnion.js";
@@ -15,6 +21,9 @@ export * from "./PlacementResource.js";
 export * from "./PlacementTypeFilter.js";
 export * from "./PushNotificationPlacementAttributes.js";
 export * from "./PushNotificationPlacementData.js";
+export * from "./UpdateBatchActivationAttributes.js";
+export * from "./UpdateBatchActivationPlacementData.js";
+export * from "./UpdateBatchActivationSlot.js";
 export * from "./UpdateMainPageAttributes.js";
 export * from "./UpdateMainPagePlacementData.js";
 export * from "./UpdatePlacementDataUnion.js";

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

@@ -14,8 +14,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./BatchActivationPlacementAttributes.js"), exports);
+__exportStar(require("./BatchActivationPlacementData.js"), exports);
+__exportStar(require("./BatchActivationSlot.js"), exports);
 __exportStar(require("./Cadence.js"), exports);
 __exportStar(require("./CadenceFrequency.js"), exports);
+__exportStar(require("./CreateBatchActivationAttributes.js"), exports);
+__exportStar(require("./CreateBatchActivationPlacementData.js"), exports);
+__exportStar(require("./CreateBatchActivationSlot.js"), exports);
 __exportStar(require("./CreateMainPageAttributes.js"), exports);
 __exportStar(require("./CreateMainPagePlacementData.js"), exports);
 __exportStar(require("./CreatePlacementDataUnion.js"), exports);
@@ -31,6 +37,9 @@ __exportStar(require("./PlacementResource.js"), exports);
 __exportStar(require("./PlacementTypeFilter.js"), exports);
 __exportStar(require("./PushNotificationPlacementAttributes.js"), exports);
 __exportStar(require("./PushNotificationPlacementData.js"), exports);
+__exportStar(require("./UpdateBatchActivationAttributes.js"), exports);
+__exportStar(require("./UpdateBatchActivationPlacementData.js"), exports);
+__exportStar(require("./UpdateBatchActivationSlot.js"), exports);
 __exportStar(require("./UpdateMainPageAttributes.js"), exports);
 __exportStar(require("./UpdateMainPagePlacementData.js"), exports);
 __exportStar(require("./UpdatePlacementDataUnion.js"), exports);

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

@@ -56,6 +56,33 @@ export declare class RewardsClient {
      */
     placementOffers(organizationId: KardApi.OrganizationId, userId: KardApi.UserId, placementId: string, request?: KardApi.users.GetOffersByPlacementRequest, requestOptions?: RewardsClient.RequestOptions): core.HttpResponsePromise<KardApi.users.OffersResponseObject>;
     private __placementOffers;
+    /**
+     * Retrieve batches for a batch-activation placement. Returns each slot in slot
+     * order with its current offer set, alias, and freshness fields (`isActive`,
+     * `lastActivatedAt`, `expiresAt`). Applies the same per-user eligibility and
+     * per-slot content-strategy filter as Get Offers By Placement, independently
+     * per slot. A slot only flips to `isActive: false` when its refresh interval
+     * has elapsed AND its post-eligibility `offers[]` is non-empty; otherwise the
+     * slot is still returned and stays active so the partner UI does not promote
+     * "refresh" with nothing to show.<br/>
+     * <b>Required scopes:</b> `rewards:read`
+     *
+     * @param {KardApi.OrganizationId} organizationId
+     * @param {KardApi.UserId} userId
+     * @param {string} placementId
+     * @param {KardApi.users.GetBatchesByPlacementRequest} request
+     * @param {RewardsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link KardApi.InternalServerError}
+     * @throws {@link KardApi.InvalidRequest}
+     * @throws {@link KardApi.DoesNotExistError}
+     * @throws {@link KardApi.UnauthorizedError}
+     *
+     * @example
+     *     await client.users.rewards.placementBatches("organizationId", "userId", "placementId")
+     */
+    placementBatches(organizationId: KardApi.OrganizationId, userId: KardApi.UserId, placementId: string, request?: KardApi.users.GetBatchesByPlacementRequest, requestOptions?: RewardsClient.RequestOptions): core.HttpResponsePromise<KardApi.users.BatchesResponseObject>;
+    private __placementBatches;
     /**
      * Retrieve national and local geographic locations that a specified user has eligible in-store offers at. Use this endpoint to build
      * out your [map-specific UX experiences](/2024-10-01/api/getting-started#c-discover-clos-near-you-map-view). Please note

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

@@ -214,6 +214,82 @@ class RewardsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v2/issuers/{organizationId}/users/{userId}/placements/{placementId}/offers");
         });
     }
+    /**
+     * 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/>
+     * <b>Required scopes:</b> `rewards:read`
+     *
+     * @param {KardApi.OrganizationId} organizationId
+     * @param {KardApi.UserId} userId
+     * @param {string} placementId
+     * @param {KardApi.users.GetBatchesByPlacementRequest} request
+     * @param {RewardsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link KardApi.InternalServerError}
+     * @throws {@link KardApi.InvalidRequest}
+     * @throws {@link KardApi.DoesNotExistError}
+     * @throws {@link KardApi.UnauthorizedError}
+     *
+     * @example
+     *     await client.users.rewards.placementBatches("organizationId", "userId", "placementId")
+     */
+    placementBatches(organizationId, userId, placementId, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__placementBatches(organizationId, userId, placementId, request, requestOptions));
+    }
+    __placementBatches(organizationId_1, userId_1, placementId_1) {
+        return __awaiter(this, arguments, void 0, function* (organizationId, userId, placementId, request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { supportedComponents } = request;
+            const _queryParams = {
+                supportedComponents: Array.isArray(supportedComponents)
+                    ? supportedComponents.map((item) => item)
+                    : supportedComponents != null
+                        ? supportedComponents
+                        : undefined,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.KardApiEnvironment.Production, `/v2/issuers/${core.url.encodePathParam(organizationId)}/users/${core.url.encodePathParam(userId)}/placements/${core.url.encodePathParam(placementId)}/batches`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 500:
+                        throw new KardApi.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 400:
+                        throw new KardApi.InvalidRequest(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new KardApi.DoesNotExistError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new KardApi.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.KardApiError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v2/issuers/{organizationId}/users/{userId}/placements/{placementId}/batches");
+        });
+    }
     /**
      * Retrieve national and local geographic locations that a specified user has eligible in-store offers at. Use this endpoint to build
      * out your [map-specific UX experiences](/2024-10-01/api/getting-started#c-discover-clos-near-you-map-view). Please note

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

@@ -0,0 +1,9 @@
+import type * as KardApi from "../../../../../../index.js";
+/**
+ * @example
+ *     {}
+ */
+export interface GetBatchesByPlacementRequest {
+    /** UI component types to include in the response. */
+    supportedComponents?: KardApi.users.ComponentType | KardApi.users.ComponentType[];
+}

package/dist/cjs/api/resources/users/resources/rewards/client/requests/GetBatchesByPlacementRequest.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/users/resources/rewards/client/requests/index.d.ts

@@ -1,3 +1,4 @@
+export type { GetBatchesByPlacementRequest } from "./GetBatchesByPlacementRequest.js";
 export type { GetLocationsByUserRequest } from "./GetLocationsByUserRequest.js";
 export type { GetOffersByPlacementRequest } from "./GetOffersByPlacementRequest.js";
 export type { GetOffersByUserRequest } from "./GetOffersByUserRequest.js";

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

@@ -0,0 +1,18 @@
+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.
+ */
+export interface BatchSlotData {
+    /** Stable identifier for the slot within the placement */
+    slotId: string;
+    /** Customer-defined alias for the slot, unique within the placement */
+    alias: 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. */
+    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;
+    /** The set of offers eligible for the user under this slot's content strategy. */
+    offers: KardApi.users.OfferDataUnion[];
+}

package/dist/cjs/api/resources/users/resources/rewards/types/BatchSlotData.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/users/resources/rewards/types/BatchesResponseObject.d.ts

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

package/dist/cjs/api/resources/users/resources/rewards/types/BatchesResponseObject.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/users/resources/rewards/types/index.d.ts

@@ -1,6 +1,8 @@
 export * from "./Amount.js";
 export * from "./AmountType.js";
 export * from "./Asset.js";
+export * from "./BatchesResponseObject.js";
+export * from "./BatchSlotData.js";
 export * from "./ButtonStyle.js";
 export * from "./CategoryData.js";
 export * from "./CategoryFields.js";

package/dist/cjs/api/resources/users/resources/rewards/types/index.js

@@ -17,6 +17,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./Amount.js"), exports);
 __exportStar(require("./AmountType.js"), exports);
 __exportStar(require("./Asset.js"), exports);
+__exportStar(require("./BatchesResponseObject.js"), exports);
+__exportStar(require("./BatchSlotData.js"), exports);
 __exportStar(require("./ButtonStyle.js"), exports);
 __exportStar(require("./CategoryData.js"), exports);
 __exportStar(require("./CategoryFields.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "22.1.0";
+export declare const SDK_VERSION = "22.3.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 = "22.1.0";
+exports.SDK_VERSION = "22.3.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": "22.1.0",
-        "User-Agent": "@kard-financial/sdk/22.1.0",
+        "X-Fern-SDK-Version": "22.3.0",
+        "User-Agent": "@kard-financial/sdk/22.3.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/types/BatchActivationPlacementAttributes.d.mts

@@ -0,0 +1,14 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Attributes for a batch-activation placement
+ */
+export interface BatchActivationPlacementAttributes {
+    /** Name of the placement */
+    name: string;
+    /** ID of the organization this placement belongs to */
+    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/BatchActivationPlacementAttributes.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/BatchActivationPlacementData.d.mts

@@ -0,0 +1,9 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Batch-activation placement resource data
+ */
+export interface BatchActivationPlacementData {
+    /** Unique identifier of the placement (UUID v7) */
+    id: string;
+    attributes: KardApi.organizations.BatchActivationPlacementAttributes;
+}

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

@@ -0,0 +1,11 @@
+/**
+ * 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.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

@@ -0,0 +1,22 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Attributes for creating a batch-activation placement
+ *
+ * @example
+ *     {
+ *         name: "Weekly Cohort",
+ *         refreshInterval: "P7D",
+ *         slots: [{
+ *                 contentStrategyId: "01961e5a-f26f-7e44-ce5f-1ad7c9fb4e67",
+ *                 alias: "primary"
+ *             }]
+ *     }
+ */
+export interface CreateBatchActivationAttributes {
+    /** Name of the placement */
+    name: string;
+    /** ISO-8601 duration controlling how often the activation cohort refreshes */
+    refreshInterval: string;
+    /** Slots that make up the activation cohort */
+    slots: KardApi.organizations.CreateBatchActivationSlot[];
+}