@blokjs/runner 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,107 @@
+import Configuration from "./Configuration";
+import ConfigurationResolver from "./ConfigurationResolver";
+import DefaultLogger from "./DefaultLogger";
+import LocalStorage from "./LocalStorage";
+import ResolverBase from "./ResolverBase";
+import Runner from "./Runner";
+import TriggerBase from "./TriggerBase";
+import { RuntimeAdapterNode } from "./RuntimeAdapterNode";
+import { RuntimeRegistry } from "./RuntimeRegistry";
+import { BunRuntimeAdapter } from "./adapters/BunRuntimeAdapter";
+import { DockerRuntimeAdapter } from "./adapters/DockerRuntimeAdapter";
+import { HttpRuntimeAdapter } from "./adapters/HttpRuntimeAdapter";
+import { NodeJsRuntimeAdapter } from "./adapters/NodeJsRuntimeAdapter";
+import type { ExecutionResult, RuntimeAdapter, RuntimeKind } from "./adapters/RuntimeAdapter";
+import { WasmRuntimeAdapter } from "./adapters/WasmRuntimeAdapter";
+import { type FnNodeDefinition, FunctionNode, defineNode } from "./defineNode";
+import { CircuitBreaker, CircuitOpenError } from "./monitoring/CircuitBreaker";
+import { HealthCheck } from "./monitoring/HealthCheck";
+import { bootstrapPrometheus, resetPrometheusBootstrap } from "./monitoring/PrometheusBootstrap";
+import { PrometheusMetricsBridge } from "./monitoring/PrometheusMetricsBridge";
+import { RateLimiter } from "./monitoring/RateLimiter";
+import { TriggerMetricsCollector } from "./monitoring/TriggerMetricsCollector";
+import { RuntimeAutoScaler } from "./marketplace/RuntimeAutoScaler";
+import { RuntimeCatalog } from "./marketplace/RuntimeCatalog";
+import { RuntimeDiscovery } from "./marketplace/RuntimeDiscovery";
+import { RuntimeHealthMonitor } from "./marketplace/RuntimeHealthMonitor";
+import { RuntimeMetricsDashboard } from "./marketplace/RuntimeMetricsDashboard";
+import { FileWatcher } from "./hmr/FileWatcher";
+import { HmrDevConsole } from "./hmr/HmrDevConsole";
+import { HotReloadManager } from "./hmr/HotReloadManager";
+import { ABACEngine, createDefaultABAC } from "./security/ABAC";
+import { AuditLogger, ConsoleAuditSink, FileAuditSink, InMemoryAuditSink } from "./security/AuditLogger";
+import { APIKeyAuthProvider, AuthMiddleware, JWTAuthProvider } from "./security/AuthMiddleware";
+import { OAuthOIDCProvider, TokenCache } from "./security/OAuthProvider";
+import { RBAC, createDefaultRBAC } from "./security/RBAC";
+import { AWSSecretsProvider, EnvironmentSecretProvider, GCPSecretProvider, InMemorySecretProvider, SecretManager, VaultSecretProvider } from "./security/SecretManager";
+import { OpenAPIGenerator } from "./openapi/OpenAPIGenerator";
+import { GraphQLSchemaGenerator } from "./graphql/GraphQLSchemaGenerator";
+import { NodeDependencyGraph } from "./visualization/NodeDependencyGraph";
+import { WorkflowVisualizer } from "./visualization/WorkflowVisualizer";
+import { PerformanceProfiler } from "./monitoring/PerformanceProfiler";
+import { RunTracker } from "./tracing/RunTracker";
+import { registerTraceRoutes } from "./tracing/TraceRouter";
+import { TracingLogger } from "./tracing/TracingLogger";
+import { sanitize as traceSanitize } from "./tracing/sanitize";
+import { CostEstimator } from "./cost/CostEstimator";
+import { DEFAULT_DURATIONS, DEFAULT_MEMORY, PRICING, getRuntimeCategory } from "./cost/pricing";
+import { SentryIntegration } from "./integrations/SentryIntegration";
+import { InMemoryCache, NodeResultCache } from "./cache/NodeResultCache";
+import { NodeTestHarness } from "./testing/TestHarness";
+import { TestLogger } from "./testing/TestLogger";
+import { WorkflowTestRunner } from "./testing/WorkflowTestRunner";
+import BlokService from "./Blok";
+import BlokResponse, { IBlokResponse } from "./BlokResponse";
+import NodeMap from "./NodeMap";
+import RunnerSteps from "./RunnerSteps";
+import Average from "./types/Average";
+import Condition from "./types/Condition";
+import Conditions from "./types/Conditions";
+import Config from "./types/Config";
+import Flow from "./types/Flow";
+import GlobalOptions from "./types/GlobalOptions";
+import Inputs from "./types/Inputs";
+import JsonLikeObject from "./types/JsonLikeObject";
+import Node from "./types/Node";
+import ParamsDictionary from "./types/ParamsDictionary";
+import Properties from "./types/Properties";
+import Targets from "./types/Targets";
+import Trigger from "./types/Trigger";
+import TriggerHttp from "./types/TriggerHttp";
+import TriggerResponse from "./types/TriggerResponse";
+import Triggers from "./types/Triggers";
+export { Configuration, Runner, ConfigurationResolver, DefaultLogger, LocalStorage, ResolverBase, TriggerBase, RuntimeRegistry, RuntimeAdapterNode, NodeJsRuntimeAdapter, DockerRuntimeAdapter, HttpRuntimeAdapter, BunRuntimeAdapter, WasmRuntimeAdapter, defineNode, FunctionNode, HealthCheck, RateLimiter, CircuitBreaker, CircuitOpenError, TriggerMetricsCollector, PrometheusMetricsBridge, bootstrapPrometheus, resetPrometheusBootstrap, RuntimeCatalog, RuntimeDiscovery, RuntimeHealthMonitor, RuntimeMetricsDashboard, RuntimeAutoScaler, FileWatcher, HotReloadManager, HmrDevConsole, AuthMiddleware, JWTAuthProvider, APIKeyAuthProvider, RBAC, createDefaultRBAC, ABACEngine, createDefaultABAC, AuditLogger, ConsoleAuditSink, FileAuditSink, InMemoryAuditSink, OAuthOIDCProvider, TokenCache, SecretManager, EnvironmentSecretProvider, InMemorySecretProvider, VaultSecretProvider, AWSSecretsProvider, GCPSecretProvider, OpenAPIGenerator, GraphQLSchemaGenerator, WorkflowVisualizer, NodeDependencyGraph, PerformanceProfiler, RunTracker, registerTraceRoutes, TracingLogger, traceSanitize, CostEstimator, PRICING, DEFAULT_DURATIONS, DEFAULT_MEMORY, getRuntimeCategory, SentryIntegration, InMemoryCache, NodeResultCache, NodeTestHarness, WorkflowTestRunner, TestLogger, Condition, Conditions, Config, Flow, Inputs, Node, Properties, Targets, Trigger, TriggerHttp, Triggers, ParamsDictionary, GlobalOptions, NodeMap, JsonLikeObject, BlokService, BlokResponse, IBlokResponse, RunnerSteps, Average, TriggerResponse, };
+export type { RuntimeAdapter, RuntimeKind, ExecutionResult, FnNodeDefinition };
+export type { HttpRuntimeAdapterOptions } from "./adapters/HttpRuntimeAdapter";
+export type { HealthStatus, HealthCheckResult, DependencyHealth, DependencyCheckFn, } from "./monitoring/HealthCheck";
+export type { RateLimitConfig, RateLimitResult } from "./monitoring/RateLimiter";
+export type { CircuitState, CircuitBreakerConfig, CircuitBreakerStats, CircuitBreakerEvent, CircuitBreakerEventType, CircuitBreakerListener, } from "./monitoring/CircuitBreaker";
+export type { TriggerMetrics, LatencyStats, ErrorStats, ThroughputStats, } from "./monitoring/TriggerMetricsCollector";
+export type { PrometheusMetricsBridgeConfig, ExecutionLabels, } from "./monitoring/PrometheusMetricsBridge";
+export type { PrometheusBootstrapConfig, PrometheusBootstrapResult, } from "./monitoring/PrometheusBootstrap";
+export type { RuntimePackageManifest, RuntimeNodeInfo, CatalogSearchOptions, CatalogSearchResult, CatalogStats, } from "./marketplace/RuntimeCatalog";
+export type { CompatibilityInfo, DiscoveryResult, ResolveOptions, } from "./marketplace/RuntimeDiscovery";
+export type { RuntimeHealthStatus, HealthMonitorConfig, HealthCheckRecord, HealthChangeListener, } from "./marketplace/RuntimeHealthMonitor";
+export type { RuntimeExecutionMetrics, LatencyPercentiles, ThroughputMetrics, ResourceMetrics, DashboardSnapshot, AggregateMetrics, } from "./marketplace/RuntimeMetricsDashboard";
+export type { ScalingPolicy, ScalingDecision, ScalingMetrics, ScalingHistory, AutoScalerConfig, ScalingListener, } from "./marketplace/RuntimeAutoScaler";
+export type { FileWatcherConfig, HMREvent, HMREventType, } from "./hmr/FileWatcher";
+export type { HotReloadManagerConfig, HotReloadStats, ReloadHandler, } from "./hmr/HotReloadManager";
+export type { AuthMiddlewareConfig, AuthProvider, AuthIdentity, AuthRequest, AuthResult, JWTAuthProviderConfig, APIKeyAuthProviderConfig, APIKeyInfo, } from "./security/AuthMiddleware";
+export type { Action, Permission, RoleDefinition, AccessCheckResult, RBACPolicy, } from "./security/RBAC";
+export type { ABACOperator, ABACEffect, ABACCondition, ABACConditionGroup, ABACPolicyTarget, ABACPolicy, SubjectAttributes, ResourceAttributes, EnvironmentAttributes, ABACRequest, ABACResult, } from "./security/ABAC";
+export type { AuditEntry, AuditCategory, AuditSeverity, AuditSink, AuditLoggerConfig, } from "./security/AuditLogger";
+export type { OAuthOIDCConfig, OIDCDiscoveryDocument, JWK, JWKS, TokenCacheStats, } from "./security/OAuthProvider";
+export type { SecretProvider, SecretMetadata, SecretAccessEvent, SecretManagerConfig, SecretCacheConfig, SecretProviderConfig, EnvironmentProviderConfig, InMemoryProviderConfig, VaultProviderConfig, AWSSecretsProviderConfig, GCPSecretProviderConfig, } from "./security/SecretManager";
+export type { OpenAPIGeneratorConfig, OpenAPISecurityScheme, WorkflowDefinition, OpenAPISpec, } from "./openapi/OpenAPIGenerator";
+export type { GraphQLGeneratorConfig, GqlWorkflowDefinition, GqlFieldDef, GraphQLSchemaJSON, GraphQLTypeInfo, GraphQLFieldInfo, } from "./graphql/GraphQLSchemaGenerator";
+export type { VisualizerConfig, WorkflowDef as VisualizerWorkflowDef, StepDef as VisualizerStepDef, ConditionDef as VisualizerConditionDef, WorkflowSummary, } from "./visualization/WorkflowVisualizer";
+export type { StepRef, DependencyNode, DependencyEdge, DependencyGraphConfig, DependencyStats, } from "./visualization/NodeDependencyGraph";
+export type { NodeProfile, WorkflowProfile, ProfileConfig, } from "./monitoring/PerformanceProfiler";
+export type { NodeCostEstimate, WorkflowCostEstimate, CostEstimatorConfig, } from "./cost/CostEstimator";
+export type { CloudProvider, RuntimeCostCategory, RuntimeCostModel, } from "./cost/pricing";
+export type { SentryConfig, WorkflowErrorContext, SentryClient, SentryTransaction, SentrySpan, } from "./integrations/SentryIntegration";
+export type { CacheProvider, CacheEntry, CacheSetOptions, CacheStats, InMemoryCacheConfig, CacheKeyStrategy, CustomKeyFn, CacheResult, NodeResultCacheConfig, } from "./cache/NodeResultCache";
+export type { LogEntry } from "./testing/TestLogger";
+export type { TestContextOverrides, TestResult, TestMetrics } from "./testing/TestHarness";
+export type { WorkflowTestConfig, WorkflowTestResult, ExecutionTrace, WorkflowExecuteOptions, } from "./testing/WorkflowTestRunner";
+export type { WorkflowRun, WorkflowRunStatus, NodeRun, NodeRunStatus, RunEvent, RunEventType, TraceLogEntry, WorkflowSummary as TraceWorkflowSummary, WorkflowDetail as TraceWorkflowDetail, PaginatedResult, StartRunOptions, StartNodeOptions, } from "./tracing/types";

