@enfuce/nextgen-sdk 0.0.4 → 0.0.6

package/src/pin/client.ts

@@ -0,0 +1,92 @@
+/*
+ * 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 {
+  PINOperationsUsingPKIApi,
+  PINOperationsWithPreSharedKeyApi,
+} from './api';
+
+/**
+ * Fluent entry point for this module. Build one with {@link PinClient.builder}:
+ *
+ * ```ts
+ * const client = PinClient.builder()
+ *   .baseUrl('https://api.example.com/...')
+ *   .oauth(tokens)
+ *   .build();
+ * ```
+ */
+export class PinClient {
+
+  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 PINOperationsUsingPKIApi} bound to this client. */
+  pINOperationsUsingPKIApi(): PINOperationsUsingPKIApi {
+    return new PINOperationsUsingPKIApi(this.configuration, undefined, this.http);
+  }
+
+  /** {@link PINOperationsWithPreSharedKeyApi} bound to this client. */
+  pINOperationsWithPreSharedKeyApi(): PINOperationsWithPreSharedKeyApi {
+    return new PINOperationsWithPreSharedKeyApi(this.configuration, undefined, this.http);
+  }
+
+  static builder(): PinClientBuilder {
+    return new PinClientBuilder();
+  }
+}
+
+/** Builds a {@link PinClient}: base URL + optional OAuth + transport customization. */
+export class PinClientBuilder {
+
+  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(): PinClient {
+    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 PinClient(http, configuration);
+  }
+}

package/src/pin/index.ts

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

package/src/threeds/client.ts

@@ -0,0 +1,86 @@
+/*
+ * 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 {
+  ThreeDSApi,
+} from './api';
+
+/**
+ * Fluent entry point for this module. Build one with {@link ThreedsClient.builder}:
+ *
+ * ```ts
+ * const client = ThreedsClient.builder()
+ *   .baseUrl('https://api.example.com/...')
+ *   .oauth(tokens)
+ *   .build();
+ * ```
+ */
+export class ThreedsClient {
+
+  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 ThreeDSApi} bound to this client. */
+  threeDSApi(): ThreeDSApi {
+    return new ThreeDSApi(this.configuration, undefined, this.http);
+  }
+
+  static builder(): ThreedsClientBuilder {
+    return new ThreedsClientBuilder();
+  }
+}
+
+/** Builds a {@link ThreedsClient}: base URL + optional OAuth + transport customization. */
+export class ThreedsClientBuilder {
+
+  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(): ThreedsClient {
+    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 ThreedsClient(http, configuration);
+  }
+}

package/src/threeds/index.ts

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

package/src/threeds-oob/client.ts

@@ -0,0 +1,86 @@
+/*
+ * 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 {
+  OOBAuthenticationChallengeWebhookNotificationApi,
+} from './api';
+
+/**
+ * Fluent entry point for this module. Build one with {@link ThreedsOobClient.builder}:
+ *
+ * ```ts
+ * const client = ThreedsOobClient.builder()
+ *   .baseUrl('https://api.example.com/...')
+ *   .oauth(tokens)
+ *   .build();
+ * ```
+ */
+export class ThreedsOobClient {
+
+  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 OOBAuthenticationChallengeWebhookNotificationApi} bound to this client. */
+  oOBAuthenticationChallengeWebhookNotificationApi(): OOBAuthenticationChallengeWebhookNotificationApi {
+    return new OOBAuthenticationChallengeWebhookNotificationApi(this.configuration, undefined, this.http);
+  }
+
+  static builder(): ThreedsOobClientBuilder {
+    return new ThreedsOobClientBuilder();
+  }
+}
+
+/** Builds a {@link ThreedsOobClient}: base URL + optional OAuth + transport customization. */
+export class ThreedsOobClientBuilder {
+
+  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(): ThreedsOobClient {
+    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 ThreedsOobClient(http, configuration);
+  }
+}

package/src/threeds-oob/index.ts

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

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);
+  });
+});

package/test/oauth.test.ts

@@ -139,6 +139,25 @@ describe('clientCredentialsFetcher', () => {
 });
 
 describe('createOAuthAxios', () => {
+  it('proactively attaches a bearer token to a request that has no Authorization header', async () => {
+    const { fetch, calls } = countingFetcher();
+    const mgr = new TokenManager(fetch, 60, makeClock().now);
+
+    const seenAuth: (string | undefined)[] = [];
+    const adapter: AxiosAdapter = async (config) => {
+      seenAuth.push(config.headers?.Authorization as string | undefined);
+      return { data: { ok: true }, status: 200, statusText: 'OK', headers: {}, config };
+    };
+    const http = createOAuthAxios(mgr, axios.create({ adapter }));
+
+    // No Authorization header supplied — the SDK must attach one (as for a no-security-scheme spec).
+    const response = await http.request({ url: 'http://localhost/v1/ecb/currencies', method: 'get' });
+
+    expect(response.status).toBe(200);
+    expect(seenAuth).toEqual(['Bearer token-1']);
+    expect(calls.n).toBe(1);
+  });
+
   it('retries the request with a refreshed token when the first call rejects with 401', async () => {
     const { fetch } = countingFetcher();
     const mgr = new TokenManager(fetch, 60, makeClock().now);