@enfuce/nextgen-sdk 0.0.1

package/src/issuer-events/base.ts

@@ -0,0 +1,86 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Issuer Events API
+ * All date-time fields adhere to the ISO 8601 standard unless specified otherwise. For example: 2024-05-31T06:55:17Z 
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+import type { Configuration } from './configuration';
+// Some imports not used depending on template conditions
+// @ts-ignore
+import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
+import globalAxios from 'axios';
+
+export const BASE_PATH = "http://localhost".replace(/\/+$/, "");
+
+/**
+ *
+ * @export
+ */
+export const COLLECTION_FORMATS = {
+    csv: ",",
+    ssv: " ",
+    tsv: "\t",
+    pipes: "|",
+};
+
+/**
+ *
+ * @export
+ * @interface RequestArgs
+ */
+export interface RequestArgs {
+    url: string;
+    options: RawAxiosRequestConfig;
+}
+
+/**
+ *
+ * @export
+ * @class BaseAPI
+ */
+export class BaseAPI {
+    protected configuration: Configuration | undefined;
+
+    constructor(configuration?: Configuration, protected basePath: string = BASE_PATH, protected axios: AxiosInstance = globalAxios) {
+        if (configuration) {
+            this.configuration = configuration;
+            this.basePath = configuration.basePath ?? basePath;
+        }
+    }
+};
+
+/**
+ *
+ * @export
+ * @class RequiredError
+ * @extends {Error}
+ */
+export class RequiredError extends Error {
+    constructor(public field: string, msg?: string) {
+        super(msg);
+        this.name = "RequiredError"
+    }
+}
+
+interface ServerMap {
+    [key: string]: {
+        url: string,
+        description: string,
+    }[];
+}
+
+/**
+ *
+ * @export
+ */
+export const operationServerMap: ServerMap = {
+}

package/src/issuer-events/common.ts