package/dist/index.js

@@ -0,0 +1,107 @@
+import Configuration from "./Configuration";
+import ConfigurationResolver from "./ConfigurationResolver";
+import DefaultLogger from "./DefaultLogger";
+import LocalStorage from "./LocalStorage";
+import ResolverBase from "./ResolverBase";
+import Runner from "./Runner";
+import TriggerBase from "./TriggerBase";
+import { RuntimeAdapterNode } from "./RuntimeAdapterNode";
+// Runtime adapters
+import { RuntimeRegistry } from "./RuntimeRegistry";
+import { BunRuntimeAdapter } from "./adapters/BunRuntimeAdapter";
+import { DockerRuntimeAdapter } from "./adapters/DockerRuntimeAdapter";
+import { HttpRuntimeAdapter } from "./adapters/HttpRuntimeAdapter";
+import { NodeJsRuntimeAdapter } from "./adapters/NodeJsRuntimeAdapter";
+import { WasmRuntimeAdapter } from "./adapters/WasmRuntimeAdapter";
+// Function-first node API
+import { FunctionNode, defineNode } from "./defineNode";
+import { CircuitBreaker, CircuitOpenError } from "./monitoring/CircuitBreaker";
+// Monitoring infrastructure
+import { HealthCheck } from "./monitoring/HealthCheck";
+import { bootstrapPrometheus, resetPrometheusBootstrap } from "./monitoring/PrometheusBootstrap";
+import { PrometheusMetricsBridge } from "./monitoring/PrometheusMetricsBridge";
+import { RateLimiter } from "./monitoring/RateLimiter";
+import { TriggerMetricsCollector } from "./monitoring/TriggerMetricsCollector";
+import { RuntimeAutoScaler } from "./marketplace/RuntimeAutoScaler";
+// Marketplace infrastructure
+import { RuntimeCatalog } from "./marketplace/RuntimeCatalog";
+import { RuntimeDiscovery } from "./marketplace/RuntimeDiscovery";
+import { RuntimeHealthMonitor } from "./marketplace/RuntimeHealthMonitor";
+import { RuntimeMetricsDashboard } from "./marketplace/RuntimeMetricsDashboard";
+// Hot Module Replacement (HMR)
+import { FileWatcher } from "./hmr/FileWatcher";
+import { HmrDevConsole } from "./hmr/HmrDevConsole";
+import { HotReloadManager } from "./hmr/HotReloadManager";
+import { ABACEngine, createDefaultABAC } from "./security/ABAC";
+import { AuditLogger, ConsoleAuditSink, FileAuditSink, InMemoryAuditSink } from "./security/AuditLogger";
+// Security
+import { APIKeyAuthProvider, AuthMiddleware, JWTAuthProvider } from "./security/AuthMiddleware";
+import { OAuthOIDCProvider, TokenCache } from "./security/OAuthProvider";
+import { RBAC, createDefaultRBAC } from "./security/RBAC";
+import { AWSSecretsProvider, EnvironmentSecretProvider, GCPSecretProvider, InMemorySecretProvider, SecretManager, VaultSecretProvider, } from "./security/SecretManager";
+// OpenAPI
+import { OpenAPIGenerator } from "./openapi/OpenAPIGenerator";
+// GraphQL
+import { GraphQLSchemaGenerator } from "./graphql/GraphQLSchemaGenerator";
+import { NodeDependencyGraph } from "./visualization/NodeDependencyGraph";
+// Visualization
+import { WorkflowVisualizer } from "./visualization/WorkflowVisualizer";
+// Performance Profiling
+import { PerformanceProfiler } from "./monitoring/PerformanceProfiler";
+// Tracing (Blok Studio)
+import { RunTracker } from "./tracing/RunTracker";
+import { registerTraceRoutes } from "./tracing/TraceRouter";
+import { TracingLogger } from "./tracing/TracingLogger";
+import { sanitize as traceSanitize } from "./tracing/sanitize";
+// Cost Estimation
+import { CostEstimator } from "./cost/CostEstimator";
+import { DEFAULT_DURATIONS, DEFAULT_MEMORY, PRICING, getRuntimeCategory } from "./cost/pricing";
+// Integrations
+import { SentryIntegration } from "./integrations/SentryIntegration";
+// Cache
+import { InMemoryCache, NodeResultCache } from "./cache/NodeResultCache";
+// Testing Framework
+import { NodeTestHarness } from "./testing/TestHarness";
+import { TestLogger } from "./testing/TestLogger";
+import { WorkflowTestRunner } from "./testing/WorkflowTestRunner";
+// types
+import BlokService from "./Blok";
+import BlokResponse from "./BlokResponse";
+import NodeMap from "./NodeMap";
+import RunnerSteps from "./RunnerSteps";
+export { Configuration, Runner, ConfigurationResolver, DefaultLogger, LocalStorage, ResolverBase, TriggerBase, 
+// Runtime adapters
+RuntimeRegistry, RuntimeAdapterNode, NodeJsRuntimeAdapter, DockerRuntimeAdapter, HttpRuntimeAdapter, BunRuntimeAdapter, WasmRuntimeAdapter, 
+// Function-first API
+defineNode, FunctionNode, 
+// Monitoring
+HealthCheck, RateLimiter, CircuitBreaker, CircuitOpenError, TriggerMetricsCollector, PrometheusMetricsBridge, bootstrapPrometheus, resetPrometheusBootstrap, 
+// Marketplace
+RuntimeCatalog, RuntimeDiscovery, RuntimeHealthMonitor, RuntimeMetricsDashboard, RuntimeAutoScaler, 
+// HMR
+FileWatcher, HotReloadManager, HmrDevConsole, 
+// Security
+AuthMiddleware, JWTAuthProvider, APIKeyAuthProvider, RBAC, createDefaultRBAC, ABACEngine, createDefaultABAC, AuditLogger, ConsoleAuditSink, FileAuditSink, InMemoryAuditSink, 
+// OAuth 2.0 / OIDC
+OAuthOIDCProvider, TokenCache, 
+// Secret Management
+SecretManager, EnvironmentSecretProvider, InMemorySecretProvider, VaultSecretProvider, AWSSecretsProvider, GCPSecretProvider, 
+// OpenAPI
+OpenAPIGenerator, 
+// GraphQL
+GraphQLSchemaGenerator, 
+// Visualization
+WorkflowVisualizer, NodeDependencyGraph, 
+// Performance Profiling
+PerformanceProfiler, 
+// Tracing (Blok Studio)
+RunTracker, registerTraceRoutes, TracingLogger, traceSanitize, 
+// Cost Estimation
+CostEstimator, PRICING, DEFAULT_DURATIONS, DEFAULT_MEMORY, getRuntimeCategory, 
+// Integrations
+SentryIntegration, 
+// Cache
+InMemoryCache, NodeResultCache, 
+// Testing
+NodeTestHarness, WorkflowTestRunner, TestLogger, NodeMap, BlokService, BlokResponse, RunnerSteps, };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/integrations/APMIntegration.d.ts

