@enfuce/nextgen-sdk 0.0.6 → 0.0.7

package/dist/config/enfuceUrls.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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;
+}
+/** `https://api.<tenant>.<environment>.mycore.enfuce.com` — the API root, no path. */
+export declare function apiBaseUrl(te: TenantEnvironment): string;
+/** `.../issuer` — issuer domain (cardholder, card, wallet, pin). */
+export declare function issuerBaseUrl(te: TenantEnvironment): string;
+/** `.../processor` — processor domain (transactions, 3DS). */
+export declare function processorBaseUrl(te: TenantEnvironment): string;
+/** `.../exchange-rates-api` — exchange-rate domain. */
+export declare function exchangeRateBaseUrl(te: TenantEnvironment): string;
+/** `https://auth.<tenant>.<environment>.mycore.enfuce.com/oauth2/token` — OAuth2 token endpoint. */
+export declare function tokenUrl(te: TenantEnvironment): string;

package/dist/config/enfuceUrls.js

@@ -0,0 +1,47 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiBaseUrl = apiBaseUrl;
+exports.issuerBaseUrl = issuerBaseUrl;
+exports.processorBaseUrl = processorBaseUrl;
+exports.exchangeRateBaseUrl = exchangeRateBaseUrl;
+exports.tokenUrl = tokenUrl;
+const DOMAIN_SUFFIX = 'mycore.enfuce.com';
+function hostSuffix(te) {
+    var _a, _b;
+    const tenant = (_a = te === null || te === void 0 ? void 0 : te.tenant) === null || _a === void 0 ? void 0 : _a.trim();
+    const environment = (_b = te === null || te === void 0 ? void 0 : te.environment) === null || _b === void 0 ? void 0 : _b.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. */
+function apiBaseUrl(te) {
+    return `https://api.${hostSuffix(te)}`;
+}
+/** `.../issuer` — issuer domain (cardholder, card, wallet, pin). */
+function issuerBaseUrl(te) {
+    return `${apiBaseUrl(te)}/issuer`;
+}
+/** `.../processor` — processor domain (transactions, 3DS). */
+function processorBaseUrl(te) {
+    return `${apiBaseUrl(te)}/processor`;
+}
+/** `.../exchange-rates-api` — exchange-rate domain. */
+function exchangeRateBaseUrl(te) {
+    return `${apiBaseUrl(te)}/exchange-rates-api`;
+}
+/** `https://auth.<tenant>.<environment>.mycore.enfuce.com/oauth2/token` — OAuth2 token endpoint. */
+function tokenUrl(te) {
+    return `https://auth.${hostSuffix(te)}/oauth2/token`;
+}

package/dist/config/index.d.ts

@@ -0,0 +1 @@
+export { TenantEnvironment, apiBaseUrl, issuerBaseUrl, processorBaseUrl, exchangeRateBaseUrl, tokenUrl, } from './enfuceUrls';

package/dist/config/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenUrl = exports.exchangeRateBaseUrl = exports.processorBaseUrl = exports.issuerBaseUrl = exports.apiBaseUrl = void 0;
+/*
+ * 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 });
+ */
+var enfuceUrls_1 = require("./enfuceUrls");
+Object.defineProperty(exports, "apiBaseUrl", { enumerable: true, get: function () { return enfuceUrls_1.apiBaseUrl; } });
+Object.defineProperty(exports, "issuerBaseUrl", { enumerable: true, get: function () { return enfuceUrls_1.issuerBaseUrl; } });
+Object.defineProperty(exports, "processorBaseUrl", { enumerable: true, get: function () { return enfuceUrls_1.processorBaseUrl; } });
+Object.defineProperty(exports, "exchangeRateBaseUrl", { enumerable: true, get: function () { return enfuceUrls_1.exchangeRateBaseUrl; } });
+Object.defineProperty(exports, "tokenUrl", { enumerable: true, get: function () { return enfuceUrls_1.tokenUrl; } });

package/dist/esm/config/enfuceUrls.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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;
+}
+/** `https://api.<tenant>.<environment>.mycore.enfuce.com` — the API root, no path. */
+export declare function apiBaseUrl(te: TenantEnvironment): string;
+/** `.../issuer` — issuer domain (cardholder, card, wallet, pin). */
+export declare function issuerBaseUrl(te: TenantEnvironment): string;
+/** `.../processor` — processor domain (transactions, 3DS). */
+export declare function processorBaseUrl(te: TenantEnvironment): string;
+/** `.../exchange-rates-api` — exchange-rate domain. */
+export declare function exchangeRateBaseUrl(te: TenantEnvironment): string;
+/** `https://auth.<tenant>.<environment>.mycore.enfuce.com/oauth2/token` — OAuth2 token endpoint. */
+export declare function tokenUrl(te: TenantEnvironment): string;

