clivly 0.9.5 → 0.9.6

package/{sdk-CM1UO-I7.cjs → sdk-w8Kv_XnW.cjs}

@@ -1,5 +1,5 @@
-const require_entity_config = require("./entity-config-7sGCk_nw.cjs");
-const require_mappings_config = require("./mappings-config-CLyEg0sf.cjs");
+const require_entity_config = require("./entity-config-DE30_RpU.cjs");
+const require_mappings_config = require("./mappings-config-CjCmT-aU.cjs");
 const require_drizzle_meta = require("./drizzle-meta-Bb1JWYqf.cjs");
 //#region ../sdk/src/deployment-identity.ts
 const MAX_DEPLOYMENT_ID_LENGTH = 128;
@@ -572,12 +572,21 @@ async function runDoctor(args) {
 		ok: entityCount > 0,
 		detail: entityCount > 0 ? `${entityCount} entit${entityCount === 1 ? "y" : "ies"} configured.` : "No `entities` config — pass defineClivlyConfig(...) as `entities`."
 	});
+	const sourcesDetail = (count, deferred) => {
+		if (deferred) return "Deferred — the coverage check below names the entity and the source key it expected.";
+		return count === 0 ? "No `source.contacts` — nothing to sync." : `${count} source(s) to mirror.`;
+	};
+	const coverage = checkConceptCoverage(config);
+	const coverageOwnsIt = !(coverage.ok || coverage.skipped);
+	const noSources = sources.length === 0;
+	const deferred = noSources && coverageOwnsIt;
 	checks.push({
 		name: "Sources configured",
-		ok: sources.length > 0,
-		detail: sources.length > 0 ? `${sources.length} source(s) to mirror.` : "No `source.contacts` — nothing to sync."
+		ok: !noSources,
+		skipped: deferred,
+		detail: sourcesDetail(sources.length, deferred)
 	});
-	checks.push(checkConceptCoverage(config));
+	checks.push(coverage);
 	checks.push(...cursorColumnChecks(sources));
 	for (const source of sources) {
 		const check = cursorMonotonicityCheck(source);
@@ -1533,6 +1542,15 @@ async function handlePreviewRequest(config, preview) {
 		sampledCount: rows.length
 	}, 200);
 }
