clivly 0.9.2 → 0.9.4

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

@@ -1,5 +1,5 @@
-const require_entity_config = require("./entity-config-DtBsl2MQ.cjs");
-const require_mappings_config = require("./mappings-config-B0RqFLxu.cjs");
+const require_entity_config = require("./entity-config-7sGCk_nw.cjs");
+const require_mappings_config = require("./mappings-config-CLyEg0sf.cjs");
 const require_drizzle_meta = require("./drizzle-meta-Bb1JWYqf.cjs");
 //#region ../sdk/src/deployment-identity.ts
 const MAX_DEPLOYMENT_ID_LENGTH = 128;
@@ -123,11 +123,16 @@ function checkConceptCoverage(config) {
 }
 //#endregion
 //#region ../sdk/src/custom-slug.ts
+const SLUG_PATTERN = /^[a-z][a-z0-9_-]*$/;
 const NON_ALNUM = /[^a-z0-9]+/g;
 const EDGE_HYPHENS = /(^-|-$)/g;
 function slugify(value) {
 	return value.toLowerCase().trim().replace(NON_ALNUM, "-").replace(EDGE_HYPHENS, "");
 }
+function suggestionFor(declared) {
+	const candidate = slugify(declared);
+	return candidate !== declared && SLUG_PATTERN.test(candidate) ? ` Did you mean "${candidate}"?` : "";
+}
 function checkCustomObjectSlugs(config) {
 	const custom = config.source?.custom ?? [];
 	const declared = config.entities ? require_entity_config.customObjectDeclarations(config.entities) : [];
@@ -141,12 +146,11 @@ function checkCustomObjectSlugs(config) {
 	const seen = /* @__PURE__ */ new Map();
 	for (const source of custom) {
 		const declared = source.objectType;
-		const canonical = slugify(declared);
-		if (canonical === "") problems.push(`"${source.entity}" has an empty objectType.`);
-		else if (canonical !== declared) problems.push(`"${declared}" is not a slug — the dashboard would store it as "${canonical}".`);
-		const prior = seen.get(canonical);
-		if (prior && canonical !== "") problems.push(`duplicate slug "${canonical}" declared by "${prior}" and "${source.entity}".`);
-		else seen.set(canonical, source.entity);
+		if (declared === "") problems.push(`"${source.entity}" has an empty objectType.`);
+		else if (!SLUG_PATTERN.test(declared)) problems.push(`"${declared}" is not a valid object type slug — use lowercase letters, digits, "-" or "_", starting with a letter.${suggestionFor(declared)}`);
+		const prior = seen.get(declared);
+		if (prior && declared !== "") problems.push(`duplicate slug "${declared}" declared by "${prior}" and "${source.entity}".`);
+		else seen.set(declared, source.entity);
 	}
 	if (problems.length > 0) return {
 		name: "Custom object slugs",
@@ -253,10 +257,20 @@ async function runMappingDryRun(config, entityKey) {
 		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}`);
+	if (missing.length === 0) return {
+		name,
+		ok: true,
+		detail: `Mapped ${Object.keys(fields).length} field(s) from a real "${resolved.source.entity}" row.`
+	};
+	if (config.entities?.entities?.[entityKey]?.projection !== void 0 && missing.length === Object.keys(fields).length) return {
+		name,
+		ok: false,
+		detail: `Row from "${resolved.source.entity}" carries none of the projection's columns (${missing.join(", ")}) — the source performs no joins, so the projection is declared but never executed. Build it with \`fromDrizzleProjection\` from \`clivly/drizzle\`, which runs the joins and returns rows keyed by ref token.`
+	};
 	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(", ")}.`
+		ok: false,
+		detail: `Row from "${resolved.source.entity}" is missing mapped column(s): ${missing.join(", ")}.`
 	};
 }
 //#endregion
@@ -465,9 +479,27 @@ async function mappingDryRunChecks(config) {
 	return checks;
 }
 /**
+* Why a source has no `DRIZZLE_META`, without asserting more than we know.
+*
+* There are two ways to get here and they are indistinguishable at runtime: the
+* source really was hand-written, or it came from `fromDrizzle` and a spread
+* stripped the metadata, which is non-enumerable. The second is easy to fall
+* into precisely where `objectType` is present — `source.custom` is typed
+* `Array<SyncSource & { objectType: string }>`, so attaching that property with
+* `{ ...fromDrizzle(...), objectType }` used to be the only way to satisfy it.
+*
+* Flatly calling such a source "hand-written" sent developers looking for one
+* that does not exist. Where `objectType` is present, name the likelier cause
+* and the fix instead of guessing wrong with confidence.
+*/
+function missingMetaDetail(source) {
+	const skipped = "column check skipped";
+	if (source.objectType === void 0) return `"${source.entity}" is a hand-written source — ${skipped}.`;
+	return `"${source.entity}" has no drizzle metadata — ${skipped}. If it came from \`fromDrizzle\`, a spread such as \`{ ...fromDrizzle(...), objectType }\` dropped it; pass \`objectType\` to \`fromDrizzle\` instead.`;
+}
+/**
 * Confirm each drizzle source actually has the cursor and id columns the sync
-* pages on. Hand-written sources have no column metadata, so they are skipped
-* rather than failed.
+* pages on. Sources with no column metadata are skipped rather than failed.
 */
 function cursorColumnChecks(sources) {
 	const checks = [];
@@ -478,7 +510,7 @@ function cursorColumnChecks(sources) {
 				name: `Cursor/id columns exist (${source.entity})`,
 				ok: false,
 				skipped: true,
-				detail: `"${source.entity}" is a hand-written source — column check skipped.`
+				detail: missingMetaDetail(source)
 			});
 			continue;
 		}
