@kard-financial/sdk 22.3.0 → 22.4.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.3.0",
-        "User-Agent": "@kard-financial/sdk/22.3.0",
+        "X-Fern-SDK-Version": "22.4.0",
+        "User-Agent": "@kard-financial/sdk/22.4.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/users/resources/attributions/client/Client.d.ts

@@ -93,4 +93,29 @@ export declare class AttributionsClient {
      */
     boost(organizationId: KardApi.OrganizationId, userId: KardApi.UserId, offerId: string, request?: KardApi.users.BoostOfferRequest, requestOptions?: AttributionsClient.RequestOptions): core.HttpResponsePromise<KardApi.users.BoostOfferResponse>;
     private __boost;
+    /**
+     * Record when a user activates a batch-activation placement slot. Writes a slot-level
+     * `placementSlotAttribution` ACTIVATE event and fans out a per-offer
+     * `offerAttribution` ACTIVATE event for every offer resolved by the slot's content
+     * strategy. The slot-level event id and the resolved `offerIds` are returned so the
+     * partner can render the batch immediately without an extra `getBatchesByPlacement`
+     * round-trip.
+     *
+     * <b>Required scopes:</b> `attributions:write`
+     *
+     * @param {KardApi.OrganizationId} organizationId
+     * @param {KardApi.UserId} userId
+     * @param {string} placementId - Unique identifier of the placement (UUID v7)
+     * @param {string} slotId - Stable identifier for the slot within the placement
+     * @param {AttributionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link KardApi.UnauthorizedError}
+     * @throws {@link KardApi.InternalServerError}
+     * @throws {@link KardApi.InvalidRequest}
+     *
+     * @example
+     *     await client.users.attributions.activatePlacementSlot("organization-123", "user-123", "018f8d6b-1abc-7def-9012-345678901234", "slot-a")
+     */
+    activatePlacementSlot(organizationId: KardApi.OrganizationId, userId: KardApi.UserId, placementId: string, slotId: string, requestOptions?: AttributionsClient.RequestOptions): core.HttpResponsePromise<KardApi.users.ActivatePlacementSlotResponse>;
+    private __activatePlacementSlot;
 }

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

@@ -279,5 +279,72 @@ class AttributionsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v2/issuers/{organizationId}/users/{userId}/offers/{offerId}/boost");
         });
     }
