@enfuce/nextgen-sdk 0.0.5 → 0.0.7

package/src/exchange-rate/client.ts

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

package/src/exchange-rate/index.ts

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

package/src/index.ts

@@ -2,6 +2,7 @@
 /* One namespaced export per API. Usage: import { card } from '@enfuce/nextgen-sdk'; */
 
 export * as oauth from './oauth';
+export * as config from './config';
 
 export * as card from './card';
 export * as wallet from './wallet';

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

package/src/issuer-events/index.ts

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

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/config.test.ts

@@ -0,0 +1,33 @@
+/**
+ * Tests for the hand-written tenant/environment URL helper (src/config).
+ */
+import { describe, expect, it } from 'vitest';
+import { config } from '../src';
+
+const sandbox: config.TenantEnvironment = { tenant: 'swile', environment: 'ext-uat1-sandbox' };
+
+describe('config URL helpers', () => {
+  it('derives per-domain base URLs as api.<tenant>.<environment>.mycore.enfuce.com/<domain>', () => {
+    expect(config.apiBaseUrl(sandbox)).toBe('https://api.swile.ext-uat1-sandbox.mycore.enfuce.com');
+    expect(config.issuerBaseUrl(sandbox)).toBe('https://api.swile.ext-uat1-sandbox.mycore.enfuce.com/issuer');
+    expect(config.processorBaseUrl(sandbox)).toBe('https://api.swile.ext-uat1-sandbox.mycore.enfuce.com/processor');
+    expect(config.exchangeRateBaseUrl(sandbox)).toBe(
+      'https://api.swile.ext-uat1-sandbox.mycore.enfuce.com/exchange-rates-api',
+    );
+  });
+
+  it('derives the token URL from the auth host', () => {
+    expect(config.tokenUrl(sandbox)).toBe('https://auth.swile.ext-uat1-sandbox.mycore.enfuce.com/oauth2/token');
+  });
+
+  it('places a multi-segment environment verbatim', () => {
+    expect(config.issuerBaseUrl({ tenant: 'swile', environment: 'eu.live.prod' })).toBe(
+      'https://api.swile.eu.live.prod.mycore.enfuce.com/issuer',
+    );
+  });
+
+  it('rejects an empty tenant or environment', () => {
+    expect(() => config.issuerBaseUrl({ tenant: ' ', environment: 'env' })).toThrow();
+    expect(() => config.tokenUrl({ tenant: 'swile', environment: '' })).toThrow();
+  });
+});