@@ -1117,11 +1149,16 @@ function observedTriggerUrl(req) {
 		return new URL(`${proto}://${host}${requestUrl.pathname}`).toString();
 	} catch {}
 }
+const PLACEHOLDER_BRACKETS = /[<>]/;
+function isPlaceholderUrl(value) {
+	return PLACEHOLDER_BRACKETS.test(value);
+}
 /**
 * Decide which trigger URL to report, in precedence order:
 *
 *   1. `configuredUrl` — an explicit `syncTrigger.url`. Someone typed this on
-*      purpose, so it beats anything inferred.
+*      purpose, so it beats anything inferred. An unedited placeholder is not
+*      "on purpose" and is skipped.
 *   2. platform env origin + `configuredPath` — available at boot, before any
 *      request has arrived. Needs the path because platform variables only give
 *      an origin.
@@ -1131,7 +1168,7 @@ function observedTriggerUrl(req) {
 * doesn't need to know about it.
 */
 function resolveTriggerUrl(args) {
-	if (args.configuredUrl) return args.configuredUrl;
+	if (args.configuredUrl && !isPlaceholderUrl(args.configuredUrl)) return args.configuredUrl;
 	const origin = originFromPlatformEnv(args.env);
 	if (origin && args.configuredPath) return `${origin}${args.configuredPath.startsWith("/") ? args.configuredPath : `/${args.configuredPath}`}`;
 	return args.observedUrl;
@@ -1789,6 +1826,7 @@ function createClivlySDK(config) {
 				reason: "ok",
 				retryable: false,
 				org: body?.org,
+				workspace: body?.workspace ?? null,
 				..."appLastSeenAt" in body ? { appLastSeenAt: body.appLastSeenAt ?? null } : {}
 			};
 		}
@@ -1996,3 +2034,9 @@ Object.defineProperty(exports, "createClivlySDK", {
 		return createClivlySDK;
 	}
 });
+Object.defineProperty(exports, "isPlaceholderUrl", {
+	enumerable: true,
+	get: function() {
+		return isPlaceholderUrl;
+	}
+});

package/{sdk-DXV8M_Io.mjs → sdk-DYBDR939.mjs}

@@ -1,5 +1,5 @@
-import { o as customObjectDeclarations } from "./entity-config-kUHri9yA.mjs";
-import { t as entitiesToMappings } from "./mappings-config-B1b1HVBg.mjs";
+import { o as customObjectDeclarations } from "./entity-config-B74SPOUZ.mjs";
+import { t as entitiesToMappings } from "./mappings-config-DQS_s4dg.mjs";
 import { t as DRIZZLE_META } from "./drizzle-meta-D-5k3n0i.mjs";
 //#region ../sdk/src/deployment-identity.ts
 const MAX_DEPLOYMENT_ID_LENGTH = 128;
