@taxdao/fintax-mcp 0.2.0

package/dist/capabilities/executor.js

@@ -0,0 +1,134 @@
+import { AuthSession } from '../auth/auth-session.js';
+import { OrgTokenProvider } from '../auth/org-token-provider.js';
+import { createBaseClient } from '../clients/base-client.js';
+import { createSuiteClient } from '../clients/suite-client.js';
+import { FinTaxError } from '../errors/fintax-error.js';
+import { normalizeError } from '../errors/normalize-error.js';
+import { z } from 'zod/v4';
+export class CapabilityExecutor {
+    #config;
+    #registry;
+    #locks;
+    #fetch;
+    #runtime;
+    constructor(options) {
+        this.#config = options.config;
+        this.#registry = options.registry;
+        this.#locks = options.locks;
+        if (options.fetch !== undefined)
+            this.#fetch = options.fetch;
+    }
+    async call(capabilityId, input, orgId, audit) {
+        const definition = this.#registry.get(capabilityId);
+        const statusCodes = [];
+        try {
+            const parsedInput = definition.requestSchema.parse(input);
+            const request = definition.requestAdapter(parsedInput);
+            const runtime = this.#getRuntime();
+            let token;
+            let identity;
+            let recoverAuthentication;
+            if (definition.auth === 'required') {
+                const context = await runtime.orgTokens.getContext(orgId, definition.sideEffect !== 'none');
+                token = context.token;
+                identity = context.identity;
+                audit?.captureIdentity(identity);
+                recoverAuthentication = async () => (await runtime.orgTokens.refreshContext(orgId, context.generation))
+                    .token;
+                this.#assertPermissions(definition.permissionAny, definition.permissionAll, identity);
+            }
+            const client = definition.service === 'base' ? runtime.base : runtime.suite;
+            const requestOptions = {
+                method: definition.method,
+                path: definition.path,
+                ...request,
+                ...(token === undefined ? {} : { token }),
+                timeoutMs: definition.timeoutMs,
+                retryPolicy: definition.retryPolicy,
+                onResponse: (status) => statusCodes.push(status),
+                ...(recoverAuthentication === undefined
+                    ? {}
+                    : { onUnauthorized: recoverAuthentication }),
+            };
+            const response = definition.responseMode === 'bytes'
+                ? await client.requestBytes(requestOptions)
+                : await client.requestData(requestOptions);
+            let parsedResponse;
+            try {
+                parsedResponse = definition.responseSchema.parse(response);
+            }
+            catch (error) {
+                if (error instanceof z.ZodError) {
+                    throw new FinTaxError('UPSTREAM_UNAVAILABLE', 'Data returned by FinTax does not satisfy the public contract', { retryable: false, cause: error });
+                }
+                throw error;
+            }
+            const result = definition.resultAdapter(parsedResponse);
+            audit?.recordUpstreamCall({
+                service: definition.service,
+                operation: definition.operation,
+                method: definition.method,
+                outcome: 'succeeded',
+                statusCodes,
+            });
+            return result;
+        }
+        catch (error) {
+            const normalized = normalizeError(error);
+            if (statusCodes.length === 0 && normalized.status !== undefined) {
+                statusCodes.push(normalized.status);
+            }
+            audit?.recordUpstreamCall({
+                service: definition.service,
+                operation: definition.operation,
+                method: definition.method,
+                outcome: 'failed',
+                statusCodes,
+            });
+            throw error;
+        }
+    }
+    async getIdentity(orgId, audit) {
+        const identity = (await this.#getRuntime().orgTokens.getContext(orgId, false)).identity;
+        audit?.captureIdentity(identity);
+        return identity;
+    }
+    close() {
+        return this.#runtime?.auth.close() ?? Promise.resolve();
+    }
+    #getRuntime() {
+        if (this.#runtime !== undefined)
+            return this.#runtime;
+        if (this.#config.FINTAX_API_URL === undefined) {
+            throw new FinTaxError('AUTH_REQUIRED', 'Configure FINTAX_API_URL before calling business Tools');
+        }
+        const clientOptions = {
+            ...(this.#fetch === undefined ? {} : { fetch: this.#fetch }),
+            defaultTimeoutMs: this.#config.FINTAX_REQUEST_TIMEOUT_MS,
+        };
+        const base = createBaseClient(this.#config.FINTAX_API_URL, clientOptions);
+        const suite = createSuiteClient(this.#config.FINTAX_API_URL, clientOptions);
+        const auth = new AuthSession(base, this.#config, this.#locks);
+        this.#runtime = {
+            base,
+            suite,
+            auth,
+            orgTokens: new OrgTokenProvider(auth, this.#locks),
+        };
+        return this.#runtime;
+    }
+    #assertPermissions(any, all, identity) {
+        const available = new Set(identity.permissions);
+        if (any.length > 0 &&
+            !any.some((permission) => available.has(permission))) {
+            throw new FinTaxError('PERMISSION_DENIED', 'The current user lacks the required permission');
+        }
+        if (!all.every((permission) => available.has(permission))) {
+            throw new FinTaxError('PERMISSION_DENIED', 'The current user lacks the required permission');
+        }
+    }
+}
+export function capabilityRequest(request) {
+    return request;
+}
+//# sourceMappingURL=executor.js.map

package/dist/capabilities/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/capabilities/executor.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/registry.d.ts

@@ -0,0 +1,7 @@
+import { type CapabilityDefinition } from './capability.js';
+export declare class CapabilityRegistry {
+    #private;
+    constructor(definitions: readonly CapabilityDefinition[]);
+    get(capabilityId: string): CapabilityDefinition;
+    list(): readonly CapabilityDefinition[];
+}

package/dist/capabilities/registry.js

@@ -0,0 +1,51 @@
+import { FinTaxError } from '../errors/fintax-error.js';
+import { capabilityMetadataSchema, } from './capability.js';
+export class CapabilityRegistry {
+    #definitions;
+    constructor(definitions) {
+        const entries = new Map();
+        for (const definition of definitions) {
+            capabilityMetadataSchema.parse({
+                capabilityId: definition.capabilityId,
+                service: definition.service,
+                module: definition.module,
+                object: definition.object,
+                operation: definition.operation,
+                method: definition.method,
+                path: definition.path,
+                auth: definition.auth,
+                permissionAny: definition.permissionAny,
+                permissionAll: definition.permissionAll,
+                risk: definition.risk,
+                sideEffect: definition.sideEffect,
+                idempotency: definition.idempotency,
+                retryPolicy: definition.retryPolicy,
+                responseMode: definition.responseMode,
+                timeoutMs: definition.timeoutMs,
+                auditEvent: definition.auditEvent,
+                enabled: definition.enabled,
+                exposurePack: definition.exposurePack,
+            });
+            if (entries.has(definition.capabilityId)) {
+                throw new Error(`Duplicate capability: ${definition.capabilityId}`);
+            }
+            if (definition.method !== 'GET' &&
+                definition.retryPolicy === 'read-bounded') {
+                throw new Error(`Write capability cannot use read retry policy: ${definition.capabilityId}`);
+            }
+            entries.set(definition.capabilityId, definition);
+        }
+        this.#definitions = entries;
+    }
+    get(capabilityId) {
+        const definition = this.#definitions.get(capabilityId);
+        if (definition === undefined || !definition.enabled) {
+            throw new FinTaxError('UPSTREAM_UNAVAILABLE', 'The FinTax service capability is temporarily unavailable');
+        }
+        return definition;
+    }
+    list() {
+        return [...this.#definitions.values()];
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/capabilities/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/capabilities/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EACL,wBAAwB,GAEzB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,OAAO,kBAAkB;IACpB,YAAY,CAA4C;IAEjE,YAAY,WAA4C;QACtD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAC;QACxD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,wBAAwB,CAAC,KAAK,CAAC;gBAC7B,YAAY,EAAE,UAAU,CAAC,YAAY;gBACrC,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,aAAa,EAAE,UAAU,CAAC,aAAa;gBACvC,aAAa,EAAE,UAAU,CAAC,aAAa;gBACvC,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,UAAU,EAAE,UAAU,CAAC,UAAU;gBACjC,WAAW,EAAE,UAAU,CAAC,WAAW;gBACnC,WAAW,EAAE,UAAU,CAAC,WAAW;gBACnC,YAAY,EAAE,UAAU,CAAC,YAAY;gBACrC,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,UAAU,EAAE,UAAU,CAAC,UAAU;gBACjC,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,YAAY,EAAE,UAAU,CAAC,YAAY;aACtC,CAAC,CAAC;YACH,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,KAAK,CAAC,yBAAyB,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC;YACtE,CAAC;YACD,IACE,UAAU,CAAC,MAAM,KAAK,KAAK;gBAC3B,UAAU,CAAC,WAAW,KAAK,cAAc,EACzC,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,kDAAkD,UAAU,CAAC,YAAY,EAAE,CAC5E,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;IAC9B,CAAC;IAED,GAAG,CAAC,YAAoB;QACtB,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACvD,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACpD,MAAM,IAAI,WAAW,CACnB,sBAAsB,EACtB,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/clients/base-client.d.ts

@@ -0,0 +1,5 @@
+import { HttpClient } from './http-client.js';
+export declare function createBaseClient(baseUrl: string, options?: {
+    fetch?: typeof fetch;
+    defaultTimeoutMs?: number;
+}): HttpClient;

package/dist/clients/base-client.js

@@ -0,0 +1,13 @@
+import makeFetchCookie from 'fetch-cookie';
+import { CookieJar } from 'tough-cookie';
+import { HttpClient } from './http-client.js';
+export function createBaseClient(baseUrl, options = {}) {
+    const cookieFetch = makeFetchCookie(options.fetch ?? globalThis.fetch, new CookieJar(undefined, { allowSpecialUseDomain: true }), false);
+    return new HttpClient(baseUrl, {
+        fetch: cookieFetch,
+        ...(options.defaultTimeoutMs === undefined
+            ? {}
+            : { defaultTimeoutMs: options.defaultTimeoutMs }),
+    });
+}
+//# sourceMappingURL=base-client.js.map

package/dist/clients/base-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-client.js","sourceRoot":"","sources":["../../src/clients/base-client.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,UAA+D,EAAE;IAEjE,MAAM,WAAW,GAAG,eAAe,CACjC,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,EACjC,IAAI,SAAS,CAAC,SAAS,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,EACzD,KAAK,CACN,CAAC;IACF,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE;QAC7B,KAAK,EAAE,WAAW;QAClB,GAAG,CAAC,OAAO,CAAC,gBAAgB,KAAK,SAAS;YACxC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC;KACpD,CAAC,CAAC;AACL,CAAC"}

package/dist/clients/http-client.d.ts

@@ -0,0 +1,29 @@
+import type { HttpMethod, RetryPolicy } from '../capabilities/capability.js';
+export interface HttpRequestOptions {
+    readonly method: HttpMethod;
+    readonly path: string;
+    readonly query?: Readonly<Record<string, string | number | boolean | undefined>>;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly body?: unknown;
+    readonly token?: string;
+    readonly timeoutMs?: number;
+    readonly retryPolicy?: RetryPolicy;
+    readonly onUnauthorized?: () => Promise<string>;
+    readonly onResponse?: (status: number) => void;
+}
+export declare class HttpClient {
+    #private;
+    constructor(baseUrl: string, options?: {
+        fetch?: typeof fetch;
+        defaultTimeoutMs?: number;
+    });
+    requestData(options: HttpRequestOptions & {
+        readonly pathParams?: Readonly<Record<string, string>>;
+    }): Promise<unknown>;
+    requestBytes(options: Omit<HttpRequestOptions, 'body'> & {
+        readonly pathParams?: Readonly<Record<string, string>>;
+    }): Promise<{
+        bytes: Uint8Array;
+        headers: Headers;
+    }>;
+}

package/dist/clients/http-client.js

@@ -0,0 +1,167 @@
+import { FinTaxError } from '../errors/fintax-error.js';
+import { httpError, normalizeError } from '../errors/normalize-error.js';
+import { withRetry } from '../policies/retry.js';
+import { parse } from 'lossless-json';
+function isEnvelope(value) {
+    return value !== null && typeof value === 'object' && 'data' in value;
+}
+function parseUpstreamJson(text) {
+    return parse(text, undefined, {
+        parseNumber: (value) => {
+            if (/^-?\d+$/.test(value)) {
+                const integer = Number(value);
+                if (Number.isSafeInteger(integer))
+                    return integer;
+            }
+            return value;
+        },
+    });
+}
+function interpolatePath(template, pathParams = {}) {
+    return template.replace(/\{([^}]+)\}/g, (_match, key) => {
+        const value = pathParams[key];
+        if (value === undefined) {
+            throw new FinTaxError('UNKNOWN', 'FinTax MCP request configuration is incomplete');
+        }
+        return encodeURIComponent(value);
+    });
+}
+export class HttpClient {
+    #baseUrl;
+    #fetch;
+    #defaultTimeoutMs;
+    constructor(baseUrl, options = {}) {
+        this.#baseUrl = baseUrl.replace(/\/$/, '');
+        this.#fetch = options.fetch ?? globalThis.fetch;
+        this.#defaultTimeoutMs = options.defaultTimeoutMs ?? 10_000;
+    }
+    async requestData(options) {
+        const path = interpolatePath(options.path, options.pathParams);
+        const url = new URL(`${this.#baseUrl}${path}`);
+        for (const [key, value] of Object.entries(options.query ?? {})) {
+            if (value !== undefined)
+                url.searchParams.set(key, String(value));
+        }
+        let token = options.token;
+        let refreshed = false;
+        const run = async () => {
+            try {
+                return await this.#requestOnce(url, {
+                    ...options,
+                    ...(token === undefined ? {} : { token }),
+                });
+            }
+            catch (error) {
+                const normalized = normalizeError(error);
+                if (normalized.code === 'AUTH_REQUIRED' &&
+                    options.onUnauthorized !== undefined &&
+                    !refreshed) {
+                    refreshed = true;
+                    token = await options.onUnauthorized();
+                    return this.#requestOnce(url, { ...options, token });
+                }
+                throw normalized;
+            }
+        };
+        return withRetry(run, {
+            retries: options.method === 'GET' && options.retryPolicy === 'read-bounded'
+                ? 2
+                : 0,
+            shouldRetry: (error) => {
+                const normalized = normalizeError(error);
+                return (normalized.code === 'UPSTREAM_UNAVAILABLE' ||
+                    normalized.code === 'TIMEOUT');
+            },
+        });
+    }
+    async requestBytes(options) {
+        const path = interpolatePath(options.path, options.pathParams);
+        const url = new URL(`${this.#baseUrl}${path}`);
+        for (const [key, value] of Object.entries(options.query ?? {})) {
+            if (value !== undefined)
+                url.searchParams.set(key, String(value));
+        }
+        let token = options.token;
+        let refreshed = false;
+        const run = async () => {
+            const response = await this.#fetch(url, {
+                method: options.method,
+                headers: this.#headers({
+                    ...options,
+                    ...(token === undefined ? {} : { token }),
+                }),
+                signal: AbortSignal.timeout(options.timeoutMs ?? this.#defaultTimeoutMs),
+            });
+            options.onResponse?.(response.status);
+            if (!response.ok) {
+                const error = await this.#responseError(response);
+                if (error.code === 'AUTH_REQUIRED' &&
+                    options.onUnauthorized !== undefined &&
+                    !refreshed) {
+                    refreshed = true;
+                    token = await options.onUnauthorized();
+                    return run();
+                }
+                throw error;
+            }
+            return {
+                bytes: new Uint8Array(await response.arrayBuffer()),
+                headers: response.headers,
+            };
+        };
+        return withRetry(run, {
+            retries: options.method === 'GET' && options.retryPolicy === 'read-bounded'
+                ? 2
+                : 0,
+            shouldRetry: (error) => normalizeError(error).retryable,
+        });
+    }
+    async #requestOnce(url, options) {
+        const response = await this.#fetch(url, {
+            method: options.method,
+            headers: this.#headers(options),
+            ...(options.body === undefined
+                ? {}
+                : {
+                    body: options.body instanceof FormData
+                        ? options.body
+                        : JSON.stringify(options.body),
+                }),
+            signal: AbortSignal.timeout(options.timeoutMs ?? this.#defaultTimeoutMs),
+        });
+        options.onResponse?.(response.status);
+        if (!response.ok)
+            throw await this.#responseError(response);
+        if (response.status === 204)
+            return undefined;
+        const parsed = parseUpstreamJson(await response.text());
+        if (!isEnvelope(parsed))
+            return parsed;
+        if (parsed.code !== undefined &&
+            (parsed.code < 200 || parsed.code >= 300)) {
+            throw httpError(parsed.code);
+        }
+        return parsed.data;
+    }
+    #headers(options) {
+        const headers = new Headers(options.headers);
+        if (!headers.has('accept'))
+            headers.set('accept', 'application/json');
+        if (options.body !== undefined && !(options.body instanceof FormData))
+            headers.set('content-type', 'application/json');
+        if (options.token !== undefined) {
+            headers.set('authorization', `Bearer ${options.token}`);
+        }
+        return headers;
+    }
+    async #responseError(response) {
+        try {
+            await response.body?.cancel();
+        }
+        catch {
+            // The body is intentionally discarded; upstream text is not public data.
+        }
+        return httpError(response.status);
+    }
+}
+//# sourceMappingURL=http-client.js.map

