@jacob-registry-repo/sdk 1.0.0

package/api/types/index.ts

@@ -0,0 +1,48 @@
+export * from "./HandlerWebhookEvent.js";
+export * from "./ModelMarketplaceStatus.js";
+export * from "./V1ApiKeyMetricsResponse.js";
+export * from "./V1ApiUsageChartItem.js";
+export * from "./V1BalanceChartDataItem.js";
+export * from "./V1CallbackConfigResponse.js";
+export * from "./V1CallbackEventResponse.js";
+export * from "./V1CallbackEventsPaginatedResponse.js";
+export * from "./V1CreateOrderResponse.js";
+export * from "./V1CreateWithdrawalResponse.js";
+export * from "./V1DashboardApiUsageResponse.js";
+export * from "./V1DashboardBalanceResponse.js";
+export * from "./V1DashboardOrdersSummaryResponse.js";
+export * from "./V1DashboardOverviewResponse.js";
+export * from "./V1DashboardStartGuideResponse.js";
+export * from "./V1ExchangeRateResponse.js";
+export * from "./V1GenerateApiKeyResponse.js";
+export * from "./V1GetApiKeyResponse.js";
+export * from "./V1GetApiKeyResponseData.js";
+export * from "./V1GetMerchantResponse.js";
+export * from "./V1GetMerchantResponseData.js";
+export * from "./V1GetSubMerchantResponse.js";
+export * from "./V1MerchantWalletBalanceResponse.js";
+export * from "./V1OrderItem.js";
+export * from "./V1OrderPaginatedResponse.js";
+export * from "./V1OrderResponse.js";
+export * from "./V1OrdersSummaryChartItem.js";
+export * from "./V1PaginationResponse.js";
+export * from "./V1PaymentSummary.js";
+export * from "./V1Response.js";
+export * from "./V1Setup2FaResponse.js";
+export * from "./V1StartGuideApiKeys.js";
+export * from "./V1StartGuideSdk.js";
+export * from "./V1StartGuideWallet.js";
+export * from "./V1SubMerchantListItem.js";
+export * from "./V1SubMerchantPaginatedResponse.js";
+export * from "./V1SubMerchantResponse.js";
+export * from "./V1SubMerchantWalletResponse.js";
+export * from "./V1TokenResponse.js";
+export * from "./V1TransactionPaginatedResponse.js";
+export * from "./V1TransactionResponse.js";
+export * from "./V1TransactionSummary.js";
+export * from "./V1WalletAddressInput.js";
+export * from "./V1WalletAddressPaginatedResponse.js";
+export * from "./V1WalletAddressResponse.js";
+export * from "./V1WalletBalanceResponse.js";
+export * from "./V1WithdrawalPaginatedResponse.js";
+export * from "./V1WithdrawalResponse.js";

package/auth/HeaderAuthProvider.ts

@@ -0,0 +1,39 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import * as core from "../core/index.js";
+import * as errors from "../errors/index.js";
+
+export namespace HeaderAuthProvider {
+    export interface AuthOptions {
+        apiKey?: core.Supplier<string>;
+    }
+
+    export interface Options extends AuthOptions {}
+}
+
+export class HeaderAuthProvider implements core.AuthProvider {
+    private readonly headerValue: core.Supplier<string> | undefined;
+
+    constructor(options: HeaderAuthProvider.Options) {
+        this.headerValue = options.apiKey;
+    }
+
+    public static canCreate(options: HeaderAuthProvider.Options): boolean {
+        return options.apiKey != null;
+    }
+
+    public async getAuthRequest(_arg?: { endpointMetadata?: core.EndpointMetadata }): Promise<core.AuthRequest> {
+        const apiKey = await core.Supplier.get(this.headerValue);
+        if (apiKey == null) {
+            throw new errors.AcqClientError({
+                message: "Please specify a apiKey by passing it in to the constructor",
+            });
+        }
+
+        const headerValue = apiKey;
+
+        return {
+            headers: { Authorization: headerValue },
+        };
+    }
+}

