flowlint 0.1.1

package/dist/packages/tracing/tracer.d.ts

@@ -0,0 +1,30 @@
+import { Span } from '@opentelemetry/api';
+import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';
+type AutoInstrumentationOptions = Parameters<typeof getNodeAutoInstrumentations>[0];
+/**
+ * Initialize OpenTelemetry tracing for FlowLint
+ */
+export declare function initTracing(options: {
+    serviceName: string;
+    serviceNamespace?: string;
+    serviceVersion?: string;
+    environment?: string;
+    exporter?: 'otlp-http' | 'otlp-grpc' | 'console' | 'none';
+    otlpEndpoint?: string;
+    otlpHeaders?: Record<string, string>;
+    otlpTimeoutMs?: number;
+    instrumentationOptions?: AutoInstrumentationOptions;
+}): Promise<void>;
+/**
+ * Shutdown OpenTelemetry
+ */
+export declare function shutdownTracing(): Promise<void>;
+/**
+ * Get tracer instance
+ */
+export declare function getTracer(): import("@opentelemetry/api").Tracer;
+/**
+ * Set custom span attributes (helper)
+ */
+export declare function setSpanAttributes(span: Span | undefined, attributes: Record<string, string | number | boolean>): void;
+export {};

package/dist/packages/tracing/tracer.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initTracing = initTracing;
+exports.shutdownTracing = shutdownTracing;
+exports.getTracer = getTracer;
+exports.setSpanAttributes = setSpanAttributes;
+const api_1 = require("@opentelemetry/api");
+const sdk_node_1 = require("@opentelemetry/sdk-node");
+const resources_1 = require("@opentelemetry/resources");
+const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
+const exporter_trace_otlp_http_1 = require("@opentelemetry/exporter-trace-otlp-http");
+const exporter_trace_otlp_grpc_1 = require("@opentelemetry/exporter-trace-otlp-grpc");
+const instrumentation_http_1 = require("@opentelemetry/instrumentation-http");
+const instrumentation_express_1 = require("@opentelemetry/instrumentation-express");
+const auto_instrumentations_node_1 = require("@opentelemetry/auto-instrumentations-node");
+const logger_1 = require("../logger");
+let sdk;
+let initPromise;
+const DEFAULT_SERVICE_VERSION = process.env.npm_package_version || '0.0.0';
+const DEFAULT_ENVIRONMENT = process.env.NODE_ENV || 'development';
+/**
+ * Initialize OpenTelemetry tracing for FlowLint
+ */
+function initTracing(options) {
+    if (initPromise) {
+        return initPromise;
+    }
+    api_1.diag.setLogger(new api_1.DiagConsoleLogger(), api_1.DiagLogLevel.ERROR);
+    const { serviceName, serviceNamespace, serviceVersion = DEFAULT_SERVICE_VERSION, environment = DEFAULT_ENVIRONMENT, exporter = process.env.OTEL_EXPORTER || 'otlp-http', otlpEndpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT, otlpHeaders = parseHeaders(process.env.OTEL_EXPORTER_OTLP_HEADERS), otlpTimeoutMs = process.env.OTEL_EXPORTER_OTLP_TIMEOUT ? Number(process.env.OTEL_EXPORTER_OTLP_TIMEOUT) : undefined, instrumentationOptions = {}, } = options;
+    const resource = (0, resources_1.resourceFromAttributes)({
+        [semantic_conventions_1.ATTR_SERVICE_NAME]: serviceName,
+        [semantic_conventions_1.ATTR_SERVICE_VERSION]: serviceVersion,
+        'service.namespace': serviceNamespace || 'flowlint',
+        'deployment.environment': environment,
+    });
+    const instrumentations = [
+        new instrumentation_http_1.HttpInstrumentation({
+            ignoreIncomingRequestHook: (req) => {
+                const path = req.url || '';
+                return ['/metrics', '/livez', '/readyz', '/healthz', '/openapi.json', '/api-docs'].some((ignorePath) => path.startsWith(ignorePath));
+            },
+        }),
+        new instrumentation_express_1.ExpressInstrumentation(),
+    ];
+    const autoInstrumentations = (0, auto_instrumentations_node_1.getNodeAutoInstrumentations)({
+        '@opentelemetry/instrumentation-fs': { enabled: false },
+        ...instrumentationOptions,
+    });
+    const exporters = createExporter({ exporter, otlpEndpoint, otlpHeaders, otlpTimeoutMs });
+    sdk = new sdk_node_1.NodeSDK({
+        resource,
+        traceExporter: exporters.traceExporter,
+        instrumentations: [...instrumentations, ...Object.values(autoInstrumentations)],
+    });
+    initPromise = (async () => {
+        await sdk.start();
+        logger_1.logger.info({ serviceName }, 'OpenTelemetry tracing initialized');
+    })().catch((error) => {
+        logger_1.logger.error({ error }, 'failed to initialize OpenTelemetry tracing');
+    });
+    return initPromise;
+}
+/**
+ * Shutdown OpenTelemetry
+ */
+async function shutdownTracing() {
+    if (!sdk) {
+        return;
+    }
+    try {
+        await sdk.shutdown();
+        logger_1.logger.info('OpenTelemetry tracing shut down');
+    }
+    catch (error) {
+        logger_1.logger.error({ error }, 'failed to shut down OpenTelemetry');
+    }
+    finally {
+        sdk = undefined;
+        initPromise = undefined;
+    }
+}
+/**
+ * Get tracer instance
+ */
+function getTracer() {
+    return api_1.trace.getTracer('flowlint');
+}
+/**
+ * Set custom span attributes (helper)
+ */
+function setSpanAttributes(span, attributes) {
+    if (!span) {
+        return;
+    }
+    span.setAttributes(attributes);
+}
+function parseHeaders(headersInput) {
+    if (!headersInput) {
+        return {};
+    }
+    try {
+        const entries = headersInput.split(',').map((entry) => {
+            const [key, value] = entry.split('=').map((item) => item.trim());
+            return [key, value];
+        });
+        return Object.fromEntries(entries);
+    }
+    catch (error) {
+        logger_1.logger.warn({ error }, 'failed to parse OTLP headers');
+        return {};
+    }
+}
+function createExporter(options) {
+    const { exporter, otlpEndpoint, otlpHeaders, otlpTimeoutMs } = options;
+    switch (exporter) {
+        case 'otlp-http':
+            return {
+                traceExporter: new exporter_trace_otlp_http_1.OTLPTraceExporter({
+                    url: otlpEndpoint,
+                    headers: otlpHeaders,
+                    timeoutMillis: otlpTimeoutMs,
+                }),
+            };
+        case 'otlp-grpc':
+            return {
+                traceExporter: new exporter_trace_otlp_grpc_1.OTLPTraceExporter({
+                    url: otlpEndpoint,
+                }),
+            };
+        case 'console':
+            return {
+                traceExporter: undefined,
+            };
+        case 'none':
+        default:
+            return {
+                traceExporter: undefined,
+            };
+    }
+}
+//# sourceMappingURL=tracer.js.map

package/dist/packages/tracing/tracer.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "flowlint",
+  "version": "0.1.1",
+  "description": "FlowLint CLI - Static analysis for n8n workflows",
+  "license": "MIT",
+  "type": "commonjs",
+  "bin": {
+    "flowlint": "dist/apps/cli/src/cli.js"
+  },
+  "scripts": {
+    "prepublishOnly": "node ../../scripts/prepare-cli-publish.js"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Replikanti/flowlint.git",
+    "directory": "packages/cli"
+  },
+  "keywords": [
+    "n8n",
+    "workflow",
+    "linter",
+    "static-analysis",
+    "cli"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "glob": "^10.3.10",
+    "yaml": "^2.4.0",
+    "ajv": "^8.17.1",
+    "ajv-draft-04": "^1.0.0",
+    "ajv-formats": "^3.0.1",
+    "micromatch": "^4.0.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.4.0"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ]
+}