package/dist/clients/http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/clients/http-client.ts"],"names":[],"mappings":"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"}

package/dist/clients/suite-client.d.ts

@@ -0,0 +1,5 @@
+import { HttpClient } from './http-client.js';
+export declare function createSuiteClient(suiteUrl: string, options?: {
+    fetch?: typeof fetch;
+    defaultTimeoutMs?: number;
+}): HttpClient;

package/dist/clients/suite-client.js

@@ -0,0 +1,5 @@
+import { HttpClient } from './http-client.js';
+export function createSuiteClient(suiteUrl, options = {}) {
+    return new HttpClient(suiteUrl, options);
+}
+//# sourceMappingURL=suite-client.js.map

package/dist/clients/suite-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suite-client.js","sourceRoot":"","sources":["../../src/clients/suite-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,UAA+D,EAAE;IAEjE,OAAO,IAAI,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC"}

package/dist/concurrency/lock-manager.d.ts

@@ -0,0 +1,4 @@
+export declare class LockManager {
+    #private;
+    withLock<T>(key: string, operation: () => Promise<T>): Promise<T>;
+}

package/dist/concurrency/lock-manager.js

@@ -0,0 +1,23 @@
+export class LockManager {
+    #tails = new Map();
+    async withLock(key, operation) {
+        const previous = this.#tails.get(key) ?? Promise.resolve();
+        let release;
+        const current = new Promise((resolve) => {
+            release = resolve;
+        });
+        const tail = previous.then(() => current);
+        this.#tails.set(key, tail);
+        await previous;
+        try {
+            return await operation();
+        }
+        finally {
+            release();
+            if (this.#tails.get(key) === tail) {
+                this.#tails.delete(key);
+            }
+        }
+    }
+}
+//# sourceMappingURL=lock-manager.js.map