@@ -123,11 +123,16 @@ function checkConceptCoverage(config) {
 }
 //#endregion
 //#region ../sdk/src/custom-slug.ts
+const SLUG_PATTERN = /^[a-z][a-z0-9_-]*$/;
 const NON_ALNUM = /[^a-z0-9]+/g;
 const EDGE_HYPHENS = /(^-|-$)/g;
 function slugify(value) {
 	return value.toLowerCase().trim().replace(NON_ALNUM, "-").replace(EDGE_HYPHENS, "");
 }
+function suggestionFor(declared) {
+	const candidate = slugify(declared);
+	return candidate !== declared && SLUG_PATTERN.test(candidate) ? ` Did you mean "${candidate}"?` : "";
+}
 function checkCustomObjectSlugs(config) {
 	const custom = config.source?.custom ?? [];
 	const declared = config.entities ? customObjectDeclarations(config.entities) : [];
@@ -141,12 +146,11 @@ function checkCustomObjectSlugs(config) {
 	const seen = /* @__PURE__ */ new Map();
 	for (const source of custom) {
 		const declared = source.objectType;
-		const canonical = slugify(declared);
-		if (canonical === "") problems.push(`"${source.entity}" has an empty objectType.`);
-		else if (canonical !== declared) problems.push(`"${declared}" is not a slug — the dashboard would store it as "${canonical}".`);
-		const prior = seen.get(canonical);
-		if (prior && canonical !== "") problems.push(`duplicate slug "${canonical}" declared by "${prior}" and "${source.entity}".`);
-		else seen.set(canonical, source.entity);
+		if (declared === "") problems.push(`"${source.entity}" has an empty objectType.`);
+		else if (!SLUG_PATTERN.test(declared)) problems.push(`"${declared}" is not a valid object type slug — use lowercase letters, digits, "-" or "_", starting with a letter.${suggestionFor(declared)}`);
+		const prior = seen.get(declared);
+		if (prior && declared !== "") problems.push(`duplicate slug "${declared}" declared by "${prior}" and "${source.entity}".`);
+		else seen.set(declared, source.entity);
 	}
 	if (problems.length > 0) return {
 		name: "Custom object slugs",
@@ -253,10 +257,20 @@ async function runMappingDryRun(config, entityKey) {
 		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}`);
+	if (missing.length === 0) return {
+		name,
+		ok: true,
+		detail: `Mapped ${Object.keys(fields).length} field(s) from a real "${resolved.source.entity}" row.`
+	};
+	if (config.entities?.entities?.[entityKey]?.projection !== void 0 && missing.length === Object.keys(fields).length) return {
+		name,
+		ok: false,
+		detail: `Row from "${resolved.source.entity}" carries none of the projection's columns (${missing.join(", ")}) — the source performs no joins, so the projection is declared but never executed. Build it with \`fromDrizzleProjection\` from \`clivly/drizzle\`, which runs the joins and returns rows keyed by ref token.`
+	};
 	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(", ")}.`
+		ok: false,
+		detail: `Row from "${resolved.source.entity}" is missing mapped column(s): ${missing.join(", ")}.`
 	};
 }
 //#endregion
@@ -465,9 +479,27 @@ async function mappingDryRunChecks(config) {
 	return checks;
 }
 /**
+* Why a source has no `DRIZZLE_META`, without asserting more than we know.
+*
+* There are two ways to get here and they are indistinguishable at runtime: the
+* source really was hand-written, or it came from `fromDrizzle` and a spread
+* stripped the metadata, which is non-enumerable. The second is easy to fall
+* into precisely where `objectType` is present — `source.custom` is typed
+* `Array<SyncSource & { objectType: string }>`, so attaching that property with
+* `{ ...fromDrizzle(...), objectType }` used to be the only way to satisfy it.
+*
+* Flatly calling such a source "hand-written" sent developers looking for one
+* that does not exist. Where `objectType` is present, name the likelier cause
+* and the fix instead of guessing wrong with confidence.
+*/
+function missingMetaDetail(source) {
+	const skipped = "column check skipped";
+	if (source.objectType === void 0) return `"${source.entity}" is a hand-written source — ${skipped}.`;
+	return `"${source.entity}" has no drizzle metadata — ${skipped}. If it came from \`fromDrizzle\`, a spread such as \`{ ...fromDrizzle(...), objectType }\` dropped it; pass \`objectType\` to \`fromDrizzle\` instead.`;
+}
+/**
 * Confirm each drizzle source actually has the cursor and id columns the sync
-* pages on. Hand-written sources have no column metadata, so they are skipped
-* rather than failed.
+* pages on. Sources with no column metadata are skipped rather than failed.
 */
 function cursorColumnChecks(sources) {
 	const checks = [];
@@ -478,7 +510,7 @@ function cursorColumnChecks(sources) {
 				name: `Cursor/id columns exist (${source.entity})`,
 				ok: false,
 				skipped: true,
-				detail: `"${source.entity}" is a hand-written source — column check skipped.`
+				detail: missingMetaDetail(source)
 			});
 			continue;
 		}
