@kard-financial/sdk 29.2.0 → 30.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kard Financial
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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": "29.2.0",
-        "User-Agent": "@kard-financial/sdk/29.2.0",
+        "X-Fern-SDK-Version": "30.1.0",
+        "User-Agent": "@kard-financial/sdk/30.1.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

@@ -98,8 +98,8 @@ export declare class AttributionsClient {
      * `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.
+     * partner can render the batch immediately without an extra round-trip to re-fetch
+     * the placement content.
      *
      * <b>Required scopes:</b> `attributions:write`
      *

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

@@ -284,8 +284,8 @@ class AttributionsClient {
      * `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.
+     * partner can render the batch immediately without an extra round-trip to re-fetch
+     * the placement content.
      *
      * <b>Required scopes:</b> `attributions:write`
      *

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

@@ -35,69 +35,16 @@ export declare class RewardsClient {
      */
     offers(organizationId: KardApi.OrganizationId, userId: KardApi.UserId, request?: KardApi.users.GetOffersByUserRequest, requestOptions?: RewardsClient.RequestOptions): core.HttpResponsePromise<KardApi.users.OffersResponseObject>;
     private __offers;
-    /**
-     * Retrieve offers for a placement slot. Returns offers sorted by highest cash back,
-     * limited by the placement's available slots.<br/>
-     * <b>Required scopes:</b> `rewards:read`
-     *
-     * @param {KardApi.OrganizationId} organizationId
-     * @param {KardApi.UserId} userId
-     * @param {string} placementId
-     * @param {KardApi.users.GetOffersByPlacementRequest} 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.placementOffers("organizationId", "userId", "placementId")
-     */
-    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 or group placement. Returns each
-     * slot in slot order with its current offer set, alias, and freshness fields
-     * (`isActive`, `lastActivatedAt`, `expiresAt`). Applies the same per-user
-     * eligibility and per-slot content-strategy filter as Get Offers By
-     * Placement, independently per slot. For a batch-activation placement, a
-     * slot only flips to `isActive: false` when its refresh interval has elapsed
-     * AND its post-eligibility `offers[]` is non-empty; otherwise the slot is
-     * still returned and stays active so the partner UI does not promote
-     * "refresh" with nothing to show. For a group placement, slots are always
-     * active and each slot returns its offers regardless of activation state,
-     * hiding only offers that require activation (`requiredInBatch`) and have
-     * no activation record.<br/>
-     * <b>Required scopes:</b> `rewards:read`
-     *
-     * @param {KardApi.OrganizationId} organizationId
-     * @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 the content for a placement. The placement type is resolved
      * server-side so callers no longer pick an endpoint by placement type.
      * Returns a JSON:API document whose `data` resources are self-describing
-     * by `type`: a standard placement returns `standardOffer` resources (the
-     * same payload as Get Offers By Placement — with `links`, optional
-     * `included` categories, and `meta`); a batch-activation or group
-     * placement returns `placementBatch` slot resources (the same payload as
-     * Get Batches By Placement). Distinguish the two by each resource's
-     * `type`. Email and push-notification placements are not servable through
-     * this endpoint and respond with a `400`.<br/>
+     * by `type`: a standard placement returns `standardOffer` resources (with
+     * `links`, optional `included` categories, and `meta`); a batch-activation
+     * or group placement returns `placementBatch` slot resources. Distinguish
+     * the two by each resource's `type`. Email and push-notification
+     * placements are not servable through this endpoint and respond with a
+     * `400`.<br/>
      * <b>Required scopes:</b> `rewards:read`
      *
      * @param {KardApi.OrganizationId} organizationId

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

@@ -139,172 +139,16 @@ class RewardsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v2/issuers/{organizationId}/users/{userId}/offers");
         });
     }