@@ -0,0 +1,150 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Issuer Events API
+ * All date-time fields adhere to the ISO 8601 standard unless specified otherwise. For example: 2024-05-31T06:55:17Z 
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+import type { Configuration } from "./configuration";
+import type { RequestArgs } from "./base";
+import type { AxiosInstance, AxiosResponse } from 'axios';
+import { RequiredError } from "./base";
+
+/**
+ *
+ * @export
+ */
+export const DUMMY_BASE_URL = 'https://example.com'
+
+/**
+ *
+ * @throws {RequiredError}
+ * @export
+ */
+export const assertParamExists = function (functionName: string, paramName: string, paramValue: unknown) {
+    if (paramValue === null || paramValue === undefined) {
+        throw new RequiredError(paramName, `Required parameter ${paramName} was null or undefined when calling ${functionName}.`);
+    }
+}
+
+/**
+ *
+ * @export
+ */
+export const setApiKeyToObject = async function (object: any, keyParamName: string, configuration?: Configuration) {
+    if (configuration && configuration.apiKey) {
+        const localVarApiKeyValue = typeof configuration.apiKey === 'function'
+            ? await configuration.apiKey(keyParamName)
+            : await configuration.apiKey;
+        object[keyParamName] = localVarApiKeyValue;
+    }
+}
+
+/**
+ *
+ * @export
+ */
+export const setBasicAuthToObject = function (object: any, configuration?: Configuration) {
+    if (configuration && (configuration.username || configuration.password)) {
+        object["auth"] = { username: configuration.username, password: configuration.password };
+    }
+}
+
+/**
+ *
+ * @export
+ */
+export const setBearerAuthToObject = async function (object: any, configuration?: Configuration) {
+    if (configuration && configuration.accessToken) {
+        const accessToken = typeof configuration.accessToken === 'function'
+            ? await configuration.accessToken()
+            : await configuration.accessToken;
+        object["Authorization"] = "Bearer " + accessToken;
+    }
+}
+
+/**
+ *
+ * @export
+ */
+export const setOAuthToObject = async function (object: any, name: string, scopes: string[], configuration?: Configuration) {
+    if (configuration && configuration.accessToken) {
+        const localVarAccessTokenValue = typeof configuration.accessToken === 'function'
+            ? await configuration.accessToken(name, scopes)
+            : await configuration.accessToken;
+        object["Authorization"] = "Bearer " + localVarAccessTokenValue;
+    }
+}
+
+function setFlattenedQueryParams(urlSearchParams: URLSearchParams, parameter: any, key: string = ""): void {
+    if (parameter == null) return;
+    if (typeof parameter === "object") {
+        if (Array.isArray(parameter)) {
+            (parameter as any[]).forEach(item => setFlattenedQueryParams(urlSearchParams, item, key));
+        }
+        else {
+            Object.keys(parameter).forEach(currentKey =>
+                setFlattenedQueryParams(urlSearchParams, parameter[currentKey], `${key}${key !== '' ? '.' : ''}${currentKey}`)
+            );
+        }
+    }
+    else {
+        if (urlSearchParams.has(key)) {
+            urlSearchParams.append(key, parameter);
+        }
+        else {
+            urlSearchParams.set(key, parameter);
+        }
+    }
+}
+
+/**
+ *
+ * @export
+ */
+export const setSearchParams = function (url: URL, ...objects: any[]) {
+    const searchParams = new URLSearchParams(url.search);
+    setFlattenedQueryParams(searchParams, objects);
+    url.search = searchParams.toString();
+}
+
+/**
+ *
+ * @export
+ */
+export const serializeDataIfNeeded = function (value: any, requestOptions: any, configuration?: Configuration) {
+    const nonString = typeof value !== 'string';
+    const needsSerialization = nonString && configuration && configuration.isJsonMime
+        ? configuration.isJsonMime(requestOptions.headers['Content-Type'])
+        : nonString;
+    return needsSerialization
+        ? JSON.stringify(value !== undefined ? value : {})
+        : (value || "");
+}
+
+/**
+ *
+ * @export
+ */
+export const toPathString = function (url: URL) {
+    return url.pathname + url.search + url.hash
+}
+
+/**
+ *
+ * @export
+ */
+export const createRequestFunction = function (axiosArgs: RequestArgs, globalAxios: AxiosInstance, BASE_PATH: string, configuration?: Configuration) {
+    return <T = unknown, R = AxiosResponse<T>>(axios: AxiosInstance = globalAxios, basePath: string = BASE_PATH) => {
+        const axiosRequestArgs = {...axiosArgs.options, url: (axios.defaults.baseURL ? '' : configuration?.basePath ?? basePath) + axiosArgs.url};
+        return axios.request<T, R>(axiosRequestArgs);
+    };
+}

package/src/issuer-events/configuration.ts

