@diegoaltoworks/chatter 0.12.0 → 0.14.0

package/dist/auth/index.d.ts

@@ -3,6 +3,6 @@
  *
  * Re-exports authentication-related classes and functions.
  */
-export { ApiKeyManager } from "./apikeys";
 export type { ApiKeyOptions, ApiKeyPayload, VerifyResult } from "./apikeys";
+export { ApiKeyManager } from "./apikeys";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/bin/create-apikey.js

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+"use strict";
+
+// src/auth/apikeys.ts
+var import_node_crypto = require("node:crypto");
+var import_jose = require("jose");
+var ApiKeyManager = class {
+  constructor(secret) {
+    this.secret = secret;
+    if (!secret) {
+      throw new Error("API key secret is required");
+    }
+    this.secretBytes = new TextEncoder().encode(secret);
+  }
+  secret;
+  secretBytes;
+  /**
+   * Create a new API key
+   *
+   * @param options - API key options
+   * @returns JWT token string
+   */
+  async create(options = {}) {
+    const keyId = (0, import_node_crypto.randomUUID)();
+    const keyName = options.name || "api-key";
+    const expiresIn = options.expiresIn || "365d";
+    const expirationMs = this.parseExpiration(expiresIn);
+    const expiresAt = new Date(Date.now() + expirationMs);
+    const jwt = await new import_jose.SignJWT({
+      name: keyName,
+      type: "api_key",
+      ...options.claims
+    }).setProtectedHeader({ alg: "HS256" }).setSubject(keyId).setIssuedAt().setExpirationTime(expiresAt).sign(this.secretBytes);
+    return jwt;
+  }
+  /**
+   * Verify an API key
+   *
+   * @param token - JWT token to verify
+   * @returns Verification result with payload if valid
+   */
+  async verify(token) {
+    try {
+      const { payload } = await (0, import_jose.jwtVerify)(token, this.secretBytes);
+      if (payload.type !== "api_key") {
+        return {
+          valid: false,
+          error: "Token is not an API key"
+        };
+      }
+      return {
+        valid: true,
+        payload
+      };
+    } catch (error) {
+      return {
+        valid: false,
+        error: error instanceof Error ? error.message : "Verification failed"
+      };
+    }
+  }
+  /**
+   * Parse expiration string to milliseconds
+   *
+   * @param expiresIn - Time string (e.g., "1y", "30d", "12h")
+   * @returns Milliseconds
+   */
+  parseExpiration(expiresIn) {
+    const match = expiresIn.match(/^(\d+)([smhdMy])$/);
+    if (!match) {
+      throw new Error(
+        `Invalid expiration format: ${expiresIn}. Supported: s (seconds), m (minutes), h (hours), d (days), M (months), y (years)`
+      );
+    }
+    const value = Number.parseInt(match[1], 10);
+    const unit = match[2];
+    switch (unit) {
+      case "s":
+        return value * 1e3;
+      case "m":
+        return value * 60 * 1e3;
+      case "h":
+        return value * 60 * 60 * 1e3;
+      case "d":
+        return value * 24 * 60 * 60 * 1e3;
+      case "M":
+        return value * 30 * 24 * 60 * 60 * 1e3;
+      // Approximate 30 days
+      case "y":
+        return value * 365 * 24 * 60 * 60 * 1e3;
+      // Approximate 365 days
+      default:
+        throw new Error(`Unknown time unit: ${unit}`);
+    }
+  }
+  /**
+   * Get information about a token without verifying signature
+   * Useful for debugging
+   *
+   * @param token - JWT token
+   * @returns Decoded payload (unverified)
+   */
+  decode(token) {
+    try {
+      const parts = token.split(".");
+      if (parts.length !== 3) {
+        return null;
+      }
+      const payload = JSON.parse(Buffer.from(parts[1], "base64url").toString("utf-8"));
+      return payload;
+    } catch {
+      return null;
+    }
+  }
+};
+
+// bin/create-apikey.ts
+async function main() {
+  const args = process.argv.slice(2);
+  const options = {};
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--name" && args[i + 1]) {
+      options.name = args[i + 1];
+      i++;
+    } else if (args[i] === "--expires-in" && args[i + 1]) {
+      options.expiresIn = args[i + 1];
+      i++;
+    } else if (args[i] === "--help" || args[i] === "-h") {
+      console.log(`
+Chatter API Key Generator
+
+Usage:
+  npx chatter create-apikey [options]
+
+Options:
+  --name <name>          Name/label for the API key (default: "api-key")
+  --expires-in <time>    Expiration time (default: "365d")
+                         Formats: s=seconds, m=minutes, h=hours, d=days, M=months, y=years
+                         Examples: 30d, 12h, 1y, 6M
+
+Environment:
+  CHATTER_SECRET         Required. Secret key for signing JWT tokens
+
+Examples:
+  npx chatter create-apikey --name "mobile-app" --expires-in 365d
+  npx chatter create-apikey --name "test-key" --expires-in 1h
+      `);
+      process.exit(0);
+    }
+  }
+  const secret = process.env.CHATTER_SECRET;
+  if (!secret) {
+    console.error("\u274C Error: CHATTER_SECRET environment variable is not set");
+    console.error("\n   Please set it before running this command:");
+    console.error("   export CHATTER_SECRET=your-secret-key-here");
+    console.error("\n   Or prefix the command:");
+    console.error("   CHATTER_SECRET=your-secret npx chatter create-apikey\n");
+    process.exit(1);
+  }
+  const manager = new ApiKeyManager(secret);
+  const keyName = options.name || "api-key";
+  const expiresIn = options.expiresIn || "365d";
+  try {
+    const apiKey = await manager.create({
+      name: keyName,
+      expiresIn
+    });
+    const payload = manager.decode(apiKey);
+    if (!payload) {
+      throw new Error("Failed to decode generated API key");
+    }
+    const expiresAt = new Date((payload.exp || 0) * 1e3);
+    const issuedAt = new Date((payload.iat || 0) * 1e3);
+    console.log("\n\u2705 API Key generated successfully!\n");
+    console.log(`   Name:       ${keyName}`);
+    console.log(`   ID:         ${payload.sub}`);
+    console.log(`   Issued:     ${issuedAt.toISOString()}`);
+    console.log(`   Expires:    ${expiresAt.toISOString()} (${expiresIn})`);
+    console.log(`
+   API Key:
+   ${apiKey}
+`);
+    console.log("   Usage:");
+    console.log("   curl -X POST https://your-bot.example.com/api/public/chat \\");
+    console.log(`     -H "x-api-key: ${apiKey.slice(0, 50)}..." \\`);
+    console.log('     -H "Content-Type: application/json" \\');
+    console.log(`     -d '{"message": "Hello"}'`);
+    console.log("");
+  } catch (error) {
+    console.error("\u274C Error creating API key:", error);
+    process.exit(1);
+  }
+}
+main();