+async function handleProjectionPreviewRequest(config, request) {
+	const run = config.introspector?.runProjection;
+	if (!run) return jsonResponse({ error: "This app cannot preview derived objects. Set `introspector: drizzleIntrospector(db)` in clivly.config.ts, on a clivly version that supports runProjection." }, 400);
+	const rows = await run.call(config.introspector, request.projection, { limit: request.limit });
+	return jsonResponse({
+		rows,
+		sampledCount: rows.length
+	}, 200);
+}
 /**
 * Create the Clivly SDK. The implemented surface — heartbeat/discovery reporting
 * and the auth-verify handler — connects a developer's app to a running Clivly
@@ -1662,13 +1680,17 @@ function createClivlySDK(config) {
 		lastPushFailure = null;
 		if (!await syncOne(resolved.source, resolved.path, "delta", resolved.objectType, runId, SAMPLE_BATCH_SIZE, SAMPLE_BATCH_SIZE, false)) throw new Error(describePushFailure([resolved.source.entity]));
 	};
-	const sendHeartbeat = () => {
-		const triggerUrl = resolveTriggerUrl({
+	const describeSyncTrigger = () => ({
+		configured: config.syncTrigger?.url,
+		resolved: resolveTriggerUrl({
 			configuredUrl: config.syncTrigger?.url,
 			configuredPath: config.syncTrigger?.path,
 			env: config.env ?? process.env,
 			observedUrl
-		});
+		})
+	});
+	const sendHeartbeat = () => {
+		const triggerUrl = describeSyncTrigger().resolved;
 		return fetcher(`${apiUrl}/clivly/sdk/heartbeat`, {
 			method: "POST",
 			headers: {
@@ -1896,6 +1918,7 @@ function createClivlySDK(config) {
 		const startedAt = Date.now();
 		try {
 			if (payload.preview) return await handlePreviewRequest(config, payload.preview);
+			if (payload.previewProjection) return await handleProjectionPreviewRequest(config, payload.previewProjection);
 			if (payload.sample) await runSampleSync(payload.sample.entityKey, payload.runId);
 			else await runScheduled({
 				mode: payload.mode,
@@ -1991,6 +2014,7 @@ function createClivlySDK(config) {
 		connect,
 		ping,
 		doctor,
+		describeSyncTrigger,
 		runScheduled,
 		createClivlyHandler,
 		sync: runSync,

package/sdk.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_entity_config = require("./entity-config-7sGCk_nw.cjs");
-const require_sdk = require("./sdk-CM1UO-I7.cjs");
+const require_entity_config = require("./entity-config-DE30_RpU.cjs");
+const require_sdk = require("./sdk-w8Kv_XnW.cjs");
 exports.ClivlyAuthError = require_sdk.ClivlyAuthError;
 exports.ClivlyError = require_sdk.ClivlyError;
 exports.ClivlyNetworkError = require_sdk.ClivlyNetworkError;

package/sdk.d.cts

@@ -1,5 +1,5 @@
 import { C as defineClivlyConfig, S as customObjectDeclarations, a as ClivlyEntitiesConfig, f as CustomObjectDeclaration, k as validateEntitiesConfig, l as ConfigValidationError, m as DiscoveredSchemaTable, u as ConfigValidationResult } from "./entity-config-B2RA53nw.cjs";
-import { a as ClivlyConnectResult, c as ClivlyUser, d as DiscoveredTable, f as DoctorCheck, g as EnsuredObjectTypeResult, h as EnsuredMappingResult, i as ClivlyConnectReason, l as CreateChatSessionHandlerOptions, m as EnsureSchemaResult, n as ChatSessionRequestBody, o as ClivlySDK, p as DoctorReport, r as ChatWidgetVisitor, s as ClivlySDKConfig, u as CursorStore } from "./namespace-probe-BoGI18dQ.cjs";
+import { a as ClivlyConnectResult, c as ClivlyUser, d as DiscoveredTable, f as DoctorCheck, g as EnsuredObjectTypeResult, h as EnsuredMappingResult, i as ClivlyConnectReason, l as CreateChatSessionHandlerOptions, m as EnsureSchemaResult, n as ChatSessionRequestBody, o as ClivlySDK, p as DoctorReport, r as ChatWidgetVisitor, s as ClivlySDKConfig, u as CursorStore, v as SyncTriggerDescription } from "./namespace-probe-DaTJINS-.cjs";
 //#region ../sdk/src/trigger-url.d.ts
 declare function isPlaceholderUrl(value: string): boolean;
 //#endregion
@@ -36,4 +36,4 @@ declare class ClivlyNetworkError extends ClivlyError {}
  */
 declare function createClivlySDK(config: ClivlySDKConfig): ClivlySDK;
 //#endregion
-export { type ChatSessionRequestBody, type ChatWidgetVisitor, ClivlyAuthError, type ClivlyConnectReason, type ClivlyConnectResult, type ClivlyEntitiesConfig, ClivlyError, ClivlyNetworkError, ClivlyRateLimitError, type ClivlySDK, type ClivlySDKConfig, type ClivlyUser, type ConfigValidationError, type ConfigValidationResult, type CreateChatSessionHandlerOptions, type CursorStore, type CustomObjectDeclaration, type DiscoveredSchemaTable, type DiscoveredTable, type DoctorCheck, type DoctorReport, type EnsureSchemaResult, type EnsuredMappingResult, type EnsuredObjectTypeResult, createChatSessionHandler, createClivlySDK, customObjectDeclarations, defineClivlyConfig, isPlaceholderUrl, validateEntitiesConfig };
+export { type ChatSessionRequestBody, type ChatWidgetVisitor, ClivlyAuthError, type ClivlyConnectReason, type ClivlyConnectResult, type ClivlyEntitiesConfig, ClivlyError, ClivlyNetworkError, ClivlyRateLimitError, type ClivlySDK, type ClivlySDKConfig, type ClivlyUser, type ConfigValidationError, type ConfigValidationResult, type CreateChatSessionHandlerOptions, type CursorStore, type CustomObjectDeclaration, type DiscoveredSchemaTable, type DiscoveredTable, type DoctorCheck, type DoctorReport, type EnsureSchemaResult, type EnsuredMappingResult, type EnsuredObjectTypeResult, type SyncTriggerDescription, createChatSessionHandler, createClivlySDK, customObjectDeclarations, defineClivlyConfig, isPlaceholderUrl, validateEntitiesConfig };

package/sdk.d.mts

@@ -1,5 +1,5 @@
 import { C as defineClivlyConfig, S as customObjectDeclarations, a as ClivlyEntitiesConfig, f as CustomObjectDeclaration, k as validateEntitiesConfig, l as ConfigValidationError, m as DiscoveredSchemaTable, u as ConfigValidationResult } from "./entity-config-B2RA53nw.mjs";
