clivly 0.9.6 → 0.9.7

package/README.md

@@ -92,6 +92,12 @@ empty, for you or `clivly login` to fill; the trigger URL gets a visible
 `https://<yourDomain.com>/api/clivly/tick` template, because there the shape is
 the documentation.
 
+From `0.9.7` the scaffolded config also sets `introspector:
+drizzleIntrospector(db)`. Clivly never connects to your database, so that handle
+is what lets your app run a **derived object** authored in Clivly's dashboard —
+scaffolding it by default is what makes such an object sync with no further code
+on your side. It costs nothing if you never author one.
+
 | Flag | Purpose |
 | --- | --- |
 | `--dry-run` | Show what would be written; write nothing |
@@ -268,7 +274,7 @@ It answers two questions under two headings:
   scope; `clivly doctor` is local by definition and omits it.
 - **This project** — the local ladder, run here on your machine: credential →
   Clivly reachable → `clivly.config` loads → `clivly.config` is edge-safe →
-  boot hook wired → setup checks → sync trigger URL.
+  boot hook wired → setup checks → dashboard-authored objects → sync trigger URL.
 
 ```text
 Clivly status
@@ -281,11 +287,17 @@ Workspace
   🔒 Let Clivly start a sync
 
 This project
-  ✅ Step 1 of 7 · API key present
-  ✅ Step 2 of 7 · Clivly reachable — Acme
+  ✅ Step 1 of 8 · API key present
+  ✅ Step 2 of 8 · Clivly reachable — Acme
   ...
 ```
 
+**Dashboard-authored objects** is new in `0.9.7`. It reports how many derived
+objects authored in Clivly ran on the last sync and how many were quarantined —
+and, when your config has no `introspector`, warns that such objects cannot run
+at all here and names the one line to add. An app whose installed `clivly`
+predates the feature reports nothing rather than a failure.
+
 **Boot hook wired** is the rung to know about. It finds the boot site for your
 framework and confirms something there actually starts Clivly — and on Next.js
 below 15, that `experimental.instrumentationHook` is set in `next.config`,

package/core-auth-adapter.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
 const require_auth_adapter = require("./auth-adapter-CiEXcweZ.cjs");
+const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
 require("./internal-auth-adapter.cjs");
 //#region src/core-auth-adapter.ts
 require_deprecate_subpath.warnDeprecatedSubpath("clivly/core/auth-adapter", "clivly/internal/auth-adapter");

package/core-auth-adapter.mjs

@@ -1,5 +1,5 @@
-import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
 import { t as authCustom } from "./auth-adapter-gfVDxf3d.mjs";
+import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
 import "./internal-auth-adapter.mjs";
 //#region src/core-auth-adapter.ts
 warnDeprecatedSubpath("clivly/core/auth-adapter", "clivly/internal/auth-adapter");

package/core-drizzle.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
-const require_drizzle = require("./drizzle-bfjVzYR6.cjs");
+const require_drizzle = require("./drizzle-DcB7OfBp.cjs");
 require("./internal-drizzle.cjs");
 //#region src/core-drizzle.ts
 require_deprecate_subpath.warnDeprecatedSubpath("clivly/core/drizzle", "clivly/internal/drizzle");

package/core-drizzle.d.cts

@@ -1,3 +1,3 @@
-import { n as buildUniqueConstraints, r as discoverFromDrizzle, t as buildColumnsMeta } from "./drizzle-DEtRrqtc.cjs";
+import { n as buildUniqueConstraints, r as discoverFromDrizzle, t as buildColumnsMeta } from "./drizzle-ixVV4pPN.cjs";
 import "./internal-drizzle.cjs";
 export { buildColumnsMeta, buildUniqueConstraints, discoverFromDrizzle };

package/core-drizzle.d.mts

@@ -1,3 +1,3 @@
-import { n as buildUniqueConstraints, r as discoverFromDrizzle, t as buildColumnsMeta } from "./drizzle-CiK8MMEZ.mjs";
+import { n as buildUniqueConstraints, r as discoverFromDrizzle, t as buildColumnsMeta } from "./drizzle-BmDDgAIF.mjs";
 import "./internal-drizzle.mjs";
 export { buildColumnsMeta, buildUniqueConstraints, discoverFromDrizzle };

package/core-drizzle.mjs

@@ -1,5 +1,5 @@
 import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