@@ -1117,11 +1149,16 @@ function observedTriggerUrl(req) {
 		return new URL(`${proto}://${host}${requestUrl.pathname}`).toString();
 	} catch {}
 }
+const PLACEHOLDER_BRACKETS = /[<>]/;
+function isPlaceholderUrl(value) {
+	return PLACEHOLDER_BRACKETS.test(value);
+}
 /**
 * Decide which trigger URL to report, in precedence order:
 *
 *   1. `configuredUrl` — an explicit `syncTrigger.url`. Someone typed this on
-*      purpose, so it beats anything inferred.
+*      purpose, so it beats anything inferred. An unedited placeholder is not
+*      "on purpose" and is skipped.
 *   2. platform env origin + `configuredPath` — available at boot, before any
 *      request has arrived. Needs the path because platform variables only give
 *      an origin.
@@ -1131,7 +1168,7 @@ function observedTriggerUrl(req) {
 * doesn't need to know about it.
 */
 function resolveTriggerUrl(args) {
-	if (args.configuredUrl) return args.configuredUrl;
+	if (args.configuredUrl && !isPlaceholderUrl(args.configuredUrl)) return args.configuredUrl;
 	const origin = originFromPlatformEnv(args.env);
 	if (origin && args.configuredPath) return `${origin}${args.configuredPath.startsWith("/") ? args.configuredPath : `/${args.configuredPath}`}`;
 	return args.observedUrl;
@@ -1789,6 +1826,7 @@ function createClivlySDK(config) {
 				reason: "ok",
 				retryable: false,
 				org: body?.org,
+				workspace: body?.workspace ?? null,
 				..."appLastSeenAt" in body ? { appLastSeenAt: body.appLastSeenAt ?? null } : {}
 			};
 		}
@@ -1960,4 +1998,4 @@ function createClivlySDK(config) {
 	};
 }
 //#endregion
-export { ClivlyRateLimitError as a, ClivlyNetworkError as i, ClivlyAuthError as n, createChatSessionHandler as o, ClivlyError as r, createClivlySDK as t };
+export { ClivlyRateLimitError as a, ClivlyNetworkError as i, ClivlyAuthError as n, createChatSessionHandler as o, ClivlyError as r, isPlaceholderUrl as s, createClivlySDK as t };

package/sdk.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_entity_config = require("./entity-config-DtBsl2MQ.cjs");
-const require_sdk = require("./sdk-D4Wp_uxb.cjs");
+const require_entity_config = require("./entity-config-7sGCk_nw.cjs");
+const require_sdk = require("./sdk-CM1UO-I7.cjs");
 exports.ClivlyAuthError = require_sdk.ClivlyAuthError;
 exports.ClivlyError = require_sdk.ClivlyError;
 exports.ClivlyNetworkError = require_sdk.ClivlyNetworkError;
@@ -9,4 +9,5 @@ exports.createChatSessionHandler = require_sdk.createChatSessionHandler;
 exports.createClivlySDK = require_sdk.createClivlySDK;
 exports.customObjectDeclarations = require_entity_config.customObjectDeclarations;
 exports.defineClivlyConfig = require_entity_config.defineClivlyConfig;
