@r_masseater/cc-plugin-lib 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { HookLogger } from "./logger.js";
+export { wrapRun } from "./wrapRun.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,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { HookLogger } from "./logger.js";
+export { wrapRun } from "./wrapRun.js";

package/dist/logger.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Claude Code プラグイン用のロガー
+ *
+ * 並行実行に対応したファイルベースのロギングを提供する。
+ * ログは XDG_STATE_HOME/masseater-plugins/{hookName}/ に日別で保存される。
+ *
+ * @example
+ * ```typescript
+ * using logger = HookLogger.fromFile(import.meta.filename);
+ * logger.debug("Hook started");
+ * ```
+ */
+export declare class HookLogger {
+    private readonly logDir;
+    private readonly logger;
+    /**
+     * ファイルパスからHookLoggerを作成する
+     *
+     * @param filePath - import.meta.filename を渡す
+     */
+    static fromFile(filePath: string): HookLogger;
+    private constructor();
+    [Symbol.dispose](): void;
+    private getLogFilePath;
+    private ensureLogDir;
+    private cleanupOldLogs;
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+    fatal(message: string, error: unknown): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;GAWG;AACH,qBAAa,UAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IAErC;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU;IAM7C,OAAO;IA+BP,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAIxB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,cAAc;IAiBtB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQ5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQ3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQ3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQ5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;CAO5C"}

package/dist/logger.js

@@ -0,0 +1,125 @@
+import { existsSync, mkdirSync, readdirSync, unlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, join } from "node:path";
+import pino from "pino";
+const KEEP_COUNT = Number(process.env.MASSEATER_PLUGINS_KEEP_COUNT) || 30;
+function getHomeDir() {
+    const home = process.env.HOME ?? homedir();
+    if (!home) {
+        throw new Error("Could not determine home directory");
+    }
+    return home;
+}
+/**
+ * Claude Code プラグイン用のロガー
+ *
+ * 並行実行に対応したファイルベースのロギングを提供する。
+ * ログは XDG_STATE_HOME/masseater-plugins/{hookName}/ に日別で保存される。
+ *
+ * @example
+ * ```typescript
+ * using logger = HookLogger.fromFile(import.meta.filename);
+ * logger.debug("Hook started");
+ * ```
+ */
+export class HookLogger {
+    logDir;
+    logger;
+    /**
+     * ファイルパスからHookLoggerを作成する
+     *
+     * @param filePath - import.meta.filename を渡す
+     */
+    static fromFile(filePath) {
+        const fileName = basename(filePath);
+        const hookName = fileName.replace(/\.[^.]+$/, "");
+        return new HookLogger(hookName);
+    }
+    constructor(hookName) {
+        const home = getHomeDir();
+        const xdgStateHome = process.env.XDG_STATE_HOME ?? `${home}/.local/state`;
+        this.logDir = `${xdgStateHome}/masseater-plugins/${hookName}`;
+        this.ensureLogDir();
+        const logPath = this.getLogFilePath();
+        // pino with file transport
+        // sync: true + append: true for concurrent writes from multiple instances
+        // Each JSON line is atomic write (< PIPE_BUF)
+        this.logger = pino({
+            level: process.env.MASSEATER_PLUGINS_LOG_LEVEL ?? "debug",
+            timestamp: pino.stdTimeFunctions.isoTime,
+            base: { pid: process.pid, hook: hookName },
+            formatters: {
+                level: (label) => ({ level: label }),
+            },
+        }, pino.destination({
+            dest: logPath,
+            sync: true,
+            append: true,
+            mkdir: true,
+        }));
+        this.debug("Logger initialized");
+    }
+    [Symbol.dispose]() {
+        this.cleanupOldLogs();
+    }
+    getLogFilePath() {
+        const date = new Date().toISOString().split("T")[0];
+        return join(this.logDir, `${date}.log`);
+    }
+    ensureLogDir() {
+        if (!existsSync(this.logDir)) {
+            mkdirSync(this.logDir, { recursive: true });
+        }
+    }
+    cleanupOldLogs() {
+        if (!existsSync(this.logDir)) {
+            return;
+        }
+        const files = readdirSync(this.logDir)
+            .filter((f) => /^\d{4}-\d{2}-\d{2}\.log$/.test(f))
+            .sort()
+            .reverse();
+        const filesToDelete = files.slice(KEEP_COUNT);
+        for (const file of filesToDelete) {
+            unlinkSync(join(this.logDir, file));
+        }
+    }
+    debug(message, data) {
+        if (data) {
+            this.logger.debug(data, message);
+        }
+        else {
+            this.logger.debug(message);
+        }
+    }
+    info(message, data) {
+        if (data) {
+            this.logger.info(data, message);
+        }
+        else {
+            this.logger.info(message);
+        }
+    }
+    warn(message, data) {
+        if (data) {
+            this.logger.warn(data, message);
+        }
+        else {
+            this.logger.warn(message);
+        }
+    }
+    error(message, data) {
+        if (data) {
+            this.logger.error(data, message);
+        }
+        else {
+            this.logger.error(message);
+        }
+    }
+    fatal(message, error) {
+        const errorInfo = error instanceof Error
+            ? { message: error.message, stack: error.stack, name: error.name }
+            : { message: String(error) };
+        this.logger.fatal({ error: errorInfo }, message);
+    }
+}

package/dist/wrapRun.d.ts

@@ -0,0 +1,21 @@
+import type { HookLogger } from "./logger.js";
+type Awaitable<T> = T | Promise<T>;
+/**
+ * hook の run 関数をラップしてロギングとエラーハンドリングを追加する
+ *
+ * @example
+ * ```typescript
+ * const hook = defineHook({
+ *   trigger: { Stop: true },
+ *   run: wrapRun(logger, (context) => {
+ *     // hook logic
+ *     return context.success({});
+ *   }),
+ * });
+ * ```
+ */
+export declare function wrapRun<TContext extends {
+    input: unknown;
+}, TResult>(logger: HookLogger, run: (context: TContext) => Awaitable<TResult>): (context: TContext) => Promise<TResult>;
+export {};
+//# sourceMappingURL=wrapRun.d.ts.map

package/dist/wrapRun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapRun.d.ts","sourceRoot":"","sources":["../src/wrapRun.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEnC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,QAAQ,SAAS;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,EAAE,OAAO,EACnE,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS,CAAC,OAAO,CAAC,GAC5C,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAYzC"}

package/dist/wrapRun.js

@@ -0,0 +1,28 @@
+/**
+ * hook の run 関数をラップしてロギングとエラーハンドリングを追加する
+ *
+ * @example
+ * ```typescript
+ * const hook = defineHook({
+ *   trigger: { Stop: true },
+ *   run: wrapRun(logger, (context) => {
+ *     // hook logic
+ *     return context.success({});
+ *   }),
+ * });
+ * ```
+ */
+export function wrapRun(logger, run) {
+    return async (context) => {
+        logger.debug("Hook triggered", { input: context.input });
+        try {
+            const result = await run(context);
+            logger.debug("Hook completed");
+            return result;
+        }
+        catch (error) {
+            logger.fatal("Hook failed", error);
+            throw error;
+        }
+    };
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+	"name": "@r_masseater/cc-plugin-lib",
+	"version": "0.0.1",
+	"description": "Common library for Claude Code plugins - logging and error handling utilities",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": ["dist"],
+	"scripts": {
+		"build": "tsc",
+		"check": "biome check",
+		"check:fix": "biome check --write",
+		"prepublishOnly": "bun run build"
+	},
+	"dependencies": {
+		"pino": "^9.6.0"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.3.8",
+		"@types/bun": "^1.3.4",
+		"typescript": "^5.9.3"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/masseater/claude-code-plugin"
+	},
+	"keywords": ["claude-code", "plugin", "hooks", "logging"],
+	"author": "masseater",
+	"license": "MIT"
+}