-import { n as buildUniqueConstraints, r as discoverFromDrizzle, t as buildColumnsMeta } from "./drizzle-3kvhkwO7.mjs";
+import { n as buildUniqueConstraints, r as discoverFromDrizzle, t as buildColumnsMeta } from "./drizzle-wbcuG-cy.mjs";
 import "./internal-drizzle.mjs";
 //#region src/core-drizzle.ts
 warnDeprecatedSubpath("clivly/core/drizzle", "clivly/internal/drizzle");

package/core-entity-config.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_entity_config = require("./entity-config-DE30_RpU.cjs");
+const require_entity_config = require("./entity-config-CPM-Tp-d.cjs");
 //#region src/core-entity-config.ts
 require("./deprecate-subpath-B9ngvizt.cjs").warnDeprecatedSubpath("clivly/core/entity-config", "clivly/internal/entity-config");
 //#endregion

package/core-entity-config.mjs

@@ -1,4 +1,4 @@
-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-CusbTOJ1.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-C8IIkrmX.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");

package/core-mapping-form.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
 const require_mapping_form = require("./mapping-form-BpfON_ME.cjs");
+const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
 require("./internal-mapping-form.cjs");
 //#region src/core-mapping-form.ts
 require_deprecate_subpath.warnDeprecatedSubpath("clivly/core/mapping-form", "clivly/internal/mapping-form");

package/core-mapping-form.mjs

@@ -1,5 +1,5 @@
-import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
 import { n as buildRelationships, r as relationshipViaSignature, t as buildFilterFromDiscriminator } from "./mapping-form-DigkuvFc.mjs";
+import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
 import "./internal-mapping-form.mjs";
 //#region src/core-mapping-form.ts
 warnDeprecatedSubpath("clivly/core/mapping-form", "clivly/internal/mapping-form");

package/core-mappings-config.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_mappings_config = require("./mappings-config-CjCmT-aU.cjs");
+const require_mappings_config = require("./mappings-config-CBwL3FVh.cjs");
 const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
 require("./internal-mappings-config.cjs");
 //#region src/core-mappings-config.ts

package/core-mappings-config.mjs

@@ -1,4 +1,4 @@
-import { n as mappingsToEntitiesConfig, t as entitiesToMappings } from "./mappings-config-7qQ47p9K.mjs";
+import { n as mappingsToEntitiesConfig, t as entitiesToMappings } from "./mappings-config-DUKBe6OS.mjs";
 import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
 import "./internal-mappings-config.mjs";
 //#region src/core-mappings-config.ts

package/core-sync-engine.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
 const require_sync_engine = require("./sync-engine-BLgwLpR6.cjs");
+const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
 require("./internal-sync-engine.cjs");
 //#region src/core-sync-engine.ts
 require_deprecate_subpath.warnDeprecatedSubpath("clivly/core/sync-engine", "clivly/internal/sync-engine");

package/core-sync-engine.mjs

@@ -1,5 +1,5 @@
-import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
 import { i as runSync, n as previewSync, r as reconcile, t as computeSampleWarnings } from "./sync-engine-B_IzoUSx.mjs";
+import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
 import "./internal-sync-engine.mjs";
 //#region src/core-sync-engine.ts
 warnDeprecatedSubpath("clivly/core/sync-engine", "clivly/internal/sync-engine");

package/core-view-compiler.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
 const require_view_compiler = require("./view-compiler-BHI5E4QI.cjs");
+const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
 require("./internal-view-compiler.cjs");
 //#region src/core-view-compiler.ts
 require_deprecate_subpath.warnDeprecatedSubpath("clivly/core/view-compiler", "clivly/internal/view-compiler");

package/core-view-compiler.mjs

@@ -1,5 +1,5 @@
-import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
 import { a as explainViewExecutionError, i as explainEntitiesConfig, n as compileEntityView, r as compileEntityViews, t as DEFAULT_VIEW_PREFIX } from "./view-compiler-D_6gfXFr.mjs";
+import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
 import "./internal-view-compiler.mjs";
 //#region src/core-view-compiler.ts
 warnDeprecatedSubpath("clivly/core/view-compiler", "clivly/internal/view-compiler");

package/core.cjs

@@ -1,16 +1,15 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_projection = require("./projection-DEwL-D8R.cjs");
-const require_entity_config = require("./entity-config-DE30_RpU.cjs");
-const require_mappings_config = require("./mappings-config-CjCmT-aU.cjs");
-const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
+const require_entity_config = require("./entity-config-CPM-Tp-d.cjs");
+const require_mappings_config = require("./mappings-config-CBwL3FVh.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-BQ47iN6f.cjs");
+const require_internal = require("./internal-BLKMnIIZ.cjs");
 const require_projection_sql = require("./projection-sql-iHy-Cx6V.cjs");
 const require_view_compiler = require("./view-compiler-BHI5E4QI.cjs");
 const require_sync_engine = require("./sync-engine-BLgwLpR6.cjs");
 //#region src/core.ts
