@nahisaho/katashiro-observability 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nahisaho
+
+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/dist/HealthChecker.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Health Checker Implementation
+ *
+ * @requirement REQ-OBS-002
+ * @design DES-KATASHIRO-003-OBS §3.4
+ */
+import type { HealthCheck, HealthCheckResult } from './types.js';
+/**
+ * ヘルスチェッカー設定
+ */
+export interface HealthCheckerConfig {
+    /** デフォルトタイムアウト (ms) */
+    defaultTimeout?: number;
+    /** チェック並列実行 */
+    parallel?: boolean;
+}
+/**
+ * ヘルスチェッカー
+ */
+export declare class HealthChecker {
+    private checks;
+    private config;
+    constructor(config?: HealthCheckerConfig);
+    /**
+     * ヘルスチェック登録
+     */
+    register(check: HealthCheck): void;
+    /**
+     * ヘルスチェック登録解除
+     */
+    unregister(name: string): boolean;
+    /**
+     * 全チェック実行
+     */
+    check(): Promise<HealthCheckResult>;
+    /**
+     * 単一チェック実行（タイムアウト付き）
+     */
+    private runCheck;
+    /**
+     * Liveness チェック（常にOK）
+     */
+    liveness(): Promise<{
+        status: 'pass';
+    }>;
+    /**
+     * Readiness チェック
+     */
+    readiness(): Promise<HealthCheckResult>;
+}
+/**
+ * グローバルヘルスチェッカー取得
+ */
+export declare function getHealthChecker(): HealthChecker;
+/**
+ * ヘルスチェッカーリセット（テスト用）
+ */
+export declare function resetHealthChecker(): void;
+//# sourceMappingURL=HealthChecker.d.ts.map

package/dist/HealthChecker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthChecker.d.ts","sourceRoot":"","sources":["../src/HealthChecker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAID;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,MAAM,CAAgC;gBAElC,MAAM,CAAC,EAAE,mBAAmB;IAOxC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIlC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAyCzC;;OAEG;YACW,QAAQ;IA8BtB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAI7C;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,iBAAiB,CAAC;CAG9C;AAKD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/HealthChecker.js

