@naturalpay/sdk 1.6.28 → 1.6.30

package/dist/esm/api/resources/agentCards/types/CreateAgentCardsResponseDataRelationshipsWalletData.mjs

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

package/dist/esm/api/resources/agentCards/types/CreateAgentCardsResponseDataRelationshipsWalletDataType.d.mts

@@ -0,0 +1,5 @@
+/** Resource type. Always `wallet`. */
+export declare const CreateAgentCardsResponseDataRelationshipsWalletDataType: {
+    readonly Wallet: "wallet";
+};
+export type CreateAgentCardsResponseDataRelationshipsWalletDataType = (typeof CreateAgentCardsResponseDataRelationshipsWalletDataType)[keyof typeof CreateAgentCardsResponseDataRelationshipsWalletDataType];

package/dist/esm/api/resources/agentCards/types/CreateAgentCardsResponseDataRelationshipsWalletDataType.mjs

@@ -0,0 +1,5 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Resource type. Always `wallet`. */
+export const CreateAgentCardsResponseDataRelationshipsWalletDataType = {
+    Wallet: "wallet",
+};

package/dist/esm/api/resources/agentCards/types/CreateAgentCardsResponseDataType.d.mts

@@ -0,0 +1,5 @@
+/** Resource type. Always `agentCard`. */
+export declare const CreateAgentCardsResponseDataType: {
+    readonly AgentCard: "agentCard";
+};
+export type CreateAgentCardsResponseDataType = (typeof CreateAgentCardsResponseDataType)[keyof typeof CreateAgentCardsResponseDataType];

package/dist/esm/api/resources/agentCards/types/CreateAgentCardsResponseDataType.mjs

@@ -0,0 +1,5 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Resource type. Always `agentCard`. */
+export const CreateAgentCardsResponseDataType = {
+    AgentCard: "agentCard",
+};

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponse.d.mts

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

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponse.mjs

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

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseData.d.mts

@@ -0,0 +1,9 @@
+import type * as Natural from "../../../index.mjs";
+export interface GetAgentCardsResponseData {
+    /** Resource type. Always `agentCard`. */
+    type: Natural.GetAgentCardsResponseDataType;
+    /** Agent card ID (pcd_*). */
+    id: string;
+    attributes: Natural.GetAgentCardsResponseDataAttributes;
+    relationships: Natural.GetAgentCardsResponseDataRelationships;
+}

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseData.mjs

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

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataAttributes.d.mts

@@ -0,0 +1,21 @@
+import type * as Natural from "../../../index.mjs";
+export interface GetAgentCardsResponseDataAttributes {
+    /** The kind of agent card. single_use: approves one purchase at one merchant, up to a maximum, then closes. */
+    type: Natural.GetAgentCardsResponseDataAttributesType;
+    /** issuing: Natural is creating the card. active: ready for its one purchase. used: its purchase was approved, so it approves nothing else. expired: its time ran out. failed: it couldn't be issued; request a new card. */
+    status: Natural.GetAgentCardsResponseDataAttributesStatus;
+    merchant: Natural.GetAgentCardsResponseDataAttributesMerchant;
+    /** The most the one purchase can be, in cents. */
+    maximumAmount: number;
+    currency: Natural.GetAgentCardsResponseDataAttributesCurrency;
+    /** Last four digits, once the card is issued. */
+    lastFour: string | null;
+    expirationMonth: number | null;
+    expirationYear: number | null;
+    /** RFC 3339 timestamp when the card stops working. */
+    expiresAt: string;
+    /** RFC 3339 timestamp when the card was used or expired, or null while open. */
+    closedAt: string | null;
+    /** RFC 3339 timestamp when the card was requested. */
+    createdAt: string;
+}

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataAttributes.mjs

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

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataAttributesCurrency.d.mts

@@ -0,0 +1,4 @@
+export declare const GetAgentCardsResponseDataAttributesCurrency: {
+    readonly Usd: "USD";
+};
+export type GetAgentCardsResponseDataAttributesCurrency = (typeof GetAgentCardsResponseDataAttributesCurrency)[keyof typeof GetAgentCardsResponseDataAttributesCurrency];

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataAttributesCurrency.mjs

@@ -0,0 +1,4 @@
+// This file was auto-generated by Fern from our API Definition.
+export const GetAgentCardsResponseDataAttributesCurrency = {
+    Usd: "USD",
+};

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataAttributesMerchant.d.mts

