@jacob-registry-repo/sdk 1.0.0

package/api/resources/orders/client/Client.ts

@@ -0,0 +1,336 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth, normalizeClientOptionsWithAuth } from "../../../../BaseClient.js";
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.js";
+import * as core from "../../../../core/index.js";
+import * as environments from "../../../../environments.js";
+import { handleNonStatusCodeError } from "../../../../errors/handleNonStatusCodeError.js";
+import * as errors from "../../../../errors/index.js";
+import * as AcqClient from "../../../index.js";
+
+export declare namespace OrdersClient {
+    export type Options = BaseClientOptions;
+
+    export interface RequestOptions extends BaseRequestOptions {}
+}
+
+export class OrdersClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<OrdersClient.Options>;
+
+    constructor(options: OrdersClient.Options) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+
+    /**
+     * Lists all orders for the authenticated merchant with filters and pagination. Supports JWT (dashboard), publishable, or secret API key.
+     *
+     * @param {AcqClient.GetOrdersRequest} request
+     * @param {OrdersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AcqClient.UnauthorizedError}
+     * @throws {@link AcqClient.ForbiddenError}
+     * @throws {@link AcqClient.InternalServerError}
+     *
+     * @example
+     *     await client.orders.listMerchantOrders()
+     */
+    public listMerchantOrders(
+        request: AcqClient.GetOrdersRequest = {},
+        requestOptions?: OrdersClient.RequestOptions,
+    ): core.HttpResponsePromise<AcqClient.GetOrdersResponse> {
+        return core.HttpResponsePromise.fromPromise(this.__listMerchantOrders(request, requestOptions));
+    }
+
+    private async __listMerchantOrders(
+        request: AcqClient.GetOrdersRequest = {},
+        requestOptions?: OrdersClient.RequestOptions,
+    ): Promise<core.WithRawResponse<AcqClient.GetOrdersResponse>> {
+        const { status, chain, crypto, search, fromDate, toDate, page, pageSize, sortBy, orderBy } = request;
+        const _queryParams: Record<string, string | string[] | object | object[] | null> = {};
+        if (status != null) {
+            _queryParams.status = status;
+        }
+
+        if (chain != null) {
+            _queryParams.chain = chain;
+        }
+
+        if (crypto != null) {
+            _queryParams.crypto = crypto;
+        }
+
+        if (search != null) {
+            _queryParams.search = search;
+        }
+
+        if (fromDate != null) {
+            _queryParams.fromDate = fromDate;
+        }
+
+        if (toDate != null) {
+            _queryParams.toDate = toDate;
+        }
+
+        if (page != null) {
+            _queryParams.page = page.toString();
+        }
+
+        if (pageSize != null) {
+            _queryParams.pageSize = pageSize.toString();
+        }
+
+        if (sortBy != null) {
+            _queryParams.sortBy = sortBy;
+        }
+
+        if (orderBy != null) {
+            _queryParams.orderBy = orderBy;
+        }
+
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            mergeOnlyDefinedHeaders({
+                "X-Publishable-Key": requestOptions?.publishableKey ?? this._options?.publishableKey,
+                "X-Secret-Key": requestOptions?.secretKey ?? this._options?.secretKey,
+            }),
+            requestOptions?.headers,
+        );
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join(
+                (await core.Supplier.get(this._options.baseUrl)) ??
+                    (await core.Supplier.get(this._options.environment)) ??
+                    environments.AcqClientEnvironment.Default,
+                "orders",
+            ),
+            method: "GET",
+            headers: _headers,
+            queryParameters: { ..._queryParams, ...requestOptions?.queryParams },
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            withCredentials: true,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body as AcqClient.GetOrdersResponse, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new AcqClient.UnauthorizedError(
+                        _response.error.body as AcqClient.V1Response,
+                        _response.rawResponse,
+                    );
+                case 403:
+                    throw new AcqClient.ForbiddenError(
+                        _response.error.body as AcqClient.V1Response,
+                        _response.rawResponse,
+                    );
+                case 500:
+                    throw new AcqClient.InternalServerError(
+                        _response.error.body as AcqClient.V1Response,
+                        _response.rawResponse,
+                    );
+                default:
+                    throw new errors.AcqClientError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/orders");
+    }
+
+    /**
+     * Creates a new payment order and returns payment details. Requires JWT (dashboard) or secret API key. Supports idempotency via Idempotency-Key header to prevent duplicate orders.
+     *
+     * @param {AcqClient.V1CreateOrderRequest} request
+     * @param {OrdersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AcqClient.BadRequestError}
+     * @throws {@link AcqClient.UnauthorizedError}
+     * @throws {@link AcqClient.ForbiddenError}
+     * @throws {@link AcqClient.InternalServerError}
+     *
+     * @example
+     *     await client.orders.createPaymentOrder({
+     *         amount: 100,
+     *         chain: "ETH",
+     *         crypto: "USDT"
+     *     })
+     */
+    public createPaymentOrder(
+        request: AcqClient.V1CreateOrderRequest,
+        requestOptions?: OrdersClient.RequestOptions,
+    ): core.HttpResponsePromise<AcqClient.PostOrdersResponse> {
+        return core.HttpResponsePromise.fromPromise(this.__createPaymentOrder(request, requestOptions));
+    }
+
+    private async __createPaymentOrder(
+        request: AcqClient.V1CreateOrderRequest,
+        requestOptions?: OrdersClient.RequestOptions,
+    ): Promise<core.WithRawResponse<AcqClient.PostOrdersResponse>> {
+        const { "Idempotency-Key": idempotencyKey, ..._body } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            mergeOnlyDefinedHeaders({
+                "Idempotency-Key": idempotencyKey != null ? idempotencyKey : undefined,
+                "X-Publishable-Key": requestOptions?.publishableKey ?? this._options?.publishableKey,
+                "X-Secret-Key": requestOptions?.secretKey ?? this._options?.secretKey,
+            }),
+            requestOptions?.headers,
+        );
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join(
+                (await core.Supplier.get(this._options.baseUrl)) ??
+                    (await core.Supplier.get(this._options.environment)) ??
+                    environments.AcqClientEnvironment.Default,
+                "orders",
+            ),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: _body,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            withCredentials: true,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body as AcqClient.PostOrdersResponse, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new AcqClient.BadRequestError(
+                        _response.error.body as AcqClient.V1Response,
+                        _response.rawResponse,
+                    );
+                case 401:
+                    throw new AcqClient.UnauthorizedError(
+                        _response.error.body as AcqClient.V1Response,
+                        _response.rawResponse,
+                    );
+                case 403:
+                    throw new AcqClient.ForbiddenError(
+                        _response.error.body as AcqClient.V1Response,
+                        _response.rawResponse,
+                    );
+                case 500:
+                    throw new AcqClient.InternalServerError(
+                        _response.error.body as AcqClient.V1Response,
+                        _response.rawResponse,
+                    );
+                default:
+                    throw new errors.AcqClientError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/orders");
+    }
+
+    /**
+     * Retrieves order details with all associated transactions. Supports JWT (dashboard), publishable, or secret API key.
+     *
+     * @param {AcqClient.GetOrdersIdDetailsRequest} request
+     * @param {OrdersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AcqClient.UnauthorizedError}
+     * @throws {@link AcqClient.ForbiddenError}
+     * @throws {@link AcqClient.NotFoundError}
+     *
+     * @example
+     *     await client.orders.getOrderWithTransactionDetails({
+     *         id: "id"
+     *     })
+     */
+    public getOrderWithTransactionDetails(
+        request: AcqClient.GetOrdersIdDetailsRequest,
+        requestOptions?: OrdersClient.RequestOptions,
+    ): core.HttpResponsePromise<AcqClient.GetOrdersIdDetailsResponse> {
+        return core.HttpResponsePromise.fromPromise(this.__getOrderWithTransactionDetails(request, requestOptions));
+    }
+
+    private async __getOrderWithTransactionDetails(
+        request: AcqClient.GetOrdersIdDetailsRequest,
+        requestOptions?: OrdersClient.RequestOptions,
+    ): Promise<core.WithRawResponse<AcqClient.GetOrdersIdDetailsResponse>> {
+        const { id } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            mergeOnlyDefinedHeaders({
+                "X-Publishable-Key": requestOptions?.publishableKey ?? this._options?.publishableKey,
+                "X-Secret-Key": requestOptions?.secretKey ?? this._options?.secretKey,
+            }),
+            requestOptions?.headers,
+        );
+        const _response = await (this._options.fetcher ?? core.fetcher)({
+            url: core.url.join(
+                (await core.Supplier.get(this._options.baseUrl)) ??
+                    (await core.Supplier.get(this._options.environment)) ??
+                    environments.AcqClientEnvironment.Default,
+                `orders/${core.url.encodePathParam(id)}/details`,
+            ),
+            method: "GET",
+            headers: _headers,
+            queryParameters: requestOptions?.queryParams,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            withCredentials: true,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body as AcqClient.GetOrdersIdDetailsResponse, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new AcqClient.UnauthorizedError(
+                        _response.error.body as AcqClient.V1Response,
+                        _response.rawResponse,
+                    );
+                case 403:
+                    throw new AcqClient.ForbiddenError(
+                        _response.error.body as AcqClient.V1Response,
+                        _response.rawResponse,
+                    );
+                case 404:
+                    throw new AcqClient.NotFoundError(
+                        _response.error.body as AcqClient.V1Response,
+                        _response.rawResponse,
+                    );
+                default:
+                    throw new errors.AcqClientError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/orders/{id}/details");
+    }
+}