-    /**
-     * Retrieve offers for a placement slot. Returns offers sorted by highest cash back,
-     * limited by the placement's available slots.<br/>
-     * <b>Required scopes:</b> `rewards:read`
-     *
-     * @param {KardApi.OrganizationId} organizationId
-     * @param {KardApi.UserId} userId
-     * @param {string} placementId
-     * @param {KardApi.users.GetOffersByPlacementRequest} 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.placementOffers("organizationId", "userId", "placementId")
-     */
-    placementOffers(organizationId, userId, placementId, request = {}, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__placementOffers(organizationId, userId, placementId, request, requestOptions));
-    }
-    __placementOffers(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 { "filter[search]": filterSearch, "filter[purchaseChannel]": filterPurchaseChannel, "filter[category]": filterCategory, "filter[isTargeted]": filterIsTargeted, include, supportedComponents, } = request;
-            const _queryParams = {
-                "filter[search]": filterSearch,
-                "filter[purchaseChannel]": filterPurchaseChannel != null ? (0, json_js_1.toJson)(filterPurchaseChannel) : undefined,
-                "filter[category]": filterCategory != null ? filterCategory : undefined,
-                "filter[isTargeted]": filterIsTargeted,
-                include,
-                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)}/offers`),
-                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}/offers");
-        });
-    }
-    /**
-     * Retrieve batches for a batch-activation or group placement. Returns each
-     * slot in slot order with its current offer set, alias, and freshness fields
-     * (`isActive`, `lastActivatedAt`, `expiresAt`). Applies the same per-user
-     * eligibility and per-slot content-strategy filter as Get Offers By
-     * Placement, independently per slot. For a batch-activation placement, a
-     * slot only flips to `isActive: false` when its refresh interval has elapsed
-     * AND its post-eligibility `offers[]` is non-empty; otherwise the slot is
-     * still returned and stays active so the partner UI does not promote
-     * "refresh" with nothing to show. For a group placement, slots are always
-     * active and each slot returns its offers regardless of activation state,
-     * hiding only offers that require activation (`requiredInBatch`) and have
-     * no activation record.<br/>
-     * <b>Required scopes:</b> `rewards:read`
-     *
-     * @param {KardApi.OrganizationId} organizationId
-     * @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 the content for a placement. The placement type is resolved
      * server-side so callers no longer pick an endpoint by placement type.
      * Returns a JSON:API document whose `data` resources are self-describing
-     * by `type`: a standard placement returns `standardOffer` resources (the
-     * same payload as Get Offers By Placement — with `links`, optional
-     * `included` categories, and `meta`); a batch-activation or group
-     * placement returns `placementBatch` slot resources (the same payload as
-     * Get Batches By Placement). Distinguish the two by each resource's
-     * `type`. Email and push-notification placements are not servable through
-     * this endpoint and respond with a `400`.<br/>
+     * by `type`: a standard placement returns `standardOffer` resources (with
+     * `links`, optional `included` categories, and `meta`); a batch-activation
+     * or group placement returns `placementBatch` slot resources. Distinguish
+     * the two by each resource's `type`. Email and push-notification
+     * placements are not servable through this endpoint and respond with a
+     * `400`.<br/>
      * <b>Required scopes:</b> `rewards:read`
      *
      * @param {KardApi.OrganizationId} organizationId

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * Metadata about the placement.
+ */
+export interface BatchesMeta {
+    /** Display name of the placement, resolved server-side from its id. */
+    placementName?: string | undefined;
+}

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

@@ -4,4 +4,5 @@ import type * as KardApi from "../../../../../index.js";
  */
 export interface BatchesResponseObject {
     data: KardApi.users.PlacementBatchData[];
+    meta?: KardApi.users.BatchesMeta | undefined;
 }

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

@@ -5,4 +5,6 @@ import type * as KardApi from "../../../../../index.js";
 export interface OffersMeta {
     /** All distinct categories available across the entire filtered result set, not just the current page */
     availableCategories?: KardApi.users.CategoryIncluded[] | undefined;
+    /** Display name of the placement, resolved server-side from its id. Populated only on the Get Placement Content endpoint; absent on the Get Offers By User endpoint. */
+    placementName?: string | undefined;
 }

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

@@ -1,10 +1,5 @@
 import type * as KardApi from "../../../../../index.js";
 /**
- * Combined placement-content response, shaped as a JSON:API document. The placement is resolved server-side: a standard placement yields `standardOffer` resources (with `links`, optional `included` categories, and `meta`), while a batch-activation or group placement yields `placementBatch` slot resources. Callers distinguish the two by each resource's `type` rather than a separate discriminator, and the payload mirrors Get Offers By Placement / Get Batches By Placement exactly.
+ * Combined placement-content response. The placement is resolved server-side and the response is returned verbatim as one of two variants: a standard placement yields the offers response (`standardOffer` resources with `links`, optional `included` categories, and `meta`), while a batch-activation or group placement yields the batches response (`placementBatch` slot resources). Callers distinguish the two by each resource's `type` rather than a separate discriminator.
  */
-export interface PlacementContentResponse {
-    data: KardApi.users.PlacementContentData[];
-    links?: KardApi.Links | undefined;
-    included?: KardApi.users.EligibilityOfferIncluded[] | undefined;
-    meta?: KardApi.users.OffersMeta | undefined;
-}
+export type PlacementContentResponse = KardApi.users.OffersResponseObject | KardApi.users.BatchesResponseObject;

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

@@ -1,6 +1,7 @@
 export * from "./Amount.js";
 export * from "./AmountType.js";
 export * from "./Asset.js";
+export * from "./BatchesMeta.js";
 export * from "./BatchesResponseObject.js";
 export * from "./ButtonStyle.js";
 export * from "./CategoryData.js";
@@ -41,7 +42,6 @@ export * from "./OperationPeriod.js";
 export * from "./OperationTime.js";
 export * from "./PlacementBatchAttributes.js";
 export * from "./PlacementBatchData.js";
-export * from "./PlacementContentData.js";
 export * from "./PlacementContentResponse.js";
 export * from "./ProgressBar.js";
 export * from "./ProgressBarLabelPair.js";

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

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./Amount.js"), exports);
 __exportStar(require("./AmountType.js"), exports);
 __exportStar(require("./Asset.js"), exports);
+__exportStar(require("./BatchesMeta.js"), exports);
 __exportStar(require("./BatchesResponseObject.js"), exports);
 __exportStar(require("./ButtonStyle.js"), exports);
 __exportStar(require("./CategoryData.js"), exports);
@@ -57,7 +58,6 @@ __exportStar(require("./OperationPeriod.js"), exports);
 __exportStar(require("./OperationTime.js"), exports);
 __exportStar(require("./PlacementBatchAttributes.js"), exports);
 __exportStar(require("./PlacementBatchData.js"), exports);
-__exportStar(require("./PlacementContentData.js"), exports);
 __exportStar(require("./PlacementContentResponse.js"), exports);
 __exportStar(require("./ProgressBar.js"), exports);
 __exportStar(require("./ProgressBarLabelPair.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "29.2.0";
+export declare const SDK_VERSION = "30.1.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 = "29.2.0";
+exports.SDK_VERSION = "30.1.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": "29.2.0",
-        "User-Agent": "@kard-financial/sdk/29.2.0",
+        "X-Fern-SDK-Version": "30.1.0",
+        "User-Agent": "@kard-financial/sdk/30.1.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

@@ -98,8 +98,8 @@ export declare class AttributionsClient {
      * `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.
