@siglo/opentelemetry 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Jerico de guzman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,180 @@
-# Temporary Holding Version
+# @siglo/opentelemetry Adapter Guide
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`@siglo/opentelemetry` provides vendor-neutral distributed tracing, semantic spans, context event streaming, and W3C Trace Context propagation for `Siglo` workflows. It is fully compliant with the OpenTelemetry API (`@opentelemetry/api` v1.9.0+) and integrates seamlessly with collectors like Jaeger, Zipkin, Datadog, Prometheus, New Relic, and AWS X-Ray.
+
+---
+
+## 1. Overview & Architecture
+
+The OpenTelemetry integration creates an end-to-end distributed span hierarchy covering workflows, steps, retries, and context mutations:
+
+```mermaid
+flowchart TD
+    Req["Incoming HTTP / Kafka / SQS Request<br/>(with W3C traceparent)"] -->|extractTraceContext()| WFSpan["Span: workflow:CheckoutPipeline<br/>• siglo.workflow.name = 'CheckoutPipeline'<br/>• siglo.workflow.version = '2.1.0'<br/>• siglo.stack.id = 'stack_9812_01'<br/>• siglo.namespace = 'ecommerce-us'<br/>• siglo.timeout = 30000"]
+    WFSpan --> Step1["Span: step:validateCart<br/>• siglo.step.name = ...<br/>• siglo.step.attempt = 1<br/>• Status: OK"]
+    WFSpan --> Step2["Span: step:chargeCard<br/>• siglo.step.attempt = 1<br/>• (Failure: recordException)"]
+    Step2 -->|Retry| Step2Retry["Span: step:chargeCard (retry #2)<br/>• siglo.step.attempt = 2<br/>• Status: OK"]
+```
+
+---
+
+## 2. Installation & Requirements
+
+Install `@siglo/opentelemetry` and the OpenTelemetry API:
+
+```bash
+npm install @siglo/core @siglo/opentelemetry @opentelemetry/api
+```
+
+Recommended OpenTelemetry SDK packages for Node.js:
+```bash
+npm install --save-dev @opentelemetry/sdk-node @opentelemetry/sdk-trace-node @opentelemetry/exporter-trace-otlp-grpc
+```
+
+---
+
+## 3. Semantic Attributes Reference
+
+`SemanticAttributes` defines standardized OpenTelemetry attribute keys:
+
+| Attribute Constant | String Key | Type | Description |
+| :--- | :--- | :--- | :--- |
+| `WORKFLOW_NAME` | `siglo.workflow.name` | `string` | Canonical name of the executing workflow. |
+| `WORKFLOW_VERSION` | `siglo.workflow.version` | `string` | Semantic version string of the workflow. |
+| `WORKFLOW_ID` | `siglo.workflow.id` | `string` | Unique workflow identifier. |
+| `STACK_ID` | `siglo.stack.id` | `string` | Unique stack execution identifier. |
+| `STEP_NAME` | `siglo.step.name` | `string` | Name or debug label of the active step. |
+| `STEP_ID` | `siglo.step.id` | `string` | Internal node identifier in the workflow graph AST. |
+| `STEP_ATTEMPT` | `siglo.step.attempt` | `number` | 1-based attempt count (incremented on retries). |
+| `NAMESPACE` | `siglo.namespace` | `string` | Tenant namespace partition (requires `allowNamespace: true`). |
+| `CACHE_HIT` | `siglo.cache.hit` | `boolean` | `true` if step result was served from cache. |
+| `TIMEOUT` | `siglo.timeout` | `number` | Configured timeout in milliseconds. |
+
+---
+
+## 4. API Reference
+
+### `instrumentWorkflow(workflow, options)`
+
+Instruments a `Flow` instance with a root span, sets execution attributes, and automatically instruments all child steps:
+
+```typescript
+function instrumentWorkflow<TInput = any, TOutput = any>(
+    workflow: Flow<TInput, TOutput>,
+    options?: SigloTelemetryOptions
+): Flow<TInput, TOutput>;
+```
+
+#### Options (`SigloTelemetryOptions`):
+- `tracer` (`Tracer`): Custom OpenTelemetry `Tracer` instance. If omitted, uses `trace.getTracer('@siglo/opentelemetry', '1.0.0')`.
+- `serviceName` (`string`): Tracer service name identifier.
+- `workflowName` (`string`): Override workflow span label.
+- `workflowVersion` (`string`): Workflow version (default: `'1.0.0'`).
+- `allowNamespace` (`boolean`): If `true`, injects `siglo.namespace` into span attributes. Default `false` to prevent accidental namespace leakage.
+- `allowContextFields` (`string[]`): Whitelist of step context mutation keys that are allowed to be recorded as span attributes.
+- `redactHook` (`(key: string, value: unknown) => unknown`): Sanitizer hook to scrub sensitive or PII data before recording attributes.
+
+---
+
+### `instrumentStep(step, options)`
+
+Wraps an individual `Step` with a child span covering step execution, attempt count tracking, status reporting, and exception capturing:
+
+```typescript
+function instrumentStep<TInput = any, TOutput = any>(
+    step: Step<TInput, TOutput>,
+    options?: SigloTelemetryOptions
+): Step<TInput, TOutput>;
+```
+
+---
+
+### `createTelemetryStorageAdapter(options)`
+
+Creates a `StorageAdapter` that transforms context changes into OpenTelemetry span attributes:
+
+```typescript
+function createTelemetryStorageAdapter(options?: SigloTelemetryOptions): StorageAdapter;
+```
+
+#### Security & PII Protection:
+By default, **no context fields are streamed to OpenTelemetry spans**. Only fields explicitly declared in `allowContextFields` are emitted as `siglo.context.<field>`, and all values pass through `redactHook` if configured.
+
+---
+
+### W3C Distributed Context Propagation Helpers
+
+- **`injectTraceContext(carrier, ctx?)`**: Injects active OpenTelemetry span context into headers or metadata dictionaries.
+- **`extractTraceContext(carrier, ctx?)`**: Extracts OpenTelemetry `Context` from HTTP headers or Kafka message headers.
+- **`getTraceHeaders(span?)`**: Returns `{ traceparent: string, tracestate?: string }` from the active or supplied span.
+
+---
+
+## 5. Complete Production Instrumentation Example
+
+```typescript
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-grpc';
+import { trace } from '@opentelemetry/api';
+import { Step, flow } from '@siglo/core';
+import {
+    instrumentWorkflow,
+    createTelemetryStorageAdapter,
+    getTraceHeaders
+} from '@siglo/opentelemetry';
+
+// 1. Initialize OpenTelemetry SDK
+const sdk = new NodeSDK({
+    traceExporter: new OTLPTraceExporter({ url: 'http://localhost:4317' }),
+    serviceName: 'order-service',
+});
+sdk.start();
+
+const tracer = trace.getTracer('order-service', '1.0.0');
+
+// 2. Configure Storage Adapter with PII Sanitization
+const telemetryStorage = createTelemetryStorageAdapter({
+    allowContextFields: ['orderId', 'orderStatus', 'cardLast4', 'totalAmount'],
+    redactHook: (key, val) => {
+        if (key === 'cardLast4') {
+            return `****${String(val).slice(-4)}`;
+        }
+        return val;
+    },
+});
+Step.useStorage(telemetryStorage);
+
+// 3. Define Workflow Steps with Retry
+const validateOrder = Step.create('validateOrder', async (input: any) => {
+    return { orderId: input.orderId, validated: true };
+});
+
+const chargePayment = Step.create('chargePayment', async (param: any) => {
+    // Simulate transient failure on first attempt
+    if (param.$attempt && param.$attempt() === 0) {
+        throw new Error('Temporary payment gateway blip');
+    }
+    return { paymentStatus: 'CHARGED', cardLast4: '4242' };
+})
+    .retry({ maxRetries: 2, delayMs: 100 })
+    ;
+
+const orderWorkflow = flow(validateOrder, chargePayment);
+
+// 4. Instrument Workflow
+const monitoredWorkflow = instrumentWorkflow(orderWorkflow, {
+    tracer,
+    workflowName: 'CustomerOrderProcessing',
+    workflowVersion: '2.4.0',
+    allowNamespace: true,
+});
+
+// 5. Run Monitored Workflow
+const result = await monitoredWorkflow.run(
+    { orderId: 'ORD-7718', totalAmount: 89.5 },
+    { namespace: 'tenant-emea' }
+);
+
+console.log('Workflow finished with Stack ID:', result.$stackId());
+console.log('Outgoing W3C Headers for downstreams:', getTraceHeaders());
+```

