@clivly/sdk 0.3.0-next.5 → 0.3.0-next.7

package/dist/chat-session.cjs

@@ -0,0 +1,84 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/chat-session.ts
+const DEFAULT_API_URL = "https://api.clivly.com";
+const JSON_HEADERS = { "content-type": "application/json" };
+const TRAILING_SLASH = /\/$/;
+function jsonResponse(body, status) {
+	return new Response(JSON.stringify(body), {
+		status,
+		headers: JSON_HEADERS
+	});
+}
+function normalizeApiUrl(apiUrl) {
+	return apiUrl.replace(TRAILING_SLASH, "");
+}
+function resolveOrigin(req) {
+	const headerOrigin = req.headers.get("origin");
+	if (headerOrigin) return headerOrigin;
+	try {
+		return new URL(req.url).origin;
+	} catch {
+		return null;
+	}
+}
+function isChatSessionRequestBody(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const body = value;
+	if (typeof body.widgetId !== "string" || body.widgetId.trim().length === 0) return false;
+	if (typeof body.visitor !== "object" || body.visitor === null || Array.isArray(body.visitor)) return false;
+	const visitor = body.visitor;
+	if (typeof visitor.name !== "string" || visitor.name.trim().length === 0) return false;
+	if (typeof visitor.email !== "string" || visitor.email.trim().length === 0) return false;
+	return body.visitorToken === void 0 || body.visitorToken === null || typeof body.visitorToken === "string";
+}
+function originAllowed(origin, allowedOrigins) {
+	if (!allowedOrigins || allowedOrigins.length === 0) return true;
+	if (!origin) return false;
+	return allowedOrigins.includes(origin);
+}
+function createChatSessionHandler({ allowedOrigins, apiKey, apiUrl = DEFAULT_API_URL, fetchImpl = fetch }) {
+	const sessionUrl = `${normalizeApiUrl(apiUrl)}/clivly/widget/session`;
+	return async (request) => {
+		if (request.method !== "POST") return new Response(JSON.stringify({ error: "method_not_allowed" }), {
+			status: 405,
+			headers: {
+				...JSON_HEADERS,
+				allow: "POST"
+			}
+		});
+		const origin = resolveOrigin(request);
+		if (!originAllowed(origin, allowedOrigins)) return jsonResponse({ error: "origin_not_allowed" }, 403);
+		let body;
+		try {
+			body = await request.json();
+		} catch {
+			return jsonResponse({ error: "invalid_json" }, 400);
+		}
+		if (!isChatSessionRequestBody(body)) return jsonResponse({ error: "invalid_request" }, 400);
+		try {
+			const upstream = await fetchImpl(sessionUrl, {
+				method: "POST",
+				headers: {
+					authorization: `Bearer ${apiKey}`,
+					"content-type": "application/json",
+					...origin ? { origin } : {}
+				},
+				body: JSON.stringify({
+					widgetId: body.widgetId,
+					visitor: body.visitor,
+					visitorToken: body.visitorToken,
+					origin
+				})
+			});
+			const responseBody = await upstream.text();
+			return new Response(responseBody, {
+				status: upstream.status,
+				headers: { "content-type": upstream.headers.get("content-type") ?? "application/json" }
+			});
+		} catch {
+			return jsonResponse({ error: "upstream_unreachable" }, 502);
+		}
+	};
+}
+//#endregion
+exports.createChatSessionHandler = createChatSessionHandler;

package/dist/chat-session.d.cts

@@ -0,0 +1,11 @@
+import { c as CreateChatSessionHandlerOptions } from "./types-jMafEyTv.cjs";
+
+//#region src/chat-session.d.ts
+declare function createChatSessionHandler({
+  allowedOrigins,
+  apiKey,
+  apiUrl,
+  fetchImpl
+}: CreateChatSessionHandlerOptions): (request: Request) => Promise<Response>;
+//#endregion
+export { createChatSessionHandler };

package/dist/chat-session.d.mts

