clivly 0.4.1 → 0.7.1

package/{mappings-config-CNTZRD4g.mjs → mappings-config-Dbgxx3Nv.mjs}

@@ -1,4 +1,4 @@
-import { t as CANONICAL_FIELDS } from "./entity-config-D3YpQB0z.mjs";
+import { t as CANONICAL_FIELDS } from "./entity-config-va2bkH5o.mjs";
 //#region ../core/src/mappings-config.ts
 const RESERVED_FIELD = "id";
 /**

package/{mappings-config-DjRLCb2Q.d.cts → mappings-config-DsUa7-1w.d.mts}

@@ -1,5 +1,4 @@
-import { a as ClivlyEntitiesConfig } from "./entity-config-GczjD3y8.cjs";
-
+import { a as ClivlyEntitiesConfig } from "./entity-config-DoUCXtq5.mjs";
 //#region ../core/src/mappings-config.d.ts
 /**
  * Mappings → Entity Config bridge.

package/{mappings-config-GxiYsSBQ.d.mts → mappings-config-XmzB4dag.d.cts}

@@ -1,5 +1,4 @@
-import { a as ClivlyEntitiesConfig } from "./entity-config-D1DFyeUp.mjs";
-
+import { a as ClivlyEntitiesConfig } from "./entity-config-DoUCXtq5.cjs";
 //#region ../core/src/mappings-config.d.ts
 /**
  * Mappings → Entity Config bridge.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clivly",
-  "version": "0.4.1",
+  "version": "0.7.1",
   "private": false,
   "type": "module",
   "description": "Clivly CLI — scaffold a CRM into your app (clivly init).",
@@ -11,6 +11,34 @@
   "main": "./index.cjs",
   "module": "./index.mjs",
   "types": "./index.d.mts",
+  "sideEffects": [
+    "./index.mjs",
+    "./index.cjs",
+    "./core.mjs",
+    "./core.cjs",
+    "./core-adapter.mjs",
+    "./core-adapter.cjs",
+    "./core-auth-adapter.mjs",
+    "./core-auth-adapter.cjs",
+    "./core-drizzle.mjs",
+    "./core-drizzle.cjs",
+    "./core-entity-config.mjs",
+    "./core-entity-config.cjs",
+    "./core-entity-heuristics.mjs",
+    "./core-entity-heuristics.cjs",
+    "./core-mapping-form.mjs",
+    "./core-mapping-form.cjs",
+    "./core-mapping-score.mjs",
+    "./core-mapping-score.cjs",
+    "./core-mappings-config.mjs",
+    "./core-mappings-config.cjs",
+    "./core-sync-engine.mjs",
+    "./core-sync-engine.cjs",
+    "./core-types.mjs",
+    "./core-types.cjs",
+    "./core-view-compiler.mjs",
+    "./core-view-compiler.cjs"
+  ],
   "files": [
     "*.cjs",
     "*.mjs",
@@ -151,6 +179,126 @@
         "default": "./core-view-compiler.cjs"
       }
     },
+    "./internal": {
+      "import": {
+        "types": "./internal.d.mts",
+        "default": "./internal.mjs"
+      },
+      "require": {
+        "types": "./internal.d.cts",
+        "default": "./internal.cjs"
+      }
+    },
+    "./internal/adapter": {
+      "import": {
+        "types": "./internal-adapter.d.mts",
+        "default": "./internal-adapter.mjs"
+      },
+      "require": {
+        "types": "./internal-adapter.d.cts",
+        "default": "./internal-adapter.cjs"
+      }
+    },
+    "./internal/auth-adapter": {
+      "import": {
+        "types": "./internal-auth-adapter.d.mts",
+        "default": "./internal-auth-adapter.mjs"
+      },
+      "require": {
+        "types": "./internal-auth-adapter.d.cts",
+        "default": "./internal-auth-adapter.cjs"
+      }
+    },
+    "./internal/drizzle": {
+      "import": {
+        "types": "./internal-drizzle.d.mts",
+        "default": "./internal-drizzle.mjs"
+      },
+      "require": {
+        "types": "./internal-drizzle.d.cts",
+        "default": "./internal-drizzle.cjs"
+      }
+    },
+    "./internal/entity-config": {
+      "import": {
+        "types": "./internal-entity-config.d.mts",
+        "default": "./internal-entity-config.mjs"
+      },
+      "require": {
+        "types": "./internal-entity-config.d.cts",
+        "default": "./internal-entity-config.cjs"
+      }
+    },
+    "./internal/entity-heuristics": {
+      "import": {
+        "types": "./internal-entity-heuristics.d.mts",
+        "default": "./internal-entity-heuristics.mjs"
+      },
+      "require": {
+        "types": "./internal-entity-heuristics.d.cts",
+        "default": "./internal-entity-heuristics.cjs"
+      }
+    },
+    "./internal/mapping-form": {
+      "import": {
+        "types": "./internal-mapping-form.d.mts",
+        "default": "./internal-mapping-form.mjs"
+      },
+      "require": {
+        "types": "./internal-mapping-form.d.cts",
+        "default": "./internal-mapping-form.cjs"
+      }
+    },
+    "./internal/mapping-score": {
+      "import": {
+        "types": "./internal-mapping-score.d.mts",
+        "default": "./internal-mapping-score.mjs"
+      },
+      "require": {
+        "types": "./internal-mapping-score.d.cts",
+        "default": "./internal-mapping-score.cjs"
+      }
+    },
+    "./internal/mappings-config": {
+      "import": {
+        "types": "./internal-mappings-config.d.mts",
+        "default": "./internal-mappings-config.mjs"
+      },
+      "require": {
+        "types": "./internal-mappings-config.d.cts",
+        "default": "./internal-mappings-config.cjs"
+      }
+    },
+    "./internal/sync-engine": {
+      "import": {
+        "types": "./internal-sync-engine.d.mts",
+        "default": "./internal-sync-engine.mjs"
+      },
+      "require": {
+        "types": "./internal-sync-engine.d.cts",
+        "default": "./internal-sync-engine.cjs"
+      }
+    },
+    "./internal/types": {
+      "import": {
+        "types": "./internal-types.d.mts",
+        "default": "./internal-types.mjs"
+      },
+      "require": {
+        "types": "./internal-types.d.cts",
+        "default": "./internal-types.cjs"
+      }
+    },
+    "./internal/view-compiler": {
+      "import": {
+        "types": "./internal-view-compiler.d.mts",
+        "default": "./internal-view-compiler.mjs"
+      },
+      "require": {
+        "types": "./internal-view-compiler.d.cts",
+        "default": "./internal-view-compiler.cjs"
+      }
+    },
     "./sdk": {
       "import": {
         "types": "./sdk.d.mts",
@@ -219,8 +367,8 @@
   "peerDependencies": {
     "@clerk/backend": ">=1",
     "@workos-inc/node": ">=7",
-    "better-auth": ">=1",
-    "drizzle-orm": ">=0.30",
+    "better-auth": ">=1.6.22",
+    "drizzle-orm": ">=0.30 || >=1.0.0-rc.0",
     "vite": ">=5"
   },
   "peerDependenciesMeta": {
@@ -242,7 +390,7 @@
   },
   "author": "Joseph Amani",
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "repository": {
     "type": "git",

package/{sdk-DdzBxgMx.mjs → sdk-C6WANW8M.mjs}

@@ -1,4 +1,83 @@
-import { t as DRIZZLE_META } from "./drizzle-meta-DpMKataU.mjs";
+import { t as DRIZZLE_META } from "./drizzle-meta-D-5k3n0i.mjs";
+//#region ../sdk/src/entity-source.ts
+const CONCEPT_KEYS = {
+	contact: "contacts",
+	company: "companies",
+	deal: "deals"
+};
+function resolveEntitySource(config, entityKey) {
+	const entity = config.entities?.entities?.[entityKey];
+	const src = config.source;
+	if (!(entity && src)) return null;
+	const conceptKey = CONCEPT_KEYS[entity.concept];
+	if (conceptKey) {
+		const source = src[conceptKey];
+		return source ? {
+			concept: entity.concept,
+			expectedKey: conceptKey,
+			source
+		} : null;
+	}
+	if (entity.concept === "custom") {
+		const match = (src.custom ?? []).find((c) => c.entity === entity.source || c.entity === entityKey);
+		return match ? {
+			concept: "custom",
+			expectedKey: "custom",
+			source: match
+		} : null;
+	}
+	return null;
+}
+/** The `config.source` key an entity's concept requires, present or not. */
+function expectedSourceKey(concept) {
+	return CONCEPT_KEYS[concept] ?? "custom";
+}
+//#endregion
+//#region ../sdk/src/concept-coverage.ts
+const CHECK_NAME = "Entity → source coverage";
+function configuredKeys(config) {
+	const src = config.source;
+	if (!src) return [];
+	return Object.entries(src).filter(([, value]) => Array.isArray(value) ? value.length > 0 : Boolean(value)).map(([key]) => key);
+}
+/**
+* Every configured entity must resolve to a source, or it silently syncs
+* nothing. This is the check that catches `source` keyed by entity name rather
+* than by CRM concept — a mistake that otherwise shows up only as a run that
+* succeeds with zero rows.
+*/
+function checkConceptCoverage(config) {
+	const entities = config.entities?.entities ?? {};
+	const keys = Object.keys(entities);
+	if (keys.length === 0) return {
+		name: CHECK_NAME,
+		ok: false,
+		skipped: true,
+		detail: "No entities configured — nothing to cross-check."
+	};
+	const unresolved = keys.filter((key) => resolveEntitySource(config, key) === null);
+	if (unresolved.length === 0) return {
+		name: CHECK_NAME,
+		ok: true,
+		detail: `${keys.length} entit${keys.length === 1 ? "y" : "ies"} resolve to a configured source.`
+	};
+	const available = configuredKeys(config);
+	const listed = available.length > 0 ? available.join(", ") : "(none)";
+	const problems = unresolved.map((key) => {
+		const concept = entities[key]?.concept ?? "unknown";
+		if (concept === "custom") {
+			const custom = config.source?.custom ?? [];
+			if (custom.length > 0) return `"${key}" has concept "custom" but no entry in \`source.custom\` matches it — it will never sync. Entities configured in \`source.custom\`: ${custom.map((c) => c.entity).join(", ")}.`;
+		}
+		return `"${key}" has concept "${concept}" but no \`source.${expectedSourceKey(concept)}\` is configured — it will never sync.`;
+	});
+	return {
+		name: CHECK_NAME,
+		ok: false,
+		detail: `${problems.join(" ")} Configured source keys: ${listed}. \`source\` is keyed by CRM concept, not by entity key.`
+	};
+}
+//#endregion
 //#region ../sdk/src/custom-slug.ts
 const NON_ALNUM = /[^a-z0-9]+/g;
 const EDGE_HYPHENS = /(^-|-$)/g;