package/dist/concurrency/lock-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-manager.js","sourceRoot":"","sources":["../../src/concurrency/lock-manager.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAW;IACb,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEnD,KAAK,CAAC,QAAQ,CAAI,GAAW,EAAE,SAA2B;QACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3D,IAAI,OAAoB,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5C,OAAO,GAAG,OAAO,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAE3B,MAAM,QAAQ,CAAC;QACf,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;YACV,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;gBAClC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/config/load-config.d.ts

@@ -0,0 +1,2 @@
+import { type RuntimeConfig } from './schema.js';
+export declare function loadConfig(environment?: NodeJS.ProcessEnv): RuntimeConfig;

package/dist/config/load-config.js

@@ -0,0 +1,18 @@
+import { runtimeConfigSchema } from './schema.js';
+export function loadConfig(environment = process.env) {
+    return runtimeConfigSchema.parse({
+        FINTAX_API_URL: environment.FINTAX_API_URL,
+        FINTAX_USERNAME: environment.FINTAX_USERNAME,
+        FINTAX_PASSWORD: environment.FINTAX_PASSWORD,
+        FINTAX_DEFAULT_ORG_ID: environment.FINTAX_DEFAULT_ORG_ID,
+        FINTAX_TOOL_PACKS: environment.FINTAX_TOOL_PACKS,
+        FINTAX_ALLOWED_IMPORT_DIRS: environment.FINTAX_ALLOWED_IMPORT_DIRS,
+        FINTAX_ARTIFACT_DIR: environment.FINTAX_ARTIFACT_DIR,
+        FINTAX_AUDIT_DIR: environment.FINTAX_AUDIT_DIR,
+        FINTAX_LOG_LEVEL: environment.FINTAX_LOG_LEVEL,
+        FINTAX_REQUEST_TIMEOUT_MS: environment.FINTAX_REQUEST_TIMEOUT_MS,
+        FINTAX_SHUTDOWN_TIMEOUT_MS: environment.FINTAX_SHUTDOWN_TIMEOUT_MS,
+        FINTAX_MAX_FILE_BYTES: environment.FINTAX_MAX_FILE_BYTES,
+    });
+}
+//# sourceMappingURL=load-config.js.map

