clivly 0.9.3 → 0.9.5

package/index.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { t as CANONICAL_FIELDS } from "./entity-config-kUHri9yA.mjs";
+import { t as CANONICAL_FIELDS } from "./entity-config-B74SPOUZ.mjs";
 import "./mapping-score-C68uAqGB.mjs";
 import { matchesConcept, requiredFieldsFor, scoreFieldMap, scoreRelationships, suggestCursorField, toFieldMap } from "./internal-entity-heuristics.mjs";
-import { t as createClivlySDK } from "./sdk-CZNXBsgA.mjs";
+import { s as isPlaceholderUrl, t as createClivlySDK } from "./sdk-DYBDR939.mjs";
 import { createRequire } from "node:module";
 import { spawn } from "node:child_process";
 import { accessSync, constants, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, statSync, watch, writeFileSync } from "node:fs";
@@ -291,10 +291,37 @@ function addCommand(pm, packages) {
 	};
 }
 //#endregion
+//#region src/tick-route.ts
+/**
+* The tick route's public URL path, and the template `clivly login` writes for
+* it.
+*
+* Every framework the CLI scaffolds mounts the tick handler at the same URL —
+* the *files* differ (`app/api/clivly/tick/route.ts`,
+* `src/routes/api/clivly/tick.ts`, `app/routes/api.clivly.tick.ts`, …) but each
+* one resolves to `/api/clivly/tick`. So this is a constant, not a per-framework
+* lookup, and `clivly dev`, the generated config and the `.env` template can all
+* read from one place instead of repeating the string and drifting.
+*/
+const CLIVLY_TICK_PATH = "/api/clivly/tick";
+/**
+* What `clivly login` writes into `.env` for `CLIVLY_SYNC_TRIGGER_URL`.
+*
+* A visible template beats an empty line: the developer sees the shape they
+* eventually need — a public origin plus the tick path — instead of an unhelpful
+* `CLIVLY_SYNC_TRIGGER_URL=` they have to go and look up.
+*
+* It is safe to ship a truthy non-address here only because the SDK refuses to
+* treat a bracketed value as configured (`isPlaceholderUrl` in
+* `@clivly/sdk/trigger-url`). Change the brackets here and that guard stops
+* matching, so the two must stay in step.
+*/
+const TRIGGER_URL_PLACEHOLDER = `https://<yourDomain.com>${CLIVLY_TICK_PATH}`;
+//#endregion
 //#region src/dev-tunnel.ts
 const CLOUDFLARE_QUICK_TUNNEL_REGEX = /https:\/\/[a-z0-9-]+\.trycloudflare\.com/;
 const DEFAULT_PORT = "3000";
