@revkeen/sdk 1.20260312.41

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

@@ -0,0 +1,493 @@
+// 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 } 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 RevKeen from "../../../index.js";
+
+export declare namespace OrdersClient {
+    export type Options = BaseClientOptions;
+
+    export interface RequestOptions extends BaseRequestOptions {}
+}
+
+/**
+ * One-off purchases with lifecycle operations: create, pay, cancel, and fulfill.
+ *
+ * **Required Scopes:**
+ * - `orders:read` - List and retrieve orders
+ * - `orders:write` - Create, cancel, fulfill orders
+ *
+ * **MCP Tools:** `orders_list`, `orders_create`, `orders_cancel`, `orders_fulfill`
+ */
+export class OrdersClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<OrdersClient.Options>;
+
+    constructor(options: OrdersClient.Options) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+
+    /**
+     * List all orders for the authenticated merchant. Supports filtering and cursor-based pagination.
+     *
+     * @param {RevKeen.OrdersListRequest} request
+     * @param {OrdersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link RevKeen.UnauthorizedError}
+     *
+     * @example
+     *     await client.orders.list()
+     */
+    public list(
+        request: RevKeen.OrdersListRequest = {},
+        requestOptions?: OrdersClient.RequestOptions,
+    ): core.HttpResponsePromise<RevKeen.OrderListResponse> {
+        return core.HttpResponsePromise.fromPromise(this.__list(request, requestOptions));
+    }
+
+    private async __list(
+        request: RevKeen.OrdersListRequest = {},
+        requestOptions?: OrdersClient.RequestOptions,
+    ): Promise<core.WithRawResponse<RevKeen.OrderListResponse>> {
+        const {
+            customer_id: customerId,
+            status,
+            billing_type: billingType,
+            created_gte: createdGte,
+            created_lte: createdLte,
+            limit,
+            starting_after: startingAfter,
+            ending_before: endingBefore,
+        } = request;
+        const _queryParams: Record<string, unknown> = {
+            customer_id: customerId,
+            status: status != null ? status : undefined,
+            billing_type: billingType != null ? billingType : undefined,
+            created_gte: createdGte,
+            created_lte: createdLte,
+            limit,
+            starting_after: startingAfter,
+            ending_before: endingBefore,
+        };
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            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.RevKeenEnvironment.Default,
+                "orders",
+            ),
+            method: "GET",
+            headers: _headers,
+            queryParameters: { ..._queryParams, ...requestOptions?.queryParams },
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body as RevKeen.OrderListResponse, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new RevKeen.UnauthorizedError(_response.error.body as unknown, _response.rawResponse);
+                default:
+                    throw new errors.RevKeenError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/orders");
+    }
+
+    /**
+     * Creates a new order with line items. Orders start in draft status.
+     *
+     * @param {RevKeen.CreateOrderRequest} request
+     * @param {OrdersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link RevKeen.BadRequestError}
+     * @throws {@link RevKeen.UnauthorizedError}
+     * @throws {@link RevKeen.NotFoundError}
+     *
+     * @example
+     *     await client.orders.create({
+     *         line_items: [{
+     *                 description: "description",
+     *                 unit_price: 1
+     *             }]
+     *     })
+     */
+    public create(
+        request: RevKeen.CreateOrderRequest,
+        requestOptions?: OrdersClient.RequestOptions,
+    ): core.HttpResponsePromise<RevKeen.Order> {
+        return core.HttpResponsePromise.fromPromise(this.__create(request, requestOptions));
+    }
+
+    private async __create(
+        request: RevKeen.CreateOrderRequest,
+        requestOptions?: OrdersClient.RequestOptions,
+    ): Promise<core.WithRawResponse<RevKeen.Order>> {
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            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.RevKeenEnvironment.Default,
+                "orders",
+            ),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: request,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body as RevKeen.Order, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new RevKeen.BadRequestError(_response.error.body as unknown, _response.rawResponse);
+                case 401:
+                    throw new RevKeen.UnauthorizedError(_response.error.body as unknown, _response.rawResponse);
+                case 404:
+                    throw new RevKeen.NotFoundError(_response.error.body as unknown, _response.rawResponse);
+                default:
+                    throw new errors.RevKeenError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/orders");
+    }
+
+    /**
+     * Retrieves an order by its ID, including line items.
+     *
+     * @param {RevKeen.OrdersRetrieveRequest} request
+     * @param {OrdersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link RevKeen.UnauthorizedError}
+     * @throws {@link RevKeen.NotFoundError}
+     *
+     * @example
+     *     await client.orders.retrieve({
+     *         id: "id"
+     *     })
+     */
+    public retrieve(
+        request: RevKeen.OrdersRetrieveRequest,
+        requestOptions?: OrdersClient.RequestOptions,
+    ): core.HttpResponsePromise<RevKeen.Order> {
+        return core.HttpResponsePromise.fromPromise(this.__retrieve(request, requestOptions));
+    }
+
+    private async __retrieve(
+        request: RevKeen.OrdersRetrieveRequest,
+        requestOptions?: OrdersClient.RequestOptions,
+    ): Promise<core.WithRawResponse<RevKeen.Order>> {
+        const { id } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            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.RevKeenEnvironment.Default,
+                `orders/${core.url.encodePathParam(id)}`,
+            ),
+            method: "GET",
+            headers: _headers,
+            queryParameters: requestOptions?.queryParams,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body as RevKeen.Order, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new RevKeen.UnauthorizedError(_response.error.body as unknown, _response.rawResponse);
+                case 404:
+                    throw new RevKeen.NotFoundError(_response.error.body as unknown, _response.rawResponse);
+                default:
+                    throw new errors.RevKeenError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/orders/{id}");
+    }
+
+    /**
+     * Process payment for an order. Creates an invoice and charges the customer's payment method.
+     *
+     * @param {RevKeen.PayOrderRequest} request
+     * @param {OrdersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link RevKeen.BadRequestError}
+     * @throws {@link RevKeen.UnauthorizedError}
+     * @throws {@link RevKeen.NotFoundError}
+     *
+     * @example
+     *     await client.orders.pay({
+     *         id: "id"
+     *     })
+     */
+    public pay(
+        request: RevKeen.PayOrderRequest,
+        requestOptions?: OrdersClient.RequestOptions,
+    ): core.HttpResponsePromise<RevKeen.Order> {
+        return core.HttpResponsePromise.fromPromise(this.__pay(request, requestOptions));
+    }
+
+    private async __pay(
+        request: RevKeen.PayOrderRequest,
+        requestOptions?: OrdersClient.RequestOptions,
+    ): Promise<core.WithRawResponse<RevKeen.Order>> {
+        const { id, ..._body } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            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.RevKeenEnvironment.Default,
+                `orders/${core.url.encodePathParam(id)}/pay`,
+            ),
+            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,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body as RevKeen.Order, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new RevKeen.BadRequestError(_response.error.body as unknown, _response.rawResponse);
+                case 401:
+                    throw new RevKeen.UnauthorizedError(_response.error.body as unknown, _response.rawResponse);
+                case 404:
+                    throw new RevKeen.NotFoundError(_response.error.body as unknown, _response.rawResponse);
+                default:
+                    throw new errors.RevKeenError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/orders/{id}/pay");
+    }
+
+    /**
+     * Cancels an order. Only orders that haven't been paid or fulfilled can be canceled.
+     *
+     * @param {RevKeen.CancelOrderRequest} request
+     * @param {OrdersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link RevKeen.BadRequestError}
+     * @throws {@link RevKeen.UnauthorizedError}
+     * @throws {@link RevKeen.NotFoundError}
+     *
+     * @example
+     *     await client.orders.cancel({
+     *         id: "id"
+     *     })
+     */
+    public cancel(
+        request: RevKeen.CancelOrderRequest,
+        requestOptions?: OrdersClient.RequestOptions,
+    ): core.HttpResponsePromise<RevKeen.Order> {
+        return core.HttpResponsePromise.fromPromise(this.__cancel(request, requestOptions));
+    }
+
+    private async __cancel(
+        request: RevKeen.CancelOrderRequest,
+        requestOptions?: OrdersClient.RequestOptions,
+    ): Promise<core.WithRawResponse<RevKeen.Order>> {
+        const { id, ..._body } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            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.RevKeenEnvironment.Default,
+                `orders/${core.url.encodePathParam(id)}/cancel`,
+            ),
+            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,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body as RevKeen.Order, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new RevKeen.BadRequestError(_response.error.body as unknown, _response.rawResponse);
+                case 401:
+                    throw new RevKeen.UnauthorizedError(_response.error.body as unknown, _response.rawResponse);
+                case 404:
+                    throw new RevKeen.NotFoundError(_response.error.body as unknown, _response.rawResponse);
+                default:
+                    throw new errors.RevKeenError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/orders/{id}/cancel");
+    }
+
+    /**
+     * Mark an order as fulfilled. Optionally include shipping tracking information.
+     *
+     * @param {RevKeen.FulfillOrderRequest} request
+     * @param {OrdersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link RevKeen.BadRequestError}
+     * @throws {@link RevKeen.UnauthorizedError}
+     * @throws {@link RevKeen.NotFoundError}
+     *
+     * @example
+     *     await client.orders.fulfill({
+     *         id: "id"
+     *     })
+     */
+    public fulfill(
+        request: RevKeen.FulfillOrderRequest,
+        requestOptions?: OrdersClient.RequestOptions,
+    ): core.HttpResponsePromise<RevKeen.Order> {
+        return core.HttpResponsePromise.fromPromise(this.__fulfill(request, requestOptions));
+    }
+
+    private async __fulfill(
+        request: RevKeen.FulfillOrderRequest,
+        requestOptions?: OrdersClient.RequestOptions,
+    ): Promise<core.WithRawResponse<RevKeen.Order>> {
+        const { id, ..._body } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            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.RevKeenEnvironment.Default,
+                `orders/${core.url.encodePathParam(id)}/fulfill`,
+            ),
+            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,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body as RevKeen.Order, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new RevKeen.BadRequestError(_response.error.body as unknown, _response.rawResponse);
+                case 401:
+                    throw new RevKeen.UnauthorizedError(_response.error.body as unknown, _response.rawResponse);
+                case 404:
+                    throw new RevKeen.NotFoundError(_response.error.body as unknown, _response.rawResponse);
+                default:
+                    throw new errors.RevKeenError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/orders/{id}/fulfill");
+    }
+}

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