package/dist/config/load-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-config.js","sourceRoot":"","sources":["../../src/config/load-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAsB,MAAM,aAAa,CAAC;AAEtE,MAAM,UAAU,UAAU,CACxB,cAAiC,OAAO,CAAC,GAAG;IAE5C,OAAO,mBAAmB,CAAC,KAAK,CAAC;QAC/B,cAAc,EAAE,WAAW,CAAC,cAAc;QAC1C,eAAe,EAAE,WAAW,CAAC,eAAe;QAC5C,eAAe,EAAE,WAAW,CAAC,eAAe;QAC5C,qBAAqB,EAAE,WAAW,CAAC,qBAAqB;QACxD,iBAAiB,EAAE,WAAW,CAAC,iBAAiB;QAChD,0BAA0B,EAAE,WAAW,CAAC,0BAA0B;QAClE,mBAAmB,EAAE,WAAW,CAAC,mBAAmB;QACpD,gBAAgB,EAAE,WAAW,CAAC,gBAAgB;QAC9C,gBAAgB,EAAE,WAAW,CAAC,gBAAgB;QAC9C,yBAAyB,EAAE,WAAW,CAAC,yBAAyB;QAChE,0BAA0B,EAAE,WAAW,CAAC,0BAA0B;QAClE,qBAAqB,EAAE,WAAW,CAAC,qBAAqB;KACzD,CAAC,CAAC;AACL,CAAC"}