@@ -0,0 +1,115 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Issuer Events API
+ * All date-time fields adhere to the ISO 8601 standard unless specified otherwise. For example: 2024-05-31T06:55:17Z 
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+export interface ConfigurationParameters {
+    apiKey?: string | Promise<string> | ((name: string) => string) | ((name: string) => Promise<string>);
+    username?: string;
+    password?: string;
+    accessToken?: string | Promise<string> | ((name?: string, scopes?: string[]) => string) | ((name?: string, scopes?: string[]) => Promise<string>);
+    basePath?: string;
+    serverIndex?: number;
+    baseOptions?: any;
+    formDataCtor?: new () => any;
+}
+
+export class Configuration {
+    /**
+     * parameter for apiKey security
+     * @param name security name
+     * @memberof Configuration
+     */
+    apiKey?: string | Promise<string> | ((name: string) => string) | ((name: string) => Promise<string>);
+    /**
+     * parameter for basic security
+     *
+     * @type {string}
+     * @memberof Configuration
+     */
+    username?: string;
+    /**
+     * parameter for basic security
+     *
+     * @type {string}
+     * @memberof Configuration
+     */
+    password?: string;
+    /**
+     * parameter for oauth2 security
+     * @param name security name
+     * @param scopes oauth2 scope
+     * @memberof Configuration
+     */
+    accessToken?: string | Promise<string> | ((name?: string, scopes?: string[]) => string) | ((name?: string, scopes?: string[]) => Promise<string>);
+    /**
+     * override base path
+     *
+     * @type {string}
+     * @memberof Configuration
+     */
+    basePath?: string;
+    /**
+     * override server index
+     *
+     * @type {number}
+     * @memberof Configuration
+     */
+    serverIndex?: number;
+    /**
+     * base options for axios calls
+     *
+     * @type {any}
+     * @memberof Configuration
+     */
+    baseOptions?: any;
+    /**
+     * The FormData constructor that will be used to create multipart form data
+     * requests. You can inject this here so that execution environments that
+     * do not support the FormData class can still run the generated client.
+     *
+     * @type {new () => FormData}
+     */
+    formDataCtor?: new () => any;
+
+    constructor(param: ConfigurationParameters = {}) {
+        this.apiKey = param.apiKey;
+        this.username = param.username;
+        this.password = param.password;
+        this.accessToken = param.accessToken;
+        this.basePath = param.basePath;
+        this.serverIndex = param.serverIndex;
+        this.baseOptions = {
+            ...param.baseOptions,
+            headers: {
+                ...param.baseOptions?.headers,
+            },
+        };
+        this.formDataCtor = param.formDataCtor;
+    }
+
+    /**
+     * Check if the given MIME is a JSON MIME.
+     * JSON MIME examples:
+     *   application/json
+     *   application/json; charset=UTF8
+     *   APPLICATION/JSON
+     *   application/vnd.company+json
+     * @param mime - MIME (Multipurpose Internet Mail Extensions)
+     * @return True if the given MIME is JSON, false otherwise.
+     */
+    public isJsonMime(mime: string): boolean {
+        const jsonMime: RegExp = new RegExp('^(application\/json|[^;/ \t]+\/[^;/ \t]+[+]json)[ \t]*(;.*)?$', 'i');
+        return mime !== null && (jsonMime.test(mime) || mime.toLowerCase() === 'application/json-patch+json');
+    }
+}

package/src/issuer-events/index.ts

@@ -0,0 +1,18 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Issuer Events API
+ * All date-time fields adhere to the ISO 8601 standard unless specified otherwise. For example: 2024-05-31T06:55:17Z 
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+export * from "./api";
+export * from "./configuration";
+

package/src/oauth/axios.ts

@@ -0,0 +1,60 @@
+/*
+ * Enfuce nextgen SDK — OAuth token-management helper.
+ *
+ * HAND-WRITTEN, NOT GENERATED. This module (src/oauth) is authored by hand and
+ * preserved across SDK regeneration (see scripts/generate.sh). Do not expect
+ * OpenAPI Generator to (re)produce it.
+ */
+import axios, { AxiosError, AxiosInstance, InternalAxiosRequestConfig } from 'axios';
+import { TokenManager } from './tokenManager';
+
+const BEARER_PREFIX = 'Bearer ';
+
+type RetriableConfig = InternalAxiosRequestConfig & { _oauthRetried?: boolean };
+
+function stripBearer(header: string): string {
+    return header.toLowerCase().startsWith(BEARER_PREFIX.toLowerCase())
+        ? header.slice(BEARER_PREFIX.length)
+        : header;
+}
+
+/**
+ * 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:
+ *
+ * ```ts
+ * const http = createOAuthAxios(tokens);
+ * const config = new card.Configuration({ accessToken: () => tokens.getToken() });
+ * const api = new card.CardApi(config, undefined, http);
+ * ```
+ */
+export function createOAuthAxios(manager: TokenManager, instance?: AxiosInstance): AxiosInstance {
+    const http = instance ?? axios.create();
+
+    http.interceptors.response.use(undefined, async (error: AxiosError) => {
+        const response = error.response;
+        const original = error.config as RetriableConfig | undefined;
+
+        if (!response || response.status !== 401 || !original || original._oauthRetried) {
+            return Promise.reject(error);
+        }
+
+        const authHeader = original.headers?.['Authorization'] ?? original.headers?.Authorization;
+        const stale = typeof authHeader === 'string' ? stripBearer(authHeader) : undefined;
+
+        const fresh = await manager.forceRefresh(stale);
+        if (stale !== undefined && fresh === stale) {
+            // Refresh produced the same token — surface the original 401.
+            return Promise.reject(error);
+        }
+
+        original._oauthRetried = true;
+        if (original.headers) {
+            original.headers['Authorization'] = BEARER_PREFIX + fresh;
+        }
+        return http.request(original);
+    });
+
+    return http;
+}