+    /**
+     * Record when a user activates a batch-activation placement slot. Writes a slot-level
+     * `placementSlotAttribution` ACTIVATE event and fans out a per-offer
+     * `offerAttribution` ACTIVATE event for every offer resolved by the slot's content
+     * strategy. The slot-level event id and the resolved `offerIds` are returned so the
+     * partner can render the batch immediately without an extra `getBatchesByPlacement`
+     * round-trip.
+     *
+     * <b>Required scopes:</b> `attributions:write`
+     *
+     * @param {KardApi.OrganizationId} organizationId
+     * @param {KardApi.UserId} userId
+     * @param {string} placementId - Unique identifier of the placement (UUID v7)
+     * @param {string} slotId - Stable identifier for the slot within the placement
+     * @param {AttributionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link KardApi.UnauthorizedError}
+     * @throws {@link KardApi.InternalServerError}
+     * @throws {@link KardApi.InvalidRequest}
+     *
+     * @example
+     *     await client.users.attributions.activatePlacementSlot("organization-123", "user-123", "018f8d6b-1abc-7def-9012-345678901234", "slot-a")
+     */
+    activatePlacementSlot(organizationId, userId, placementId, slotId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__activatePlacementSlot(organizationId, userId, placementId, slotId, requestOptions));
+    }
+    __activatePlacementSlot(organizationId, userId, placementId, slotId, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            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)}/slot/${core.url.encodePathParam(slotId)}/activate`),
+                method: "POST",
+                headers: _headers,
+                queryParameters: 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 401:
+                        throw new KardApi.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new KardApi.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 400:
+                        throw new KardApi.InvalidRequest(_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, "POST", "/v2/issuers/{organizationId}/users/{userId}/placements/{placementId}/slot/{slotId}/activate");
+        });
+    }
 }
 exports.AttributionsClient = AttributionsClient;

package/dist/cjs/api/resources/users/resources/attributions/types/ActivatePlacementSlotResponse.d.ts

@@ -0,0 +1,23 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Ack payload for a slot activation request.
+ *
+ * @example
+ *     {
+ *         data: {
+ *             type: "placementSlotAttribution",
+ *             id: "c94a93a7-beb9-4e58-960c-2c812f849398",
+ *             attributes: {
+ *                 placementId: "018f8d6b-1abc-7def-9012-345678901234",
+ *                 slotId: "slot-a",
+ *                 eventCode: "ACTIVATE",
+ *                 medium: "CTA",
+ *                 eventDate: "2025-01-01T00:00:00Z",
+ *                 offerIds: ["offer-1", "offer-2", "offer-3"]
+ *             }
+ *         }
+ *     }
+ */
+export interface ActivatePlacementSlotResponse {
+    data: KardApi.users.ActivatePlacementSlotResponseData;
+}

package/dist/cjs/api/resources/users/resources/attributions/types/ActivatePlacementSlotResponse.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/attributions/types/ActivatePlacementSlotResponseAttributes.d.ts

@@ -0,0 +1,15 @@
+export interface ActivatePlacementSlotResponseAttributes {
+    /** Unique identifier of the placement */
+    placementId: string;
+    /** Stable identifier for the slot within the placement */
+    slotId: string;
+    eventCode: string;
+    medium: string;
+    eventDate: string;
+    /**
+     * All offer IDs that resolved under the slot's content strategy and had
+     * per-offer `offerAttribution` ACTIVATE events written. The partner can use
+     * this to render the batch immediately without an extra round-trip.
+     */
+    offerIds: string[];
+}

package/dist/cjs/api/resources/users/resources/attributions/types/ActivatePlacementSlotResponseAttributes.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/attributions/types/ActivatePlacementSlotResponseData.d.ts

@@ -0,0 +1,7 @@
+import type * as KardApi from "../../../../../index.js";
+export interface ActivatePlacementSlotResponseData {
+    type: string;
+    /** The slot-level attribution event id */
+    id: string;
+    attributes: KardApi.users.ActivatePlacementSlotResponseAttributes;
+}

package/dist/cjs/api/resources/users/resources/attributions/types/ActivatePlacementSlotResponseData.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/attributions/types/AttributionState.d.ts

@@ -4,4 +4,8 @@ export interface AttributionState {
     rank?: number | undefined;
     /** The active filters when the user saw the offer */
     filters?: KardApi.users.AttributionFilter[] | undefined;
+    /** Unique identifier of the placement the attribution event originated from */
+    placementId?: string | undefined;
+    /** Stable identifier for the slot within the placement */
+    slotId?: string | undefined;
 }

package/dist/cjs/api/resources/users/resources/attributions/types/CreateAttributionRequestUnion.d.ts

@@ -1,5 +1,5 @@
 import type * as KardApi from "../../../../../index.js";
-export type CreateAttributionRequestUnion = KardApi.users.CreateAttributionRequestUnion.OfferAttribution | KardApi.users.CreateAttributionRequestUnion.NotificationAttribution;
+export type CreateAttributionRequestUnion = KardApi.users.CreateAttributionRequestUnion.OfferAttribution | KardApi.users.CreateAttributionRequestUnion.NotificationAttribution | KardApi.users.CreateAttributionRequestUnion.PlacementSlotAttribution;
 export declare namespace CreateAttributionRequestUnion {
     interface OfferAttribution extends KardApi.users.OfferAttributionRequest {
         type: "offerAttribution";
@@ -7,4 +7,7 @@ export declare namespace CreateAttributionRequestUnion {
     interface NotificationAttribution extends KardApi.users.NotificationAttributionRequest {
         type: "notificationAttribution";
     }
+    interface PlacementSlotAttribution extends KardApi.users.PlacementSlotAttributionRequest {
+        type: "placementSlotAttribution";
+    }
 }

package/dist/cjs/api/resources/users/resources/attributions/types/PlacementSlotAttributionAttributes.d.ts

@@ -0,0 +1,19 @@
+import type * as KardApi from "../../../../../index.js";
+/**
+ * Attributes for a slot-level activation event on a batch-activation placement.
+ * A slot activation also writes per-offer `offerAttribution` ACTIVATE events for
+ * every offer resolved by the slot's content strategy (see `ActivatePlacementSlot`).
+ */
+export interface PlacementSlotAttributionAttributes {
+    /** The slot ID (matches `state.slotId`) */
+    entityId: string;
+    eventCode: KardApi.users.EventCode;
+    medium: KardApi.users.PlacementSlotMedium;
+    /**
+     * The timestamp of the attribution event.
+     * Must be in ISO 8601 format (e.g., "2025-01-01T00:00:00Z").
+     */
+    eventDate: string;
+    /** Placement context for the attribution event */
+    state?: KardApi.users.AttributionState | undefined;
+}

package/dist/cjs/api/resources/users/resources/attributions/types/PlacementSlotAttributionAttributes.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/attributions/types/PlacementSlotAttributionRequest.d.ts

@@ -0,0 +1,4 @@
+import type * as KardApi from "../../../../../index.js";
+export interface PlacementSlotAttributionRequest {
+    attributes: KardApi.users.PlacementSlotAttributionAttributes;
+}

package/dist/cjs/api/resources/users/resources/attributions/types/PlacementSlotAttributionRequest.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/attributions/types/PlacementSlotMedium.d.ts

@@ -0,0 +1,5 @@
+/** Where the placement-slot attribution event is taking place in your rewards experience. */
+export declare const PlacementSlotMedium: {
+    readonly Cta: "CTA";
+};
+export type PlacementSlotMedium = (typeof PlacementSlotMedium)[keyof typeof PlacementSlotMedium];

package/dist/cjs/api/resources/users/resources/attributions/types/PlacementSlotMedium.js

@@ -0,0 +1,8 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlacementSlotMedium = void 0;
+/** Where the placement-slot attribution event is taking place in your rewards experience. */
+exports.PlacementSlotMedium = {
+    Cta: "CTA",
+};

package/dist/cjs/api/resources/users/resources/attributions/types/index.d.ts

@@ -3,6 +3,9 @@ export * from "./ActivateOfferIncludeOption.js";
 export * from "./ActivateOfferResponse.js";
 export * from "./ActivateOfferResponseAttributes.js";
 export * from "./ActivateOfferResponseData.js";
+export * from "./ActivatePlacementSlotResponse.js";
+export * from "./ActivatePlacementSlotResponseAttributes.js";
+export * from "./ActivatePlacementSlotResponseData.js";
 export * from "./AttributionFilter.js";
 export * from "./AttributionState.js";
 export * from "./BoostOfferIncluded.js";
@@ -20,3 +23,6 @@ export * from "./NotificationMedium.js";
 export * from "./OfferAttributionAttributes.js";
 export * from "./OfferAttributionRequest.js";
 export * from "./OfferMedium.js";
+export * from "./PlacementSlotAttributionAttributes.js";
+export * from "./PlacementSlotAttributionRequest.js";
+export * from "./PlacementSlotMedium.js";

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

@@ -19,6 +19,9 @@ __exportStar(require("./ActivateOfferIncludeOption.js"), exports);
 __exportStar(require("./ActivateOfferResponse.js"), exports);
 __exportStar(require("./ActivateOfferResponseAttributes.js"), exports);
 __exportStar(require("./ActivateOfferResponseData.js"), exports);
+__exportStar(require("./ActivatePlacementSlotResponse.js"), exports);
+__exportStar(require("./ActivatePlacementSlotResponseAttributes.js"), exports);
+__exportStar(require("./ActivatePlacementSlotResponseData.js"), exports);
 __exportStar(require("./AttributionFilter.js"), exports);
 __exportStar(require("./AttributionState.js"), exports);
 __exportStar(require("./BoostOfferIncluded.js"), exports);
@@ -36,3 +39,6 @@ __exportStar(require("./NotificationMedium.js"), exports);
 __exportStar(require("./OfferAttributionAttributes.js"), exports);
 __exportStar(require("./OfferAttributionRequest.js"), exports);
 __exportStar(require("./OfferMedium.js"), exports);
+__exportStar(require("./PlacementSlotAttributionAttributes.js"), exports);
+__exportStar(require("./PlacementSlotAttributionRequest.js"), exports);
+__exportStar(require("./PlacementSlotMedium.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "22.3.0";
+export declare const SDK_VERSION = "22.4.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.3.0";
+exports.SDK_VERSION = "22.4.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.3.0",
-        "User-Agent": "@kard-financial/sdk/22.3.0",
+        "X-Fern-SDK-Version": "22.4.0",
+        "User-Agent": "@kard-financial/sdk/22.4.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/users/resources/attributions/client/Client.d.mts

@@ -93,4 +93,29 @@ export declare class AttributionsClient {
      */
     boost(organizationId: KardApi.OrganizationId, userId: KardApi.UserId, offerId: string, request?: KardApi.users.BoostOfferRequest, requestOptions?: AttributionsClient.RequestOptions): core.HttpResponsePromise<KardApi.users.BoostOfferResponse>;
     private __boost;
+    /**
+     * Record when a user activates a batch-activation placement slot. Writes a slot-level
+     * `placementSlotAttribution` ACTIVATE event and fans out a per-offer
+     * `offerAttribution` ACTIVATE event for every offer resolved by the slot's content
+     * strategy. The slot-level event id and the resolved `offerIds` are returned so the
+     * partner can render the batch immediately without an extra `getBatchesByPlacement`
+     * round-trip.
+     *
+     * <b>Required scopes:</b> `attributions:write`
+     *
+     * @param {KardApi.OrganizationId} organizationId
+     * @param {KardApi.UserId} userId
+     * @param {string} placementId - Unique identifier of the placement (UUID v7)
+     * @param {string} slotId - Stable identifier for the slot within the placement
+     * @param {AttributionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link KardApi.UnauthorizedError}
+     * @throws {@link KardApi.InternalServerError}
+     * @throws {@link KardApi.InvalidRequest}
+     *
+     * @example
+     *     await client.users.attributions.activatePlacementSlot("organization-123", "user-123", "018f8d6b-1abc-7def-9012-345678901234", "slot-a")
+     */
+    activatePlacementSlot(organizationId: KardApi.OrganizationId, userId: KardApi.UserId, placementId: string, slotId: string, requestOptions?: AttributionsClient.RequestOptions): core.HttpResponsePromise<KardApi.users.ActivatePlacementSlotResponse>;
+    private __activatePlacementSlot;
 }

package/dist/esm/api/resources/users/resources/attributions/client/Client.mjs

@@ -243,4 +243,71 @@ export class AttributionsClient {
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v2/issuers/{organizationId}/users/{userId}/offers/{offerId}/boost");
         });
     }
+    /**
+     * Record when a user activates a batch-activation placement slot. Writes a slot-level
+     * `placementSlotAttribution` ACTIVATE event and fans out a per-offer
+     * `offerAttribution` ACTIVATE event for every offer resolved by the slot's content
+     * strategy. The slot-level event id and the resolved `offerIds` are returned so the
+     * partner can render the batch immediately without an extra `getBatchesByPlacement`
+     * round-trip.
+     *
+     * <b>Required scopes:</b> `attributions:write`
+     *
+     * @param {KardApi.OrganizationId} organizationId
+     * @param {KardApi.UserId} userId
+     * @param {string} placementId - Unique identifier of the placement (UUID v7)
+     * @param {string} slotId - Stable identifier for the slot within the placement
+     * @param {AttributionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link KardApi.UnauthorizedError}
+     * @throws {@link KardApi.InternalServerError}
+     * @throws {@link KardApi.InvalidRequest}
+     *
+     * @example
+     *     await client.users.attributions.activatePlacementSlot("organization-123", "user-123", "018f8d6b-1abc-7def-9012-345678901234", "slot-a")
+     */
+    activatePlacementSlot(organizationId, userId, placementId, slotId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__activatePlacementSlot(organizationId, userId, placementId, slotId, requestOptions));
+    }
+    __activatePlacementSlot(organizationId, userId, placementId, slotId, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = 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)}/slot/${core.url.encodePathParam(slotId)}/activate`),
+                method: "POST",
+                headers: _headers,
+                queryParameters: 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 401:
+                        throw new KardApi.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new KardApi.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 400:
+                        throw new KardApi.InvalidRequest(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.KardApiError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v2/issuers/{organizationId}/users/{userId}/placements/{placementId}/slot/{slotId}/activate");
+        });
+    }
 }

