@nahisaho/katashiro-observability 2.0.0

package/dist/Tracer.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Tracer Implementation
+ *
+ * @requirement REQ-OBS-001
+ * @design DES-KATASHIRO-003-OBS §3.1.2
+ */
+import type { Span, SpanOptions, TracerConfig, TraceExporter } from './types.js';
+/**
+ * メイントレーサークラス
+ */
+export declare class Tracer {
+    private static instance;
+    private asyncStorage;
+    private exporters;
+    private config;
+    private constructor();
+    /**
+     * シングルトンインスタンス取得
+     */
+    static getInstance(config?: TracerConfig): Tracer;
+    /**
+     * インスタンスリセット（テスト用）
+     */
+    static resetInstance(): void;
+    /**
+     * 設定取得
+     */
+    getConfig(): Readonly<TracerConfig>;
+    /**
+     * スパン開始（コールバック方式）
+     */
+    startActiveSpan<T>(name: string, fn: (span: Span) => Promise<T>, options?: SpanOptions): Promise<T>;
+    /**
+     * 現在のスパン取得
+     */
+    getCurrentSpan(): Span | undefined;
+    /**
+     * 現在のトレースID取得
+     */
+    getCurrentTraceId(): string | undefined;
+    /**
+     * エクスポーター追加
+     */
+    addExporter(exporter: TraceExporter): void;
+    /**
+     * エクスポーター削除
+     */
+    removeExporter(name: string): boolean;
+    /**
+     * 全エクスポーターシャットダウン
+     */
+    shutdown(): Promise<void>;
+    /**
+     * トレースエクスポート
+     */
+    private export;
+}
+/**
+ * グローバルトレーサー取得
+ */
+export declare function getGlobalTracer(): Tracer;
+/**
+ * トレースデコレータ
+ *
+ * @example
+ * class MyService {
+ *   @trace('myOperation')
+ *   async doSomething() { ... }
+ * }
+ */
+export declare function trace(name: string, options?: SpanOptions): <T>(_target: object, _propertyKey: string, descriptor: TypedPropertyDescriptor<(...args: unknown[]) => Promise<T>>) => TypedPropertyDescriptor<(...args: unknown[]) => Promise<T>>;
+//# sourceMappingURL=Tracer.d.ts.map

package/dist/Tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tracer.d.ts","sourceRoot":"","sources":["../src/Tracer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,IAAI,EACJ,WAAW,EAGX,YAAY,EACZ,aAAa,EACd,MAAM,YAAY,CAAC;AAapB;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuB;IAC9C,OAAO,CAAC,YAAY,CAAyC;IAC7D,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,MAAM,CAAe;IAE7B,OAAO;IAKP;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM;IAOjD;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,YAAY,CAAC;IAInC;;OAEG;IACG,eAAe,CAAC,CAAC,EACrB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,CAAC,CAAC;IAoCb;;OAEG;IACH,cAAc,IAAI,IAAI,GAAG,SAAS;IAIlC;;OAEG;IACH,iBAAiB,IAAI,MAAM,GAAG,SAAS;IAIvC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAI1C;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IASrC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B;;OAEG;YACW,MAAM;CAKrB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,IACtC,CAAC,EAChB,SAAS,MAAM,EACf,cAAc,MAAM,EACpB,YAAY,uBAAuB,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,KACtE,uBAAuB,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CA2B/D"}

package/dist/Tracer.js