+     * partner can render the batch immediately without an extra round-trip to re-fetch
+     * the placement content.
      *
      * <b>Required scopes:</b> `attributions:write`
      *

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

@@ -248,8 +248,8 @@ export class AttributionsClient {
      * `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.
+     * partner can render the batch immediately without an extra round-trip to re-fetch
+     * the placement content.
      *
      * <b>Required scopes:</b> `attributions:write`
      *

package/dist/esm/api/resources/users/resources/rewards/client/Client.d.mts

@@ -35,69 +35,16 @@ export declare class RewardsClient {
      */
     offers(organizationId: KardApi.OrganizationId, userId: KardApi.UserId, request?: KardApi.users.GetOffersByUserRequest, requestOptions?: RewardsClient.RequestOptions): core.HttpResponsePromise<KardApi.users.OffersResponseObject>;
     private __offers;
-    /**
-     * Retrieve offers for a placement slot. Returns offers sorted by highest cash back,
-     * limited by the placement's available slots.<br/>
-     * <b>Required scopes:</b> `rewards:read`
-     *
-     * @param {KardApi.OrganizationId} organizationId
-     * @param {KardApi.UserId} userId
-     * @param {string} placementId
-     * @param {KardApi.users.GetOffersByPlacementRequest} 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.placementOffers("organizationId", "userId", "placementId")
-     */
-    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 or group placement. Returns each
-     * slot in slot order with its current offer set, alias, and freshness fields
-     * (`isActive`, `lastActivatedAt`, `expiresAt`). Applies the same per-user
-     * eligibility and per-slot content-strategy filter as Get Offers By
-     * Placement, independently per slot. For a batch-activation placement, a
-     * slot only flips to `isActive: false` when its refresh interval has elapsed
-     * AND its post-eligibility `offers[]` is non-empty; otherwise the slot is
-     * still returned and stays active so the partner UI does not promote
-     * "refresh" with nothing to show. For a group placement, slots are always
-     * active and each slot returns its offers regardless of activation state,
-     * hiding only offers that require activation (`requiredInBatch`) and have
-     * no activation record.<br/>
-     * <b>Required scopes:</b> `rewards:read`
-     *
-     * @param {KardApi.OrganizationId} organizationId
-     * @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 the content for a placement. The placement type is resolved
      * server-side so callers no longer pick an endpoint by placement type.
      * Returns a JSON:API document whose `data` resources are self-describing
-     * by `type`: a standard placement returns `standardOffer` resources (the
-     * same payload as Get Offers By Placement — with `links`, optional
-     * `included` categories, and `meta`); a batch-activation or group
-     * placement returns `placementBatch` slot resources (the same payload as
-     * Get Batches By Placement). Distinguish the two by each resource's
-     * `type`. Email and push-notification placements are not servable through
-     * this endpoint and respond with a `400`.<br/>
+     * by `type`: a standard placement returns `standardOffer` resources (with
+     * `links`, optional `included` categories, and `meta`); a batch-activation
+     * or group placement returns `placementBatch` slot resources. Distinguish
+     * the two by each resource's `type`. Email and push-notification
+     * placements are not servable through this endpoint and respond with a
+     * `400`.<br/>
      * <b>Required scopes:</b> `rewards:read`
      *
      * @param {KardApi.OrganizationId} organizationId

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

@@ -103,172 +103,16 @@ export class RewardsClient {
             return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v2/issuers/{organizationId}/users/{userId}/offers");
         });
     }
-    /**
-     * Retrieve offers for a placement slot. Returns offers sorted by highest cash back,
-     * limited by the placement's available slots.<br/>
-     * <b>Required scopes:</b> `rewards:read`
-     *
-     * @param {KardApi.OrganizationId} organizationId
-     * @param {KardApi.UserId} userId
-     * @param {string} placementId
-     * @param {KardApi.users.GetOffersByPlacementRequest} 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.placementOffers("organizationId", "userId", "placementId")
-     */
-    placementOffers(organizationId, userId, placementId, request = {}, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__placementOffers(organizationId, userId, placementId, request, requestOptions));
-    }
-    __placementOffers(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 { "filter[search]": filterSearch, "filter[purchaseChannel]": filterPurchaseChannel, "filter[category]": filterCategory, "filter[isTargeted]": filterIsTargeted, include, supportedComponents, } = request;
-            const _queryParams = {
-                "filter[search]": filterSearch,
-                "filter[purchaseChannel]": filterPurchaseChannel != null ? toJson(filterPurchaseChannel) : undefined,
-                "filter[category]": filterCategory != null ? filterCategory : undefined,
-                "filter[isTargeted]": filterIsTargeted,
-                include,
-                supportedComponents: Array.isArray(supportedComponents)
-                    ? supportedComponents.map((item) => item)
-                    : supportedComponents != null
-                        ? supportedComponents
-                        : undefined,
-            };
-            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)}/offers`),
-                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 handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v2/issuers/{organizationId}/users/{userId}/placements/{placementId}/offers");
-        });
-    }
-    /**
-     * Retrieve batches for a batch-activation or group placement. Returns each
-     * slot in slot order with its current offer set, alias, and freshness fields
-     * (`isActive`, `lastActivatedAt`, `expiresAt`). Applies the same per-user
-     * eligibility and per-slot content-strategy filter as Get Offers By
-     * Placement, independently per slot. For a batch-activation placement, a
-     * slot only flips to `isActive: false` when its refresh interval has elapsed
-     * AND its post-eligibility `offers[]` is non-empty; otherwise the slot is
-     * still returned and stays active so the partner UI does not promote
-     * "refresh" with nothing to show. For a group placement, slots are always
-     * active and each slot returns its offers regardless of activation state,
-     * hiding only offers that require activation (`requiredInBatch`) and have
-     * no activation record.<br/>
-     * <b>Required scopes:</b> `rewards:read`
-     *
-     * @param {KardApi.OrganizationId} organizationId
-     * @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 = 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 handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v2/issuers/{organizationId}/users/{userId}/placements/{placementId}/batches");
-        });
-    }
     /**
      * Retrieve the content for a placement. The placement type is resolved
      * server-side so callers no longer pick an endpoint by placement type.
      * Returns a JSON:API document whose `data` resources are self-describing
-     * by `type`: a standard placement returns `standardOffer` resources (the
-     * same payload as Get Offers By Placement — with `links`, optional
-     * `included` categories, and `meta`); a batch-activation or group
-     * placement returns `placementBatch` slot resources (the same payload as
-     * Get Batches By Placement). Distinguish the two by each resource's
-     * `type`. Email and push-notification placements are not servable through
-     * this endpoint and respond with a `400`.<br/>
+     * by `type`: a standard placement returns `standardOffer` resources (with
+     * `links`, optional `included` categories, and `meta`); a batch-activation
+     * or group placement returns `placementBatch` slot resources. Distinguish
+     * the two by each resource's `type`. Email and push-notification
+     * placements are not servable through this endpoint and respond with a
+     * `400`.<br/>
      * <b>Required scopes:</b> `rewards:read`
      *
      * @param {KardApi.OrganizationId} organizationId

package/dist/esm/api/resources/users/resources/rewards/client/requests/index.d.mts

@@ -1,5 +1,3 @@
-export type { GetBatchesByPlacementRequest } from "./GetBatchesByPlacementRequest.mjs";
 export type { GetLocationsByUserRequest } from "./GetLocationsByUserRequest.mjs";
-export type { GetOffersByPlacementRequest } from "./GetOffersByPlacementRequest.mjs";
 export type { GetOffersByUserRequest } from "./GetOffersByUserRequest.mjs";
 export type { GetPlacementContentRequest } from "./GetPlacementContentRequest.mjs";

package/dist/esm/api/resources/users/resources/rewards/types/BatchesMeta.d.mts

@@ -0,0 +1,7 @@
+/**
+ * Metadata about the placement.
+ */
+export interface BatchesMeta {
+    /** Display name of the placement, resolved server-side from its id. */
+    placementName?: string | undefined;
+}