package/dist/esm/api/resources/users/resources/attributions/types/ActivatePlacementSlotResponse.d.mts

@@ -0,0 +1,23 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Ack payload for a slot activation request.
+ *
+ * @example
+ *     {
+ *         data: {
+ *             type: "placementSlotAttribution",
+ *             id: "c94a93a7-beb9-4e58-960c-2c812f849398",
+ *             attributes: {
+ *                 placementId: "018f8d6b-1abc-7def-9012-345678901234",
+ *                 slotId: "slot-a",
+ *                 eventCode: "ACTIVATE",
+ *                 medium: "CTA",
+ *                 eventDate: "2025-01-01T00:00:00Z",
+ *                 offerIds: ["offer-1", "offer-2", "offer-3"]
+ *             }
+ *         }
+ *     }
+ */
+export interface ActivatePlacementSlotResponse {
+    data: KardApi.users.ActivatePlacementSlotResponseData;
+}

package/dist/esm/api/resources/users/resources/attributions/types/ActivatePlacementSlotResponse.mjs

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

package/dist/esm/api/resources/users/resources/attributions/types/ActivatePlacementSlotResponseAttributes.d.mts

@@ -0,0 +1,15 @@
+export interface ActivatePlacementSlotResponseAttributes {
+    /** Unique identifier of the placement */
+    placementId: string;
+    /** Stable identifier for the slot within the placement */
+    slotId: string;
+    eventCode: string;
+    medium: string;
+    eventDate: string;
+    /**
+     * All offer IDs that resolved under the slot's content strategy and had
+     * per-offer `offerAttribution` ACTIVATE events written. The partner can use
+     * this to render the batch immediately without an extra round-trip.
+     */
+    offerIds: string[];
+}