-require_deprecate_subpath.warnDeprecatedSubpath("clivly/core", "clivly/sdk", "Import \"defineClivlyConfig\" and its config types from \"clivly/sdk\"; import everything else from \"clivly/internal\" (no stability guarantee — see STABILITY.md).");
+require("./deprecate-subpath-B9ngvizt.cjs").warnDeprecatedSubpath("clivly/core", "clivly/sdk", "Import \"defineClivlyConfig\" and its config types from \"clivly/sdk\"; import everything else from \"clivly/internal\" (no stability guarantee — see STABILITY.md).");
 //#endregion
 exports.BASE_REF = require_projection.BASE_REF;
 exports.CANONICAL_FIELDS = require_entity_config.CANONICAL_FIELDS;

package/core.mjs

@@ -1,13 +1,13 @@
 import { a as projectionSchema, i as identityRefs, t as BASE_REF } from "./projection-hnPSgH6G.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-CusbTOJ1.mjs";
-import { n as mappingsToEntitiesConfig } from "./mappings-config-7qQ47p9K.mjs";
-import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.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-C8IIkrmX.mjs";
+import { n as mappingsToEntitiesConfig } from "./mappings-config-DUKBe6OS.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 draftToProjection, c as suggestJoinConditions, i as draftRefOptions, n as describeCardinality, o as emptyProjectionDraft, r as draftErrors, s as removeDraftJoin, t as addDraftJoin } from "./internal-ChufvXE6.mjs";
+import { a as draftToProjection, c as suggestJoinConditions, i as draftRefOptions, n as describeCardinality, o as emptyProjectionDraft, r as draftErrors, s as removeDraftJoin, t as addDraftJoin } from "./internal-BpVh_J77.mjs";
 import { a as compileProjectionPreview, i as compileProjectionJoins, n as compileProjectionFrom, o as compileProjectionSelect, r as compileProjectionIdentity, s as quoteIdent, t as PREVIEW_MAX_ROWS } from "./projection-sql-9zzTVGvf.mjs";
 import { i as explainEntitiesConfig, n as compileEntityView, r as compileEntityViews, t as DEFAULT_VIEW_PREFIX } from "./view-compiler-D_6gfXFr.mjs";
 import { i as runSync, r as reconcile } from "./sync-engine-B_IzoUSx.mjs";
+import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
 //#region src/core.ts
 warnDeprecatedSubpath("clivly/core", "clivly/sdk", "Import \"defineClivlyConfig\" and its config types from \"clivly/sdk\"; import everything else from \"clivly/internal\" (no stability guarantee — see STABILITY.md).");
 //#endregion

package/{drizzle-CiK8MMEZ.d.mts → drizzle-BmDDgAIF.d.mts}

@@ -36,6 +36,8 @@ declare function buildColumnsMeta(table: Table): DiscoveredColumnMeta[];
  * when you import this entry (`@clivly/core/drizzle`); the rest of `@clivly/core`
  * stays dependency-free.
  */
-declare function discoverFromDrizzle(schema: Record<string, unknown>): DiscoveredSchemaTable[];
+declare function discoverFromDrizzle(schema: Record<string, unknown>, options?: {
+  allowEmpty?: boolean;
+}): DiscoveredSchemaTable[];
 //#endregion
 export { buildUniqueConstraints as n, discoverFromDrizzle as r, buildColumnsMeta as t };

package/{drizzle-bfjVzYR6.cjs → drizzle-DcB7OfBp.cjs}

