@forestadmin/workflow-executor 1.0.0

package/dist/cli-core.js

@@ -0,0 +1,228 @@
+"use strict";
+/* eslint-disable no-console */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = parseArgs;
+exports.pickLogger = pickLogger;
+exports.readEnvConfig = readEnvConfig;
+exports.printHelp = printHelp;
+exports.printVersion = printVersion;
+exports.logStartup = logStartup;
+exports.runCli = runCli;
+const zod_1 = require("zod");
+const console_logger_1 = __importDefault(require("./adapters/console-logger"));
+const pretty_logger_1 = __importDefault(require("./adapters/pretty-logger"));
+const defaults_1 = require("./defaults");
+const errors_1 = require("./errors");
+const POSITIVE_INT = zod_1.z.coerce.number().int().positive();
+function parsePositiveIntEnv(name, raw) {
+    if (!raw)
+        return undefined;
+    const parsed = POSITIVE_INT.safeParse(raw);
+    if (!parsed.success) {
+        throw new errors_1.ConfigurationError(`${name} must be a positive integer (got "${raw}")`);
+    }
+    return parsed.data;
+}
+// eslint-disable-next-line @typescript-eslint/no-var-requires, import/no-dynamic-require, global-require
+const { version } = require('../package.json');
+const BINARY_NAME = 'forest-workflow-executor';
+function parseArgs(argv) {
+    const result = {
+        help: false,
+        version: false,
+        inMemory: false,
+        pretty: false,
+        json: false,
+    };
+    for (const arg of argv) {
+        switch (arg) {
+            case '--help':
+            case '-h':
+                result.help = true;
+                break;
+            case '--version':
+            case '-v':
+                result.version = true;
+                break;
+            case '--in-memory':
+                result.inMemory = true;
+                break;
+            case '--pretty':
+                result.pretty = true;
+                break;
+            case '--json':
+                result.json = true;
+                break;
+            default:
+                throw new Error(`Unknown argument: ${arg}`);
+        }
+    }
+    return result;
+}
+// Priority: --json → Console; --pretty → Pretty; TTY → Pretty; else Console (piped/docker/k8s/CI).
+// NO_COLOR is respected by picocolors so pretty output stays monochrome where ANSI is banned.
+function pickLogger(args, stdout = process.stdout) {
+    if (args.json)
+        return new console_logger_1.default();
+    if (args.pretty)
+        return new pretty_logger_1.default();
+    return stdout.isTTY ? new pretty_logger_1.default() : new console_logger_1.default();
+}
+function parseAiConfig(env) {
+    const { AI_PROVIDER, AI_MODEL, AI_API_KEY } = env;
+    const fields = [AI_PROVIDER, AI_MODEL, AI_API_KEY];
+    const setCount = fields.filter(Boolean).length;
+    if (setCount === 0)
+        return undefined;
+    if (setCount !== fields.length) {
+        throw new Error('AI config must be all-or-nothing: set AI_PROVIDER, AI_MODEL and AI_API_KEY together or leave all unset.');
+    }
+    if (AI_PROVIDER !== 'anthropic' && AI_PROVIDER !== 'openai') {
+        throw new Error(`AI_PROVIDER must be "anthropic" or "openai", got "${AI_PROVIDER}"`);
+    }
+    return [
+        {
+            name: 'default',
+            provider: AI_PROVIDER,
+            model: AI_MODEL,
+            apiKey: AI_API_KEY,
+        },
+    ];
+}
+function readEnvConfig(env, args) {
+    const requiredBase = ['FOREST_ENV_SECRET', 'FOREST_AUTH_SECRET', 'AGENT_URL'];
+    const missing = requiredBase.filter(key => !env[key]);
+    if (!args.inMemory && !env.DATABASE_URL) {
+        missing.push('DATABASE_URL (required unless --in-memory)');
+    }
+    if (missing.length > 0) {
+        throw new Error(`Missing required environment variables:\n${missing.map(v => `  - ${v}`).join('\n')}\n\n` +
+            `Run \`${BINARY_NAME} --help\` for the full list.`);
+    }
+    const aiConfigurations = parseAiConfig(env);
+    const executorOptions = {
+        envSecret: env.FOREST_ENV_SECRET,
+        authSecret: env.FOREST_AUTH_SECRET,
+        agentUrl: env.AGENT_URL,
+        httpPort: parsePositiveIntEnv('HTTP_PORT', env.HTTP_PORT) ?? defaults_1.DEFAULT_HTTP_PORT,
+        forestServerUrl: env.FOREST_SERVER_URL,
+        pollingIntervalMs: parsePositiveIntEnv('POLLING_INTERVAL_MS', env.POLLING_INTERVAL_MS),
+        stopTimeoutMs: parsePositiveIntEnv('STOP_TIMEOUT_MS', env.STOP_TIMEOUT_MS),
+        stepTimeoutMs: parsePositiveIntEnv('STEP_TIMEOUT_MS', env.STEP_TIMEOUT_MS),
+        aiInvokeTimeoutMs: parsePositiveIntEnv('AI_INVOKE_TIMEOUT_MS', env.AI_INVOKE_TIMEOUT_MS),
+        maxChainDepth: parsePositiveIntEnv('MAX_CHAIN_DEPTH', env.MAX_CHAIN_DEPTH),
+        schemaCacheTtlMs: parsePositiveIntEnv('SCHEMA_CACHE_TTL_MS', env.SCHEMA_CACHE_TTL_MS),
+        ...(aiConfigurations && { aiConfigurations }),
+        ...(env.FORCE_AI_ERROR === 'true' && { forceAiError: true }),
+    };
+    return {
+        executorOptions,
+        databaseUrl: env.DATABASE_URL,
+        mode: args.inMemory ? 'in-memory' : 'database',
+    };
+}
+function printHelp() {
+    console.log(`Usage: ${BINARY_NAME} [options]
+
+Run the Forest Admin workflow executor.
+
+Options:
+  --in-memory       Use an in-memory run store (no DB needed, not for prod)
+  --pretty          Force colorized human-readable logs (default when stdout is a TTY)
+  --json            Force structured JSON logs (default when stdout is not a TTY)
+  --help, -h        Show this help
+  --version, -v     Show version
+
+Required environment variables:
+  FOREST_ENV_SECRET   Forest Admin project environment secret
+  FOREST_AUTH_SECRET  JWT signing secret (shared with your agent)
+  AGENT_URL           URL of your running Forest Admin agent
+  DATABASE_URL        Postgres connection string (not needed with --in-memory)
+
+Optional environment variables:
+  HTTP_PORT              Default: ${defaults_1.DEFAULT_HTTP_PORT}
+  FOREST_SERVER_URL      Default: ${defaults_1.DEFAULT_FOREST_SERVER_URL}
+  POLLING_INTERVAL_MS    Default: ${defaults_1.DEFAULT_POLLING_INTERVAL_MS}
+  STOP_TIMEOUT_MS        Default: ${defaults_1.DEFAULT_STOP_TIMEOUT_MS}
+  STEP_TIMEOUT_MS        Max duration of a step in ms (default: ${defaults_1.DEFAULT_STEP_TIMEOUT_MS})
+  AI_INVOKE_TIMEOUT_MS   Max duration of a single AI provider invocation in ms (default: ${defaults_1.DEFAULT_AI_INVOKE_TIMEOUT_MS})
+  MAX_CHAIN_DEPTH        Max steps auto-executed per run before yielding (default: ${defaults_1.DEFAULT_MAX_CHAIN_DEPTH})
+  SCHEMA_CACHE_TTL_MS    Collection schema cache TTL in ms (default: ${defaults_1.DEFAULT_SCHEMA_CACHE_TTL_MS})
+  NO_COLOR               Set to any value to disable ANSI colors in pretty logs
+  FORCE_AI_ERROR         Set to "true" to make every AI call fail (dev only, to test error paths)
+
+AI configuration (all-or-nothing — falls back to server AI if any is missing):
+  AI_PROVIDER            'anthropic' | 'openai'
+  AI_MODEL               Model name (e.g. claude-sonnet-4-6)
+  AI_API_KEY             Provider API key
+
+Signals:
+  SIGTERM / SIGINT  Graceful shutdown (drain in-flight, then exit)`);
+}
+function printVersion() {
+    console.log(version);
+}
+function logStartup(logger, config) {
+    const { executorOptions: opts, mode } = config;
+    let aiLabel;
+    if (opts.forceAiError) {
+        aiLabel = 'forced-error (dev only)';
+    }
+    else if (opts.aiConfigurations?.length) {
+        aiLabel = `local (${opts.aiConfigurations[0].provider} / ${opts.aiConfigurations[0].model})`;
+    }
+    else {
+        aiLabel = 'server fallback';
+    }
+    logger.info('Workflow executor starting', {
+        mode,
+        forestServerUrl: opts.forestServerUrl ?? defaults_1.DEFAULT_FOREST_SERVER_URL,
+        agentUrl: opts.agentUrl,
+        httpPort: opts.httpPort,
+        pollingIntervalMs: opts.pollingIntervalMs ?? defaults_1.DEFAULT_POLLING_INTERVAL_MS,
+        aiConfig: aiLabel,
+    });
+}
+async function runCli(argv, env, factories) {
+    const args = parseArgs(argv);
+    if (args.help) {
+        printHelp();
+        return null;
+    }
+    if (args.version) {
+        printVersion();
+        return null;
+    }
+    const config = readEnvConfig(env, args);
+    const logger = pickLogger(args);
+    config.executorOptions.logger = logger;
+    logStartup(logger, config);
+    try {
+        let executor;
+        if (config.mode === 'in-memory') {
+            executor = factories.buildInMemory(config.executorOptions);
+        }
+        else {
+            const databaseOptions = {
+                ...config.executorOptions,
+                database: { uri: config.databaseUrl },
+            };
+            executor = factories.buildDatabase(databaseOptions);
+        }
+        await executor.start();
+        logger.info('Workflow executor ready', {
+            url: `http://localhost:${config.executorOptions.httpPort}`,
+        });
+        return executor;
+    }
+    catch (error) {
+        logger.error('Workflow executor failed to start', {
+            error: (0, errors_1.extractErrorMessage)(error),
+        });
+        throw error;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLWNvcmUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvY2xpLWNvcmUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBLCtCQUErQjs7Ozs7QUFnRS9CLDhCQWtDQztBQUlELGdDQUtDO0FBNkJELHNDQXNDQztBQUVELDhCQXFDQztBQUVELG9DQUVDO0FBRUQsZ0NBb0JDO0FBRUQsd0JBa0RDO0FBOVJELDZCQUF3QjtBQUV4QiwrRUFBc0Q7QUFDdEQsNkVBQW9EO0FBTXBELHlDQVNvQjtBQUNwQixxQ0FBbUU7QUFFbkUsTUFBTSxZQUFZLEdBQUcsT0FBQyxDQUFDLE1BQU0sQ0FBQyxNQUFNLEVBQUUsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxRQUFRLEVBQUUsQ0FBQztBQUV4RCxTQUFTLG1CQUFtQixDQUFDLElBQVksRUFBRSxHQUF1QjtJQUNoRSxJQUFJLENBQUMsR0FBRztRQUFFLE9BQU8sU0FBUyxDQUFDO0lBRTNCLE1BQU0sTUFBTSxHQUFHLFlBQVksQ0FBQyxTQUFTLENBQUMsR0FBRyxDQUFDLENBQUM7SUFFM0MsSUFBSSxDQUFDLE1BQU0sQ0FBQyxPQUFPLEVBQUUsQ0FBQztRQUNwQixNQUFNLElBQUksMkJBQWtCLENBQUMsR0FBRyxJQUFJLHFDQUFxQyxHQUFHLElBQUksQ0FBQyxDQUFDO0lBQ3BGLENBQUM7SUFFRCxPQUFPLE1BQU0sQ0FBQyxJQUFJLENBQUM7QUFDckIsQ0FBQztBQUVELHlHQUF5RztBQUN6RyxNQUFNLEVBQUUsT0FBTyxFQUFFLEdBQUcsT0FBTyxDQUFDLGlCQUFpQixDQUF3QixDQUFDO0FBRXRFLE1BQU0sV0FBVyxHQUFHLDBCQUEwQixDQUFDO0FBcUIvQyxTQUFnQixTQUFTLENBQUMsSUFBYztJQUN0QyxNQUFNLE1BQU0sR0FBWTtRQUN0QixJQUFJLEVBQUUsS0FBSztRQUNYLE9BQU8sRUFBRSxLQUFLO1FBQ2QsUUFBUSxFQUFFLEtBQUs7UUFDZixNQUFNLEVBQUUsS0FBSztRQUNiLElBQUksRUFB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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+"use strict";
+/* eslint-disable no-console */
+Object.defineProperty(exports, "__esModule", { value: true });
+const build_workflow_executor_1 = require("./build-workflow-executor");
+const cli_core_1 = require("./cli-core");
+const errors_1 = require("./errors");
+if (require.main === module) {
+    (0, cli_core_1.runCli)(process.argv.slice(2), process.env, {
+        buildDatabase: build_workflow_executor_1.buildDatabaseExecutor,
+        buildInMemory: build_workflow_executor_1.buildInMemoryExecutor,
+    }).catch((err) => {
+        console.error(`Error: ${(0, errors_1.extractErrorMessage)(err)}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NsaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUNBLCtCQUErQjs7QUFFL0IsdUVBQXlGO0FBQ3pGLHlDQUFvQztBQUNwQyxxQ0FBK0M7QUFFL0MsSUFBSSxPQUFPLENBQUMsSUFBSSxLQUFLLE1BQU0sRUFBRSxDQUFDO0lBQzVCLElBQUEsaUJBQU0sRUFBQyxPQUFPLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsRUFBRSxPQUFPLENBQUMsR0FBRyxFQUFFO1FBQ3pDLGFBQWEsRUFBRSwrQ0FBcUI7UUFDcEMsYUFBYSxFQUFFLCtDQUFxQjtLQUNyQyxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUMsR0FBWSxFQUFFLEVBQUU7UUFDeEIsT0FBTyxDQUFDLEtBQUssQ0FBQyxVQUFVLElBQUEsNEJBQW1CLEVBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxDQUFDO1FBQ3BELE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDbEIsQ0FBQyxDQUFDLENBQUM7QUFDTCxDQUFDIn0=

package/dist/defaults.d.ts

@@ -0,0 +1,9 @@
+export declare const DEFAULT_HTTP_PORT = 3400;
+export declare const DEFAULT_FOREST_SERVER_URL = "https://api.forestadmin.com";
+export declare const DEFAULT_POLLING_INTERVAL_MS = 30000;
+export declare const DEFAULT_STEP_TIMEOUT_MS: number;
+export declare const DEFAULT_AI_INVOKE_TIMEOUT_MS = 30000;
+export declare const DEFAULT_STOP_TIMEOUT_MS = 30000;
+export declare const DEFAULT_MAX_CHAIN_DEPTH = 50;
+export declare const DEFAULT_SCHEMA_CACHE_TTL_MS: number;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/defaults.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SCHEMA_CACHE_TTL_MS = exports.DEFAULT_MAX_CHAIN_DEPTH = exports.DEFAULT_STOP_TIMEOUT_MS = exports.DEFAULT_AI_INVOKE_TIMEOUT_MS = exports.DEFAULT_STEP_TIMEOUT_MS = exports.DEFAULT_POLLING_INTERVAL_MS = exports.DEFAULT_FOREST_SERVER_URL = exports.DEFAULT_HTTP_PORT = void 0;
+exports.DEFAULT_HTTP_PORT = 3400;
+exports.DEFAULT_FOREST_SERVER_URL = 'https://api.forestadmin.com';
+exports.DEFAULT_POLLING_INTERVAL_MS = 30000;
+exports.DEFAULT_STEP_TIMEOUT_MS = 5 * 60000;
+exports.DEFAULT_AI_INVOKE_TIMEOUT_MS = 30000;
+exports.DEFAULT_STOP_TIMEOUT_MS = 30000;
+exports.DEFAULT_MAX_CHAIN_DEPTH = 50;
+exports.DEFAULT_SCHEMA_CACHE_TTL_MS = 10 * 60000;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVmYXVsdHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvZGVmYXVsdHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQWEsUUFBQSxpQkFBaUIsR0FBRyxJQUFJLENBQUM7QUFDekIsUUFBQSx5QkFBeUIsR0FBRyw2QkFBNkIsQ0FBQztBQUMxRCxRQUFBLDJCQUEyQixHQUFHLEtBQU0sQ0FBQztBQUNyQyxRQUFBLHVCQUF1QixHQUFHLENBQUMsR0FBRyxLQUFNLENBQUM7QUFDckMsUUFBQSw0QkFBNEIsR0FBRyxLQUFNLENBQUM7QUFDdEMsUUFBQSx1QkFBdUIsR0FBRyxLQUFNLENBQUM7QUFDakMsUUFBQSx1QkFBdUIsR0FBRyxFQUFFLENBQUM7QUFDN0IsUUFBQSwyQkFBMkIsR0FBRyxFQUFFLEdBQUcsS0FBTSxDQUFDIn0=

package/dist/errors.d.ts

@@ -0,0 +1,153 @@
+import type { MalformedRunInfo } from './ports/workflow-port';
+import type { RecordId } from './types/validated/collection';
+import type { z } from 'zod';
+export declare function causeMessage(error: unknown): string | undefined;
+export declare function extractErrorMessage(err?: unknown): string | undefined;
+export declare abstract class WorkflowExecutorError extends Error {
+    readonly userMessage: string;
+    cause?: unknown;
+    constructor(message: string, userMessage?: string);
+}
+export declare class MissingToolCallError extends WorkflowExecutorError {
+    constructor();
+}
+export declare class MalformedToolCallError extends WorkflowExecutorError {
+    readonly toolName: string;
+    constructor(toolName: string, details: string);
+}
+export declare class RecordNotFoundError extends WorkflowExecutorError {
+    constructor(collectionName: string, recordId: RecordId);
+}
+export declare class NoRecordsError extends WorkflowExecutorError {
+    constructor();
+}
+export declare class NoReadableFieldsError extends WorkflowExecutorError {
+    constructor(collectionName: string);
+}
+export declare class NoResolvedFieldsError extends WorkflowExecutorError {
+    constructor(fieldNames: string[]);
+}
+export declare class NoWritableFieldsError extends WorkflowExecutorError {
+    constructor(collectionName: string);
+}
+export declare class NoActionsError extends WorkflowExecutorError {
+    constructor(collectionName: string);
+}
+export declare class UnsupportedActionFormError extends WorkflowExecutorError {
+    constructor(actionDisplayName: string);
+}
+export declare class RunStorePortError extends WorkflowExecutorError {
+    constructor(operation: string, cause: unknown);
+}
+export declare class NoRelationshipFieldsError extends WorkflowExecutorError {
+    constructor(collectionName: string);
+}
+export declare class RelatedRecordNotFoundError extends WorkflowExecutorError {
+    constructor(collectionName: string, relationName: string);
+}
+export declare class InvalidAIResponseError extends WorkflowExecutorError {
+    constructor(message: string);
+}
+export declare class InvalidAiRequestError extends WorkflowExecutorError {
+    constructor(message: string);
+}
+export declare class RelationNotFoundError extends WorkflowExecutorError {
+    constructor(name: string, collectionName: string);
+}
+export declare class FieldNotFoundError extends WorkflowExecutorError {
+    constructor(name: string, collectionName: string);
+}
+export declare class FieldTypeMissingError extends WorkflowExecutorError {
+    constructor(name: string, collectionName: string);
+}
+export declare class ActionNotFoundError extends WorkflowExecutorError {
+    constructor(name: string, collectionName: string);
+}
+export declare class StepStateError extends WorkflowExecutorError {
+    constructor(message: string);
+}
+export declare class ActivityLogCreationError extends WorkflowExecutorError {
+    constructor(cause: unknown);
+}
+export declare class StepTimeoutError extends WorkflowExecutorError {
+    constructor(timeoutMs: number);
+}
+export declare class AiInvokeTimeoutError extends WorkflowExecutorError {
+    constructor(timeoutMs: number);
+}
+export declare class NoMcpToolsError extends WorkflowExecutorError {
+    constructor(requestedMcpServerId: string);
+}
+export declare class McpToolNotFoundError extends WorkflowExecutorError {
+    constructor(name: string);
+}
+export declare class AgentPortError extends WorkflowExecutorError {
+    constructor(operation: string, cause: unknown);
+}
+export declare class SchemaNotCachedError extends WorkflowExecutorError {
+    constructor(collectionName: string);
+}
+export declare class WorkflowPortError extends WorkflowExecutorError {
+    constructor(operation: string, cause: unknown);
+}
+export declare class AiModelPortError extends WorkflowExecutorError {
+    constructor(operation: string, cause: unknown);
+}
+export declare class McpToolInvocationError extends WorkflowExecutorError {
+    constructor(toolName: string, cause: unknown);
+}
+export declare class ConfigurationError extends Error {
+    constructor(message: string);
+}
+export declare class RunNotFoundError extends Error {
+    cause?: unknown;
+    constructor(runId: string, cause?: unknown);
+}
+export declare class UserMismatchError extends Error {
+    constructor(runId: string);
+}
+export declare class RunAlreadyInFlightError extends Error {
+    constructor(runId: string);
+}
+export declare class PendingDataNotFoundError extends Error {
+    constructor(runId: string, stepIndex: number);
+}
+export interface ValidationIssue {
+    path: (string | number)[];
+    message: string;
+    code: string;
+}
+export declare class InvalidPendingDataError extends WorkflowExecutorError {
+    readonly issues: ValidationIssue[];
+    constructor(issues: ValidationIssue[]);
+}
+export declare class InvalidPreRecordedArgsError extends WorkflowExecutorError {
+    constructor(detail: string);
+}
+export declare class AgentProbeError extends Error {
+    readonly cause?: unknown;
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class UnsupportedStepTypeError extends WorkflowExecutorError {
+    constructor(stepType: string);
+}
+export declare class RecordIdSerializationError extends WorkflowExecutorError {
+    constructor(part: string);
+}
+export declare class InvalidStepDefinitionError extends WorkflowExecutorError {
+    constructor(detail: string);
+}
+export declare class DomainValidationError extends WorkflowExecutorError {
+    readonly issues: ReadonlyArray<{
+        path: string;
+        message: string;
+    }>;
+    constructor(runId: number, zodError: z.ZodError);
+}
+export declare class MalformedRunError extends WorkflowExecutorError {
+    readonly info: MalformedRunInfo;
+    constructor(info: MalformedRunInfo);
+}
+//# sourceMappingURL=errors.d.ts.map