package/dist/esm/api/resources/users/resources/attributions/types/ActivatePlacementSlotResponseAttributes.mjs

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

package/dist/esm/api/resources/users/resources/attributions/types/ActivatePlacementSlotResponseData.d.mts

@@ -0,0 +1,7 @@
+import type * as KardApi from "../../../../../index.mjs";
+export interface ActivatePlacementSlotResponseData {
+    type: string;
+    /** The slot-level attribution event id */
+    id: string;
+    attributes: KardApi.users.ActivatePlacementSlotResponseAttributes;
+}

package/dist/esm/api/resources/users/resources/attributions/types/ActivatePlacementSlotResponseData.mjs

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

package/dist/esm/api/resources/users/resources/attributions/types/AttributionState.d.mts

@@ -4,4 +4,8 @@ export interface AttributionState {
     rank?: number | undefined;
     /** The active filters when the user saw the offer */
     filters?: KardApi.users.AttributionFilter[] | undefined;
+    /** Unique identifier of the placement the attribution event originated from */
+    placementId?: string | undefined;
+    /** Stable identifier for the slot within the placement */
+    slotId?: string | undefined;
 }

package/dist/esm/api/resources/users/resources/attributions/types/CreateAttributionRequestUnion.d.mts

@@ -1,5 +1,5 @@
 import type * as KardApi from "../../../../../index.mjs";