@@ -0,0 +1,165 @@
+/**
+ * Tracer Implementation
+ *
+ * @requirement REQ-OBS-001
+ * @design DES-KATASHIRO-003-OBS §3.1.2
+ */
+import { AsyncLocalStorage } from 'async_hooks';
+import { SpanImpl, NoopSpan } from './Span.js';
+/**
+ * デフォルト設定
+ */
+const DEFAULT_CONFIG = {
+    serviceName: 'katashiro',
+    serviceVersion: '2.0.0',
+    environment: 'development',
+    sampling: 1.0,
+};
+/**
+ * メイントレーサークラス
+ */
+export class Tracer {
+    static instance = null;
+    asyncStorage = new AsyncLocalStorage();
+    exporters = [];
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.exporters = config.exporters ?? [];
+    }
+    /**
+     * シングルトンインスタンス取得
+     */
+    static getInstance(config) {
+        if (!Tracer.instance) {
+            Tracer.instance = new Tracer(config ?? DEFAULT_CONFIG);
+        }
+        return Tracer.instance;
+    }
+    /**
+     * インスタンスリセット（テスト用）
+     */
+    static resetInstance() {
+        Tracer.instance = null;
+    }
+    /**
+     * 設定取得
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * スパン開始（コールバック方式）
+     */
+    async startActiveSpan(name, fn, options) {
+        // サンプリング判定
+        if (this.config.sampling !== undefined &&
+            Math.random() > this.config.sampling) {
+            return fn(new NoopSpan());
+        }
+        const parentContext = this.asyncStorage.getStore();
+        const span = new SpanImpl(name, parentContext?.currentSpan, options);
+        const newContext = {
+            traceId: parentContext?.traceId ?? span.traceId,
+            currentSpan: span,
+        };
+        return this.asyncStorage.run(newContext, async () => {
+            try {
+                const result = await fn(span);
+                span.setStatus({ code: 'OK' });
+                return result;
+            }
+            catch (error) {
+                span.setStatus({
+                    code: 'ERROR',
+                    message: error instanceof Error ? error.message : 'Unknown error',
+                });
+                span.recordException(error);
+                throw error;
+            }
+            finally {
+                span.end();
+                await this.export(span.toRecord());
+            }
+        });
+    }
+    /**
+     * 現在のスパン取得
+     */
+    getCurrentSpan() {
+        return this.asyncStorage.getStore()?.currentSpan;
+    }
+    /**
+     * 現在のトレースID取得
+     */
+    getCurrentTraceId() {
+        return this.asyncStorage.getStore()?.traceId;
+    }
+    /**
+     * エクスポーター追加
+     */
+    addExporter(exporter) {
+        this.exporters.push(exporter);
+    }
+    /**
+     * エクスポーター削除
+     */
+    removeExporter(name) {
+        const idx = this.exporters.findIndex((e) => e.name === name);
+        if (idx >= 0) {
+            this.exporters.splice(idx, 1);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * 全エクスポーターシャットダウン
+     */
+    async shutdown() {
+        await Promise.all(this.exporters.map((exp) => exp.shutdown?.().catch(console.error)));
+    }
+    /**
+     * トレースエクスポート
+     */
+    async export(record) {
+        await Promise.all(this.exporters.map((exp) => exp.export(record).catch(console.error)));
+    }
+}
+/**
+ * グローバルトレーサー取得
+ */
+export function getGlobalTracer() {
+    return Tracer.getInstance();
+}
+/**
+ * トレースデコレータ
+ *
+ * @example
+ * class MyService {
+ *   @trace('myOperation')
+ *   async doSomething() { ... }
+ * }
+ */
+export function trace(name, options) {
+    return function (_target, _propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        if (!originalMethod) {
+            return descriptor;
+        }
+        descriptor.value = async function (...args) {
+            const tracer = getGlobalTracer();
+            return tracer.startActiveSpan(name, async (span) => {
+                if (options?.recordInput) {
+                    span.setAttribute('input', JSON.stringify(args));
+                }
+                const result = await originalMethod.apply(this, args);
+                if (options?.recordOutput) {
+                    span.setAttribute('output', JSON.stringify(result));
+                }
+                return result;
+            }, options);
+        };
+        return descriptor;
+    };
+}
+//# sourceMappingURL=Tracer.js.map

package/dist/Tracer.js.map

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

package/dist/exporters/ConsoleExporter.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Console Exporter Implementation
+ *
+ * @requirement REQ-OBS-001, REQ-OBS-002
+ * @design DES-KATASHIRO-003-OBS §3.5
+ */
+import type { TraceExporter, TraceRecord, MetricsExporter, MetricsSnapshot } from '../types.js';
+/**
+ * コンソールトレースエクスポーター
+ */
+export declare class ConsoleTraceExporter implements TraceExporter {
+    readonly name = "console";
+    export(record: TraceRecord): Promise<void>;
+    shutdown(): Promise<void>;
+}
+/**
+ * コンソールメトリクスエクスポーター
+ */
+export declare class ConsoleMetricsExporter implements MetricsExporter {
+    readonly name = "console";
+    export(snapshot: MetricsSnapshot): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=ConsoleExporter.d.ts.map

package/dist/exporters/ConsoleExporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleExporter.d.ts","sourceRoot":"","sources":["../../src/exporters/ConsoleExporter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,eAAe,EACf,eAAe,EAEhB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACxD,QAAQ,CAAC,IAAI,aAAa;IAEpB,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB1C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC;AAED;;GAEG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,QAAQ,CAAC,IAAI,aAAa;IAEpB,MAAM,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BhD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}

package/dist/exporters/ConsoleExporter.js

@@ -0,0 +1,60 @@
+/**
+ * Console Exporter Implementation
+ *
+ * @requirement REQ-OBS-001, REQ-OBS-002
+ * @design DES-KATASHIRO-003-OBS §3.5
+ */
+/**
+ * コンソールトレースエクスポーター
+ */
+export class ConsoleTraceExporter {
+    name = 'console';
+    async export(record) {
+        const prefix = record.status.code === 'ERROR' ? '❌' : '✅';
+        const duration = record.durationMs ? `${record.durationMs}ms` : 'ongoing';
+        console.log(`${prefix} [TRACE] ${record.name} (${duration}) traceId=${record.traceId.slice(0, 8)}`);
+        if (record.status.code === 'ERROR') {
+            console.error(`   Error: ${record.status.message}`);
+        }
+        if (Object.keys(record.attributes).length > 0) {
+            console.log(`   Attributes:`, record.attributes);
+        }
+        for (const event of record.events) {
+            console.log(`   Event: ${event.name} at ${event.timestamp}`);
+        }
+    }
+    async shutdown() {
+        // No-op for console
+    }
+}
+/**
+ * コンソールメトリクスエクスポーター
+ */
+export class ConsoleMetricsExporter {
+    name = 'console';
+    async export(snapshot) {
+        console.log(`\n📊 [METRICS] ${snapshot.timestamp}`);
+        if (Object.keys(snapshot.counters).length > 0) {
+            console.log('   Counters:');
+            for (const [key, value] of Object.entries(snapshot.counters)) {
+                console.log(`     ${key}: ${value}`);
+            }
+        }
+        if (Object.keys(snapshot.gauges).length > 0) {
+            console.log('   Gauges:');
+            for (const [key, value] of Object.entries(snapshot.gauges)) {
+                console.log(`     ${key}: ${value}`);
+            }
+        }
+        if (Object.keys(snapshot.histograms).length > 0) {
+            console.log('   Histograms:');
+            for (const [key, data] of Object.entries(snapshot.histograms)) {
+                console.log(`     ${key}: count=${data.count} avg=${data.avg.toFixed(2)} p50=${data.p50} p99=${data.p99}`);
+            }
+        }
+    }
+    async shutdown() {
+        // No-op for console
+    }
+}
+//# sourceMappingURL=ConsoleExporter.js.map

package/dist/exporters/ConsoleExporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleExporter.js","sourceRoot":"","sources":["../../src/exporters/ConsoleExporter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH;;GAEG;AACH,MAAM,OAAO,oBAAoB;IACtB,IAAI,GAAG,SAAS,CAAC;IAE1B,KAAK,CAAC,MAAM,CAAC,MAAmB;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC1D,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAE1E,OAAO,CAAC,GAAG,CACT,GAAG,MAAM,YAAY,MAAM,CAAC,IAAI,KAAK,QAAQ,aAAa,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CACvF,CAAC;QAEF,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACnC,OAAO,CAAC,KAAK,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QACnD,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,oBAAoB;IACtB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,sBAAsB;IACxB,IAAI,GAAG,SAAS,CAAC;IAE1B,KAAK,CAAC,MAAM,CAAC,QAAyB;QACpC,OAAO,CAAC,GAAG,CAAC,kBAAkB,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;QAEpD,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7D,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3D,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B,EAAE,CAAC;gBAC3F,OAAO,CAAC,GAAG,CACT,QAAQ,GAAG,WAAW,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,GAAG,QAAQ,IAAI,CAAC,GAAG,EAAE,CAC9F,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,oBAAoB;IACtB,CAAC;CACF"}

package/dist/exporters/FileExporter.d.ts

@@ -0,0 +1,43 @@
+/**
+ * File Exporter Implementation
+ *
+ * @requirement REQ-OBS-001, REQ-OBS-002
+ * @design DES-KATASHIRO-003-OBS §3.5
+ */
+import type { TraceExporter, TraceRecord, MetricsExporter, MetricsSnapshot } from '../types.js';
+/**
+ * ファイルエクスポーター設定
+ */
+export interface FileExporterConfig {
+    /** 出力ファイルパス */
+    path: string;
+    /** 追記モード */
+    append?: boolean;
+    /** 行区切り */
+    delimiter?: string;
+}
+/**
+ * ファイルトレースエクスポーター
+ */
+export declare class FileTraceExporter implements TraceExporter {
+    readonly name = "file";
+    private config;
+    private initialized;
+    constructor(config: FileExporterConfig);
+    export(record: TraceRecord): Promise<void>;
+    shutdown(): Promise<void>;
+    private ensureDir;
+}
+/**
+ * ファイルメトリクスエクスポーター
+ */
+export declare class FileMetricsExporter implements MetricsExporter {
+    readonly name = "file";
+    private config;
+    private initialized;
+    constructor(config: FileExporterConfig);
+    export(snapshot: MetricsSnapshot): Promise<void>;
+    shutdown(): Promise<void>;
+    private ensureDir;
+}
+//# sourceMappingURL=FileExporter.d.ts.map

package/dist/exporters/FileExporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileExporter.d.ts","sourceRoot":"","sources":["../../src/exporters/FileExporter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,eAAe,EACf,eAAe,EAChB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,IAAI,UAAU;IACvB,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,kBAAkB;IAQhC,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAIjB,SAAS;CAMxB;AAED;;GAEG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACzD,QAAQ,CAAC,IAAI,UAAU;IACvB,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,kBAAkB;IAQhC,MAAM,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAIjB,SAAS;CAMxB"}

package/dist/exporters/FileExporter.js

@@ -0,0 +1,79 @@
+/**
+ * File Exporter Implementation
+ *
+ * @requirement REQ-OBS-001, REQ-OBS-002
+ * @design DES-KATASHIRO-003-OBS §3.5
+ */
+import { writeFile, appendFile, mkdir } from 'fs/promises';
+import { dirname } from 'path';
+/**
+ * ファイルトレースエクスポーター
+ */
+export class FileTraceExporter {
+    name = 'file';
+    config;
+    initialized = false;
+    constructor(config) {
+        this.config = {
+            path: config.path,
+            append: config.append ?? true,
+            delimiter: config.delimiter ?? '\n',
+        };
+    }
+    async export(record) {
+        await this.ensureDir();
+        const line = JSON.stringify(record) + this.config.delimiter;
+        if (this.config.append) {
+            await appendFile(this.config.path, line, 'utf-8');
+        }
+        else {
+            await writeFile(this.config.path, line, 'utf-8');
+        }
+    }
+    async shutdown() {
+        // No-op for file
+    }
+    async ensureDir() {
+        if (this.initialized)
+            return;
+        const dir = dirname(this.config.path);
+        await mkdir(dir, { recursive: true });
+        this.initialized = true;
+    }
+}
+/**
+ * ファイルメトリクスエクスポーター
+ */
+export class FileMetricsExporter {
+    name = 'file';
+    config;
+    initialized = false;
+    constructor(config) {
+        this.config = {
+            path: config.path,
+            append: config.append ?? true,
+            delimiter: config.delimiter ?? '\n',
+        };
+    }
+    async export(snapshot) {
+        await this.ensureDir();
+        const line = JSON.stringify(snapshot) + this.config.delimiter;
+        if (this.config.append) {
+            await appendFile(this.config.path, line, 'utf-8');
+        }
+        else {
+            await writeFile(this.config.path, line, 'utf-8');
+        }
+    }
+    async shutdown() {
+        // No-op for file
+    }
+    async ensureDir() {
+        if (this.initialized)
+            return;
+        const dir = dirname(this.config.path);
+        await mkdir(dir, { recursive: true });
+        this.initialized = true;
+    }
+}
+//# sourceMappingURL=FileExporter.js.map

package/dist/exporters/FileExporter.js.map

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

package/dist/exporters/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Exporters Index
+ *
+ * @design DES-KATASHIRO-003-OBS §3.5
+ */
+export { ConsoleTraceExporter, ConsoleMetricsExporter } from './ConsoleExporter.js';
+export { FileTraceExporter, FileMetricsExporter } from './FileExporter.js';
+export type { FileExporterConfig } from './FileExporter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/exporters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exporters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/exporters/index.js

@@ -0,0 +1,8 @@
+/**
+ * Exporters Index
+ *
+ * @design DES-KATASHIRO-003-OBS §3.5
+ */
+export { ConsoleTraceExporter, ConsoleMetricsExporter } from './ConsoleExporter.js';
+export { FileTraceExporter, FileMetricsExporter } from './FileExporter.js';
+//# sourceMappingURL=index.js.map

package/dist/exporters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/exporters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @nahisaho/katashiro-observability
+ * トレーシング・メトリクス・ロギング
+ *
+ * @requirement REQ-OBS-001, REQ-OBS-002, REQ-OBS-003, REQ-OBS-004, REQ-OBS-005
+ * @design DES-KATASHIRO-003-OBS
+ */
+export type { Span, SpanOptions, SpanStatus, SpanEvent, SpanLink, TraceRecord, TraceContext, TracerConfig, TraceExporter, AttributeValue, MetricsSnapshot, HistogramData, MetricsExporter, HealthCheck, HealthCheckResult, } from './types.js';
+export { SpanImpl, NoopSpan } from './Span.js';
+export { Tracer, getGlobalTracer, trace } from './Tracer.js';
+export { MetricsCollector, getMetricsCollector, resetMetricsCollector, } from './MetricsCollector.js';
+export { HealthChecker, getHealthChecker, resetHealthChecker, } from './HealthChecker.js';
+export type { HealthCheckerConfig } from './HealthChecker.js';
+export { ConsoleTraceExporter, ConsoleMetricsExporter, FileTraceExporter, FileMetricsExporter, } from './exporters/index.js';
+export type { FileExporterConfig } from './exporters/index.js';
+//# 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;;;;;;GAMG;AAGH,YAAY,EAEV,IAAI,EACJ,WAAW,EACX,UAAU,EACV,SAAS,EACT,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EAEd,eAAe,EACf,aAAa,EACb,eAAe,EAEf,WAAW,EACX,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * @nahisaho/katashiro-observability
+ * トレーシング・メトリクス・ロギング
+ *
+ * @requirement REQ-OBS-001, REQ-OBS-002, REQ-OBS-003, REQ-OBS-004, REQ-OBS-005
+ * @design DES-KATASHIRO-003-OBS
+ */
+// Span
+export { SpanImpl, NoopSpan } from './Span.js';
+// Tracer
+export { Tracer, getGlobalTracer, trace } from './Tracer.js';
+// Metrics
+export { MetricsCollector, getMetricsCollector, resetMetricsCollector, } from './MetricsCollector.js';
+// Health
+export { HealthChecker, getHealthChecker, resetHealthChecker, } from './HealthChecker.js';
+// Exporters
+export { ConsoleTraceExporter, ConsoleMetricsExporter, FileTraceExporter, FileMetricsExporter, } from './exporters/index.js';
+//# 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;;;;;;GAMG;AAwBH,OAAO;AACP,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE/C,SAAS;AACT,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE7D,UAAU;AACV,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,SAAS;AACT,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAG5B,YAAY;AACZ,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}