@@ -0,0 +1,11 @@
+import { c as CreateChatSessionHandlerOptions } from "./types-B7wBCHRT.mjs";
+
+//#region src/chat-session.d.ts
+declare function createChatSessionHandler({
+  allowedOrigins,
+  apiKey,
+  apiUrl,
+  fetchImpl
+}: CreateChatSessionHandlerOptions): (request: Request) => Promise<Response>;
+//#endregion
+export { createChatSessionHandler };

package/dist/chat-session.mjs

@@ -0,0 +1,83 @@
+//#region src/chat-session.ts
+const DEFAULT_API_URL = "https://api.clivly.com";
+const JSON_HEADERS = { "content-type": "application/json" };
+const TRAILING_SLASH = /\/$/;
+function jsonResponse(body, status) {
+	return new Response(JSON.stringify(body), {
+		status,
+		headers: JSON_HEADERS
+	});
+}
+function normalizeApiUrl(apiUrl) {
+	return apiUrl.replace(TRAILING_SLASH, "");
+}
+function resolveOrigin(req) {
+	const headerOrigin = req.headers.get("origin");
+	if (headerOrigin) return headerOrigin;
+	try {
+		return new URL(req.url).origin;
+	} catch {
+		return null;
+	}
+}
+function isChatSessionRequestBody(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const body = value;
+	if (typeof body.widgetId !== "string" || body.widgetId.trim().length === 0) return false;
+	if (typeof body.visitor !== "object" || body.visitor === null || Array.isArray(body.visitor)) return false;
+	const visitor = body.visitor;
+	if (typeof visitor.name !== "string" || visitor.name.trim().length === 0) return false;
+	if (typeof visitor.email !== "string" || visitor.email.trim().length === 0) return false;
+	return body.visitorToken === void 0 || body.visitorToken === null || typeof body.visitorToken === "string";
+}
+function originAllowed(origin, allowedOrigins) {
+	if (!allowedOrigins || allowedOrigins.length === 0) return true;
+	if (!origin) return false;
+	return allowedOrigins.includes(origin);
+}
+function createChatSessionHandler({ allowedOrigins, apiKey, apiUrl = DEFAULT_API_URL, fetchImpl = fetch }) {
+	const sessionUrl = `${normalizeApiUrl(apiUrl)}/clivly/widget/session`;
+	return async (request) => {
+		if (request.method !== "POST") return new Response(JSON.stringify({ error: "method_not_allowed" }), {
+			status: 405,
+			headers: {
+				...JSON_HEADERS,
+				allow: "POST"
+			}
+		});
+		const origin = resolveOrigin(request);
+		if (!originAllowed(origin, allowedOrigins)) return jsonResponse({ error: "origin_not_allowed" }, 403);
+		let body;
+		try {
+			body = await request.json();
+		} catch {
+			return jsonResponse({ error: "invalid_json" }, 400);
+		}
+		if (!isChatSessionRequestBody(body)) return jsonResponse({ error: "invalid_request" }, 400);
+		try {
+			const upstream = await fetchImpl(sessionUrl, {
+				method: "POST",
+				headers: {
+					authorization: `Bearer ${apiKey}`,
+					"content-type": "application/json",
+					...origin ? { origin } : {}
+				},
+				body: JSON.stringify({
+					widgetId: body.widgetId,
+					visitor: body.visitor,
+					visitorToken: body.visitorToken,
+					origin
+				})
+			});
+			const responseBody = await upstream.text();
+			return new Response(responseBody, {
+				status: upstream.status,
+				headers: { "content-type": upstream.headers.get("content-type") ?? "application/json" }
+			});
+		} catch {
+			return jsonResponse({ error: "upstream_unreachable" }, 502);
+		}
+	};
+}
+//#endregion
+export { createChatSessionHandler };

package/dist/drizzle.d.cts

@@ -1,4 +1,4 @@
-import { d as SyncSource, t as NamespaceIntrospector } from "./namespace-probe-9wTakLJu.cjs";
+import { m as NamespaceIntrospector, p as SyncSource } from "./types-jMafEyTv.cjs";
 import { Table } from "drizzle-orm";
 
 //#region src/drizzle.d.ts

package/dist/drizzle.d.mts

