clivly 0.10.7 → 0.10.8

package/drizzle.cjs

@@ -60,6 +60,7 @@ function fromDrizzleProjection(db, projection, opts) {
 	const head = [`select ${selectItems.join(", ")}`, fromClause].join(" ");
 	return {
 		entity: opts.entity,
+		pushSource: projection.baseTable,
 		cursorField: cursorToken,
 		idField: "id",
 		...opts.objectType === void 0 ? {} : { objectType: opts.objectType },
@@ -89,6 +90,7 @@ function fromDrizzleProjectionByIdentity(client, projection, identityExpr, fromC
 	const head = [`select ${selectItems.join(", ")}`, fromClause].join(" ");
 	return {
 		entity: opts.entity,
+		pushSource: projection.baseTable,
 		cursorField: "id",
 		idField: "id",
 		...opts.objectType === void 0 ? {} : { objectType: opts.objectType },

package/drizzle.d.cts

@@ -1,6 +1,6 @@
 import { R as ProjectionMapping, z as ProjectionRef } from "./entity-config-w8oMBWf8.cjs";
 import { n as buildUniqueConstraints, r as discoverFromDrizzle } from "./drizzle-SD8WCvYj.cjs";
-import { t as NamespaceIntrospector, v as SyncSource } from "./namespace-probe-lj_0bJrc.cjs";
+import { t as NamespaceIntrospector, v as SyncSource } from "./namespace-probe-C3xMOqWE.cjs";
 import { Table } from "drizzle-orm";
 //#region ../sdk/src/drizzle-projection.d.ts
 /**

package/drizzle.d.mts

@@ -1,6 +1,6 @@
 import { R as ProjectionMapping, z as ProjectionRef } from "./entity-config-w8oMBWf8.mjs";
 import { n as buildUniqueConstraints, r as discoverFromDrizzle } from "./drizzle-axugRJ0u.mjs";
-import { t as NamespaceIntrospector, v as SyncSource } from "./namespace-probe-ouHKZas2.mjs";
+import { t as NamespaceIntrospector, v as SyncSource } from "./namespace-probe-BmxtnOfc.mjs";
 import { Table } from "drizzle-orm";
 //#region ../sdk/src/drizzle-projection.d.ts
 /**

package/drizzle.mjs

@@ -59,6 +59,7 @@ function fromDrizzleProjection(db, projection, opts) {
 	const head = [`select ${selectItems.join(", ")}`, fromClause].join(" ");
 	return {
 		entity: opts.entity,
+		pushSource: projection.baseTable,
 		cursorField: cursorToken,
 		idField: "id",
 		...opts.objectType === void 0 ? {} : { objectType: opts.objectType },
@@ -88,6 +89,7 @@ function fromDrizzleProjectionByIdentity(client, projection, identityExpr, fromC
 	const head = [`select ${selectItems.join(", ")}`, fromClause].join(" ");
 	return {
 		entity: opts.entity,
+		pushSource: projection.baseTable,
 		cursorField: "id",
 		idField: "id",
 		...opts.objectType === void 0 ? {} : { objectType: opts.objectType },

package/index.cjs

@@ -3,7 +3,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_entity_config = require("./entity-config-C2MfIDL2.cjs");
 require("./mapping-score-CaB3F4Uu.cjs");
 const require_internal_entity_heuristics = require("./internal-entity-heuristics.cjs");
-const require_sdk = require("./sdk-DbvqXNSh.cjs");
+const require_sdk = require("./sdk-BAHcnhm7.cjs");
 let node_child_process = require("node:child_process");
 let node_fs = require("node:fs");
 let node_module = require("node:module");
@@ -1953,14 +1953,19 @@ export async function register() {
 		return;
 	}
 	try {
-		// Built at runtime so the bundler cannot statically trace it. Next
-		// compiles this file for BOTH runtimes, and the guard above only runs on
-		// the edge — it does not stop the edge BUILD from following a literal
-		// import into your config, and from there into your database driver. A
-		// node-postgres app fails that pass on \`require('path')\` and every route
-		// 500s before Clivly is ever reached.
-		const specifier = "${importPath}";
-		const { default: clivly } = await import(/* webpackIgnore: true */ specifier);
+		// A plain import, deliberately. Next compiles this file for BOTH runtimes
+		// and follows this into your config and on into your database driver, so a
+		// Node-only driver breaks the EDGE build — the guard above is a runtime
+		// check and cannot prevent that. The fix belongs in next.config, where
+		// \`clivly init\` writes an edge-only \`config.externals\` entry; nothing here
+		// ever executes on the edge, so the driver only has to resolve.
+		//
+		// Do NOT make this untraceable (a variable specifier, webpackIgnore).
+		// That silences the build error and breaks the app in a worse way:
+		// clivly.config is TypeScript, so an unbundled import cannot load it, and
+		// the catch below turns that into a warning — the app boots, serves
+		// traffic, and never checks in.
+		const { default: clivly } = await import("${importPath}");
 		await clivly.start();
 	} catch (error) {
 		console.warn("[clivly] could not check in:", error);
@@ -2013,6 +2018,46 @@ function nextNeedsInstrumentationFlag(versionRange) {
 }
 const NEXT_INSTRUMENTATION_FLAG_STEP = `Your Next.js version reads instrumentation.ts only when it is switched on. Add this to next.config, or Clivly will never be told your app started:
       experimental: { instrumentationHook: true }`;
+const NODE_ONLY_DRIVERS = /* @__PURE__ */ new Set([
+	"pg",
+	"mysql",
+	"mysql2",
+	"better-sqlite3",
+	"sqlite3",
+	"tedious",
+	"oracledb",
+	"ioredis"
+]);
+/**
+* The Node-only database drivers a config's dependency list contains.
+*
+* Next compiles instrumentation.ts for the edge runtime whether or not the app
+* uses it, and follows the boot hook's config import into the driver. `pg`
+* pulls in `pgpass` → `split2` → `stream`, none of which resolve there, so the
+* build fails and every route 500s — before any Clivly code runs.
+*
+* `serverExternalPackages` does NOT fix this. It applies to the Node server
+* bundle only; the edge pass ignores it entirely, which is why adding package
+* after package to it never terminates. An edge-only `config.externals` is what
+* works, and it is safe precisely because nothing in that bundle ever executes
+* — the boot hook returns early unless NEXT_RUNTIME is "nodejs".
+*/
+function nodeOnlyDrivers(dependencies) {
+	if (!dependencies) return [];
+	return Object.keys(dependencies).filter((name) => NODE_ONLY_DRIVERS.has(name)).sort();
+}
+/** The next.config step an app needs when its config reaches a Node driver. */
+function nextEdgeExternalsStep(drivers) {
+	const list = drivers.map((d) => `"${d}"`).join(", ");
+	return `Your database driver (${drivers.join(", ")}) cannot be bundled for Next's edge runtime, which compiles instrumentation.ts whether or not you use it. Without this, every route fails to build. Add to next.config:
+      webpack: (config, { nextRuntime }) => {
+        if (nextRuntime === "edge") {
+          config.externals = [...(config.externals ?? []), ${list}];
+        }
+        return config;
+      }
+    Nothing runs on the edge — the boot hook exits early there — so the driver only has to resolve.`;
+}
 const REMIX_BOOT_STEP = `Start Clivly when your app boots. Add this near the top of app/entry.server.tsx:
       import clivly from "./clivly.config";
       clivly.start().catch((error) => console.warn("[clivly] could not check in:", error));`;
@@ -2563,21 +2608,32 @@ function planEnv(args) {
 		action: envAction(addedKeys.length, existing.length)
 	};
 }
-function declaredNextVersion(args) {
+function hostManifest(args) {
 	const raw = args.readFile((0, node_path.join)(args.cwd, "package.json"));
-	if (!raw) return;
-	let pkg = {};
+	if (!raw) return {};
 	try {
-		pkg = JSON.parse(raw);
+		return JSON.parse(raw);
 	} catch {
-		pkg = {};
+		return {};
 	}
+}
+function declaredNextVersion(args) {
+	const pkg = hostManifest(args);
 	return pkg.dependencies?.next ?? pkg.devDependencies?.next;
 }
+function declaredDependencies(args) {
+	return hostManifest(args).dependencies;
+}
+/** The edge-externals step, or null when no Node-only driver is declared. */
+function edgeExternalsStepFor(dependencies) {
+	const drivers = nodeOnlyDrivers(dependencies);
+	return drivers.length > 0 ? nextEdgeExternalsStep(drivers) : null;
+}
 function planBootPatch(args) {
 	if (bootHookPath(args.framework, args.layout) !== null) return {
 		file: null,
-		manual: args.framework === "nextjs" && nextNeedsInstrumentationFlag(declaredNextVersion(args)) ? NEXT_INSTRUMENTATION_FLAG_STEP : null
+		manual: args.framework === "nextjs" && nextNeedsInstrumentationFlag(declaredNextVersion(args)) ? NEXT_INSTRUMENTATION_FLAG_STEP : null,
+		extra: args.framework === "nextjs" ? edgeExternalsStepFor(declaredDependencies(args)) : null
 	};
 	if (args.framework === "remix") return {
 		file: null,
@@ -2623,7 +2679,7 @@ function planMutations(args) {
 	return {
 		files,
 		env: planEnv(args),
-		manualSteps: boot.manual ? [boot.manual] : []
+		manualSteps: [boot.manual, boot.extra ?? null].filter((step) => step !== null)
 	};
 }
 function planWidgetMutations(args) {
@@ -4030,6 +4086,10 @@ function previewMutations(deps, mutations, options) {
 		out(`  ${mutations.env.action.padEnd(9)} .env\n`);
 		for (const key of mutations.env.addedKeys) out(`              + ${key}=\n`);
 	}
+	if (mutations.manualSteps.length > 0) {
+		out("\nYou will also need to:\n");
+		for (const step of mutations.manualSteps) out(`\n  ! ${step}\n`);
+	}
 	out(options.diff ? "\nRe-run without --diff to apply; --force to overwrite the files marked conflict.\n" : "\nRe-run without --dry-run to apply.\n");
 }
 function printNextSteps(out, authComplete, loginRan, envFile, needsViteDotenv = false) {

package/index.mjs

@@ -2,7 +2,7 @@
 import { t as CANONICAL_FIELDS } from "./entity-config-bC3DX9f1.mjs";
 import "./mapping-score-C68uAqGB.mjs";
 import { hasDefiningColumn, isFrameworkTable, matchesConcept, requiredFieldsFor, scoreFieldMap, scoreRelationships, suggestCursorField, toFieldMap } from "./internal-entity-heuristics.mjs";
-import { s as isPlaceholderUrl, t as createClivlySDK } from "./sdk-BTzaM8bF.mjs";
+import { s as isPlaceholderUrl, t as createClivlySDK } from "./sdk-C0DU5KDS.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";
@@ -1952,14 +1952,19 @@ export async function register() {
 		return;
 	}
 	try {
-		// Built at runtime so the bundler cannot statically trace it. Next
-		// compiles this file for BOTH runtimes, and the guard above only runs on
-		// the edge — it does not stop the edge BUILD from following a literal
-		// import into your config, and from there into your database driver. A
-		// node-postgres app fails that pass on \`require('path')\` and every route
-		// 500s before Clivly is ever reached.
-		const specifier = "${importPath}";
-		const { default: clivly } = await import(/* webpackIgnore: true */ specifier);
+		// A plain import, deliberately. Next compiles this file for BOTH runtimes
+		// and follows this into your config and on into your database driver, so a
+		// Node-only driver breaks the EDGE build — the guard above is a runtime
+		// check and cannot prevent that. The fix belongs in next.config, where
+		// \`clivly init\` writes an edge-only \`config.externals\` entry; nothing here
+		// ever executes on the edge, so the driver only has to resolve.
+		//
+		// Do NOT make this untraceable (a variable specifier, webpackIgnore).
+		// That silences the build error and breaks the app in a worse way:
+		// clivly.config is TypeScript, so an unbundled import cannot load it, and
+		// the catch below turns that into a warning — the app boots, serves
+		// traffic, and never checks in.
+		const { default: clivly } = await import("${importPath}");
 		await clivly.start();
 	} catch (error) {
 		console.warn("[clivly] could not check in:", error);
@@ -2012,6 +2017,46 @@ function nextNeedsInstrumentationFlag(versionRange) {
 }
 const NEXT_INSTRUMENTATION_FLAG_STEP = `Your Next.js version reads instrumentation.ts only when it is switched on. Add this to next.config, or Clivly will never be told your app started:
       experimental: { instrumentationHook: true }`;
+const NODE_ONLY_DRIVERS = /* @__PURE__ */ new Set([
+	"pg",
+	"mysql",
+	"mysql2",
+	"better-sqlite3",
+	"sqlite3",
+	"tedious",
+	"oracledb",
+	"ioredis"
+]);
+/**
+* The Node-only database drivers a config's dependency list contains.
+*
+* Next compiles instrumentation.ts for the edge runtime whether or not the app
+* uses it, and follows the boot hook's config import into the driver. `pg`
+* pulls in `pgpass` → `split2` → `stream`, none of which resolve there, so the
+* build fails and every route 500s — before any Clivly code runs.
+*
+* `serverExternalPackages` does NOT fix this. It applies to the Node server
+* bundle only; the edge pass ignores it entirely, which is why adding package
+* after package to it never terminates. An edge-only `config.externals` is what
+* works, and it is safe precisely because nothing in that bundle ever executes
+* — the boot hook returns early unless NEXT_RUNTIME is "nodejs".
+*/
+function nodeOnlyDrivers(dependencies) {
+	if (!dependencies) return [];
+	return Object.keys(dependencies).filter((name) => NODE_ONLY_DRIVERS.has(name)).sort();
+}
+/** The next.config step an app needs when its config reaches a Node driver. */
+function nextEdgeExternalsStep(drivers) {
+	const list = drivers.map((d) => `"${d}"`).join(", ");
+	return `Your database driver (${drivers.join(", ")}) cannot be bundled for Next's edge runtime, which compiles instrumentation.ts whether or not you use it. Without this, every route fails to build. Add to next.config:
+      webpack: (config, { nextRuntime }) => {
+        if (nextRuntime === "edge") {
+          config.externals = [...(config.externals ?? []), ${list}];
+        }
+        return config;
+      }
+    Nothing runs on the edge — the boot hook exits early there — so the driver only has to resolve.`;
+}
 const REMIX_BOOT_STEP = `Start Clivly when your app boots. Add this near the top of app/entry.server.tsx:
       import clivly from "./clivly.config";
       clivly.start().catch((error) => console.warn("[clivly] could not check in:", error));`;
@@ -2562,21 +2607,32 @@ function planEnv(args) {
 		action: envAction(addedKeys.length, existing.length)
 	};
 }
-function declaredNextVersion(args) {
+function hostManifest(args) {
 	const raw = args.readFile(join(args.cwd, "package.json"));
-	if (!raw) return;
-	let pkg = {};
+	if (!raw) return {};
 	try {
-		pkg = JSON.parse(raw);
+		return JSON.parse(raw);
 	} catch {
-		pkg = {};
+		return {};
 	}
+}
+function declaredNextVersion(args) {
+	const pkg = hostManifest(args);
 	return pkg.dependencies?.next ?? pkg.devDependencies?.next;
 }
+function declaredDependencies(args) {
+	return hostManifest(args).dependencies;
+}
+/** The edge-externals step, or null when no Node-only driver is declared. */
+function edgeExternalsStepFor(dependencies) {
+	const drivers = nodeOnlyDrivers(dependencies);
+	return drivers.length > 0 ? nextEdgeExternalsStep(drivers) : null;
+}
 function planBootPatch(args) {
 	if (bootHookPath(args.framework, args.layout) !== null) return {
 		file: null,
-		manual: args.framework === "nextjs" && nextNeedsInstrumentationFlag(declaredNextVersion(args)) ? NEXT_INSTRUMENTATION_FLAG_STEP : null
+		manual: args.framework === "nextjs" && nextNeedsInstrumentationFlag(declaredNextVersion(args)) ? NEXT_INSTRUMENTATION_FLAG_STEP : null,
+		extra: args.framework === "nextjs" ? edgeExternalsStepFor(declaredDependencies(args)) : null
 	};
 	if (args.framework === "remix") return {
 		file: null,
@@ -2622,7 +2678,7 @@ function planMutations(args) {
 	return {
 		files,
 		env: planEnv(args),
-		manualSteps: boot.manual ? [boot.manual] : []
+		manualSteps: [boot.manual, boot.extra ?? null].filter((step) => step !== null)
 	};
 }
 function planWidgetMutations(args) {
@@ -4029,6 +4085,10 @@ function previewMutations(deps, mutations, options) {
 		out(`  ${mutations.env.action.padEnd(9)} .env\n`);
 		for (const key of mutations.env.addedKeys) out(`              + ${key}=\n`);
 	}
+	if (mutations.manualSteps.length > 0) {
+		out("\nYou will also need to:\n");
+		for (const step of mutations.manualSteps) out(`\n  ! ${step}\n`);
+	}
 	out(options.diff ? "\nRe-run without --diff to apply; --force to overwrite the files marked conflict.\n" : "\nRe-run without --dry-run to apply.\n");
 }
 function printNextSteps(out, authComplete, loginRan, envFile, needsViteDotenv = false) {

package/{namespace-probe-ouHKZas2.d.mts → namespace-probe-BmxtnOfc.d.mts}

@@ -332,6 +332,22 @@ interface SyncSource {
    * absent from another, and read by the runtime.
    */
   objectType?: string;
+  /**
+   * The `source` label a push carries, when it differs from `entity`.
+   *
+   * Only a projection sets this, and only because a projection entity has no
+   * choice but to carry two names: its entity key doubles as the custom-object
+   * slug and must be kebab-case, while `projection.entityKey` is validated by
+   * `/^[a-z][a-z0-9_]*$/` and rejects hyphens. The server resolves that by
+   * storing the mapping's `sourceTable` as `projection.baseTable` — so a push
+   * labelled with the entity key matched no mapping and every row was dropped,
+   * while `push-schema` reported the mapping created and exited 0.
+   *
+   * Deliberately NOT folded into `entity`: that value is also the cursor-store
+   * key, so redefining it would silently reset the sync cursor of every
+   * existing projection and re-push its whole history.
+   */
+  pushSource?: string;
   /** Set by `fromDrizzle`; lets `doctor` introspect the backing table. */
   [DRIZZLE_META]?: DrizzleSourceMeta;
 }

package/{namespace-probe-lj_0bJrc.d.cts → namespace-probe-C3xMOqWE.d.cts}

@@ -332,6 +332,22 @@ interface SyncSource {
    * absent from another, and read by the runtime.
    */
   objectType?: string;
+  /**
+   * The `source` label a push carries, when it differs from `entity`.
+   *
+   * Only a projection sets this, and only because a projection entity has no
+   * choice but to carry two names: its entity key doubles as the custom-object
+   * slug and must be kebab-case, while `projection.entityKey` is validated by
+   * `/^[a-z][a-z0-9_]*$/` and rejects hyphens. The server resolves that by
+   * storing the mapping's `sourceTable` as `projection.baseTable` — so a push
+   * labelled with the entity key matched no mapping and every row was dropped,
+   * while `push-schema` reported the mapping created and exited 0.
+   *
+   * Deliberately NOT folded into `entity`: that value is also the cursor-store
+   * key, so redefining it would silently reset the sync cursor of every
+   * existing projection and re-push its whole history.
+   */
+  pushSource?: string;
   /** Set by `fromDrizzle`; lets `doctor` introspect the backing table. */
   [DRIZZLE_META]?: DrizzleSourceMeta;
 }

package/package.json

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

package/{sdk-DbvqXNSh.cjs → sdk-BAHcnhm7.cjs}

@@ -77,6 +77,43 @@ function resolveEntitySource(config, entityKey) {
 function expectedSourceKey(concept) {
 	return CONCEPT_KEYS[concept] ?? "custom";
 }
+/**
+* The `source` label a push must carry for the server to find its mapping.
+*
+* `entity` is the SDK's own name for a source — the cursor-store key, and what
+* the developer wrote in `config.source`. It is NOT always what the server
+* filed the mapping under: for a projection, `ensureSchema` stores
+* `sourceTable` as `projection.baseTable`, because a projection entity's key
+* doubles as a kebab-case object slug and cannot also be the snake_case
+* `projection.entityKey`.
+*
+* Pushing under `entity` therefore dropped 100% of a projection's rows while
+* every local signal said the setup was correct. One function so the three
+* push sites cannot drift apart again.
+*/
+function pushSourceOf(source) {
+	return source.pushSource ?? source.entity;
+}
+/**
+* The push label for a custom source, resolved against the config.
+*
+* `fromDrizzleProjection` stamps `pushSource` itself, but a projection source
+* can equally be hand-built — `fromDrizzle` with an overridden `fetchPage` is
+* what the README's own example leads you to, and next-finance did exactly
+* that. Such a source has no `pushSource`, so the label has to come from the
+* one place that is true either way: the entity's declared
+* `projection.baseTable`.
+*
+* Matched on the source's `entity`, which for a custom source is also the
+* config entity key (that is what `resolveEntitySource` above pairs them by).
+* Falls back to `pushSourceOf`, so a non-projection custom source and an
+* already-stamped one both keep their current label.
+*/
+function customPushSource(config, source) {
+	if (source.pushSource) return source.pushSource;
+	const entities = config.entities?.entities;
+	return (entities?.[source.entity] ?? Object.values(entities ?? {}).find((e) => e.source === source.entity))?.projection?.baseTable ?? source.entity;
+}
 //#endregion
 //#region ../sdk/src/concept-coverage.ts
 const CHECK_NAME$1 = "Entity → source coverage";
@@ -1203,7 +1240,7 @@ async function pushRemoteProjections(args) {
 		}
 		try {
 			const ok = await args.push(SYNC_CUSTOM_PATH$1, {
-				source: source.entity,
+				source: pushSourceOf(source),
 				rows: all,
 				mode: "full",
 				fetched: all.length,
@@ -1278,7 +1315,7 @@ async function syncSource(args) {
 		if (rows.length === 0) break;
 		const capped = maxRows === void 0 ? rows : rows.slice(0, maxRows);
 		if (!await push(path, {
-			source: source.entity,
+			source: pushSourceOf(source),
 			rows: capped,
 			mode: "delta",
 			fetched: rows.length,
@@ -1322,7 +1359,7 @@ async function fullSyncSource(args) {
 		ok: true
 	};
 	const ok = await push(path, {
-		source: source.entity,
+		source: pushSourceOf(source),
 		rows: all,
 		mode: "full",
 		fetched: all.length,
@@ -1922,7 +1959,10 @@ function createClivlySDK(config) {
 	};
 	const syncCustomSources = async (customSources, mode, runId) => {
 		const failed = [];
-		for (const customSource of customSources ?? []) if (!await syncOne(customSource, SYNC_CUSTOM_PATH, mode, customSource.objectType, runId)) failed.push(customSource.entity);
+		for (const customSource of customSources ?? []) {
+			customSource.pushSource = customPushSource(config, customSource);
+			if (!await syncOne(customSource, SYNC_CUSTOM_PATH, mode, customSource.objectType, runId)) failed.push(customSource.entity);
+		}
 		return failed;
 	};
 	const syncRemoteSources = async (sources, runId) => {

package/{sdk-BTzaM8bF.mjs → sdk-C0DU5KDS.mjs}

@@ -77,6 +77,43 @@ function resolveEntitySource(config, entityKey) {
 function expectedSourceKey(concept) {
 	return CONCEPT_KEYS[concept] ?? "custom";
 }
+/**
+* The `source` label a push must carry for the server to find its mapping.
+*
+* `entity` is the SDK's own name for a source — the cursor-store key, and what
+* the developer wrote in `config.source`. It is NOT always what the server
+* filed the mapping under: for a projection, `ensureSchema` stores
+* `sourceTable` as `projection.baseTable`, because a projection entity's key
+* doubles as a kebab-case object slug and cannot also be the snake_case
+* `projection.entityKey`.
+*
+* Pushing under `entity` therefore dropped 100% of a projection's rows while
+* every local signal said the setup was correct. One function so the three
+* push sites cannot drift apart again.
+*/
+function pushSourceOf(source) {
+	return source.pushSource ?? source.entity;
+}
+/**
+* The push label for a custom source, resolved against the config.
+*
+* `fromDrizzleProjection` stamps `pushSource` itself, but a projection source
+* can equally be hand-built — `fromDrizzle` with an overridden `fetchPage` is
+* what the README's own example leads you to, and next-finance did exactly
+* that. Such a source has no `pushSource`, so the label has to come from the
+* one place that is true either way: the entity's declared
+* `projection.baseTable`.
+*
+* Matched on the source's `entity`, which for a custom source is also the
+* config entity key (that is what `resolveEntitySource` above pairs them by).
+* Falls back to `pushSourceOf`, so a non-projection custom source and an
+* already-stamped one both keep their current label.
+*/
+function customPushSource(config, source) {
+	if (source.pushSource) return source.pushSource;
+	const entities = config.entities?.entities;
+	return (entities?.[source.entity] ?? Object.values(entities ?? {}).find((e) => e.source === source.entity))?.projection?.baseTable ?? source.entity;
+}
 //#endregion
 //#region ../sdk/src/concept-coverage.ts
 const CHECK_NAME$1 = "Entity → source coverage";
@@ -1203,7 +1240,7 @@ async function pushRemoteProjections(args) {
 		}
 		try {
 			const ok = await args.push(SYNC_CUSTOM_PATH$1, {
-				source: source.entity,
+				source: pushSourceOf(source),
 				rows: all,
 				mode: "full",
 				fetched: all.length,
@@ -1278,7 +1315,7 @@ async function syncSource(args) {
 		if (rows.length === 0) break;
 		const capped = maxRows === void 0 ? rows : rows.slice(0, maxRows);
 		if (!await push(path, {
-			source: source.entity,
+			source: pushSourceOf(source),
 			rows: capped,
 			mode: "delta",
 			fetched: rows.length,
@@ -1322,7 +1359,7 @@ async function fullSyncSource(args) {
 		ok: true
 	};
 	const ok = await push(path, {
-		source: source.entity,
+		source: pushSourceOf(source),
 		rows: all,
 		mode: "full",
 		fetched: all.length,
@@ -1922,7 +1959,10 @@ function createClivlySDK(config) {
 	};
 	const syncCustomSources = async (customSources, mode, runId) => {
 		const failed = [];
-		for (const customSource of customSources ?? []) if (!await syncOne(customSource, SYNC_CUSTOM_PATH, mode, customSource.objectType, runId)) failed.push(customSource.entity);
+		for (const customSource of customSources ?? []) {
+			customSource.pushSource = customPushSource(config, customSource);
+			if (!await syncOne(customSource, SYNC_CUSTOM_PATH, mode, customSource.objectType, runId)) failed.push(customSource.entity);
+		}
 		return failed;
 	};
 	const syncRemoteSources = async (sources, runId) => {

package/sdk.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_entity_config = require("./entity-config-C2MfIDL2.cjs");
-const require_sdk = require("./sdk-DbvqXNSh.cjs");
+const require_sdk = require("./sdk-BAHcnhm7.cjs");
 exports.ClivlyAuthError = require_sdk.ClivlyAuthError;
 exports.ClivlyError = require_sdk.ClivlyError;
 exports.ClivlyNetworkError = require_sdk.ClivlyNetworkError;

package/sdk.d.cts

@@ -1,5 +1,5 @@
 import { C as customObjectDeclarations, M as validateEntitiesConfig, a as ClivlyEntitiesConfig, f as CustomObjectDeclaration, l as ConfigValidationError, m as DiscoveredSchemaTable, u as ConfigValidationResult, w as defineClivlyConfig } from "./entity-config-w8oMBWf8.cjs";
-import { _ as RemoteProjectionsDescription, 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, y as SyncTriggerDescription } from "./namespace-probe-lj_0bJrc.cjs";
+import { _ as RemoteProjectionsDescription, 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, y as SyncTriggerDescription } from "./namespace-probe-C3xMOqWE.cjs";
 //#region ../sdk/src/trigger-url.d.ts
 declare function isPlaceholderUrl(value: string): boolean;
 //#endregion

package/sdk.d.mts

@@ -1,5 +1,5 @@
 import { C as customObjectDeclarations, M as validateEntitiesConfig, a as ClivlyEntitiesConfig, f as CustomObjectDeclaration, l as ConfigValidationError, m as DiscoveredSchemaTable, u as ConfigValidationResult, w as defineClivlyConfig } from "./entity-config-w8oMBWf8.mjs";
-import { _ as RemoteProjectionsDescription, 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, y as SyncTriggerDescription } from "./namespace-probe-ouHKZas2.mjs";
+import { _ as RemoteProjectionsDescription, 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, y as SyncTriggerDescription } from "./namespace-probe-BmxtnOfc.mjs";
 //#region ../sdk/src/trigger-url.d.ts
 declare function isPlaceholderUrl(value: string): boolean;
 //#endregion

package/sdk.mjs

@@ -1,3 +1,3 @@
 import { c as defineClivlyConfig, g as validateEntitiesConfig, s as customObjectDeclarations } from "./entity-config-bC3DX9f1.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-BTzaM8bF.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-C0DU5KDS.mjs";
 export { ClivlyAuthError, ClivlyError, ClivlyNetworkError, ClivlyRateLimitError, createChatSessionHandler, createClivlySDK, customObjectDeclarations, defineClivlyConfig, isPlaceholderUrl, validateEntitiesConfig };

package/vite.d.cts

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

package/vite.d.mts

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