katanakit-js 2.13.7 → 2.14.0

package/README.md

@@ -66,6 +66,236 @@ if (result.ok) {
 - **Tree-shakeable** — destructured re-exports from Singleton facades
 - **SSR-safe** — all infrastructure adapters guard or fall back gracefully in server environments
 
+## AI assistant (Kitt)
+
+`katanakit-js` ships a zero-dependency, provider-agnostic AI assistant and agent
+built on the OpenAI-compatible protocol (works with DashScope, OpenAI, and any
+compatible endpoint). It uses native `fetch`, so no SDK is required.
+
+Use the **low-level API** for one-shot chat and tool loops. Use **`useInitAssistant` / `useReply`**
+when you want sessions, persistence, and channels (REST, Telegram, WhatsApp). Fallible calls
+follow the Safe Result pattern: they **never throw**. Check `result.ok` and read `result.data`
+or `result.error`.
+
+### Low-level API
+
+```ts
+import { useInitAgent, useChat, useRunAgent } from "katanakit-js";
+
+// Register once. apiKey falls back to process.env.DASHSCOPE_API_KEY.
+useInitAgent({ model: "qwen3.8-max" });
+
+// Assistant — single-shot review / question.
+const review = await useChat([
+  { role: "user", content: "Summarize the benefits of solar energy in three bullet points." },
+]);
+if (review.ok) console.log(review.data);
+
+// Agent — autonomous tool-calling loop that can act (read/write/run).
+const result = await useRunAgent("Fix the type errors in src/", {
+  tools: [
+    {
+      name: "readFile",
+      description: "Returns file contents",
+      parameters: { type: "object", properties: { path: { type: "string" } } },
+      execute: ({ path }) => fs.readFile(path, "utf8"),
+    },
+  ],
+  maxSteps: 12,
+});
+```
+
+- **Kitt preset** — `KITT_SYSTEM_PROMPT`, `kittPreset`, `KITT_BASE_URL`, and `KITT_DEFAULT_MODEL` (`qwen3.8-max`)
+  are exported as sensible defaults. Override via `useInitAgent({ systemPrompt, model, baseUrl })`.
+- **Safe Results** — `useChat` and `useRunAgent` return `{ data, error, ok }`, never throw.
+- **Tools** — each tool is `{ name, description, parameters (JSON Schema), execute(input) }`.
+
+### Use from another project
+
+```bash
+npm i katanakit-js express dotenv
+```
+
+```ts
+import "dotenv/config";
+import { useInitAssistant, useReply } from "katanakit-js";
+
+useInitAssistant({
+  // apiKey      — process.env.DASHSCOPE_API_KEY
+  // baseUrl     — KITT_BASE_URL
+  // model       — "qwen3.8-max"
+  // systemPrompt — KITT_SYSTEM_PROMPT
+  // store       — in-memory (useCreateMemoryStore)
+  // tools       — AiTool[]
+  // maxSteps    — number
+});
+
+const result = await useReply(undefined, "What are your hours?");
+if (result.ok) {
+  console.log(result.data.reply, result.data.sessionId);
+} else {
+  console.error(result.error.message);
+}
+```
+
+`useReply(sessionId | undefined, text)` creates a session when `sessionId` is omitted. Pass
+`result.data.sessionId` on later turns.
+
+Also on the main barrel:
+
+| Helper | Signature |
+|--------|-----------|
+| `useCreateSession` | `(channel?) => Promise<string>` |
+| `useGetHistory` | `(sessionId) => Promise<AiMessage[]>` |
+| `useResetSession` | `(sessionId) => Promise<void>` |
+| `useCreateMemoryStore` | `() => ConversationStore` |
+
+Then start a channel (see below). Copy keys from [`.env.example`](.env.example):
+
+```env
+DASHSCOPE_API_KEY=
+PORT=3000
+HOST=localhost
+KITT_CHANNEL=rest
+TELEGRAM_BOT_TOKEN=
+WHATSAPP_TOKEN=
+WHATSAPP_PHONE_NUMBER_ID=
+WHATSAPP_VERIFY_TOKEN=
+DATABASE_URL=
+```
+
+### Run standalone (this repo)
+
+| Script | Starts |
+|--------|--------|
+| `yarn assistant:dev` | REST assistant. Uses Prisma when `DATABASE_URL` is set. |
+| `yarn telegram:dev` | Telegram long polling. Requires `TELEGRAM_BOT_TOKEN`. |
+| `yarn whatsapp:dev` | WhatsApp webhook. Requires `WHATSAPP_*`. |
+| `yarn assistant:demo` | Demo in `examples/assistant/`. Set `KITT_CHANNEL=rest\|telegram\|whatsapp`. |
+
+### REST
+
+```ts
+import { useStartAssistant, useCreateAssistantRouter } from "katanakit-js/adapters/assistant";
+
+useStartAssistant(); // port?, host?, mountPath = "/assistant", options?
+// or mount useCreateAssistantRouter() on an existing Express app
+```
+
+| Method | Path | Body | Response |
+|--------|------|------|----------|
+| `POST` | `/assistant/chat` | `{ sessionId?, message }` | `{ ok, data: { reply, sessionId }, error }` |
+| `GET` | `/assistant/sessions/:id` | — | `{ sessionId, messages }` or `404` |
+| `DELETE` | `/assistant/sessions/:id` | — | `204` or `404` |
+
+The endpoints are **public by default**. In production pass an auth guard (applied to every
+route). Unknown session ids return `404`, and `useReply` rejects a `sessionId` that does not exist.
+
+```ts
+useStartAssistant(3000, "localhost", "/assistant", {
+  guard: (req, res, next) =>
+    req.header("authorization") === `Bearer ${process.env.ASSISTANT_API_KEY}`
+      ? next()
+      : res.status(401).end(),
+});
+```
+
+```bash
+curl -X POST http://localhost:3000/assistant/chat \
+  -H 'Content-Type: application/json' \
+  -d '{"message":"What are your hours?"}'
+```
+
+#### Rate limiting
+
+POST `/chat` and POST `/whatsapp/webhook` are rate-limited by default (20 req/min and 60 req/min per IP). Override via the router options:
+
+```ts
+app.use("/assistant", useCreateAssistantRouter({
+  rateLimit: rateLimit({ windowMs: 60_000, max: 30 }),
+}));
+```
+
+### Telegram (BotFather)
+
+Long polling does not need a public URL. Session ids are `telegram:<chatId>`.
+
+```ts
+import { useInitTelegram, useStartTelegramPolling } from "katanakit-js/adapters/telegram";
+
+useInitTelegram({ token: process.env.TELEGRAM_BOT_TOKEN });
+await useStartTelegramPolling();
+```
+
+1. Open Telegram, talk to [@BotFather](https://t.me/BotFather).
+2. Send `/newbot` — choose a name and a username.
+3. Copy the token.
+4. Set `TELEGRAM_BOT_TOKEN`.
+5. Run `yarn telegram:dev` (long polling, no public URL).
+6. Optional webhook: expose HTTPS and call `useHandleTelegramUpdate(update)` on inbound updates.
+
+### WhatsApp (Meta Cloud API)
+
+Webhook: `GET` / `POST` `/whatsapp/webhook`. Session ids are `wa:<phone>`.
+
+```ts
+import { useInitWhatsApp, useStartWhatsApp } from "katanakit-js/adapters/whatsapp";
+
+useInitWhatsApp({
+  token: process.env.WHATSAPP_TOKEN,
+  phoneNumberId: process.env.WHATSAPP_PHONE_NUMBER_ID,
+  verifyToken: process.env.WHATSAPP_VERIFY_TOKEN,
+  appSecret: process.env.WHATSAPP_APP_SECRET,
+});
+useStartWhatsApp();
+```
+
+1. Create a Meta Business account and an app.
+2. Add the WhatsApp product.
+3. Copy the temporary or permanent token, the Phone number ID, and the **App Secret**.
+4. Set `WHATSAPP_TOKEN`, `WHATSAPP_PHONE_NUMBER_ID`, `WHATSAPP_VERIFY_TOKEN`, and `WHATSAPP_APP_SECRET`.
+5. Run `yarn whatsapp:dev`.
+6. Expose public HTTPS (Cloudflare Tunnel or ngrok) to `GET`/`POST` `/whatsapp/webhook`.
+7. In Meta, set the webhook URL and verify token; subscribe to `messages`.
+
+Inbound deliveries are verified against `X-Hub-Signature-256` (HMAC-SHA256 of the raw body
+with your App Secret) and rejected with `401` when the signature is missing or invalid. The
+webhook acks `200` immediately and processes replies asynchronously to avoid Meta retries.
+POST `/webhook` is rate-limited to 60 req/min per IP; at most 5 messages are processed per
+webhook payload (cost-amplification guard).
+
+`useVerifyWhatsAppWebhook`, `useVerifyWhatsAppSignature`, and `useHandleWhatsAppMessage` are the same handlers if you mount the webhook on your own server.
+
+### Persistence
+
+Memory by default (`useCreateMemoryStore()`). History is lost on process restart.
+
+Prisma when `DATABASE_URL` is set:
+
+```ts
+import { useInitAssistant } from "katanakit-js";
+import { useCreatePrismaStore, PrismaConversationStore } from "katanakit-js/prisma";
+
+useInitAssistant({ store: useCreatePrismaStore() });
+// or: { store: PrismaConversationStore }
+```
+
+Models `Conversation` and `Message` are already in `src/prisma/schema.prisma`. If the consumer
+owns the database, run `prisma contract emit` then `prisma db init` in that app.
+
+### Real use case
+
+[`examples/assistant/`](examples/assistant/) is a generic digital assistant with two demo tools:
+`readFile` on `knowledge-base.md` and `saveNote` to `notes.jsonl`.
+
+```bash
+yarn assistant:demo
+# KITT_CHANNEL=rest|telegram|whatsapp
+```
+
+Replace the system prompt, `knowledge-base.md`, and the tool `execute()` functions with your
+product FAQ, CRM, or ticket system. Keep the `{ name, description, parameters, execute }` shape.
+
 ## Framework usage
 
 All common `use*` helpers (`useLogger`, `useInitApis`, `useGetApi`, formatter, dates, utils, theme, …) are on the **main barrel** `katanakit-js`.
@@ -120,6 +350,9 @@ See [Getting Started](https://senseikatana.github.io/katanakit-js/docs/guides/ge
 | **Nuxt** | `katanakit-js/adapters/nuxt` | `useUnwrap`, `useSafeResponse`, `useEventResponse` |
 | **Vue** | `katanakit-js/adapters/vue` | `useKatanaFetch` composable with reactivity |
 | **Astro** | `katanakit-js` or `katanakit-js/adapters/astro` | `AstroService`, `RssService` |
+| **Assistant** | `katanakit-js/adapters/assistant` | REST digital assistant (`useStartAssistant`) |
+| **Telegram** | `katanakit-js/adapters/telegram` | BotFather bot (`useInitTelegram`, `useStartTelegramPolling`) |
+| **WhatsApp** | `katanakit-js/adapters/whatsapp` | Meta Cloud API (`useInitWhatsApp`, `useStartWhatsApp`) |
 
 ## Documentation
 

package/dist/adapters/assistant/assistant.service.d.ts

@@ -0,0 +1,27 @@
+import { type RequestHandler, Router } from "express";
+/** Options for the assistant HTTP router. */
+export interface AssistantRouterOptions {
+    /** Optional auth guard (e.g. Bearer token). Applied before every route. */
+    guard?: RequestHandler;
+    /** Optional rate limiter for POST /chat. Defaults to 20 req/min per IP. */
+    rateLimit?: RequestHandler;
+}
+/** Builds a fresh Express router exposing the assistant over HTTP. */
+export declare function useCreateAssistantRouter(options?: AssistantRouterOptions): Router;
+/**
+ * Mounts the assistant routes on the shared Express app and starts the server.
+ * Idempotent — subsequent calls are no-ops.
+ *
+ * @param port - Port to listen on (default: 3000)
+ * @param host - Host to bind to (default: "localhost")
+ * @param mountPath - Base path for the assistant routes (default: "/assistant")
+ * @param options - Router options (e.g. an auth `guard`)
+ *
+ * @example
+ * ```ts
+ * useStartAssistant(3000, "localhost", "/assistant", { guard: requireAuth });
+ * // POST /assistant/chat
+ * ```
+ */
+export declare function useStartAssistant(port?: number, host?: string, mountPath?: string, options?: AssistantRouterOptions): void;
+//# sourceMappingURL=assistant.service.d.ts.map

package/dist/adapters/assistant/assistant.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant.service.d.ts","sourceRoot":"","sources":["../../../src/adapters/assistant/assistant.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,cAAc,EAAiB,MAAM,EAAE,MAAM,SAAS,CAAC;AAWnF,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACtC,2EAA2E;IAC3E,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,cAAc,CAAC;CAC3B;AAWD,sEAAsE;AACtE,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,sBAA2B,GAAG,MAAM,CAmDrF;AAKD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAChC,IAAI,SAAO,EACX,IAAI,SAAc,EAClB,SAAS,SAAe,EACxB,OAAO,GAAE,sBAA2B,GAClC,IAAI,CAMN"}

package/dist/adapters/assistant/assistant.service.js

@@ -0,0 +1,76 @@
+import { Router } from "express";
+import rateLimit from "express-rate-limit";
+import { useGetHistory, useReply, useResetSession, useSessionExists, } from "../../core/services/assistant.service.js";
+import { useExpressGetApp, useExpressStart } from "../express/server.js";
+/** Default rate limiter: 20 requests per minute per IP. */
+const defaultChatRateLimit = rateLimit({
+    windowMs: 60_000,
+    max: 20,
+    standardHeaders: "draft-7",
+    legacyHeaders: false,
+    message: { ok: false, data: null, error: { message: "Too many requests", status: 429 } },
+});
+/** Builds a fresh Express router exposing the assistant over HTTP. */
+export function useCreateAssistantRouter(options = {}) {
+    const router = Router();
+    if (options.guard) {
+        router.use(options.guard);
+    }
+    router.post("/chat", options.rateLimit ?? defaultChatRateLimit, async (request, response) => {
+        const { sessionId, message } = (request.body ?? {});
+        if (typeof message !== "string" || message.trim() === "") {
+            response.status(400).json({
+                ok: false,
+                data: null,
+                error: { message: "Field `message` is required", status: 400 },
+            });
+            return;
+        }
+        const result = await useReply(sessionId, message);
+        response.status(result.ok ? 200 : 502).json(result);
+    });
+    router.get("/sessions/:id", async (request, response) => {
+        const id = String(request.params.id);
+        if (!(await useSessionExists(id))) {
+            response.status(404).json({ error: "Session not found" });
+            return;
+        }
+        const messages = await useGetHistory(id);
+        response.json({ sessionId: id, messages });
+    });
+    router.delete("/sessions/:id", async (request, response) => {
+        const id = String(request.params.id);
+        if (!(await useSessionExists(id))) {
+            response.status(404).json({ error: "Session not found" });
+            return;
+        }
+        await useResetSession(id);
+        response.status(204).end();
+    });
+    return router;
+}
+/** Module-level mount guard for the standalone assistant. */
+let mounted = false;
+/**
+ * Mounts the assistant routes on the shared Express app and starts the server.
+ * Idempotent — subsequent calls are no-ops.
+ *
+ * @param port - Port to listen on (default: 3000)
+ * @param host - Host to bind to (default: "localhost")
+ * @param mountPath - Base path for the assistant routes (default: "/assistant")
+ * @param options - Router options (e.g. an auth `guard`)
+ *
+ * @example
+ * ```ts
+ * useStartAssistant(3000, "localhost", "/assistant", { guard: requireAuth });
+ * // POST /assistant/chat
+ * ```
+ */
+export function useStartAssistant(port = 3000, host = "localhost", mountPath = "/assistant", options = {}) {
+    if (mounted)
+        return;
+    mounted = true;
+    useExpressGetApp().use(mountPath, useCreateAssistantRouter(options));
+    useExpressStart(port, host);
+}
+//# sourceMappingURL=assistant.service.js.map

package/dist/adapters/assistant/assistant.service.js.map

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

package/dist/adapters/assistant/index.d.ts

@@ -0,0 +1,2 @@
+export { useCreateAssistantRouter, useStartAssistant } from "./assistant.service.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/assistant/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/assistant/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/adapters/assistant/index.js

@@ -0,0 +1,2 @@
+export { useCreateAssistantRouter, useStartAssistant } from "./assistant.service.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/assistant/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/assistant/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/adapters/assistant/main.d.ts

@@ -0,0 +1,2 @@
+import "dotenv/config";
+//# sourceMappingURL=main.d.ts.map

package/dist/adapters/assistant/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/adapters/assistant/main.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC"}

package/dist/adapters/assistant/main.js

@@ -0,0 +1,12 @@
+import "dotenv/config";
+import { useInitAssistant } from "../../core/services/assistant.service.js";
+import { useStartAssistant } from "./assistant.service.js";
+if (process.env.DATABASE_URL) {
+    const { useCreatePrismaStore } = await import("../../prisma/assistant.store.js");
+    useInitAssistant({ store: useCreatePrismaStore() });
+}
+else {
+    useInitAssistant();
+}
+useStartAssistant(Number(process.env.PORT ?? 3000), process.env.HOST ?? "localhost");
+//# sourceMappingURL=main.js.map

package/dist/adapters/assistant/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/adapters/assistant/main.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAEvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;IAC9B,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;IACjF,gBAAgB,CAAC,EAAE,KAAK,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAC;AACrD,CAAC;KAAM,CAAC;IACP,gBAAgB,EAAE,CAAC;AACpB,CAAC;AAED,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,WAAW,CAAC,CAAC"}

package/dist/adapters/astro/astro.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"astro.service.d.ts","sourceRoot":"","sources":["../../../src/adapters/astro/astro.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,SAAS,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,CAAC,EAC9E,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,GAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAM,GAC3C,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAkB7B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,sBAAsB,CAC3C,KAAK,GAAG,OAAO,EACf,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,EAEnC,eAAe,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,EAC9E,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,YAAY,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAM,GACpE,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAe1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAClC,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,GACpC,CAAC,GAAG,IAAI,CAQV;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,MAAM,SAAS,MAAM,GAAG,MAAM,EAC3E,KAAK,EAAE,CAAC,EAAE,EACV,QAAQ,SAAK,EACb,KAAK,GAAE,MAAyB,GAC9B,SAAS,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAYzC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,EACrE,MAAM,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAC3B,KAAK,GAAE,MAAyB,GAC9B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,CAKtC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAEhG"}

package/dist/adapters/astro/astro.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"astro.service.js","sourceRoot":"","sources":["../../../src/adapters/astro/astro.service.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAChC,KAAU,EACV,OAAO,GAAoC,EAAE;IAE7C,MAAM,EACL,KAAK,GAAG,MAAgB,EACxB,SAAS,GAAG,CAAC,IAAO,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,IAAyD,CAAC;QACzE,OAAO,MAAM,EAAE,IAAI,IAAI,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC,EACD,SAAS,GAAG,CAAC,IAAO,EAAE,EAAE,CAAC,IAAyB,EAClD,UAAU,GACV,GAAG,OAAO,CAAC;IAEZ,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC3B,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAG5E;QACD,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC;KACtB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAK3C,eAA8E,EAC9E,cAAsB,EACtB,OAAO,GAA6D,EAAE;IAEtE,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,cAAc,CAAC,CAAC;QACtD,OAAO,EAAE,IAAI,EAAE,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAC7E,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACzB,OAAO;YACN,IAAI,EAAE,IAAI;YACV,KAAK,EAAE;gBACN,OAAO,EAAE,2CAA2C,cAAc,GAAG;gBACrE,cAAc;gBACd,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC/D;YACD,EAAE,EAAE,KAAK;SACT,CAAC;IACH,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB,CAChC,KAAU,EACV,KAAa,EACb,OAAsC;IAEtC,MAAM,MAAM,GACX,OAAO;QACP,CAAC,CAAC,IAAO,EAAE,EAAE;YACZ,MAAM,MAAM,GAAG,IAAyD,CAAC;YACzE,OAAO,MAAM,EAAE,IAAI,IAAI,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;IACJ,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC;AACrE,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,0BAA0B,CACzC,KAAU,EACV,QAAQ,GAAG,EAAE,EACb,KAAK,GAAW,MAAgB;IAEhC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;IACnE,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAClD,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,OAAO;YACN,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,EAGrE;YACD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE;SACxF,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,uBAAuB,CACtC,MAA2B,EAC3B,KAAK,GAAW,MAAgB;IAEhC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC7B,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,EAAwC;QACxE,KAAK,EAAE,KAAK;KACZ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,2BAA2B,CAAO,KAAU,EAAE,OAA6B;IAC1F,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/adapters/astro/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/astro/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/adapters/astro/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/astro/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/adapters/astro/rss.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rss.service.d.ts","sourceRoot":"","sources":["../../../src/adapters/astro/rss.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAuG1E;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB,WAAY,SAAS,KAAG,SAsBvD,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,WAAY,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC,KAAG,MAGjF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,yBAAyB,WAC7B,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG;IAClC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;CAC1D,KACC,CAAC,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,GAAG,GAAG,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAsC1D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,mCAAmC,eACnC,UAAU,SACf,OAAO,EAAE,GAAG,CAAC,MAAM,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,KACvD,CAAC,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,GAAG,GAAG,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAS1D,CAAC"}

package/dist/adapters/astro/rss.service.js.map

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

package/dist/adapters/astro/seo.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo.service.d.ts","sourceRoot":"","sources":["../../../src/adapters/astro/seo.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,YAAY,EACX,OAAO,EACP,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,iBAAiB,GACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACN,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,UAAU,EACV,SAAS,EACT,UAAU,EACV,QAAQ,GACR,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,KAAK,UAAU,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/adapters/astro/seo.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo.service.js","sourceRoot":"","sources":["../../../src/adapters/astro/seo.service.ts"],"names":[],"mappings":"AAgBA,OAAO,EACN,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,UAAU,EACV,SAAS,EACT,UAAU,EACV,QAAQ,GACR,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAmB,UAAU,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/adapters/express/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/adapters/express/app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAoB,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAElF;;;;;;;;GAQG;AACH,eAAO,MAAM,GAAG,EAAE,WAAgC,CAAC;AAEnD;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,yBAAmB,CAAC;AAE1C;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,wBAAkB,CAAC"}

package/dist/adapters/express/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../src/adapters/express/app.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAElF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,GAAG,GAAgB,gBAAgB,EAAE,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,gBAAgB,CAAC;AAE1C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,eAAe,CAAC"}

package/dist/{katanakit-js/adapters → adapters}/express/index.d.ts

@@ -1,5 +1,5 @@
 export { app, useGetApp, useStart } from "./app.js";
 export { useExpressCreateProduct, useExpressDeleteProduct, useExpressGetAllProducts, useExpressGetProductById, useExpressUpdateProduct, } from "./products.controller.js";
 export { default as router } from "./router.js";
-export { useExpressCreate, useExpressGetApp, useExpressStart } from "./server.js";
+export { useExpressCreate, useExpressFinalize, useExpressGetApp, useExpressStart, useGetRawBody, } from "./server.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/adapters/express/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/express/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EACN,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACN,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,aAAa,GACb,MAAM,aAAa,CAAC"}

package/dist/{katanakit-js/adapters → adapters}/express/index.js

@@ -1,5 +1,5 @@
 export { app, useGetApp, useStart } from "./app.js";
 export { useExpressCreateProduct, useExpressDeleteProduct, useExpressGetAllProducts, useExpressGetProductById, useExpressUpdateProduct, } from "./products.controller.js";
 export { default as router } from "./router.js";
-export { useExpressCreate, useExpressGetApp, useExpressStart } from "./server.js";
+export { useExpressCreate, useExpressFinalize, useExpressGetApp, useExpressStart, useGetRawBody, } from "./server.js";
 //# sourceMappingURL=index.js.map

package/dist/adapters/express/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/express/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EACN,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACN,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,aAAa,GACb,MAAM,aAAa,CAAC"}

package/dist/{katanakit-js/adapters → adapters}/express/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../src/adapters/express/main.ts"],"names":[],"mappings":""}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/adapters/express/main.ts"],"names":[],"mappings":""}

package/dist/adapters/express/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/adapters/express/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,eAAe,EAAE,CAAC"}

package/dist/adapters/express/products.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"products.controller.d.ts","sourceRoot":"","sources":["../../../src/adapters/express/products.controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAOjD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,aAAc,OAAO,YAAY,QAAQ,KAAG,IAEhF,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,YAAa,OAAO,YAAY,QAAQ,KAAG,IAU/E,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,YAAa,OAAO,YAAY,QAAQ,KAAG,IAc9E,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,YAAa,OAAO,YAAY,QAAQ,KAAG,IAiB9E,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,YAAa,OAAO,YAAY,QAAQ,KAAG,IAW9E,CAAC"}

package/dist/adapters/express/products.controller.js.map

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

package/dist/adapters/express/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/adapters/express/router.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,MAAM,4CAAW,CAAC;eAeT,MAAM"}

package/dist/adapters/express/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/adapters/express/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,MAAM,EAAE,MAAM,SAAS,CAAC;AAE9D,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;AAExB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,QAAiB,EAAE,QAAkB,EAAE,EAAE;IACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,OAAgB,EAAE,QAAkB,EAAE,EAAE;IAC3D,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAiB,EAAE,QAAkB,EAAE,EAAE;IAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;AACjD,CAAC,CAAC,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/dist/adapters/express/server.d.ts

@@ -0,0 +1,63 @@
+import { type Application, type Request } from "express";
+/**
+ * Returns the raw request body buffer captured by the JSON parser, if any.
+ * Needed to verify webhook signatures (e.g. `X-Hub-Signature-256`).
+ *
+ * @param request - The Express request.
+ * @returns The raw body buffer, or `undefined` when not available.
+ */
+export declare function useGetRawBody(request: Request): Buffer | undefined;
+/**
+ * Create and configure the Express application. Mount channel routers on the
+ * returned app BEFORE calling {@link useExpressFinalize} / {@link useExpressStart},
+ * otherwise the 404 catch-all will shadow them.
+ *
+ * @returns Configured Express Application instance
+ *
+ * @example
+ * ```ts
+ * const expressApp = useExpressCreate();
+ * expressApp.use("/assistant", useCreateAssistantRouter());
+ * useExpressStart();
+ * ```
+ */
+export declare const useExpressCreate: () => Application;
+/**
+ * Registers the error handler and 404 catch-all. Idempotent. Call this after
+ * mounting every channel router so it runs last. {@link useExpressStart}
+ * invokes it automatically.
+ *
+ * @example
+ * ```ts
+ * useExpressGetApp().use("/assistant", useCreateAssistantRouter());
+ * useExpressFinalize();
+ * ```
+ */
+export declare const useExpressFinalize: () => void;
+/**
+ * Start the Express HTTP server. Idempotent — subsequent calls are no-ops.
+ * Finalizes error handling before listening.
+ *
+ * @param port - Port to listen on (default: 3000)
+ * @param host - Host to bind to (default: "localhost")
+ *
+ * @example
+ * ```ts
+ * useExpressStart(3000, "localhost");
+ * // Server running on http://localhost:3000
+ * ```
+ */
+export declare const useExpressStart: (port?: number, host?: string) => void;
+/**
+ * Get the Express application instance. Creates it if it doesn't exist.
+ *
+ * @returns Express Application instance
+ *
+ * @example
+ * ```ts
+ * const expressApp = useExpressGetApp();
+ * expressApp.get("/custom", (req, res) => res.json({ ok: true }));
+ * ```
+ */
+export declare const useExpressGetApp: () => Application;
+//# sourceMappingURL=server.d.ts.map

package/dist/adapters/express/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/adapters/express/server.ts"],"names":[],"mappings":"AAEA,OAAgB,EAAE,KAAK,WAAW,EAAqB,KAAK,OAAO,EAAiB,MAAM,SAAS,CAAC;AAapG;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAElE;AAkFD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,QAAO,WAQnC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,QAAO,IAIrC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,oCAAsC,IAUjE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,QAAO,WAAiC,CAAC"}