@blokjs/runner 0.6.21 → 0.7.0

package/dist/integrations/SentryIntegration.js

@@ -1,200 +0,0 @@
-/**
- * Sentry Error Tracking Integration for Blok
- *
- * Provides error tracking and performance monitoring via Sentry.
- * Captures workflow execution errors, node failures, and trigger issues
- * with full context (workflow name, node, request ID, etc.).
- *
- * Uses a lightweight adapter pattern so Sentry SDK is loaded lazily
- * and the framework doesn't hard-depend on @sentry/node.
- *
- * @example
- * ```typescript
- * import { SentryIntegration } from "@blokjs/runner";
- *
- * const sentry = new SentryIntegration({
- *   dsn: process.env.SENTRY_DSN!,
- *   environment: process.env.NODE_ENV || "development",
- *   release: "blok@1.0.0",
- *   tracesSampleRate: 0.1,
- * });
- *
- * await sentry.init();
- *
- * // In error handler
- * sentry.captureWorkflowError(error, {
- *   workflowName: "get-user",
- *   workflowPath: "/users/:id",
- *   requestId: ctx.id,
- * });
- * ```
- */
-export class SentryIntegration {
-    config;
-    client = null;
-    initialized = false;
-    eventCount = 0;
-    errorCount = 0;
-    constructor(config) {
-        this.config = {
-            environment: process.env.NODE_ENV || "development",
-            sampleRate: 1.0,
-            tracesSampleRate: 0.1,
-            debug: false,
-            ...config,
-        };
-    }
-    /**
-     * Initialize Sentry SDK (lazy-loads @sentry/node)
-     */
-    async init() {
-        if (this.initialized)
-            return true;
-        try {
-            // Dynamic import to avoid hard dependency — @sentry/node is optional
-            // @ts-expect-error: @sentry/node types not installed; loaded lazily at runtime
-            const Sentry = await import("@sentry/node");
-            Sentry.init({
-                dsn: this.config.dsn,
-                environment: this.config.environment,
-                release: this.config.release,
-                serverName: this.config.serverName,
-                sampleRate: this.config.sampleRate,
-                tracesSampleRate: this.config.tracesSampleRate,
-                debug: this.config.debug,
-            });
-            // Set global tags
-            if (this.config.tags) {
-                for (const [key, value] of Object.entries(this.config.tags)) {
-                    Sentry.setTag(key, value);
-                }
-            }
-            Sentry.setTag("framework", "blok");
-            // Create adapter
-            this.client = {
-                captureException: (error, context) => {
-                    return Sentry.captureException(error, {
-                        extra: context,
-                    });
-                },
-                captureMessage: (message, level) => {
-                    return Sentry.captureMessage(message, level);
-                },
-                setTag: (key, value) => Sentry.setTag(key, value),
-                setUser: (user) => Sentry.setUser(user),
-                startTransaction: (context) => {
-                    return Sentry.startSpan(context, (span) => span);
-                },
-                flush: (timeout) => Sentry.flush(timeout),
-            };
-            this.initialized = true;
-            return true;
-        }
-        catch {
-            // @sentry/node not installed - that's OK, fail silently
-            this.initialized = false;
-            return false;
-        }
-    }
-    /**
-     * Set a custom Sentry client (useful for testing)
-     */
-    setClient(client) {
-        this.client = client;
-        this.initialized = true;
-    }
-    /**
-     * Capture a workflow execution error
-     */
-    captureWorkflowError(error, context) {
-        if (!this.client)
-            return null;
-        this.errorCount++;
-        this.eventCount++;
-        const eventId = this.client.captureException(error, {
-            workflow_name: context.workflowName,
-            workflow_path: context.workflowPath,
-            workflow_version: context.workflowVersion,
-            request_id: context.requestId,
-            node_name: context.nodeName,
-            node_type: context.nodeType,
-            trigger_type: context.triggerType,
-            duration_ms: context.durationMs,
-        });
-        return eventId;
-    }
-    /**
-     * Capture a node execution error
-     */
-    captureNodeError(error, nodeName, nodeType, context) {
-        if (!this.client)
-            return null;
-        this.errorCount++;
-        this.eventCount++;
-        return this.client.captureException(error, {
-            node_name: nodeName,
-            node_type: nodeType,
-            workflow_name: context?.workflowName,
-            request_id: context?.requestId,
-        });
-    }
-    /**
-     * Capture a trigger error
-     */
-    captureTriggerError(error, triggerType, context) {
-        if (!this.client)
-            return null;
-        this.errorCount++;
-        this.eventCount++;
-        return this.client.captureException(error, {
-            trigger_type: triggerType,
-            ...context,
-        });
-    }
-    /**
-     * Capture a warning message
-     */
-    captureWarning(message, context) {
-        if (!this.client)
-            return null;
-        this.eventCount++;
-        return this.client.captureMessage(context ? `${message} | ${JSON.stringify(context)}` : message, "warning");
-    }
-    /**
-     * Set current user context
-     */
-    setUser(user) {
-        this.client?.setUser(user);
-    }
-    /**
-     * Add a tag to all future events
-     */
-    setTag(key, value) {
-        this.client?.setTag(key, value);
-    }
-    /**
-     * Flush pending events to Sentry
-     */
-    async flush(timeoutMs = 2000) {
-        if (!this.client)
-            return true;
-        return this.client.flush(timeoutMs);
-    }
-    /**
-     * Check if Sentry is initialized
-     */
-    isInitialized() {
-        return this.initialized;
-    }
-    /**
-     * Get stats about captured events
-     */
-    getStats() {
-        return {
-            initialized: this.initialized,
-            eventCount: this.eventCount,
-            errorCount: this.errorCount,
-        };
-    }
-}
-//# sourceMappingURL=SentryIntegration.js.map