@@ -79,6 +158,56 @@ function describeFetchError(entity, error) {
 	return `Couldn't read "${entity}": ${firstLine(root instanceof Error ? root.message : String(root?.message ?? root ?? "unknown error"))}`;
 }
 //#endregion
+//#region ../sdk/src/mapping-dry-run.ts
+/**
+* Fetch one real row and push it through the entity's field map.
+*
+* The distinction from "Sample fetch": that proves the query runs, this proves
+* the row that comes back actually carries the columns `fields` names. A
+* mapping that points at a column the row lacks produces empty CRM records
+* rather than an error, so it has to be caught here.
+*
+* An empty table SKIPS rather than fails — a fresh database is not a
+* misconfiguration, and failing on it would train people to ignore the check.
+*/
+async function runMappingDryRun(config, entityKey) {
+	const name = `Field mapping dry run (${entityKey})`;
+	const resolved = resolveEntitySource(config, entityKey);
+	if (!resolved) return {
+		name,
+		ok: false,
+		skipped: true,
+		detail: `"${entityKey}" resolves to no source — see the coverage check above.`
+	};
+	const fields = config.entities?.entities?.[entityKey]?.fields ?? {};
+	let rows;
+	try {
+		rows = await resolved.source.fetchPage({
+			since: null,
+			limit: 1
+		});
+	} catch (error) {
+		return {
+			name,
+			ok: false,
+			detail: describeFetchError(entityKey, error)
+		};
+	}
+	const row = rows[0];
+	if (row === void 0) return {
+		name,
+		ok: false,
+		skipped: true,
+		detail: `"${resolved.source.entity}" is empty — nothing to map yet.`
+	};
+	const missing = Object.entries(fields).filter(([, column]) => !(column in row)).map(([field, column]) => `${field} → ${column}`);
+	return {
+		name,
+		ok: missing.length === 0,
+		detail: missing.length === 0 ? `Mapped ${Object.keys(fields).length} field(s) from a real "${resolved.source.entity}" row.` : `Row from "${resolved.source.entity}" is missing mapped column(s): ${missing.join(", ")}.`
+	};
+}
+//#endregion
 //#region ../sdk/src/namespace-probe.ts
 /**
 * Verify the tables the integration depends on are genuinely reachable:
@@ -169,6 +298,11 @@ async function namespaceCheck(config) {
 		detail: probeResult.reachable ? "All required source tables are reachable." : probeResult.error?.message ?? "namespace unreachable"
 	};
 }
+async function mappingDryRunChecks(config) {
+	const checks = [];
+	for (const entityKey of Object.keys(config.entities?.entities ?? {})) checks.push(await runMappingDryRun(config, entityKey));
+	return checks;
+}
 /**
 * Run the read-only setup checks and return a structured report. Every check
 * captures its own error into `detail` rather than throwing, so one failure never
@@ -195,6 +329,7 @@ async function runDoctor(args) {
 		ok: sources.length > 0,
 		detail: sources.length > 0 ? `${sources.length} source(s) to mirror.` : "No `source.contacts` — nothing to sync."
 	});
+	checks.push(checkConceptCoverage(config));
 	for (const source of sources) {
 		const meta = source[DRIZZLE_META];
 		if (!meta) {
@@ -233,6 +368,7 @@ async function runDoctor(args) {
 			detail: describeFetchError(source.entity, error)
 		});
 	}
+	checks.push(...await mappingDryRunChecks(config));
 	const result = await connect();
 	checks.push({
 		name: "Heartbeat",
@@ -276,6 +412,7 @@ async function syncSource(args) {
 	const idField = source.idField ?? DEFAULT_ID_FIELD;
 	let cursor = since;
 	let pushed = 0;
+	const resumedFrom = since === null ? null : since.time.toISOString();
 	for (;;) {
 		const rows = await source.fetchPage({
 			since: cursor,
@@ -287,6 +424,8 @@ async function syncSource(args) {
 			source: source.entity,
 			rows: capped,
 			mode: "delta",
+			fetched: rows.length,
+			cursor: resumedFrom,
 			...objectType ? { objectType } : {}
 		})) return {
 			pushed,
@@ -329,6 +468,8 @@ async function fullSyncSource(args) {
 		source: source.entity,
 		rows: all,
 		mode: "full",
+		fetched: all.length,
+		cursor: null,
 		...objectType ? { objectType } : {}
 	});
 	return {
@@ -393,9 +534,7 @@ function observedTriggerUrl(req) {
 	const proto = forwardedProto || requestUrl.protocol.replace(":", "");
 	try {
 		return new URL(`${proto}://${host}${requestUrl.pathname}`).toString();
-	} catch {
-		return;
-	}
+	} catch {}
 }
 /**
 * Decide which trigger URL to report, in precedence order:
@@ -454,7 +593,7 @@ function originAllowed(origin, allowedOrigins) {
 	if (!origin) return false;
 	return allowedOrigins.includes(origin);
 }
-function createChatSessionHandler({ allowedOrigins, apiKey, apiUrl = DEFAULT_API_URL$1, fetchImpl = fetch }) {
+function createChatSessionHandler({ allowedOrigins, apiKey, apiUrl = DEFAULT_API_URL$1, fetchImpl = fetch, resolveUser }) {
 	const sessionUrl = `${normalizeApiUrl(apiUrl)}/clivly/widget/session`;
 	return async (request) => {
 		if (request.method !== "POST") return new Response(JSON.stringify({ error: "method_not_allowed" }), {
@@ -473,6 +612,12 @@ function createChatSessionHandler({ allowedOrigins, apiKey, apiUrl = DEFAULT_API
 			return jsonResponse$1({ error: "invalid_json" }, 400);
 		}
 		if (!isChatSessionRequestBody(body)) return jsonResponse$1({ error: "invalid_request" }, 400);
+		let hostUser = null;
+		if (resolveUser) try {
+			hostUser = await resolveUser(request);
+		} catch {
+			console.warn("[clivly] resolveUser threw; continuing without host identity");
+		}
 		try {
 			const upstream = await fetchImpl(sessionUrl, {
 				method: "POST",
@@ -485,7 +630,8 @@ function createChatSessionHandler({ allowedOrigins, apiKey, apiUrl = DEFAULT_API
 					widgetId: body.widgetId,
 					visitor: body.visitor,
 					visitorToken: body.visitorToken,
-					origin
+					origin,
+					...hostUser ? { hostUser } : {}
 				})
 			});
 			const responseBody = await upstream.text();
@@ -675,9 +821,7 @@ function connectReason(status) {
 async function resolveOrg(response) {
 	try {
 		return (await response.json())?.org;
-	} catch {
-		return;
-	}
+	} catch {}
 }
 function retryAfterMs(res) {
 	const header = res.headers.get("retry-after");
@@ -700,35 +844,30 @@ function createFetcher(retry) {
 			}
 			if (!(res === null || isRetryableStatus(res.status)) || attempt >= maxAttempts) return res;
 			const backoff = baseDelayMs * 2 ** (attempt - 1) + Math.random() * baseDelayMs;
-			await sleep(res ? retryAfterMs(res) ?? backoff : backoff);
+			const wait = res ? retryAfterMs(res) ?? backoff : backoff;
+			await sleep(wait);
 		}
 	};
 }
+const CONCEPT_PATHS = {
+	contacts: SYNC_CONTACTS_PATH,
+	companies: SYNC_COMPANIES_PATH,
+	deals: SYNC_DEALS_PATH,
+	custom: SYNC_CUSTOM_PATH
+};
 function resolveSampleSource(config, entityKey) {
-	const entity = config.entities?.entities?.[entityKey];
-	const src = config.source;
-	if (!(entity && src)) return null;
-	if (entity.concept === "contact" && src.contacts) return {
-		source: src.contacts,
-		path: SYNC_CONTACTS_PATH
-	};
-	if (entity.concept === "company" && src.companies) return {
-		source: src.companies,
-		path: SYNC_COMPANIES_PATH
-	};
-	if (entity.concept === "deal" && src.deals) return {
-		source: src.deals,
-		path: SYNC_DEALS_PATH
+	const resolved = resolveEntitySource(config, entityKey);
+	if (!resolved) return null;
+	const path = CONCEPT_PATHS[resolved.expectedKey];
+	if (!path) return null;
+	return resolved.expectedKey === "custom" ? {
+		source: resolved.source,
+		path,
+		objectType: resolved.source.objectType
+	} : {
+		source: resolved.source,
+		path
 	};
-	if (entity.concept === "custom") {
-		const custom = (src.custom ?? []).find((c) => c.entity === entity.source || c.entity === entityKey);
-		return custom ? {
-			source: custom,
-			path: SYNC_CUSTOM_PATH,
-			objectType: custom.objectType
-		} : null;
-	}
-	return null;
 }
 const PREVIEW_LIMIT = 5;
 function resolvePreviewSource(config, sourceTable) {
@@ -757,7 +896,7 @@ async function handlePreviewRequest(config, preview) {
 	if (!source) return jsonResponse({ error: `No configured source for table "${preview.sourceTable}"` }, 400);
 	const idField = source.idField ?? "id";
 	const filterColumns = preview.filter ? Object.keys(preview.filter).filter((k) => k !== "$raw") : [];
-	const needed = new Set([
+	const needed = /* @__PURE__ */ new Set([
 		idField,
 		...Object.values(preview.fieldMap),
 		...filterColumns