clivly 0.9.3 → 0.9.4

package/{projection-D7xmQP4S.mjs → projection-CSGJbZlZ.mjs}

@@ -4220,8 +4220,29 @@ function superRefine(fn, params) {
 */
 /** The reserved ref name for the projection's base table. */
 const BASE_REF = "base";
-/** Entity keys become view names (`crm_src_<entityKey>`), so keep them slugs. */
-const PROJECTION_KEY_PATTERN = /^[a-z][a-z0-9_]*$/;
+/**
+* Entity keys become view names (`crm_src_<entityKey>`), so keep them slugs.
+*
+* Accepts hyphens as well as underscores, matching `OBJECT_TYPE_SLUG_PATTERN`
+* on the server. Those two were widened apart: the server learned hyphens
+* because the SDK's own `slugify` collapses non-alphanumerics to them and
+* `clivly status` reports that form as canonical — but this pattern was missed,
+* so `clivly status` would tell you to key an entity `client-accounts` and then
+* `defineClivlyConfig` would reject the config it had just asked for. Same bug,
+* opposite half of the product.
+*
+* Widening is the safe direction: every key that was valid before still is, so
+* nothing existing is renamed. Safe at all because neither use is ever a bare
+* SQL identifier — the view name is quoted (`view-compiler.ts`, `quoteIdent`),
+* and so is a join's `key` when it is emitted as an alias.
+*/
+const PROJECTION_KEY_PATTERN = /^[a-z][a-z0-9_-]*$/;
+/**
+* Stated in prose because the default for a failed `.regex()` reports only the
+* pattern — the developer is told the config is wrong and handed a regex to
+* decode. Naming the rule is what makes the failure actionable.
+*/
+const PROJECTION_KEY_MESSAGE = "must be lowercase letters, digits, \"-\" or \"_\", starting with a letter";
 const projectionRefSchema = strictObject({
 	table: string().min(1),
 	column: string().min(1)
@@ -4233,7 +4254,7 @@ const projectionJoinConditionSchema = strictObject({
 });
 const projectionJoinSchema = strictObject({
 	/** SQL alias and ref target. Unique within the projection. */
-	key: string().regex(PROJECTION_KEY_PATTERN),
+	key: string().regex(PROJECTION_KEY_PATTERN, { message: `join key ${PROJECTION_KEY_MESSAGE}` }),
 	table: string().min(1),
 	type: _enum(["inner", "left"]),
 	on: array(projectionJoinConditionSchema).min(1)
@@ -4257,7 +4278,7 @@ const projectionIdentitySchema = union([
 const projectionSchema = strictObject({
 	version: literal(1),
 	kind: literal("projection"),
-	entityKey: string().regex(PROJECTION_KEY_PATTERN),
+	entityKey: string().regex(PROJECTION_KEY_PATTERN, { message: `entityKey ${PROJECTION_KEY_MESSAGE}` }),
 	baseTable: string().min(1),
 	joins: array(projectionJoinSchema),
 	fieldBindings: record(string(), projectionFieldBindingSchema).refine((b) => Object.keys(b).length > 0, { message: "at least one field must be bound" }),

package/{projection-C5244vGa.cjs → projection-Dz6_i1-w.cjs}

@@ -4220,8 +4220,29 @@ function superRefine(fn, params) {
 */
 /** The reserved ref name for the projection's base table. */
 const BASE_REF = "base";
-/** Entity keys become view names (`crm_src_<entityKey>`), so keep them slugs. */
-const PROJECTION_KEY_PATTERN = /^[a-z][a-z0-9_]*$/;
+/**
+* Entity keys become view names (`crm_src_<entityKey>`), so keep them slugs.
+*
+* Accepts hyphens as well as underscores, matching `OBJECT_TYPE_SLUG_PATTERN`
+* on the server. Those two were widened apart: the server learned hyphens
+* because the SDK's own `slugify` collapses non-alphanumerics to them and
+* `clivly status` reports that form as canonical — but this pattern was missed,
+* so `clivly status` would tell you to key an entity `client-accounts` and then
+* `defineClivlyConfig` would reject the config it had just asked for. Same bug,
+* opposite half of the product.
+*
+* Widening is the safe direction: every key that was valid before still is, so
+* nothing existing is renamed. Safe at all because neither use is ever a bare
+* SQL identifier — the view name is quoted (`view-compiler.ts`, `quoteIdent`),
+* and so is a join's `key` when it is emitted as an alias.
+*/
+const PROJECTION_KEY_PATTERN = /^[a-z][a-z0-9_-]*$/;
+/**
+* Stated in prose because the default for a failed `.regex()` reports only the
+* pattern — the developer is told the config is wrong and handed a regex to
+* decode. Naming the rule is what makes the failure actionable.
+*/
+const PROJECTION_KEY_MESSAGE = "must be lowercase letters, digits, \"-\" or \"_\", starting with a letter";
 const projectionRefSchema = strictObject({
 	table: string().min(1),
 	column: string().min(1)
@@ -4233,7 +4254,7 @@ const projectionJoinConditionSchema = strictObject({
 });
 const projectionJoinSchema = strictObject({
 	/** SQL alias and ref target. Unique within the projection. */
-	key: string().regex(PROJECTION_KEY_PATTERN),
+	key: string().regex(PROJECTION_KEY_PATTERN, { message: `join key ${PROJECTION_KEY_MESSAGE}` }),
 	table: string().min(1),
 	type: _enum(["inner", "left"]),
 	on: array(projectionJoinConditionSchema).min(1)
@@ -4257,7 +4278,7 @@ const projectionIdentitySchema = union([
 const projectionSchema = strictObject({
 	version: literal(1),
 	kind: literal("projection"),
-	entityKey: string().regex(PROJECTION_KEY_PATTERN),
+	entityKey: string().regex(PROJECTION_KEY_PATTERN, { message: `entityKey ${PROJECTION_KEY_MESSAGE}` }),
 	baseTable: string().min(1),
 	joins: array(projectionJoinSchema),
 	fieldBindings: record(string(), projectionFieldBindingSchema).refine((b) => Object.keys(b).length > 0, { message: "at least one field must be bound" }),

package/projection-sql-BgnfiGqF.mjs

@@ -0,0 +1,65 @@
+import { r as identityRefs, t as BASE_REF } from "./projection-CSGJbZlZ.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. Composite identities concatenate their parts with
+* `::`; validation guarantees every part is NOT NULL and non-text, which is
+* what makes the concatenation collision-free.
+*
+* Exported unaliased because two paths need the same expression under different
+* names: the view compiler aliases it `id`, and the SDK's projection push source
+* also orders and keyset-paginates by it. Sharing one definition is what keeps
+* a pushed row's `id` identical to the one the view would have produced.
+*/
+function compileProjectionIdentity(projection, basePkColumn) {
+	const refs = identityRefs(projection.identity, basePkColumn);
+	if (projection.identity.kind === "composite") return `CONCAT_WS('::', ${refs.map((ref) => `${refSql(ref)}::text`).join(", ")})`;
+	const [ref] = refs;
+	if (!ref) throw new Error("projection identity resolved to no column");
+	return refSql(ref);
+}
+/** The identity expression, aliased as `id`. */
+function identitySql(projection, basePkColumn) {
+	return `${compileProjectionIdentity(projection, basePkColumn)} 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
+export { quoteIdent as a, compileProjectionSelect as i, compileProjectionIdentity as n, compileProjectionJoins as r, compileProjectionFrom as t };

package/projection-sql-Cl1qIn8m.cjs

@@ -0,0 +1,94 @@
+const require_projection = require("./projection-Dz6_i1-w.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. Composite identities concatenate their parts with
+* `::`; validation guarantees every part is NOT NULL and non-text, which is
+* what makes the concatenation collision-free.
+*
+* Exported unaliased because two paths need the same expression under different
+* names: the view compiler aliases it `id`, and the SDK's projection push source
+* also orders and keyset-paginates by it. Sharing one definition is what keeps
+* a pushed row's `id` identical to the one the view would have produced.
+*/
+function compileProjectionIdentity(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(", ")})`;
+	const [ref] = refs;
+	if (!ref) throw new Error("projection identity resolved to no column");
+	return refSql(ref);
+}
+/** The identity expression, aliased as `id`. */
+function identitySql(projection, basePkColumn) {
+	return `${compileProjectionIdentity(projection, basePkColumn)} 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
+Object.defineProperty(exports, "compileProjectionFrom", {
+	enumerable: true,
+	get: function() {
+		return compileProjectionFrom;
+	}
+});
+Object.defineProperty(exports, "compileProjectionIdentity", {
+	enumerable: true,
+	get: function() {
+		return compileProjectionIdentity;
+	}
+});
+Object.defineProperty(exports, "compileProjectionJoins", {
+	enumerable: true,
+	get: function() {
+		return compileProjectionJoins;
+	}
+});
+Object.defineProperty(exports, "compileProjectionSelect", {
+	enumerable: true,
+	get: function() {
+		return compileProjectionSelect;
+	}
+});
+Object.defineProperty(exports, "quoteIdent", {
+	enumerable: true,
+	get: function() {
+		return quoteIdent;
+	}
+});

package/{sdk-COLUHhJq.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;
@@ -1997,3 +2034,9 @@ Object.defineProperty(exports, "createClivlySDK", {
 		return createClivlySDK;
 	}
 });
+Object.defineProperty(exports, "isPlaceholderUrl", {
+	enumerable: true,
+	get: function() {
+		return isPlaceholderUrl;
+	}
+});

package/{sdk-CZNXBsgA.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;
@@ -1961,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-COLUHhJq.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-EYyxWZnf.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-BmdGnYMn.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-CZNXBsgA.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.