clivly 0.7.0 → 0.7.2

package/README.md

@@ -1,34 +1,40 @@
 # clivly
 
-Configure and integrate [Clivly](https://clivly.com) — the CRM that lives inside
-your app.
+Clivly's consolidated public package.
 
-For the full integration path, including when to use `start()` versus
-`runScheduled()` / `createClivlyHandler()`, see the
-[connecting to Clivly Cloud guide](https://github.com/amani-joseph/clivly.com/blob/master/docs/guides/connecting-to-clivly-cloud.md).
+It serves two roles:
 
-## Usage
+- the CLI you run as `npx clivly ...`
+- the package that exposes the stable runtime subpaths such as `clivly/sdk`
+
+## Install
 
 ```bash
 npm install clivly
+```
+
+Stable releases publish on npm's `latest` tag. Use `@next` only when you are
+intentionally testing a prerelease build.
 
-npx clivly init          # scaffold config, routes and .env, then pair this machine
-npx clivly login         # pair this machine and write your credentials to .env
+This package requires Node `>=22`.
+
+## CLI commands
+
+```bash
+npx clivly init          # scaffold config, route files, and .env placeholders
+npx clivly add widget    # scaffold the chat-session route for the widget
+npx clivly login         # pair this machine and write credentials to .env
 npx clivly status        # check your setup, step by step
 npx clivly dev           # tunnel localhost so remote sync can reach you
 npx clivly push-schema   # report your schema to Clivly without deploying
 ```
 
-`ping` and `doctor` remain as aliases that run subsets of the `status` ladder.
+`ping` and `doctor` remain available as focused aliases around parts of the
+`status` ladder.
 
-Clivly's stable packages publish on npm's `latest` tag. Once installed, the
-`npx clivly …` commands above use your local copy. Use `@next` only when you
-are intentionally testing a prerelease cut.
+## Runtime imports
 
-## Imports
-
-`clivly` is the consolidated public package. The CLI remains available as
-`npx clivly`, while application code imports from typed subpaths:
+Application code should import from subpaths, not from the package root:
 
 ```ts
 import { createClivlySDK, defineClivlyConfig } from "clivly/sdk";
@@ -39,71 +45,43 @@ import { createWorkOSAuthAdapter } from "clivly/auth/workos";
 import { createBetterAuthAdapter } from "clivly/auth/better-auth";
 ```
 
-Provider and framework integrations use optional peer dependencies.
-**Supported auth providers: Clerk, WorkOS, and BetterAuth.** Install only
+Do **not** import application code from `clivly` (the package root). The root
+entry is the CLI.
+
+Provider and framework integrations use optional peer dependencies. Install only
 what your app actually uses, such as `drizzle-orm`, `vite`, `@clerk/backend`,
 `@workos-inc/node`, or `better-auth`.
 
-`clivly init` detects your framework from `package.json`, locates your Drizzle
-schema, and generates a `clivly.config.ts` that maps likely contact and company
-tables. The init command currently generates config for Drizzle only; Prisma and
-Kysely projects should use a hand-written `fetchPage` source for now.
-
-Use `--schema` when your Drizzle schema is not in a common location or in
-`drizzle.config.ts`. Re-run with `--force` to overwrite an existing config.
-
-### Monorepos
+## `clivly init`
 
-In a workspace, `init` reads your `pnpm-workspace.yaml` (or `workspaces` array)
-and imports anything owned by a *sibling* package by **package name** rather than
-by a relative path that climbs out of your app:
-
-```ts
-import * as schema from "@acme/database"; // not "../../packages/database/src/index"
-```
+`clivly init` detects your framework from `package.json`, locates your Drizzle
+schema, and writes:
 
-`--schema` accepts a package specifier as well as a path, so all of these work:
+- `clivly.config.ts`
+- the supported Clivly route files for your framework
+- missing `.env` placeholders
 
-```bash
-clivly init --schema @acme/database                  # the package entry
-clivly init --schema @acme/database/src/schema.ts    # a subpath inside it
-clivly init --schema ./src/db/schema.ts              # a plain path (unchanged)
-```
+It currently targets Drizzle-backed integrations. Prisma and Kysely projects
+can still integrate, but should provide hand-written `fetchPage` sources rather
+than relying on the generated Drizzle path.
 
-A real file always wins over a same-named package, so existing relative paths
-keep their meaning.
+Useful flags:
 
 | Flag | Purpose |
 | --- | --- |
-| `--schema <path\|package>` | Where your Drizzle tables live. |
-| `--db-import <specifier>` | Where the Drizzle instance lives, when it isn't beside the schema. Accepts `@acme/database#database` to name the export. |
-| `--auth-import <specifier>` | Where your better-auth instance lives. Same `#exportName` form. Overrides on-disk probing, which cannot see across a package boundary. |
-| `--contact-table <name>` | Use this table as the contact entity, skipping the naming heuristics. |
-| `--company-table <name>` | Same for companies. |
-
-`--contact-table` and `--company-table` accept either the SQL table name or the
-name it is exported under in your schema module — whichever you have in front of
-you.
-
-### When no contact entity can be found
+| `--schema <path\|package>` | Where your Drizzle schema lives |
+| `--db-import <specifier>` | Where the Drizzle client lives when it is not beside the schema |
+| `--auth-import <specifier>` | Where your auth instance lives |
+| `--contact-table <name>` | Force the contact entity table |
+| `--company-table <name>` | Force the company entity table |
+| `--force` | Overwrite generated files / `.env` values |
+| `--no-login` | Skip the browser pairing step |
+| `--no-browser` | Print the approval URL instead of opening it |
 
-`init` **writes nothing** rather than scaffolding a config that cannot compile.
-Clivly needs one entity before a config will load, and it will not invent one:
-
-```
-No usable contact entity
+If no usable contact entity can be found, `init` writes nothing rather than
+generating a broken config.
 
-  Tables in @acme/database:
-    widgets
-    invoices
-
-  Pick the one that holds your people and re-run:
-    clivly init --schema @acme/database --contact-table widgets
-
-  Nothing was written — Clivly needs one entity before a config can load.
-```
-
-First-class route scaffolding currently exists for:
+Supported first-class route scaffolding today:
 
 - Next.js
 - TanStack Start
@@ -111,82 +89,50 @@ First-class route scaffolding currently exists for:
 - Remix
 - Nuxt
 
-Vue.js apps can still integrate Clivly, but they usually need a manual server
-layer for the tick and verify routes unless they are using Nuxt.
-
-When `init` finishes and `CLIVLY_API_KEY` is still empty, it hands you straight
-into `clivly login` so you don't end up staring at a blank `.env`. That step is
-interactive, so it is skipped automatically when there is no TTY or when `CI` is
-set — and you can always turn it off yourself:
+## `clivly add widget`
 
 ```bash
-npx clivly init --no-login     # scaffold only; pair later with `clivly login`
-npx clivly init --no-browser   # pair, but print the URL instead of opening it
+npx clivly add widget
 ```
 
+Scaffolds the host-side widget session route that mounts
+`createChatSessionHandler()` from `clivly/sdk`. It is idempotent and supports
+`--dry-run` and `--force`.
+
 ## `clivly login`
 
 ```bash
 npx clivly login [--force] [--rotate] [--api-url <url>] [--no-browser]
 ```
 
-Pairs this machine with a Clivly workspace and writes `CLIVLY_API_KEY` and
-`CLIVLY_SYNC_TRIGGER_SECRET` into your project's `.env`. It creates a pairing
-session, prints (and by default opens) an approval link, and waits while you
-approve it in a signed-in browser. The approval link is always printed, so an
-SSH or headless session can be approved by opening the link elsewhere.
-
-- `--no-browser` — print the approval URL without opening a browser.
-- `--force` — overwrite `.env` values that already have a real value. Without
-  it, existing values are kept and reported as skipped; an empty placeholder
-  (`CLIVLY_API_KEY=`) is always filled in.
-- `--rotate` — rotate the workspace's remote-sync trigger secret instead of
-  revealing the current one. Your already-deployed host app will stop receiving
-  sync triggers until you redeploy it with the new secret.
-
-Before anything is written, the CLI prints which workspace approved the pairing
-and asks you to confirm. Declining writes nothing and exits non-zero. In a
-non-interactive run (no TTY, or `CI` set) the workspace is still printed but
-you are not prompted, so scripted pairing cannot hang.
-
-The pairing endpoints are feature-flagged server-side
-(`CLIVLY_CLI_PAIRING_ENABLED`); if the backend you point at has not enabled
-them, `clivly login` says so and exits non-zero.
-
-**Clivly Cloud has pairing enabled**, so `clivly login` is the normal path there.
-The flag defaults to `false`, so a self-hosted backend must opt in.
-
-### Manual credential path
-
-If pairing is unavailable — a self-hosted backend with the flag off, or a
-restricted environment — every credential can be set by hand. Nothing about the
-CLI requires pairing.
-
-| Value | Where to get it | Notes |
-| --- | --- | --- |
-| `CLIVLY_API_KEY` | Dashboard → **Settings → API keys** → Create | **Shown once.** Copy it immediately; you cannot retrieve it later, only regenerate. Regenerating **revokes the previous key**, so redeploy after rotating. |
-| `CLIVLY_SYNC_TRIGGER_SECRET` | Dashboard → **Integrations → Remote sync** | Must match the value in your app's env exactly. A mismatch surfaces as a `401` on the signed trigger. |
-| `CLIVLY_SYNC_TRIGGER_URL` | Your own deployment | The public URL of your mounted tick route, e.g. `https://app.example.com/api/clivly/tick`. Optional until you deploy — push-only setups can leave it unset. |
-| `CLIVLY_VERIFY_TOKEN` | Dashboard → **Integrations** | Only needed if you mount the auth-verify route. |
-
-Write them into the `.env` of the package that imports `clivly`, then re-run
-`clivly status` to confirm each rung goes green.
-
-> **Running your own Clivly backend?** `CLIVLY_TRIGGER_SECRET_WRAPPING_KEY` (a
-> 32-byte hex key) is a **hard production prerequisite** for pairing. The
-> trigger secret is stored encrypted with it, so without the key set on the
-> server, `clivly login` fails with a 500 at the moment it would hand over
-> credentials. Set it before enabling `CLIVLY_CLI_PAIRING_ENABLED`.
+Pairs this machine with a Clivly workspace and writes:
+
+- `CLIVLY_SECRET_KEY`
+- `CLIVLY_SYNC_TRIGGER_SECRET`
+
+into your project's `.env`.
+
+The approval URL is always printed, so headless or SSH sessions can still be
+approved in another browser.
+
+Notes:
+
+- `--force` overwrites existing real values
+- `--rotate` rotates the remote-sync trigger secret instead of revealing the
+  current one
+- pairing is feature-flagged server-side with `CLIVLY_CLI_PAIRING_ENABLED`
+
+If pairing is unavailable, you can still set credentials manually and then run
+`clivly status`.
 
 ## `clivly status`
 
 ```bash
-npx clivly status [--verbose] [--config <path>]
+npx clivly status [--verbose] [--config <path>] [--env-file <path>]
 ```
 
-Walks your setup one rung at a time — credentials, config, schema, sources,
-connectivity — and stops at the first thing that isn't ready, telling you what
-to do about it. This is the command to reach for when something isn't working.
+Walks the setup one rung at a time: credentials, config, schema, sources, and
+connectivity. This is the main diagnostic command for integration issues.
 
 ## `clivly dev`
 
@@ -195,52 +141,49 @@ npx clivly dev [--port <n>] [--api-url <url>] [--route-path <path>] [-- <cmd>]
 ```
 
 Opens a `cloudflared` tunnel to your local app and registers it with Clivly for
-the length of the session, so remote sync can reach `localhost` while you
-develop. Your dev server is detected from `package.json` scripts, or pass it
-explicitly after `--`. Needs `cloudflared` on `PATH` and `CLIVLY_API_KEY` set.
-The override is cleared when the process exits; remote sync is otherwise
-deploy-only.
+the lifetime of the session, so remote sync can reach `localhost` during local
+development. The override is cleared on exit.
 
-## `clivly ping` / `clivly doctor`
+Requires:
 
-`clivly ping` reads `CLIVLY_API_KEY` from the environment, sends one heartbeat, and prints a clear ✅/❌ with the resolved org or the failure reason — so you can confirm a connection from the terminal without writing any code. Point it at a non-default backend with `--api-url <url>` (or `CLIVLY_API_URL`).
+- `cloudflared` on `PATH`
+- `CLIVLY_SECRET_KEY` set
+
+## `clivly push-schema`
 
 ```bash
-CLIVLY_API_KEY=sk_live_… npx clivly ping
-#
-# Clivly ping
-#   ✅ Connected to Clivly
-#      Org: Acme (org_1)
+npx clivly push-schema [--config <path>]
 ```
 
-`clivly doctor` loads your config and runs the same read-only checks as
-`await clivly.doctor()`: API key, entity config, sources, Drizzle cursor/id
-columns, sample fetch, and heartbeat.
+Reports your discovered schema to Clivly without waiting for a deployed app to
+heartbeat it first.
 
-```bash
-npx clivly doctor
-npx clivly doctor --config ./apps/web/clivly.config.ts
-```
+## `clivly ping` / `clivly doctor`
+
+`clivly ping` sends one heartbeat and prints a terse pass/fail result.
+
+`clivly doctor` loads your config and runs the same read-only checks exposed by
+`await clivly.doctor()`.
 
 ## Telemetry
 
-**Clivly collects no telemetry.** The CLI makes network requests only to the
-Clivly API you point it at, and only to do what you asked: pairing, heartbeats,
-schema pushes, and status checks. No usage analytics, no crash reporting, no
-phone-home. See [SECURITY.md](https://github.com/amani-joseph/clivly.com/blob/master/SECURITY.md#telemetry).
+Clivly collects no telemetry. The CLI makes network requests only to the
+Clivly API you point it at, and only to do the work you asked for: pairing,
+heartbeats, schema pushes, status checks, and tunnel override registration.
+
+See the telemetry section in:
+[SECURITY.md](https://github.com/amani-joseph/clivly.com/blob/master/SECURITY.md#telemetry)
 
 ## More docs
 
-- Onboarding guide:
-  [connecting to Clivly Cloud](https://github.com/amani-joseph/clivly.com/blob/master/docs/guides/connecting-to-clivly-cloud.md)
-- Adding the chat widget:
-  [guide](https://github.com/amani-joseph/clivly.com/blob/master/docs/guides/adding-the-chat-widget.md)
-- Security policy:
-  [SECURITY.md](https://github.com/amani-joseph/clivly.com/blob/master/SECURITY.md)
+- Cloud onboarding guide:
+  [Connecting to Clivly Cloud](https://github.com/amani-joseph/clivly.com/blob/master/docs/guides/connecting-to-clivly-cloud.md)
+- Chat widget guide:
+  [Adding the chat widget](https://github.com/amani-joseph/clivly.com/blob/master/docs/guides/adding-the-chat-widget.md)
 - SDK docs:
-  [`@clivly/sdk` README](https://github.com/amani-joseph/clivly.com/blob/master/packages/sdk/README.md)
+  [packages/sdk/README.md](https://github.com/amani-joseph/clivly.com/blob/master/packages/sdk/README.md)
 - Release notes:
-  [CHANGELOG](https://github.com/amani-joseph/clivly.com/blob/master/CHANGELOG.md)
+  [CHANGELOG.md](https://github.com/amani-joseph/clivly.com/blob/master/CHANGELOG.md)
 
 ## License
 

package/core-entity-config.cjs

@@ -1,8 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
 const require_entity_config = require("./entity-config-D87rV-tE.cjs");
 //#region src/core-entity-config.ts
-require_deprecate_subpath.warnDeprecatedSubpath("clivly/core/entity-config", "clivly/internal/entity-config");
+require("./deprecate-subpath-B9ngvizt.cjs").warnDeprecatedSubpath("clivly/core/entity-config", "clivly/internal/entity-config");
 //#endregion
 exports.CANONICAL_FIELDS = require_entity_config.CANONICAL_FIELDS;
 exports.CRM_CONCEPTS = require_entity_config.CRM_CONCEPTS;

package/core-entity-config.mjs

@@ -1,5 +1,5 @@
-import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
 import { a as MATERIALIZING_CONCEPTS, c as filterSchema, d as validateEntitiesConfig, i as ClivlyConfigError, l as relationshipSchema, n as CRM_CONCEPTS, o as defineClivlyConfig, r as CUSTOM_CONCEPT, s as entitiesConfigSchema, t as CANONICAL_FIELDS, u as relationshipsSchema } from "./entity-config-va2bkH5o.mjs";
+import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
 //#region src/core-entity-config.ts
 warnDeprecatedSubpath("clivly/core/entity-config", "clivly/internal/entity-config");
 //#endregion

package/core-entity-heuristics.cjs

@@ -1,8 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
 const require_internal_entity_heuristics = require("./internal-entity-heuristics.cjs");
 //#region src/core-entity-heuristics.ts
-require_deprecate_subpath.warnDeprecatedSubpath("clivly/core/entity-heuristics", "clivly/internal/entity-heuristics");
+require("./deprecate-subpath-B9ngvizt.cjs").warnDeprecatedSubpath("clivly/core/entity-heuristics", "clivly/internal/entity-heuristics");
 //#endregion
 exports.TARGET_CONCEPTS = require_internal_entity_heuristics.TARGET_CONCEPTS;
 exports.matchesConcept = require_internal_entity_heuristics.matchesConcept;

package/core-entity-heuristics.mjs

@@ -1,5 +1,5 @@
-import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
 import { TARGET_CONCEPTS, matchesConcept, requiredFieldsFor, scoreConcepts, scoreFieldMap, scoreRelationships, suggestCursorField, suggestDiscriminatorColumns, toFieldMap, topConcept, validateMapping } from "./internal-entity-heuristics.mjs";
+import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
 //#region src/core-entity-heuristics.ts
 warnDeprecatedSubpath("clivly/core/entity-heuristics", "clivly/internal/entity-heuristics");
 //#endregion

package/core-mapping-score.cjs

@@ -1,8 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
 const require_mapping_score = require("./mapping-score-CaB3F4Uu.cjs");
 //#region src/core-mapping-score.ts
-require_deprecate_subpath.warnDeprecatedSubpath("clivly/core/mapping-score", "clivly/internal/mapping-score");
+require("./deprecate-subpath-B9ngvizt.cjs").warnDeprecatedSubpath("clivly/core/mapping-score", "clivly/internal/mapping-score");
 //#endregion
 exports.AMBIGUITY_MARGIN = require_mapping_score.AMBIGUITY_MARGIN;
 exports.CONCEPT_TIERS = require_mapping_score.CONCEPT_TIERS;

package/core-mapping-score.mjs

@@ -1,5 +1,5 @@
-import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.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, t as AMBIGUITY_MARGIN, u as tierFor } from "./mapping-score-C68uAqGB.mjs";
+import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
 //#region src/core-mapping-score.ts
 warnDeprecatedSubpath("clivly/core/mapping-score", "clivly/internal/mapping-score");
 //#endregion

package/core.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
 const require_entity_config = require("./entity-config-D87rV-tE.cjs");
+const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
 const require_auth_adapter = require("./auth-adapter-CiEXcweZ.cjs");
 const require_mapping_form = require("./mapping-form-BpfON_ME.cjs");
 const require_mappings_config = require("./mappings-config-BsRADNRv.cjs");

package/core.mjs

@@ -1,5 +1,5 @@
-import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
 import { a as MATERIALIZING_CONCEPTS, c as filterSchema, d as validateEntitiesConfig, i as ClivlyConfigError, l as relationshipSchema, n as CRM_CONCEPTS, o as defineClivlyConfig, s as entitiesConfigSchema, t as CANONICAL_FIELDS, u as relationshipsSchema } from "./entity-config-va2bkH5o.mjs";
+import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.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 { t as mappingsToEntitiesConfig } from "./mappings-config-Dbgxx3Nv.mjs";

package/index.cjs

@@ -1,12 +1,9 @@
 #!/usr/bin/env node
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_entity_config = require("./entity-config-D87rV-tE.cjs");
-require("./core-entity-config.cjs");
 require("./mapping-score-CaB3F4Uu.cjs");
 const require_internal_entity_heuristics = require("./internal-entity-heuristics.cjs");
-require("./core-entity-heuristics.cjs");
-require("./core-mapping-score.cjs");
-const require_sdk = require("./sdk-CzOf596t.cjs");
+const require_sdk = require("./sdk-iqOXeWIp.cjs");
 let node_child_process = require("node:child_process");
 let node_fs = require("node:fs");
 let node_module = require("node:module");
@@ -720,6 +717,12 @@ function siblingDbCandidates(schemaPath) {
 	const dir = isDirectory(schemaPath) ? schemaPath : (0, node_path.dirname)(schemaPath);
 	return SIBLING_DB_NAMES.map((name) => (0, node_path.join)(dir, name));
 }
+function parentDbCandidates(schemaPath, cwd) {
+	const parent = (0, node_path.dirname)(isDirectory(schemaPath) ? schemaPath : (0, node_path.dirname)(schemaPath));
+	const relativeToRoot = (0, node_path.relative)((0, node_path.resolve)(cwd), (0, node_path.resolve)(parent));
+	if (!(relativeToRoot === "" || !relativeToRoot.startsWith(".."))) return [];
+	return SIBLING_DB_NAMES.map((name) => (0, node_path.join)(parent, name));
+}
 async function discoverSchema(opts) {
 	const load = opts.load ?? defaultLoader$1(opts.cwd);
 	const mod = await loadSchemaModule(opts.schemaPath, load);
@@ -751,6 +754,13 @@ async function discoverSchema(opts) {
 		load,
 		match: isDrizzleDb
 	});
+	if (db === null) db = await probeModule({
+		candidates: parentDbCandidates(opts.schemaPath, opts.cwd),
+		cwd: opts.cwd,
+		graph: opts.graph,
+		load,
+		match: isDrizzleDb
+	});
 	return {
 		tables,
 		importPath,
@@ -1286,10 +1296,6 @@ function renderSource(role, entity, dbExpr) {
 	const opts = entity.idField === null ? `{ entity: "${entity.tableName}", cursorField: "${entity.cursorField}" }` : `{ entity: "${entity.tableName}", cursorField: "${entity.cursorField}", idField: "${entity.idField}" }`;
 	return `    ${role}: fromDrizzle(${dbExpr}, schema.${entity.moduleKey}, ${opts})`;
 }
-function fallbackDbImportPath(schemaImportPath) {
-	const slash = schemaImportPath.lastIndexOf("/");
-	return `${slash >= 0 ? schemaImportPath.slice(0, slash) : "."}/db`;
-}
 function dbIsInSchemaModule(plan) {
 	return plan.db !== null && plan.db.importPath === plan.importPath;
 }
@@ -1304,7 +1310,7 @@ function renderImports(plan) {
 		"import { discoverFromDrizzle } from \"clivly/drizzle\";",
 		`import * as schema from "${plan.importPath}";`
 	];
-	if (!plan.db) lines.push(`import { db } from "${fallbackDbImportPath(plan.importPath)}"; // TODO: point at your Drizzle instance`);
+	if (!plan.db) lines.push("import { db } from \"<YOUR_DB_MODULE>\"; // TODO(clivly): replace with the path to your Drizzle `db` instance — NOT your schema file");
 	else if (!dbIsInSchemaModule(plan)) lines.push(`import { ${plan.db.moduleKey} } from "${plan.db.importPath}";`);
 	return lines.join("\n");
 }
@@ -1333,6 +1339,8 @@ export default createClivlySDK({
   // all when you add a mapping — not just the ones wired up as sources below.
   schema: discoverFromDrizzle(schema),
   source: {
+    // Keyed by CRM concept — contacts/companies/deals/custom.
+    // NOT by your entity key. The entity's own \`source:\` above is a table name.
 ${sources.join(",\n")},
   },
   syncTrigger: {
@@ -2133,7 +2141,7 @@ const STATUS_STAGES = [
 			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. Push-only setups can ignore this."
+				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."
 			});
 		}
 	}

package/index.mjs

@@ -1,11 +1,8 @@
 #!/usr/bin/env node
 import { t as CANONICAL_FIELDS } from "./entity-config-va2bkH5o.mjs";
-import "./core-entity-config.mjs";
 import "./mapping-score-C68uAqGB.mjs";
 import { matchesConcept, requiredFieldsFor, scoreFieldMap, scoreRelationships, suggestCursorField, toFieldMap } from "./internal-entity-heuristics.mjs";
-import "./core-entity-heuristics.mjs";
-import "./core-mapping-score.mjs";
-import { t as createClivlySDK } from "./sdk-C_1sGiH8.mjs";
+import { t as createClivlySDK } from "./sdk-C6WANW8M.mjs";
 import { createRequire } from "node:module";
 import { spawn } from "node:child_process";
 import { accessSync, constants, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, statSync, writeFileSync } from "node:fs";
@@ -719,6 +716,12 @@ function siblingDbCandidates(schemaPath) {
 	const dir = isDirectory(schemaPath) ? schemaPath : dirname(schemaPath);
 	return SIBLING_DB_NAMES.map((name) => join(dir, name));
 }
+function parentDbCandidates(schemaPath, cwd) {
+	const parent = dirname(isDirectory(schemaPath) ? schemaPath : dirname(schemaPath));
+	const relativeToRoot = relative(resolve(cwd), resolve(parent));
+	if (!(relativeToRoot === "" || !relativeToRoot.startsWith(".."))) return [];
+	return SIBLING_DB_NAMES.map((name) => join(parent, name));
+}
 async function discoverSchema(opts) {
 	const load = opts.load ?? defaultLoader$1(opts.cwd);
 	const mod = await loadSchemaModule(opts.schemaPath, load);
@@ -750,6 +753,13 @@ async function discoverSchema(opts) {
 		load,
 		match: isDrizzleDb
 	});
+	if (db === null) db = await probeModule({
+		candidates: parentDbCandidates(opts.schemaPath, opts.cwd),
+		cwd: opts.cwd,
+		graph: opts.graph,
+		load,
+		match: isDrizzleDb
+	});
 	return {
 		tables,
 		importPath,
@@ -1285,10 +1295,6 @@ function renderSource(role, entity, dbExpr) {
 	const opts = entity.idField === null ? `{ entity: "${entity.tableName}", cursorField: "${entity.cursorField}" }` : `{ entity: "${entity.tableName}", cursorField: "${entity.cursorField}", idField: "${entity.idField}" }`;
 	return `    ${role}: fromDrizzle(${dbExpr}, schema.${entity.moduleKey}, ${opts})`;
 }
-function fallbackDbImportPath(schemaImportPath) {
-	const slash = schemaImportPath.lastIndexOf("/");
-	return `${slash >= 0 ? schemaImportPath.slice(0, slash) : "."}/db`;
-}
 function dbIsInSchemaModule(plan) {
 	return plan.db !== null && plan.db.importPath === plan.importPath;
 }
@@ -1303,7 +1309,7 @@ function renderImports(plan) {
 		"import { discoverFromDrizzle } from \"clivly/drizzle\";",
 		`import * as schema from "${plan.importPath}";`
 	];
-	if (!plan.db) lines.push(`import { db } from "${fallbackDbImportPath(plan.importPath)}"; // TODO: point at your Drizzle instance`);
+	if (!plan.db) lines.push("import { db } from \"<YOUR_DB_MODULE>\"; // TODO(clivly): replace with the path to your Drizzle `db` instance — NOT your schema file");
 	else if (!dbIsInSchemaModule(plan)) lines.push(`import { ${plan.db.moduleKey} } from "${plan.db.importPath}";`);
 	return lines.join("\n");
 }
@@ -1332,6 +1338,8 @@ export default createClivlySDK({
   // all when you add a mapping — not just the ones wired up as sources below.
   schema: discoverFromDrizzle(schema),
   source: {
+    // Keyed by CRM concept — contacts/companies/deals/custom.
+    // NOT by your entity key. The entity's own \`source:\` above is a table name.
 ${sources.join(",\n")},
   },
   syncTrigger: {
@@ -2132,7 +2140,7 @@ const STATUS_STAGES = [
 			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. Push-only setups can ignore this."
+				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."
 			});
 		}
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clivly",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "private": false,
   "type": "module",
   "description": "Clivly CLI — scaffold a CRM into your app (clivly init).",
@@ -367,8 +367,8 @@
   "peerDependencies": {
     "@clerk/backend": ">=1",
     "@workos-inc/node": ">=7",
-    "better-auth": ">=1",
-    "drizzle-orm": ">=0.30",
+    "better-auth": ">=1.6.22",
+    "drizzle-orm": ">=0.30 || >=1.0.0-rc.0",
     "vite": ">=5"
   },
   "peerDependenciesMeta": {

package/{sdk-C_1sGiH8.mjs → sdk-C6WANW8M.mjs}

@@ -1,4 +1,83 @@
 import { t as DRIZZLE_META } from "./drizzle-meta-D-5k3n0i.mjs";
+//#region ../sdk/src/entity-source.ts
+const CONCEPT_KEYS = {
+	contact: "contacts",
+	company: "companies",
+	deal: "deals"
+};
+function resolveEntitySource(config, entityKey) {
+	const entity = config.entities?.entities?.[entityKey];
+	const src = config.source;
+	if (!(entity && src)) return null;
+	const conceptKey = CONCEPT_KEYS[entity.concept];
+	if (conceptKey) {
+		const source = src[conceptKey];
+		return source ? {
+			concept: entity.concept,
+			expectedKey: conceptKey,
+			source
+		} : null;
+	}
+	if (entity.concept === "custom") {
+		const match = (src.custom ?? []).find((c) => c.entity === entity.source || c.entity === entityKey);
+		return match ? {
+			concept: "custom",
+			expectedKey: "custom",
+			source: match
+		} : null;
+	}
+	return null;
+}
+/** The `config.source` key an entity's concept requires, present or not. */
+function expectedSourceKey(concept) {
+	return CONCEPT_KEYS[concept] ?? "custom";
+}
+//#endregion
+//#region ../sdk/src/concept-coverage.ts
+const CHECK_NAME = "Entity → source coverage";
+function configuredKeys(config) {
+	const src = config.source;
+	if (!src) return [];
+	return Object.entries(src).filter(([, value]) => Array.isArray(value) ? value.length > 0 : Boolean(value)).map(([key]) => key);
+}
+/**
+* Every configured entity must resolve to a source, or it silently syncs
+* nothing. This is the check that catches `source` keyed by entity name rather
+* than by CRM concept — a mistake that otherwise shows up only as a run that
+* succeeds with zero rows.
+*/
+function checkConceptCoverage(config) {
+	const entities = config.entities?.entities ?? {};
+	const keys = Object.keys(entities);
+	if (keys.length === 0) return {
+		name: CHECK_NAME,
+		ok: false,
+		skipped: true,
+		detail: "No entities configured — nothing to cross-check."
+	};
+	const unresolved = keys.filter((key) => resolveEntitySource(config, key) === null);
+	if (unresolved.length === 0) return {
+		name: CHECK_NAME,
+		ok: true,
+		detail: `${keys.length} entit${keys.length === 1 ? "y" : "ies"} resolve to a configured source.`
+	};
+	const available = configuredKeys(config);
+	const listed = available.length > 0 ? available.join(", ") : "(none)";
+	const problems = unresolved.map((key) => {
+		const concept = entities[key]?.concept ?? "unknown";
+		if (concept === "custom") {
+			const custom = config.source?.custom ?? [];
+			if (custom.length > 0) return `"${key}" has concept "custom" but no entry in \`source.custom\` matches it — it will never sync. Entities configured in \`source.custom\`: ${custom.map((c) => c.entity).join(", ")}.`;
+		}
+		return `"${key}" has concept "${concept}" but no \`source.${expectedSourceKey(concept)}\` is configured — it will never sync.`;
+	});
+	return {
+		name: CHECK_NAME,
+		ok: false,
+		detail: `${problems.join(" ")} Configured source keys: ${listed}. \`source\` is keyed by CRM concept, not by entity key.`
+	};
+}
+//#endregion
 //#region ../sdk/src/custom-slug.ts
 const NON_ALNUM = /[^a-z0-9]+/g;
 const EDGE_HYPHENS = /(^-|-$)/g;
@@ -79,6 +158,56 @@ function describeFetchError(entity, error) {
 	return `Couldn't read "${entity}": ${firstLine(root instanceof Error ? root.message : String(root?.message ?? root ?? "unknown error"))}`;
 }
 //#endregion
+//#region ../sdk/src/mapping-dry-run.ts
+/**
+* Fetch one real row and push it through the entity's field map.
+*
+* The distinction from "Sample fetch": that proves the query runs, this proves
+* the row that comes back actually carries the columns `fields` names. A
+* mapping that points at a column the row lacks produces empty CRM records
+* rather than an error, so it has to be caught here.
+*
+* An empty table SKIPS rather than fails — a fresh database is not a
+* misconfiguration, and failing on it would train people to ignore the check.
+*/
+async function runMappingDryRun(config, entityKey) {
+	const name = `Field mapping dry run (${entityKey})`;
+	const resolved = resolveEntitySource(config, entityKey);
+	if (!resolved) return {
+		name,
+		ok: false,
+		skipped: true,
+		detail: `"${entityKey}" resolves to no source — see the coverage check above.`
+	};
+	const fields = config.entities?.entities?.[entityKey]?.fields ?? {};
+	let rows;
+	try {
+		rows = await resolved.source.fetchPage({
+			since: null,
+			limit: 1
+		});
+	} catch (error) {
+		return {
+			name,
+			ok: false,
+			detail: describeFetchError(entityKey, error)
+		};
+	}
+	const row = rows[0];
+	if (row === void 0) return {
+		name,
+		ok: false,
+		skipped: true,
+		detail: `"${resolved.source.entity}" is empty — nothing to map yet.`
+	};
+	const missing = Object.entries(fields).filter(([, column]) => !(column in row)).map(([field, column]) => `${field} → ${column}`);
+	return {
+		name,
+		ok: missing.length === 0,
+		detail: missing.length === 0 ? `Mapped ${Object.keys(fields).length} field(s) from a real "${resolved.source.entity}" row.` : `Row from "${resolved.source.entity}" is missing mapped column(s): ${missing.join(", ")}.`
+	};
+}
+//#endregion
 //#region ../sdk/src/namespace-probe.ts
 /**
 * Verify the tables the integration depends on are genuinely reachable:
@@ -169,6 +298,11 @@ async function namespaceCheck(config) {
 		detail: probeResult.reachable ? "All required source tables are reachable." : probeResult.error?.message ?? "namespace unreachable"
 	};
 }
+async function mappingDryRunChecks(config) {
+	const checks = [];
+	for (const entityKey of Object.keys(config.entities?.entities ?? {})) checks.push(await runMappingDryRun(config, entityKey));
+	return checks;
+}
 /**
 * Run the read-only setup checks and return a structured report. Every check
 * captures its own error into `detail` rather than throwing, so one failure never
@@ -195,6 +329,7 @@ async function runDoctor(args) {
 		ok: sources.length > 0,
 		detail: sources.length > 0 ? `${sources.length} source(s) to mirror.` : "No `source.contacts` — nothing to sync."
 	});
+	checks.push(checkConceptCoverage(config));
 	for (const source of sources) {
 		const meta = source[DRIZZLE_META];
 		if (!meta) {
@@ -233,6 +368,7 @@ async function runDoctor(args) {
 			detail: describeFetchError(source.entity, error)
 		});
 	}
+	checks.push(...await mappingDryRunChecks(config));
 	const result = await connect();
 	checks.push({
 		name: "Heartbeat",
@@ -276,6 +412,7 @@ async function syncSource(args) {
 	const idField = source.idField ?? DEFAULT_ID_FIELD;
 	let cursor = since;
 	let pushed = 0;
+	const resumedFrom = since === null ? null : since.time.toISOString();
 	for (;;) {
 		const rows = await source.fetchPage({
 			since: cursor,
@@ -287,6 +424,8 @@ async function syncSource(args) {
 			source: source.entity,
 			rows: capped,
 			mode: "delta",
+			fetched: rows.length,
+			cursor: resumedFrom,
 			...objectType ? { objectType } : {}
 		})) return {
 			pushed,
@@ -329,6 +468,8 @@ async function fullSyncSource(args) {
 		source: source.entity,
 		rows: all,
 		mode: "full",
+		fetched: all.length,
+		cursor: null,
 		...objectType ? { objectType } : {}
 	});
 	return {
@@ -708,31 +849,25 @@ function createFetcher(retry) {
 		}
 	};
 }
+const CONCEPT_PATHS = {
+	contacts: SYNC_CONTACTS_PATH,
+	companies: SYNC_COMPANIES_PATH,
+	deals: SYNC_DEALS_PATH,
+	custom: SYNC_CUSTOM_PATH
+};
 function resolveSampleSource(config, entityKey) {
-	const entity = config.entities?.entities?.[entityKey];
-	const src = config.source;
-	if (!(entity && src)) return null;
-	if (entity.concept === "contact" && src.contacts) return {
-		source: src.contacts,
-		path: SYNC_CONTACTS_PATH
-	};
-	if (entity.concept === "company" && src.companies) return {
-		source: src.companies,
-		path: SYNC_COMPANIES_PATH
-	};
-	if (entity.concept === "deal" && src.deals) return {
-		source: src.deals,
-		path: SYNC_DEALS_PATH
+	const resolved = resolveEntitySource(config, entityKey);
+	if (!resolved) return null;
+	const path = CONCEPT_PATHS[resolved.expectedKey];
+	if (!path) return null;
+	return resolved.expectedKey === "custom" ? {
+		source: resolved.source,
+		path,
+		objectType: resolved.source.objectType
+	} : {
+		source: resolved.source,
+		path
 	};
-	if (entity.concept === "custom") {
-		const custom = (src.custom ?? []).find((c) => c.entity === entity.source || c.entity === entityKey);
-		return custom ? {
-			source: custom,
-			path: SYNC_CUSTOM_PATH,
-			objectType: custom.objectType
-		} : null;
-	}
-	return null;
 }
 const PREVIEW_LIMIT = 5;
 function resolvePreviewSource(config, sourceTable) {

package/{sdk-CzOf596t.cjs → sdk-iqOXeWIp.cjs}

@@ -1,4 +1,83 @@
 const require_drizzle_meta = require("./drizzle-meta-Bb1JWYqf.cjs");
+//#region ../sdk/src/entity-source.ts
+const CONCEPT_KEYS = {
+	contact: "contacts",
+	company: "companies",
+	deal: "deals"
+};
+function resolveEntitySource(config, entityKey) {
+	const entity = config.entities?.entities?.[entityKey];
+	const src = config.source;
+	if (!(entity && src)) return null;
+	const conceptKey = CONCEPT_KEYS[entity.concept];
+	if (conceptKey) {
+		const source = src[conceptKey];
+		return source ? {
+			concept: entity.concept,
+			expectedKey: conceptKey,
+			source
+		} : null;
+	}
+	if (entity.concept === "custom") {
+		const match = (src.custom ?? []).find((c) => c.entity === entity.source || c.entity === entityKey);
+		return match ? {
+			concept: "custom",
+			expectedKey: "custom",
+			source: match
+		} : null;
+	}
+	return null;
+}
+/** The `config.source` key an entity's concept requires, present or not. */
+function expectedSourceKey(concept) {
+	return CONCEPT_KEYS[concept] ?? "custom";
+}
+//#endregion
+//#region ../sdk/src/concept-coverage.ts
+const CHECK_NAME = "Entity → source coverage";
+function configuredKeys(config) {
+	const src = config.source;
+	if (!src) return [];
+	return Object.entries(src).filter(([, value]) => Array.isArray(value) ? value.length > 0 : Boolean(value)).map(([key]) => key);
+}
+/**
+* Every configured entity must resolve to a source, or it silently syncs
+* nothing. This is the check that catches `source` keyed by entity name rather
+* than by CRM concept — a mistake that otherwise shows up only as a run that
+* succeeds with zero rows.
+*/
+function checkConceptCoverage(config) {
+	const entities = config.entities?.entities ?? {};
+	const keys = Object.keys(entities);
+	if (keys.length === 0) return {
+		name: CHECK_NAME,
+		ok: false,
+		skipped: true,
+		detail: "No entities configured — nothing to cross-check."
+	};
+	const unresolved = keys.filter((key) => resolveEntitySource(config, key) === null);
+	if (unresolved.length === 0) return {
+		name: CHECK_NAME,
+		ok: true,
+		detail: `${keys.length} entit${keys.length === 1 ? "y" : "ies"} resolve to a configured source.`
+	};
+	const available = configuredKeys(config);
+	const listed = available.length > 0 ? available.join(", ") : "(none)";
+	const problems = unresolved.map((key) => {
+		const concept = entities[key]?.concept ?? "unknown";
+		if (concept === "custom") {
+			const custom = config.source?.custom ?? [];
+			if (custom.length > 0) return `"${key}" has concept "custom" but no entry in \`source.custom\` matches it — it will never sync. Entities configured in \`source.custom\`: ${custom.map((c) => c.entity).join(", ")}.`;
+		}
+		return `"${key}" has concept "${concept}" but no \`source.${expectedSourceKey(concept)}\` is configured — it will never sync.`;
+	});
+	return {
+		name: CHECK_NAME,
+		ok: false,
+		detail: `${problems.join(" ")} Configured source keys: ${listed}. \`source\` is keyed by CRM concept, not by entity key.`
+	};
+}
+//#endregion
 //#region ../sdk/src/custom-slug.ts
 const NON_ALNUM = /[^a-z0-9]+/g;
 const EDGE_HYPHENS = /(^-|-$)/g;
@@ -79,6 +158,56 @@ function describeFetchError(entity, error) {
 	return `Couldn't read "${entity}": ${firstLine(root instanceof Error ? root.message : String(root?.message ?? root ?? "unknown error"))}`;
 }
 //#endregion
+//#region ../sdk/src/mapping-dry-run.ts
+/**
+* Fetch one real row and push it through the entity's field map.
+*
+* The distinction from "Sample fetch": that proves the query runs, this proves
+* the row that comes back actually carries the columns `fields` names. A
+* mapping that points at a column the row lacks produces empty CRM records
+* rather than an error, so it has to be caught here.
+*
+* An empty table SKIPS rather than fails — a fresh database is not a
+* misconfiguration, and failing on it would train people to ignore the check.
+*/
+async function runMappingDryRun(config, entityKey) {
+	const name = `Field mapping dry run (${entityKey})`;
+	const resolved = resolveEntitySource(config, entityKey);
+	if (!resolved) return {
+		name,
+		ok: false,
+		skipped: true,
+		detail: `"${entityKey}" resolves to no source — see the coverage check above.`
+	};
+	const fields = config.entities?.entities?.[entityKey]?.fields ?? {};
+	let rows;
+	try {
+		rows = await resolved.source.fetchPage({
+			since: null,
+			limit: 1
+		});
+	} catch (error) {
+		return {
+			name,
+			ok: false,
+			detail: describeFetchError(entityKey, error)
+		};
+	}
+	const row = rows[0];
+	if (row === void 0) return {
+		name,
+		ok: false,
+		skipped: true,
+		detail: `"${resolved.source.entity}" is empty — nothing to map yet.`
+	};
+	const missing = Object.entries(fields).filter(([, column]) => !(column in row)).map(([field, column]) => `${field} → ${column}`);
+	return {
+		name,
+		ok: missing.length === 0,
+		detail: missing.length === 0 ? `Mapped ${Object.keys(fields).length} field(s) from a real "${resolved.source.entity}" row.` : `Row from "${resolved.source.entity}" is missing mapped column(s): ${missing.join(", ")}.`
+	};
+}
+//#endregion
 //#region ../sdk/src/namespace-probe.ts
 /**
 * Verify the tables the integration depends on are genuinely reachable:
@@ -169,6 +298,11 @@ async function namespaceCheck(config) {
 		detail: probeResult.reachable ? "All required source tables are reachable." : probeResult.error?.message ?? "namespace unreachable"
 	};
 }
+async function mappingDryRunChecks(config) {
+	const checks = [];
+	for (const entityKey of Object.keys(config.entities?.entities ?? {})) checks.push(await runMappingDryRun(config, entityKey));
+	return checks;
+}
 /**
 * Run the read-only setup checks and return a structured report. Every check
 * captures its own error into `detail` rather than throwing, so one failure never
@@ -195,6 +329,7 @@ async function runDoctor(args) {
 		ok: sources.length > 0,
 		detail: sources.length > 0 ? `${sources.length} source(s) to mirror.` : "No `source.contacts` — nothing to sync."
 	});
+	checks.push(checkConceptCoverage(config));
 	for (const source of sources) {
 		const meta = source[require_drizzle_meta.DRIZZLE_META];
 		if (!meta) {
@@ -233,6 +368,7 @@ async function runDoctor(args) {
 			detail: describeFetchError(source.entity, error)
 		});
 	}
+	checks.push(...await mappingDryRunChecks(config));
 	const result = await connect();
 	checks.push({
 		name: "Heartbeat",
@@ -276,6 +412,7 @@ async function syncSource(args) {
 	const idField = source.idField ?? DEFAULT_ID_FIELD;
 	let cursor = since;
 	let pushed = 0;
+	const resumedFrom = since === null ? null : since.time.toISOString();
 	for (;;) {
 		const rows = await source.fetchPage({
 			since: cursor,
@@ -287,6 +424,8 @@ async function syncSource(args) {
 			source: source.entity,
 			rows: capped,
 			mode: "delta",
+			fetched: rows.length,
+			cursor: resumedFrom,
 			...objectType ? { objectType } : {}
 		})) return {
 			pushed,
@@ -329,6 +468,8 @@ async function fullSyncSource(args) {
 		source: source.entity,
 		rows: all,
 		mode: "full",
+		fetched: all.length,
+		cursor: null,
 		...objectType ? { objectType } : {}
 	});
 	return {
@@ -708,31 +849,25 @@ function createFetcher(retry) {
 		}
 	};
 }
+const CONCEPT_PATHS = {
+	contacts: SYNC_CONTACTS_PATH,
+	companies: SYNC_COMPANIES_PATH,
+	deals: SYNC_DEALS_PATH,
+	custom: SYNC_CUSTOM_PATH
+};
 function resolveSampleSource(config, entityKey) {
-	const entity = config.entities?.entities?.[entityKey];
-	const src = config.source;
-	if (!(entity && src)) return null;
-	if (entity.concept === "contact" && src.contacts) return {
-		source: src.contacts,
-		path: SYNC_CONTACTS_PATH
-	};
-	if (entity.concept === "company" && src.companies) return {
-		source: src.companies,
-		path: SYNC_COMPANIES_PATH
-	};
-	if (entity.concept === "deal" && src.deals) return {
-		source: src.deals,
-		path: SYNC_DEALS_PATH
+	const resolved = resolveEntitySource(config, entityKey);
+	if (!resolved) return null;
+	const path = CONCEPT_PATHS[resolved.expectedKey];
+	if (!path) return null;
+	return resolved.expectedKey === "custom" ? {
+		source: resolved.source,
+		path,
+		objectType: resolved.source.objectType
+	} : {
+		source: resolved.source,
+		path
 	};
-	if (entity.concept === "custom") {
-		const custom = (src.custom ?? []).find((c) => c.entity === entity.source || c.entity === entityKey);
-		return custom ? {
-			source: custom,
-			path: SYNC_CUSTOM_PATH,
-			objectType: custom.objectType
-		} : null;
-	}
-	return null;
 }
 const PREVIEW_LIMIT = 5;
 function resolvePreviewSource(config, sourceTable) {

package/sdk.cjs

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

package/sdk.mjs

@@ -1,3 +1,3 @@
 import { o as defineClivlyConfig } from "./entity-config-va2bkH5o.mjs";
-import { a as ClivlyRateLimitError, i as ClivlyNetworkError, n as ClivlyAuthError, o as createChatSessionHandler, r as ClivlyError, t as createClivlySDK } from "./sdk-C_1sGiH8.mjs";
+import { a as ClivlyRateLimitError, i as ClivlyNetworkError, n as ClivlyAuthError, o as createChatSessionHandler, r as ClivlyError, t as createClivlySDK } from "./sdk-C6WANW8M.mjs";
 export { ClivlyAuthError, ClivlyError, ClivlyNetworkError, ClivlyRateLimitError, createChatSessionHandler, createClivlySDK, defineClivlyConfig };