@@ -91,7 +91,7 @@ function buildColumnsMeta(table) {
 * when you import this entry (`@clivly/core/drizzle`); the rest of `@clivly/core`
 * stays dependency-free.
 */
-function discoverFromDrizzle(schema) {
+function discoverFromDrizzle(schema, options = {}) {
 	const tables = [];
 	for (const value of Object.values(schema)) {
 		if (!(0, drizzle_orm.is)(value, drizzle_orm.Table)) continue;
@@ -104,8 +104,16 @@ function discoverFromDrizzle(schema) {
 			...uniqueConstraints === void 0 ? {} : { uniqueConstraints }
 		});
 	}
+	if (tables.length === 0 && !options.allowEmpty) throw new Error(`discoverFromDrizzle: found no Drizzle tables in the object it was given (${describeKeys(schema)}). Import the schema module's tables directly — \`import * as schema from "./db/schema"\` — rather than a barrel or a default export, which can collapse to \`{ default }\` under ESM/CJS interop. Pass { allowEmpty: true } if an empty schema is genuinely intended.`);
 	return tables;
 }
+/** The keys actually present, so the message names what was handed over. */
+function describeKeys(schema) {
+	const keys = Object.keys(schema);
+	if (keys.length === 0) return "it was empty";
+	const shown = keys.slice(0, 5).join(", ");
+	return keys.length > 5 ? `keys: ${shown}, +${keys.length - 5} more` : `keys: ${shown}`;
+}
 //#endregion
 Object.defineProperty(exports, "buildColumnsMeta", {
 	enumerable: true,

package/{drizzle-DEtRrqtc.d.cts → drizzle-ixVV4pPN.d.cts}

@@ -36,6 +36,8 @@ declare function buildColumnsMeta(table: Table): DiscoveredColumnMeta[];
  * when you import this entry (`@clivly/core/drizzle`); the rest of `@clivly/core`
  * stays dependency-free.
  */
-declare function discoverFromDrizzle(schema: Record<string, unknown>): DiscoveredSchemaTable[];
+declare function discoverFromDrizzle(schema: Record<string, unknown>, options?: {
+  allowEmpty?: boolean;
+}): DiscoveredSchemaTable[];
 //#endregion
 export { buildUniqueConstraints as n, discoverFromDrizzle as r, buildColumnsMeta as t };

package/{drizzle-3kvhkwO7.mjs → drizzle-wbcuG-cy.mjs}

@@ -91,7 +91,7 @@ function buildColumnsMeta(table) {
 * when you import this entry (`@clivly/core/drizzle`); the rest of `@clivly/core`
 * stays dependency-free.
 */
-function discoverFromDrizzle(schema) {
+function discoverFromDrizzle(schema, options = {}) {
 	const tables = [];
 	for (const value of Object.values(schema)) {
 		if (!is(value, Table)) continue;
@@ -104,7 +104,15 @@ function discoverFromDrizzle(schema) {
 			...uniqueConstraints === void 0 ? {} : { uniqueConstraints }
 		});
 	}
+	if (tables.length === 0 && !options.allowEmpty) throw new Error(`discoverFromDrizzle: found no Drizzle tables in the object it was given (${describeKeys(schema)}). Import the schema module's tables directly — \`import * as schema from "./db/schema"\` — rather than a barrel or a default export, which can collapse to \`{ default }\` under ESM/CJS interop. Pass { allowEmpty: true } if an empty schema is genuinely intended.`);
 	return tables;
 }
+/** The keys actually present, so the message names what was handed over. */
+function describeKeys(schema) {
+	const keys = Object.keys(schema);
+	if (keys.length === 0) return "it was empty";
+	const shown = keys.slice(0, 5).join(", ");
+	return keys.length > 5 ? `keys: ${shown}, +${keys.length - 5} more` : `keys: ${shown}`;
+}
 //#endregion
 export { buildUniqueConstraints as n, discoverFromDrizzle as r, buildColumnsMeta as t };

package/drizzle.cjs

@@ -2,22 +2,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_projection = require("./projection-DEwL-D8R.cjs");
 const require_drizzle_meta = require("./drizzle-meta-Bb1JWYqf.cjs");
 const require_projection_sql = require("./projection-sql-iHy-Cx6V.cjs");
-const require_drizzle = require("./drizzle-bfjVzYR6.cjs");
+const require_drizzle = require("./drizzle-DcB7OfBp.cjs");
 let drizzle_orm = require("drizzle-orm");
-//#region ../sdk/src/projection-preview.ts
-/** `db.execute` returns either an array or `{ rows }`, depending on driver. */
-function rowsOf(result) {
-	if (Array.isArray(result)) return result;
-	const rows = result.rows;
-	if (Array.isArray(rows)) return rows;
-	throw new Error("previewProjection: db.execute() returned neither an array of rows nor { rows }.");
-}
-async function previewProjection(db, projection, opts) {
-	const client = db;
-	const { sql } = await import("drizzle-orm");
-	return rowsOf(await client.execute(sql.raw(require_projection_sql.compileProjectionPreview(projection, opts.limit))));
-}
-//#endregion
 //#region ../sdk/src/drizzle-projection.ts
 /** `<ref>.<column>` — the token `fields` carries and cloud-ingest reads. */
 function refToken(ref) {
@@ -54,10 +40,12 @@ function fromDrizzleProjection(db, projection, opts) {
 	const client = db;
 	const known = /* @__PURE__ */ new Set([require_projection.BASE_REF, ...projection.joins.map((j) => j.key)]);
 	if (projection.identity.kind === "base_pk" && projection.identity.column === void 0 && opts.basePkColumn === void 0) throw new Error(`fromDrizzleProjection: projection "${projection.entityKey}" has a base_pk identity with no column — pass { basePkColumn }.`);
-	const cursorRef = parseRef(opts.cursorField);
-	assertKnownRef(cursorRef, known, "cursorField");
 	for (const [field, binding] of Object.entries(projection.fieldBindings)) assertKnownRef(binding.from, known, `field "${field}"`);
 	const identityExpr = require_projection_sql.compileProjectionIdentity(projection, opts.basePkColumn ?? "");
+	const fromClause = [require_projection_sql.compileProjectionFrom(projection), ...require_projection_sql.compileProjectionJoins(projection)].join(" ");
+	if (opts.cursorField === void 0) return fromDrizzleProjectionByIdentity(client, projection, identityExpr, fromClause, opts);
+	const cursorRef = parseRef(opts.cursorField);
+	assertKnownRef(cursorRef, known, "cursorField");
 	const cursorToken = refToken(cursorRef);
 	const cursorExpr = `CAST(${refSql(cursorRef)} AS timestamptz)`;
 	const cursorRead = `to_char(${cursorExpr} AT TIME ZONE 'UTC', 'YYYY-MM-DD"T"HH24:MI:SS.MS"Z"')`;
@@ -69,11 +57,7 @@ function fromDrizzleProjection(db, projection, opts) {
 		emitted.add(token);
 		selectItems.push(`${refSql(binding.from)} AS ${require_projection_sql.quoteIdent(token)}`);
 	}
-	const head = [
-		`select ${selectItems.join(", ")}`,
-		require_projection_sql.compileProjectionFrom(projection),
-		...require_projection_sql.compileProjectionJoins(projection)
-	].join(" ");
+	const head = [`select ${selectItems.join(", ")}`, fromClause].join(" ");
 	return {
 		entity: opts.entity,
 		cursorField: cursorToken,
@@ -86,6 +70,49 @@ function fromDrizzleProjection(db, projection, opts) {
 		}
 	};
 }
+/**
+* The identity-only paging path `fromDrizzleProjection` takes when
+* `cursorField` is omitted. Deliberately not a generalisation of the
+* timestamp path above — it selects no timestamp cursor, pages on the
+* identity expression alone, and always reports `cursorField`/`idField` as
+* `"id"`, the alias every row carries either way.
+*/
+function fromDrizzleProjectionByIdentity(client, projection, identityExpr, fromClause, opts) {
+	const selectItems = [`${identityExpr} AS ${require_projection_sql.quoteIdent("id")}`];
+	const emitted = /* @__PURE__ */ new Set();
+	for (const binding of Object.values(projection.fieldBindings)) {
+		const token = refToken(binding.from);
+		if (emitted.has(token)) continue;
+		emitted.add(token);
+		selectItems.push(`${refSql(binding.from)} AS ${require_projection_sql.quoteIdent(token)}`);
+	}
+	const head = [`select ${selectItems.join(", ")}`, fromClause].join(" ");
+	return {
+		entity: opts.entity,
+		cursorField: "id",
+		idField: "id",
+		...opts.objectType === void 0 ? {} : { objectType: opts.objectType },
+		fetchPage: async ({ since, limit }) => {
+			const where = since ? drizzle_orm.sql` where ${drizzle_orm.sql.raw(identityExpr)} > ${since.id}` : drizzle_orm.sql``;
+			const query = drizzle_orm.sql`${drizzle_orm.sql.raw(head)}${where} order by ${drizzle_orm.sql.raw(identityExpr)} asc limit ${limit}`;
+			return normalizeRows(await client.execute(query));
+		}
+	};
+}
+//#endregion
+//#region ../sdk/src/projection-preview.ts
+/** `db.execute` returns either an array or `{ rows }`, depending on driver. */
+function rowsOf(result) {
+	if (Array.isArray(result)) return result;
+	const rows = result.rows;
+	if (Array.isArray(rows)) return rows;
+	throw new Error("previewProjection: db.execute() returned neither an array of rows nor { rows }.");
+}
+async function previewProjection(db, projection, opts) {
+	const client = db;
+	const { sql } = await import("drizzle-orm");
+	return rowsOf(await client.execute(sql.raw(require_projection_sql.compileProjectionPreview(projection, opts.limit))));
+}
 //#endregion
 //#region ../sdk/src/drizzle.ts
 function inferIdField(table) {
@@ -152,6 +179,13 @@ function drizzleIntrospector(db) {
 		},
 		runProjection(projection, opts) {
 			return previewProjection(db, projection, opts);
+		},
+		projectionSource(projection, opts) {
+			return fromDrizzleProjection(db, projection, {
+				entity: opts.objectType,
+				objectType: opts.objectType,
+				...opts.basePkColumn ? { basePkColumn: opts.basePkColumn } : {}
+			});
 		}
 	};
 }

package/drizzle.d.cts

@@ -1,6 +1,6 @@
 import { F as ProjectionRef, P as ProjectionMapping } from "./entity-config-B2RA53nw.cjs";
-import { n as buildUniqueConstraints, r as discoverFromDrizzle } from "./drizzle-DEtRrqtc.cjs";
-import { _ as SyncSource, t as NamespaceIntrospector } from "./namespace-probe-DaTJINS-.cjs";
+import { n as buildUniqueConstraints, r as discoverFromDrizzle } from "./drizzle-ixVV4pPN.cjs";
+import { t as NamespaceIntrospector, v as SyncSource } from "./namespace-probe-DZIGdvlm.cjs";
 import { Table } from "drizzle-orm";
 //#region ../sdk/src/drizzle-projection.d.ts
 /**
@@ -37,8 +37,14 @@ interface FromDrizzleProjectionOptions {
    * The column to keyset-paginate on, as a ref token (`"base.updated_at"`) or
    * a `ProjectionRef`. A projection spans several tables, so there is no
    * single table to infer a cursor from.
+   *
+   * Omit it to page by identity alone — the mode a dashboard-authored
+   * projection uses, since it has no timestamp column and no UI to nominate
+   * one. `checkIdentitySafety` (`@clivly/core`) already proves the identity
+   * uniquely identifies a row, which makes it a sound keyset cursor with no
+   * timestamp involved.
    */
-  cursorField: string | ProjectionRef;
+  cursorField?: string | ProjectionRef;
   /** The source name rows are pushed under. */
   entity: string;
   /**

package/drizzle.d.mts

@@ -1,6 +1,6 @@
 import { F as ProjectionRef, P as ProjectionMapping } from "./entity-config-B2RA53nw.mjs";
-import { n as buildUniqueConstraints, r as discoverFromDrizzle } from "./drizzle-CiK8MMEZ.mjs";
-import { _ as SyncSource, t as NamespaceIntrospector } from "./namespace-probe-Ckn9yJ6F.mjs";
+import { n as buildUniqueConstraints, r as discoverFromDrizzle } from "./drizzle-BmDDgAIF.mjs";
+import { t as NamespaceIntrospector, v as SyncSource } from "./namespace-probe-BQ4imnV7.mjs";
 import { Table } from "drizzle-orm";
 //#region ../sdk/src/drizzle-projection.d.ts
 /**
@@ -37,8 +37,14 @@ interface FromDrizzleProjectionOptions {
    * The column to keyset-paginate on, as a ref token (`"base.updated_at"`) or
    * a `ProjectionRef`. A projection spans several tables, so there is no
    * single table to infer a cursor from.
+   *
+   * Omit it to page by identity alone — the mode a dashboard-authored
+   * projection uses, since it has no timestamp column and no UI to nominate
+   * one. `checkIdentitySafety` (`@clivly/core`) already proves the identity
+   * uniquely identifies a row, which makes it a sound keyset cursor with no
+   * timestamp involved.
    */
-  cursorField: string | ProjectionRef;
+  cursorField?: string | ProjectionRef;
   /** The source name rows are pushed under. */
   entity: string;
   /**

package/drizzle.mjs

@@ -1,22 +1,8 @@
 import { t as BASE_REF } from "./projection-hnPSgH6G.mjs";
 import { t as DRIZZLE_META } from "./drizzle-meta-D-5k3n0i.mjs";
 import { a as compileProjectionPreview, i as compileProjectionJoins, n as compileProjectionFrom, r as compileProjectionIdentity, s as quoteIdent } from "./projection-sql-9zzTVGvf.mjs";
-import { n as buildUniqueConstraints, r as discoverFromDrizzle, t as buildColumnsMeta } from "./drizzle-3kvhkwO7.mjs";
+import { n as buildUniqueConstraints, r as discoverFromDrizzle, t as buildColumnsMeta } from "./drizzle-wbcuG-cy.mjs";
 import { asc, getTableColumns, getTableName, sql } from "drizzle-orm";
-//#region ../sdk/src/projection-preview.ts
-/** `db.execute` returns either an array or `{ rows }`, depending on driver. */
-function rowsOf(result) {
-	if (Array.isArray(result)) return result;
-	const rows = result.rows;
-	if (Array.isArray(rows)) return rows;
-	throw new Error("previewProjection: db.execute() returned neither an array of rows nor { rows }.");
-}
-async function previewProjection(db, projection, opts) {
-	const client = db;
-	const { sql } = await import("drizzle-orm");
-	return rowsOf(await client.execute(sql.raw(compileProjectionPreview(projection, opts.limit))));
-}
-//#endregion
 //#region ../sdk/src/drizzle-projection.ts
 /** `<ref>.<column>` — the token `fields` carries and cloud-ingest reads. */
 function refToken(ref) {
@@ -53,10 +39,12 @@ function fromDrizzleProjection(db, projection, opts) {
 	const client = db;
 	const known = /* @__PURE__ */ new Set([BASE_REF, ...projection.joins.map((j) => j.key)]);
 	if (projection.identity.kind === "base_pk" && projection.identity.column === void 0 && opts.basePkColumn === void 0) throw new Error(`fromDrizzleProjection: projection "${projection.entityKey}" has a base_pk identity with no column — pass { basePkColumn }.`);
-	const cursorRef = parseRef(opts.cursorField);
-	assertKnownRef(cursorRef, known, "cursorField");
 	for (const [field, binding] of Object.entries(projection.fieldBindings)) assertKnownRef(binding.from, known, `field "${field}"`);
 	const identityExpr = compileProjectionIdentity(projection, opts.basePkColumn ?? "");
+	const fromClause = [compileProjectionFrom(projection), ...compileProjectionJoins(projection)].join(" ");
+	if (opts.cursorField === void 0) return fromDrizzleProjectionByIdentity(client, projection, identityExpr, fromClause, opts);
+	const cursorRef = parseRef(opts.cursorField);
+	assertKnownRef(cursorRef, known, "cursorField");
 	const cursorToken = refToken(cursorRef);
 	const cursorExpr = `CAST(${refSql(cursorRef)} AS timestamptz)`;
 	const cursorRead = `to_char(${cursorExpr} AT TIME ZONE 'UTC', 'YYYY-MM-DD"T"HH24:MI:SS.MS"Z"')`;
@@ -68,11 +56,7 @@ function fromDrizzleProjection(db, projection, opts) {
 		emitted.add(token);
 		selectItems.push(`${refSql(binding.from)} AS ${quoteIdent(token)}`);
 	}
-	const head = [
-		`select ${selectItems.join(", ")}`,
-		compileProjectionFrom(projection),
-		...compileProjectionJoins(projection)
-	].join(" ");
+	const head = [`select ${selectItems.join(", ")}`, fromClause].join(" ");
 	return {
 		entity: opts.entity,
 		cursorField: cursorToken,
@@ -85,6 +69,49 @@ function fromDrizzleProjection(db, projection, opts) {
 		}
 	};
 }
+/**
+* The identity-only paging path `fromDrizzleProjection` takes when
+* `cursorField` is omitted. Deliberately not a generalisation of the
+* timestamp path above — it selects no timestamp cursor, pages on the
+* identity expression alone, and always reports `cursorField`/`idField` as
+* `"id"`, the alias every row carries either way.
+*/
+function fromDrizzleProjectionByIdentity(client, projection, identityExpr, fromClause, opts) {
+	const selectItems = [`${identityExpr} AS ${quoteIdent("id")}`];
+	const emitted = /* @__PURE__ */ new Set();
+	for (const binding of Object.values(projection.fieldBindings)) {
+		const token = refToken(binding.from);
+		if (emitted.has(token)) continue;
+		emitted.add(token);
+		selectItems.push(`${refSql(binding.from)} AS ${quoteIdent(token)}`);
+	}
+	const head = [`select ${selectItems.join(", ")}`, fromClause].join(" ");
+	return {
+		entity: opts.entity,
+		cursorField: "id",
+		idField: "id",
+		...opts.objectType === void 0 ? {} : { objectType: opts.objectType },
+		fetchPage: async ({ since, limit }) => {
+			const where = since ? sql` where ${sql.raw(identityExpr)} > ${since.id}` : sql``;
+			const query = sql`${sql.raw(head)}${where} order by ${sql.raw(identityExpr)} asc limit ${limit}`;
+			return normalizeRows(await client.execute(query));
+		}
+	};
+}
+//#endregion
+//#region ../sdk/src/projection-preview.ts
+/** `db.execute` returns either an array or `{ rows }`, depending on driver. */
+function rowsOf(result) {
+	if (Array.isArray(result)) return result;
+	const rows = result.rows;
+	if (Array.isArray(rows)) return rows;
+	throw new Error("previewProjection: db.execute() returned neither an array of rows nor { rows }.");
+}
+async function previewProjection(db, projection, opts) {
+	const client = db;
+	const { sql } = await import("drizzle-orm");
+	return rowsOf(await client.execute(sql.raw(compileProjectionPreview(projection, opts.limit))));
+}
 //#endregion
 //#region ../sdk/src/drizzle.ts
 function inferIdField(table) {
@@ -151,6 +178,13 @@ function drizzleIntrospector(db) {
 		},
 		runProjection(projection, opts) {
 			return previewProjection(db, projection, opts);
+		},
+		projectionSource(projection, opts) {
+			return fromDrizzleProjection(db, projection, {
+				entity: opts.objectType,
+				objectType: opts.objectType,
+				...opts.basePkColumn ? { basePkColumn: opts.basePkColumn } : {}
+			});
 		}
 	};
 }

package/{entity-config-CusbTOJ1.mjs → entity-config-C8IIkrmX.mjs}

@@ -137,7 +137,7 @@ function checkTablesExist(errors, projection, resolver, base) {
 		if (!hasRichMeta(table)) {
 			errors.push({
 				path,
-				message: `table "${name}" has no key/column metadata — upgrade @clivly/sdk and re-run discovery before using a projection`
+				message: `table "${name}" was discovered without column types or unique keys, which a projection needs to prove its id is unique. Redeploy or restart the app so it re-reports its schema (or run \`clivly push-schema\`); if the table is declared by hand as \`{ name, columns }\`, use \`discoverFromDrizzle\` so keys and types come with it.`
 			});
 			ok = false;
 		}
@@ -182,10 +182,27 @@ function checkRefs(errors, projection, resolver, base, basePk) {
 	for (const [field, binding] of Object.entries(projection.fieldBindings)) checkRef(errors, resolver, `${base}.projection.fieldBindings.${field}`, binding.from);
 	for (const ref of identityRefs(projection.identity, basePk)) checkRef(errors, resolver, `${base}.projection.identity`, ref);
 }
+/**
+* Prove that a single-column identity (`column`, or `base_pk` with an
+* explicit column) is actually unique.
+*
+* `coversUniqueKey` fails closed on absent metadata, same as every other
+* check in this file: a column not provably covered by a unique key is
+* rejected, never assumed safe.
+*/
+function checkSingleColumnIdentity(errors, resolver, path, ref) {
+	const table = resolver.tableFor(ref.table);
+	if (!table) return;
+	if (!coversUniqueKey(table, [ref.column])) errors.push({
+		path,
+		message: `identity column "${ref.table}.${ref.column}" is not covered by a unique key of "${table.name}" — pick a column with a unique constraint, or use a composite identity that is`
+	});
+}
 function checkIdentitySafety(errors, projection, resolver, base, baseTable) {
 	const path = `${base}.projection.identity`;
 	const pk = primaryKeyColumns(baseTable);
-	if (projection.identity.kind === "base_pk" && !projection.identity.column) {
+	const { identity } = projection;
+	if (identity.kind === "base_pk" && !identity.column) {
 		if (pk.length === 0) {
 			errors.push({
 				path,
@@ -200,9 +217,21 @@ function checkIdentitySafety(errors, projection, resolver, base, baseTable) {
 			});
 			return;
 		}
+		return;
+	}
+	if (identity.kind === "base_pk" && identity.column) {
+		checkSingleColumnIdentity(errors, resolver, path, {
+			table: BASE_REF,
+			column: identity.column
+		});
+		return;
+	}
+	if (identity.kind === "column") {
+		checkSingleColumnIdentity(errors, resolver, path, identity.from);
+		return;
 	}
-	if (projection.identity.kind !== "composite") return;
-	for (const part of projection.identity.parts) {
+	if (identity.kind !== "composite") return;
+	for (const part of identity.parts) {
 		const table = resolver.tableFor(part.table);
 		const meta = table && columnMetaFor(table, part.column);
 		if (!meta) continue;