@fronx/use-claude-code 0.1.0

package/dist/server/sse-emitter.js

@@ -0,0 +1,56 @@
+/**
+ * Server-Sent Events (SSE) response formatting helpers.
+ *
+ * These utilities help format SSE responses according to the specification,
+ * with proper event names and JSON data payloads.
+ */
+/**
+ * Set up an HTTP response for SSE streaming.
+ *
+ * @param res - The HTTP response object
+ */
+export function setupSSEResponse(res) {
+    res.setHeader('Content-Type', 'text/event-stream');
+    res.setHeader('Cache-Control', 'no-cache');
+    res.setHeader('Connection', 'keep-alive');
+}
+/**
+ * Send a Server-Sent Event to a single response.
+ *
+ * @param res - The HTTP response object
+ * @param event - The event type (e.g., 'init', 'assistant', 'result')
+ * @param data - The event data (will be JSON stringified)
+ */
+export function sendSSE(res, event, data) {
+    if (!res.destroyed) {
+        res.write(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`);
+    }
+}
+/**
+ * Broadcast an SSE event to multiple responses.
+ *
+ * @param responses - Set of HTTP response objects
+ * @param event - The event type
+ * @param data - The event data (will be JSON stringified)
+ */
+export function broadcastSSE(responses, event, data) {
+    responses.forEach((res) => {
+        sendSSE(res, event, data);
+    });
+}
+/**
+ * Broadcast an SSE event with a session ID attached.
+ *
+ * This is important for clients to filter out stale events from previous
+ * sessions (e.g., when clear() is called mid-stream).
+ *
+ * @param responses - Set of HTTP response objects
+ * @param event - The event type
+ * @param data - The event data (sessionId will be added)
+ * @param sessionId - The current session ID
+ */
+export function broadcastSSEWithSession(responses, event, data, sessionId) {
+    const dataWithSession = { ...data, sessionId };
+    broadcastSSE(responses, event, dataWithSession);
+}
+//# sourceMappingURL=sse-emitter.js.map

package/dist/server/sse-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-emitter.js","sourceRoot":"","sources":["../../src/server/sse-emitter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAmB;IAClD,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;IACnD,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;IAC3C,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,GAAmB,EAAE,KAAa,EAAE,IAAa;IACvE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACnB,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,WAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,SAA8B,EAC9B,KAAa,EACb,IAAa;IAEb,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACxB,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CACrC,SAA8B,EAC9B,KAAa,EACb,IAA6B,EAC7B,SAAiB;IAEjB,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC;IAC/C,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;AAClD,CAAC"}

package/dist/shared/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './tool-utils.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/shared/index.js

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './tool-utils.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/shared/tool-utils.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Utility functions for extracting human-readable information from tool invocations.
+ */
+/**
+ * Extract the most relevant parameter from a tool invocation for display.
+ *
+ * @param toolName - The name of the tool being invoked
+ * @param input - The tool's input parameters
+ * @returns The most relevant parameter value, or undefined
+ *
+ * @example
+ * getRelevantToolParam('Read', { file_path: '/src/index.ts' }) // '/src/index.ts'
+ * getRelevantToolParam('Bash', { command: 'npm test' }) // 'npm test'
+ * getRelevantToolParam('Grep', { pattern: 'TODO' }) // 'TODO'
+ */
+export declare function getRelevantToolParam(toolName: string, input: Record<string, unknown> | undefined): string | undefined;
+/**
+ * Format a tool invocation for display.
+ *
+ * @param toolName - The name of the tool being invoked
+ * @param input - The tool's input parameters
+ * @returns A formatted string like "**Read** /src/index.ts"
+ */
+export declare function formatToolUse(toolName: string, input: Record<string, unknown> | undefined): string;
+//# sourceMappingURL=tool-utils.d.ts.map

package/dist/shared/tool-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-utils.d.ts","sourceRoot":"","sources":["../../src/shared/tool-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACzC,MAAM,GAAG,SAAS,CAkBpB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACzC,MAAM,CAQR"}

package/dist/shared/tool-utils.js

@@ -0,0 +1,49 @@
+/**
+ * Utility functions for extracting human-readable information from tool invocations.
+ */
+/**
+ * Extract the most relevant parameter from a tool invocation for display.
+ *
+ * @param toolName - The name of the tool being invoked
+ * @param input - The tool's input parameters
+ * @returns The most relevant parameter value, or undefined
+ *
+ * @example
+ * getRelevantToolParam('Read', { file_path: '/src/index.ts' }) // '/src/index.ts'
+ * getRelevantToolParam('Bash', { command: 'npm test' }) // 'npm test'
+ * getRelevantToolParam('Grep', { pattern: 'TODO' }) // 'TODO'
+ */
+export function getRelevantToolParam(toolName, input) {
+    if (!input)
+        return undefined;
+    switch (toolName) {
+        case 'Read':
+        case 'Write':
+        case 'Edit':
+            return input.file_path;
+        case 'Bash':
+            return input.command;
+        case 'Glob':
+        case 'Grep':
+            return input.pattern;
+        case 'LS':
+            return input.path;
+        default:
+            return undefined;
+    }
+}
+/**
+ * Format a tool invocation for display.
+ *
+ * @param toolName - The name of the tool being invoked
+ * @param input - The tool's input parameters
+ * @returns A formatted string like "**Read** /src/index.ts"
+ */
+export function formatToolUse(toolName, input) {
+    const param = getRelevantToolParam(toolName, input);
+    if (param) {
+        return `**${toolName}** ${param}`;
+    }
+    return `**${toolName}**`;
+}
+//# sourceMappingURL=tool-utils.js.map

package/dist/shared/tool-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-utils.js","sourceRoot":"","sources":["../../src/shared/tool-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,KAA0C;IAE1C,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAE7B,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,SAA+B,CAAC;QAC/C,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,OAA6B,CAAC;QAC7C,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,OAA6B,CAAC;QAC7C,KAAK,IAAI;YACP,OAAO,KAAK,CAAC,IAA0B,CAAC;QAC1C;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,KAA0C;IAE1C,MAAM,KAAK,GAAG,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAEpD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,KAAK,QAAQ,MAAM,KAAK,EAAE,CAAC;IACpC,CAAC;IAED,OAAO,KAAK,QAAQ,IAAI,CAAC;AAC3B,CAAC"}

package/dist/shared/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Core types shared between server and client
+ */
+export interface Message {
+    id: string;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    timestamp?: Date;
+    hidden?: boolean;
+}
+export type StreamSegment = {
+    type: 'text';
+    content: string;
+} | {
+    type: 'tool';
+    name: string;
+    param?: string;
+};
+export type ClaudeError = {
+    code: 'rate_limit';
+    message: string;
+    retryAfter?: number;
+} | {
+    code: 'auth_failed';
+    message: string;
+} | {
+    code: 'credit_limit';
+    message: string;
+} | {
+    code: 'process_crashed';
+    message: string;
+    exitCode: number;
+} | {
+    code: 'network';
+    message: string;
+} | {
+    code: 'unknown';
+    message: string;
+};
+export type SSEEvent = {
+    type: 'init';
+    sessionId: string;
+    resumed?: boolean;
+    prewarmed?: boolean;
+} | {
+    type: 'history';
+    messages: Message[];
+    sessionId: string;
+} | {
+    type: 'assistant';
+    text: string;
+    sessionId?: string;
+} | {
+    type: 'tool';
+    name: string;
+    param?: string;
+    sessionId?: string;
+} | {
+    type: 'result';
+    result: string;
+    sessionId?: string;
+} | {
+    type: 'user';
+    content: string;
+    sessionId?: string;
+} | {
+    type: 'error';
+    error: ClaudeError;
+} | {
+    type: 'closed';
+    code?: number;
+} | {
+    type: 'cleared';
+} | {
+    type: 'stopped';
+};
+export interface ReconnectConfig {
+    maxRetries?: number;
+    baseDelay?: number;
+    maxDelay?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAGnD,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAGzC,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAGxB,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/shared/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core types shared between server and client
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/shared/types.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@fronx/use-claude-code",
+  "version": "0.1.0",
+  "description": "Library for integrating Claude Code CLI into applications",
+  "type": "module",
+  "exports": {
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.0.0",
+    "typescript": "^5.0.0"
+  }
+}