package/api/resources/orders/client/index.ts

@@ -0,0 +1 @@
+export * from "./requests/index.js";

package/api/resources/orders/client/requests/GetOrdersIdDetailsRequest.ts

@@ -0,0 +1,12 @@
+// This file was auto-generated by Fern from our API Definition.
+
+/**
+ * @example
+ *     {
+ *         id: "id"
+ *     }
+ */
+export interface GetOrdersIdDetailsRequest {
+    /** Order ID */
+    id: string;
+}

package/api/resources/orders/client/requests/GetOrdersRequest.ts

@@ -0,0 +1,28 @@
+// This file was auto-generated by Fern from our API Definition.
+
+/**
+ * @example
+ *     {}
+ */
+export interface GetOrdersRequest {
+    /** Filter by status (PENDING, COMPLETED, EXPIRED, CANCELED, RISK_LOCK) */
+    status?: string;
+    /** Filter by blockchain (ETH, BSC, TRC20) */
+    chain?: string;
+    /** Filter by cryptocurrency (USDT, USDC) */
+    crypto?: string;
+    /** Search by order ID or payment wallet */
+    search?: string;
+    /** Start date (RFC3339 format) */
+    fromDate?: string;
+    /** End date (RFC3339 format) */
+    toDate?: string;
+    /** Page number (default: 1) */
+    page?: number;
+    /** Page size (default: 10, max: 100) */
+    pageSize?: number;
+    /** Sort by field (created_at, updated_at, amount, status) */
+    sortBy?: string;
+    /** Sort direction (asc, desc) */
+    orderBy?: string;
+}

