@waniwani/sdk 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WaniWani, Inc. and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,115 @@
+# @waniwani
+
+SDK for [app.waniwani.ai](https://app.waniwani.ai) - MCP event tracking and tools.
+
+## Warning
+
+This is **pre-alpha** software. Here's what that means:
+
+- Everything will break
+- APIs will change without notice
+- We will not apologize
+
+If you're not comfortable with that, wait for v1.0.
+
+## What is WaniWani?
+
+[WaniWani](https://app.waniwani.ai) is the Shopify of MCP servers — enabling quote-based businesses that sell complex services to deploy AI agents that capture leads, qualify customers, and generate quotes.
+
+This SDK is how you track events and interactions in your MCP server.
+
+## Installation
+
+```bash
+npm install @waniwani
+```
+
+## Quick Start
+
+```typescript
+import { waniwani } from "@waniwani";
+
+const client = waniwani({
+  apiKey: "your-api-key", // or use WANIWANI_API_KEY env var
+});
+
+// Track a tool call
+await client.track({
+  eventType: "tool.called",
+  sessionId: "session-123",
+  toolName: "pricing",
+  toolType: "pricing",
+});
+
+// Get or create session from MCP metadata
+const sessionId = await client.getOrCreateSession(extra?._meta);
+```
+
+## API
+
+### `waniwani(config?)`
+
+Creates a WaniWani client.
+
+```typescript
+const client = waniwani({
+  apiKey: "...", // defaults to WANIWANI_API_KEY env var
+  baseUrl: "...", // defaults to https://app.waniwani.ai
+});
+```
+
+### `client.track(event)`
+
+Track an event. Returns `{ eventId: string }`.
+
+```typescript
+await client.track({
+  eventType: "tool.called",
+  sessionId: "session-123",
+  toolName: "pricing",
+  toolType: "pricing",
+  metadata: { custom: "data" },
+});
+```
+
+**Event Types:**
+
+| Event Type           | Description                | Additional Fields                        |
+| -------------------- | -------------------------- | ---------------------------------------- |
+| `session.started`    | New session began          | -                                        |
+| `tool.called`        | MCP tool was invoked       | `toolName?`, `toolType?`                 |
+| `quote.requested`    | Quote was requested        | -                                        |
+| `quote.succeeded`    | Quote completed            | `quoteAmount?`, `quoteCurrency?`         |
+| `quote.failed`       | Quote failed               | -                                        |
+| `link.clicked`       | User clicked a link        | `linkUrl?`                               |
+| `purchase.completed` | Purchase was completed     | `purchaseAmount?`, `purchaseCurrency?`   |
+
+**Tool Types:** `pricing`, `product_info`, `availability`, `support`, `other`
+
+**Base Event Fields:**
+
+- `sessionId` (required): Session identifier
+- `externalUserId?`: Your user identifier
+- `metadata?`: Custom key-value data
+
+### `client.getOrCreateSession(meta?)`
+
+Extract session ID from MCP request metadata, or generate a new one. If a new session is generated, automatically tracks a `session.started` event.
+
+```typescript
+// In your MCP tool handler
+const sessionId = await client.getOrCreateSession(extra?._meta);
+```
+
+Looks for session ID in: `meta["openai/sessionId"]`, `meta.sessionId`, or `meta.conversationId`.
+
+## Configuration
+
+| Option    | Environment Variable | Default                    |
+| --------- | -------------------- | -------------------------- |
+| `apiKey`  | `WANIWANI_API_KEY`   | -                          |
+| `baseUrl` | -                    | `https://app.waniwani.ai`  |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,103 @@
+declare class WaniWaniError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}
+
+type EventType = "session.started" | "tool.called" | "quote.requested" | "quote.succeeded" | "quote.failed" | "link.clicked" | "purchase.completed";
+type ToolType = "pricing" | "product_info" | "availability" | "support" | "other";
+interface BaseEvent {
+    sessionId: string;
+    externalUserId?: string;
+    metadata?: Record<string, unknown>;
+}
+type TrackEvent = ({
+    eventType: "session.started";
+} & BaseEvent) | ({
+    eventType: "tool.called";
+    toolName?: string;
+    toolType?: ToolType;
+} & BaseEvent) | ({
+    eventType: "quote.requested";
+} & BaseEvent) | ({
+    eventType: "quote.succeeded";
+    quoteAmount?: number;
+    quoteCurrency?: string;
+} & BaseEvent) | ({
+    eventType: "quote.failed";
+} & BaseEvent) | ({
+    eventType: "link.clicked";
+    linkUrl?: string;
+} & BaseEvent) | ({
+    eventType: "purchase.completed";
+    purchaseAmount?: number;
+    purchaseCurrency?: string;
+} & BaseEvent);
+/**
+ * Tracking module methods for WaniWaniClient
+ */
+interface TrackingClient {
+    /**
+     * Track an event using the WaniWani API
+     */
+    track: (event: TrackEvent) => Promise<{
+        eventId: string;
+    }>;
+    /**
+     * Extract session ID from MCP request metadata, or generate a new one.
+     * If a new session ID is generated, automatically tracks a session.started event.
+     *
+     * @param meta - The _meta object from the MCP request (extra?._meta)
+     * @returns The session ID (existing or newly generated)
+     */
+    getOrCreateSession: (meta?: Record<string, unknown>) => Promise<string>;
+}
+
+interface WaniWaniConfig {
+    /**
+     * Your MCP environment API key
+     *
+     * Defaults to process.env.WANIWANI_API_KEY if not provided
+     *
+     * To create one, visit:
+     * https://app.waniwani.com/mcp/environments
+     */
+    apiKey?: string;
+    /**
+     * The base URL of the WaniWani API
+     *
+     * Defaults to https://app.waniwani.ai
+     */
+    baseUrl?: string;
+}
+/**
+ * WaniWani SDK Client
+ *
+ * Extends with each module:
+ * - TrackingClient: track(), getOrCreateSession()
+ * - Future: ToolsClient, etc.
+ */
+interface WaniWaniClient extends TrackingClient {
+}
+
+/**
+ * Create a WaniWani SDK client
+ *
+ * @param config - Configuration options
+ * @returns A fully typed WaniWani client
+ *
+ * @example
+ * ```typescript
+ * import { waniwani } from "@waniwani";
+ *
+ * const client = waniwani({ apiKey: "..." });
+ *
+ * await client.track({
+ *   eventType: "tool.called",
+ *   sessionId: "session-123",
+ *   toolName: "pricing"
+ * });
+ * ```
+ */
+declare function waniwani(config?: WaniWaniConfig): WaniWaniClient;
+
+export { type EventType, type ToolType, type TrackEvent, type WaniWaniClient, type WaniWaniConfig, WaniWaniError, waniwani };

package/dist/index.js

@@ -0,0 +1,2 @@
+var o=class extends Error{constructor(t,s){super(t);this.status=s;this.name="WaniWaniError"}};function f(i){let{baseUrl:a,apiKey:t}=i;function s(){if(!t)throw new Error("WANIWANI_API_KEY is not set")}return{async track(e){try{s();let n=await fetch(`${a}/api/mcp/events`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${t}`},body:JSON.stringify(e)}),r=await n.json();if(!n.ok)throw new o(r.message??"Request failed",n.status);return{eventId:r.data.eventId}}catch(n){throw console.error("[WaniWani] Track error:",n),n}},async getOrCreateSession(e){if(e){let r=e["openai/sessionId"]||e.sessionId||e.conversationId;if(typeof r=="string"&&r.length>0)return r}let n=crypto.randomUUID();return await this.track({eventType:"session.started",sessionId:n}),n}}}function y(i){let a=i?.baseUrl??"https://app.waniwani.ai",t=i?.apiKey??process.env.WANIWANI_API_KEY;return{...f({baseUrl:a,apiKey:t})}}export{o as WaniWaniError,y as waniwani};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/error.ts","../src/tracking/index.ts","../src/waniwani.ts"],"sourcesContent":["// WaniWani SDK - Errors\n\nexport class WaniWaniError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic status: number,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"WaniWaniError\";\n\t}\n}\n","// Tracking Module\n\nimport { WaniWaniError } from \"../error.js\";\nimport type { InternalConfig } from \"../types.js\";\nimport type { TrackEvent, TrackingClient } from \"./@types.js\";\n\n// Re-export types\nexport type {\n\tEventType,\n\tToolType,\n\tTrackEvent,\n\tTrackingClient,\n} from \"./@types.js\";\n\nexport function createTrackingClient(config: InternalConfig): TrackingClient {\n\tconst { baseUrl, apiKey } = config;\n\n\tfunction checkIfApiKeyIsSet() {\n\t\tif (!apiKey) {\n\t\t\tthrow new Error(\"WANIWANI_API_KEY is not set\");\n\t\t}\n\t}\n\n\treturn {\n\t\tasync track(event: TrackEvent): Promise<{ eventId: string }> {\n\t\t\ttry {\n\t\t\t\tcheckIfApiKeyIsSet();\n\n\t\t\t\tconst response = await fetch(`${baseUrl}/api/mcp/events`, {\n\t\t\t\t\tmethod: \"POST\",\n\t\t\t\t\theaders: {\n\t\t\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t\t\tAuthorization: `Bearer ${apiKey}`,\n\t\t\t\t\t},\n\t\t\t\t\tbody: JSON.stringify(event),\n\t\t\t\t});\n\n\t\t\t\tconst data = await response.json();\n\n\t\t\t\tif (!response.ok) {\n\t\t\t\t\tthrow new WaniWaniError(\n\t\t\t\t\t\tdata.message ?? \"Request failed\",\n\t\t\t\t\t\tresponse.status,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\treturn { eventId: data.data.eventId };\n\t\t\t} catch (error) {\n\t\t\t\tconsole.error(\"[WaniWani] Track error:\", error);\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t},\n\n\t\tasync getOrCreateSession(meta?: Record<string, unknown>): Promise<string> {\n\t\t\tif (meta) {\n\t\t\t\tconst sessionId =\n\t\t\t\t\tmeta[\"openai/sessionId\"] || meta.sessionId || meta.conversationId;\n\t\t\t\tif (typeof sessionId === \"string\" && sessionId.length > 0) {\n\t\t\t\t\treturn sessionId;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst sessionId = crypto.randomUUID();\n\t\t\tawait this.track({ eventType: \"session.started\", sessionId });\n\t\t\treturn sessionId;\n\t\t},\n\t};\n}\n","// WaniWani SDK - Main Entry\n\nimport { createTrackingClient } from \"./tracking/index.js\";\nimport type { WaniWaniClient, WaniWaniConfig } from \"./types.js\";\n\n/**\n * Create a WaniWani SDK client\n *\n * @param config - Configuration options\n * @returns A fully typed WaniWani client\n *\n * @example\n * ```typescript\n * import { waniwani } from \"@waniwani\";\n *\n * const client = waniwani({ apiKey: \"...\" });\n *\n * await client.track({\n *   eventType: \"tool.called\",\n *   sessionId: \"session-123\",\n *   toolName: \"pricing\"\n * });\n * ```\n */\nexport function waniwani(config?: WaniWaniConfig): WaniWaniClient {\n\tconst baseUrl = config?.baseUrl ?? \"https://app.waniwani.ai\";\n\tconst apiKey = config?.apiKey ?? process.env.WANIWANI_API_KEY;\n\n\tconst internalConfig = { baseUrl, apiKey };\n\n\t// Compose client from modules\n\tconst tracking = createTrackingClient(internalConfig);\n\n\treturn {\n\t\t...tracking,\n\t\t// Future modules will be spread here\n\t\t// ...tools,\n\t};\n}\n"],"mappings":"AAEO,IAAMA,EAAN,cAA4B,KAAM,CACxC,YACCC,EACOC,EACN,CACD,MAAMD,CAAO,EAFN,YAAAC,EAGP,KAAK,KAAO,eACb,CACD,ECIO,SAASC,EAAqBC,EAAwC,CAC5E,GAAM,CAAE,QAAAC,EAAS,OAAAC,CAAO,EAAIF,EAE5B,SAASG,GAAqB,CAC7B,GAAI,CAACD,EACJ,MAAM,IAAI,MAAM,6BAA6B,CAE/C,CAEA,MAAO,CACN,MAAM,MAAME,EAAiD,CAC5D,GAAI,CACHD,EAAmB,EAEnB,IAAME,EAAW,MAAM,MAAM,GAAGJ,CAAO,kBAAmB,CACzD,OAAQ,OACR,QAAS,CACR,eAAgB,mBAChB,cAAe,UAAUC,CAAM,EAChC,EACA,KAAM,KAAK,UAAUE,CAAK,CAC3B,CAAC,EAEKE,EAAO,MAAMD,EAAS,KAAK,EAEjC,GAAI,CAACA,EAAS,GACb,MAAM,IAAIE,EACTD,EAAK,SAAW,iBAChBD,EAAS,MACV,EAGD,MAAO,CAAE,QAASC,EAAK,KAAK,OAAQ,CACrC,OAASE,EAAO,CACf,cAAQ,MAAM,0BAA2BA,CAAK,EACxCA,CACP,CACD,EAEA,MAAM,mBAAmBC,EAAiD,CACzE,GAAIA,EAAM,CACT,IAAMC,EACLD,EAAK,kBAAkB,GAAKA,EAAK,WAAaA,EAAK,eACpD,GAAI,OAAOC,GAAc,UAAYA,EAAU,OAAS,EACvD,OAAOA,CAET,CAEA,IAAMA,EAAY,OAAO,WAAW,EACpC,aAAM,KAAK,MAAM,CAAE,UAAW,kBAAmB,UAAAA,CAAU,CAAC,EACrDA,CACR,CACD,CACD,CC3CO,SAASC,EAASC,EAAyC,CACjE,IAAMC,EAAUD,GAAQ,SAAW,0BAC7BE,EAASF,GAAQ,QAAU,QAAQ,IAAI,iBAO7C,MAAO,CACN,GAHgBG,EAHM,CAAE,QAAAF,EAAS,OAAAC,CAAO,CAGW,CAMpD,CACD","names":["WaniWaniError","message","status","createTrackingClient","config","baseUrl","apiKey","checkIfApiKeyIsSet","event","response","data","WaniWaniError","error","meta","sessionId","waniwani","config","baseUrl","apiKey","createTrackingClient"]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@waniwani/sdk",
+  "version": "0.0.2",
+  "description": "WaniWani SDK - MCP event tracking and tools",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && npm run typecheck && npm run lint && tsup",
+    "dev": "tsx --watch src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "lint:fix": "biome check . --write",
+    "prepublishOnly": "npm run build",
+    "release": "npm version patch && npm publish --access public",
+    "release:minor": "npm version minor && npm publish --access public",
+    "release:major": "npm version major && npm publish --access public"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.13",
+    "@types/node": "^22.10.0",
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/WaniWani-AI/sdk"
+  },
+  "keywords": [
+    "sdk",
+    "mcp",
+    "waniwani",
+    "tracking",
+    "events",
+    "tools"
+  ],
+  "author": "WaniWani",
+  "license": "MIT"
+}