@nahisaho/katashiro-observability 2.0.0

package/dist/types.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Observability Types
+ *
+ * @requirement REQ-OBS-001, REQ-OBS-002
+ * @design DES-KATASHIRO-003-OBS §3.1
+ */
+/**
+ * スパンステータス
+ */
+export type SpanStatus = {
+    code: 'OK';
+} | {
+    code: 'ERROR';
+    message: string;
+};
+/**
+ * 属性値型
+ */
+export type AttributeValue = string | number | boolean | string[] | number[];
+/**
+ * スパンイベント
+ */
+export interface SpanEvent {
+    name: string;
+    timestamp: string;
+    attributes?: Record<string, AttributeValue>;
+}
+/**
+ * スパンリンク
+ */
+export interface SpanLink {
+    traceId: string;
+    spanId: string;
+    attributes?: Record<string, AttributeValue>;
+}
+/**
+ * トレースレコード
+ */
+export interface TraceRecord {
+    /** トレースID（UUID） */
+    traceId: string;
+    /** スパンID（UUID） */
+    spanId: string;
+    /** 親スパンID */
+    parentSpanId?: string;
+    /** 操作名 */
+    name: string;
+    /** 開始時刻（ISO8601） */
+    startTime: string;
+    /** 終了時刻（ISO8601） */
+    endTime?: string;
+    /** 期間（ミリ秒） */
+    durationMs?: number;
+    /** ステータス */
+    status: SpanStatus;
+    /** 属性 */
+    attributes: Record<string, AttributeValue>;
+    /** イベント */
+    events: SpanEvent[];
+    /** リンク */
+    links: SpanLink[];
+}
+/**
+ * トレースコンテキスト
+ */
+export interface TraceContext {
+    traceId: string;
+    currentSpan: Span;
+}
+/**
+ * スパンインターフェース
+ */
+export interface Span {
+    readonly traceId: string;
+    readonly spanId: string;
+    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;
+}
+/**
+ * スパン作成オプション
+ */
+export interface SpanOptions {
+    attributes?: Record<string, AttributeValue>;
+    links?: SpanLink[];
+    recordInput?: boolean;
+    recordOutput?: boolean;
+}
+/**
+ * トレーサー設定
+ */
+export interface TracerConfig {
+    serviceName: string;
+    serviceVersion: string;
+    environment?: string;
+    /** サンプリングレート (0.0-1.0) */
+    sampling?: number;
+    exporters?: TraceExporter[];
+}
+/**
+ * トレースエクスポーターインターフェース
+ */
+export interface TraceExporter {
+    name: string;
+    export(record: TraceRecord): Promise<void>;
+    shutdown?(): Promise<void>;
+}
+/**
+ * メトリクスエクスポーターインターフェース
+ */
+export interface MetricsExporter {
+    name: string;
+    export(snapshot: MetricsSnapshot): Promise<void>;
+    shutdown?(): Promise<void>;
+}
+/**
+ * ヒストグラムデータ
+ */
+export interface HistogramData {
+    count: number;
+    sum: number;
+    min: number;
+    max: number;
+    avg: number;
+    p50: number;
+    p90: number;
+    p99: number;
+    buckets: Record<string, number>;
+}
+/**
+ * メトリクススナップショット
+ */
+export interface MetricsSnapshot {
+    timestamp: string;
+    counters: Record<string, number>;
+    gauges: Record<string, number>;
+    histograms: Record<string, HistogramData>;
+}
+/**
+ * ヘルスチェック結果
+ */
+export interface HealthCheckResult {
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    checks: Record<string, {
+        status: 'pass' | 'warn' | 'fail';
+        message?: string;
+        latencyMs?: number;
+    }>;
+    timestamp: string;
+}
+/**
+ * ヘルスチェック対象
+ */
+export interface HealthCheck {
+    name: string;
+    check(): Promise<{
+        status: 'pass' | 'warn' | 'fail';
+        message?: string;
+    }>;
+    timeout?: number;
+}
+//# 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;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU;IACV,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY;IACZ,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS;IACT,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C,WAAW;IACX,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,UAAU;IACV,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IACvD,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI,CAAC;IAChE,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI,CAAC;IAC1E,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpC,GAAG,IAAI,IAAI,CAAC;IACZ,QAAQ,IAAI,WAAW,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,MAAM,EAAE,MAAM,CACZ,MAAM,EACN;QACE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;QACjC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CACF,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Observability Types
+ *
+ * @requirement REQ-OBS-001, REQ-OBS-002
+ * @design DES-KATASHIRO-003-OBS §3.1
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@nahisaho/katashiro-observability",
+  "version": "2.0.0",
+  "description": "KATASHIRO Observability - トレーシング・メトリクス・ロギング",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "katashiro",
+    "observability",
+    "tracing",
+    "metrics",
+    "logging"
+  ],
+  "author": "nahisaho",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nahisaho/katashiro.git",
+    "directory": "packages/observability"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@nahisaho/katashiro-core": "2.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "@opentelemetry/api": "^1.7.0",
+    "langfuse": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@opentelemetry/api": {
+      "optional": true
+    },
+    "langfuse": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}