package/src/oauth/clientCredentials.ts

@@ -0,0 +1,72 @@
+/*
+ * Enfuce nextgen SDK — OAuth token-management helper.
+ *
+ * HAND-WRITTEN, NOT GENERATED. This module (src/oauth) is authored by hand and
+ * preserved across SDK regeneration (see scripts/generate.sh). Do not expect
+ * OpenAPI Generator to (re)produce it.
+ */
+import axios, { AxiosInstance, AxiosRequestConfig } from 'axios';
+import { AccessToken, TokenFetcher, TokenManager } from './tokenManager';
+
+/** Configuration for the OAuth2 `client_credentials` grant. */
+export interface OAuthConfig {
+    tokenUrl: string;
+    clientId: string;
+    clientSecret: string;
+    /** Requested scopes; space-joined into a `scope` parameter. */
+    scopes?: string[];
+    /** How client credentials are presented. Defaults to `basic`. */
+    authStyle?: 'basic' | 'body';
+    /** Extra form parameters to include in the token request. */
+    extraParams?: Record<string, string>;
+    /** Axios instance used for the token request. Defaults to a fresh instance. */
+    axiosInstance?: AxiosInstance;
+}
+
+interface TokenResponse {
+    access_token?: string;
+    expires_in?: number;
+}
+
+/**
+ * Builds a {@link TokenFetcher} that performs the OAuth2 `client_credentials`
+ * grant: a form-encoded POST to `config.tokenUrl`, parsing `access_token` and
+ * `expires_in`. Server-side only — never ship a client secret to a browser.
+ */
+export function clientCredentialsFetcher(config: OAuthConfig): TokenFetcher {
+    const http = config.axiosInstance ?? axios.create();
+    const style = config.authStyle ?? 'basic';
+
+    return async (): Promise<AccessToken> => {
+        const form = new URLSearchParams();
+        form.set('grant_type', 'client_credentials');
+        if (config.scopes && config.scopes.length > 0) {
+            form.set('scope', config.scopes.join(' '));
+        }
+        for (const [key, value] of Object.entries(config.extraParams ?? {})) {
+            form.set(key, value);
+        }
+
+        const options: AxiosRequestConfig = {
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        };
+        if (style === 'basic') {
+            options.auth = { username: config.clientId, password: config.clientSecret };
+        } else {
+            form.set('client_id', config.clientId);
+            form.set('client_secret', config.clientSecret);
+        }
+
+        const response = await http.post<TokenResponse>(config.tokenUrl, form.toString(), options);
+        const data = response.data;
+        if (!data || !data.access_token) {
+            throw new Error('token response has no access_token field');
+        }
+        return { accessToken: data.access_token, expiresInSeconds: data.expires_in ?? 0 };
+    };
+}
+
+/** Convenience: a caching {@link TokenManager} backed by the client-credentials grant. */
+export function clientCredentials(config: OAuthConfig, skewSeconds: number = 60): TokenManager {
+    return new TokenManager(clientCredentialsFetcher(config), skewSeconds);
+}

package/src/oauth/index.ts

