remita-checkout-client 0.1.0

package/dist/cli.mjs

@@ -0,0 +1,231 @@
+#!/usr/bin/env node
+import {
+  RemitaCheckoutClient,
+  __commonJS,
+  init_client
+} from "./chunk-MGQQHIIZ.mjs";
+
+// src/cli.ts
+import { parseArgs } from "util";
+var require_cli = __commonJS({
+  "src/cli.ts"() {
+    init_client();
+    function printUsage() {
+      console.log(`
+remita-checkout <command> [options]
+
+Commands:
+  pre         Pre-payment initialization
+  fee         Calculate channel fee
+  initiate    Initiate a payment
+  authorize   Submit authorization params to an actionUrl
+  validate    Validate second-factor authorization (e.g. OTP)
+  verify      Verify payment status by reference
+  stream      Stream real-time status updates (SSE) for a transaction
+  banks       List supported banks
+  ussd        List USSD codes
+  wallets     List wallet types
+
+Global options:
+  --key <publicKey>            Remita public key (required for most commands)
+  --env <qa|demo|production>   Explicit environment (skips prefix detection)
+  --base-url <url>             Override the resolved base URL entirely
+  --json                       Print raw JSON only, useful for piping
+
+Command-specific options:
+  pre:        --rrr <rrr> | --txn <transactionId> [--payload '<json>']
+  fee:        --amount <amount> --channel <channel>
+  initiate:   --amount <amount> --channel <channel> [--txn <transactionId>]
+  authorize:  --action-url <url> --payload '<json>'
+  validate:   --payload '<json>' [--action-url <url>] [--ref <paymentReference>] [--otp <otp>]
+  verify:     --ref <paymentReference>
+  stream:     --trx <trxRef>
+
+Examples:
+  remita-checkout pre --key QA-abc123 --rrr 123456789
+  remita-checkout initiate --key QA-abc123 --amount 5000 --channel card --json
+  remita-checkout stream --key QA-abc123 --trx TRX-001
+`);
+    }
+    function buildClient(values) {
+      const key = values.key;
+      if (!key) throw new Error("--key is required.");
+      const baseUrl = values["base-url"];
+      return new RemitaCheckoutClient({
+        publicKey: key,
+        environment: values.env,
+        baseUrls: baseUrl ? { qa: baseUrl, demo: baseUrl, production: baseUrl } : void 0,
+        onEnvironmentDetectionFallback: (guessed) => {
+          if (!values.json) {
+            console.error(`(couldn't detect environment from key prefix, defaulting to "${guessed}")`);
+          }
+        }
+      });
+    }
+    function output(values, label, data) {
+      if (values.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+      }
+      console.log(`
+${label}:`);
+      console.log(JSON.stringify(data, null, 2));
+    }
+    function parsePayload(raw) {
+      if (!raw) return {};
+      try {
+        return JSON.parse(raw);
+      } catch {
+        throw new Error(`--payload must be valid JSON, e.g. --payload '{"otp":"123456"}'`);
+      }
+    }
+    async function main() {
+      const { values, positionals } = parseArgs({
+        allowPositionals: true,
+        options: {
+          key: { type: "string" },
+          env: { type: "string" },
+          "base-url": { type: "string" },
+          json: { type: "boolean", default: false },
+          rrr: { type: "string" },
+          txn: { type: "string" },
+          amount: { type: "string" },
+          channel: { type: "string" },
+          "action-url": { type: "string" },
+          payload: { type: "string" },
+          ref: { type: "string" },
+          otp: { type: "string" },
+          trx: { type: "string" },
+          help: { type: "boolean", default: false }
+        }
+      });
+      const command = positionals[0];
+      if (!command || values.help) {
+        printUsage();
+        process.exit(command ? 0 : 1);
+      }
+      try {
+        switch (command) {
+          case "pre": {
+            const client = buildClient(values);
+            const result = await client.prePayment({
+              ...parsePayload(values.payload),
+              publicKey: client.publicKey,
+              rrr: values.rrr,
+              transactionId: values.txn
+            });
+            output(values, "Pre-payment response", result);
+            break;
+          }
+          case "fee": {
+            const client = buildClient(values);
+            if (!values.amount || !values.channel) {
+              throw new Error("fee requires --amount and --channel.");
+            }
+            const result = await client.calculateFee({
+              publicKey: client.publicKey,
+              amount: Number(values.amount),
+              channel: values.channel
+            });
+            output(values, "Fee response", result);
+            break;
+          }
+          case "initiate": {
+            const client = buildClient(values);
+            if (!values.amount || !values.channel) {
+              throw new Error("initiate requires --amount and --channel.");
+            }
+            const result = await client.initiatePayment({
+              publicKey: client.publicKey,
+              amount: Number(values.amount),
+              channel: values.channel,
+              transactionId: values.txn
+            });
+            output(values, "Initiate response", result);
+            break;
+          }
+          case "authorize": {
+            const client = buildClient(values);
+            const actionUrl = values["action-url"];
+            if (!actionUrl) throw new Error("authorize requires --action-url.");
+            const result = await client.authorize(
+              actionUrl,
+              parsePayload(values.payload)
+            );
+            output(values, "Authorize response", result);
+            break;
+          }
+          case "validate": {
+            const client = buildClient(values);
+            const payload = parsePayload(values.payload);
+            const result = await client.validatePayment(
+              {
+                paymentReference: values.ref,
+                otp: values.otp,
+                ...payload
+              },
+              values["action-url"]
+            );
+            output(values, "Validate response", result);
+            break;
+          }
+          case "verify": {
+            const client = buildClient(values);
+            const ref = values.ref;
+            if (!ref) throw new Error("verify requires --ref.");
+            const result = await client.verifyPayment(ref);
+            output(values, "Verify response", result);
+            break;
+          }
+          case "stream": {
+            const client = buildClient(values);
+            const trx = values.trx;
+            if (!trx) throw new Error("stream requires --trx.");
+            console.error(`Streaming status for ${trx}. Ctrl+C to stop.`);
+            const handle = client.streamPaymentStatus(trx, {
+              onOpen: () => console.error("(stream open)"),
+              onMessage: (event) => console.log(JSON.stringify(event.data, null, 2)),
+              onError: (err) => {
+                console.error("Stream error:", err);
+                process.exitCode = 1;
+              }
+            });
+            process.on("SIGINT", () => {
+              handle.close();
+              process.exit(0);
+            });
+            await new Promise(() => {
+            });
+            break;
+          }
+          case "banks": {
+            const client = buildClient(values);
+            output(values, "Bank list", await client.getBankList());
+            break;
+          }
+          case "ussd": {
+            const client = buildClient(values);
+            output(values, "USSD codes", await client.getUssdCodes());
+            break;
+          }
+          case "wallets": {
+            const client = buildClient(values);
+            output(values, "Wallet types", await client.getWalletTypes());
+            break;
+          }
+          default:
+            console.error(`Unknown command: ${command}
+`);
+            printUsage();
+            process.exit(1);
+        }
+      } catch (err) {
+        console.error("Error:", err instanceof Error ? err.message : err);
+        process.exitCode = 1;
+      }
+    }
+    main();
+  }
+});
+export default require_cli();
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n// Node.js provides this builtin at runtime; the project does not currently\n// include Node.js type definitions, so suppress only this module-resolution\n// diagnostic until @types/node is added.\n// @ts-ignore\nimport { parseArgs } from \"node:util\";\nimport { RemitaCheckoutClient } from \"./client\";\nimport type { RemitaEnvironment } from \"./environment\";\n\ndeclare const process: {\n  exit(code?: number): never;\n  exitCode?: number;\n  on(signal: string, listener: () => void): void;\n};\n\nfunction printUsage(): void {\n  console.log(`\nremita-checkout <command> [options]\n\nCommands:\n  pre         Pre-payment initialization\n  fee         Calculate channel fee\n  initiate    Initiate a payment\n  authorize   Submit authorization params to an actionUrl\n  validate    Validate second-factor authorization (e.g. OTP)\n  verify      Verify payment status by reference\n  stream      Stream real-time status updates (SSE) for a transaction\n  banks       List supported banks\n  ussd        List USSD codes\n  wallets     List wallet types\n\nGlobal options:\n  --key <publicKey>            Remita public key (required for most commands)\n  --env <qa|demo|production>   Explicit environment (skips prefix detection)\n  --base-url <url>             Override the resolved base URL entirely\n  --json                       Print raw JSON only, useful for piping\n\nCommand-specific options:\n  pre:        --rrr <rrr> | --txn <transactionId> [--payload '<json>']\n  fee:        --amount <amount> --channel <channel>\n  initiate:   --amount <amount> --channel <channel> [--txn <transactionId>]\n  authorize:  --action-url <url> --payload '<json>'\n  validate:   --payload '<json>' [--action-url <url>] [--ref <paymentReference>] [--otp <otp>]\n  verify:     --ref <paymentReference>\n  stream:     --trx <trxRef>\n\nExamples:\n  remita-checkout pre --key QA-abc123 --rrr 123456789\n  remita-checkout initiate --key QA-abc123 --amount 5000 --channel card --json\n  remita-checkout stream --key QA-abc123 --trx TRX-001\n`);\n}\n\ntype ParsedValues = Record<string, string | boolean | undefined>;\n\nfunction buildClient(values: ParsedValues): RemitaCheckoutClient {\n  const key = values.key as string | undefined;\n  if (!key) throw new Error(\"--key is required.\");\n\n  const baseUrl = values[\"base-url\"] as string | undefined;\n\n  return new RemitaCheckoutClient({\n    publicKey: key,\n    environment: values.env as RemitaEnvironment | undefined,\n    baseUrls: baseUrl ? { qa: baseUrl, demo: baseUrl, production: baseUrl } : undefined,\n    onEnvironmentDetectionFallback: (guessed) => {\n      if (!values.json) {\n        console.error(`(couldn't detect environment from key prefix, defaulting to \"${guessed}\")`);\n      }\n    },\n  });\n}\n\nfunction output(values: ParsedValues, label: string, data: unknown): void {\n  if (values.json) {\n    console.log(JSON.stringify(data, null, 2));\n    return;\n  }\n  console.log(`\\n${label}:`);\n  console.log(JSON.stringify(data, null, 2));\n}\n\nfunction parsePayload(raw: string | undefined): Record<string, unknown> {\n  if (!raw) return {};\n  try {\n    return JSON.parse(raw);\n  } catch {\n    throw new Error(`--payload must be valid JSON, e.g. --payload '{\"otp\":\"123456\"}'`);\n  }\n}\n\nasync function main(): Promise<void> {\n  const { values, positionals } = parseArgs({\n    allowPositionals: true,\n    options: {\n      key: { type: \"string\" },\n      env: { type: \"string\" },\n      \"base-url\": { type: \"string\" },\n      json: { type: \"boolean\", default: false },\n      rrr: { type: \"string\" },\n      txn: { type: \"string\" },\n      amount: { type: \"string\" },\n      channel: { type: \"string\" },\n      \"action-url\": { type: \"string\" },\n      payload: { type: \"string\" },\n      ref: { type: \"string\" },\n      otp: { type: \"string\" },\n      trx: { type: \"string\" },\n      help: { type: \"boolean\", default: false },\n    },\n  });\n\n  const command = positionals[0];\n\n  if (!command || values.help) {\n    printUsage();\n    process.exit(command ? 0 : 1);\n  }\n\n  try {\n    switch (command) {\n      case \"pre\": {\n        const client = buildClient(values);\n        const result = await client.prePayment({\n          ...parsePayload(values.payload as string | undefined),\n          publicKey: client.publicKey,\n          rrr: values.rrr as string | undefined,\n          transactionId: values.txn as string | undefined,\n        } as unknown as Parameters<RemitaCheckoutClient[\"prePayment\"]>[0]);\n        output(values, \"Pre-payment response\", result);\n        break;\n      }\n\n      case \"fee\": {\n        const client = buildClient(values);\n        if (!values.amount || !values.channel) {\n          throw new Error(\"fee requires --amount and --channel.\");\n        }\n        const result = await client.calculateFee({\n          publicKey: client.publicKey,\n          amount: Number(values.amount),\n          channel: values.channel as string,\n        });\n        output(values, \"Fee response\", result);\n        break;\n      }\n\n      case \"initiate\": {\n        const client = buildClient(values);\n        if (!values.amount || !values.channel) {\n          throw new Error(\"initiate requires --amount and --channel.\");\n        }\n        const result = await client.initiatePayment({\n          publicKey: client.publicKey,\n          amount: Number(values.amount),\n          channel: values.channel as string,\n          transactionId: values.txn as string | undefined,\n        });\n        output(values, \"Initiate response\", result);\n        break;\n      }\n\n      case \"authorize\": {\n        const client = buildClient(values);\n        const actionUrl = values[\"action-url\"] as string | undefined;\n        if (!actionUrl) throw new Error(\"authorize requires --action-url.\");\n        const result = await client.authorize(\n          actionUrl,\n          parsePayload(values.payload as string | undefined)\n        );\n        output(values, \"Authorize response\", result);\n        break;\n      }\n\n      case \"validate\": {\n        const client = buildClient(values);\n        const payload = parsePayload(values.payload as string | undefined);\n        const result = await client.validatePayment(\n          {\n            paymentReference: values.ref as string | undefined,\n            otp: values.otp as string | undefined,\n            ...payload,\n          },\n          values[\"action-url\"] as string | undefined\n        );\n        output(values, \"Validate response\", result);\n        break;\n      }\n\n      case \"verify\": {\n        const client = buildClient(values);\n        const ref = values.ref as string | undefined;\n        if (!ref) throw new Error(\"verify requires --ref.\");\n        const result = await client.verifyPayment(ref);\n        output(values, \"Verify response\", result);\n        break;\n      }\n\n      case \"stream\": {\n        const client = buildClient(values);\n        const trx = values.trx as string | undefined;\n        if (!trx) throw new Error(\"stream requires --trx.\");\n        console.error(`Streaming status for ${trx}. Ctrl+C to stop.`);\n        const handle = client.streamPaymentStatus(trx, {\n          onOpen: () => console.error(\"(stream open)\"),\n          onMessage: (event) => console.log(JSON.stringify(event.data, null, 2)),\n          onError: (err) => {\n            console.error(\"Stream error:\", err);\n            process.exitCode = 1;\n          },\n        });\n        process.on(\"SIGINT\", () => {\n          handle.close();\n          process.exit(0);\n        });\n        await new Promise(() => {}); // keep the process alive until Ctrl+C\n        break;\n      }\n\n      case \"banks\": {\n        const client = buildClient(values);\n        output(values, \"Bank list\", await client.getBankList());\n        break;\n      }\n\n      case \"ussd\": {\n        const client = buildClient(values);\n        output(values, \"USSD codes\", await client.getUssdCodes());\n        break;\n      }\n\n      case \"wallets\": {\n        const client = buildClient(values);\n        output(values, \"Wallet types\", await client.getWalletTypes());\n        break;\n      }\n\n      default:\n        console.error(`Unknown command: ${command}\\n`);\n        printUsage();\n        process.exit(1);\n    }\n  } catch (err) {\n    console.error(\"Error:\", err instanceof Error ? err.message : err);\n    process.exitCode = 1;\n  }\n}\n\nmain();\n"],"mappings":"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","names":[]}