package/dist/config/schema.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod/v4';
+export declare const runtimeConfigSchema: z.ZodObject<{
+    FINTAX_API_URL: z.ZodPreprocess<z.ZodOptional<z.ZodPipe<z.ZodURL, z.ZodTransform<string, string>>>>;
+    FINTAX_USERNAME: z.ZodPreprocess<z.ZodOptional<z.ZodString>>;
+    FINTAX_PASSWORD: z.ZodPreprocess<z.ZodOptional<z.ZodString>>;
+    FINTAX_DEFAULT_ORG_ID: z.ZodPreprocess<z.ZodOptional<z.ZodUUID>>;
+    FINTAX_TOOL_PACKS: z.ZodPipe<z.ZodDefault<z.ZodString>, z.ZodTransform<("core-read" | "fnd-import" | "core-edit" | "workflow" | "period-end" | "asset-ops" | "automation" | "configuration")[], string>>;
+    FINTAX_ALLOWED_IMPORT_DIRS: z.ZodPipe<z.ZodDefault<z.ZodString>, z.ZodTransform<string[], string>>;
+    FINTAX_ARTIFACT_DIR: z.ZodDefault<z.ZodString>;
+    FINTAX_AUDIT_DIR: z.ZodDefault<z.ZodString>;
+    FINTAX_LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
+        silent: "silent";
+        error: "error";
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+        fatal: "fatal";
+        trace: "trace";
+    }>>;
+    FINTAX_REQUEST_TIMEOUT_MS: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    FINTAX_SHUTDOWN_TIMEOUT_MS: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    FINTAX_MAX_FILE_BYTES: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+export type RuntimeConfig = z.infer<typeof runtimeConfigSchema>;

