@kard-financial/sdk 29.1.0 → 29.2.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": "29.1.0",
-        "User-Agent": "@kard-financial/sdk/29.1.0",
+        "X-Fern-SDK-Version": "29.2.0",
+        "User-Agent": "@kard-financial/sdk/29.2.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/rewards/client/Client.d.ts

@@ -87,6 +87,42 @@ export declare class RewardsClient {
      */
     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/>
+     * <b>Required scopes:</b> `rewards:read`
+     *
+     * @param {KardApi.OrganizationId} organizationId
+     * @param {KardApi.UserId} userId
+     * @param {string} placementId
+     * @param {KardApi.users.GetPlacementContentRequest} 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.placementContent("organization-123", "user-123", "placement-homepage-banner", {
+     *         include: "categories"
+     *     })
+     *
+     * @example
+     *     await client.users.rewards.placementContent("organization-123", "user-123", "placement-weekly-bundles", {
+     *         supportedComponents: "baseReward"
+     *     })
+     */
+    placementContent(organizationId: KardApi.OrganizationId, userId: KardApi.UserId, placementId: string, request?: KardApi.users.GetPlacementContentRequest, requestOptions?: RewardsClient.RequestOptions): core.HttpResponsePromise<KardApi.users.PlacementContentResponse>;
+    private __placementContent;
     /**
      * Retrieve national and local geographic locations that a specified user has eligible in-store offers at. Use this endpoint to build
      * out your [map-specific UX experiences](/2024-10-01/api/getting-started#c-discover-clos-near-you-map-view). Please note

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

@@ -294,6 +294,95 @@ class RewardsClient {
             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/>
+     * <b>Required scopes:</b> `rewards:read`
+     *
+     * @param {KardApi.OrganizationId} organizationId
+     * @param {KardApi.UserId} userId
+     * @param {string} placementId
+     * @param {KardApi.users.GetPlacementContentRequest} 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.placementContent("organization-123", "user-123", "placement-homepage-banner", {
+     *         include: "categories"
+     *     })
+     *
+     * @example
+     *     await client.users.rewards.placementContent("organization-123", "user-123", "placement-weekly-bundles", {
+     *         supportedComponents: "baseReward"
+     *     })
+     */
+    placementContent(organizationId, userId, placementId, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__placementContent(organizationId, userId, placementId, request, requestOptions));
+    }
+    __placementContent(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 { include, supportedComponents } = request;
+            const _queryParams = {
+                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)}/content`),
+                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}/content");
+        });
+    }
     /**
      * Retrieve national and local geographic locations that a specified user has eligible in-store offers at. Use this endpoint to build
      * out your [map-specific UX experiences](/2024-10-01/api/getting-started#c-discover-clos-near-you-map-view). Please note

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

@@ -0,0 +1,18 @@
+import type * as KardApi from "../../../../../../index.js";
+/**
+ * @example
+ *     {
+ *         include: "categories"
+ *     }
+ *
+ * @example
+ *     {
+ *         supportedComponents: "baseReward"
+ *     }
+ */
+export interface GetPlacementContentRequest {
+    /** CSV list of included resources in the response (e.g "categories"). Allowed value is `categories`. Only applies to standard placements (those returning `standardOffer` resources). */
+    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/GetPlacementContentRequest.js

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

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

@@ -2,3 +2,4 @@ export type { GetBatchesByPlacementRequest } from "./GetBatchesByPlacementReques
 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/PlacementContentData.d.ts

@@ -0,0 +1,5 @@
+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

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

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

@@ -0,0 +1,10 @@
+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.
+ */
+export interface PlacementContentResponse {
+    data: KardApi.users.PlacementContentData[];
+    links?: KardApi.Links | undefined;
+    included?: KardApi.users.EligibilityOfferIncluded[] | undefined;
+    meta?: KardApi.users.OffersMeta | undefined;
+}

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

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

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

@@ -41,6 +41,8 @@ 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";
 export * from "./ProgressBarLabels.js";

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

@@ -57,6 +57,8 @@ __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);
 __exportStar(require("./ProgressBarLabels.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "29.1.0";
+export declare const SDK_VERSION = "29.2.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.1.0";
+exports.SDK_VERSION = "29.2.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.1.0",
-        "User-Agent": "@kard-financial/sdk/29.1.0",
+        "X-Fern-SDK-Version": "29.2.0",
+        "User-Agent": "@kard-financial/sdk/29.2.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/rewards/client/Client.d.mts

@@ -87,6 +87,42 @@ export declare class RewardsClient {
      */
     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/>
+     * <b>Required scopes:</b> `rewards:read`
+     *
+     * @param {KardApi.OrganizationId} organizationId
+     * @param {KardApi.UserId} userId
+     * @param {string} placementId
+     * @param {KardApi.users.GetPlacementContentRequest} 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.placementContent("organization-123", "user-123", "placement-homepage-banner", {
+     *         include: "categories"
+     *     })
+     *
+     * @example
+     *     await client.users.rewards.placementContent("organization-123", "user-123", "placement-weekly-bundles", {
+     *         supportedComponents: "baseReward"
+     *     })
+     */
+    placementContent(organizationId: KardApi.OrganizationId, userId: KardApi.UserId, placementId: string, request?: KardApi.users.GetPlacementContentRequest, requestOptions?: RewardsClient.RequestOptions): core.HttpResponsePromise<KardApi.users.PlacementContentResponse>;
+    private __placementContent;
     /**
      * Retrieve national and local geographic locations that a specified user has eligible in-store offers at. Use this endpoint to build
      * out your [map-specific UX experiences](/2024-10-01/api/getting-started#c-discover-clos-near-you-map-view). Please note

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

@@ -258,6 +258,95 @@ export class RewardsClient {
             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/>
+     * <b>Required scopes:</b> `rewards:read`
+     *
+     * @param {KardApi.OrganizationId} organizationId
+     * @param {KardApi.UserId} userId
+     * @param {string} placementId
+     * @param {KardApi.users.GetPlacementContentRequest} 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.placementContent("organization-123", "user-123", "placement-homepage-banner", {
+     *         include: "categories"
+     *     })
+     *
+     * @example
+     *     await client.users.rewards.placementContent("organization-123", "user-123", "placement-weekly-bundles", {
+     *         supportedComponents: "baseReward"
+     *     })
+     */
+    placementContent(organizationId, userId, placementId, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__placementContent(organizationId, userId, placementId, request, requestOptions));
+    }
+    __placementContent(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 { include, supportedComponents } = request;
+            const _queryParams = {
+                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)}/content`),
+                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}/content");
+        });
+    }
     /**
      * Retrieve national and local geographic locations that a specified user has eligible in-store offers at. Use this endpoint to build
      * out your [map-specific UX experiences](/2024-10-01/api/getting-started#c-discover-clos-near-you-map-view). Please note

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

@@ -0,0 +1,18 @@
+import type * as KardApi from "../../../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         include: "categories"
+ *     }
+ *
+ * @example
+ *     {
+ *         supportedComponents: "baseReward"
+ *     }
+ */
+export interface GetPlacementContentRequest {
+    /** CSV list of included resources in the response (e.g "categories"). Allowed value is `categories`. Only applies to standard placements (those returning `standardOffer` resources). */
+    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/GetPlacementContentRequest.mjs

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

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

@@ -2,3 +2,4 @@ export type { GetBatchesByPlacementRequest } from "./GetBatchesByPlacementReques
 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/PlacementContentData.d.mts

@@ -0,0 +1,5 @@
+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

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

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

@@ -0,0 +1,10 @@
+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.
+ */
+export interface PlacementContentResponse {
+    data: KardApi.users.PlacementContentData[];
+    links?: KardApi.Links | undefined;
+    included?: KardApi.users.EligibilityOfferIncluded[] | undefined;
+    meta?: KardApi.users.OffersMeta | undefined;
+}

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

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

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

@@ -41,6 +41,8 @@ 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";
 export * from "./ProgressBarLabels.mjs";

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

@@ -41,6 +41,8 @@ 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";
 export * from "./ProgressBarLabels.mjs";

package/dist/esm/version.d.mts

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

package/dist/esm/version.mjs

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

package/package.json

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

package/reference.md

@@ -3158,6 +3158,105 @@ await client.users.rewards.placementBatches("organizationId", "userId", "placeme
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.users.rewards.<a href="/src/api/resources/users/resources/rewards/client/Client.ts">placementContent</a>(organizationId, userId, placementId, { ...params }) -> KardApi.PlacementContentResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+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/>
+<b>Required scopes:</b> `rewards:read`
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.users.rewards.placementContent("organization-123", "user-123", "placement-homepage-banner", {
+    include: "categories"
+});
+
+```
+</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.GetPlacementContentRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `RewardsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>