@naturalpay/sdk 1.6.37 → 1.6.38

package/dist/esm/api/resources/cardSessions/client/Client.mjs

@@ -8,6 +8,17 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 import { normalizeClientOptionsWithAuth } from "../../../../BaseClient.mjs";
 import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.mjs";
 import * as core from "../../../../core/index.mjs";
@@ -24,6 +35,115 @@ export class CardSessionsClient {
     constructor(options = {}) {
         this._options = normalizeClientOptionsWithAuth(options);
     }
+    /**
+     * List the card sessions you opened for the party you act for, newest first. It never includes card data.
+     *
+     * @param {Natural.ListCardSessionsRequest} request
+     * @param {CardSessionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Natural.BadRequestError}
+     * @throws {@link Natural.UnauthorizedError}
+     * @throws {@link Natural.ForbiddenError}
+     * @throws {@link Natural.NotFoundError}
+     * @throws {@link Natural.ConflictError}
+     * @throws {@link Natural.UnprocessableEntityError}
+     * @throws {@link Natural.PreconditionError}
+     * @throws {@link Natural.TooManyRequestsError}
+     * @throws {@link Natural.InternalServerError}
+     * @throws {@link Natural.NotImplementedError}
+     * @throws {@link Natural.BadGatewayError}
+     * @throws {@link Natural.ServiceUnavailableError}
+     * @throws {@link errors.NaturalError}
+     * @throws {@link errors.NaturalTimeoutError}
+     *
+     * @example
+     *     await client.cardSessions.list()
+     */
+    list(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__list(request, requestOptions));
+    }
+    __list() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+            const { customerPartyId, status, reference, limit, cursor } = request;
+            const _queryParams = {
+                customerPartyId,
+                status: status != null
+                    ? serializers.ListCardSessionsRequestStatus.jsonOrThrow(status, {
+                        unrecognizedObjectKeys: "strip",
+                        omitUndefined: true,
+                    })
+                    : undefined,
+                reference,
+                limit,
+                cursor,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Instance-ID": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.instanceId) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.instanceId }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
+                url: core.url.join((_f = (_e = (yield core.Supplier.get(this._options.baseUrl))) !== null && _e !== void 0 ? _e : (yield core.Supplier.get(this._options.environment))) !== null && _f !== void 0 ? _f : environments.NaturalEnvironment.Production, "card-sessions"),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url
+                    .queryBuilder()
+                    .addMany(_queryParams)
+                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
+                    .build(),
+                timeoutMs: ((_j = (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.timeoutInSeconds) !== null && _j !== void 0 ? _j : 60) * 1000,
+                maxRetries: (_k = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _k !== void 0 ? _k : (_l = this._options) === null || _l === void 0 ? void 0 : _l.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_m = this._options) === null || _m === void 0 ? void 0 : _m.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.ListCardSessionsResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Natural.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new Natural.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Natural.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Natural.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new Natural.ConflictError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new Natural.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 428:
+                        throw new Natural.PreconditionError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Natural.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Natural.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 501:
+                        throw new Natural.NotImplementedError(_response.error.body, _response.rawResponse);
+                    case 502:
+                        throw new Natural.BadGatewayError(_response.error.body, _response.rawResponse);
+                    case 503:
+                        throw new Natural.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.NaturalError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/card-sessions");
+        });
+    }
     /**
      * Open a session to pay for one purchase with one card. Poll it until the user approves, then claim it once for a stand-in card and proxy login.
      *
@@ -54,7 +174,8 @@ export class CardSessionsClient {
      *             merchantName: "Blue Bottle Coffee",
      *             amount: 2450,
      *             currency: "USD"
-     *         }
+     *         },
+     *         reference: "checkout_7f3a"
      *     })
      */
     create(request, requestOptions) {
@@ -63,8 +184,12 @@ export class CardSessionsClient {
     __create(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+            const { idempotencyKey } = request, _body = __rest(request, ["idempotencyKey"]);
             const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Instance-ID": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.instanceId) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.instanceId }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
+                "Idempotency-Key": idempotencyKey,
+                "X-Instance-ID": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.instanceId) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.instanceId,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
                 url: core.url.join((_f = (_e = (yield core.Supplier.get(this._options.baseUrl))) !== null && _e !== void 0 ? _e : (yield core.Supplier.get(this._options.environment))) !== null && _f !== void 0 ? _f : environments.NaturalEnvironment.Production, "card-sessions"),
                 method: "POST",
@@ -72,7 +197,7 @@ export class CardSessionsClient {
                 contentType: "application/json",
                 queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
                 requestType: "json",
-                body: mergeAdditionalBodyParameters(serializers.CreateCardSessionsRequest.jsonOrThrow(request, {
+                body: mergeAdditionalBodyParameters(serializers.CreateCardSessionsRequest.jsonOrThrow(_body, {
                     unrecognizedObjectKeys: "strip",
                     omitUndefined: true,
                 }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.additionalBodyParameters),
@@ -234,7 +359,7 @@ export class CardSessionsClient {
         });
     }
     /**
-     * Claim the stand-in card and proxy login for an approved session. It succeeds once, and the credential can't be fetched again.
+     * Claim the stand-in card and proxy login for an approved session. It succeeds once; with an Idempotency-Key, retrying with the same key returns a fresh login until expiresAt.
      *
      * @param {Natural.ClaimCardSessionsRequest} request
      * @param {CardSessionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -265,12 +390,15 @@ export class CardSessionsClient {
     __claim(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
-            const { sessionId, customerPartyId } = request;
+            const { sessionId, customerPartyId, idempotencyKey } = request;
             const _queryParams = {
                 customerPartyId,
             };
             const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "X-Instance-ID": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.instanceId) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.instanceId }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
+                "Idempotency-Key": idempotencyKey,
+                "X-Instance-ID": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.instanceId) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.instanceId,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
                 url: core.url.join((_f = (_e = (yield core.Supplier.get(this._options.baseUrl))) !== null && _e !== void 0 ? _e : (yield core.Supplier.get(this._options.environment))) !== null && _f !== void 0 ? _f : environments.NaturalEnvironment.Production, `card-sessions/${core.url.encodePathParam(sessionId)}/claim`),
                 method: "POST",

package/dist/esm/api/resources/cardSessions/client/requests/ClaimCardSessionsRequest.d.mts

@@ -9,4 +9,6 @@ export interface ClaimCardSessionsRequest {
     sessionId: string;
     /** Customer party to act for (pty_*). Omit to act as your own party. To act for another party, pass the ID of a party that has authorized you to act on its behalf. */
     customerPartyId?: string;
+    /** Optional. Retrying the claim with the same key before expiresAt returns a new stand-in card and proxy login that expire at the same time as the first. Without a key, the credential can't be fetched again. */
+    idempotencyKey?: string;
 }

package/dist/esm/api/resources/cardSessions/client/requests/CreateCardSessionsRequest.d.mts

@@ -9,10 +9,13 @@ import type * as Natural from "../../../../index.mjs";
  *             merchantName: "Blue Bottle Coffee",
  *             amount: 2450,
  *             currency: "USD"
- *         }
+ *         },
+ *         reference: "checkout_7f3a"
  *     }
  */
 export interface CreateCardSessionsRequest {
+    /** Optional. Retrying with the same key and body returns the original session and approvalUrl instead of opening another one. */
+    idempotencyKey?: string;
     cardId: string;
     /** Customer party to act for (pty_*). Omit to act as your own party. To act for another party, pass the ID of a party that has authorized you to act on its behalf. */
     customerPartyId?: string;
@@ -22,4 +25,6 @@ export interface CreateCardSessionsRequest {
     ttlSeconds?: number;
     /** What the agent is buying. Required for a card the user added (eac_): the user approves this exact purchase. */
     purchase?: Natural.CreateCardSessionsRequestPurchase;
+    /** Your own reference for the session, such as your checkout or task ID. Not unique: filter GET /card-sessions by it to find the session again. */
+    reference?: string;
 }

package/dist/esm/api/resources/cardSessions/client/requests/ListCardSessionsRequest.d.mts

@@ -0,0 +1,17 @@
+import type * as Natural from "../../../../index.mjs";
+/**
+ * @example
+ *     {}
+ */
+export interface ListCardSessionsRequest {
+    /** Customer party to act for (pty_*). Omit to act as your own party. To act for another party, pass the ID of a party that has authorized you to act on its behalf. */
+    customerPartyId?: string;
+    /** Only sessions with this status. */
+    status?: Natural.ListCardSessionsRequestStatus;
+    /** Only sessions created with this reference. */
+    reference?: string;
+    /** Maximum results per page. */
+    limit?: number;
+    /** Cursor from the previous page. */
+    cursor?: string;
+}

package/dist/esm/api/resources/cardSessions/client/requests/ListCardSessionsRequest.mjs

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

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

@@ -1,3 +1,4 @@
 export type { ClaimCardSessionsRequest } from "./ClaimCardSessionsRequest.mjs";
 export type { CreateCardSessionsRequest } from "./CreateCardSessionsRequest.mjs";
 export type { GetCardSessionsRequest } from "./GetCardSessionsRequest.mjs";
+export type { ListCardSessionsRequest } from "./ListCardSessionsRequest.mjs";

package/dist/esm/api/resources/cardSessions/types/CreateCardSessionsResponse.d.mts

@@ -7,13 +7,15 @@ export interface CreateCardSessionsResponse {
     /** pending_approval: waiting for the user; keep polling. approved: claim it now. declined: the user said no. claimed: already collected. expired: open a new session. */
     status: Natural.CreateCardSessionsResponseStatus;
     allowedHosts: string[];
+    /** The reference you created the session with. Null when you didn't set one. */
+    reference: string | null;
     /** A pending session must be approved, and an approved one claimed, before this. */
     claimExpiresAt: string;
     claimedAt: string | null;
     /** When the claimed proxy login stops working. */
     credentialExpiresAt: string | null;
     createdAt: string;
-    /** Cards the user added only, once the purchase is approved: a suggestion to pass on to the user. Null when there's nothing to suggest. */
+    /** Cards the user added only, once the purchase is approved: a suggestion to pass on to the user. Null when there's nothing to suggest, and always null in list results: get the session for it. */
     note: Natural.CreateCardSessionsResponseNote | null;
     /** Cards the user added only: send the user here to approve the purchase. Returned only in this response; it can't be fetched again. */
     approvalUrl: string | null;

package/dist/esm/api/resources/cardSessions/types/GetCardSessionsResponse.d.mts

@@ -7,12 +7,14 @@ export interface GetCardSessionsResponse {
     /** pending_approval: waiting for the user; keep polling. approved: claim it now. declined: the user said no. claimed: already collected. expired: open a new session. */
     status: Natural.GetCardSessionsResponseStatus;
     allowedHosts: string[];
+    /** The reference you created the session with. Null when you didn't set one. */
+    reference: string | null;
     /** A pending session must be approved, and an approved one claimed, before this. */
     claimExpiresAt: string;
     claimedAt: string | null;
     /** When the claimed proxy login stops working. */
     credentialExpiresAt: string | null;
     createdAt: string;
-    /** Cards the user added only, once the purchase is approved: a suggestion to pass on to the user. Null when there's nothing to suggest. */
+    /** Cards the user added only, once the purchase is approved: a suggestion to pass on to the user. Null when there's nothing to suggest, and always null in list results: get the session for it. */
     note: Natural.GetCardSessionsResponseNote | null;
 }

package/dist/esm/api/resources/cardSessions/types/ListCardSessionsRequestStatus.d.mts

@@ -0,0 +1,9 @@
+/** Only sessions with this status. */
+export declare const ListCardSessionsRequestStatus: {
+    readonly PendingApproval: "pending_approval";
+    readonly Approved: "approved";
+    readonly Declined: "declined";
+    readonly Claimed: "claimed";
+    readonly Expired: "expired";
+};
+export type ListCardSessionsRequestStatus = (typeof ListCardSessionsRequestStatus)[keyof typeof ListCardSessionsRequestStatus];

package/dist/esm/api/resources/cardSessions/types/ListCardSessionsRequestStatus.mjs

@@ -0,0 +1,9 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Only sessions with this status. */
+export const ListCardSessionsRequestStatus = {
+    PendingApproval: "pending_approval",
+    Approved: "approved",
+    Declined: "declined",
+    Claimed: "claimed",
+    Expired: "expired",
+};

package/dist/esm/api/resources/cardSessions/types/ListCardSessionsResponse.d.mts

@@ -0,0 +1,5 @@
+import type * as Natural from "../../../index.mjs";
+export interface ListCardSessionsResponse {
+    data: Natural.ListCardSessionsResponseDataItem[];
+    meta: Natural.ListCardSessionsResponseMeta;
+}

package/dist/esm/api/resources/cardSessions/types/ListCardSessionsResponse.mjs

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

package/dist/esm/api/resources/cardSessions/types/ListCardSessionsResponseDataItem.d.mts

@@ -0,0 +1,20 @@
+import type * as Natural from "../../../index.mjs";
+export interface ListCardSessionsResponseDataItem {
+    sessionId: string;
+    cardId: string;
+    /** natural_issued: an agent card Natural issued to you. external: a card the user added on the dashboard. */
+    cardSource: Natural.ListCardSessionsResponseDataItemCardSource;
+    /** pending_approval: waiting for the user; keep polling. approved: claim it now. declined: the user said no. claimed: already collected. expired: open a new session. */
+    status: Natural.ListCardSessionsResponseDataItemStatus;
+    allowedHosts: string[];
+    /** The reference you created the session with. Null when you didn't set one. */
+    reference: string | null;
+    /** A pending session must be approved, and an approved one claimed, before this. */
+    claimExpiresAt: string;
+    claimedAt: string | null;
+    /** When the claimed proxy login stops working. */
+    credentialExpiresAt: string | null;
+    createdAt: string;
+    /** Cards the user added only, once the purchase is approved: a suggestion to pass on to the user. Null when there's nothing to suggest, and always null in list results: get the session for it. */
+    note: Natural.ListCardSessionsResponseDataItemNote | null;
+}

package/dist/esm/api/resources/cardSessions/types/ListCardSessionsResponseDataItem.mjs

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

package/dist/esm/api/resources/cardSessions/types/ListCardSessionsResponseDataItemCardSource.d.mts

@@ -0,0 +1,6 @@
+/** natural_issued: an agent card Natural issued to you. external: a card the user added on the dashboard. */
+export declare const ListCardSessionsResponseDataItemCardSource: {
+    readonly NaturalIssued: "natural_issued";
+    readonly External: "external";
+};
+export type ListCardSessionsResponseDataItemCardSource = (typeof ListCardSessionsResponseDataItemCardSource)[keyof typeof ListCardSessionsResponseDataItemCardSource];

package/dist/esm/api/resources/cardSessions/types/ListCardSessionsResponseDataItemCardSource.mjs

@@ -0,0 +1,6 @@
+// This file was auto-generated by Fern from our API Definition.
+/** natural_issued: an agent card Natural issued to you. external: a card the user added on the dashboard. */
+export const ListCardSessionsResponseDataItemCardSource = {
+    NaturalIssued: "natural_issued",
+    External: "external",
+};

package/dist/esm/api/resources/cardSessions/types/ListCardSessionsResponseDataItemNote.d.mts

@@ -0,0 +1,6 @@
+export interface ListCardSessionsResponseDataItemNote {
+    /** What to tell the user: what would let them skip the security code next time, such as verifying their identity or adding money to Natural. */
+    message: string;
+    /** A page to send the user to for that step. Null when there's nothing to do yet. */
+    url: string | null;
+}

package/dist/esm/api/resources/cardSessions/types/ListCardSessionsResponseDataItemNote.mjs

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

package/dist/esm/api/resources/cardSessions/types/ListCardSessionsResponseDataItemStatus.d.mts

@@ -0,0 +1,9 @@
+/** pending_approval: waiting for the user; keep polling. approved: claim it now. declined: the user said no. claimed: already collected. expired: open a new session. */
+export declare const ListCardSessionsResponseDataItemStatus: {
+    readonly PendingApproval: "pending_approval";
+    readonly Approved: "approved";
+    readonly Declined: "declined";
+    readonly Claimed: "claimed";
+    readonly Expired: "expired";
+};
+export type ListCardSessionsResponseDataItemStatus = (typeof ListCardSessionsResponseDataItemStatus)[keyof typeof ListCardSessionsResponseDataItemStatus];

package/dist/esm/api/resources/cardSessions/types/ListCardSessionsResponseDataItemStatus.mjs

@@ -0,0 +1,9 @@
+// This file was auto-generated by Fern from our API Definition.
+/** pending_approval: waiting for the user; keep polling. approved: claim it now. declined: the user said no. claimed: already collected. expired: open a new session. */
+export const ListCardSessionsResponseDataItemStatus = {
+    PendingApproval: "pending_approval",
+    Approved: "approved",
+    Declined: "declined",
+    Claimed: "claimed",
+    Expired: "expired",
+};

package/dist/esm/api/resources/cardSessions/types/ListCardSessionsResponseMeta.d.mts

@@ -0,0 +1,4 @@
+import type * as Natural from "../../../index.mjs";
+export interface ListCardSessionsResponseMeta {
+    pagination: Natural.ListCardSessionsResponseMetaPagination;
+}

package/dist/esm/api/resources/cardSessions/types/ListCardSessionsResponseMeta.mjs

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

package/dist/esm/api/resources/cardSessions/types/ListCardSessionsResponseMetaPagination.d.mts

@@ -0,0 +1,6 @@
+export interface ListCardSessionsResponseMetaPagination {
+    /** Whether more results are available. */
+    hasMore: boolean;
+    /** Cursor for the next page, or null when there are no more results. */
+    nextCursor: string | null;
+}

package/dist/esm/api/resources/cardSessions/types/ListCardSessionsResponseMetaPagination.mjs

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

package/dist/esm/api/resources/cardSessions/types/index.d.mts

@@ -12,3 +12,11 @@ export * from "./GetCardSessionsResponse.mjs";
 export * from "./GetCardSessionsResponseCardSource.mjs";
 export * from "./GetCardSessionsResponseNote.mjs";
 export * from "./GetCardSessionsResponseStatus.mjs";
+export * from "./ListCardSessionsRequestStatus.mjs";
+export * from "./ListCardSessionsResponse.mjs";
+export * from "./ListCardSessionsResponseDataItem.mjs";
+export * from "./ListCardSessionsResponseDataItemCardSource.mjs";
+export * from "./ListCardSessionsResponseDataItemNote.mjs";
+export * from "./ListCardSessionsResponseDataItemStatus.mjs";
+export * from "./ListCardSessionsResponseMeta.mjs";
+export * from "./ListCardSessionsResponseMetaPagination.mjs";

package/dist/esm/api/resources/cardSessions/types/index.mjs

@@ -12,3 +12,11 @@ export * from "./GetCardSessionsResponse.mjs";
 export * from "./GetCardSessionsResponseCardSource.mjs";
 export * from "./GetCardSessionsResponseNote.mjs";
 export * from "./GetCardSessionsResponseStatus.mjs";
+export * from "./ListCardSessionsRequestStatus.mjs";
+export * from "./ListCardSessionsResponse.mjs";
+export * from "./ListCardSessionsResponseDataItem.mjs";
+export * from "./ListCardSessionsResponseDataItemCardSource.mjs";
+export * from "./ListCardSessionsResponseDataItemNote.mjs";
+export * from "./ListCardSessionsResponseDataItemStatus.mjs";
+export * from "./ListCardSessionsResponseMeta.mjs";
+export * from "./ListCardSessionsResponseMetaPagination.mjs";

package/dist/esm/serialization/resources/cardSessions/client/requests/CreateCardSessionsRequest.d.mts

@@ -2,7 +2,7 @@ import type * as Natural from "../../../../../api/index.mjs";
 import * as core from "../../../../../core/index.mjs";
 import type * as serializers from "../../../../index.mjs";
 import { CreateCardSessionsRequestPurchase } from "../../types/CreateCardSessionsRequestPurchase.mjs";
-export declare const CreateCardSessionsRequest: core.serialization.Schema<serializers.CreateCardSessionsRequest.Raw, Natural.CreateCardSessionsRequest>;
+export declare const CreateCardSessionsRequest: core.serialization.Schema<serializers.CreateCardSessionsRequest.Raw, Omit<Natural.CreateCardSessionsRequest, "idempotencyKey">>;
 export declare namespace CreateCardSessionsRequest {
     interface Raw {
         cardId: string;
@@ -10,5 +10,6 @@ export declare namespace CreateCardSessionsRequest {
         allowedHosts: string[];
         ttlSeconds?: number | null;
         purchase?: CreateCardSessionsRequestPurchase.Raw | null;
+        reference?: string | null;
     }
 }

package/dist/esm/serialization/resources/cardSessions/client/requests/CreateCardSessionsRequest.mjs

@@ -7,4 +7,5 @@ export const CreateCardSessionsRequest = core.serialization.object({
     allowedHosts: core.serialization.list(core.serialization.string()),
     ttlSeconds: core.serialization.number().optional(),
     purchase: CreateCardSessionsRequestPurchase.optional(),
+    reference: core.serialization.string().optional(),
 });

package/dist/esm/serialization/resources/cardSessions/types/CreateCardSessionsResponse.d.mts

@@ -12,6 +12,7 @@ export declare namespace CreateCardSessionsResponse {
         cardSource: CreateCardSessionsResponseCardSource.Raw;
         status: CreateCardSessionsResponseStatus.Raw;
         allowedHosts: string[];
+        reference?: string | null;
         claimExpiresAt: string;
         claimedAt?: string | null;
         credentialExpiresAt?: string | null;

package/dist/esm/serialization/resources/cardSessions/types/CreateCardSessionsResponse.mjs

@@ -9,6 +9,7 @@ export const CreateCardSessionsResponse = core.serialization.object({
     cardSource: CreateCardSessionsResponseCardSource,
     status: CreateCardSessionsResponseStatus,
     allowedHosts: core.serialization.list(core.serialization.string()),
+    reference: core.serialization.string().nullable(),
     claimExpiresAt: core.serialization.string(),
     claimedAt: core.serialization.string().nullable(),
     credentialExpiresAt: core.serialization.string().nullable(),

package/dist/esm/serialization/resources/cardSessions/types/GetCardSessionsResponse.d.mts

@@ -12,6 +12,7 @@ export declare namespace GetCardSessionsResponse {
         cardSource: GetCardSessionsResponseCardSource.Raw;
         status: GetCardSessionsResponseStatus.Raw;
         allowedHosts: string[];
+        reference?: string | null;
         claimExpiresAt: string;
         claimedAt?: string | null;
         credentialExpiresAt?: string | null;

package/dist/esm/serialization/resources/cardSessions/types/GetCardSessionsResponse.mjs

@@ -9,6 +9,7 @@ export const GetCardSessionsResponse = core.serialization.object({
     cardSource: GetCardSessionsResponseCardSource,
     status: GetCardSessionsResponseStatus,
     allowedHosts: core.serialization.list(core.serialization.string()),
+    reference: core.serialization.string().nullable(),
     claimExpiresAt: core.serialization.string(),
     claimedAt: core.serialization.string().nullable(),
     credentialExpiresAt: core.serialization.string().nullable(),

package/dist/esm/serialization/resources/cardSessions/types/ListCardSessionsRequestStatus.d.mts

@@ -0,0 +1,7 @@
+import type * as Natural from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+import type * as serializers from "../../../index.mjs";
+export declare const ListCardSessionsRequestStatus: core.serialization.Schema<serializers.ListCardSessionsRequestStatus.Raw, Natural.ListCardSessionsRequestStatus>;
+export declare namespace ListCardSessionsRequestStatus {
+    type Raw = "pending_approval" | "approved" | "declined" | "claimed" | "expired";
+}

package/dist/esm/serialization/resources/cardSessions/types/ListCardSessionsRequestStatus.mjs

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../../../core/index.mjs";
+export const ListCardSessionsRequestStatus = core.serialization.enum_(["pending_approval", "approved", "declined", "claimed", "expired"]);

package/dist/esm/serialization/resources/cardSessions/types/ListCardSessionsResponse.d.mts

@@ -0,0 +1,12 @@
+import type * as Natural from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+import type * as serializers from "../../../index.mjs";
+import { ListCardSessionsResponseDataItem } from "./ListCardSessionsResponseDataItem.mjs";
+import { ListCardSessionsResponseMeta } from "./ListCardSessionsResponseMeta.mjs";
+export declare const ListCardSessionsResponse: core.serialization.ObjectSchema<serializers.ListCardSessionsResponse.Raw, Natural.ListCardSessionsResponse>;
+export declare namespace ListCardSessionsResponse {
+    interface Raw {
+        data: ListCardSessionsResponseDataItem.Raw[];
+        meta: ListCardSessionsResponseMeta.Raw;
+    }
+}

package/dist/esm/serialization/resources/cardSessions/types/ListCardSessionsResponse.mjs

@@ -0,0 +1,8 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../../../core/index.mjs";
+import { ListCardSessionsResponseDataItem } from "./ListCardSessionsResponseDataItem.mjs";
+import { ListCardSessionsResponseMeta } from "./ListCardSessionsResponseMeta.mjs";
+export const ListCardSessionsResponse = core.serialization.object({
+    data: core.serialization.list(ListCardSessionsResponseDataItem),
+    meta: ListCardSessionsResponseMeta,
+});

package/dist/esm/serialization/resources/cardSessions/types/ListCardSessionsResponseDataItem.d.mts

@@ -0,0 +1,22 @@
+import type * as Natural from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+import type * as serializers from "../../../index.mjs";
+import { ListCardSessionsResponseDataItemCardSource } from "./ListCardSessionsResponseDataItemCardSource.mjs";
+import { ListCardSessionsResponseDataItemNote } from "./ListCardSessionsResponseDataItemNote.mjs";
+import { ListCardSessionsResponseDataItemStatus } from "./ListCardSessionsResponseDataItemStatus.mjs";
+export declare const ListCardSessionsResponseDataItem: core.serialization.ObjectSchema<serializers.ListCardSessionsResponseDataItem.Raw, Natural.ListCardSessionsResponseDataItem>;
+export declare namespace ListCardSessionsResponseDataItem {
+    interface Raw {
+        sessionId: string;
+        cardId: string;
+        cardSource: ListCardSessionsResponseDataItemCardSource.Raw;
+        status: ListCardSessionsResponseDataItemStatus.Raw;
+        allowedHosts: string[];
+        reference?: string | null;
+        claimExpiresAt: string;
+        claimedAt?: string | null;
+        credentialExpiresAt?: string | null;
+        createdAt: string;
+        note?: ListCardSessionsResponseDataItemNote.Raw | null;
+    }
+}

package/dist/esm/serialization/resources/cardSessions/types/ListCardSessionsResponseDataItem.mjs

@@ -0,0 +1,18 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../../../core/index.mjs";
+import { ListCardSessionsResponseDataItemCardSource } from "./ListCardSessionsResponseDataItemCardSource.mjs";
+import { ListCardSessionsResponseDataItemNote } from "./ListCardSessionsResponseDataItemNote.mjs";
+import { ListCardSessionsResponseDataItemStatus } from "./ListCardSessionsResponseDataItemStatus.mjs";
+export const ListCardSessionsResponseDataItem = core.serialization.object({
+    sessionId: core.serialization.string(),
+    cardId: core.serialization.string(),
+    cardSource: ListCardSessionsResponseDataItemCardSource,
+    status: ListCardSessionsResponseDataItemStatus,
+    allowedHosts: core.serialization.list(core.serialization.string()),
+    reference: core.serialization.string().nullable(),
+    claimExpiresAt: core.serialization.string(),
+    claimedAt: core.serialization.string().nullable(),
+    credentialExpiresAt: core.serialization.string().nullable(),
+    createdAt: core.serialization.string(),
+    note: ListCardSessionsResponseDataItemNote.nullable(),
+});

package/dist/esm/serialization/resources/cardSessions/types/ListCardSessionsResponseDataItemCardSource.d.mts

@@ -0,0 +1,7 @@
+import type * as Natural from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+import type * as serializers from "../../../index.mjs";
+export declare const ListCardSessionsResponseDataItemCardSource: core.serialization.Schema<serializers.ListCardSessionsResponseDataItemCardSource.Raw, Natural.ListCardSessionsResponseDataItemCardSource>;
+export declare namespace ListCardSessionsResponseDataItemCardSource {
+    type Raw = "natural_issued" | "external";
+}

package/dist/esm/serialization/resources/cardSessions/types/ListCardSessionsResponseDataItemCardSource.mjs

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../../../core/index.mjs";
+export const ListCardSessionsResponseDataItemCardSource = core.serialization.enum_(["natural_issued", "external"]);

package/dist/esm/serialization/resources/cardSessions/types/ListCardSessionsResponseDataItemNote.d.mts

@@ -0,0 +1,10 @@
+import type * as Natural from "../../../../api/index.mjs";
+import * as core from "../../../../core/index.mjs";
+import type * as serializers from "../../../index.mjs";
+export declare const ListCardSessionsResponseDataItemNote: core.serialization.ObjectSchema<serializers.ListCardSessionsResponseDataItemNote.Raw, Natural.ListCardSessionsResponseDataItemNote>;
+export declare namespace ListCardSessionsResponseDataItemNote {
+    interface Raw {
+        message: string;
+        url?: string | null;
+    }
+}