package/dist/integrations/SentryIntegration.js.map

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

package/dist/integrations/index.d.ts

@@ -1,19 +0,0 @@
-/**
- * External Integrations for Blok Framework
- *
- * Provides integrations with third-party services:
- * - Sentry: Error tracking and performance monitoring
- * - APM: DataDog, New Relic, and generic OTLP backends
- * - CloudWatch: AWS CloudWatch metrics, logs, and traces (via ADOT → X-Ray)
- * - Azure Monitor: Azure Application Insights traces, metrics, and events
- *
- * All integrations use lazy-loading to avoid hard dependencies.
- */
-export { SentryIntegration } from "./SentryIntegration";
-export type { SentryConfig, WorkflowErrorContext, SentryClient, SentryTransaction, SentrySpan, } from "./SentryIntegration";
-export { APMIntegration } from "./APMIntegration";
-export type { APMVendor, APMConfig, APMBootstrapResult, } from "./APMIntegration";
-export { CloudWatchIntegration } from "./CloudWatchIntegration";
-export type { CloudWatchConfig, CloudWatchUnit, CloudWatchLogEntry, CloudWatchStats, } from "./CloudWatchIntegration";
-export { AzureMonitorIntegration } from "./AzureMonitorIntegration";
-export type { AzureMonitorConfig, AzureMonitorStats, } from "./AzureMonitorIntegration";

package/dist/integrations/index.js

@@ -1,16 +0,0 @@
-/**
- * External Integrations for Blok Framework
- *
- * Provides integrations with third-party services:
- * - Sentry: Error tracking and performance monitoring
- * - APM: DataDog, New Relic, and generic OTLP backends
- * - CloudWatch: AWS CloudWatch metrics, logs, and traces (via ADOT → X-Ray)
- * - Azure Monitor: Azure Application Insights traces, metrics, and events
- *
- * All integrations use lazy-loading to avoid hard dependencies.
- */
-export { SentryIntegration } from "./SentryIntegration";
-export { APMIntegration } from "./APMIntegration";
-export { CloudWatchIntegration } from "./CloudWatchIntegration";
-export { AzureMonitorIntegration } from "./AzureMonitorIntegration";
-//# sourceMappingURL=index.js.map

package/dist/integrations/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AASxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAOlD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAQhE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/marketplace/RuntimeAutoScaler.d.ts