package/auth/index.ts

@@ -0,0 +1 @@
+export { HeaderAuthProvider } from "./HeaderAuthProvider.js";

package/core/auth/AuthProvider.ts

@@ -0,0 +1,6 @@
+import type { EndpointMetadata } from "../fetcher/EndpointMetadata.js";
+import type { AuthRequest } from "./AuthRequest.js";
+
+export interface AuthProvider {
+    getAuthRequest(arg?: { endpointMetadata?: EndpointMetadata }): Promise<AuthRequest>;
+}

package/core/auth/AuthRequest.ts

@@ -0,0 +1,9 @@
+/**
+ * Request parameters for authentication requests.
+ */
+export interface AuthRequest {
+    /**
+     * The headers to be included in the request.
+     */
+    headers: Record<string, string>;
+}

package/core/auth/BasicAuth.ts

@@ -0,0 +1,32 @@
+import { base64Decode, base64Encode } from "../base64.js";
+
+export interface BasicAuth {
+    username: string;
+    password: string;
+}
+
+const BASIC_AUTH_HEADER_PREFIX = /^Basic /i;
+
+export const BasicAuth = {
+    toAuthorizationHeader: (basicAuth: BasicAuth | undefined): string | undefined => {
+        if (basicAuth == null) {
+            return undefined;
+        }
+        const token = base64Encode(`${basicAuth.username}:${basicAuth.password}`);
+        return `Basic ${token}`;
+    },
+    fromAuthorizationHeader: (header: string): BasicAuth => {
+        const credentials = header.replace(BASIC_AUTH_HEADER_PREFIX, "");
+        const decoded = base64Decode(credentials);
+        const [username, ...passwordParts] = decoded.split(":");
+        const password = passwordParts.length > 0 ? passwordParts.join(":") : undefined;
+
+        if (username == null || password == null) {
+            throw new Error("Invalid basic auth");
+        }
+        return {
+            username,
+            password,
+        };
+    },
+};

package/core/auth/BearerToken.ts

@@ -0,0 +1,20 @@
+export type BearerToken = string;
+
+const BEARER_AUTH_HEADER_PREFIX = /^Bearer /i;
+
+function toAuthorizationHeader(token: string | undefined): string | undefined {
+    if (token == null) {
+        return undefined;
+    }
+    return `Bearer ${token}`;
+}
+
+export const BearerToken: {
+    toAuthorizationHeader: typeof toAuthorizationHeader;
+    fromAuthorizationHeader: (header: string) => BearerToken;
+} = {
+    toAuthorizationHeader: toAuthorizationHeader,
+    fromAuthorizationHeader: (header: string): BearerToken => {
+        return header.replace(BEARER_AUTH_HEADER_PREFIX, "").trim() as BearerToken;
+    },
+};

package/core/auth/NoOpAuthProvider.ts

@@ -0,0 +1,8 @@
+import type { AuthProvider } from "./AuthProvider.js";
+import type { AuthRequest } from "./AuthRequest.js";
+
+export class NoOpAuthProvider implements AuthProvider {
+    public getAuthRequest(): Promise<AuthRequest> {
+        return Promise.resolve({ headers: {} });
+    }
+}

package/core/auth/index.ts

@@ -0,0 +1,5 @@
+export type { AuthProvider } from "./AuthProvider.js";
+export type { AuthRequest } from "./AuthRequest.js";
+export { BasicAuth } from "./BasicAuth.js";
+export { BearerToken } from "./BearerToken.js";
+export { NoOpAuthProvider } from "./NoOpAuthProvider.js";

package/core/base64.ts