@@ -0,0 +1,4 @@
+export interface GetAgentCardsResponseDataAttributesMerchant {
+    name: string;
+    networkMerchantId: string | null;
+}

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataAttributesMerchant.mjs

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

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataAttributesStatus.d.mts

@@ -0,0 +1,9 @@
+/** issuing: Natural is creating the card. active: ready for its one purchase. used: its purchase was approved, so it approves nothing else. expired: its time ran out. failed: it couldn't be issued; request a new card. */
+export declare const GetAgentCardsResponseDataAttributesStatus: {
+    readonly Issuing: "issuing";
+    readonly Active: "active";
+    readonly Used: "used";
+    readonly Expired: "expired";
+    readonly Failed: "failed";
+};
+export type GetAgentCardsResponseDataAttributesStatus = (typeof GetAgentCardsResponseDataAttributesStatus)[keyof typeof GetAgentCardsResponseDataAttributesStatus];

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataAttributesStatus.mjs

@@ -0,0 +1,9 @@
+// This file was auto-generated by Fern from our API Definition.
+/** issuing: Natural is creating the card. active: ready for its one purchase. used: its purchase was approved, so it approves nothing else. expired: its time ran out. failed: it couldn't be issued; request a new card. */
+export const GetAgentCardsResponseDataAttributesStatus = {
+    Issuing: "issuing",
+    Active: "active",
+    Used: "used",
+    Expired: "expired",
+    Failed: "failed",
+};

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataAttributesType.d.mts

@@ -0,0 +1,5 @@
+/** The kind of agent card. single_use: approves one purchase at one merchant, up to a maximum, then closes. */
+export declare const GetAgentCardsResponseDataAttributesType: {
+    readonly SingleUse: "single_use";
+};
+export type GetAgentCardsResponseDataAttributesType = (typeof GetAgentCardsResponseDataAttributesType)[keyof typeof GetAgentCardsResponseDataAttributesType];

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataAttributesType.mjs

@@ -0,0 +1,5 @@
+// This file was auto-generated by Fern from our API Definition.
+/** The kind of agent card. single_use: approves one purchase at one merchant, up to a maximum, then closes. */
+export const GetAgentCardsResponseDataAttributesType = {
+    SingleUse: "single_use",
+};

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataRelationships.d.mts

@@ -0,0 +1,5 @@
+import type * as Natural from "../../../index.mjs";
+export interface GetAgentCardsResponseDataRelationships {
+    /** Wallet the card spends from. */
+    wallet: Natural.GetAgentCardsResponseDataRelationshipsWallet;
+}

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataRelationships.mjs

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

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataRelationshipsWallet.d.mts

@@ -0,0 +1,8 @@
+import type * as Natural from "../../../index.mjs";
+/**
+ * Wallet the card spends from.
+ */
+export interface GetAgentCardsResponseDataRelationshipsWallet {
+    /** Related resource identifier. */
+    data: Natural.GetAgentCardsResponseDataRelationshipsWalletData;
+}

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataRelationshipsWallet.mjs

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

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataRelationshipsWalletData.d.mts

@@ -0,0 +1,9 @@
+import type * as Natural from "../../../index.mjs";
+/**
+ * Related resource identifier.
+ */
+export interface GetAgentCardsResponseDataRelationshipsWalletData {
+    /** Resource type. Always `wallet`. */
+    type: Natural.GetAgentCardsResponseDataRelationshipsWalletDataType;
+    id: string;
+}

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataRelationshipsWalletData.mjs

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

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataRelationshipsWalletDataType.d.mts

@@ -0,0 +1,5 @@
+/** Resource type. Always `wallet`. */
+export declare const GetAgentCardsResponseDataRelationshipsWalletDataType: {
+    readonly Wallet: "wallet";
+};
+export type GetAgentCardsResponseDataRelationshipsWalletDataType = (typeof GetAgentCardsResponseDataRelationshipsWalletDataType)[keyof typeof GetAgentCardsResponseDataRelationshipsWalletDataType];

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataRelationshipsWalletDataType.mjs

@@ -0,0 +1,5 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Resource type. Always `wallet`. */
+export const GetAgentCardsResponseDataRelationshipsWalletDataType = {
+    Wallet: "wallet",
+};

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataType.d.mts

