flowlint 0.3.1 → 0.3.3

package/dist/packages/review/utils.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXAMPLES_BASE_URL = void 0;
+exports.flattenConnections = flattenConnections;
+exports.buildValidationErrors = buildValidationErrors;
+exports.collectStrings = collectStrings;
+exports.toRegex = toRegex;
+exports.isApiNode = isApiNode;
+exports.isMutationNode = isMutationNode;
+exports.isErrorProneNode = isErrorProneNode;
+exports.isNotificationNode = isNotificationNode;
+exports.isErrorHandlerNode = isErrorHandlerNode;
+exports.isRejoinNode = isRejoinNode;
+exports.isMeaningfulConsumer = isMeaningfulConsumer;
+exports.containsCandidate = containsCandidate;
+exports.isTerminalNode = isTerminalNode;
+exports.readNumber = readNumber;
+exports.findAllDownstreamNodes = findAllDownstreamNodes;
+exports.findAllUpstreamNodes = findAllUpstreamNodes;
+exports.getExampleLink = getExampleLink;
+/**
+ * Shared utility functions for workflow parsing and validation
+ */
+/**
+ * Helper to flatten nested connection arrays from n8n workflow connections.
+ * Connections can be nested in various ways (arrays of arrays, objects with node properties).
+ * This recursively flattens them to a simple array of connection objects.
+ *
+ * @param value - The connection value to flatten (can be array, object, or primitive)
+ * @returns Array of connection objects with 'node' property
+ */
+function flattenConnections(value) {
+    if (!value)
+        return [];
+    if (Array.isArray(value)) {
+        return value.flatMap((entry) => flattenConnections(entry));
+    }
+    if (typeof value === 'object' && 'node' in value) {
+        return [value];
+    }
+    return [];
+}
+/**
+ * Build validation error objects from a collection of items using provided templates.
+ * This utility eliminates code duplication in validation error construction.
+ *
+ * @template T - Type of items to process
+ * @param items - Set or array of items to convert to validation errors
+ * @param errorConfig - Configuration object containing:
+ *   - path: The JSON path where the error occurred
+ *   - messageTemplate: Function to generate error message for each item
+ *   - suggestionTemplate: Function to generate actionable suggestion for each item
+ * @returns Array of validation error objects with path, message, and suggestion fields
+ *
+ * @example
+ * ```typescript
+ * const duplicates = new Set(['node1', 'node2']);
+ * const errors = buildValidationErrors(duplicates, {
+ *   path: 'nodes[].id',
+ *   messageTemplate: (id) => `Duplicate node ID: "${id}"`,
+ *   suggestionTemplate: (id) => `Remove or rename the duplicate node with ID "${id}".`
+ * });
+ * ```
+ */
+function buildValidationErrors(items, errorConfig) {
+    const itemArray = Array.isArray(items) ? items : Array.from(items);
+    return itemArray.map((item) => ({
+        path: errorConfig.path,
+        message: errorConfig.messageTemplate(item),
+        suggestion: errorConfig.suggestionTemplate(item),
+    }));
+}
+function collectStrings(value, out = []) {
+    if (typeof value === 'string')
+        out.push(value);
+    else if (Array.isArray(value))
+        value.forEach((entry) => collectStrings(entry, out));
+    else if (value && typeof value === 'object')
+        Object.values(value).forEach((entry) => collectStrings(entry, out));
+    return out;
+}
+function toRegex(pattern) {
+    let source = pattern;
+    let flags = '';
+    if (source.startsWith('(?i)')) {
+        source = source.slice(4);
+        flags += 'i';
+    }
+    return new RegExp(source, flags);
+}
+function isApiNode(type) {
+    return /http|request|google|facebook|ads/i.test(type);
+}
+function isMutationNode(type) {
+    return /write|insert|update|delete|post|put|patch|database|mongo|supabase|sheet/i.test(type);
+}
+function isErrorProneNode(type) {
+    return isApiNode(type) || isMutationNode(type) || /execute|workflow|function/i.test(type);
+}
+function isNotificationNode(type) {
+    return /slack|discord|email|gotify|mattermost|microsoftTeams|pushbullet|pushover|rocketchat|zulip|telegram/i.test(type);
+}
+function isErrorHandlerNode(type, name) {
+    const normalizedType = type.toLowerCase();
+    if (normalizedType.includes('stopanderror'))
+        return true;
+    if (normalizedType.includes('errorhandler'))
+        return true;
+    if (normalizedType.includes('raiseerror'))
+        return true;
+    const normalizedName = name?.toLowerCase() ?? '';
+    if (normalizedName.includes('stop and error'))
+        return true;
+    if (normalizedName.includes('error handler'))
+        return true;
+    return false;
+}
+function isRejoinNode(graph, nodeId) {
+    const incoming = graph.edges.filter((e) => e.to === nodeId);
+    if (incoming.length <= 1)
+        return false;
+    const hasErrorEdge = incoming.some((e) => e.on === 'error');
+    const hasSuccessEdge = incoming.some((e) => e.on !== 'error');
+    return hasErrorEdge && hasSuccessEdge;
+}
+function isMeaningfulConsumer(node) {
+    // A meaningful consumer is a node that has an external side-effect.
+    return (isMutationNode(node.type) || // Writes to a DB, sheet, etc.
+        isNotificationNode(node.type) || // Sends a message to Slack, email, etc.
+        isApiNode(node.type) || // Calls an external API
+        /respondToWebhook/i.test(node.type) // Specifically nodes that send a response back.
+    );
+}
+function containsCandidate(value, candidates) {
+    if (!value || !candidates.length)
+        return false;
+    const queue = [value];
+    const candidateRegex = new RegExp(`(${candidates.join('|')})`, 'i');
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (typeof current === 'string') {
+            if (candidateRegex.test(current))
+                return true;
+        }
+        else if (Array.isArray(current)) {
+            queue.push(...current);
+        }
+        else if (current && typeof current === 'object') {
+            for (const [key, val] of Object.entries(current)) {
+                if (candidateRegex.test(key))
+                    return true;
+                queue.push(val);
+            }
+        }
+    }
+    return false;
+}
+const TERMINAL_NODE_PATTERNS = [
+    'respond', 'reply', 'end', 'stop', 'terminate', 'return', 'sticky', 'note', 'noop', 'no operation',
+    'slack', 'email', 'discord', 'teams', 'webhook', 'telegram', 'pushbullet', 'mattermost', 'notifier', 'notification', 'alert', 'sms', 'call',
+];
+function isTerminalNode(type, name) {
+    const label = `${type} ${name ?? ''}`.toLowerCase();
+    return TERMINAL_NODE_PATTERNS.some((pattern) => label.includes(pattern));
+}
+function readNumber(source, paths) {
+    for (const path of paths) {
+        const value = path.split('.').reduce((acc, key) => (acc ? acc[key] : undefined), source);
+        if (typeof value === 'number')
+            return value;
+        if (typeof value === 'string' && !Number.isNaN(Number(value)))
+            return Number(value);
+    }
+    return undefined;
+}
+function findAllDownstreamNodes(graph, startNodeId) {
+    const visited = new Set();
+    const queue = [startNodeId];
+    visited.add(startNodeId);
+    let head = 0;
+    while (head < queue.length) {
+        const currentId = queue[head++];
+        const outgoing = graph.edges.filter((e) => e.from === currentId);
+        for (const edge of outgoing) {
+            if (!visited.has(edge.to)) {
+                visited.add(edge.to);
+                queue.push(edge.to);
+            }
+        }
+    }
+    return visited;
+}
+function findAllUpstreamNodes(graph, startNodeId) {
+    const visited = new Set();
+    const queue = [startNodeId];
+    visited.add(startNodeId);
+    let head = 0;
+    while (head < queue.length) {
+        const currentId = queue[head++];
+        const incoming = graph.edges.filter((e) => e.to === currentId);
+        for (const edge of incoming) {
+            if (!visited.has(edge.from)) {
+                visited.add(edge.from);
+                queue.push(edge.from);
+            }
+        }
+    }
+    return visited;
+}
+exports.EXAMPLES_BASE_URL = "https://github.com/Replikanti/flowlint/tree/main/flowlint-examples";
+function getExampleLink(ruleId) {
+    return `${exports.EXAMPLES_BASE_URL}/${ruleId}`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/packages/review/utils.js.map

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

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

@@ -0,0 +1,38 @@
+/**
+ * GitHub API tracing wrapper
+ * Instruments GitHub API calls with OpenTelemetry spans
+ */
+/**
+ * Wrap a GitHub API call with tracing
+ */
+export declare function traceGitHubApiCall<T>(method: string, endpoint: string, fn: () => Promise<T>, additionalAttributes?: Record<string, string | number | boolean>): Promise<T>;
+/**
+ * GitHub API call attributes for common operations
+ */
+export declare const GitHubApiAttributes: {
+    listFiles: (owner: string, repo: string, prNumber: number) => {
+        'github.repo.owner': string;
+        'github.repo.name': string;
+        'github.pr.number': number;
+        'github.api.operation': string;
+    };
+    getContent: (owner: string, repo: string, path: string, ref: string) => {
+        'github.repo.owner': string;
+        'github.repo.name': string;
+        'github.file.path': string;
+        'github.ref': string;
+        'github.api.operation': string;
+    };
+    createCheckRun: (owner: string, repo: string, sha: string) => {
+        'github.repo.owner': string;
+        'github.repo.name': string;
+        'github.commit.sha': string;
+        'github.api.operation': string;
+    };
+    updateCheckRun: (owner: string, repo: string, checkRunId: number) => {
+        'github.repo.owner': string;
+        'github.repo.name': string;
+        'github.check_run.id': number;
+        'github.api.operation': string;
+    };
+};

package/dist/packages/tracing/github-tracer.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * GitHub API tracing wrapper
+ * Instruments GitHub API calls with OpenTelemetry spans
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitHubApiAttributes = void 0;
+exports.traceGitHubApiCall = traceGitHubApiCall;
+const index_1 = require("./index");
+/**
+ * Wrap a GitHub API call with tracing
+ */
+async function traceGitHubApiCall(method, endpoint, fn, additionalAttributes) {
+    return (0, index_1.withClientSpan)(index_1.SpanNames.GITHUB_API_CALL, async (span) => {
+        span.setAttributes({
+            'github.api.method': method,
+            'github.api.endpoint': endpoint,
+            'http.method': method,
+            'http.url': endpoint,
+            ...additionalAttributes,
+        });
+        const startTime = Date.now();
+        try {
+            const result = await fn();
+            const duration = Date.now() - startTime;
+            span.setAttributes({
+                'github.api.duration_ms': duration,
+                'http.status_code': 200, // Assuming success
+            });
+            span.addEvent('github.api.call.success', {
+                duration_ms: duration,
+            });
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            span.setAttributes({
+                'github.api.duration_ms': duration,
+                'github.api.error': true,
+                'error.type': error instanceof Error ? error.constructor.name : 'UnknownError',
+            });
+            if (error instanceof Error) {
+                span.recordException(error);
+            }
+            throw error;
+        }
+    });
+}
+/**
+ * GitHub API call attributes for common operations
+ */
+exports.GitHubApiAttributes = {
+    listFiles: (owner, repo, prNumber) => ({
+        'github.repo.owner': owner,
+        'github.repo.name': repo,
+        'github.pr.number': prNumber,
+        'github.api.operation': 'list_pr_files',
+    }),
+    getContent: (owner, repo, path, ref) => ({
+        'github.repo.owner': owner,
+        'github.repo.name': repo,
+        'github.file.path': path,
+        'github.ref': ref,
+        'github.api.operation': 'get_content',
+    }),
+    createCheckRun: (owner, repo, sha) => ({
+        'github.repo.owner': owner,
+        'github.repo.name': repo,
+        'github.commit.sha': sha,
+        'github.api.operation': 'create_check_run',
+    }),
+    updateCheckRun: (owner, repo, checkRunId) => ({
+        'github.repo.owner': owner,
+        'github.repo.name': repo,
+        'github.check_run.id': checkRunId,
+        'github.api.operation': 'update_check_run',
+    }),
+};
+//# sourceMappingURL=github-tracer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-tracer.js","sourceRoot":"","sources":["../../../packages/tracing/github-tracer.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAQH,gDAkDC;AAxDD,mCAAoD;AAGpD;;GAEG;AACI,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,QAAgB,EAChB,EAAoB,EACpB,oBAAgE;IAEhE,OAAO,IAAA,sBAAc,EACnB,iBAAS,CAAC,eAAe,EACzB,KAAK,EAAE,IAAU,EAAE,EAAE;QACnB,IAAI,CAAC,aAAa,CAAC;YACjB,mBAAmB,EAAE,MAAM;YAC3B,qBAAqB,EAAE,QAAQ;YAC/B,aAAa,EAAE,MAAM;YACrB,UAAU,EAAE,QAAQ;YACpB,GAAG,oBAAoB;SACxB,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAExC,IAAI,CAAC,aAAa,CAAC;gBACjB,wBAAwB,EAAE,QAAQ;gBAClC,kBAAkB,EAAE,GAAG,EAAE,mBAAmB;aAC7C,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,yBAAyB,EAAE;gBACvC,WAAW,EAAE,QAAQ;aACtB,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAExC,IAAI,CAAC,aAAa,CAAC;gBACjB,wBAAwB,EAAE,QAAQ;gBAClC,kBAAkB,EAAE,IAAI;gBACxB,YAAY,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc;aAC/E,CAAC,CAAC;YAEH,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACU,QAAA,mBAAmB,GAAG;IACjC,SAAS,EAAE,CAAC,KAAa,EAAE,IAAY,EAAE,QAAgB,EAAE,EAAE,CAAC,CAAC;QAC7D,mBAAmB,EAAE,KAAK;QAC1B,kBAAkB,EAAE,IAAI;QACxB,kBAAkB,EAAE,QAAQ;QAC5B,sBAAsB,EAAE,eAAe;KACxC,CAAC;IAEF,UAAU,EAAE,CAAC,KAAa,EAAE,IAAY,EAAE,IAAY,EAAE,GAAW,EAAE,EAAE,CAAC,CAAC;QACvE,mBAAmB,EAAE,KAAK;QAC1B,kBAAkB,EAAE,IAAI;QACxB,kBAAkB,EAAE,IAAI;QACxB,YAAY,EAAE,GAAG;QACjB,sBAAsB,EAAE,aAAa;KACtC,CAAC;IAEF,cAAc,EAAE,CAAC,KAAa,EAAE,IAAY,EAAE,GAAW,EAAE,EAAE,CAAC,CAAC;QAC7D,mBAAmB,EAAE,KAAK;QAC1B,kBAAkB,EAAE,IAAI;QACxB,mBAAmB,EAAE,GAAG;QACxB,sBAAsB,EAAE,kBAAkB;KAC3C,CAAC;IAEF,cAAc,EAAE,CAAC,KAAa,EAAE,IAAY,EAAE,UAAkB,EAAE,EAAE,CAAC,CAAC;QACpE,mBAAmB,EAAE,KAAK;QAC1B,kBAAkB,EAAE,IAAI;QACxB,qBAAqB,EAAE,UAAU;QACjC,sBAAsB,EAAE,kBAAkB;KAC3C,CAAC;CACH,CAAC"}

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

@@ -0,0 +1,81 @@
+/**
+ * FlowLint Distributed Tracing Package
+ *
+ * Provides OpenTelemetry-based distributed tracing for FlowLint.
+ * Tracks request flow from webhook reception through job processing to Check Run creation.
+ *
+ * @module packages/tracing
+ */
+import { Tracer, Span, SpanStatusCode, Context, context, trace, propagation } from '@opentelemetry/api';
+/**
+ * Trace span names following OpenTelemetry semantic conventions
+ */
+export declare const SpanNames: {
+    readonly WEBHOOK_RECEIVED: "webhook.received";
+    readonly WEBHOOK_VERIFY_SIGNATURE: "webhook.verify_signature";
+    readonly JOB_ENQUEUED: "job.enqueued";
+    readonly JOB_PROCESSED: "job.processed";
+    readonly JOB_FETCH_FILES: "job.fetch_files";
+    readonly JOB_LOAD_CONFIG: "job.load_config";
+    readonly JOB_PARSE_WORKFLOW: "job.parse_workflow";
+    readonly JOB_RUN_RULES: "job.run_rules";
+    readonly JOB_CREATE_CHECK_RUN: "job.create_check_run";
+    readonly GITHUB_API_CALL: "github.api_call";
+    readonly LINT_RULE_EXECUTE: "lint.rule.execute";
+    readonly REDIS_OPERATION: "redis.operation";
+};
+/**
+ * Get the configured tracer instance
+ */
+export declare function getTracerInstance(): Tracer;
+/**
+ * Start a new span with the given name and attributes
+ */
+export declare function startSpan(name: string, attributes?: Record<string, string | number | boolean>, parentContext?: Context): Span;
+/**
+ * Start a server span (for incoming requests)
+ */
+export declare function startServerSpan(name: string, attributes?: Record<string, string | number | boolean>, parentContext?: Context): Span;
+/**
+ * Start a client span (for outgoing requests)
+ */
+export declare function startClientSpan(name: string, attributes?: Record<string, string | number | boolean>, parentContext?: Context): Span;
+/**
+ * Execute a function within a span context
+ */
+export declare function withSpan<T>(name: string, fn: (span: Span) => Promise<T>, attributes?: Record<string, string | number | boolean>, parentContext?: Context): Promise<T>;
+/**
+ * Execute a synchronous function within a span context
+ */
+export declare function withSpanSync<T>(name: string, fn: (span: Span) => T, attributes?: Record<string, string | number | boolean>, parentContext?: Context): T;
+/**
+ * Execute a function within a server span context (for incoming requests)
+ */
+export declare function withServerSpan<T>(name: string, fn: (span: Span) => Promise<T>, attributes?: Record<string, string | number | boolean>, parentContext?: Context): Promise<T>;
+/**
+ * Execute a function within a client span context (for outgoing requests)
+ */
+export declare function withClientSpan<T>(name: string, fn: (span: Span) => Promise<T>, attributes?: Record<string, string | number | boolean>, parentContext?: Context): Promise<T>;
+/**
+ * Add an event to the current active span
+ */
+export declare function addSpanEvent(name: string, attributes?: Record<string, string | number | boolean>): void;
+/**
+ * Set attributes on the current active span
+ */
+export declare function setSpanAttributes(attributes: Record<string, string | number | boolean>): void;
+/**
+ * Record an exception on the current active span
+ */
+export declare function recordSpanException(error: Error): void;
+/**
+ * Get the current active span
+ */
+export declare function getActiveSpan(): Span | undefined;
+/**
+ * Get the current trace context
+ */
+export declare function getActiveContext(): Context;
+export { Span, SpanStatusCode, Context, trace, context, propagation };
+export { initTracing, shutdownTracing } from './tracer';
+export { traceGitHubApiCall, GitHubApiAttributes } from './github-tracer';

package/dist/packages/tracing/index.js

@@ -0,0 +1,240 @@
+"use strict";
+/**
+ * FlowLint Distributed Tracing Package
+ *
+ * Provides OpenTelemetry-based distributed tracing for FlowLint.
+ * Tracks request flow from webhook reception through job processing to Check Run creation.
+ *
+ * @module packages/tracing
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitHubApiAttributes = exports.traceGitHubApiCall = exports.shutdownTracing = exports.initTracing = exports.propagation = exports.context = exports.trace = exports.SpanStatusCode = exports.SpanNames = void 0;
+exports.getTracerInstance = getTracerInstance;
+exports.startSpan = startSpan;
+exports.startServerSpan = startServerSpan;
+exports.startClientSpan = startClientSpan;
+exports.withSpan = withSpan;
+exports.withSpanSync = withSpanSync;
+exports.withServerSpan = withServerSpan;
+exports.withClientSpan = withClientSpan;
+exports.addSpanEvent = addSpanEvent;
+exports.setSpanAttributes = setSpanAttributes;
+exports.recordSpanException = recordSpanException;
+exports.getActiveSpan = getActiveSpan;
+exports.getActiveContext = getActiveContext;
+const api_1 = require("@opentelemetry/api");
+Object.defineProperty(exports, "SpanStatusCode", { enumerable: true, get: function () { return api_1.SpanStatusCode; } });
+Object.defineProperty(exports, "context", { enumerable: true, get: function () { return api_1.context; } });
+Object.defineProperty(exports, "trace", { enumerable: true, get: function () { return api_1.trace; } });
+Object.defineProperty(exports, "propagation", { enumerable: true, get: function () { return api_1.propagation; } });
+const tracer_1 = require("./tracer");
+/**
+ * Trace span names following OpenTelemetry semantic conventions
+ */
+exports.SpanNames = {
+    WEBHOOK_RECEIVED: 'webhook.received',
+    WEBHOOK_VERIFY_SIGNATURE: 'webhook.verify_signature',
+    JOB_ENQUEUED: 'job.enqueued',
+    JOB_PROCESSED: 'job.processed',
+    JOB_FETCH_FILES: 'job.fetch_files',
+    JOB_LOAD_CONFIG: 'job.load_config',
+    JOB_PARSE_WORKFLOW: 'job.parse_workflow',
+    JOB_RUN_RULES: 'job.run_rules',
+    JOB_CREATE_CHECK_RUN: 'job.create_check_run',
+    GITHUB_API_CALL: 'github.api_call',
+    LINT_RULE_EXECUTE: 'lint.rule.execute',
+    REDIS_OPERATION: 'redis.operation',
+};
+/**
+ * Get the configured tracer instance
+ */
+function getTracerInstance() {
+    return (0, tracer_1.getTracer)();
+}
+/**
+ * Start a new span with the given name and attributes
+ */
+function startSpan(name, attributes, parentContext) {
+    const tracer = (0, tracer_1.getTracer)();
+    const ctx = parentContext || api_1.context.active();
+    return tracer.startSpan(name, {
+        kind: api_1.SpanKind.INTERNAL,
+        attributes,
+    }, ctx);
+}
+/**
+ * Start a server span (for incoming requests)
+ */
+function startServerSpan(name, attributes, parentContext) {
+    const tracer = (0, tracer_1.getTracer)();
+    const ctx = parentContext || api_1.context.active();
+    return tracer.startSpan(name, {
+        kind: api_1.SpanKind.SERVER,
+        attributes,
+    }, ctx);
+}
+/**
+ * Start a client span (for outgoing requests)
+ */
+function startClientSpan(name, attributes, parentContext) {
+    const tracer = (0, tracer_1.getTracer)();
+    const ctx = parentContext || api_1.context.active();
+    return tracer.startSpan(name, {
+        kind: api_1.SpanKind.CLIENT,
+        attributes,
+    }, ctx);
+}
+/**
+ * Execute a function within a span context
+ */
+async function withSpan(name, fn, attributes, parentContext) {
+    const baseContext = parentContext || api_1.context.active();
+    const span = startSpan(name, attributes, parentContext);
+    const ctxWithSpan = api_1.trace.setSpan(baseContext, span);
+    try {
+        const result = await api_1.context.with(ctxWithSpan, () => fn(span));
+        span.setStatus({ code: api_1.SpanStatusCode.OK });
+        return result;
+    }
+    catch (error) {
+        span.setStatus({
+            code: api_1.SpanStatusCode.ERROR,
+            message: error instanceof Error ? error.message : 'Unknown error',
+        });
+        if (error instanceof Error) {
+            span.recordException(error);
+        }
+        throw error;
+    }
+    finally {
+        span.end();
+    }
+}
+/**
+ * Execute a synchronous function within a span context
+ */
+function withSpanSync(name, fn, attributes, parentContext) {
+    const baseContext = parentContext || api_1.context.active();
+    const span = startSpan(name, attributes, parentContext);
+    const ctxWithSpan = api_1.trace.setSpan(baseContext, span);
+    try {
+        const result = api_1.context.with(ctxWithSpan, () => fn(span));
+        span.setStatus({ code: api_1.SpanStatusCode.OK });
+        return result;
+    }
+    catch (error) {
+        span.setStatus({
+            code: api_1.SpanStatusCode.ERROR,
+            message: error instanceof Error ? error.message : 'Unknown error',
+        });
+        if (error instanceof Error) {
+            span.recordException(error);
+        }
+        throw error;
+    }
+    finally {
+        span.end();
+    }
+}
+/**
+ * Execute a function within a server span context (for incoming requests)
+ */
+async function withServerSpan(name, fn, attributes, parentContext) {
+    const baseContext = parentContext || api_1.context.active();
+    const span = startServerSpan(name, attributes, parentContext);
+    const ctxWithSpan = api_1.trace.setSpan(baseContext, span);
+    try {
+        const result = await api_1.context.with(ctxWithSpan, () => fn(span));
+        span.setStatus({ code: api_1.SpanStatusCode.OK });
+        return result;
+    }
+    catch (error) {
+        span.setStatus({
+            code: api_1.SpanStatusCode.ERROR,
+            message: error instanceof Error ? error.message : 'Unknown error',
+        });
+        if (error instanceof Error) {
+            span.recordException(error);
+        }
+        throw error;
+    }
+    finally {
+        span.end();
+    }
+}
+/**
+ * Execute a function within a client span context (for outgoing requests)
+ */
+async function withClientSpan(name, fn, attributes, parentContext) {
+    const baseContext = parentContext || api_1.context.active();
+    const span = startClientSpan(name, attributes, parentContext);
+    const ctxWithSpan = api_1.trace.setSpan(baseContext, span);
+    try {
+        const result = await api_1.context.with(ctxWithSpan, () => fn(span));
+        span.setStatus({ code: api_1.SpanStatusCode.OK });
+        return result;
+    }
+    catch (error) {
+        span.setStatus({
+            code: api_1.SpanStatusCode.ERROR,
+            message: error instanceof Error ? error.message : 'Unknown error',
+        });
+        if (error instanceof Error) {
+            span.recordException(error);
+        }
+        throw error;
+    }
+    finally {
+        span.end();
+    }
+}
+/**
+ * Add an event to the current active span
+ */
+function addSpanEvent(name, attributes) {
+    const span = api_1.trace.getActiveSpan();
+    if (span) {
+        span.addEvent(name, attributes);
+    }
+}
+/**
+ * Set attributes on the current active span
+ */
+function setSpanAttributes(attributes) {
+    const span = api_1.trace.getActiveSpan();
+    if (span) {
+        span.setAttributes(attributes);
+    }
+}
+/**
+ * Record an exception on the current active span
+ */
+function recordSpanException(error) {
+    const span = api_1.trace.getActiveSpan();
+    if (span) {
+        span.recordException(error);
+        span.setStatus({
+            code: api_1.SpanStatusCode.ERROR,
+            message: error.message,
+        });
+    }
+}
+/**
+ * Get the current active span
+ */
+function getActiveSpan() {
+    return api_1.trace.getActiveSpan();
+}
+/**
+ * Get the current trace context
+ */
+function getActiveContext() {
+    return api_1.context.active();
+}
+var tracer_2 = require("./tracer");
+Object.defineProperty(exports, "initTracing", { enumerable: true, get: function () { return tracer_2.initTracing; } });
+Object.defineProperty(exports, "shutdownTracing", { enumerable: true, get: function () { return tracer_2.shutdownTracing; } });
+var github_tracer_1 = require("./github-tracer");
+Object.defineProperty(exports, "traceGitHubApiCall", { enumerable: true, get: function () { return github_tracer_1.traceGitHubApiCall; } });
+Object.defineProperty(exports, "GitHubApiAttributes", { enumerable: true, get: function () { return github_tracer_1.GitHubApiAttributes; } });
+//# sourceMappingURL=index.js.map