@@ -0,0 +1,141 @@
+/**
+ * APMIntegration - Unified APM bridge for DataDog, New Relic, and generic OTLP backends
+ *
+ * Configures OpenTelemetry trace and metric exporters targeting specific APM vendors.
+ * Each vendor has pre-configured OTLP endpoints and required headers/env vars.
+ *
+ * Uses lazy dynamic imports so vendor-specific SDK packages are optional.
+ * Falls back to generic OTLP if vendor-specific packages are not installed.
+ *
+ * Supported vendors:
+ * - **DataDog**: Sends traces/metrics via dd-trace or OTLP to DataDog Agent
+ * - **New Relic**: Sends traces/metrics via OTLP to New Relic ingest endpoint
+ * - **Generic OTLP**: Any OTLP-compatible backend (Jaeger, Grafana Tempo, etc.)
+ *
+ * @example
+ * ```typescript
+ * import { APMIntegration } from "@blokjs/runner";
+ *
+ * // DataDog
+ * const apm = new APMIntegration({
+ *   vendor: "datadog",
+ *   serviceName: "blok-http",
+ *   datadogAgentUrl: "http://localhost:4318",
+ * });
+ * await apm.init();
+ *
+ * // New Relic
+ * const apm = new APMIntegration({
+ *   vendor: "newrelic",
+ *   serviceName: "blok-http",
+ *   newrelicLicenseKey: process.env.NEW_RELIC_LICENSE_KEY!,
+ * });
+ * await apm.init();
+ *
+ * // Generic OTLP
+ * const apm = new APMIntegration({
+ *   vendor: "otlp",
+ *   serviceName: "blok-http",
+ *   otlpEndpoint: "http://tempo:4318/v1/traces",
+ * });
+ * await apm.init();
+ * ```
+ */
+export type APMVendor = "datadog" | "newrelic" | "otlp";
+export interface APMConfig {
+    /** APM vendor */
+    vendor: APMVendor;
+    /** Service name */
+    serviceName: string;
+    /** Service version */
+    serviceVersion?: string;
+    /** Environment (defaults to NODE_ENV) */
+    environment?: string;
+    /** DataDog: Agent OTLP endpoint (default: http://localhost:4318) */
+    datadogAgentUrl?: string;
+    /** DataDog: dd-trace service name override */
+    datadogServiceName?: string;
+    /** New Relic: License key (or set NEW_RELIC_LICENSE_KEY env) */
+    newrelicLicenseKey?: string;
+    /** New Relic: OTLP endpoint (default: US region endpoint) */
+    newrelicEndpoint?: string;
+    /** New Relic: Region "us" | "eu" (default: "us") */
+    newrelicRegion?: "us" | "eu";
+    /** Generic OTLP: endpoint URL */
+    otlpEndpoint?: string;
+    /** Generic OTLP: additional headers */
+    otlpHeaders?: Record<string, string>;
+    /** Trace sampling ratio (0.0 to 1.0, default: 1.0) */
+    samplingRatio?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+export interface APMBootstrapResult {
+    /** Vendor name */
+    vendor: APMVendor;
+    /** Gracefully shut down the APM integration */
+    shutdown: () => Promise<void>;
+    /** Force flush pending data */
+    forceFlush: () => Promise<void>;
+}
+export declare class APMIntegration {
+    private config;
+    private initialized;
+    private shutdownFn;
+    private flushFn;
+    constructor(config: APMConfig);
+    /**
+     * Initialize the APM integration.
+     * Dynamically loads vendor-specific or generic OTLP packages.
+     * Returns false if required packages are not installed.
+     */
+    init(): Promise<boolean>;
+    /**
+     * Initialize DataDog APM.
+     *
+     * Strategy: Use OTLP export to the DataDog Agent, which accepts OTLP
+     * on port 4318 (HTTP) or 4317 (gRPC) when configured with
+     * DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_HTTP_ENDPOINT.
+     */
+    private initDataDog;
+    /**
+     * Initialize New Relic APM.
+     *
+     * Strategy: Send traces via OTLP to New Relic's ingest endpoint.
+     * Requires NEW_RELIC_LICENSE_KEY in headers.
+     */
+    private initNewRelic;
+    /**
+     * Initialize generic OTLP backend.
+     */
+    private initOTLP;
+    /**
+     * Shared OTLP bootstrap using TracingBootstrap.
+     */
+    private bootstrapOTLPTracing;
+    /**
+     * Check if the APM integration is initialized.
+     */
+    isInitialized(): boolean;
+    /**
+     * Get the configured vendor.
+     */
+    getVendor(): APMVendor;
+    /**
+     * Shut down the APM integration, flushing pending data.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Force flush pending traces/metrics.
+     */
+    forceFlush(): Promise<void>;
+    /**
+     * Get the OTLP endpoint configuration for the current vendor.
+     * Useful for debugging and diagnostics.
+     */
+    getEndpointInfo(): {
+        vendor: APMVendor;
+        endpoint: string;
+        initialized: boolean;
+    };
+}

package/dist/integrations/APMIntegration.js

@@ -0,0 +1,212 @@
+/**
+ * APMIntegration - Unified APM bridge for DataDog, New Relic, and generic OTLP backends
+ *
+ * Configures OpenTelemetry trace and metric exporters targeting specific APM vendors.
+ * Each vendor has pre-configured OTLP endpoints and required headers/env vars.
+ *
+ * Uses lazy dynamic imports so vendor-specific SDK packages are optional.
+ * Falls back to generic OTLP if vendor-specific packages are not installed.
+ *
+ * Supported vendors:
+ * - **DataDog**: Sends traces/metrics via dd-trace or OTLP to DataDog Agent
+ * - **New Relic**: Sends traces/metrics via OTLP to New Relic ingest endpoint
+ * - **Generic OTLP**: Any OTLP-compatible backend (Jaeger, Grafana Tempo, etc.)
+ *
+ * @example
+ * ```typescript
+ * import { APMIntegration } from "@blokjs/runner";
+ *
+ * // DataDog
+ * const apm = new APMIntegration({
+ *   vendor: "datadog",
+ *   serviceName: "blok-http",
+ *   datadogAgentUrl: "http://localhost:4318",
+ * });
+ * await apm.init();
+ *
+ * // New Relic
+ * const apm = new APMIntegration({
+ *   vendor: "newrelic",
+ *   serviceName: "blok-http",
+ *   newrelicLicenseKey: process.env.NEW_RELIC_LICENSE_KEY!,
+ * });
+ * await apm.init();
+ *
+ * // Generic OTLP
+ * const apm = new APMIntegration({
+ *   vendor: "otlp",
+ *   serviceName: "blok-http",
+ *   otlpEndpoint: "http://tempo:4318/v1/traces",
+ * });
+ * await apm.init();
+ * ```
+ */
+export class APMIntegration {
+    config;
+    initialized = false;
+    shutdownFn = null;
+    flushFn = null;
+    constructor(config) {
+        this.config = {
+            serviceVersion: "0.0.1",
+            environment: process.env.NODE_ENV || "development",
+            samplingRatio: 1.0,
+            debug: false,
+            ...config,
+        };
+    }
+    /**
+     * Initialize the APM integration.
+     * Dynamically loads vendor-specific or generic OTLP packages.
+     * Returns false if required packages are not installed.
+     */
+    async init() {
+        if (this.initialized)
+            return true;
+        try {
+            switch (this.config.vendor) {
+                case "datadog":
+                    return await this.initDataDog();
+                case "newrelic":
+                    return await this.initNewRelic();
+                case "otlp":
+                    return await this.initOTLP();
+                default:
+                    return false;
+            }
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Initialize DataDog APM.
+     *
+     * Strategy: Use OTLP export to the DataDog Agent, which accepts OTLP
+     * on port 4318 (HTTP) or 4317 (gRPC) when configured with
+     * DD_OTLP_CONFIG_RECEIVER_PROTOCOLS_HTTP_ENDPOINT.
+     */
+    async initDataDog() {
+        const endpoint = this.config.datadogAgentUrl || "http://localhost:4318/v1/traces";
+        const headers = {};
+        // DataDog Agent does not require auth headers for local OTLP,
+        // but we pass service metadata via resource attributes.
+        return this.bootstrapOTLPTracing(endpoint, headers);
+    }
+    /**
+     * Initialize New Relic APM.
+     *
+     * Strategy: Send traces via OTLP to New Relic's ingest endpoint.
+     * Requires NEW_RELIC_LICENSE_KEY in headers.
+     */
+    async initNewRelic() {
+        const licenseKey = this.config.newrelicLicenseKey || process.env.NEW_RELIC_LICENSE_KEY || "";
+        if (!licenseKey) {
+            return false;
+        }
+        const region = this.config.newrelicRegion ?? "us";
+        const endpoint = this.config.newrelicEndpoint ||
+            (region === "eu" ? "https://otlp.eu01.nr-data.net:4318/v1/traces" : "https://otlp.nr-data.net:4318/v1/traces");
+        const headers = {
+            "api-key": licenseKey,
+        };
+        return this.bootstrapOTLPTracing(endpoint, headers);
+    }
+    /**
+     * Initialize generic OTLP backend.
+     */
+    async initOTLP() {
+        const endpoint = this.config.otlpEndpoint ||
+            process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ||
+            process.env.OTEL_EXPORTER_OTLP_ENDPOINT ||
+            "http://localhost:4318/v1/traces";
+        return this.bootstrapOTLPTracing(endpoint, this.config.otlpHeaders || {});
+    }
+    /**
+     * Shared OTLP bootstrap using TracingBootstrap.
+     */
+    async bootstrapOTLPTracing(endpoint, headers) {
+        try {
+            // Use our TracingBootstrap module
+            const { bootstrapTracing } = await import("../monitoring/TracingBootstrap");
+            const result = await bootstrapTracing({
+                serviceName: this.config.serviceName,
+                serviceVersion: this.config.serviceVersion,
+                exporter: "otlp",
+                endpoint,
+                headers,
+                samplingRatio: this.config.samplingRatio,
+            });
+            if (!result)
+                return false;
+            this.shutdownFn = result.shutdown;
+            this.flushFn = result.forceFlush;
+            this.initialized = true;
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if the APM integration is initialized.
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Get the configured vendor.
+     */
+    getVendor() {
+        return this.config.vendor;
+    }
+    /**
+     * Shut down the APM integration, flushing pending data.
+     */
+    async shutdown() {
+        if (this.shutdownFn) {
+            await this.shutdownFn();
+        }
+        this.initialized = false;
+    }
+    /**
+     * Force flush pending traces/metrics.
+     */
+    async forceFlush() {
+        if (this.flushFn) {
+            await this.flushFn();
+        }
+    }
+    /**
+     * Get the OTLP endpoint configuration for the current vendor.
+     * Useful for debugging and diagnostics.
+     */
+    getEndpointInfo() {
+        let endpoint;
+        switch (this.config.vendor) {
+            case "datadog":
+                endpoint = this.config.datadogAgentUrl || "http://localhost:4318/v1/traces";
+                break;
+            case "newrelic": {
+                const region = this.config.newrelicRegion ?? "us";
+                endpoint =
+                    this.config.newrelicEndpoint ||
+                        (region === "eu"
+                            ? "https://otlp.eu01.nr-data.net:4318/v1/traces"
+                            : "https://otlp.nr-data.net:4318/v1/traces");
+                break;
+            }
+            case "otlp":
+                endpoint = this.config.otlpEndpoint || "http://localhost:4318/v1/traces";
+                break;
+            default:
+                endpoint = "unknown";
+        }
+        return {
+            vendor: this.config.vendor,
+            endpoint,
+            initialized: this.initialized,
+        };
+    }
+}
+//# sourceMappingURL=APMIntegration.js.map

package/dist/integrations/APMIntegration.js.map

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