@enfuce/nextgen-sdk 0.0.4 → 0.0.6

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

package/src/authorisation-control/index.ts

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

package/src/card/client.ts

@@ -0,0 +1,116 @@
+/*
+ * 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 {
+  CreateCardApi,
+  CreatePINControlAccessTokenApi,
+  GetCardApi,
+  GetCardPaymentInfoApi,
+  GetPlasticManufacturingHistoryApi,
+  UpdateCardApi,
+} from './api';
+
+/**
+ * Fluent entry point for this module. Build one with {@link CardClient.builder}:
+ *
+ * ```ts
+ * const client = CardClient.builder()
+ *   .baseUrl('https://api.example.com/...')
+ *   .oauth(tokens)
+ *   .build();
+ * ```
+ */
+export class CardClient {
+
+  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 CreateCardApi} bound to this client. */
+  createCardApi(): CreateCardApi {
+    return new CreateCardApi(this.configuration, undefined, this.http);
+  }
+
+  /** {@link CreatePINControlAccessTokenApi} bound to this client. */
+  createPINControlAccessTokenApi(): CreatePINControlAccessTokenApi {
+    return new CreatePINControlAccessTokenApi(this.configuration, undefined, this.http);
+  }
+
+  /** {@link GetCardApi} bound to this client. */
+  getCardApi(): GetCardApi {
+    return new GetCardApi(this.configuration, undefined, this.http);
+  }
+
+  /** {@link GetCardPaymentInfoApi} bound to this client. */
+  getCardPaymentInfoApi(): GetCardPaymentInfoApi {
+    return new GetCardPaymentInfoApi(this.configuration, undefined, this.http);
+  }
+
+  /** {@link GetPlasticManufacturingHistoryApi} bound to this client. */
+  getPlasticManufacturingHistoryApi(): GetPlasticManufacturingHistoryApi {
+    return new GetPlasticManufacturingHistoryApi(this.configuration, undefined, this.http);
+  }
+
+  /** {@link UpdateCardApi} bound to this client. */
+  updateCardApi(): UpdateCardApi {
+    return new UpdateCardApi(this.configuration, undefined, this.http);
+  }
+
+  static builder(): CardClientBuilder {
+    return new CardClientBuilder();
+  }
+}
+
+/** Builds a {@link CardClient}: base URL + optional OAuth + transport customization. */
+export class CardClientBuilder {
+
+  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(): CardClient {
+    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 CardClient(http, configuration);
+  }
+}

package/src/card/index.ts

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

package/src/cardholder/client.ts

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

package/src/cardholder/index.ts

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

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

package/src/cards/index.ts

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

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/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/oauth/axios.ts

@@ -19,19 +19,31 @@ function stripBearer(header: string): string {
 }
 
 /**
- * Returns an {@link AxiosInstance} with a response interceptor that, on a `401`,
- * forces a token refresh and retries the request exactly once with the new bearer
- * token. Pass it as the third argument of a generated API class:
+ * Returns an {@link AxiosInstance} with OAuth bearer-token handling built in:
+ *
+ * - **Proactive:** a request interceptor attaches a fresh bearer token (from the
+ *   {@link TokenManager}) to *every* request. This authenticates API modules whose spec declares no
+ *   security scheme (e.g. exchange-rate), so no `accessToken` on the `Configuration` is required.
+ * - **Reactive:** a response interceptor, on a `401`, forces a token refresh and retries the request
+ *   exactly once with the new bearer token.
+ *
+ * Pass it as the third argument of a generated API class:
  *
  * ```ts
  * const http = createOAuthAxios(tokens);
- * const config = new card.Configuration({ accessToken: () => tokens.getToken() });
+ * const config = new card.Configuration({ basePath });
  * const api = new card.CardApi(config, undefined, http);
  * ```
  */
 export function createOAuthAxios(manager: TokenManager, instance?: AxiosInstance): AxiosInstance {
     const http = instance ?? axios.create();
 
+    // Proactive: attach a fresh bearer token to every outgoing request.
+    http.interceptors.request.use(async (config) => {
+        config.headers.set('Authorization', BEARER_PREFIX + (await manager.getToken()));
+        return config;
+    });
+
     http.interceptors.response.use(undefined, async (error: AxiosError) => {
         const response = error.response;
         const original = error.config as RetriableConfig | undefined;

package/src/oauth/index.ts

@@ -13,10 +13,13 @@
  *     clientSecret: 'my-secret',
  *     scopes: ['cards:read'],
  *   });
- *   const http = oauth.createOAuthAxios(tokens);
- *   const config = new card.Configuration({ accessToken: () => tokens.getToken() });
+ *   const http = oauth.createOAuthAxios(tokens); // attaches the token + retries on 401
+ *   const config = new card.Configuration({ basePath: 'https://api.example.com' });
  *   const api = new card.CardApi(config, undefined, http);
  *
+ * The same `http` instance authenticates every API module, including ones whose spec declares no
+ * security scheme (e.g. exchange-rate) — no `accessToken` on the `Configuration` is required.
+ *
  * Server-side only — a client secret must never ship to a browser.
  */
 export { AccessToken, TokenFetcher, TokenManager } from './tokenManager';