@@ -1,148 +0,0 @@
-/**
- * RuntimeAutoScaler - Automatic Container Pool Scaling for Blok Runtimes
- *
- * Monitors runtime execution load and automatically adjusts Docker container
- * pool sizes based on configurable scaling policies. Tracks metrics like RPS,
- * p95 latency, and CPU utilization to make informed scaling decisions.
- *
- * Follows patterns from DockerRuntimeAdapter (pool management, health checks)
- * and TriggerMetricsCollector (metrics tracking, percentile calculations).
- */
-import type { RuntimeKind } from "../adapters/RuntimeAdapter";
-import type { RuntimeMetricsDashboard } from "./RuntimeMetricsDashboard";
-export interface ScalingPolicy {
-    runtime: RuntimeKind;
-    minInstances: number;
-    maxInstances: number;
-    targetCpuUtilization: number;
-    targetLatencyMs: number;
-    targetRps: number;
-    scaleUpCooldownMs: number;
-    scaleDownCooldownMs: number;
-    scaleUpStep: number;
-    scaleDownStep: number;
-}
-export interface ScalingMetrics {
-    currentRps: number;
-    currentLatencyP95: number;
-    currentCpuUtilization: number;
-    instanceUtilization: number;
-}
-export interface ScalingDecision {
-    runtime: RuntimeKind;
-    action: "scale_up" | "scale_down" | "no_change";
-    currentInstances: number;
-    desiredInstances: number;
-    reason: string;
-    timestamp: number;
-    metrics: ScalingMetrics;
-}
-export interface ScalingHistory {
-    decisions: ScalingDecision[];
-    scaleUpCount: number;
-    scaleDownCount: number;
-    lastScaleUp: number;
-    lastScaleDown: number;
-}
-export interface AutoScalerConfig {
-    evaluationIntervalMs: number;
-    enabled: boolean;
-    dryRun: boolean;
-}
-export type ScalingListener = (decision: ScalingDecision) => void;
-/**
- * RuntimeAutoScaler monitors runtime execution load and automatically
- * adjusts Docker container pool sizes based on scaling policies.
- *
- * It periodically evaluates metrics from the RuntimeMetricsDashboard and
- * produces ScalingDecisions that indicate whether to scale up, scale down,
- * or maintain the current number of instances.
- */
-export declare class RuntimeAutoScaler {
-    private policies;
-    private history;
-    private listeners;
-    private interval;
-    private dashboard;
-    private config;
-    constructor(dashboard: RuntimeMetricsDashboard, config?: Partial<AutoScalerConfig>);
-    /**
-     * Set a scaling policy for a runtime.
-     * Merges provided values with defaults.
-     */
-    setPolicy(policy: ScalingPolicy): void;
-    /**
-     * Get the scaling policy for a runtime.
-     */
-    getPolicy(runtime: RuntimeKind): ScalingPolicy | undefined;
-    /**
-     * Remove the scaling policy for a runtime.
-     */
-    removePolicy(runtime: RuntimeKind): void;
-    /**
-     * Begin periodic evaluation of all runtime scaling policies.
-     */
-    start(): void;
-    /**
-     * Stop periodic evaluation.
-     */
-    stop(): void;
-    /**
-     * Evaluate a single runtime against its scaling policy.
-     *
-     * The evaluation logic:
-     * 1. Get current metrics from RuntimeMetricsDashboard
-     * 2. Get the scaling policy for this runtime
-     * 3. Check cooldown periods (don't scale too frequently)
-     * 4. Determine desired instances based on RPS, latency, and CPU thresholds
-     * 5. Clamp desired between minInstances and maxInstances
-     * 6. Create ScalingDecision with descriptive reason
-     * 7. Record in history and notify listeners
-     */
-    evaluate(runtime: RuntimeKind): ScalingDecision;
-    /**
-     * Evaluate all runtimes that have scaling policies.
-     */
-    evaluateAll(): ScalingDecision[];
-    /**
-     * Get the scaling history for a runtime.
-     */
-    getHistory(runtime: RuntimeKind): ScalingHistory | undefined;
-    /**
-     * Get scaling history for all runtimes.
-     */
-    getAllHistory(): Map<RuntimeKind, ScalingHistory>;
-    /**
-     * Subscribe to scaling decisions. Returns an unsubscribe function.
-     */
-    onScalingDecision(listener: ScalingListener): () => void;
-    /**
-     * Suggest a scaling policy based on current runtime metrics.
-     * Uses observed metrics to derive sensible defaults.
-     */
-    getRecommendedPolicy(runtime: RuntimeKind): ScalingPolicy;
-    /**
-     * Clear all history, policies, and state.
-     */
-    reset(): void;
-    /**
-     * Collect current scaling metrics from the RuntimeMetricsDashboard.
-     */
-    private collectMetrics;
-    /**
-     * Create a no-change decision with the given reason.
-     */
-    private createNoChangeDecision;
-    /**
-     * Get or create history entry for a runtime.
-     */
-    private getOrCreateHistory;
-    /**
-     * Record a scaling decision in the history.
-     */
-    private recordDecision;
-    /**
-     * Notify all registered listeners of a scaling decision.
-     */
-    private notifyListeners;
-}