@@ -0,0 +1,2 @@
+export * from "./requests/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,2 @@
+export * from "./requests/index.js";
+//# sourceMappingURL=index.js.map

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

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

package/api/resources/orders/client/requests/CancelOrderRequest.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @example
+ *     {
+ *         id: "id"
+ *     }
+ */
+export interface CancelOrderRequest {
+    /** Order ID */
+    id: string;
+    /** Reason for cancellation */
+    reason?: string;
+}
+//# sourceMappingURL=CancelOrderRequest.d.ts.map

package/api/resources/orders/client/requests/CancelOrderRequest.js

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};
+//# sourceMappingURL=CancelOrderRequest.js.map

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

@@ -0,0 +1,14 @@
+// This file was auto-generated by Fern from our API Definition.
+
+/**
+ * @example
+ *     {
+ *         id: "id"
+ *     }
+ */
+export interface CancelOrderRequest {
+    /** Order ID */
+    id: string;
+    /** Reason for cancellation */
+    reason?: string;
+}

package/api/resources/orders/client/requests/CreateOrderRequest.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @example
+ *     {
+ *         line_items: [{
+ *                 description: "description",
+ *                 unit_price: 1
+ *             }]
+ *     }
+ */
+export interface CreateOrderRequest {
+    /** Customer ID (optional for guest orders) */
+    customer_id?: string;
+    /** Three-letter ISO currency code */
+    currency?: string;
+    /** Billing type. one_time: Single purchase. recurring: Subscription-based. */
+    billing_type?: CreateOrderRequest.BillingType;
+    /** Order line items (at least one required) */
+    line_items: CreateOrderRequest.LineItems.Item[];
+    /** Custom key-value metadata */
+    metadata?: Record<string, unknown>;
+    notes?: string;
+    /** Expiration timestamp for the order */
+    expires_at?: string;
+    /** ID of the linked invoice (Commercial Truth) */
+    invoice_id?: string;
+    /** ID of the linked subscription (for recurring fulfillment) */
+    subscription_id?: string;
+}
+export declare namespace CreateOrderRequest {
+    /** Billing type. one_time: Single purchase. recurring: Subscription-based. */
+    const BillingType: {
+        readonly OneTime: "one_time";
+        readonly Recurring: "recurring";
+    };
+    type BillingType = (typeof BillingType)[keyof typeof BillingType];
+    type LineItems = LineItems.Item[];
+    namespace LineItems {
+        interface Item {
+            /** Product ID (optional for ad-hoc items) */
+            product_id?: string;
+            description: string;
+            quantity?: number;
+            /** Unit price in cents */
+            unit_price: number;
+            /** Custom key-value metadata */
+            metadata?: Record<string, unknown>;
+        }
+    }
+}
+//# sourceMappingURL=CreateOrderRequest.d.ts.map