package/dist/client/index.d.ts

@@ -2,6 +2,6 @@
  * Client library entry point
  * Re-exports all client widgets and types
  */
-export { ChatBot, Chat, ChatButton } from "./src";
-export type { ChatBotConfig, ChatConfig, ChatButtonConfig, ChatMessage, ChatMode, StreamCallbacks, } from "./src/types";
+export { Chat, ChatBot, ChatButton } from "./src";
+export type { ChatBotConfig, ChatButtonConfig, ChatConfig, ChatMessage, ChatMode, StreamCallbacks, } from "./src/types";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAClD,YAAY,EACV,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,eAAe,GAChB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAClD,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,QAAQ,EACR,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/dist/client/src/browser.d.ts

@@ -14,5 +14,5 @@ declare global {
         };
     }
 }
-export { ChatBot, Chat, ChatButton };
+export { Chat, ChatBot, ChatButton };
 //# sourceMappingURL=browser.d.ts.map

package/dist/client/src/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/client/src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,OAAO,EAAE;YACP,OAAO,EAAE,OAAO,OAAO,CAAC;YACxB,IAAI,EAAE,OAAO,IAAI,CAAC;YAClB,UAAU,EAAE,OAAO,UAAU,CAAC;SAC/B,CAAC;KACH;CACF;AAWD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/client/src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,OAAO,EAAE;YACP,OAAO,EAAE,OAAO,OAAO,CAAC;YACxB,IAAI,EAAE,OAAO,IAAI,CAAC;YAClB,UAAU,EAAE,OAAO,UAAU,CAAC;SAC/B,CAAC;KACH;CACF;AAWD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/client/src/index.d.ts