@@ -0,0 +1,5 @@
+/** Resource type. Always `agentCard`. */
+export declare const GetAgentCardsResponseDataType: {
+    readonly AgentCard: "agentCard";
+};
+export type GetAgentCardsResponseDataType = (typeof GetAgentCardsResponseDataType)[keyof typeof GetAgentCardsResponseDataType];

package/dist/esm/api/resources/agentCards/types/GetAgentCardsResponseDataType.mjs

@@ -0,0 +1,5 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Resource type. Always `agentCard`. */
+export const GetAgentCardsResponseDataType = {
+    AgentCard: "agentCard",
+};

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

@@ -0,0 +1,27 @@
+export * from "./CreateAgentCardsRequestCurrency.mjs";
+export * from "./CreateAgentCardsRequestMerchant.mjs";
+export * from "./CreateAgentCardsRequestType.mjs";
+export * from "./CreateAgentCardsResponse.mjs";
+export * from "./CreateAgentCardsResponseData.mjs";
+export * from "./CreateAgentCardsResponseDataAttributes.mjs";
+export * from "./CreateAgentCardsResponseDataAttributesCurrency.mjs";
+export * from "./CreateAgentCardsResponseDataAttributesMerchant.mjs";
+export * from "./CreateAgentCardsResponseDataAttributesStatus.mjs";
+export * from "./CreateAgentCardsResponseDataAttributesType.mjs";
+export * from "./CreateAgentCardsResponseDataRelationships.mjs";
+export * from "./CreateAgentCardsResponseDataRelationshipsWallet.mjs";
+export * from "./CreateAgentCardsResponseDataRelationshipsWalletData.mjs";
+export * from "./CreateAgentCardsResponseDataRelationshipsWalletDataType.mjs";
+export * from "./CreateAgentCardsResponseDataType.mjs";
+export * from "./GetAgentCardsResponse.mjs";
+export * from "./GetAgentCardsResponseData.mjs";
+export * from "./GetAgentCardsResponseDataAttributes.mjs";
+export * from "./GetAgentCardsResponseDataAttributesCurrency.mjs";
+export * from "./GetAgentCardsResponseDataAttributesMerchant.mjs";
+export * from "./GetAgentCardsResponseDataAttributesStatus.mjs";
+export * from "./GetAgentCardsResponseDataAttributesType.mjs";
+export * from "./GetAgentCardsResponseDataRelationships.mjs";
+export * from "./GetAgentCardsResponseDataRelationshipsWallet.mjs";
+export * from "./GetAgentCardsResponseDataRelationshipsWalletData.mjs";
+export * from "./GetAgentCardsResponseDataRelationshipsWalletDataType.mjs";
+export * from "./GetAgentCardsResponseDataType.mjs";

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

@@ -0,0 +1,27 @@
+export * from "./CreateAgentCardsRequestCurrency.mjs";
+export * from "./CreateAgentCardsRequestMerchant.mjs";
+export * from "./CreateAgentCardsRequestType.mjs";
+export * from "./CreateAgentCardsResponse.mjs";
+export * from "./CreateAgentCardsResponseData.mjs";
+export * from "./CreateAgentCardsResponseDataAttributes.mjs";
+export * from "./CreateAgentCardsResponseDataAttributesCurrency.mjs";
+export * from "./CreateAgentCardsResponseDataAttributesMerchant.mjs";
+export * from "./CreateAgentCardsResponseDataAttributesStatus.mjs";
+export * from "./CreateAgentCardsResponseDataAttributesType.mjs";
+export * from "./CreateAgentCardsResponseDataRelationships.mjs";
+export * from "./CreateAgentCardsResponseDataRelationshipsWallet.mjs";
+export * from "./CreateAgentCardsResponseDataRelationshipsWalletData.mjs";
+export * from "./CreateAgentCardsResponseDataRelationshipsWalletDataType.mjs";
+export * from "./CreateAgentCardsResponseDataType.mjs";
+export * from "./GetAgentCardsResponse.mjs";
+export * from "./GetAgentCardsResponseData.mjs";
+export * from "./GetAgentCardsResponseDataAttributes.mjs";
+export * from "./GetAgentCardsResponseDataAttributesCurrency.mjs";
+export * from "./GetAgentCardsResponseDataAttributesMerchant.mjs";
+export * from "./GetAgentCardsResponseDataAttributesStatus.mjs";
+export * from "./GetAgentCardsResponseDataAttributesType.mjs";
+export * from "./GetAgentCardsResponseDataRelationships.mjs";
+export * from "./GetAgentCardsResponseDataRelationshipsWallet.mjs";
+export * from "./GetAgentCardsResponseDataRelationshipsWalletData.mjs";
+export * from "./GetAgentCardsResponseDataRelationshipsWalletDataType.mjs";
+export * from "./GetAgentCardsResponseDataType.mjs";