-const DEFAULT_ROUTE_PATH = "/api/clivly/tick";
+const DEFAULT_ROUTE_PATH = CLIVLY_TICK_PATH;
 function parseTunnelUrl(chunk) {
 	const match = chunk.match(CLOUDFLARE_QUICK_TUNNEL_REGEX);
 	return match ? match[0] : null;
@@ -946,7 +973,7 @@ function isKeySet(contents, key) {
 function appendEnvKeys(existing, entries) {
 	const missing = entries.filter((e) => !hasKey$1(existing, e.key));
 	if (missing.length === 0) return existing;
-	const block = missing.map((e) => `${e.comment ? `# ${e.comment}\n` : ""}${e.key}=`).join("\n");
+	const block = missing.map((e) => `${e.comment ? `# ${e.comment}\n` : ""}${e.key}=${e.value ?? ""}`).join("\n");
 	return `${existing}${existing.length > 0 && !existing.endsWith("\n") ? "\n" : ""}${existing.length > 0 ? "\n" : ""}# Clivly\n${block}\n`;
 }
 /**
@@ -1399,15 +1426,23 @@ async function confirmWorkspace(deps, credentials) {
 	return await deps.confirm("Write this workspace's credentials to .env? [y/N] ");
 }
 function credentialEntries(credentials) {
-	return [{
-		key: SECRET_KEY_ENV,
-		value: credentials.apiKey,
-		comment: `Org secret key — ${CREDENTIALS_LOCATION}`
-	}, {
-		key: "CLIVLY_SYNC_TRIGGER_SECRET",
-		value: credentials.triggerSecret,
-		comment: `Signing secret — ${SYNC_SECRET_LOCATION}`
-	}];
+	return [
+		{
+			key: SECRET_KEY_ENV,
+			value: credentials.apiKey,
+			comment: `Org secret key — ${CREDENTIALS_LOCATION}`
+		},
+		{
+			key: "CLIVLY_SYNC_TRIGGER_SECRET",
+			value: credentials.triggerSecret,
+			comment: `Signing secret — ${SYNC_SECRET_LOCATION}`
+		},
+		{
+			key: "CLIVLY_SYNC_TRIGGER_URL",
+			value: TRIGGER_URL_PLACEHOLDER,
+			comment: "Public URL of your tick route — replace <yourDomain.com> once deployed. Local dev: run `clivly dev` instead."
+		}
+	];
 }
 function writeCredentials(options, credentials) {
 	const { deps } = options;
@@ -1774,7 +1809,8 @@ const CLIVLY_ENV_KEYS = [
 	},
 	{
 		key: "CLIVLY_SYNC_TRIGGER_URL",
-		comment: "Public URL of your mounted tick route (e.g. https://app.example.com/api/clivly/tick)"
+		value: TRIGGER_URL_PLACEHOLDER,
+		comment: "Public URL of your tick route — replace <yourDomain.com> once deployed. Local dev: run `clivly dev` instead."
 	},
 	{
 		key: "CLIVLY_SYNC_TRIGGER_SECRET",
@@ -1872,7 +1908,13 @@ export default createClivlySDK({
 ${sources.join(",\n")},
   },
   syncTrigger: {
-    // The public URL Clivly Cloud calls to trigger a sync — your mounted tick route.
+    // Where Clivly Cloud calls to start a sync — your mounted tick route.
+    //
+    // \`path\` lets the SDK build its own public URL from the hosting platform's
+    // environment (VERCEL_URL, CF_PAGES_URL, RAILWAY_PUBLIC_DOMAIN,
+    // RENDER_EXTERNAL_URL, FLY_APP_NAME), so on those platforms you never have
+    // to set the URL by hand. \`url\` overrides that when you do.
+    path: "${CLIVLY_TICK_PATH}",
     url: process.env.CLIVLY_SYNC_TRIGGER_URL,
     secret: process.env.CLIVLY_SYNC_TRIGGER_SECRET,
   },
@@ -2699,6 +2741,103 @@ function ladderExitCode(results) {
 	return results.every((result) => result.state !== "fail" && result.state !== "pending") ? 0 : 1;
 }
 //#endregion
+//#region src/boot-hook-check.ts
+const REMIX_ENTRY_CANDIDATES = [
+	"app/entry.server.tsx",
+	"app/entry.server.ts",
+	"app/entry.server.jsx",
+	"app/entry.server.js"
+];
+const NEXT_CONFIG_CANDIDATES = [
+	"next.config.ts",
+	"next.config.mjs",
+	"next.config.js",
+	"next.config.cjs",
+	"next.config.mts"
+];
+const CLIVLY_MENTION = /clivly/i;
+const INSTRUMENTATION_HOOK_ENABLED = /instrumentationHook\s*:\s*true/;
+/**
+* Where this framework's boot hook lives, most likely location first.
+*
+* The file-owning frameworks are asked of `boot-hook.ts` rather than restated,
+* so a path change there cannot leave this check hunting for a file `init` no
+* longer writes. The other two are patched into a file the app already owns.
+*/
+function bootSiteCandidates(framework) {
+	const owned = [bootHookPath(framework, "app"), bootHookPath(framework, "src/app")].filter((path) => path !== null);
+	if (owned.length > 0) return [...new Set(owned)];
+	if (framework === "tanstack-start") return [...VITE_CONFIG_CANDIDATES];
+	if (framework === "remix") return REMIX_ENTRY_CANDIDATES;
+	return [];
+}
+function declaredDeps(readFile) {
+	const raw = readFile("package.json");
+	if (raw === null) return null;
+	try {
+		const pkg = JSON.parse(raw);
+		return {
+			...pkg.dependencies,
+			...pkg.devDependencies
+		};
+	} catch {
+		return null;
+	}
+}
+function findBootSite(readFile, framework) {
+	for (const candidate of bootSiteCandidates(framework)) {
+		const source = readFile(candidate);
+		if (source !== null && CLIVLY_MENTION.test(source)) return candidate;
+	}
+	return null;
+}
+/**
+* On Next.js below 15 the hook file is ignored unless the flag is on, so a
+* present-and-correct instrumentation.ts is not evidence of anything. A missing
+* next.config is the same failure as one without the flag: either way nothing
+* switches the hook on.
+*/
+function nextFlagVerdict(readFile, version, site) {
+	if (!nextNeedsInstrumentationFlag(version)) return null;
+	for (const candidate of NEXT_CONFIG_CANDIDATES) {
+		const source = readFile(candidate);
+		if (source !== null && INSTRUMENTATION_HOOK_ENABLED.test(source)) return null;
+	}
+	return {
+		state: "broken",
+		detail: `${site} exists, but Next.js ${version} ignores it — experimental.instrumentationHook is not enabled in next.config.`,
+		hint: NEXT_INSTRUMENTATION_FLAG_STEP
+	};
+}
+function checkBootHook(readFile) {
+	const deps = declaredDeps(readFile);
+	if (deps === null) return {
+		state: "unknown",
+		detail: "package.json not readable — cannot tell how this app boots."
+	};
+	const framework = detectFramework(deps);
+	if (framework === "unknown") return {
+		state: "unknown",
+		detail: "No supported framework detected, so there is no known place to check."
+	};
+	const label = FRAMEWORK_LABELS[framework];
+	const site = findBootSite(readFile, framework);
+	if (site === null) return {
+		state: "broken",
+		detail: `No Clivly boot hook found in this ${label} app.`,
+		hint: `Nothing starts the SDK, so your app never tells Clivly it is running — the dashboard stays silent with no error anywhere. Run \`clivly init\` to scaffold it, or call \`clivly.start()\` where your server boots (${bootSiteCandidates(framework)[0]}).`
+	};
+	const nextVersion = deps.next;
+	if (framework === "nextjs" && nextVersion) {
+		const broken = nextFlagVerdict(readFile, nextVersion, site);
+		if (broken) return broken;
+	}
+	return {
+		state: "ok",
+		detail: site
+	};
+}
+//#endregion
 //#region src/edge-safety.ts
 const NODE_BUILTINS = /* @__PURE__ */ new Set([
 	"assert",
@@ -2885,7 +3024,7 @@ function pingOnce(ctx) {
 }
 const REASON_HINT = {
 	ok: "",
-	invalid_api_key: "The key was rejected (401). Check CLIVLY_SECRET_KEY (or legacy CLIVLY_API_KEY).",
+	invalid_api_key: "The key was rejected (401). Run `clivly login` to re-pair and rewrite the credentials, and check CLIVLY_SECRET_KEY (or legacy CLIVLY_API_KEY) belongs to the org whose dashboard you are watching.",
 	forbidden: "The key is valid but lacks access to this org (403).",
 	rate_limited: "Rate limited (429). Wait a moment and retry.",
 	server_error: "Clivly returned a server error (5xx). Retry shortly.",
@@ -2985,14 +3124,15 @@ const triggerUrlStage = {
 	needs: [configStage.id],
 	run(ctx) {
 		const url = ctx.sdk?.syncTrigger?.url;
-		if (url) return Promise.resolve({
+		if (url && !isPlaceholderUrl(url)) return Promise.resolve({
 			state: "pass",
 			detail: url
 		});
+		const isPlaceholder = url !== void 0;
 		return Promise.resolve({
 			state: "warn",
-			detail: "Not set — remote sync cannot call back into this app.",
-			hint: "Set CLIVLY_SYNC_TRIGGER_URL once the app is deployed. For local development run `clivly dev` — it opens a tunnel and registers the URL for you. Push-only setups can ignore this."
+			detail: isPlaceholder ? `Still the placeholder (${url}) — remote sync cannot call back into this app.` : "Not set — remote sync cannot call back into this app.",
+			hint: "Replace <yourDomain.com> with your deployed origin, or delete the line — on Vercel, Cloudflare Pages, Railway, Render and Fly the SDK derives the URL from the platform. For local development run `clivly dev`: it opens a tunnel and registers the URL for you, outranking whatever is in .env. Push-only setups can ignore this."
 		});
 	}
 };
@@ -3040,6 +3180,24 @@ const STATUS_STAGES = [
 			});
 		}
 	},
+	{
+		id: "boot-hook",
+		label: "Boot hook wired",
+		run(ctx) {
+			const read = ctx.readConfigSource ?? defaultReadConfigSource;
+			const root = dirname(ctx.configPath);
+			const verdict = checkBootHook((relative) => read(resolve(root, relative)));
+			if (verdict.state === "ok") return Promise.resolve({
+				state: "pass",
+				detail: `starts Clivly from ${verdict.detail}`
+			});
+			return Promise.resolve({
+				state: verdict.state === "unknown" ? "skip" : "fail",
+				detail: verdict.detail,
+				hint: verdict.hint
+			});
+		}
+	},
 	sdkChecksStage,
 	triggerUrlStage
 ];
@@ -3093,6 +3251,7 @@ const ALIAS_STAGE_IDS = {
 	doctor: [
 		"config",
 		"runtime",
+		"boot-hook",
 		"setup-checks"
 	],
 	connect: [
@@ -3546,8 +3705,8 @@ function previewMutations(deps, mutations, options) {
 function printNextSteps(out, authComplete, loginRan, envFile) {
 	out("\nNext steps:\n");
 	out(loginRan ? "  1. Credentials written by `clivly login`\n" : `  1. Add CLIVLY_SECRET_KEY to ${envFile} — create one at\n     ${CREDENTIALS_LOCATION}\n     (the legacy CLIVLY_API_KEY is still accepted)\n`);
-	out("  2. Set CLIVLY_SYNC_TRIGGER_URL to your public tick route\n");
-	out("     Local dev? Run `clivly dev` to open a tunnel, or skip this step until you deploy (remote sync is deploy-only locally).\n");
+	out("  2. Local dev: run `clivly dev` for dashboard-triggered sync\n");
+	out("     It tunnels your app and registers the URL for you — remote sync is\n     deploy-only otherwise, so nothing is broken if you skip it. Once deployed\n     to Vercel/Cloudflare/Railway/Render/Fly the URL is detected automatically;\n     set CLIVLY_SYNC_TRIGGER_URL by hand only for a custom domain.\n");
 	const step = authComplete ? 3 : 4;
 	if (!authComplete) out("  3. Finish resolveUser in the auth/verify route\n");
 	out(`  ${step}. Run \`clivly status\` to see where you are\n`);

package/{internal-Df-PtOH_.mjs → internal-CykXpEGk.mjs}

@@ -1,5 +1,5 @@
-import { n as PROJECTION_KEY_PATTERN, t as BASE_REF } from "./projection-D7xmQP4S.mjs";
-import { h as fanOutJoins, m as validateProjection } from "./entity-config-kUHri9yA.mjs";
+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 {

package/{internal-CwnEG6Wl.cjs → internal-DqduZU3l.cjs}

@@ -1,5 +1,5 @@
-const require_projection = require("./projection-C5244vGa.cjs");
-const require_entity_config = require("./entity-config-DtBsl2MQ.cjs");
+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 {

package/internal-entity-config.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_entity_config = require("./entity-config-DtBsl2MQ.cjs");
+const require_entity_config = require("./entity-config-7sGCk_nw.cjs");
 exports.CANONICAL_FIELDS = require_entity_config.CANONICAL_FIELDS;
 exports.CRM_CONCEPTS = require_entity_config.CRM_CONCEPTS;
 exports.CUSTOM_CONCEPT = require_entity_config.CUSTOM_CONCEPT;

package/internal-entity-config.mjs

@@ -1,2 +1,2 @@
-import { a as MATERIALIZING_CONCEPTS, c as entitiesConfigSchema, d as relationshipSchema, f as relationshipsSchema, i as ClivlyConfigError, l as filterSchema, n as CRM_CONCEPTS, o as customObjectDeclarations, p as validateEntitiesConfig, r as CUSTOM_CONCEPT, s as defineClivlyConfig, t as CANONICAL_FIELDS, u as projectionFields } from "./entity-config-kUHri9yA.mjs";
+import { a as MATERIALIZING_CONCEPTS, c as entitiesConfigSchema, d as relationshipSchema, f as relationshipsSchema, i as ClivlyConfigError, l as filterSchema, n as CRM_CONCEPTS, o as customObjectDeclarations, p as validateEntitiesConfig, r as CUSTOM_CONCEPT, s as defineClivlyConfig, t as CANONICAL_FIELDS, u as projectionFields } from "./entity-config-B74SPOUZ.mjs";
 export { CANONICAL_FIELDS, CRM_CONCEPTS, CUSTOM_CONCEPT, ClivlyConfigError, MATERIALIZING_CONCEPTS, customObjectDeclarations, defineClivlyConfig, entitiesConfigSchema, filterSchema, projectionFields, relationshipSchema, relationshipsSchema, validateEntitiesConfig };

package/internal-entity-heuristics.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_entity_config = require("./entity-config-DtBsl2MQ.cjs");
+const require_entity_config = require("./entity-config-7sGCk_nw.cjs");
 const require_mapping_score = require("./mapping-score-CaB3F4Uu.cjs");
 //#region ../core/src/entity-heuristics.ts
 const TARGET_CONCEPTS = [

package/internal-entity-heuristics.mjs

@@ -1,4 +1,4 @@
-import { a as MATERIALIZING_CONCEPTS } from "./entity-config-kUHri9yA.mjs";
+import { a as MATERIALIZING_CONCEPTS } from "./entity-config-B74SPOUZ.mjs";
 import { a as W, c as isTextLike, i as RELATIONSHIP_TIERS, l as isTimestampLike, n as CONCEPT_TIERS, o as isAmbiguous, r as FIELD_TIERS, s as isNumericLike, u as tierFor } from "./mapping-score-C68uAqGB.mjs";
 //#region ../core/src/entity-heuristics.ts
 const TARGET_CONCEPTS = [

package/internal-mappings-config.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_mappings_config = require("./mappings-config-B0RqFLxu.cjs");
+const require_mappings_config = require("./mappings-config-CLyEg0sf.cjs");
 exports.entitiesToMappings = require_mappings_config.entitiesToMappings;
 exports.mappingsToEntitiesConfig = require_mappings_config.mappingsToEntitiesConfig;

package/internal-mappings-config.mjs

@@ -1,2 +1,2 @@
-import { n as mappingsToEntitiesConfig, t as entitiesToMappings } from "./mappings-config-B1b1HVBg.mjs";
+import { n as mappingsToEntitiesConfig, t as entitiesToMappings } from "./mappings-config-DQS_s4dg.mjs";
 export { entitiesToMappings, mappingsToEntitiesConfig };

package/{internal-CDY8g9Ic.d.mts → internal-o2M7FGlR.d.mts}

@@ -36,6 +36,34 @@ declare function describeCardinality(draft: ProjectionDraft, schema: DiscoveredS
   joinKey: string;
 }>;
 //#endregion
+//#region ../core/src/projection-sql.d.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. */
+declare function quoteIdent(name: string): string;
+/**
+ * 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.
+ */
+declare function compileProjectionIdentity(projection: ProjectionMapping, basePkColumn: string): string;
+declare function compileProjectionJoins(projection: ProjectionMapping): string[];
+/** `FROM <baseTable> AS "base"` — the alias every ref resolves against. */
+declare function compileProjectionFrom(projection: ProjectionMapping): string;
+//#endregion
 //#region ../core/src/projection-validate.d.ts
 /**
  * Validate a projection against the discovered schema. Returns every error
@@ -69,4 +97,4 @@ declare function coversUniqueKey(table: DiscoveredSchemaTable, columns: string[]
 /** Is this table's payload rich enough to validate a projection against? */
 declare function hasRichMeta(table: DiscoveredSchemaTable): boolean;
 //#endregion
-export { validateProjection as a, draftErrors as c, suggestJoinConditions as d, fanOutJoins as f, primaryKeyColumns as i, draftToProjection as l, coversUniqueKey as n, ProjectionDraft as o, joinFansOut as p, hasRichMeta as r, describeCardinality as s, columnMetaFor as t, emptyProjectionDraft as u };
+export { joinFansOut as _, validateProjection as a, compileProjectionJoins as c, describeCardinality as d, draftErrors as f, fanOutJoins as g, suggestJoinConditions as h, primaryKeyColumns as i, quoteIdent as l, emptyProjectionDraft as m, coversUniqueKey as n, compileProjectionFrom as o, draftToProjection as p, hasRichMeta as r, compileProjectionIdentity as s, columnMetaFor as t, ProjectionDraft as u };

package/internal-sync-engine.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sync_engine = require("./sync-engine-abE94g6X.cjs");
+const require_sync_engine = require("./sync-engine-C4A5jgA4.cjs");
 exports.computeSampleWarnings = require_sync_engine.computeSampleWarnings;
 exports.previewSync = require_sync_engine.previewSync;
 exports.reconcile = require_sync_engine.reconcile;

package/internal-sync-engine.mjs

@@ -1,2 +1,2 @@
-import { i as runSync, n as previewSync, r as reconcile, t as computeSampleWarnings } from "./sync-engine-SuxSzbZ4.mjs";
+import { i as runSync, n as previewSync, r as reconcile, t as computeSampleWarnings } from "./sync-engine-Dt5QQSKO.mjs";
 export { computeSampleWarnings, previewSync, reconcile, runSync };

package/internal-view-compiler.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_view_compiler = require("./view-compiler-Blu4OXJ7.cjs");
+const require_view_compiler = require("./view-compiler-B5nDal14.cjs");
 exports.DEFAULT_VIEW_PREFIX = require_view_compiler.DEFAULT_VIEW_PREFIX;
 exports.compileEntityView = require_view_compiler.compileEntityView;
 exports.compileEntityViews = require_view_compiler.compileEntityViews;

package/internal-view-compiler.mjs

@@ -1,2 +1,2 @@
-import { a as explainViewExecutionError, i as explainEntitiesConfig, n as compileEntityView, r as compileEntityViews, t as DEFAULT_VIEW_PREFIX } from "./view-compiler-CQx8TRrW.mjs";
+import { a as explainViewExecutionError, i as explainEntitiesConfig, n as compileEntityView, r as compileEntityViews, t as DEFAULT_VIEW_PREFIX } from "./view-compiler-CSYwEWf5.mjs";
 export { DEFAULT_VIEW_PREFIX, compileEntityView, compileEntityViews, explainEntitiesConfig, explainViewExecutionError };

package/{internal-Da_dlcQ_.d.cts → internal-wCXSELDN.d.cts}

@@ -36,6 +36,34 @@ declare function describeCardinality(draft: ProjectionDraft, schema: DiscoveredS
   joinKey: string;
 }>;
 //#endregion
+//#region ../core/src/projection-sql.d.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. */
+declare function quoteIdent(name: string): string;
+/**
+ * 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.
+ */
+declare function compileProjectionIdentity(projection: ProjectionMapping, basePkColumn: string): string;
+declare function compileProjectionJoins(projection: ProjectionMapping): string[];
+/** `FROM <baseTable> AS "base"` — the alias every ref resolves against. */
+declare function compileProjectionFrom(projection: ProjectionMapping): string;
+//#endregion
 //#region ../core/src/projection-validate.d.ts
 /**
  * Validate a projection against the discovered schema. Returns every error
@@ -69,4 +97,4 @@ declare function coversUniqueKey(table: DiscoveredSchemaTable, columns: string[]
 /** Is this table's payload rich enough to validate a projection against? */
 declare function hasRichMeta(table: DiscoveredSchemaTable): boolean;
 //#endregion
-export { validateProjection as a, draftErrors as c, suggestJoinConditions as d, fanOutJoins as f, primaryKeyColumns as i, draftToProjection as l, coversUniqueKey as n, ProjectionDraft as o, joinFansOut as p, hasRichMeta as r, describeCardinality as s, columnMetaFor as t, emptyProjectionDraft as u };
+export { joinFansOut as _, validateProjection as a, compileProjectionJoins as c, describeCardinality as d, draftErrors as f, fanOutJoins as g, suggestJoinConditions as h, primaryKeyColumns as i, quoteIdent as l, emptyProjectionDraft as m, coversUniqueKey as n, compileProjectionFrom as o, draftToProjection as p, hasRichMeta as r, compileProjectionIdentity as s, columnMetaFor as t, ProjectionDraft as u };

package/internal.cjs

@@ -1,12 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_projection = require("./projection-C5244vGa.cjs");
-const require_entity_config = require("./entity-config-DtBsl2MQ.cjs");
-const require_mappings_config = require("./mappings-config-B0RqFLxu.cjs");
+const require_projection = require("./projection-Dz6_i1-w.cjs");
+const require_entity_config = require("./entity-config-7sGCk_nw.cjs");
+const require_mappings_config = require("./mappings-config-CLyEg0sf.cjs");
 const require_auth_adapter = require("./auth-adapter-CiEXcweZ.cjs");
 const require_mapping_form = require("./mapping-form-BpfON_ME.cjs");
-const require_internal = require("./internal-CwnEG6Wl.cjs");
-const require_view_compiler = require("./view-compiler-Blu4OXJ7.cjs");
-const require_sync_engine = require("./sync-engine-abE94g6X.cjs");
+const require_internal = require("./internal-DqduZU3l.cjs");
+const require_projection_sql = require("./projection-sql-Cl1qIn8m.cjs");
+const require_view_compiler = require("./view-compiler-B5nDal14.cjs");
+const require_sync_engine = require("./sync-engine-C4A5jgA4.cjs");
 exports.BASE_REF = require_projection.BASE_REF;
 exports.CANONICAL_FIELDS = require_entity_config.CANONICAL_FIELDS;
 exports.CRM_CONCEPTS = require_entity_config.CRM_CONCEPTS;
@@ -19,6 +20,9 @@ exports.buildRelationships = require_mapping_form.buildRelationships;
 exports.columnMetaFor = require_entity_config.columnMetaFor;
 exports.compileEntityView = require_view_compiler.compileEntityView;
 exports.compileEntityViews = require_view_compiler.compileEntityViews;
+exports.compileProjectionFrom = require_projection_sql.compileProjectionFrom;
+exports.compileProjectionIdentity = require_projection_sql.compileProjectionIdentity;
+exports.compileProjectionJoins = require_projection_sql.compileProjectionJoins;
 exports.coversUniqueKey = require_entity_config.coversUniqueKey;
 exports.defineClivlyConfig = require_entity_config.defineClivlyConfig;
 exports.describeCardinality = require_internal.describeCardinality;
@@ -35,6 +39,7 @@ exports.joinFansOut = require_entity_config.joinFansOut;
 exports.mappingsToEntitiesConfig = require_mappings_config.mappingsToEntitiesConfig;
 exports.primaryKeyColumns = require_entity_config.primaryKeyColumns;
 exports.projectionSchema = require_projection.projectionSchema;
+exports.quoteIdent = require_projection_sql.quoteIdent;
 exports.reconcile = require_sync_engine.reconcile;
 exports.relationshipSchema = require_entity_config.relationshipSchema;
 exports.relationshipViaSignature = require_mapping_form.relationshipViaSignature;

package/internal.d.cts

@@ -7,5 +7,5 @@ import { i as mappingsToEntitiesConfig, t as EntityMappingRow } from "./mappings
 import { a as compileEntityView, i as ExplainResult, n as CompiledView, o as compileEntityViews, r as DEFAULT_VIEW_PREFIX, s as explainEntitiesConfig, t as CompileOptions } from "./view-compiler-CmEdAMwj.cjs";
 import { c as SyncResult, f as reconcile, l as SyncStore, n as MirrorRecord, o as SourceRow, p as runSync, r as PersistAction, s as SyncAction, t as EntitySyncResult } from "./sync-engine-BG2O1an2.cjs";
 import { a as IntegrationStep, c as StepProblem, i as IntegrationStatus, l as StepState, n as IntegrationFacts, o as NextAction, r as IntegrationState, s as StepId, t as ConnectionLiveness } from "./integration-state-BK-riZnm.cjs";
-import { a as validateProjection, c as draftErrors, d as suggestJoinConditions, f as fanOutJoins, i as primaryKeyColumns, l as draftToProjection, n as coversUniqueKey, o as ProjectionDraft, p as joinFansOut, r as hasRichMeta, s as describeCardinality, t as columnMetaFor, u as emptyProjectionDraft } from "./internal-Da_dlcQ_.cjs";
-export { type Activity, type ActivityType, BASE_REF, CANONICAL_FIELDS, type CRMAdapter, CRM_CONCEPTS, type ClivlyAuthAdapter, ClivlyConfigError, type ClivlyEntitiesConfig, type ClivlyEntityConfig, type ClivlyUser, type Company, type CompileOptions, type CompiledView, type ConfigValidationError, type ConfigValidationResult, type ConnectionLiveness, type Contact, type ContactFilters, type ContactStatus, type CreateActivityInput, type CreateCompanyInput, type CreateContactInput, type CreateDealInput, type CreateTaskInput, type CrmConcept, type CrmMembership, type CrmRole, DEFAULT_VIEW_PREFIX, type Deal, type DealStage, type DiscoveredColumnMeta, type DiscoveredSchemaTable, type EntityMappingRow, type EntitySyncResult, type ExplainResult, type FilterExpr, type FilterValue, type IntegrationFacts, type IntegrationState, type IntegrationStatus, type IntegrationStep, MATERIALIZING_CONCEPTS, type MaterializingConcept, type MembershipResolver, type MirrorRecord, type NextAction, type Note, type PersistAction, type ProjectionDraft, type ProjectionFieldBinding, type ProjectionIdentity, type ProjectionJoin, type ProjectionMapping, type ProjectionRef, type RecordSource, type RelationshipCandidate, type RelationshipSpec, type RelationshipVia, type RelationshipsMap, type SourceRow, type StepId, type StepProblem, type StepState, type SyncAction, type SyncResult, type SyncStore, type Task, type TaskEntityType, type TaskFilters, type TaskPriority, type TaskStatus, type UpdateContactInput, type UpdateDealInput, type UpdateTaskInput, authCustom, buildFilterFromDiscriminator, buildRelationships, columnMetaFor, compileEntityView, compileEntityViews, coversUniqueKey, defineClivlyConfig, describeCardinality, draftErrors, draftToProjection, emptyProjectionDraft, entitiesConfigSchema, explainEntitiesConfig, fanOutJoins, filterSchema, hasRichMeta, identityRefs, joinFansOut, mappingsToEntitiesConfig, primaryKeyColumns, projectionSchema, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, runSync, suggestJoinConditions, validateEntitiesConfig, validateProjection };
+import { _ as joinFansOut, a as validateProjection, c as compileProjectionJoins, d as describeCardinality, f as draftErrors, g as fanOutJoins, h as suggestJoinConditions, i as primaryKeyColumns, l as quoteIdent, m as emptyProjectionDraft, n as coversUniqueKey, o as compileProjectionFrom, p as draftToProjection, r as hasRichMeta, s as compileProjectionIdentity, t as columnMetaFor, u as ProjectionDraft } from "./internal-wCXSELDN.cjs";
+export { type Activity, type ActivityType, BASE_REF, CANONICAL_FIELDS, type CRMAdapter, CRM_CONCEPTS, type ClivlyAuthAdapter, ClivlyConfigError, type ClivlyEntitiesConfig, type ClivlyEntityConfig, type ClivlyUser, type Company, type CompileOptions, type CompiledView, type ConfigValidationError, type ConfigValidationResult, type ConnectionLiveness, type Contact, type ContactFilters, type ContactStatus, type CreateActivityInput, type CreateCompanyInput, type CreateContactInput, type CreateDealInput, type CreateTaskInput, type CrmConcept, type CrmMembership, type CrmRole, DEFAULT_VIEW_PREFIX, type Deal, type DealStage, type DiscoveredColumnMeta, type DiscoveredSchemaTable, type EntityMappingRow, type EntitySyncResult, type ExplainResult, type FilterExpr, type FilterValue, type IntegrationFacts, type IntegrationState, type IntegrationStatus, type IntegrationStep, MATERIALIZING_CONCEPTS, type MaterializingConcept, type MembershipResolver, type MirrorRecord, type NextAction, type Note, type PersistAction, type ProjectionDraft, type ProjectionFieldBinding, type ProjectionIdentity, type ProjectionJoin, type ProjectionMapping, type ProjectionRef, type RecordSource, type RelationshipCandidate, type RelationshipSpec, type RelationshipVia, type RelationshipsMap, type SourceRow, type StepId, type StepProblem, type StepState, type SyncAction, type SyncResult, type SyncStore, type Task, type TaskEntityType, type TaskFilters, type TaskPriority, type TaskStatus, type UpdateContactInput, type UpdateDealInput, type UpdateTaskInput, authCustom, buildFilterFromDiscriminator, buildRelationships, columnMetaFor, compileEntityView, compileEntityViews, compileProjectionFrom, compileProjectionIdentity, compileProjectionJoins, coversUniqueKey, defineClivlyConfig, describeCardinality, draftErrors, draftToProjection, emptyProjectionDraft, entitiesConfigSchema, explainEntitiesConfig, fanOutJoins, filterSchema, hasRichMeta, identityRefs, joinFansOut, mappingsToEntitiesConfig, primaryKeyColumns, projectionSchema, quoteIdent, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, runSync, suggestJoinConditions, validateEntitiesConfig, validateProjection };

package/internal.d.mts

@@ -7,5 +7,5 @@ import { i as mappingsToEntitiesConfig, t as EntityMappingRow } from "./mappings
 import { a as compileEntityView, i as ExplainResult, n as CompiledView, o as compileEntityViews, r as DEFAULT_VIEW_PREFIX, s as explainEntitiesConfig, t as CompileOptions } from "./view-compiler-Bo7pqXW3.mjs";
 import { c as SyncResult, f as reconcile, l as SyncStore, n as MirrorRecord, o as SourceRow, p as runSync, r as PersistAction, s as SyncAction, t as EntitySyncResult } from "./sync-engine-DgQbrJON.mjs";
 import { a as IntegrationStep, c as StepProblem, i as IntegrationStatus, l as StepState, n as IntegrationFacts, o as NextAction, r as IntegrationState, s as StepId, t as ConnectionLiveness } from "./integration-state-BK-riZnm.mjs";
-import { a as validateProjection, c as draftErrors, d as suggestJoinConditions, f as fanOutJoins, i as primaryKeyColumns, l as draftToProjection, n as coversUniqueKey, o as ProjectionDraft, p as joinFansOut, r as hasRichMeta, s as describeCardinality, t as columnMetaFor, u as emptyProjectionDraft } from "./internal-CDY8g9Ic.mjs";
-export { type Activity, type ActivityType, BASE_REF, CANONICAL_FIELDS, type CRMAdapter, CRM_CONCEPTS, type ClivlyAuthAdapter, ClivlyConfigError, type ClivlyEntitiesConfig, type ClivlyEntityConfig, type ClivlyUser, type Company, type CompileOptions, type CompiledView, type ConfigValidationError, type ConfigValidationResult, type ConnectionLiveness, type Contact, type ContactFilters, type ContactStatus, type CreateActivityInput, type CreateCompanyInput, type CreateContactInput, type CreateDealInput, type CreateTaskInput, type CrmConcept, type CrmMembership, type CrmRole, DEFAULT_VIEW_PREFIX, type Deal, type DealStage, type DiscoveredColumnMeta, type DiscoveredSchemaTable, type EntityMappingRow, type EntitySyncResult, type ExplainResult, type FilterExpr, type FilterValue, type IntegrationFacts, type IntegrationState, type IntegrationStatus, type IntegrationStep, MATERIALIZING_CONCEPTS, type MaterializingConcept, type MembershipResolver, type MirrorRecord, type NextAction, type Note, type PersistAction, type ProjectionDraft, type ProjectionFieldBinding, type ProjectionIdentity, type ProjectionJoin, type ProjectionMapping, type ProjectionRef, type RecordSource, type RelationshipCandidate, type RelationshipSpec, type RelationshipVia, type RelationshipsMap, type SourceRow, type StepId, type StepProblem, type StepState, type SyncAction, type SyncResult, type SyncStore, type Task, type TaskEntityType, type TaskFilters, type TaskPriority, type TaskStatus, type UpdateContactInput, type UpdateDealInput, type UpdateTaskInput, authCustom, buildFilterFromDiscriminator, buildRelationships, columnMetaFor, compileEntityView, compileEntityViews, coversUniqueKey, defineClivlyConfig, describeCardinality, draftErrors, draftToProjection, emptyProjectionDraft, entitiesConfigSchema, explainEntitiesConfig, fanOutJoins, filterSchema, hasRichMeta, identityRefs, joinFansOut, mappingsToEntitiesConfig, primaryKeyColumns, projectionSchema, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, runSync, suggestJoinConditions, validateEntitiesConfig, validateProjection };
+import { _ as joinFansOut, a as validateProjection, c as compileProjectionJoins, d as describeCardinality, f as draftErrors, g as fanOutJoins, h as suggestJoinConditions, i as primaryKeyColumns, l as quoteIdent, m as emptyProjectionDraft, n as coversUniqueKey, o as compileProjectionFrom, p as draftToProjection, r as hasRichMeta, s as compileProjectionIdentity, t as columnMetaFor, u as ProjectionDraft } from "./internal-o2M7FGlR.mjs";
+export { type Activity, type ActivityType, BASE_REF, CANONICAL_FIELDS, type CRMAdapter, CRM_CONCEPTS, type ClivlyAuthAdapter, ClivlyConfigError, type ClivlyEntitiesConfig, type ClivlyEntityConfig, type ClivlyUser, type Company, type CompileOptions, type CompiledView, type ConfigValidationError, type ConfigValidationResult, type ConnectionLiveness, type Contact, type ContactFilters, type ContactStatus, type CreateActivityInput, type CreateCompanyInput, type CreateContactInput, type CreateDealInput, type CreateTaskInput, type CrmConcept, type CrmMembership, type CrmRole, DEFAULT_VIEW_PREFIX, type Deal, type DealStage, type DiscoveredColumnMeta, type DiscoveredSchemaTable, type EntityMappingRow, type EntitySyncResult, type ExplainResult, type FilterExpr, type FilterValue, type IntegrationFacts, type IntegrationState, type IntegrationStatus, type IntegrationStep, MATERIALIZING_CONCEPTS, type MaterializingConcept, type MembershipResolver, type MirrorRecord, type NextAction, type Note, type PersistAction, type ProjectionDraft, type ProjectionFieldBinding, type ProjectionIdentity, type ProjectionJoin, type ProjectionMapping, type ProjectionRef, type RecordSource, type RelationshipCandidate, type RelationshipSpec, type RelationshipVia, type RelationshipsMap, type SourceRow, type StepId, type StepProblem, type StepState, type SyncAction, type SyncResult, type SyncStore, type Task, type TaskEntityType, type TaskFilters, type TaskPriority, type TaskStatus, type UpdateContactInput, type UpdateDealInput, type UpdateTaskInput, authCustom, buildFilterFromDiscriminator, buildRelationships, columnMetaFor, compileEntityView, compileEntityViews, compileProjectionFrom, compileProjectionIdentity, compileProjectionJoins, coversUniqueKey, defineClivlyConfig, describeCardinality, draftErrors, draftToProjection, emptyProjectionDraft, entitiesConfigSchema, explainEntitiesConfig, fanOutJoins, filterSchema, hasRichMeta, identityRefs, joinFansOut, mappingsToEntitiesConfig, primaryKeyColumns, projectionSchema, quoteIdent, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, runSync, suggestJoinConditions, validateEntitiesConfig, validateProjection };

package/internal.mjs

@@ -1,9 +1,10 @@
-import { i as projectionSchema, r as identityRefs, t as BASE_REF } from "./projection-D7xmQP4S.mjs";
-import { _ as columnMetaFor, a as MATERIALIZING_CONCEPTS, b as primaryKeyColumns, c as entitiesConfigSchema, d as relationshipSchema, f as relationshipsSchema, g as joinFansOut, h as fanOutJoins, i as ClivlyConfigError, l as filterSchema, m as validateProjection, n as CRM_CONCEPTS, p as validateEntitiesConfig, s as defineClivlyConfig, t as CANONICAL_FIELDS, v as coversUniqueKey, y as hasRichMeta } from "./entity-config-kUHri9yA.mjs";
-import { n as mappingsToEntitiesConfig } from "./mappings-config-B1b1HVBg.mjs";
+import { i as projectionSchema, r as identityRefs, t as BASE_REF } from "./projection-CSGJbZlZ.mjs";
+import { _ as columnMetaFor, a as MATERIALIZING_CONCEPTS, b as primaryKeyColumns, c as entitiesConfigSchema, d as relationshipSchema, f as relationshipsSchema, g as joinFansOut, h as fanOutJoins, i as ClivlyConfigError, l as filterSchema, m as validateProjection, n as CRM_CONCEPTS, p as validateEntitiesConfig, s as defineClivlyConfig, t as CANONICAL_FIELDS, v as coversUniqueKey, y as hasRichMeta } from "./entity-config-B74SPOUZ.mjs";
+import { n as mappingsToEntitiesConfig } from "./mappings-config-DQS_s4dg.mjs";
 import { t as authCustom } from "./auth-adapter-gfVDxf3d.mjs";
 import { n as buildRelationships, r as relationshipViaSignature, t as buildFilterFromDiscriminator } from "./mapping-form-DigkuvFc.mjs";
-import { a as suggestJoinConditions, i as emptyProjectionDraft, n as draftErrors, r as draftToProjection, t as describeCardinality } from "./internal-Df-PtOH_.mjs";
-import { i as explainEntitiesConfig, n as compileEntityView, r as compileEntityViews, t as DEFAULT_VIEW_PREFIX } from "./view-compiler-CQx8TRrW.mjs";
-import { i as runSync, r as reconcile } from "./sync-engine-SuxSzbZ4.mjs";
-export { BASE_REF, CANONICAL_FIELDS, CRM_CONCEPTS, ClivlyConfigError, DEFAULT_VIEW_PREFIX, MATERIALIZING_CONCEPTS, authCustom, buildFilterFromDiscriminator, buildRelationships, columnMetaFor, compileEntityView, compileEntityViews, coversUniqueKey, defineClivlyConfig, describeCardinality, draftErrors, draftToProjection, emptyProjectionDraft, entitiesConfigSchema, explainEntitiesConfig, fanOutJoins, filterSchema, hasRichMeta, identityRefs, joinFansOut, mappingsToEntitiesConfig, primaryKeyColumns, projectionSchema, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, runSync, suggestJoinConditions, validateEntitiesConfig, validateProjection };
+import { a as suggestJoinConditions, i as emptyProjectionDraft, n as draftErrors, r as draftToProjection, t as describeCardinality } from "./internal-CykXpEGk.mjs";
+import { a as quoteIdent, n as compileProjectionIdentity, r as compileProjectionJoins, t as compileProjectionFrom } from "./projection-sql-BgnfiGqF.mjs";
+import { i as explainEntitiesConfig, n as compileEntityView, r as compileEntityViews, t as DEFAULT_VIEW_PREFIX } from "./view-compiler-CSYwEWf5.mjs";
+import { i as runSync, r as reconcile } from "./sync-engine-Dt5QQSKO.mjs";
+export { BASE_REF, CANONICAL_FIELDS, CRM_CONCEPTS, ClivlyConfigError, DEFAULT_VIEW_PREFIX, MATERIALIZING_CONCEPTS, authCustom, buildFilterFromDiscriminator, buildRelationships, columnMetaFor, compileEntityView, compileEntityViews, compileProjectionFrom, compileProjectionIdentity, compileProjectionJoins, coversUniqueKey, defineClivlyConfig, describeCardinality, draftErrors, draftToProjection, emptyProjectionDraft, entitiesConfigSchema, explainEntitiesConfig, fanOutJoins, filterSchema, hasRichMeta, identityRefs, joinFansOut, mappingsToEntitiesConfig, primaryKeyColumns, projectionSchema, quoteIdent, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, runSync, suggestJoinConditions, validateEntitiesConfig, validateProjection };

package/{mappings-config-B0RqFLxu.cjs → mappings-config-CLyEg0sf.cjs}

@@ -1,4 +1,4 @@
-const require_entity_config = require("./entity-config-DtBsl2MQ.cjs");
+const require_entity_config = require("./entity-config-7sGCk_nw.cjs");
 //#region ../core/src/mappings-config.ts
 const RESERVED_FIELD = "id";
 /**

package/{mappings-config-B1b1HVBg.mjs → mappings-config-DQS_s4dg.mjs}

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

package/{namespace-probe-EYyxWZnf.d.cts → namespace-probe-BoGI18dQ.d.cts}

@@ -324,6 +324,14 @@ interface SyncSource {
   }): Promise<Record<string, unknown>[]>;
   /** Stable, unique tie-breaker column for keyset paging. Defaults to "id". */
   idField?: string;
+  /**
+   * Custom-object slug this source mirrors into. Only meaningful for entries in
+   * `source.custom`, whose element type narrows it to required — declared here
+   * because the sync and readiness paths read `source.objectType` off a plain
+   * `SyncSource`, so leaving it off left the property required by one type,
+   * absent from another, and read by the runtime.
+   */
+  objectType?: string;
   /** Set by `fromDrizzle`; lets `doctor` introspect the backing table. */
   [DRIZZLE_META]?: DrizzleSourceMeta;
 }

package/{namespace-probe-BmdGnYMn.d.mts → namespace-probe-Cn7voAd0.d.mts}

@@ -324,6 +324,14 @@ interface SyncSource {
   }): Promise<Record<string, unknown>[]>;
   /** Stable, unique tie-breaker column for keyset paging. Defaults to "id". */
   idField?: string;
+  /**
+   * Custom-object slug this source mirrors into. Only meaningful for entries in
+   * `source.custom`, whose element type narrows it to required — declared here
+   * because the sync and readiness paths read `source.objectType` off a plain
+   * `SyncSource`, so leaving it off left the property required by one type,
+   * absent from another, and read by the runtime.
+   */
+  objectType?: string;
   /** Set by `fromDrizzle`; lets `doctor` introspect the backing table. */
   [DRIZZLE_META]?: DrizzleSourceMeta;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clivly",
-  "version": "0.9.3",
+  "version": "0.9.5",
   "private": false,
   "type": "module",
   "description": "Clivly CLI — scaffold a CRM into your app (clivly init).",