@@ -0,0 +1,126 @@
+/**
+ * Health Checker Implementation
+ *
+ * @requirement REQ-OBS-002
+ * @design DES-KATASHIRO-003-OBS §3.4
+ */
+const DEFAULT_TIMEOUT = 5000;
+/**
+ * ヘルスチェッカー
+ */
+export class HealthChecker {
+    checks = new Map();
+    config;
+    constructor(config) {
+        this.config = {
+            defaultTimeout: config?.defaultTimeout ?? DEFAULT_TIMEOUT,
+            parallel: config?.parallel ?? true,
+        };
+    }
+    /**
+     * ヘルスチェック登録
+     */
+    register(check) {
+        this.checks.set(check.name, check);
+    }
+    /**
+     * ヘルスチェック登録解除
+     */
+    unregister(name) {
+        return this.checks.delete(name);
+    }
+    /**
+     * 全チェック実行
+     */
+    async check() {
+        const checks = {};
+        if (this.config.parallel) {
+            // 並列実行
+            const entries = Array.from(this.checks.entries());
+            const results = await Promise.all(entries.map(async ([name, check]) => {
+                const result = await this.runCheck(check);
+                return [name, result];
+            }));
+            for (const [name, result] of results) {
+                checks[name] = result;
+            }
+        }
+        else {
+            // 逐次実行
+            for (const [name, check] of this.checks) {
+                checks[name] = await this.runCheck(check);
+            }
+        }
+        // 全体ステータス判定
+        const statuses = Object.values(checks).map((c) => c.status);
+        let status;
+        if (statuses.every((s) => s === 'pass')) {
+            status = 'healthy';
+        }
+        else if (statuses.some((s) => s === 'fail')) {
+            status = 'unhealthy';
+        }
+        else {
+            status = 'degraded';
+        }
+        return {
+            status,
+            checks,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    /**
+     * 単一チェック実行（タイムアウト付き）
+     */
+    async runCheck(check) {
+        const timeout = check.timeout ?? this.config.defaultTimeout;
+        const startTime = Date.now();
+        try {
+            const result = await Promise.race([
+                check.check(),
+                new Promise((_, reject) => setTimeout(() => reject(new Error(`Health check timeout: ${check.name}`)), timeout)),
+            ]);
+            return {
+                ...result,
+                latencyMs: Date.now() - startTime,
+            };
+        }
+        catch (error) {
+            return {
+                status: 'fail',
+                message: error instanceof Error ? error.message : 'Unknown error',
+                latencyMs: Date.now() - startTime,
+            };
+        }
+    }
+    /**
+     * Liveness チェック（常にOK）
+     */
+    async liveness() {
+        return { status: 'pass' };
+    }
+    /**
+     * Readiness チェック
+     */
+    async readiness() {
+        return this.check();
+    }
+}
+// シングルトン
+let healthChecker = null;
+/**
+ * グローバルヘルスチェッカー取得
+ */
+export function getHealthChecker() {
+    if (!healthChecker) {
+        healthChecker = new HealthChecker();
+    }
+    return healthChecker;
+}
+/**
+ * ヘルスチェッカーリセット（テスト用）
+ */
+export function resetHealthChecker() {
+    healthChecker = null;
+}
+//# sourceMappingURL=HealthChecker.js.map

package/dist/HealthChecker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthChecker.js","sourceRoot":"","sources":["../src/HealthChecker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,MAAM,eAAe,GAAG,IAAI,CAAC;AAE7B;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,GAA6B,IAAI,GAAG,EAAE,CAAC;IAC7C,MAAM,CAAgC;IAE9C,YAAY,MAA4B;QACtC,IAAI,CAAC,MAAM,GAAG;YACZ,cAAc,EAAE,MAAM,EAAE,cAAc,IAAI,eAAe;YACzD,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,IAAI;SACnC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAkB;QACzB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,MAAM,GAAgC,EAAE,CAAC;QAE/C,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACzB,OAAO;YACP,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;gBAClC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC1C,OAAO,CAAC,IAAI,EAAE,MAAM,CAAU,CAAC;YACjC,CAAC,CAAC,CACH,CAAC;YACF,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACrC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;YACxB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO;YACP,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACxC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,YAAY;QACZ,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,MAAmC,CAAC;QAExC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,EAAE,CAAC;YACxC,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;aAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,EAAE,CAAC;YAC9C,MAAM,GAAG,WAAW,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,UAAU,CAAC;QACtB,CAAC;QAED,OAAO;YACL,MAAM;YACN,MAAM;YACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,QAAQ,CACpB,KAAkB;QAElB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;QAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;gBAChC,KAAK,CAAC,KAAK,EAAE;gBACb,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC/B,UAAU,CACR,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,EAC9D,OAAO,CACR,CACF;aACF,CAAC,CAAC;YAEH,OAAO;gBACL,GAAG,MAAM;gBACT,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;gBACjE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aAClC,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF;AAED,SAAS;AACT,IAAI,aAAa,GAAyB,IAAI,CAAC;AAE/C;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC"}

package/dist/MetricsCollector.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Metrics Collector Implementation
+ *
+ * @requirement REQ-OBS-002
+ * @design DES-KATASHIRO-003-OBS §3.2
+ */
+import type { MetricsSnapshot, MetricsExporter } from './types.js';
+/**
+ * メトリクスコレクター
+ */
+export declare class MetricsCollector {
+    private counters;
+    private gauges;
+    private histograms;
+    private exporters;
+    /**
+     * カウンターインクリメント
+     */
+    incrementCounter(name: string, value?: number, labels?: Record<string, string>): void;
+    /**
+     * ゲージ設定
+     */
+    setGauge(name: string, value: number, labels?: Record<string, string>): void;
+    /**
+     * ヒストグラム記録
+     */
+    recordHistogram(name: string, value: number, labels?: Record<string, string>): void;
+    /**
+     * スナップショット取得
+     */
+    getSnapshot(): MetricsSnapshot;
+    /**
+     * 特定カウンター取得
+     */
+    getCounter(name: string, labels?: Record<string, string>): number;
+    /**
+     * 特定ゲージ取得
+     */
+    getGauge(name: string, labels?: Record<string, string>): number | undefined;
+    /**
+     * リセット
+     */
+    reset(): void;
+    /**
+     * エクスポーター追加
+     */
+    addExporter(exporter: MetricsExporter): void;
+    /**
+     * メトリクスエクスポート
+     */
+    export(): Promise<void>;
+    /**
+     * シャットダウン
+     */
+    shutdown(): Promise<void>;
+    private buildKey;
+    private percentile;
+    private buildBuckets;
+}
+/**
+ * グローバルメトリクスコレクター取得
+ */
+export declare function getMetricsCollector(): MetricsCollector;
+/**
+ * メトリクスコレクターリセット（テスト用）
+ */
+export declare function resetMetricsCollector(): void;
+//# sourceMappingURL=MetricsCollector.d.ts.map

package/dist/MetricsCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetricsCollector.d.ts","sourceRoot":"","sources":["../src/MetricsCollector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAiB,eAAe,EAAE,MAAM,YAAY,CAAC;AAElF;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,SAAS,CAAyB;IAE1C;;OAEG;IACH,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAU,EACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,IAAI;IAMP;;OAEG;IACH,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,IAAI;IAKP;;OAEG;IACH,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,IAAI;IAOP;;OAEG;IACH,WAAW,IAAI,eAAe;IA4B9B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;IAKjE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS;IAK3E;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAI5C;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAO7B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,YAAY;CAWrB;AAKD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/MetricsCollector.js

@@ -0,0 +1,148 @@
+/**
+ * Metrics Collector Implementation
+ *
+ * @requirement REQ-OBS-002
+ * @design DES-KATASHIRO-003-OBS §3.2
+ */
+/**
+ * メトリクスコレクター
+ */
+export class MetricsCollector {
+    counters = new Map();
+    gauges = new Map();
+    histograms = new Map();
+    exporters = [];
+    /**
+     * カウンターインクリメント
+     */
+    incrementCounter(name, value = 1, labels) {
+        const key = this.buildKey(name, labels);
+        const current = this.counters.get(key) ?? 0;
+        this.counters.set(key, current + value);
+    }
+    /**
+     * ゲージ設定
+     */
+    setGauge(name, value, labels) {
+        const key = this.buildKey(name, labels);
+        this.gauges.set(key, value);
+    }
+    /**
+     * ヒストグラム記録
+     */
+    recordHistogram(name, value, labels) {
+        const key = this.buildKey(name, labels);
+        const values = this.histograms.get(key) ?? [];
+        values.push(value);
+        this.histograms.set(key, values);
+    }
+    /**
+     * スナップショット取得
+     */
+    getSnapshot() {
+        const histograms = {};
+        for (const [key, values] of this.histograms) {
+            if (values.length === 0)
+                continue;
+            const sorted = [...values].sort((a, b) => a - b);
+            histograms[key] = {
+                count: values.length,
+                sum: values.reduce((a, b) => a + b, 0),
+                min: sorted[0] ?? 0,
+                max: sorted[sorted.length - 1] ?? 0,
+                avg: values.reduce((a, b) => a + b, 0) / values.length,
+                p50: this.percentile(sorted, 0.5),
+                p90: this.percentile(sorted, 0.9),
+                p99: this.percentile(sorted, 0.99),
+                buckets: this.buildBuckets(values),
+            };
+        }
+        return {
+            timestamp: new Date().toISOString(),
+            counters: Object.fromEntries(this.counters),
+            gauges: Object.fromEntries(this.gauges),
+            histograms,
+        };
+    }
+    /**
+     * 特定カウンター取得
+     */
+    getCounter(name, labels) {
+        const key = this.buildKey(name, labels);
+        return this.counters.get(key) ?? 0;
+    }
+    /**
+     * 特定ゲージ取得
+     */
+    getGauge(name, labels) {
+        const key = this.buildKey(name, labels);
+        return this.gauges.get(key);
+    }
+    /**
+     * リセット
+     */
+    reset() {
+        this.counters.clear();
+        this.gauges.clear();
+        this.histograms.clear();
+    }
+    /**
+     * エクスポーター追加
+     */
+    addExporter(exporter) {
+        this.exporters.push(exporter);
+    }
+    /**
+     * メトリクスエクスポート
+     */
+    async export() {
+        const snapshot = this.getSnapshot();
+        await Promise.all(this.exporters.map((exp) => exp.export(snapshot).catch(console.error)));
+    }
+    /**
+     * シャットダウン
+     */
+    async shutdown() {
+        await Promise.all(this.exporters.map((exp) => exp.shutdown?.().catch(console.error)));
+    }
+    buildKey(name, labels) {
+        if (!labels)
+            return name;
+        const labelStr = Object.entries(labels)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([k, v]) => `${k}="${v}"`)
+            .join(',');
+        return `${name}{${labelStr}}`;
+    }
+    percentile(sorted, p) {
+        const idx = Math.ceil(sorted.length * p) - 1;
+        return sorted[Math.max(0, idx)] ?? 0;
+    }
+    buildBuckets(values) {
+        const boundaries = [1, 5, 10, 50, 100, 500, 1000, 5000];
+        const buckets = {};
+        for (const b of boundaries) {
+            buckets[`le_${b}`] = values.filter((v) => v <= b).length;
+        }
+        buckets['le_+Inf'] = values.length;
+        return buckets;
+    }
+}
+// シングルトン
+let metricsCollector = null;
+/**
+ * グローバルメトリクスコレクター取得
+ */
+export function getMetricsCollector() {
+    if (!metricsCollector) {
+        metricsCollector = new MetricsCollector();
+    }
+    return metricsCollector;
+}
+/**
+ * メトリクスコレクターリセット（テスト用）
+ */
+export function resetMetricsCollector() {
+    metricsCollector = null;
+}
+//# sourceMappingURL=MetricsCollector.js.map

package/dist/MetricsCollector.js.map

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

package/dist/Span.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Span Implementation
+ *
+ * @requirement REQ-OBS-001
+ * @design DES-KATASHIRO-003-OBS §3.1.3
+ */
+import type { Span, SpanOptions, SpanStatus, TraceRecord, AttributeValue } from './types.js';
+/**
+ * スパン実装
+ */
+export declare class SpanImpl implements Span {
+    readonly traceId: string;
+    readonly spanId: string;
+    private parentSpanId?;
+    private name;
+    private startTime;
+    private endTime?;
+    private status;
+    private attributes;
+    private events;
+    private links;
+    constructor(name: string, parent?: Span, options?: SpanOptions);
+    setAttribute(key: string, value: AttributeValue): this;
+    setAttributes(attributes: Record<string, AttributeValue>): this;
+    setStatus(status: SpanStatus): this;
+    addEvent(name: string, attributes?: Record<string, AttributeValue>): this;
+    recordException(error: Error): this;
+    end(): void;
+    toRecord(): TraceRecord;
+}
+/**
+ * NoOp Span（サンプリングスキップ用）
+ */
+export declare class NoopSpan implements Span {
+    readonly traceId = "";
+    readonly spanId = "";
+    setAttribute(): this;
+    setAttributes(): this;
+    setStatus(): this;
+    addEvent(): this;
+    recordException(): this;
+    end(): void;
+    toRecord(): TraceRecord;
+}
+//# sourceMappingURL=Span.d.ts.map

package/dist/Span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Span.d.ts","sourceRoot":"","sources":["../src/Span.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,IAAI,EACJ,WAAW,EACX,UAAU,EAGV,WAAW,EACX,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,QAAS,YAAW,IAAI;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,OAAO,CAAC,CAAO;IACvB,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,KAAK,CAAkB;gBAEnB,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,WAAW;IAe9D,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAKtD,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI;IAK/D,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAKnC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI;IASzE,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IASnC,GAAG,IAAI,IAAI;IAMX,QAAQ,IAAI,WAAW;CAiBxB;AAED;;GAEG;AACH,qBAAa,QAAS,YAAW,IAAI;IACnC,QAAQ,CAAC,OAAO,MAAM;IACtB,QAAQ,CAAC,MAAM,MAAM;IAErB,YAAY,IAAI,IAAI;IAGpB,aAAa,IAAI,IAAI;IAGrB,SAAS,IAAI,IAAI;IAGjB,QAAQ,IAAI,IAAI;IAGhB,eAAe,IAAI,IAAI;IAGvB,GAAG,IAAI,IAAI;IACX,QAAQ,IAAI,WAAW;CAYxB"}

package/dist/Span.js

@@ -0,0 +1,120 @@
+/**
+ * Span Implementation
+ *
+ * @requirement REQ-OBS-001
+ * @design DES-KATASHIRO-003-OBS §3.1.3
+ */
+/**
+ * スパン実装
+ */
+export class SpanImpl {
+    traceId;
+    spanId;
+    parentSpanId;
+    name;
+    startTime;
+    endTime;
+    status = { code: 'OK' };
+    attributes = {};
+    events = [];
+    links = [];
+    constructor(name, parent, options) {
+        this.traceId = parent?.traceId ?? crypto.randomUUID();
+        this.spanId = crypto.randomUUID();
+        this.parentSpanId = parent?.spanId;
+        this.name = name;
+        this.startTime = new Date();
+        if (options?.attributes) {
+            this.attributes = { ...options.attributes };
+        }
+        if (options?.links) {
+            this.links = [...options.links];
+        }
+    }
+    setAttribute(key, value) {
+        this.attributes[key] = value;
+        return this;
+    }
+    setAttributes(attributes) {
+        Object.assign(this.attributes, attributes);
+        return this;
+    }
+    setStatus(status) {
+        this.status = status;
+        return this;
+    }
+    addEvent(name, attributes) {
+        this.events.push({
+            name,
+            timestamp: new Date().toISOString(),
+            attributes,
+        });
+        return this;
+    }
+    recordException(error) {
+        this.addEvent('exception', {
+            'exception.type': error.name,
+            'exception.message': error.message,
+            'exception.stacktrace': error.stack ?? '',
+        });
+        return this;
+    }
+    end() {
+        if (!this.endTime) {
+            this.endTime = new Date();
+        }
+    }
+    toRecord() {
+        return {
+            traceId: this.traceId,
+            spanId: this.spanId,
+            parentSpanId: this.parentSpanId,
+            name: this.name,
+            startTime: this.startTime.toISOString(),
+            endTime: this.endTime?.toISOString(),
+            durationMs: this.endTime
+                ? this.endTime.getTime() - this.startTime.getTime()
+                : undefined,
+            status: this.status,
+            attributes: this.attributes,
+            events: this.events,
+            links: this.links,
+        };
+    }
+}
+/**
+ * NoOp Span（サンプリングスキップ用）
+ */
+export class NoopSpan {
+    traceId = '';
+    spanId = '';
+    setAttribute() {
+        return this;
+    }
+    setAttributes() {
+        return this;
+    }
+    setStatus() {
+        return this;
+    }
+    addEvent() {
+        return this;
+    }
+    recordException() {
+        return this;
+    }
+    end() { }
+    toRecord() {
+        return {
+            traceId: '',
+            spanId: '',
+            name: 'noop',
+            startTime: new Date().toISOString(),
+            status: { code: 'OK' },
+            attributes: {},
+            events: [],
+            links: [],
+        };
+    }
+}
+//# sourceMappingURL=Span.js.map

package/dist/Span.js.map

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