@enfuce/nextgen-sdk 0.0.8 → 0.0.10

package/src/threeds-oob/client.ts

@@ -1,86 +0,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.
- */
-import globalAxios, { type AxiosInstance } from 'axios';
-import { createOAuthAxios, type OAuthClientCredentialsManager } 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?: OAuthClientCredentialsManager;
-  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: OAuthClientCredentialsManager): 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/test/authorisation-control.test.ts

@@ -1,71 +0,0 @@
-/**
- * Wire-level tests for the authorisation-control API client, asserting the request
- * against an exact JSON payload. A capturing axios adapter intercepts the request
- * instead of hitting the network, so this exercises the real generated client (URL
- * building, Content-Type, body serialization) without a live server or a mock library.
- */
-import axios, { type InternalAxiosRequestConfig } from 'axios';
-import { describe, expect, it } from 'vitest';
-import { AuthorisationRequestAPIApi, CardApplicationSelectionEnum } from '../src/authorisation-control';
-
-function capturingClient() {
-  const captured: { config?: InternalAxiosRequestConfig } = {};
-  const instance = axios.create({
-    adapter: async (config) => {
-      captured.config = config;
-      return { data: undefined, status: 200, statusText: 'OK', headers: {}, config };
-    },
-  });
-  return { captured, instance };
-}
-
-describe('AuthorisationRequestAPIApi.authPost', () => {
-  it('POSTs the exact authorisation-request JSON to the auth endpoint', async () => {
-    const { captured, instance } = capturingClient();
-    const api = new AuthorisationRequestAPIApi(undefined, 'http://localhost', instance);
-
-    await api.authPost({
-      card: {
-        id: '11111111-1111-1111-1111-111111111111',
-        applicationSelection: CardApplicationSelectionEnum.Debit,
-      },
-      merchant: {
-        id: 'MERCHANT-0001',
-        country: 'FIN',
-      },
-      transaction: {
-        transactionAmount: { amount: 1000, currency: 'EUR' },
-      },
-    });
-
-    expect(captured.config?.method?.toUpperCase()).toBe('POST');
-    expect(captured.config?.url).toBe('http://localhost/auth');
-    expect(captured.config?.headers?.['Content-Type']).toBe('application/json');
-    expect(captured.config?.data).toBe(
-      '{"card":{"id":"11111111-1111-1111-1111-111111111111","applicationSelection":"DEBIT"},"merchant":{"id":"MERCHANT-0001","country":"FIN"},"transaction":{"transactionAmount":{"amount":1000,"currency":"EUR"}}}',
-    );
-  });
-
-  it('serializes the CREDIT application selection to the exact JSON body', async () => {
-    const { captured, instance } = capturingClient();
-    const api = new AuthorisationRequestAPIApi(undefined, 'http://localhost', instance);
-
-    await api.authPost({
-      card: {
-        id: '22222222-2222-2222-2222-222222222222',
-        applicationSelection: CardApplicationSelectionEnum.Credit,
-      },
-      merchant: {
-        id: 'MERCHANT-0002',
-        country: 'SWE',
-      },
-      transaction: {
-        transactionAmount: { amount: 2500, currency: 'EUR' },
-      },
-    });
-
-    expect(captured.config?.data).toBe(
-      '{"card":{"id":"22222222-2222-2222-2222-222222222222","applicationSelection":"CREDIT"},"merchant":{"id":"MERCHANT-0002","country":"SWE"},"transaction":{"transactionAmount":{"amount":2500,"currency":"EUR"}}}',
-    );
-  });
-});

package/test/issuer-events.test.ts

@@ -1,55 +0,0 @@
-/**
- * Wire-level tests for the issuer-events API client, asserting the request against
- * an exact JSON payload. A capturing axios adapter intercepts the request instead
- * of hitting the network, so this exercises the real generated client (URL building,
- * Content-Type, body serialization) without a live server or a mock library.
- */
-import axios, { type InternalAxiosRequestConfig } from 'axios';
-import { describe, expect, it } from 'vitest';
-import { IssuerEventWebhooksApi, CardRole } from '../src/issuer-events';
-
-function capturingClient() {
-  const captured: { config?: InternalAxiosRequestConfig } = {};
-  const instance = axios.create({
-    adapter: async (config) => {
-      captured.config = config;
-      return { data: undefined, status: 200, statusText: 'OK', headers: {}, config };
-    },
-  });
-  return { captured, instance };
-}
-
-describe('IssuerEventWebhooksApi.cardEvent', () => {
-  it('POSTs the exact card-event JSON to the card webhook endpoint', async () => {
-    const { captured, instance } = capturingClient();
-    const api = new IssuerEventWebhooksApi(undefined, 'http://localhost', instance);
-
-    await api.cardEvent({
-      id: '11111111-1111-1111-1111-111111111111',
-      programId: '22222222-2222-2222-2222-222222222222',
-      role: CardRole.MainCard,
-    });
-
-    expect(captured.config?.method?.toUpperCase()).toBe('POST');
-    expect(captured.config?.url).toBe('http://localhost/card');
-    expect(captured.config?.headers?.['Content-Type']).toBe('application/json');
-    expect(captured.config?.data).toBe(
-      '{"id":"11111111-1111-1111-1111-111111111111","programId":"22222222-2222-2222-2222-222222222222","role":"MAIN_CARD"}',
-    );
-  });
-
-  it('serializes the CARD_APPLICATION role to the exact JSON body', async () => {
-    const { captured, instance } = capturingClient();
-    const api = new IssuerEventWebhooksApi(undefined, 'http://localhost', instance);
-
-    await api.cardEvent({
-      id: '33333333-3333-3333-3333-333333333333',
-      programId: '44444444-4444-4444-4444-444444444444',
-      role: CardRole.CardApplication,
-    });
-
-    expect(captured.config?.data).toBe(
-      '{"id":"33333333-3333-3333-3333-333333333333","programId":"44444444-4444-4444-4444-444444444444","role":"CARD_APPLICATION"}',
-    );
-  });
-});