package/dist/esm/api/resources/users/resources/rewards/types/BatchesResponseObject.d.mts

@@ -4,4 +4,5 @@ import type * as KardApi from "../../../../../index.mjs";
  */
 export interface BatchesResponseObject {
     data: KardApi.users.PlacementBatchData[];
+    meta?: KardApi.users.BatchesMeta | undefined;
 }

package/dist/esm/api/resources/users/resources/rewards/types/OffersMeta.d.mts

@@ -5,4 +5,6 @@ import type * as KardApi from "../../../../../index.mjs";
 export interface OffersMeta {
     /** All distinct categories available across the entire filtered result set, not just the current page */
     availableCategories?: KardApi.users.CategoryIncluded[] | undefined;
+    /** Display name of the placement, resolved server-side from its id. Populated only on the Get Placement Content endpoint; absent on the Get Offers By User endpoint. */
+    placementName?: string | undefined;
 }

package/dist/esm/api/resources/users/resources/rewards/types/PlacementContentResponse.d.mts

@@ -1,10 +1,5 @@
 import type * as KardApi from "../../../../../index.mjs";
 /**
- * Combined placement-content response, shaped as a JSON:API document. The placement is resolved server-side: a standard placement yields `standardOffer` resources (with `links`, optional `included` categories, and `meta`), while a batch-activation or group placement yields `placementBatch` slot resources. Callers distinguish the two by each resource's `type` rather than a separate discriminator, and the payload mirrors Get Offers By Placement / Get Batches By Placement exactly.
+ * Combined placement-content response. The placement is resolved server-side and the response is returned verbatim as one of two variants: a standard placement yields the offers response (`standardOffer` resources with `links`, optional `included` categories, and `meta`), while a batch-activation or group placement yields the batches response (`placementBatch` slot resources). Callers distinguish the two by each resource's `type` rather than a separate discriminator.
  */