package/api/resources/orders/client/requests/CreateOrderRequest.js

@@ -0,0 +1,10 @@
+// This file was auto-generated by Fern from our API Definition.
+export var CreateOrderRequest;
+(function (CreateOrderRequest) {
+    /** Billing type. one_time: Single purchase. recurring: Subscription-based. */
+    CreateOrderRequest.BillingType = {
+        OneTime: "one_time",
+        Recurring: "recurring",
+    };
+})(CreateOrderRequest || (CreateOrderRequest = {}));
+//# sourceMappingURL=CreateOrderRequest.js.map

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

@@ -0,0 +1,53 @@
+// This file was auto-generated by Fern from our API Definition.
+
+/**
+ * @example
+ *     {
+ *         line_items: [{
+ *                 description: "description",
+ *                 unit_price: 1
+ *             }]
+ *     }
+ */
+export interface CreateOrderRequest {
+    /** Customer ID (optional for guest orders) */
+    customer_id?: string;
+    /** Three-letter ISO currency code */
+    currency?: string;
+    /** Billing type. one_time: Single purchase. recurring: Subscription-based. */
+    billing_type?: CreateOrderRequest.BillingType;
+    /** Order line items (at least one required) */
+    line_items: CreateOrderRequest.LineItems.Item[];
+    /** Custom key-value metadata */
+    metadata?: Record<string, unknown>;
+    notes?: string;
+    /** Expiration timestamp for the order */
+    expires_at?: string;
+    /** ID of the linked invoice (Commercial Truth) */
+    invoice_id?: string;
+    /** ID of the linked subscription (for recurring fulfillment) */
+    subscription_id?: string;
+}
+
+export namespace CreateOrderRequest {
+    /** Billing type. one_time: Single purchase. recurring: Subscription-based. */
+    export const BillingType = {
+        OneTime: "one_time",
+        Recurring: "recurring",
+    } as const;
+    export type BillingType = (typeof BillingType)[keyof typeof BillingType];
+    export type LineItems = LineItems.Item[];
+
+    export namespace LineItems {
+        export interface Item {
+            /** Product ID (optional for ad-hoc items) */
+            product_id?: string;
+            description: string;
+            quantity?: number;
+            /** Unit price in cents */
+            unit_price: number;
+            /** Custom key-value metadata */
+            metadata?: Record<string, unknown>;
+        }
+    }
+}

package/api/resources/orders/client/requests/FulfillOrderRequest.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @example
+ *     {
+ *         id: "id"
+ *     }
+ */
+export interface FulfillOrderRequest {
+    /** Order ID */
+    id: string;
+    /** Shipping tracking number */
+    tracking_number?: string;
+    /** Shipping carrier (e.g., 'ups', 'fedex', 'usps') */
+    carrier?: string;
+    /** Specific line items to fulfill (defaults to all) */
+    line_item_ids?: string[];
+    /** Send fulfillment notification to customer */
+    notify_customer?: boolean;
+}
+//# sourceMappingURL=FulfillOrderRequest.d.ts.map

package/api/resources/orders/client/requests/FulfillOrderRequest.js

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};
+//# sourceMappingURL=FulfillOrderRequest.js.map