-import { a as ClivlyConnectResult, c as ClivlyUser, d as DiscoveredTable, f as DoctorCheck, g as EnsuredObjectTypeResult, h as EnsuredMappingResult, i as ClivlyConnectReason, l as CreateChatSessionHandlerOptions, m as EnsureSchemaResult, n as ChatSessionRequestBody, o as ClivlySDK, p as DoctorReport, r as ChatWidgetVisitor, s as ClivlySDKConfig, u as CursorStore } from "./namespace-probe-Cn7voAd0.mjs";
+import { a as ClivlyConnectResult, c as ClivlyUser, d as DiscoveredTable, f as DoctorCheck, g as EnsuredObjectTypeResult, h as EnsuredMappingResult, i as ClivlyConnectReason, l as CreateChatSessionHandlerOptions, m as EnsureSchemaResult, n as ChatSessionRequestBody, o as ClivlySDK, p as DoctorReport, r as ChatWidgetVisitor, s as ClivlySDKConfig, u as CursorStore, v as SyncTriggerDescription } from "./namespace-probe-Ckn9yJ6F.mjs";
 //#region ../sdk/src/trigger-url.d.ts
 declare function isPlaceholderUrl(value: string): boolean;
 //#endregion
@@ -36,4 +36,4 @@ declare class ClivlyNetworkError extends ClivlyError {}
  */
 declare function createClivlySDK(config: ClivlySDKConfig): ClivlySDK;
 //#endregion
-export { type ChatSessionRequestBody, type ChatWidgetVisitor, ClivlyAuthError, type ClivlyConnectReason, type ClivlyConnectResult, type ClivlyEntitiesConfig, ClivlyError, ClivlyNetworkError, ClivlyRateLimitError, type ClivlySDK, type ClivlySDKConfig, type ClivlyUser, type ConfigValidationError, type ConfigValidationResult, type CreateChatSessionHandlerOptions, type CursorStore, type CustomObjectDeclaration, type DiscoveredSchemaTable, type DiscoveredTable, type DoctorCheck, type DoctorReport, type EnsureSchemaResult, type EnsuredMappingResult, type EnsuredObjectTypeResult, createChatSessionHandler, createClivlySDK, customObjectDeclarations, defineClivlyConfig, isPlaceholderUrl, validateEntitiesConfig };
+export { type ChatSessionRequestBody, type ChatWidgetVisitor, ClivlyAuthError, type ClivlyConnectReason, type ClivlyConnectResult, type ClivlyEntitiesConfig, ClivlyError, ClivlyNetworkError, ClivlyRateLimitError, type ClivlySDK, type ClivlySDKConfig, type ClivlyUser, type ConfigValidationError, type ConfigValidationResult, type CreateChatSessionHandlerOptions, type CursorStore, type CustomObjectDeclaration, type DiscoveredSchemaTable, type DiscoveredTable, type DoctorCheck, type DoctorReport, type EnsureSchemaResult, type EnsuredMappingResult, type EnsuredObjectTypeResult, type SyncTriggerDescription, createChatSessionHandler, createClivlySDK, customObjectDeclarations, defineClivlyConfig, isPlaceholderUrl, validateEntitiesConfig };

package/sdk.mjs

@@ -1,3 +1,3 @@
-import { o as customObjectDeclarations, p as validateEntitiesConfig, s as defineClivlyConfig } from "./entity-config-B74SPOUZ.mjs";
-import { a as ClivlyRateLimitError, i as ClivlyNetworkError, n as ClivlyAuthError, o as createChatSessionHandler, r as ClivlyError, s as isPlaceholderUrl, t as createClivlySDK } from "./sdk-DYBDR939.mjs";
+import { o as customObjectDeclarations, p as validateEntitiesConfig, s as defineClivlyConfig } from "./entity-config-CusbTOJ1.mjs";
+import { a as ClivlyRateLimitError, i as ClivlyNetworkError, n as ClivlyAuthError, o as createChatSessionHandler, r as ClivlyError, s as isPlaceholderUrl, t as createClivlySDK } from "./sdk-Dkq6ELkf.mjs";
 export { ClivlyAuthError, ClivlyError, ClivlyNetworkError, ClivlyRateLimitError, createChatSessionHandler, createClivlySDK, customObjectDeclarations, defineClivlyConfig, isPlaceholderUrl, validateEntitiesConfig };