package/dist/esm/api/resources/agenticPayments/client/Client.d.mts

@@ -11,7 +11,7 @@ export declare class AgenticPaymentsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<AgenticPaymentsClient.Options>;
     constructor(options?: AgenticPaymentsClient.Options);
     /**
-     * List usable mandates on cards the calling agent can use, or all of the owner's mandates
+     * List the party's usable mandates for the calling agent, or all of the owner's mandates
      *
      * @param {Natural.ListMandatesAgenticPaymentsRequest} request
      * @param {AgenticPaymentsClient.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -33,7 +33,7 @@ export class AgenticPaymentsClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
-     * List usable mandates on cards the calling agent can use, or all of the owner's mandates
+     * List the party's usable mandates for the calling agent, or all of the owner's mandates
      *
      * @param {Natural.ListMandatesAgenticPaymentsRequest} request
      * @param {AgenticPaymentsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/agents/types/CreateCustomerAgentsRequestPermissionsItem.d.mts

@@ -30,5 +30,6 @@ export declare const CreateCustomerAgentsRequestPermissionsItem: {
     readonly MandatesRead: "mandates.read";
     readonly EnrollmentRead: "enrollment.read";
     readonly CardsRead: "cards.read";
+    readonly SavedCardsUse: "saved_cards.use";
 };
 export type CreateCustomerAgentsRequestPermissionsItem = (typeof CreateCustomerAgentsRequestPermissionsItem)[keyof typeof CreateCustomerAgentsRequestPermissionsItem];

package/dist/esm/api/resources/agents/types/CreateCustomerAgentsRequestPermissionsItem.mjs

@@ -31,4 +31,5 @@ export const CreateCustomerAgentsRequestPermissionsItem = {
     MandatesRead: "mandates.read",
     EnrollmentRead: "enrollment.read",
     CardsRead: "cards.read",
+    SavedCardsUse: "saved_cards.use",
 };

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

@@ -65,7 +65,7 @@ export class ApprovalsClient {
     __list() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
-            const { limit, status } = request;
+            const { limit, status, cursor } = request;
             const _queryParams = {
                 limit,
                 status: status != null
@@ -74,6 +74,7 @@ export class ApprovalsClient {
                         omitUndefined: true,
                     })
                     : undefined,
+                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);

package/dist/esm/api/resources/approvals/client/requests/ListApprovalsRequest.d.mts

@@ -6,4 +6,5 @@ import type * as Natural from "../../../../index.mjs";
 export interface ListApprovalsRequest {
     limit?: number;
     status?: Natural.ListApprovalsRequestStatus;
+    cursor?: string;
 }

package/dist/esm/api/resources/cardTransactions/client/Client.d.mts

@@ -0,0 +1,70 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.mjs";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as Natural from "../../../index.mjs";
+export declare namespace CardTransactionsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+/**
+ * Purchases and refunds on Natural-issued cards
+ */
+export declare class CardTransactionsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<CardTransactionsClient.Options>;
+    constructor(options?: CardTransactionsClient.Options);
+    /**
+     * List purchases and refunds on Natural-issued cards, newest first. An agent sees only its own card transactions.
+     *
+     * @param {Natural.ListCardTransactionsRequest} request
+     * @param {CardTransactionsClient.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.cardTransactions.list()
+     */
+    list(request?: Natural.ListCardTransactionsRequest, requestOptions?: CardTransactionsClient.RequestOptions): core.HttpResponsePromise<Natural.ListCardTransactionsResponse>;
+    private __list;
+    /**
+     * Get a purchase or refund on a Natural-issued card, with its timeline.
+     *
+     * @param {Natural.GetCardTransactionsRequest} request
+     * @param {CardTransactionsClient.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.cardTransactions.get({
+     *         cardTransactionId: "cardTransactionId"
+     *     })
+     */
+    get(request: Natural.GetCardTransactionsRequest, requestOptions?: CardTransactionsClient.RequestOptions): core.HttpResponsePromise<Natural.GetCardTransactionsResponse>;
+    private __get;
+}