-export interface PlacementContentResponse {
-    data: KardApi.users.PlacementContentData[];
-    links?: KardApi.Links | undefined;
-    included?: KardApi.users.EligibilityOfferIncluded[] | undefined;
-    meta?: KardApi.users.OffersMeta | undefined;
-}
+export type PlacementContentResponse = KardApi.users.OffersResponseObject | KardApi.users.BatchesResponseObject;

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

@@ -1,6 +1,7 @@
 export * from "./Amount.mjs";
 export * from "./AmountType.mjs";
 export * from "./Asset.mjs";
+export * from "./BatchesMeta.mjs";
 export * from "./BatchesResponseObject.mjs";
 export * from "./ButtonStyle.mjs";
 export * from "./CategoryData.mjs";
@@ -41,7 +42,6 @@ export * from "./OperationPeriod.mjs";
 export * from "./OperationTime.mjs";
 export * from "./PlacementBatchAttributes.mjs";
 export * from "./PlacementBatchData.mjs";
-export * from "./PlacementContentData.mjs";
 export * from "./PlacementContentResponse.mjs";
 export * from "./ProgressBar.mjs";
 export * from "./ProgressBarLabelPair.mjs";

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

@@ -1,6 +1,7 @@
 export * from "./Amount.mjs";
 export * from "./AmountType.mjs";
 export * from "./Asset.mjs";