@@ -0,0 +1,27 @@
+function base64ToBytes(base64: string): Uint8Array {
+    const binString = atob(base64);
+    return Uint8Array.from(binString, (m) => m.codePointAt(0)!);
+}
+
+function bytesToBase64(bytes: Uint8Array): string {
+    const binString = String.fromCodePoint(...bytes);
+    return btoa(binString);
+}
+
+export function base64Encode(input: string): string {
+    if (typeof Buffer !== "undefined") {
+        return Buffer.from(input, "utf8").toString("base64");
+    }
+
+    const bytes = new TextEncoder().encode(input);
+    return bytesToBase64(bytes);
+}
+
+export function base64Decode(input: string): string {
+    if (typeof Buffer !== "undefined") {
+        return Buffer.from(input, "base64").toString("utf8");
+    }
+
+    const bytes = base64ToBytes(input);
+    return new TextDecoder().decode(bytes);
+}

package/core/exports.ts

@@ -0,0 +1 @@
+export * from "./logging/exports.js";

package/core/fetcher/APIResponse.ts

@@ -0,0 +1,23 @@
+import type { RawResponse } from "./RawResponse.js";
+
+/**
+ * The response of an API call.
+ * It is a successful response or a failed response.
+ */
+export type APIResponse<Success, Failure> = SuccessfulResponse<Success> | FailedResponse<Failure>;
+
+export interface SuccessfulResponse<T> {
+    ok: true;
+    body: T;
+    /**
+     * @deprecated Use `rawResponse` instead
+     */
+    headers?: Record<string, any>;
+    rawResponse: RawResponse;
+}
+
+export interface FailedResponse<T> {
+    ok: false;
+    error: T;
+    rawResponse: RawResponse;
+}

package/core/fetcher/BinaryResponse.ts

@@ -0,0 +1,34 @@
+export type BinaryResponse = {
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */
+    bodyUsed: Response["bodyUsed"];
+    /**
+     * Returns a ReadableStream of the response body.
+     * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body)
+     */
+    stream: () => Response["body"];
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */
+    arrayBuffer: () => ReturnType<Response["arrayBuffer"]>;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */
+    blob: () => ReturnType<Response["blob"]>;
+    /**
+     * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes)
+     * Some versions of the Fetch API may not support this method.
+     */
+    bytes?(): ReturnType<Response["bytes"]>;
+};
+
+export function getBinaryResponse(response: Response): BinaryResponse {
+    const binaryResponse: BinaryResponse = {
+        get bodyUsed() {
+            return response.bodyUsed;
+        },
+        stream: () => response.body,
+        arrayBuffer: response.arrayBuffer.bind(response),
+        blob: response.blob.bind(response),
+    };
+    if ("bytes" in response && typeof response.bytes === "function") {
+        binaryResponse.bytes = response.bytes.bind(response);
+    }
+
+    return binaryResponse;
+}

package/core/fetcher/EndpointMetadata.ts

@@ -0,0 +1,13 @@
+export type SecuritySchemeKey = string;
+/**
+ * A collection of security schemes, where the key is the name of the security scheme and the value is the list of scopes required for that scheme.
+ * All schemes in the collection must be satisfied for authentication to be successful.
+ */
+export type SecuritySchemeCollection = Record<SecuritySchemeKey, AuthScope[]>;
+export type AuthScope = string;
+export type EndpointMetadata = {
+    /**
+     * An array of security scheme collections. Each collection represents an alternative way to authenticate.
+     */
+    security?: SecuritySchemeCollection[];
+};

package/core/fetcher/EndpointSupplier.ts

@@ -0,0 +1,14 @@
+import type { EndpointMetadata } from "./EndpointMetadata.js";
+import type { Supplier } from "./Supplier.js";
+
+type EndpointSupplierFn<T> = (arg: { endpointMetadata: EndpointMetadata }) => T | Promise<T>;
+export type EndpointSupplier<T> = Supplier<T> | EndpointSupplierFn<T>;
+export const EndpointSupplier = {
+    get: async <T>(supplier: EndpointSupplier<T>, arg: { endpointMetadata: EndpointMetadata }): Promise<T> => {
+        if (typeof supplier === "function") {
+            return (supplier as EndpointSupplierFn<T>)(arg);
+        } else {
+            return supplier;
+        }
+    },
+};