package/dist/attributes.d.ts

@@ -0,0 +1,14 @@
+export declare const SemanticAttributes: {
+    readonly WORKFLOW_NAME: "siglo.workflow.name";
+    readonly WORKFLOW_VERSION: "siglo.workflow.version";
+    readonly WORKFLOW_ID: "siglo.workflow.id";
+    readonly STACK_ID: "siglo.stack.id";
+    readonly STEP_NAME: "siglo.step.name";
+    readonly STEP_ID: "siglo.step.id";
+    readonly STEP_ATTEMPT: "siglo.step.attempt";
+    readonly NAMESPACE: "siglo.namespace";
+    readonly CACHE_HIT: "siglo.cache.hit";
+    readonly TIMEOUT: "siglo.timeout";
+};
+export type SemanticAttributeKey = (typeof SemanticAttributes)[keyof typeof SemanticAttributes];
+//# sourceMappingURL=attributes.d.ts.map

package/dist/attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../src/attributes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB;;;;;;;;;;;CAWrB,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/attributes.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SemanticAttributes = void 0;
+exports.SemanticAttributes = {
+    WORKFLOW_NAME: 'siglo.workflow.name',
+    WORKFLOW_VERSION: 'siglo.workflow.version',
+    WORKFLOW_ID: 'siglo.workflow.id',
+    STACK_ID: 'siglo.stack.id',
+    STEP_NAME: 'siglo.step.name',
+    STEP_ID: 'siglo.step.id',
+    STEP_ATTEMPT: 'siglo.step.attempt',
+    NAMESPACE: 'siglo.namespace',
+    CACHE_HIT: 'siglo.cache.hit',
+    TIMEOUT: 'siglo.timeout',
+};
+//# sourceMappingURL=attributes.js.map