+export * from "./BatchesMeta.mjs";
 export * from "./BatchesResponseObject.mjs";
 export * from "./ButtonStyle.mjs";
 export * from "./CategoryData.mjs";
@@ -41,7 +42,6 @@ export * from "./OperationPeriod.mjs";
 export * from "./OperationTime.mjs";
 export * from "./PlacementBatchAttributes.mjs";
 export * from "./PlacementBatchData.mjs";
-export * from "./PlacementContentData.mjs";
 export * from "./PlacementContentResponse.mjs";
 export * from "./ProgressBar.mjs";
 export * from "./ProgressBarLabelPair.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "29.2.0";
+export declare const SDK_VERSION = "30.1.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "29.2.0";
+export const SDK_VERSION = "30.1.0";

package/package.json

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

package/reference.md

@@ -2737,8 +2737,8 @@ Record when a user activates a batch-activation placement slot. Writes a slot-le
 `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.
+partner can render the batch immediately without an extra round-trip to re-fetch
+the placement content.
 
 <b>Required scopes:</b> `attributions:write`
 </dd>
@@ -2970,194 +2970,6 @@ await client.users.rewards.offers("organization-123", "user-123", {
 </dl>
 
 
-</dd>
-</dl>
-</details>
-
-<details><summary><code>client.users.rewards.<a href="/src/api/resources/users/resources/rewards/client/Client.ts">placementOffers</a>(organizationId, userId, placementId, { ...params }) -> KardApi.OffersResponseObject</code></summary>
-<dl>
-<dd>
-
-#### 📝 Description
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-Retrieve offers for a placement slot. Returns offers sorted by highest cash back,
-limited by the placement's available slots.<br/>
-<b>Required scopes:</b> `rewards:read`
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### 🔌 Usage
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-```typescript
-await client.users.rewards.placementOffers("organizationId", "userId", "placementId");
-
-```
-</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` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `KardApi.users.GetOffersByPlacementRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `RewardsClient.RequestOptions` 
-    
-</dd>
-</dl>
-</dd>
-</dl>
-
-
-</dd>
-</dl>
-</details>
-
-<details><summary><code>client.users.rewards.<a href="/src/api/resources/users/resources/rewards/client/Client.ts">placementBatches</a>(organizationId, userId, placementId, { ...params }) -> KardApi.BatchesResponseObject</code></summary>
-<dl>
-<dd>
-
-#### 📝 Description
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-Retrieve batches for a batch-activation or group placement. Returns each
-slot in slot order with its current offer set, alias, and freshness fields
-(`isActive`, `lastActivatedAt`, `expiresAt`). Applies the same per-user
-eligibility and per-slot content-strategy filter as Get Offers By
-Placement, independently per slot. For a batch-activation placement, a
-slot only flips to `isActive: false` when its refresh interval has elapsed
-AND its post-eligibility `offers[]` is non-empty; otherwise the slot is
-still returned and stays active so the partner UI does not promote
-"refresh" with nothing to show. For a group placement, slots are always
-active and each slot returns its offers regardless of activation state,
-hiding only offers that require activation (`requiredInBatch`) and have
-no activation record.<br/>
-<b>Required scopes:</b> `rewards:read`
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### 🔌 Usage
-
-<dl>
-<dd>
-
-<dl>
-<dd>
-
-```typescript
-await client.users.rewards.placementBatches("organizationId", "userId", "placementId");
-
-```
-</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` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**request:** `KardApi.users.GetBatchesByPlacementRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
-**requestOptions:** `RewardsClient.RequestOptions` 
-    
-</dd>
-</dl>
-</dd>
-</dl>
-
-
 </dd>
 </dl>
 </details>
@@ -3177,13 +2989,12 @@ await client.users.rewards.placementBatches("organizationId", "userId", "placeme
 Retrieve the content for a placement. The placement type is resolved
 server-side so callers no longer pick an endpoint by placement type.
 Returns a JSON:API document whose `data` resources are self-describing
-by `type`: a standard placement returns `standardOffer` resources (the
-same payload as Get Offers By Placement — with `links`, optional
-`included` categories, and `meta`); a batch-activation or group
-placement returns `placementBatch` slot resources (the same payload as
-Get Batches By Placement). Distinguish the two by each resource's
-`type`. Email and push-notification placements are not servable through
-this endpoint and respond with a `400`.<br/>
+by `type`: a standard placement returns `standardOffer` resources (with
+`links`, optional `included` categories, and `meta`); a batch-activation
+or group placement returns `placementBatch` slot resources. Distinguish
+the two by each resource's `type`. Email and push-notification
+placements are not servable through this endpoint and respond with a
+`400`.<br/>
 <b>Required scopes:</b> `rewards:read`
 </dd>
 </dl>

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

@@ -1,9 +0,0 @@
-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/GetOffersByPlacementRequest.d.ts

@@ -1,16 +0,0 @@
-import type * as KardApi from "../../../../../../index.js";
-/**
- * @example
- *     {}
- */
-export interface GetOffersByPlacementRequest {
-    /** Case-insensitive search string to filter offers by merchant name */
-    "filter[search]"?: string;
-    "filter[purchaseChannel]"?: KardApi.PurchaseChannel[];
-    "filter[category]"?: KardApi.CategoryOption;
-    "filter[isTargeted]"?: boolean;
-    /** CSV list of included resources in the response (e.g "categories"). Allowed value is `categories`. */
-    include?: string | string[];
-    /** 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/GetOffersByPlacementRequest.js

@@ -1,3 +0,0 @@
-"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/PlacementContentData.d.ts

@@ -1,5 +0,0 @@
-import type * as KardApi from "../../../../../index.js";
-/**
- * A single placement-content resource: a `standardOffer` (returned for a standard placement) or a `placementBatch` slot (returned for a batch-activation or group placement). Discriminate on the resource `type`.
- */
-export type PlacementContentData = KardApi.users.OfferDataUnion | KardApi.users.PlacementBatchData;

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

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

package/dist/esm/api/resources/users/resources/rewards/client/requests/GetBatchesByPlacementRequest.d.mts

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

package/dist/esm/api/resources/users/resources/rewards/client/requests/GetOffersByPlacementRequest.d.mts

@@ -1,16 +0,0 @@
-import type * as KardApi from "../../../../../../index.mjs";
-/**
- * @example
- *     {}
- */
-export interface GetOffersByPlacementRequest {
-    /** Case-insensitive search string to filter offers by merchant name */
-    "filter[search]"?: string;
-    "filter[purchaseChannel]"?: KardApi.PurchaseChannel[];
-    "filter[category]"?: KardApi.CategoryOption;
-    "filter[isTargeted]"?: boolean;
-    /** CSV list of included resources in the response (e.g "categories"). Allowed value is `categories`. */
-    include?: string | string[];
-    /** UI component types to include in the response. */
-    supportedComponents?: KardApi.users.ComponentType | KardApi.users.ComponentType[];
-}

package/dist/esm/api/resources/users/resources/rewards/client/requests/GetOffersByPlacementRequest.mjs

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

package/dist/esm/api/resources/users/resources/rewards/types/PlacementContentData.d.mts

@@ -1,5 +0,0 @@
-import type * as KardApi from "../../../../../index.mjs";
-/**
- * A single placement-content resource: a `standardOffer` (returned for a standard placement) or a `placementBatch` slot (returned for a batch-activation or group placement). Discriminate on the resource `type`.
- */
-export type PlacementContentData = KardApi.users.OfferDataUnion | KardApi.users.PlacementBatchData;

package/dist/esm/api/resources/users/resources/rewards/types/PlacementContentData.mjs

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