package/dist/index.d.mts

@@ -0,0 +1,225 @@
+type RemitaEnvironment = "qa" | "demo" | "production";
+declare const ENVIRONMENT_BASE_URLS: Record<RemitaEnvironment, string>;
+interface ResolveEnvironmentOptions {
+    /** Explicit override — always wins over prefix detection. */
+    environment?: RemitaEnvironment;
+    /** Custom base URLs, e.g. to point at a local/staging mirror. */
+    baseUrls?: Partial<Record<RemitaEnvironment, string>>;
+}
+interface ResolvedEnvironment {
+    environment: RemitaEnvironment;
+    baseUrl: string;
+    /** False when detection couldn't confidently match a prefix and we fell back to a default. */
+    detected: boolean;
+}
+declare function resolveEnvironment(publicKey: string, options?: ResolveEnvironmentOptions): ResolvedEnvironment;
+
+interface ApiErrorPayload {
+    responseCode?: string;
+    responseMessage?: string;
+    message?: string;
+    [key: string]: unknown;
+}
+declare class RemitaApiError extends Error {
+    readonly status: number;
+    readonly payload: ApiErrorPayload | undefined;
+    constructor(message: string, status: number, payload?: ApiErrorPayload);
+}
+interface PrePaymentRequest {
+    firstName: string;
+    lastName: string;
+    email: string;
+    phoneNumber: string;
+    paymentIdentifier: string;
+    currency: string;
+    narration?: string;
+    amount: number;
+    [key: string]: unknown;
+}
+interface PaymentChannel {
+    code: string;
+    name: string;
+    [key: string]: unknown;
+}
+interface PrePaymentResponse {
+    merchantName?: string;
+    amount?: number | string;
+    currency?: string;
+    channels?: PaymentChannel[];
+    /** Forwarded from /payment/pre if the API echoes one. */
+    transactionId?: string;
+    paymentReference?: string;
+    [key: string]: unknown;
+}
+interface FeeChargeRequest {
+    amount: number;
+    channel: string;
+    [key: string]: unknown;
+}
+interface FeeChargeResponse {
+    fee?: number | string;
+    totalAmount?: number | string;
+    [key: string]: unknown;
+}
+interface InitiatePaymentRequest {
+    channel: string;
+    amount: number;
+    transactionId?: string;
+    [key: string]: unknown;
+}
+interface InitiatePaymentResponse {
+    /** Where to POST the next-step authorization payload (OTP, PIN, 3DS fields, etc). */
+    actionUrl?: string;
+    paymentReference?: string;
+    transactionId?: string;
+    status?: string;
+    [key: string]: unknown;
+}
+type AuthorizePayload = Record<string, unknown>;
+interface AuthorizeResponse {
+    status?: string;
+    requiresValidation?: boolean;
+    [key: string]: unknown;
+}
+interface ValidatePaymentRequest {
+    paymentReference?: string;
+    transactionId?: string;
+    otp?: string;
+    [key: string]: unknown;
+}
+interface ValidatePaymentResponse {
+    status?: string;
+    [key: string]: unknown;
+}
+type PaymentStatus = "APPROVED" | "PENDING" | "FAILED" | (string & {});
+interface VerifyPaymentResponse {
+    status?: PaymentStatus;
+    paymentReference?: string;
+    amount?: number | string;
+    [key: string]: unknown;
+}
+interface Bank {
+    code: string;
+    name: string;
+    currency?: string;
+    [key: string]: unknown;
+}
+interface BankListResponse {
+    banks: Bank[];
+    [key: string]: unknown;
+}
+interface UssdCode {
+    bankCode: string;
+    ussdCode: string;
+    [key: string]: unknown;
+}
+interface UssdCodesResponse {
+    codes: UssdCode[];
+    [key: string]: unknown;
+}
+interface WalletType {
+    code: string;
+    name: string;
+    [key: string]: unknown;
+}
+interface WalletTypesResponse {
+    wallets: WalletType[];
+    [key: string]: unknown;
+}
+interface StatusStreamEvent {
+    status?: PaymentStatus;
+    [key: string]: unknown;
+}
+
+interface StatusStreamOptions {
+    onMessage: (event: {
+        data: unknown;
+        raw: string;
+    }) => void;
+    onError?: (err: unknown) => void;
+    onOpen?: () => void;
+    fetchImpl?: typeof fetch;
+    /** Optional override; publicKey is sent as a query param by default. */
+    sendPublicKeyHeader?: boolean;
+}
+interface StatusStreamHandle {
+    close: () => void;
+}
+/**
+ * Opens the payment status SSE stream using a manual fetch + ReadableStream
+ * reader rather than the browser-only `EventSource` global, so this works
+ * identically in the browser and in Node 18+.
+ */
+declare function openStatusStream(baseUrl: string, trxRef: string, publicKey: string, options: StatusStreamOptions): StatusStreamHandle;
+
+interface RemitaCheckoutClientOptions extends ResolveEnvironmentOptions {
+    publicKey: string;
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+    /** Extra headers merged after `publicKey` is set (so they can override). */
+    defaultHeaders?: Record<string, string>;
+    /** Called once if the environment couldn't be confidently detected from the key prefix (falls back to "qa"). */
+    onEnvironmentDetectionFallback?: (guessed: "qa") => void;
+}
+declare class RemitaCheckoutClient {
+    readonly publicKey: string;
+    readonly environment: string;
+    readonly baseUrl: string;
+    private readonly http;
+    constructor(options: RemitaCheckoutClientOptions);
+    prePayment(request: PrePaymentRequest): Promise<PrePaymentResponse>;
+    calculateFee(request: FeeChargeRequest): Promise<FeeChargeResponse>;
+    initiatePayment(request: InitiatePaymentRequest): Promise<InitiatePaymentResponse>;
+    /**
+     * Posts authorization params (OTP, PIN, 3DS form fields, etc) to the
+     * processor-provided actionUrl from initiatePayment().
+     *
+     * NOTE: CyberSource/Cardinal 3DS endpoints expect
+     * `application/x-www-form-urlencoded`. Pass `contentType` if the
+     * actionUrl is a 3DS processor endpoint.
+     */
+    authorize(actionUrl: string, payload: AuthorizePayload, contentType?: string): Promise<AuthorizeResponse>;
+    /**
+     * Validates second-factor authorization (e.g. OTP). Per the endpoint docs
+     * this may go to a fixed /payment/validate endpoint OR to a dynamic
+     * actionUrl — pass `actionUrl` if the preceding step returned one.
+     */
+    validatePayment(request: ValidatePaymentRequest, actionUrl?: string): Promise<ValidatePaymentResponse>;
+    verifyPayment(paymentRef: string): Promise<VerifyPaymentResponse>;
+    /** Opens an SSE stream for real-time status updates. Call the returned `close()` when done. */
+    streamPaymentStatus(trxRef: string, options: StatusStreamOptions): StatusStreamHandle;
+    getBankList(): Promise<BankListResponse>;
+    getUssdCodes(): Promise<UssdCodesResponse>;
+    getWalletTypes(): Promise<WalletTypesResponse>;
+}
+
+type PaymentSessionStage = "idle" | "pre" | "fee" | "initiated" | "authorized" | "validated" | "verified" | "failed";
+/**
+ * Sequences the multi-step payment flow (pre → fee → initiate → authorize →
+ * validate → verify) and tracks the refs each step hands to the next
+ * (paymentReference, transactionId, actionUrl), so callers don't have to
+ * thread that state through by hand.
+ */
+declare class PaymentSession {
+    private readonly client;
+    stage: PaymentSessionStage;
+    paymentReference?: string;
+    transactionId?: string;
+    /** URL returned by initiate() for the *authorize* step. */
+    private authorizeActionUrl?;
+    /** URL returned by authorize() for the *validate* step, if different. */
+    private validateActionUrl?;
+    constructor(client: RemitaCheckoutClient);
+    pre(request: PrePaymentRequest): Promise<PrePaymentResponse>;
+    fee(request: FeeChargeRequest): Promise<FeeChargeResponse>;
+    initiate(request: InitiatePaymentRequest): Promise<InitiatePaymentResponse>;
+    /**
+     * Uses the actionUrl captured from initiate() unless you pass one explicitly.
+     * Pass `contentType` for 3DS processor endpoints that require form-encoding.
+     */
+    authorize(payload: AuthorizePayload, actionUrlOverride?: string, contentType?: string): Promise<AuthorizeResponse>;
+    validate(request: ValidatePaymentRequest, actionUrlOverride?: string): Promise<ValidatePaymentResponse>;
+    verify(paymentRefOverride?: string): Promise<VerifyPaymentResponse>;
+}
+
+export { type ApiErrorPayload, type AuthorizePayload, type AuthorizeResponse, type Bank, type BankListResponse, ENVIRONMENT_BASE_URLS, type FeeChargeRequest, type FeeChargeResponse, type InitiatePaymentRequest, type InitiatePaymentResponse, type PaymentChannel, PaymentSession, type PaymentSessionStage, type PaymentStatus, type PrePaymentRequest, type PrePaymentResponse, RemitaApiError, RemitaCheckoutClient, type RemitaCheckoutClientOptions, type RemitaEnvironment, type ResolveEnvironmentOptions, type ResolvedEnvironment, type StatusStreamEvent, type StatusStreamHandle, type StatusStreamOptions, type UssdCode, type UssdCodesResponse, type ValidatePaymentRequest, type ValidatePaymentResponse, type VerifyPaymentResponse, type WalletType, type WalletTypesResponse, openStatusStream, resolveEnvironment };