package/api/resources/orders/client/requests/V1CreateOrderRequest.ts

@@ -0,0 +1,33 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as AcqClient from "../../../../index.js";
+
+/**
+ * @example
+ *     {
+ *         amount: 100,
+ *         chain: "ETH",
+ *         crypto: "USDT"
+ *     }
+ */
+export interface V1CreateOrderRequest {
+    /** Idempotency key (UUID recommended) to prevent duplicate requests. Responses cached for 24 hours. */
+    "Idempotency-Key"?: string;
+    amount: number;
+    chain: V1CreateOrderRequest.Chain;
+    crypto: V1CreateOrderRequest.Crypto;
+    items?: AcqClient.V1OrderItem[];
+}
+
+export namespace V1CreateOrderRequest {
+    export const Chain = {
+        Eth: "ETH",
+        Bsc: "BSC",
+    } as const;
+    export type Chain = (typeof Chain)[keyof typeof Chain];
+    export const Crypto = {
+        Usdt: "USDT",
+        Usdc: "USDC",
+    } as const;
+    export type Crypto = (typeof Crypto)[keyof typeof Crypto];
+}

package/api/resources/orders/client/requests/index.ts

@@ -0,0 +1,3 @@
+export type { GetOrdersIdDetailsRequest } from "./GetOrdersIdDetailsRequest.js";
+export type { GetOrdersRequest } from "./GetOrdersRequest.js";
+export type { V1CreateOrderRequest } from "./V1CreateOrderRequest.js";

package/api/resources/orders/index.ts

@@ -0,0 +1,2 @@
+export * from "./client/index.js";
+export * from "./types/index.js";

package/api/resources/orders/types/GetOrdersIdDetailsResponse.ts

@@ -0,0 +1,9 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as AcqClient from "../../../index.js";
+
+export interface GetOrdersIdDetailsResponse {
+    data?: AcqClient.V1OrderResponse;
+    code?: number;
+    message?: string;
+}

package/api/resources/orders/types/GetOrdersResponse.ts

@@ -0,0 +1,9 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as AcqClient from "../../../index.js";
+
+export interface GetOrdersResponse {
+    data?: AcqClient.V1OrderPaginatedResponse;
+    code?: number;
+    message?: string;
+}

package/api/resources/orders/types/PostOrdersResponse.ts

@@ -0,0 +1,9 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as AcqClient from "../../../index.js";
+
+export interface PostOrdersResponse {
+    data?: AcqClient.V1CreateOrderResponse;
+    code?: number;
+    message?: string;
+}

package/api/resources/orders/types/index.ts

@@ -0,0 +1,3 @@
+export * from "./GetOrdersIdDetailsResponse.js";
+export * from "./GetOrdersResponse.js";
+export * from "./PostOrdersResponse.js";