package/{sync-engine-C4A5jgA4.cjs → sync-engine-BLgwLpR6.cjs}

@@ -1,4 +1,4 @@
-const require_view_compiler = require("./view-compiler-B5nDal14.cjs");
+const require_view_compiler = require("./view-compiler-BHI5E4QI.cjs");
 //#region ../core/src/sync-engine.ts
 /**
 * Diff a view's rows against the current mirror population for one entity.

package/{sync-engine-Dt5QQSKO.mjs → sync-engine-B_IzoUSx.mjs}

@@ -1,4 +1,4 @@
-import { r as compileEntityViews } from "./view-compiler-CSYwEWf5.mjs";
+import { r as compileEntityViews } from "./view-compiler-D_6gfXFr.mjs";
 //#region ../core/src/sync-engine.ts
 /**
 * Diff a view's rows against the current mirror population for one entity.

package/{view-compiler-B5nDal14.cjs → view-compiler-BHI5E4QI.cjs}

@@ -1,5 +1,5 @@
-const require_projection = require("./projection-Dz6_i1-w.cjs");
-const require_projection_sql = require("./projection-sql-Cl1qIn8m.cjs");
+const require_projection = require("./projection-DEwL-D8R.cjs");
+const require_projection_sql = require("./projection-sql-iHy-Cx6V.cjs");
 //#region ../core/src/view-compiler.ts
 /**
 * View compiler (Phase 2) — turns a validated entity config into read-only

package/{view-compiler-CSYwEWf5.mjs → view-compiler-D_6gfXFr.mjs}

@@ -1,5 +1,5 @@
-import { t as BASE_REF } from "./projection-CSGJbZlZ.mjs";
-import { a as quoteIdent, i as compileProjectionSelect, r as compileProjectionJoins, t as compileProjectionFrom } from "./projection-sql-BgnfiGqF.mjs";
+import { t as BASE_REF } from "./projection-hnPSgH6G.mjs";
+import { i as compileProjectionJoins, n as compileProjectionFrom, o as compileProjectionSelect, s as quoteIdent } from "./projection-sql-9zzTVGvf.mjs";
 //#region ../core/src/view-compiler.ts
 /**
 * View compiler (Phase 2) — turns a validated entity config into read-only

package/vite.d.cts

@@ -1,4 +1,4 @@
-import { o as ClivlySDK } from "./namespace-probe-BoGI18dQ.cjs";
+import { o as ClivlySDK } from "./namespace-probe-DaTJINS-.cjs";
 import { Plugin } from "vite";
 //#region ../sdk/src/vite.d.ts
 interface ClivlyViteOptions {

package/vite.d.mts

@@ -1,4 +1,4 @@
-import { o as ClivlySDK } from "./namespace-probe-Cn7voAd0.mjs";
+import { o as ClivlySDK } from "./namespace-probe-Ckn9yJ6F.mjs";
 import { Plugin } from "vite";
 //#region ../sdk/src/vite.d.ts
 interface ClivlyViteOptions {

package/internal-CykXpEGk.mjs

@@ -1,68 +0,0 @@
-import { n as PROJECTION_KEY_PATTERN, t as BASE_REF } from "./projection-CSGJbZlZ.mjs";
-import { h as fanOutJoins, m as validateProjection } from "./entity-config-B74SPOUZ.mjs";
-//#region ../core/src/projection-draft.ts
-function emptyProjectionDraft(baseTable) {
-	return {
-		baseTable,
-		entityKey: "",
-		fieldBindings: {},
-		identity: { kind: "base_pk" },
-		joins: []
-	};
-}
-/**
-* The ON conditions implied by a foreign key between the two tables, so the
-* builder can pre-fill a join instead of making the user hand-pick columns.
-* Returns [] when no FK relates them — the user then picks manually.
-*/
-function suggestJoinConditions(baseTable, joinTable, schema, joinKey) {
-	const join = schema.find((t) => t.name === joinTable);
-	const conditions = [];
-	for (const column of join?.columnsMeta ?? []) if (column.references?.table === baseTable) conditions.push({
-		left: {
-			table: joinKey,
-			column: column.name
-		},
-		op: "eq",
-		right: {
-			table: BASE_REF,
-			column: column.references.column
-		}
-	});
-	return conditions;
-}
-/** A draft becomes a projection once it has a valid key and ≥1 binding. */
-function draftToProjection(draft) {
-	if (!PROJECTION_KEY_PATTERN.test(draft.entityKey)) return null;
-	if (Object.keys(draft.fieldBindings).length === 0) return null;
-	return {
-		version: 1,
-		kind: "projection",
-		entityKey: draft.entityKey,
-		baseTable: draft.baseTable,
-		joins: draft.joins,
-		fieldBindings: draft.fieldBindings,
-		identity: draft.identity
-	};
-}
-function draftErrors(draft, schema) {
-	const projection = draftToProjection(draft);
-	if (!projection) return [{
-		path: "projection",
-		message: "Name the object and map a field."
-	}];
-	return validateProjection(projection, schema, "projection");
-}
-/** Per-join fan-out, for the builder's inline cardinality hints. */
-function describeCardinality(draft, schema) {
-	const projection = draftToProjection(draft);
-	if (!projection) return [];
-	const tablesByName = new Map(schema.map((t) => [t.name, t]));
-	const fanning = new Set(fanOutJoins(projection, tablesByName).map((j) => j.key));
-	return projection.joins.map((join) => ({
-		joinKey: join.key,
-		fansOut: fanning.has(join.key)
-	}));
-}
-//#endregion
-export { suggestJoinConditions as a, emptyProjectionDraft as i, draftErrors as n, draftToProjection as r, describeCardinality as t };

