@enfuce/nextgen-sdk 0.0.5 → 0.0.6

package/src/wallet/client.ts

@@ -0,0 +1,128 @@
+/*
+ * Enfuce nextgen SDK — fluent module client.
+ *
+ * GENERATED by scripts/generate.sh from a custom template (generator-templates/typescript). One per
+ * API module: wires an OAuth-enabled axios instance (bearer token on every request + reactive 401
+ * retry) to the module's Configuration and exposes each API. Nothing is shared across modules.
+ */
+import globalAxios, { type AxiosInstance } from 'axios';
+import { createOAuthAxios, type TokenManager } from '../oauth';
+import { Configuration } from './configuration';
+import {
+  ActivateTokenApi,
+  DeactivateTokenApi,
+  EligibleTokenRequestorsApi,
+  GetTokensApi,
+  PushCardsApi,
+  PushProvisionApi,
+  SuspendTokenApi,
+  UnsuspendTokenApi,
+} from './api';
+
+/**
+ * Fluent entry point for this module. Build one with {@link WalletClient.builder}:
+ *
+ * ```ts
+ * const client = WalletClient.builder()
+ *   .baseUrl('https://api.example.com/...')
+ *   .oauth(tokens)
+ *   .build();
+ * ```
+ */
+export class WalletClient {
+
+  constructor(
+    /** The axios instance — OAuth interceptors and any customizations already applied. */
+    readonly http: AxiosInstance,
+    /** The module configuration — base path applied. */
+    readonly configuration: Configuration,
+  ) {}
+
+  /** Build any API in this module bound to this client (for APIs without a named getter). */
+  api<T>(factory: (configuration: Configuration, http: AxiosInstance) => T): T {
+    return factory(this.configuration, this.http);
+  }
+
+  /** {@link ActivateTokenApi} bound to this client. */
+  activateTokenApi(): ActivateTokenApi {
+    return new ActivateTokenApi(this.configuration, undefined, this.http);
+  }
+
+  /** {@link DeactivateTokenApi} bound to this client. */
+  deactivateTokenApi(): DeactivateTokenApi {
+    return new DeactivateTokenApi(this.configuration, undefined, this.http);
+  }
+
+  /** {@link EligibleTokenRequestorsApi} bound to this client. */
+  eligibleTokenRequestorsApi(): EligibleTokenRequestorsApi {
+    return new EligibleTokenRequestorsApi(this.configuration, undefined, this.http);
+  }
+
+  /** {@link GetTokensApi} bound to this client. */
+  getTokensApi(): GetTokensApi {
+    return new GetTokensApi(this.configuration, undefined, this.http);
+  }
+
+  /** {@link PushCardsApi} bound to this client. */
+  pushCardsApi(): PushCardsApi {
+    return new PushCardsApi(this.configuration, undefined, this.http);
+  }
+
+  /** {@link PushProvisionApi} bound to this client. */
+  pushProvisionApi(): PushProvisionApi {
+    return new PushProvisionApi(this.configuration, undefined, this.http);
+  }
+
+  /** {@link SuspendTokenApi} bound to this client. */
+  suspendTokenApi(): SuspendTokenApi {
+    return new SuspendTokenApi(this.configuration, undefined, this.http);
+  }
+
+  /** {@link UnsuspendTokenApi} bound to this client. */
+  unsuspendTokenApi(): UnsuspendTokenApi {
+    return new UnsuspendTokenApi(this.configuration, undefined, this.http);
+  }
+
+  static builder(): WalletClientBuilder {
+    return new WalletClientBuilder();
+  }
+}
+
+/** Builds a {@link WalletClient}: base URL + optional OAuth + transport customization. */
+export class WalletClientBuilder {
+
+  private _baseUrl?: string;
+  private _tokens?: TokenManager;
+  private _customizers: Array<(http: AxiosInstance) => void> = [];
+
+  /** The module's host, e.g. `https://api.<tenant>.../issuer`. */
+  baseUrl(baseUrl: string): this {
+    this._baseUrl = baseUrl;
+    return this;
+  }
+
+  /** Install OAuth: a fresh bearer token on every request + reactive 401 retry. */
+  oauth(tokens: TokenManager): this {
+    this._tokens = tokens;
+    return this;
+  }
+
+  /**
+   * Customize the underlying axios instance — set a timeout (`http.defaults.timeout = ...`), a proxy,
+   * default headers, extra interceptors, etc. Runs after OAuth is installed. Composable: multiple
+   * calls run in order.
+   */
+  configure(customizer: (http: AxiosInstance) => void): this {
+    this._customizers.push(customizer);
+    return this;
+  }
+
+  build(): WalletClient {
+    const http = this._tokens ? createOAuthAxios(this._tokens) : globalAxios.create();
+    for (const customizer of this._customizers) {
+      customizer(http);
+    }
+    const configuration = new Configuration({ basePath: this._baseUrl });
+    return new WalletClient(http, configuration);
+  }
+}

package/src/wallet/index.ts

@@ -16,3 +16,5 @@
 export * from "./api";
 export * from "./configuration";
 
+
+export * from './client';

package/test/exchange-rate-client.test.ts

@@ -0,0 +1,36 @@
+/**
+ * The generated fluent module client (exchangeRate.ExchangeRateClient) — a representative check that
+ * the client.mustache template wires the builder, base path, API getters and the configure() seam.
+ * Built without OAuth (no token manager) so the test needs no network.
+ */
+import { describe, expect, it } from 'vitest';
+import { exchangeRate } from '../src';
+
+describe('ExchangeRateClient (generated facade)', () => {
+  it('builder applies the base path and exposes the module APIs', () => {
+    const client = exchangeRate.ExchangeRateClient.builder()
+      .baseUrl('http://localhost/exchange-rate')
+      .build();
+
+    expect(client.configuration.basePath).toBe('http://localhost/exchange-rate');
+    expect(client.getECBExchangeRateApi()).toBeInstanceOf(exchangeRate.GetECBExchangeRateApi);
+    expect(client.getECBSupportedCurrenciesApi()).toBeInstanceOf(exchangeRate.GetECBSupportedCurrenciesApi);
+    expect(client.getFXExchangeRatesApi()).toBeInstanceOf(exchangeRate.GetFXExchangeRatesApi);
+
+    // Generic escape hatch for any API bound to the same client.
+    expect(client.api((c, http) => new exchangeRate.GetECBExchangeRateApi(c, undefined, http)))
+      .toBeInstanceOf(exchangeRate.GetECBExchangeRateApi);
+  });
+
+  it('configure() runs against the axios instance and composes (e.g. a timeout)', () => {
+    let calls = 0;
+    const client = exchangeRate.ExchangeRateClient.builder()
+      .baseUrl('http://x')
+      .configure(() => { calls += 1; })
+      .configure((http) => { http.defaults.timeout = 1234; })
+      .build();
+
+    expect(calls).toBe(1);
+    expect(client.http.defaults.timeout).toBe(1234);
+  });
+});