+exports.isPlaceholderUrl = require_sdk.isPlaceholderUrl;
 exports.validateEntitiesConfig = require_entity_config.validateEntitiesConfig;

package/sdk.d.cts

@@ -1,5 +1,8 @@
 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-C6aHjedO.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";
+//#region ../sdk/src/trigger-url.d.ts
+declare function isPlaceholderUrl(value: string): boolean;
+//#endregion
 //#region ../sdk/src/chat-session.d.ts
 declare function createChatSessionHandler({ allowedOrigins, apiKey, apiUrl, fetchImpl, resolveUser }: CreateChatSessionHandlerOptions): (request: Request) => Promise<Response>;
 //#endregion
@@ -33,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, 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, createChatSessionHandler, createClivlySDK, customObjectDeclarations, defineClivlyConfig, isPlaceholderUrl, validateEntitiesConfig };

package/sdk.d.mts

@@ -1,5 +1,8 @@
 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-Dj-0Q3Hb.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";
+//#region ../sdk/src/trigger-url.d.ts
+declare function isPlaceholderUrl(value: string): boolean;
+//#endregion
 //#region ../sdk/src/chat-session.d.ts
 declare function createChatSessionHandler({ allowedOrigins, apiKey, apiUrl, fetchImpl, resolveUser }: CreateChatSessionHandlerOptions): (request: Request) => Promise<Response>;
 //#endregion
@@ -33,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, 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, 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-kUHri9yA.mjs";
-import { a as ClivlyRateLimitError, i as ClivlyNetworkError, n as ClivlyAuthError, o as createChatSessionHandler, r as ClivlyError, t as createClivlySDK } from "./sdk-DXV8M_Io.mjs";
-export { ClivlyAuthError, ClivlyError, ClivlyNetworkError, ClivlyRateLimitError, createChatSessionHandler, createClivlySDK, customObjectDeclarations, defineClivlyConfig, validateEntitiesConfig };
+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";
+export { ClivlyAuthError, ClivlyError, ClivlyNetworkError, ClivlyRateLimitError, createChatSessionHandler, createClivlySDK, customObjectDeclarations, defineClivlyConfig, isPlaceholderUrl, validateEntitiesConfig };

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

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

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

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

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