package/test/threeds-oob.test.ts

@@ -1,90 +0,0 @@
-/**
- * Wire-level tests for the threeds-oob API client, asserting the request against an
- * exact JSON payload. A capturing axios adapter intercepts the request instead of
- * hitting the network, so this exercises the real generated client (URL building,
- * Content-Type, body serialization) without a live server or a mock library.
- */
-import axios, { type InternalAxiosRequestConfig } from 'axios';
-import { describe, expect, it } from 'vitest';
-import {
-  OOBAuthenticationChallengeWebhookNotificationApi,
-  ThreeDsTransactionCategoryEnum,
-  ThreeDsTransactionDeviceChannelEnum,
-} from '../src/threeds-oob';
-
-function capturingClient() {
-  const captured: { config?: InternalAxiosRequestConfig } = {};
-  const instance = axios.create({
-    adapter: async (config) => {
-      captured.config = config;
-      return { data: undefined, status: 200, statusText: 'OK', headers: {}, config };
-    },
-  });
-  return { captured, instance };
-}
-
-describe('OOBAuthenticationChallengeWebhookNotificationApi.initiateAuthenticationChallenge', () => {
-  it('POSTs the exact challenge JSON to the OOB challenge initiate endpoint', async () => {
-    const { captured, instance } = capturingClient();
-    const api = new OOBAuthenticationChallengeWebhookNotificationApi(undefined, 'http://localhost', instance);
-
-    await api.initiateAuthenticationChallenge({
-      authenticationId: '11111111-1111-1111-1111-111111111111',
-      challengeId: '22222222-2222-2222-2222-222222222222',
-      cardholder: {
-        id: '33333333-3333-3333-3333-333333333333',
-        customerNumber: 'CUST-0001',
-      },
-      card: {
-        id: '44444444-4444-4444-4444-444444444444',
-        maskedPan: '512345******0000',
-      },
-      threeDsTransaction: {
-        transactionAmount: { amount: 1000, currency: 'EUR' },
-        category: ThreeDsTransactionCategoryEnum.Payment,
-        deviceChannel: ThreeDsTransactionDeviceChannelEnum.App,
-        processedDateTime: '2024-05-31T06:55:17Z',
-      },
-      merchant: {
-        name: 'Acme Shop',
-        country: 'FIN',
-        url: 'https://merchant.example',
-      },
-    });
-
-    expect(captured.config?.method?.toUpperCase()).toBe('POST');
-    expect(captured.config?.url).toBe('http://localhost/v1/3ds/oob/challenge/initiate');
-    expect(captured.config?.headers?.['Content-Type']).toBe('application/json');
-    expect(captured.config?.data).toBe(
-      '{"authenticationId":"11111111-1111-1111-1111-111111111111","challengeId":"22222222-2222-2222-2222-222222222222","cardholder":{"id":"33333333-3333-3333-3333-333333333333","customerNumber":"CUST-0001"},"card":{"id":"44444444-4444-4444-4444-444444444444","maskedPan":"512345******0000"},"threeDsTransaction":{"transactionAmount":{"amount":1000,"currency":"EUR"},"category":"PAYMENT","deviceChannel":"APP","processedDateTime":"2024-05-31T06:55:17Z"},"merchant":{"name":"Acme Shop","country":"FIN","url":"https://merchant.example"}}',
-    );
-  });
-
-  it('serializes the NON_PAYMENT category to the exact JSON body', async () => {
-    const { captured, instance } = capturingClient();
-    const api = new OOBAuthenticationChallengeWebhookNotificationApi(undefined, 'http://localhost', instance);
-
-    await api.initiateAuthenticationChallenge({
-      authenticationId: '55555555-5555-5555-5555-555555555555',
-      challengeId: '66666666-6666-6666-6666-666666666666',
-      cardholder: {
-        id: '77777777-7777-7777-7777-777777777777',
-        customerNumber: 'CUST-0002',
-      },
-      card: {
-        id: '88888888-8888-8888-8888-888888888888',
-        maskedPan: '512345******1111',
-      },
-      threeDsTransaction: {
-        transactionAmount: { amount: 2500, currency: 'EUR' },
-        category: ThreeDsTransactionCategoryEnum.NonPayment,
-        deviceChannel: ThreeDsTransactionDeviceChannelEnum.Browser,
-        processedDateTime: '2024-06-01T10:00:00Z',
-      },
-    });
-
-    expect(captured.config?.data).toBe(
-      '{"authenticationId":"55555555-5555-5555-5555-555555555555","challengeId":"66666666-6666-6666-6666-666666666666","cardholder":{"id":"77777777-7777-7777-7777-777777777777","customerNumber":"CUST-0002"},"card":{"id":"88888888-8888-8888-8888-888888888888","maskedPan":"512345******1111"},"threeDsTransaction":{"transactionAmount":{"amount":2500,"currency":"EUR"},"category":"NON_PAYMENT","deviceChannel":"BROWSER","processedDateTime":"2024-06-01T10:00:00Z"}}',
-    );
-  });
-});