@@ -2,8 +2,8 @@
  * @diegoaltoworks/chatter
  * Isomorphic TypeScript chatbot client for AI chat API
  */
-export { ChatBot } from "./ChatBot";
 export { Chat } from "./Chat";
+export { ChatBot } from "./ChatBot";
 export { ChatButton } from "./ChatButton";
-export type { ChatMode, ChatBotConfig, ChatMessage, ChatResponse, StreamCallbacks, ChatConfig, ChatButtonConfig, } from "./types";
+export type { ChatBotConfig, ChatButtonConfig, ChatConfig, ChatMessage, ChatMode, ChatResponse, StreamCallbacks, } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/client/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EACV,QAAQ,EACR,aAAa,EACb,WAAW,EACX,YAAY,EACZ,eAAe,EACf,UAAU,EACV,gBAAgB,GACjB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/core/widgets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widgets.d.ts","sourceRoot":"","sources":["../../src/core/widgets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,gBAAgB,CA4BxE"}
+{"version":3,"file":"widgets.d.ts","sourceRoot":"","sources":["../../src/core/widgets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAwBxE"}

package/dist/index.d.ts

@@ -10,28 +10,27 @@
  *
  * @packageDocumentation
  */
-export { createServer } from "./server";
-export type { ChatterConfig, ServerDependencies } from "./types";
-export { createMCPServer } from "./mcp-server";
-export type { MCPServerOptions, MCPTransportMode } from "./mcp-server";
-export { VectorStore } from "./core/retrieval";
+export type { ApiKeyOptions, ApiKeyPayload, VerifyResult } from "./auth";
+export { ApiKeyManager } from "./auth";
+export type { ChatBotConfig, ChatButtonConfig, ChatConfig, ChatMessage, ChatMode, StreamCallbacks, } from "./client";
+export { Chat, ChatBot, ChatButton } from "./client";
+export { detectLeakage, scrubOutput } from "./core/guardrails";
 export { completeOnce, completeStream } from "./core/llm";
 export { loadKnowledge } from "./core/loaders";
 export { PromptLoader } from "./core/prompts";
-export { detectLeakage, scrubOutput } from "./core/guardrails";
-export { createSession, validateSession, getSessionInfo, getActiveSessions, } from "./core/session";
-export { ApiKeyManager } from "./auth";
-export type { ApiKeyOptions, ApiKeyPayload, VerifyResult } from "./auth";
+export { VectorStore } from "./core/retrieval";
+export { createSession, getActiveSessions, getSessionInfo, validateSession, } from "./core/session";
+export type { MCPServerOptions, MCPTransportMode } from "./mcp-server";
+export { createMCPServer } from "./mcp-server";
 export { createAuthMiddleware } from "./middleware/auth";
-export { createJWTMiddleware } from "./middleware/jwt";
 export { cors } from "./middleware/cors";
+export { createJWTMiddleware } from "./middleware/jwt";
 export { createRateLimiter } from "./middleware/ratelimit";
 export { createReferrerCheck } from "./middleware/referrer";
 export { createSessionMiddleware } from "./middleware/session";
-export { publicRoutes } from "./routes/public";
-export { privateRoutes } from "./routes/private";
 export { demoRoutes } from "./routes/demo";
-export { ChatBot, Chat, ChatButton } from "./client";
-export type { ChatBotConfig, ChatConfig, ChatButtonConfig, ChatMessage, ChatMode, StreamCallbacks, } from "./client";
-export type { BotIdentity, BotBranding, BotChatConfig, KnowledgeDocument, EmbeddingChunk, } from "./types";
+export { privateRoutes } from "./routes/private";
+export { publicRoutes } from "./routes/public";
+export { createServer } from "./server";
+export type { BotBranding, BotChatConfig, BotIdentity, ChatterConfig, EmbeddingChunk, KnowledgeDocument, ServerDependencies, } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGjE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGvE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EACL,aAAa,EACb,eAAe,EACf,cAAc,EACd,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EACV,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,eAAe,GAChB,MAAM,UAAU,CAAC;AAGlB,YAAY,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,cAAc,GACf,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,QAAQ,EACR,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,YAAY,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}