@@ -0,0 +1,24 @@
+/*
+ * Enfuce nextgen SDK — OAuth token-management helper.
+ *
+ * HAND-WRITTEN, NOT GENERATED. This module (src/oauth) is authored by hand and
+ * preserved across SDK regeneration (see scripts/generate.sh). It is re-exported
+ * from the package barrel as `oauth`:
+ *
+ *   import { oauth, card } from '@enfuce/nextgen-sdk';
+ *
+ *   const tokens = oauth.clientCredentials({
+ *     tokenUrl: 'https://auth.example.com/oauth/token',
+ *     clientId: 'my-id',
+ *     clientSecret: 'my-secret',
+ *     scopes: ['cards:read'],
+ *   });
+ *   const http = oauth.createOAuthAxios(tokens);
+ *   const config = new card.Configuration({ accessToken: () => tokens.getToken() });
+ *   const api = new card.CardApi(config, undefined, http);
+ *
+ * Server-side only — a client secret must never ship to a browser.
+ */
+export { AccessToken, TokenFetcher, TokenManager } from './tokenManager';
+export { OAuthConfig, clientCredentials, clientCredentialsFetcher } from './clientCredentials';
+export { createOAuthAxios } from './axios';

package/src/oauth/tokenManager.ts

@@ -0,0 +1,85 @@
+/*
+ * Enfuce nextgen SDK — OAuth token-management helper.
+ *
+ * HAND-WRITTEN, NOT GENERATED. This module (src/oauth) is authored by hand and
+ * preserved across SDK regeneration (see scripts/generate.sh). Do not expect
+ * OpenAPI Generator to (re)produce it.
+ */
+
+/** The result of fetching an access token. */
+export interface AccessToken {
+    accessToken: string;
+    /** Lifetime in seconds (OAuth2 `expires_in`); <= 0 means unknown → refetch every call. */
+    expiresInSeconds: number;
+}
+
+/** Fetches a fresh access token. Supply your own to support any grant/source. */
+export type TokenFetcher = () => Promise<AccessToken>;
+
+/**
+ * Caches an access token and refreshes it before expiry. Plug it into a generated
+ * client's `Configuration`:
+ *
+ * ```ts
+ * const tokens = new TokenManager(fetcher);
+ * const config = new card.Configuration({ accessToken: () => tokens.getToken() });
+ * ```
+ *
+ * A token is considered expired once the clock passes `expiry - skew`. Concurrent
+ * refreshes share a single in-flight promise, so the token endpoint is hit once.
+ */
+export class TokenManager {
+    private token?: string;
+    private expiresAtMs?: number;
+    private inflight?: Promise<string>;
+
+    constructor(
+        private readonly fetcher: TokenFetcher,
+        private readonly skewSeconds: number = 60,
+        private readonly now: () => number = Date.now,
+    ) {}
+
+    /** Returns a valid access token, refreshing first if necessary. */
+    async getToken(): Promise<string> {
+        if (
+            this.token !== undefined &&
+            this.expiresAtMs !== undefined &&
+            this.now() < this.expiresAtMs - this.skewSeconds * 1000
+        ) {
+            return this.token;
+        }
+        return this.refresh();
+    }
+
+    /**
+     * Forces a refresh. If `staleToken` is given and the cached token has already
+     * changed, returns the current token without refetching — so two concurrent
+     * 401s trigger a single refresh.
+     */
+    forceRefresh(staleToken?: string): Promise<string> {
+        if (staleToken !== undefined && this.token !== undefined && this.token !== staleToken) {
+            return Promise.resolve(this.token);
+        }
+        return this.refresh();
+    }
+
+    private refresh(): Promise<string> {
+        if (this.inflight !== undefined) {
+            return this.inflight;
+        }
+        this.inflight = (async () => {
+            try {
+                const fetched = await this.fetcher();
+                this.token = fetched.accessToken;
+                this.expiresAtMs =
+                    fetched.expiresInSeconds > 0
+                        ? this.now() + fetched.expiresInSeconds * 1000
+                        : undefined;
+                return this.token;
+            } finally {
+                this.inflight = undefined;
+            }
+        })();
+        return this.inflight;
+    }
+}