clivly 0.9.3 → 0.9.4

package/index.cjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 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");
 require("./mapping-score-CaB3F4Uu.cjs");
 const require_internal_entity_heuristics = require("./internal-entity-heuristics.cjs");
-const require_sdk = require("./sdk-COLUHhJq.cjs");
+const require_sdk = require("./sdk-CM1UO-I7.cjs");
 let node_child_process = require("node:child_process");
 let node_fs = require("node:fs");
 let node_module = require("node:module");
@@ -292,10 +292,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;
@@ -1400,15 +1427,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;
@@ -1873,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,
   },
@@ -2986,14 +3027,15 @@ const triggerUrlStage = {
 	needs: [configStage.id],
 	run(ctx) {
 		const url = ctx.sdk?.syncTrigger?.url;
-		if (url) return Promise.resolve({
+		if (url && !require_sdk.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."
 		});
 	}
 };
@@ -3547,8 +3589,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/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;
@@ -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;
@@ -1872,7 +1907,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,
   },
@@ -2985,14 +3026,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."
 		});
 	}
 };
@@ -3546,8 +3588,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.4",
   "private": false,
   "type": "module",
   "description": "Clivly CLI — scaffold a CRM into your app (clivly init).",