package/dist/attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.js","sourceRoot":"","sources":["../src/attributes.ts"],"names":[],"mappings":";;;AAAa,QAAA,kBAAkB,GAAG;IAC9B,aAAa,EAAE,qBAAqB;IACpC,gBAAgB,EAAE,wBAAwB;IAC1C,WAAW,EAAE,mBAAmB;IAChC,QAAQ,EAAE,gBAAgB;IAC1B,SAAS,EAAE,iBAAiB;IAC5B,OAAO,EAAE,eAAe;IACxB,YAAY,EAAE,oBAAoB;IAClC,SAAS,EAAE,iBAAiB;IAC5B,SAAS,EAAE,iBAAiB;IAC5B,OAAO,EAAE,eAAe;CAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './attributes';
+export * from './types';
+export * from './w3c';
+export * from './instrument';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./attributes"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./w3c"), exports);
+__exportStar(require("./instrument"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,0CAAwB;AACxB,wCAAsB;AACtB,+CAA6B"}

package/dist/instrument.d.ts

@@ -0,0 +1,21 @@
+import { Tracer } from '@opentelemetry/api';
+import { Flow, Step, StorageAdapter } from '@siglo/core';
+import { SigloTelemetryOptions } from './types';
+/**
+ * Returns an OpenTelemetry tracer based on configuration.
+ */
+export declare function getTracer(options?: SigloTelemetryOptions): Tracer;
+/**
+ * Creates a StorageAdapter that streams allowed, sanitized context changes to active telemetry spans.
+ */
+export declare function createTelemetryStorageAdapter(options?: SigloTelemetryOptions): StorageAdapter;
+/**
+ * Instruments an individual Step with an OpenTelemetry child span covering action execution,
+ * attempt counting, and error recording.
+ */
+export declare function instrumentStep<TInput = any, TOutput = any>(step: Step<TInput, TOutput>, options?: SigloTelemetryOptions): Step<TInput, TOutput>;
+/**
+ * Wraps a Flow execution with end-to-end OpenTelemetry spans and instruments child steps.
+ */
+export declare function instrumentWorkflow<TInput = any, TOutput = any>(workflow: Flow<TInput, TOutput>, options?: SigloTelemetryOptions): Flow<TInput, TOutput>;
+//# sourceMappingURL=instrument.d.ts.map

package/dist/instrument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrument.d.ts","sourceRoot":"","sources":["../src/instrument.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,MAAM,EACT,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,IAAI,EACJ,IAAI,EACJ,cAAc,EACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAKhD;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAEjE;AAaD;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CAsBjG;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EACtD,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,OAAO,GAAE,qBAA0B,GACpC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAqDvB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EAC1D,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,GAAE,qBAA0B,GACpC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CA0DvB"}

package/dist/instrument.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTracer = getTracer;
+exports.createTelemetryStorageAdapter = createTelemetryStorageAdapter;
+exports.instrumentStep = instrumentStep;
+exports.instrumentWorkflow = instrumentWorkflow;
+const api_1 = require("@opentelemetry/api");
+const attributes_1 = require("./attributes");
+const DEFAULT_TRACER_NAME = '@siglo/opentelemetry';
+const DEFAULT_TRACER_VERSION = '1.0.0';
+/**
+ * Returns an OpenTelemetry tracer based on configuration.
+ */
+function getTracer(options) {
+    return options?.tracer || api_1.trace.getTracer(options?.serviceName || DEFAULT_TRACER_NAME, DEFAULT_TRACER_VERSION);
+}
+function resolveValue(valOrFn) {
+    if (typeof valOrFn === 'function') {
+        try {
+            return valOrFn();
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return valOrFn;
+}
+/**
+ * Creates a StorageAdapter that streams allowed, sanitized context changes to active telemetry spans.
+ */
+function createTelemetryStorageAdapter(options = {}) {
+    return {
+        name: 'opentelemetry',
+        onContextChange(entry) {
+            if (!options.allowContextFields || !options.allowContextFields.includes(entry.field)) {
+                return; // Omit by default to protect secrets and full context
+            }
+            const activeSpan = api_1.trace.getActiveSpan();
+            if (activeSpan) {
+                let val = entry.value;
+                if (options.redactHook) {
+                    val = options.redactHook(entry.field, val);
+                }
+                if (val !== undefined) {
+                    activeSpan.setAttribute(`siglo.context.${entry.field}`, typeof val === 'object' && val !== null ? JSON.stringify(val) : String(val));
+                }
+            }
+        },
+    };
+}
+/**
+ * Instruments an individual Step with an OpenTelemetry child span covering action execution,
+ * attempt counting, and error recording.
+ */
+function instrumentStep(step, options = {}) {
+    const tracer = getTracer(options);
+    const originalAction = step.action;
+    if (!originalAction) {
+        return step;
+    }
+    let invocationCount = 0;
+    const isNamespaceAllowed = options.allowNamespace ?? false;
+    step.action = (async (param, current, index) => {
+        invocationCount++;
+        const stackId = resolveValue(param?.$stackId);
+        const retryCount = resolveValue(param?.$attempt);
+        const attempt = retryCount !== undefined ? retryCount + 1 : invocationCount;
+        const namespace = resolveValue(param?.$namespace);
+        const stepName = step.name || step.$stepId || 'unnamed-step';
+        const spanName = attempt > 1 ? `step:${stepName} (retry #${attempt})` : `step:${stepName}`;
+        const stepSpan = tracer.startSpan(spanName, {
+            attributes: {
+                [attributes_1.SemanticAttributes.STEP_NAME]: stepName,
+                ...(step.$stepId ? { [attributes_1.SemanticAttributes.STEP_ID]: step.$stepId } : {}),
+                [attributes_1.SemanticAttributes.STEP_ATTEMPT]: attempt,
+                ...(stackId ? { [attributes_1.SemanticAttributes.STACK_ID]: stackId } : {}),
+                ...(isNamespaceAllowed && namespace
+                    ? { [attributes_1.SemanticAttributes.NAMESPACE]: namespace }
+                    : {}),
+                ...(step.timeoutMs ? { [attributes_1.SemanticAttributes.TIMEOUT]: step.timeoutMs } : {}),
+            },
+        });
+        const ctx = api_1.trace.setSpan(api_1.context.active(), stepSpan);
+        return api_1.context.with(ctx, async () => {
+            try {
+                const result = await originalAction(param, current, index);
+                stepSpan.setStatus({ code: api_1.SpanStatusCode.OK });
+                return result;
+            }
+            catch (err) {
+                stepSpan.recordException(err);
+                stepSpan.setStatus({
+                    code: api_1.SpanStatusCode.ERROR,
+                    message: err?.message || 'Step execution failed',
+                });
+                throw err;
+            }
+            finally {
+                stepSpan.end();
+            }
+        });
+    });
+    return step;
+}
+/**
+ * Wraps a Flow execution with end-to-end OpenTelemetry spans and instruments child steps.
+ */
+function instrumentWorkflow(workflow, options = {}) {
+    const tracer = getTracer(options);
+    // Instrument individual child steps if available
+    if (Array.isArray(workflow.steps)) {
+        for (const step of workflow.steps) {
+            if (step && typeof step === 'object' && 'action' in step) {
+                instrumentStep(step, options);
+            }
+        }
+    }
+    const originalRun = workflow.run.bind(workflow);
+    const isNamespaceAllowed = options.allowNamespace ?? false;
+    workflow.run = (async (input, execOptions = {}) => {
+        const workflowName = options.workflowName || workflow.name || 'workflow';
+        const workflowVersion = options.workflowVersion || workflow.workflowVersion || '1.0.0';
+        const namespace = execOptions?.namespace;
+        const wfSpan = tracer.startSpan(`workflow:${workflowName}`, {
+            attributes: {
+                [attributes_1.SemanticAttributes.WORKFLOW_NAME]: workflowName,
+                [attributes_1.SemanticAttributes.WORKFLOW_VERSION]: String(workflowVersion),
+                ...(isNamespaceAllowed && namespace
+                    ? { [attributes_1.SemanticAttributes.NAMESPACE]: namespace }
+                    : {}),
+                ...(execOptions?.timeout || workflow.timeoutMs
+                    ? { [attributes_1.SemanticAttributes.TIMEOUT]: execOptions?.timeout || workflow.timeoutMs }
+                    : {}),
+            },
+        });
+        const ctx = api_1.trace.setSpan(api_1.context.active(), wfSpan);
+        return api_1.context.with(ctx, async () => {
+            try {
+                const result = await originalRun(input, execOptions);
+                const stackId = resolveValue(result?.$stackId);
+                if (stackId) {
+                    wfSpan.setAttribute(attributes_1.SemanticAttributes.STACK_ID, stackId);
+                }
+                wfSpan.setStatus({ code: api_1.SpanStatusCode.OK });
+                return result;
+            }
+            catch (err) {
+                wfSpan.recordException(err);
+                wfSpan.setStatus({
+                    code: api_1.SpanStatusCode.ERROR,
+                    message: err?.message || 'Workflow execution failed',
+                });
+                throw err;
+            }
+            finally {
+                wfSpan.end();
+            }
+        });
+    });
+    return workflow;
+}
+//# sourceMappingURL=instrument.js.map

package/dist/instrument.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,20 @@
+import { Tracer, Span } from '@opentelemetry/api';
+export interface SigloTelemetryOptions {
+    tracer?: Tracer;
+    serviceName?: string;
+    workflowName?: string;
+    workflowVersion?: string;
+    allowNamespace?: boolean;
+    allowContextFields?: string[];
+    redactHook?: (key: string, value: unknown) => unknown;
+}
+export interface W3CTraceHeaders {
+    traceparent?: string;
+    tracestate?: string;
+}
+export interface ActiveExecutionSpan {
+    workflowSpan: Span;
+    stepSpans: Map<string, Span>;
+}
+export type RivuletTelemetryOptions = SigloTelemetryOptions;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,WAAW,qBAAqB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACzD;AAED,MAAM,WAAW,eAAe;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAChC,YAAY,EAAE,IAAI,CAAC;IACnB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CAChC;AAGD,MAAM,MAAM,uBAAuB,GAAG,qBAAqB,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/w3c.d.ts

@@ -0,0 +1,15 @@
+import { Span, Context } from '@opentelemetry/api';
+import { W3CTraceHeaders } from './types';
+/**
+ * Injects the active or specified OpenTelemetry context into a headers / carrier object.
+ */
+export declare function injectTraceContext(carrier?: Record<string, string>, ctx?: Context): Record<string, string>;
+/**
+ * Extracts an OpenTelemetry context from a headers / carrier object (e.g., from HTTP or Kafka headers).
+ */
+export declare function extractTraceContext(carrier: Record<string, string | undefined>, ctx?: Context): Context;
+/**
+ * Extracts W3C traceparent and tracestate from an active Span or SpanContext.
+ */
+export declare function getTraceHeaders(span?: Span): W3CTraceHeaders;
+//# sourceMappingURL=w3c.d.ts.map

package/dist/w3c.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"w3c.d.ts","sourceRoot":"","sources":["../src/w3c.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,IAAI,EAEJ,OAAO,EAGV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C;;GAEG;AACH,wBAAgB,kBAAkB,CAC9B,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,GAAG,GAAE,OAA0B,GAChC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAC3C,GAAG,GAAE,OAA0B,GAChC,OAAO,CAQT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,eAAe,CAiB5D"}

package/dist/w3c.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.injectTraceContext = injectTraceContext;
+exports.extractTraceContext = extractTraceContext;
+exports.getTraceHeaders = getTraceHeaders;
+const api_1 = require("@opentelemetry/api");
+/**
+ * Injects the active or specified OpenTelemetry context into a headers / carrier object.
+ */
+function injectTraceContext(carrier = {}, ctx = api_1.context.active()) {
+    api_1.propagation.inject(ctx, carrier, api_1.defaultTextMapSetter);
+    return carrier;
+}
+/**
+ * Extracts an OpenTelemetry context from a headers / carrier object (e.g., from HTTP or Kafka headers).
+ */
+function extractTraceContext(carrier, ctx = api_1.context.active()) {
+    const sanitizedCarrier = {};
+    for (const [key, val] of Object.entries(carrier)) {
+        if (typeof val === 'string') {
+            sanitizedCarrier[key.toLowerCase()] = val;
+        }
+    }
+    return api_1.propagation.extract(ctx, sanitizedCarrier, api_1.defaultTextMapGetter);
+}
+/**
+ * Extracts W3C traceparent and tracestate from an active Span or SpanContext.
+ */
+function getTraceHeaders(span) {
+    const targetSpan = span || api_1.trace.getActiveSpan();
+    if (!targetSpan) {
+        return {};
+    }
+    const spanCtx = targetSpan.spanContext();
+    if (!spanCtx || !spanCtx.traceId) {
+        return {};
+    }
+    const flags = (spanCtx.traceFlags || 0).toString(16).padStart(2, '0');
+    const traceparent = `00-${spanCtx.traceId}-${spanCtx.spanId}-${flags}`;
+    const headers = { traceparent };
+    if (spanCtx.traceState) {
+        headers.tracestate = spanCtx.traceState.serialize();
+    }
+    return headers;
+}
+//# sourceMappingURL=w3c.js.map

package/dist/w3c.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"w3c.js","sourceRoot":"","sources":["../src/w3c.ts"],"names":[],"mappings":";;AAcA,gDAMC;AAKD,kDAWC;AAKD,0CAiBC;AA1DD,4CAQ4B;AAG5B;;GAEG;AACH,SAAgB,kBAAkB,CAC9B,UAAkC,EAAE,EACpC,MAAe,aAAO,CAAC,MAAM,EAAE;IAE/B,iBAAW,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,0BAAoB,CAAC,CAAC;IACvD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAC/B,OAA2C,EAC3C,MAAe,aAAO,CAAC,MAAM,EAAE;IAE/B,MAAM,gBAAgB,GAA2B,EAAE,CAAC;IACpD,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/C,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC1B,gBAAgB,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,GAAG,CAAC;QAC9C,CAAC;IACL,CAAC;IACD,OAAO,iBAAW,CAAC,OAAO,CAAC,GAAG,EAAE,gBAAgB,EAAE,0BAAoB,CAAC,CAAC;AAC5E,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,IAAW;IACvC,MAAM,UAAU,GAAG,IAAI,IAAI,WAAK,CAAC,aAAa,EAAE,CAAC;IACjD,IAAI,CAAC,UAAU,EAAE,CAAC;QACd,OAAO,EAAE,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IACzC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtE,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;IACvE,MAAM,OAAO,GAAoB,EAAE,WAAW,EAAE,CAAC;IACjD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACrB,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@siglo/opentelemetry",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "OpenTelemetry observability integration for Siglo workflows",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "test": "npm run build && mocha -r tsx 'src/**/*.test.ts'"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jsoftgem/siglo.git",
+    "directory": "packages/opentelemetry"
+  },
+  "author": "Jerico de Guzman",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/jsoftgem/siglo/issues"
+  },
+  "homepage": "https://github.com/jsoftgem/siglo#readme",
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@siglo/core": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/chai": "^5.2.3",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^26.6.5",
+    "chai": "^3.5.0",
+    "mocha": "^12.0.3",
+    "tsx": "^4.23.15",
+    "typescript": "~5.7.0"
+  }
+}