-export type CreateAttributionRequestUnion = KardApi.users.CreateAttributionRequestUnion.OfferAttribution | KardApi.users.CreateAttributionRequestUnion.NotificationAttribution;
+export type CreateAttributionRequestUnion = KardApi.users.CreateAttributionRequestUnion.OfferAttribution | KardApi.users.CreateAttributionRequestUnion.NotificationAttribution | KardApi.users.CreateAttributionRequestUnion.PlacementSlotAttribution;
 export declare namespace CreateAttributionRequestUnion {
     interface OfferAttribution extends KardApi.users.OfferAttributionRequest {
         type: "offerAttribution";
@@ -7,4 +7,7 @@ export declare namespace CreateAttributionRequestUnion {
     interface NotificationAttribution extends KardApi.users.NotificationAttributionRequest {
         type: "notificationAttribution";
     }
+    interface PlacementSlotAttribution extends KardApi.users.PlacementSlotAttributionRequest {
+        type: "placementSlotAttribution";
+    }
 }

package/dist/esm/api/resources/users/resources/attributions/types/PlacementSlotAttributionAttributes.d.mts

@@ -0,0 +1,19 @@
+import type * as KardApi from "../../../../../index.mjs";
+/**
+ * Attributes for a slot-level activation event on a batch-activation placement.
+ * A slot activation also writes per-offer `offerAttribution` ACTIVATE events for
+ * every offer resolved by the slot's content strategy (see `ActivatePlacementSlot`).
+ */
+export interface PlacementSlotAttributionAttributes {
+    /** The slot ID (matches `state.slotId`) */
+    entityId: string;
+    eventCode: KardApi.users.EventCode;
+    medium: KardApi.users.PlacementSlotMedium;
+    /**
+     * The timestamp of the attribution event.
+     * Must be in ISO 8601 format (e.g., "2025-01-01T00:00:00Z").
+     */
+    eventDate: string;
+    /** Placement context for the attribution event */
+    state?: KardApi.users.AttributionState | undefined;
+}

package/dist/esm/api/resources/users/resources/attributions/types/PlacementSlotAttributionAttributes.mjs

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

package/dist/esm/api/resources/users/resources/attributions/types/PlacementSlotAttributionRequest.d.mts

@@ -0,0 +1,4 @@
+import type * as KardApi from "../../../../../index.mjs";
+export interface PlacementSlotAttributionRequest {
+    attributes: KardApi.users.PlacementSlotAttributionAttributes;
+}

package/dist/esm/api/resources/users/resources/attributions/types/PlacementSlotAttributionRequest.mjs

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

package/dist/esm/api/resources/users/resources/attributions/types/PlacementSlotMedium.d.mts

@@ -0,0 +1,5 @@
+/** Where the placement-slot attribution event is taking place in your rewards experience. */
+export declare const PlacementSlotMedium: {
+    readonly Cta: "CTA";
+};
+export type PlacementSlotMedium = (typeof PlacementSlotMedium)[keyof typeof PlacementSlotMedium];

package/dist/esm/api/resources/users/resources/attributions/types/PlacementSlotMedium.mjs

@@ -0,0 +1,5 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Where the placement-slot attribution event is taking place in your rewards experience. */
+export const PlacementSlotMedium = {
+    Cta: "CTA",
+};

package/dist/esm/api/resources/users/resources/attributions/types/index.d.mts

@@ -3,6 +3,9 @@ export * from "./ActivateOfferIncludeOption.mjs";
 export * from "./ActivateOfferResponse.mjs";
 export * from "./ActivateOfferResponseAttributes.mjs";
 export * from "./ActivateOfferResponseData.mjs";
+export * from "./ActivatePlacementSlotResponse.mjs";
+export * from "./ActivatePlacementSlotResponseAttributes.mjs";
+export * from "./ActivatePlacementSlotResponseData.mjs";
 export * from "./AttributionFilter.mjs";
 export * from "./AttributionState.mjs";
 export * from "./BoostOfferIncluded.mjs";
@@ -20,3 +23,6 @@ export * from "./NotificationMedium.mjs";
 export * from "./OfferAttributionAttributes.mjs";
 export * from "./OfferAttributionRequest.mjs";
 export * from "./OfferMedium.mjs";
+export * from "./PlacementSlotAttributionAttributes.mjs";
+export * from "./PlacementSlotAttributionRequest.mjs";
+export * from "./PlacementSlotMedium.mjs";

package/dist/esm/api/resources/users/resources/attributions/types/index.mjs

@@ -3,6 +3,9 @@ export * from "./ActivateOfferIncludeOption.mjs";
 export * from "./ActivateOfferResponse.mjs";
 export * from "./ActivateOfferResponseAttributes.mjs";
 export * from "./ActivateOfferResponseData.mjs";
+export * from "./ActivatePlacementSlotResponse.mjs";
+export * from "./ActivatePlacementSlotResponseAttributes.mjs";
+export * from "./ActivatePlacementSlotResponseData.mjs";
 export * from "./AttributionFilter.mjs";
 export * from "./AttributionState.mjs";
 export * from "./BoostOfferIncluded.mjs";
@@ -20,3 +23,6 @@ export * from "./NotificationMedium.mjs";
 export * from "./OfferAttributionAttributes.mjs";
 export * from "./OfferAttributionRequest.mjs";
 export * from "./OfferMedium.mjs";
+export * from "./PlacementSlotAttributionAttributes.mjs";
+export * from "./PlacementSlotAttributionRequest.mjs";
+export * from "./PlacementSlotMedium.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "22.3.0";
+export declare const SDK_VERSION = "22.4.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "22.3.0";
+export const SDK_VERSION = "22.4.0";

package/package.json

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

package/reference.md

@@ -2717,6 +2717,100 @@ await client.users.attributions.boost("organization-123", "user-123", "offer-456
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.users.attributions.<a href="/src/api/resources/users/resources/attributions/client/Client.ts">activatePlacementSlot</a>(organizationId, userId, placementId, slotId) -> KardApi.ActivatePlacementSlotResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Record when a user activates a batch-activation placement slot. Writes a slot-level
+`placementSlotAttribution` ACTIVATE event and fans out a per-offer
+`offerAttribution` ACTIVATE event for every offer resolved by the slot's content
+strategy. The slot-level event id and the resolved `offerIds` are returned so the
+partner can render the batch immediately without an extra `getBatchesByPlacement`
+round-trip.
+
+<b>Required scopes:</b> `attributions:write`
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.users.attributions.activatePlacementSlot("organization-123", "user-123", "018f8d6b-1abc-7def-9012-345678901234", "slot-a");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**organizationId:** `KardApi.OrganizationId` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**userId:** `KardApi.UserId` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**placementId:** `string` — Unique identifier of the placement (UUID v7)
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**slotId:** `string` — Stable identifier for the slot within the placement
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AttributionsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>