@enfuce/nextgen-sdk 0.0.5 → 0.0.7

package/dist/wallet/client.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletClientBuilder = exports.WalletClient = void 0;
+/*
+ * 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.
+ */
+const axios_1 = require("axios");
+const oauth_1 = require("../oauth");
+const configuration_1 = require("./configuration");
+const api_1 = require("./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();
+ * ```
+ */
+class WalletClient {
+    constructor(
+    /** The axios instance — OAuth interceptors and any customizations already applied. */
+    http, 
+    /** The module configuration — base path applied. */
+    configuration) {
+        this.http = http;
+        this.configuration = configuration;
+    }
+    /** Build any API in this module bound to this client (for APIs without a named getter). */
+    api(factory) {
+        return factory(this.configuration, this.http);
+    }
+    /** {@link ActivateTokenApi} bound to this client. */
+    activateTokenApi() {
+        return new api_1.ActivateTokenApi(this.configuration, undefined, this.http);
+    }
+    /** {@link DeactivateTokenApi} bound to this client. */
+    deactivateTokenApi() {
+        return new api_1.DeactivateTokenApi(this.configuration, undefined, this.http);
+    }
+    /** {@link EligibleTokenRequestorsApi} bound to this client. */
+    eligibleTokenRequestorsApi() {
+        return new api_1.EligibleTokenRequestorsApi(this.configuration, undefined, this.http);
+    }
+    /** {@link GetTokensApi} bound to this client. */
+    getTokensApi() {
+        return new api_1.GetTokensApi(this.configuration, undefined, this.http);
+    }
+    /** {@link PushCardsApi} bound to this client. */
+    pushCardsApi() {
+        return new api_1.PushCardsApi(this.configuration, undefined, this.http);
+    }
+    /** {@link PushProvisionApi} bound to this client. */
+    pushProvisionApi() {
+        return new api_1.PushProvisionApi(this.configuration, undefined, this.http);
+    }
+    /** {@link SuspendTokenApi} bound to this client. */
+    suspendTokenApi() {
+        return new api_1.SuspendTokenApi(this.configuration, undefined, this.http);
+    }
+    /** {@link UnsuspendTokenApi} bound to this client. */
+    unsuspendTokenApi() {
+        return new api_1.UnsuspendTokenApi(this.configuration, undefined, this.http);
+    }
+    static builder() {
+        return new WalletClientBuilder();
+    }
+}
+exports.WalletClient = WalletClient;
+/** Builds a {@link WalletClient}: base URL + optional OAuth + transport customization. */
+class WalletClientBuilder {
+    constructor() {
+        this._customizers = [];
+    }
+    /** The module's host, e.g. `https://api.<tenant>.../issuer`. */
+    baseUrl(baseUrl) {
+        this._baseUrl = baseUrl;
+        return this;
+    }
+    /** Install OAuth: a fresh bearer token on every request + reactive 401 retry. */
+    oauth(tokens) {
+        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) {
+        this._customizers.push(customizer);
+        return this;
+    }
+    build() {
+        const http = this._tokens ? (0, oauth_1.createOAuthAxios)(this._tokens) : axios_1.default.create();
+        for (const customizer of this._customizers) {
+            customizer(http);
+        }
+        const configuration = new configuration_1.Configuration({ basePath: this._baseUrl });
+        return new WalletClient(http, configuration);
+    }
+}
+exports.WalletClientBuilder = WalletClientBuilder;

package/dist/wallet/index.d.ts

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

package/dist/wallet/index.js

@@ -29,3 +29,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./api"), exports);
 __exportStar(require("./configuration"), exports);
+__exportStar(require("./client"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enfuce/nextgen-sdk",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "Enfuce nextgen client SDK (TypeScript). One namespaced export per API.",
   "publishConfig": {
     "access": "public"

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

@@ -0,0 +1,57 @@
+/*
+ * Enfuce nextgen SDK — tenant/environment addressing helper.
+ *
+ * HAND-WRITTEN, NOT GENERATED. This module (src/config) is authored by hand and
+ * preserved across SDK regeneration (see scripts/generate.sh). Do not expect
+ * OpenAPI Generator to (re)produce it.
+ */
+
+/**
+ * Identifies a single Enfuce deployment by its `tenant` and `environment` — the two variable
+ * segments of every Enfuce host, e.g. `api.<tenant>.<environment>.mycore.enfuce.com`.
+ */
+export interface TenantEnvironment {
+    /** Tenant segment, e.g. `swile`, `shine`, `cad`. */
+    tenant: string;
+    /** Environment segment, e.g. `ext-uat1-sandbox`, `eu.live.prod`. */
+    environment: string;
+}
+
+const DOMAIN_SUFFIX = 'mycore.enfuce.com';
+
+function hostSuffix(te: TenantEnvironment): string {
+    const tenant = te?.tenant?.trim();
+    const environment = te?.environment?.trim();
+    if (!tenant) {
+        throw new Error('tenant must not be empty');
+    }
+    if (!environment) {
+        throw new Error('environment must not be empty');
+    }
+    return `${tenant}.${environment}.${DOMAIN_SUFFIX}`;
+}
+
+/** `https://api.<tenant>.<environment>.mycore.enfuce.com` — the API root, no path. */
+export function apiBaseUrl(te: TenantEnvironment): string {
+    return `https://api.${hostSuffix(te)}`;
+}
+
+/** `.../issuer` — issuer domain (cardholder, card, wallet, pin). */
+export function issuerBaseUrl(te: TenantEnvironment): string {
+    return `${apiBaseUrl(te)}/issuer`;
+}
+
+/** `.../processor` — processor domain (transactions, 3DS). */
+export function processorBaseUrl(te: TenantEnvironment): string {
+    return `${apiBaseUrl(te)}/processor`;
+}
+
+/** `.../exchange-rates-api` — exchange-rate domain. */
+export function exchangeRateBaseUrl(te: TenantEnvironment): string {
+    return `${apiBaseUrl(te)}/exchange-rates-api`;
+}
+
+/** `https://auth.<tenant>.<environment>.mycore.enfuce.com/oauth2/token` — OAuth2 token endpoint. */
+export function tokenUrl(te: TenantEnvironment): string {
+    return `https://auth.${hostSuffix(te)}/oauth2/token`;
+}

package/src/config/index.ts

@@ -0,0 +1,21 @@
+/*
+ * Enfuce nextgen SDK — tenant/environment addressing helper.
+ *
+ * HAND-WRITTEN, NOT GENERATED. This module (src/config) is authored by hand and
+ * preserved across SDK regeneration (see scripts/generate.sh). It is re-exported
+ * from the package barrel as `config`:
+ *
+ *   import { config, cardholder, oauth } from '@enfuce/nextgen-sdk';
+ *
+ *   const te = { tenant: 'swile', environment: 'ext-uat1-sandbox' };
+ *   const conf = new cardholder.Configuration({ basePath: config.issuerBaseUrl(te) });
+ *   const tokens = oauth.clientCredentials({ tokenUrl: config.tokenUrl(te), clientId, clientSecret });
+ */
+export {
+    TenantEnvironment,
+    apiBaseUrl,
+    issuerBaseUrl,
+    processorBaseUrl,
+    exchangeRateBaseUrl,
+    tokenUrl,
+} from './enfuceUrls';