package/dist/config/schema.js

@@ -0,0 +1,85 @@
+import path from 'node:path';
+import { z } from 'zod/v4';
+import { EXPOSURE_PACKS } from '../tools/tool-definition.js';
+const optionalUrl = z.preprocess((value) => (value === '' ? undefined : value), z
+    .url()
+    .transform((value) => value.replace(/\/$/, ''))
+    .optional());
+const optionalString = z.preprocess((value) => (value === '' ? undefined : value), z.string().min(1).optional());
+const positiveInteger = (fallback) => z.coerce.number().int().positive().default(fallback);
+const directoryList = z
+    .string()
+    .default('')
+    .transform((value, context) => {
+    const directories = value
+        .split(path.delimiter)
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+    for (const directory of directories) {
+        if (!path.isAbsolute(directory)) {
+            context.addIssue({
+                code: 'custom',
+                message: `Import directory must be absolute: ${directory}`,
+            });
+        }
+    }
+    return directories;
+});
+const exposurePackList = z
+    .string()
+    .default(EXPOSURE_PACKS.join(','))
+    .transform((value, context) => {
+    const supported = new Set(EXPOSURE_PACKS);
+    const packs = [
+        ...new Set(value.split(',').map((entry) => entry.trim())),
+    ].filter((entry) => entry.length > 0);
+    if (packs.length === 0) {
+        context.addIssue({
+            code: 'custom',
+            message: 'At least one FinTax Tool pack must be enabled',
+        });
+    }
+    for (const pack of packs) {
+        if (!supported.has(pack)) {
+            context.addIssue({
+                code: 'custom',
+                message: `Unsupported FinTax Tool pack: ${pack}`,
+            });
+        }
+    }
+    for (const pack of [
+        'fnd-import',
+        'core-edit',
+        'workflow',
+        'asset-ops',
+        'automation',
+        'configuration',
+    ]) {
+        if (packs.includes(pack) && !packs.includes('core-read')) {
+            context.addIssue({
+                code: 'custom',
+                message: `The ${pack} Tool pack requires core-read`,
+            });
+        }
+    }
+    return packs;
+});
+export const runtimeConfigSchema = z
+    .object({
+    FINTAX_API_URL: optionalUrl,
+    FINTAX_USERNAME: optionalString,
+    FINTAX_PASSWORD: optionalString,
+    FINTAX_DEFAULT_ORG_ID: z.preprocess((value) => (value === '' ? undefined : value), z.uuid().optional()),
+    FINTAX_TOOL_PACKS: exposurePackList,
+    FINTAX_ALLOWED_IMPORT_DIRS: directoryList,
+    FINTAX_ARTIFACT_DIR: z.string().min(1).default('./var/artifacts'),
+    FINTAX_AUDIT_DIR: z.string().min(1).default('./var/audit'),
+    FINTAX_LOG_LEVEL: z
+        .enum(['fatal', 'error', 'warn', 'info', 'debug', 'trace', 'silent'])
+        .default('info'),
+    FINTAX_REQUEST_TIMEOUT_MS: positiveInteger(10_000),
+    FINTAX_SHUTDOWN_TIMEOUT_MS: positiveInteger(5_000),
+    FINTAX_MAX_FILE_BYTES: positiveInteger(25 * 1024 * 1024),
+})
+    .strict();
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"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"}