package/internal-DqduZU3l.cjs

@@ -1,97 +0,0 @@
-const require_projection = require("./projection-Dz6_i1-w.cjs");
-const require_entity_config = require("./entity-config-7sGCk_nw.cjs");
-//#region ../core/src/projection-draft.ts
-function emptyProjectionDraft(baseTable) {
-	return {
-		baseTable,
-		entityKey: "",
-		fieldBindings: {},
-		identity: { kind: "base_pk" },
-		joins: []
-	};
-}
-/**
-* The ON conditions implied by a foreign key between the two tables, so the
-* builder can pre-fill a join instead of making the user hand-pick columns.
-* Returns [] when no FK relates them — the user then picks manually.
-*/
-function suggestJoinConditions(baseTable, joinTable, schema, joinKey) {
-	const join = schema.find((t) => t.name === joinTable);
-	const conditions = [];
-	for (const column of join?.columnsMeta ?? []) if (column.references?.table === baseTable) conditions.push({
-		left: {
-			table: joinKey,
-			column: column.name
-		},
-		op: "eq",
-		right: {
-			table: require_projection.BASE_REF,
-			column: column.references.column
-		}
-	});
-	return conditions;
-}
-/** A draft becomes a projection once it has a valid key and ≥1 binding. */
-function draftToProjection(draft) {
-	if (!require_projection.PROJECTION_KEY_PATTERN.test(draft.entityKey)) return null;
-	if (Object.keys(draft.fieldBindings).length === 0) return null;
-	return {
-		version: 1,
-		kind: "projection",
-		entityKey: draft.entityKey,
-		baseTable: draft.baseTable,
-		joins: draft.joins,
-		fieldBindings: draft.fieldBindings,
-		identity: draft.identity
-	};
-}
-function draftErrors(draft, schema) {
-	const projection = draftToProjection(draft);
-	if (!projection) return [{
-		path: "projection",
-		message: "Name the object and map a field."
-	}];
-	return require_entity_config.validateProjection(projection, schema, "projection");
-}
-/** Per-join fan-out, for the builder's inline cardinality hints. */
-function describeCardinality(draft, schema) {
-	const projection = draftToProjection(draft);
-	if (!projection) return [];
-	const tablesByName = new Map(schema.map((t) => [t.name, t]));
-	const fanning = new Set(require_entity_config.fanOutJoins(projection, tablesByName).map((j) => j.key));
-	return projection.joins.map((join) => ({
-		joinKey: join.key,
-		fansOut: fanning.has(join.key)
-	}));
-}
-//#endregion
-Object.defineProperty(exports, "describeCardinality", {
-	enumerable: true,
-	get: function() {
-		return describeCardinality;
-	}
-});
-Object.defineProperty(exports, "draftErrors", {
-	enumerable: true,
-	get: function() {
-		return draftErrors;
-	}
-});
-Object.defineProperty(exports, "draftToProjection", {
-	enumerable: true,
-	get: function() {
-		return draftToProjection;
-	}
-});
-Object.defineProperty(exports, "emptyProjectionDraft", {
-	enumerable: true,
-	get: function() {
-		return emptyProjectionDraft;
-	}
-});
-Object.defineProperty(exports, "suggestJoinConditions", {
-	enumerable: true,
-	get: function() {
-		return suggestJoinConditions;
-	}
-});