@@ -1,58 +1,5 @@
-const require_projection = require("./projection-C5244vGa.cjs");
-//#region ../core/src/projection-sql.ts
-/**
-* SQL generation for projection-backed entities.
-*
-* Base and joins are aliased by their ref key (`base`, then each join's `key`),
-* which is what allows the same table to be joined twice and keeps generated
-* SQL independent of host table names.
-*
-* Pure string generation — no DB access. Identifiers are escaped so output is
-* deterministic and injection-safe.
-*/
-/** Quote a single identifier part, escaping embedded double-quotes. */
-function quoteIdent(name) {
-	return `"${name.replace(/"/g, "\"\"")}"`;
-}
-function refSql(ref) {
-	return `${quoteIdent(ref.table)}.${quoteIdent(ref.column)}`;
-}
-/**
-* The identity expression, aliased as `id`. Composite identities concatenate
-* their parts with `::`; validation guarantees every part is NOT NULL and
-* non-text, which is what makes the concatenation collision-free.
-*/
-function identitySql(projection, basePkColumn) {
-	const refs = require_projection.identityRefs(projection.identity, basePkColumn);
-	if (projection.identity.kind === "composite") return `CONCAT_WS('::', ${refs.map((ref) => `${refSql(ref)}::text`).join(", ")}) AS ${quoteIdent("id")}`;
-	const [ref] = refs;
-	if (!ref) throw new Error("projection identity resolved to no column");
-	return `${refSql(ref)} AS ${quoteIdent("id")}`;
-}
-function compileProjectionSelect(projection, basePkColumn) {
-	const selectItems = [identitySql(projection, basePkColumn)];
-	const columns = ["id"];
-	for (const [field, binding] of Object.entries(projection.fieldBindings)) {
-		selectItems.push(`${refSql(binding.from)} AS ${quoteIdent(field)}`);
-		columns.push(field);
-	}
-	return {
-		columns,
-		selectItems
-	};
-}
-function compileProjectionJoins(projection) {
-	return projection.joins.map((join) => {
-		const keyword = join.type === "inner" ? "INNER JOIN" : "LEFT JOIN";
-		const on = join.on.map((c) => `${refSql(c.left)} = ${refSql(c.right)}`).join(" AND ");
-		return `${keyword} ${quoteIdent(join.table)} AS ${quoteIdent(join.key)} ON ${on}`;
-	});
-}
-/** `FROM <baseTable> AS "base"` — the alias every ref resolves against. */
-function compileProjectionFrom(projection) {
-	return `FROM ${quoteIdent(projection.baseTable)} AS ${quoteIdent(require_projection.BASE_REF)}`;
-}
-//#endregion
+const require_projection = require("./projection-Dz6_i1-w.cjs");
+const require_projection_sql = require("./projection-sql-Cl1qIn8m.cjs");
 //#region ../core/src/view-compiler.ts
 /**
 * View compiler (Phase 2) — turns a validated entity config into read-only
@@ -88,7 +35,7 @@ function quoteList(values) {
 }
 /** Compile one column predicate into a SQL boolean expression. */
 function compilePredicate(table, column, value) {
-	const col = `${quoteIdent(table)}.${quoteIdent(column)}`;
+	const col = `${require_projection_sql.quoteIdent(table)}.${require_projection_sql.quoteIdent(column)}`;
 	if (value === null || typeof value !== "object") return `${col} = ${quoteLiteral(value)}`;
 	if ("eq" in value) return `${col} = ${quoteLiteral(value.eq)}`;
 	if ("ne" in value) return `${col} <> ${quoteLiteral(value.ne)}`;
@@ -121,33 +68,33 @@ function refParts(ref, defaultTable) {
 }
 function compileRelationship(relName, rel, source, related) {
 	const refCol = `${relName}_ref`;
-	const refAlias = quoteIdent(refCol);
+	const refAlias = require_projection_sql.quoteIdent(refCol);
 	const { via } = rel;
 	if ("fkOn" in via) {
 		const relatedTable = related?.source ?? "";
 		if (via.fkOn === "company") {
 			const { table, column } = refParts(via.column, relatedTable);
 			const relatedFilter = compileFilterConditions(table, related?.filter);
-			const on = [`${quoteIdent(table)}.${quoteIdent(column)} = ${quoteIdent(source.source)}.${quoteIdent(SOURCE_KEY)}`, ...relatedFilter].join(" AND ");
+			const on = [`${require_projection_sql.quoteIdent(table)}.${require_projection_sql.quoteIdent(column)} = ${require_projection_sql.quoteIdent(source.source)}.${require_projection_sql.quoteIdent(SOURCE_KEY)}`, ...relatedFilter].join(" AND ");
 			return {
-				clause: `LEFT JOIN ${quoteIdent(table)} ON ${on}`,
-				refSelect: `${quoteIdent(table)}.${quoteIdent(SOURCE_KEY)} AS ${refAlias}`,
+				clause: `LEFT JOIN ${require_projection_sql.quoteIdent(table)} ON ${on}`,
+				refSelect: `${require_projection_sql.quoteIdent(table)}.${require_projection_sql.quoteIdent(SOURCE_KEY)} AS ${refAlias}`,
 				refColumn: refCol
 			};
 		}
 		const { table, column } = refParts(via.column, source.source);
-		const on = [`${quoteIdent(relatedTable)}.${quoteIdent(SOURCE_KEY)} = ${quoteIdent(table)}.${quoteIdent(column)}`, ...compileFilterConditions(relatedTable, related?.filter)].join(" AND ");
+		const on = [`${require_projection_sql.quoteIdent(relatedTable)}.${require_projection_sql.quoteIdent(SOURCE_KEY)} = ${require_projection_sql.quoteIdent(table)}.${require_projection_sql.quoteIdent(column)}`, ...compileFilterConditions(relatedTable, related?.filter)].join(" AND ");
 		return {
-			clause: `LEFT JOIN ${quoteIdent(relatedTable)} ON ${on}`,
-			refSelect: `${quoteIdent(relatedTable)}.${quoteIdent(SOURCE_KEY)} AS ${refAlias}`,
+			clause: `LEFT JOIN ${require_projection_sql.quoteIdent(relatedTable)} ON ${on}`,
+			refSelect: `${require_projection_sql.quoteIdent(relatedTable)}.${require_projection_sql.quoteIdent(SOURCE_KEY)} AS ${refAlias}`,
 			refColumn: refCol
 		};
 	}
 	if ("through" in via) {
-		const on = `${quoteIdent(via.through)}.${quoteIdent(via.localKey)} = ${quoteIdent(source.source)}.${quoteIdent(SOURCE_KEY)}`;
+		const on = `${require_projection_sql.quoteIdent(via.through)}.${require_projection_sql.quoteIdent(via.localKey)} = ${require_projection_sql.quoteIdent(source.source)}.${require_projection_sql.quoteIdent(SOURCE_KEY)}`;
 		return {
-			clause: `LEFT JOIN ${quoteIdent(via.through)} ON ${on}`,
-			refSelect: `${quoteIdent(via.through)}.${quoteIdent(via.foreignKey)} AS ${refAlias}`,
+			clause: `LEFT JOIN ${require_projection_sql.quoteIdent(via.through)} ON ${on}`,
+			refSelect: `${require_projection_sql.quoteIdent(via.through)}.${require_projection_sql.quoteIdent(via.foreignKey)} AS ${refAlias}`,
 			refColumn: refCol
 		};
 	}
@@ -159,10 +106,10 @@ function compileRelationship(relName, rel, source, related) {
 }
 /** SELECT items for a legacy single-table entity: source key, then fields. */
 function legacySelect(entity, src) {
-	const selectItems = [`${quoteIdent(src)}.${quoteIdent(SOURCE_KEY)} AS ${quoteIdent("id")}`];
+	const selectItems = [`${require_projection_sql.quoteIdent(src)}.${require_projection_sql.quoteIdent(SOURCE_KEY)} AS ${require_projection_sql.quoteIdent("id")}`];
 	const columns = ["id"];
 	for (const [field, column] of Object.entries(entity.fields)) {
-		selectItems.push(`${quoteIdent(src)}.${quoteIdent(column)} AS ${quoteIdent(field)}`);
+		selectItems.push(`${require_projection_sql.quoteIdent(src)}.${require_projection_sql.quoteIdent(column)} AS ${require_projection_sql.quoteIdent(field)}`);
 		columns.push(field);
 	}
 	return {
@@ -209,14 +156,14 @@ function compileEntityView(config, entityKey, options = {}) {
 	const src = entity.source;
 	const projection = entity.projection;
 	const filterTable = projection ? require_projection.BASE_REF : src;
-	const { selectItems, columns } = projection ? compileProjectionSelect(projection, SOURCE_KEY) : legacySelect(entity, src);
-	const joins = projection ? compileProjectionJoins(projection) : legacyJoins(config, entity, columns, selectItems);
+	const { selectItems, columns } = projection ? require_projection_sql.compileProjectionSelect(projection, SOURCE_KEY) : legacySelect(entity, src);
+	const joins = projection ? require_projection_sql.compileProjectionJoins(projection) : legacyJoins(config, entity, columns, selectItems);
 	const conditions = compileFilterConditions(filterTable, entity.filter);
-	if (options.orgScope) conditions.push(`${quoteIdent(filterTable)}.${quoteIdent(options.orgScope.column)} = ${quoteLiteral(options.orgScope.value)}`);
+	if (options.orgScope) conditions.push(`${require_projection_sql.quoteIdent(filterTable)}.${require_projection_sql.quoteIdent(options.orgScope.column)} = ${quoteLiteral(options.orgScope.value)}`);
 	const lines = [
-		options.securityInvoker ?? true ? `CREATE OR REPLACE VIEW ${quoteIdent(viewName)} WITH (security_invoker = true) AS` : `CREATE OR REPLACE VIEW ${quoteIdent(viewName)} AS`,
+		options.securityInvoker ?? true ? `CREATE OR REPLACE VIEW ${require_projection_sql.quoteIdent(viewName)} WITH (security_invoker = true) AS` : `CREATE OR REPLACE VIEW ${require_projection_sql.quoteIdent(viewName)} AS`,
 		`SELECT ${selectItems.join(", ")}`,
-		projection ? compileProjectionFrom(projection) : `FROM ${quoteIdent(src)}`,
+		projection ? require_projection_sql.compileProjectionFrom(projection) : `FROM ${require_projection_sql.quoteIdent(src)}`,
 		...joins
 	];
 	if (conditions.length > 0) lines.push(`WHERE ${conditions.join(" AND ")}`);
@@ -229,7 +176,7 @@ function compileEntityView(config, entityKey, options = {}) {
 		sourceTable: src,
 		columns,
 		sql,
-		dropSql: `DROP VIEW IF EXISTS ${quoteIdent(viewName)};`
+		dropSql: `DROP VIEW IF EXISTS ${require_projection_sql.quoteIdent(viewName)};`
 	};
 }
 /** Compile every entity in the config into its view, in declaration order. */

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

@@ -1,58 +1,5 @@
-import { r as identityRefs, t as BASE_REF } from "./projection-D7xmQP4S.mjs";
-//#region ../core/src/projection-sql.ts
-/**
-* SQL generation for projection-backed entities.
-*
-* Base and joins are aliased by their ref key (`base`, then each join's `key`),
-* which is what allows the same table to be joined twice and keeps generated
-* SQL independent of host table names.
-*
-* Pure string generation — no DB access. Identifiers are escaped so output is
-* deterministic and injection-safe.
-*/
-/** Quote a single identifier part, escaping embedded double-quotes. */
-function quoteIdent(name) {
-	return `"${name.replace(/"/g, "\"\"")}"`;
-}
-function refSql(ref) {
-	return `${quoteIdent(ref.table)}.${quoteIdent(ref.column)}`;
-}
-/**
-* The identity expression, aliased as `id`. Composite identities concatenate
-* their parts with `::`; validation guarantees every part is NOT NULL and
-* non-text, which is what makes the concatenation collision-free.
-*/
-function identitySql(projection, basePkColumn) {
-	const refs = identityRefs(projection.identity, basePkColumn);
-	if (projection.identity.kind === "composite") return `CONCAT_WS('::', ${refs.map((ref) => `${refSql(ref)}::text`).join(", ")}) AS ${quoteIdent("id")}`;
-	const [ref] = refs;
-	if (!ref) throw new Error("projection identity resolved to no column");
-	return `${refSql(ref)} AS ${quoteIdent("id")}`;
-}
-function compileProjectionSelect(projection, basePkColumn) {
-	const selectItems = [identitySql(projection, basePkColumn)];
-	const columns = ["id"];
-	for (const [field, binding] of Object.entries(projection.fieldBindings)) {
-		selectItems.push(`${refSql(binding.from)} AS ${quoteIdent(field)}`);
-		columns.push(field);
-	}
-	return {
-		columns,
-		selectItems
-	};
-}
-function compileProjectionJoins(projection) {
-	return projection.joins.map((join) => {
-		const keyword = join.type === "inner" ? "INNER JOIN" : "LEFT JOIN";
-		const on = join.on.map((c) => `${refSql(c.left)} = ${refSql(c.right)}`).join(" AND ");
-		return `${keyword} ${quoteIdent(join.table)} AS ${quoteIdent(join.key)} ON ${on}`;
-	});
-}
-/** `FROM <baseTable> AS "base"` — the alias every ref resolves against. */
-function compileProjectionFrom(projection) {
-	return `FROM ${quoteIdent(projection.baseTable)} AS ${quoteIdent(BASE_REF)}`;
-}
-//#endregion
+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";
 //#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-C6aHjedO.cjs";
+import { o as ClivlySDK } from "./namespace-probe-BoGI18dQ.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-Dj-0Q3Hb.mjs";
+import { o as ClivlySDK } from "./namespace-probe-Cn7voAd0.mjs";
 import { Plugin } from "vite";
 //#region ../sdk/src/vite.d.ts
 interface ClivlyViteOptions {