package/dist/esm/config/enfuceUrls.js

@@ -0,0 +1,40 @@
+/*
+ * 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.
+ */
+const DOMAIN_SUFFIX = 'mycore.enfuce.com';
+function hostSuffix(te) {
+    var _a, _b;
+    const tenant = (_a = te === null || te === void 0 ? void 0 : te.tenant) === null || _a === void 0 ? void 0 : _a.trim();
+    const environment = (_b = te === null || te === void 0 ? void 0 : te.environment) === null || _b === void 0 ? void 0 : _b.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) {
+    return `https://api.${hostSuffix(te)}`;
+}
+/** `.../issuer` — issuer domain (cardholder, card, wallet, pin). */
+export function issuerBaseUrl(te) {
+    return `${apiBaseUrl(te)}/issuer`;
+}
+/** `.../processor` — processor domain (transactions, 3DS). */
+export function processorBaseUrl(te) {
+    return `${apiBaseUrl(te)}/processor`;
+}
+/** `.../exchange-rates-api` — exchange-rate domain. */
+export function exchangeRateBaseUrl(te) {
+    return `${apiBaseUrl(te)}/exchange-rates-api`;
+}
+/** `https://auth.<tenant>.<environment>.mycore.enfuce.com/oauth2/token` — OAuth2 token endpoint. */
+export function tokenUrl(te) {
+    return `https://auth.${hostSuffix(te)}/oauth2/token`;
+}

package/dist/esm/config/index.d.ts

@@ -0,0 +1 @@
+export { TenantEnvironment, apiBaseUrl, issuerBaseUrl, processorBaseUrl, exchangeRateBaseUrl, tokenUrl, } from './enfuceUrls';

package/dist/esm/config/index.js

@@ -0,0 +1,14 @@
+/*
+ * 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 { apiBaseUrl, issuerBaseUrl, processorBaseUrl, exchangeRateBaseUrl, tokenUrl, } from './enfuceUrls';

package/dist/esm/index.d.ts

@@ -1,4 +1,5 @@
 export * as oauth from './oauth';
+export * as config from './config';
 export * as card from './card';
 export * as wallet from './wallet';
 export * as cardholder from './cardholder';

package/dist/esm/index.js

@@ -1,6 +1,7 @@
 /* AUTO-GENERATED by scripts/generate.sh - do not edit. */
 /* 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';
 export * as cardholder from './cardholder';

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * as oauth from './oauth';
+export * as config from './config';
 export * as card from './card';
 export * as wallet from './wallet';
 export * as cardholder from './cardholder';

package/dist/index.js

@@ -2,8 +2,9 @@
 /* AUTO-GENERATED by scripts/generate.sh - do not edit. */
 /* One namespaced export per API. Usage: import { card } from '@enfuce/nextgen-sdk'; */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.exchangeRate = exports.transactionEvent = exports.clearingFileCopy = exports.threedsOob = exports.threeds = exports.cards = exports.authorisationControl = exports.issuerEvents = exports.pin = exports.cardholder = exports.wallet = exports.card = exports.oauth = void 0;
+exports.exchangeRate = exports.transactionEvent = exports.clearingFileCopy = exports.threedsOob = exports.threeds = exports.cards = exports.authorisationControl = exports.issuerEvents = exports.pin = exports.cardholder = exports.wallet = exports.card = exports.config = exports.oauth = void 0;
 exports.oauth = require("./oauth");
+exports.config = require("./config");
 exports.card = require("./card");
 exports.wallet = require("./wallet");
 exports.cardholder = require("./cardholder");

package/package.json

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

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';

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