@@ -1,4 +1,4 @@
-import { d as SyncSource, t as NamespaceIntrospector } from "./namespace-probe-BD1-lqlp.mjs";
+import { m as NamespaceIntrospector, p as SyncSource } from "./types-B7wBCHRT.mjs";
 import { Table } from "drizzle-orm";
 
 //#region src/drizzle.d.ts

package/dist/index.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_drizzle_meta = require("./drizzle-meta-iAu8w1hj.cjs");
+const require_chat_session = require("./chat-session.cjs");
 //#region src/custom-slug.ts
 const NON_ALNUM = /[^a-z0-9]+/g;
 const EDGE_HYPHENS = /(^-|-$)/g;
@@ -936,4 +937,5 @@ exports.ClivlyAuthError = ClivlyAuthError;
 exports.ClivlyError = ClivlyError;
 exports.ClivlyNetworkError = ClivlyNetworkError;
 exports.ClivlyRateLimitError = ClivlyRateLimitError;
+exports.createChatSessionHandler = require_chat_session.createChatSessionHandler;
 exports.createClivlySDK = createClivlySDK;

package/dist/index.d.cts

@@ -1,4 +1,5 @@
-import { a as ClivlySDKConfig, c as DiscoveredTable, i as ClivlySDK, l as DoctorCheck, n as ClivlyConnectReason, o as ClivlyUser, r as ClivlyConnectResult, s as CursorStore, u as DoctorReport } from "./namespace-probe-9wTakLJu.cjs";
+import { a as ClivlySDK, c as CreateChatSessionHandlerOptions, d as DoctorCheck, f as DoctorReport, i as ClivlyConnectResult, l as CursorStore, n as ChatWidgetVisitor, o as ClivlySDKConfig, r as ClivlyConnectReason, s as ClivlyUser, t as ChatSessionRequestBody, u as DiscoveredTable } from "./types-jMafEyTv.cjs";
+import { createChatSessionHandler } from "./chat-session.cjs";
 
 //#region src/errors.d.ts
 declare class ClivlyError extends Error {
@@ -30,4 +31,4 @@ declare class ClivlyNetworkError extends ClivlyError {}
  */
 declare function createClivlySDK(config: ClivlySDKConfig): ClivlySDK;
 //#endregion
-export { ClivlyAuthError, type ClivlyConnectReason, type ClivlyConnectResult, ClivlyError, ClivlyNetworkError, ClivlyRateLimitError, type ClivlySDK, type ClivlySDKConfig, type ClivlyUser, type CursorStore, type DiscoveredTable, type DoctorCheck, type DoctorReport, createClivlySDK };
+export { type ChatSessionRequestBody, type ChatWidgetVisitor, ClivlyAuthError, type ClivlyConnectReason, type ClivlyConnectResult, ClivlyError, ClivlyNetworkError, ClivlyRateLimitError, type ClivlySDK, type ClivlySDKConfig, type ClivlyUser, type CreateChatSessionHandlerOptions, type CursorStore, type DiscoveredTable, type DoctorCheck, type DoctorReport, createChatSessionHandler, createClivlySDK };

package/dist/index.d.mts

@@ -1,4 +1,5 @@
-import { a as ClivlySDKConfig, c as DiscoveredTable, i as ClivlySDK, l as DoctorCheck, n as ClivlyConnectReason, o as ClivlyUser, r as ClivlyConnectResult, s as CursorStore, u as DoctorReport } from "./namespace-probe-BD1-lqlp.mjs";
+import { a as ClivlySDK, c as CreateChatSessionHandlerOptions, d as DoctorCheck, f as DoctorReport, i as ClivlyConnectResult, l as CursorStore, n as ChatWidgetVisitor, o as ClivlySDKConfig, r as ClivlyConnectReason, s as ClivlyUser, t as ChatSessionRequestBody, u as DiscoveredTable } from "./types-B7wBCHRT.mjs";
+import { createChatSessionHandler } from "./chat-session.mjs";
 
 //#region src/errors.d.ts
 declare class ClivlyError extends Error {
@@ -30,4 +31,4 @@ declare class ClivlyNetworkError extends ClivlyError {}
  */
 declare function createClivlySDK(config: ClivlySDKConfig): ClivlySDK;
 //#endregion
-export { ClivlyAuthError, type ClivlyConnectReason, type ClivlyConnectResult, ClivlyError, ClivlyNetworkError, ClivlyRateLimitError, type ClivlySDK, type ClivlySDKConfig, type ClivlyUser, type CursorStore, type DiscoveredTable, type DoctorCheck, type DoctorReport, createClivlySDK };
+export { type ChatSessionRequestBody, type ChatWidgetVisitor, ClivlyAuthError, type ClivlyConnectReason, type ClivlyConnectResult, ClivlyError, ClivlyNetworkError, ClivlyRateLimitError, type ClivlySDK, type ClivlySDKConfig, type ClivlyUser, type CreateChatSessionHandlerOptions, type CursorStore, type DiscoveredTable, type DoctorCheck, type DoctorReport, createChatSessionHandler, createClivlySDK };

package/dist/index.mjs

@@ -1,4 +1,5 @@
 import { t as DRIZZLE_META } from "./drizzle-meta-DMx_9nlj.mjs";
+import { createChatSessionHandler } from "./chat-session.mjs";
 //#region src/custom-slug.ts
 const NON_ALNUM = /[^a-z0-9]+/g;
 const EDGE_HYPHENS = /(^-|-$)/g;
@@ -931,4 +932,4 @@ function createClivlySDK(config) {
 	};
 }
 //#endregion
-export { ClivlyAuthError, ClivlyError, ClivlyNetworkError, ClivlyRateLimitError, createClivlySDK };
+export { ClivlyAuthError, ClivlyError, ClivlyNetworkError, ClivlyRateLimitError, createChatSessionHandler, createClivlySDK };

package/dist/{namespace-probe-9wTakLJu.d.cts → types-B7wBCHRT.d.mts}

@@ -13,6 +13,14 @@ interface DrizzleSourceMeta {
   tableName?: string;
 }
 //#endregion
+//#region src/namespace-probe.d.ts
+interface NamespaceIntrospector {
+  /** All base table names in the reachable schema. */
+  listTables(): Promise<string[]>;
+  /** Prove a table is genuinely selectable (SELECT ... LIMIT 1). Throws if unreachable/denied. */
+  sampleSelect(table: string): Promise<void>;
+}
+//#endregion
 //#region src/types.d.ts
 interface DiscoveredColumn {
   isForeignKey?: boolean;
@@ -179,6 +187,21 @@ interface ClivlyUser {
   id: string;
   name?: string;
 }
+interface ChatWidgetVisitor {
+  email: string;
+  name: string;
+}
+interface ChatSessionRequestBody {
+  visitor: ChatWidgetVisitor;
+  visitorToken?: string | null;
+  widgetId: string;
+}
+interface CreateChatSessionHandlerOptions {
+  allowedOrigins?: string[];
+  apiKey: string;
+  apiUrl?: string;
+  fetchImpl?: typeof fetch;
+}
 interface DoctorCheck {
   /** Human-readable outcome — what passed, or why it failed. */
   detail: string;
@@ -305,12 +328,4 @@ interface ClivlySDK {
   }): Promise<void>;
 }
 //#endregion
-//#region src/namespace-probe.d.ts
-interface NamespaceIntrospector {
-  /** All base table names in the reachable schema. */
-  listTables(): Promise<string[]>;
-  /** Prove a table is genuinely selectable (SELECT ... LIMIT 1). Throws if unreachable/denied. */
-  sampleSelect(table: string): Promise<void>;
-}
-//#endregion
-export { ClivlySDKConfig as a, DiscoveredTable as c, SyncSource as d, ClivlySDK as i, DoctorCheck as l, ClivlyConnectReason as n, ClivlyUser as o, ClivlyConnectResult as r, CursorStore as s, NamespaceIntrospector as t, DoctorReport as u };
+export { ClivlySDK as a, CreateChatSessionHandlerOptions as c, DoctorCheck as d, DoctorReport as f, ClivlyConnectResult as i, CursorStore as l, NamespaceIntrospector as m, ChatWidgetVisitor as n, ClivlySDKConfig as o, SyncSource as p, ClivlyConnectReason as r, ClivlyUser as s, ChatSessionRequestBody as t, DiscoveredTable as u };

package/dist/{namespace-probe-BD1-lqlp.d.mts → types-jMafEyTv.d.cts}

@@ -13,6 +13,14 @@ interface DrizzleSourceMeta {
   tableName?: string;
 }
 //#endregion
+//#region src/namespace-probe.d.ts
+interface NamespaceIntrospector {
+  /** All base table names in the reachable schema. */
+  listTables(): Promise<string[]>;
+  /** Prove a table is genuinely selectable (SELECT ... LIMIT 1). Throws if unreachable/denied. */
+  sampleSelect(table: string): Promise<void>;
+}
+//#endregion
 //#region src/types.d.ts
 interface DiscoveredColumn {
   isForeignKey?: boolean;
@@ -179,6 +187,21 @@ interface ClivlyUser {
   id: string;
   name?: string;
 }
+interface ChatWidgetVisitor {
+  email: string;
+  name: string;
+}
+interface ChatSessionRequestBody {
+  visitor: ChatWidgetVisitor;
+  visitorToken?: string | null;
+  widgetId: string;
+}
+interface CreateChatSessionHandlerOptions {
+  allowedOrigins?: string[];
+  apiKey: string;
+  apiUrl?: string;
+  fetchImpl?: typeof fetch;
+}
 interface DoctorCheck {
   /** Human-readable outcome — what passed, or why it failed. */
   detail: string;
@@ -305,12 +328,4 @@ interface ClivlySDK {
   }): Promise<void>;
 }
 //#endregion
-//#region src/namespace-probe.d.ts
-interface NamespaceIntrospector {
-  /** All base table names in the reachable schema. */
-  listTables(): Promise<string[]>;
-  /** Prove a table is genuinely selectable (SELECT ... LIMIT 1). Throws if unreachable/denied. */
-  sampleSelect(table: string): Promise<void>;
-}
-//#endregion
-export { ClivlySDKConfig as a, DiscoveredTable as c, SyncSource as d, ClivlySDK as i, DoctorCheck as l, ClivlyConnectReason as n, ClivlyUser as o, ClivlyConnectResult as r, CursorStore as s, NamespaceIntrospector as t, DoctorReport as u };
+export { ClivlySDK as a, CreateChatSessionHandlerOptions as c, DoctorCheck as d, DoctorReport as f, ClivlyConnectResult as i, CursorStore as l, NamespaceIntrospector as m, ChatWidgetVisitor as n, ClivlySDKConfig as o, SyncSource as p, ClivlyConnectReason as r, ClivlyUser as s, ChatSessionRequestBody as t, DiscoveredTable as u };

package/dist/vite.d.cts

@@ -1,4 +1,4 @@
-import { i as ClivlySDK } from "./namespace-probe-9wTakLJu.cjs";
+import { a as ClivlySDK } from "./types-jMafEyTv.cjs";
 import { Plugin } from "vite";
 
 //#region src/vite.d.ts

package/dist/vite.d.mts

@@ -1,4 +1,4 @@
-import { i as ClivlySDK } from "./namespace-probe-BD1-lqlp.mjs";
+import { a as ClivlySDK } from "./types-B7wBCHRT.mjs";
 import { Plugin } from "vite";
 
 //#region src/vite.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clivly/sdk",
-  "version": "0.3.0-next.5",
+  "version": "0.3.0-next.7",
   "private": false,
   "type": "module",
   "description": "Clivly SDK — connect your app to Clivly Cloud (heartbeat, discovery, auth bridge).",
@@ -17,6 +17,16 @@
         "default": "./dist/index.cjs"
       }
     },
+    "./chat-session": {
+      "import": {
+        "types": "./dist/chat-session.d.mts",
+        "default": "./dist/chat-session.mjs"
+      },
+      "require": {
+        "types": "./dist/chat-session.d.cts",
+        "default": "./dist/chat-session.cjs"
+      }
+    },
     "./drizzle": {
       "import": {
         "types": "./dist/drizzle.d.mts",
@@ -45,7 +55,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@clivly/core": "0.3.0-next.5"
+    "@clivly/core": "0.3.0-next.7"
   },
   "peerDependencies": {
     "drizzle-orm": ">=0.30",