clivly 0.9.5 → 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`,
@@ -298,6 +310,13 @@ above it fails to load. A framework the CLI does not recognise shows it as
 skipped rather than passed — there is nowhere known to look, and a green step
 for an unasked question is what made this worth adding.
 
+**Sync trigger URL** distinguishes three states, which it previously could not:
+a real URL passes, no URL at all warns, and the
+`https://<yourDomain.com>/api/clivly/tick` template that `clivly login` writes
+into `.env` reports as *still the scaffolded placeholder* — a value that is
+present but cannot resolve. Reading that as "not set" sent people hunting for a
+missing variable sitting in their own `.env`.
+
 If the Workspace section reads
 `⚠️ This Clivly server does not report setup progress`, or names a rejected key
 or an unreachable host, that means the question could not be asked — not that

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-7sGCk_nw.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-B74SPOUZ.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-CLyEg0sf.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-DQS_s4dg.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_sync_engine = require("./sync-engine-BLgwLpR6.cjs");
 const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
-const require_sync_engine = require("./sync-engine-C4A5jgA4.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 { 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 { i as runSync, n as previewSync, r as reconcile, t as computeSampleWarnings } from "./sync-engine-Dt5QQSKO.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_view_compiler = require("./view-compiler-BHI5E4QI.cjs");
 const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
-const require_view_compiler = require("./view-compiler-B5nDal14.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 { 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 { a as explainViewExecutionError, i as explainEntitiesConfig, n as compileEntityView, r as compileEntityViews, t as DEFAULT_VIEW_PREFIX } from "./view-compiler-CSYwEWf5.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-Dz6_i1-w.cjs");
-const require_entity_config = require("./entity-config-7sGCk_nw.cjs");
-const require_mappings_config = require("./mappings-config-CLyEg0sf.cjs");
-const require_deprecate_subpath = require("./deprecate-subpath-B9ngvizt.cjs");
+const require_projection = require("./projection-DEwL-D8R.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-DqduZU3l.cjs");
-const require_projection_sql = require("./projection-sql-Cl1qIn8m.cjs");
-const require_view_compiler = require("./view-compiler-B5nDal14.cjs");
-const require_sync_engine = require("./sync-engine-C4A5jgA4.cjs");
+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;
@@ -18,6 +17,8 @@ exports.CRM_CONCEPTS = require_entity_config.CRM_CONCEPTS;
 exports.ClivlyConfigError = require_entity_config.ClivlyConfigError;
 exports.DEFAULT_VIEW_PREFIX = require_view_compiler.DEFAULT_VIEW_PREFIX;
 exports.MATERIALIZING_CONCEPTS = require_entity_config.MATERIALIZING_CONCEPTS;
+exports.PREVIEW_MAX_ROWS = require_projection_sql.PREVIEW_MAX_ROWS;
+exports.addDraftJoin = require_internal.addDraftJoin;
 exports.authCustom = require_auth_adapter.authCustom;
 exports.buildFilterFromDiscriminator = require_mapping_form.buildFilterFromDiscriminator;
 exports.buildRelationships = require_mapping_form.buildRelationships;
@@ -27,10 +28,13 @@ exports.compileEntityViews = require_view_compiler.compileEntityViews;
 exports.compileProjectionFrom = require_projection_sql.compileProjectionFrom;
 exports.compileProjectionIdentity = require_projection_sql.compileProjectionIdentity;
 exports.compileProjectionJoins = require_projection_sql.compileProjectionJoins;
+exports.compileProjectionPreview = require_projection_sql.compileProjectionPreview;
+exports.compileProjectionSelect = require_projection_sql.compileProjectionSelect;
 exports.coversUniqueKey = require_entity_config.coversUniqueKey;
 exports.defineClivlyConfig = require_entity_config.defineClivlyConfig;
 exports.describeCardinality = require_internal.describeCardinality;
 exports.draftErrors = require_internal.draftErrors;
+exports.draftRefOptions = require_internal.draftRefOptions;
 exports.draftToProjection = require_internal.draftToProjection;
 exports.emptyProjectionDraft = require_internal.emptyProjectionDraft;
 exports.entitiesConfigSchema = require_entity_config.entitiesConfigSchema;
@@ -48,6 +52,7 @@ exports.reconcile = require_sync_engine.reconcile;
 exports.relationshipSchema = require_entity_config.relationshipSchema;
 exports.relationshipViaSignature = require_mapping_form.relationshipViaSignature;
 exports.relationshipsSchema = require_entity_config.relationshipsSchema;
+exports.removeDraftJoin = require_internal.removeDraftJoin;
 exports.runSync = require_sync_engine.runSync;
 exports.suggestJoinConditions = require_internal.suggestJoinConditions;
 exports.validateEntitiesConfig = require_entity_config.validateEntitiesConfig;

package/core.d.cts

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

package/core.d.mts

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

package/core.mjs

@@ -1,14 +1,14 @@
-import { i as projectionSchema, r as identityRefs, t as BASE_REF } from "./projection-CSGJbZlZ.mjs";
-import { _ as columnMetaFor, a as MATERIALIZING_CONCEPTS, b as primaryKeyColumns, c as entitiesConfigSchema, d as relationshipSchema, f as relationshipsSchema, g as joinFansOut, h as fanOutJoins, i as ClivlyConfigError, l as filterSchema, m as validateProjection, n as CRM_CONCEPTS, p as validateEntitiesConfig, s as defineClivlyConfig, t as CANONICAL_FIELDS, v as coversUniqueKey, y as hasRichMeta } from "./entity-config-B74SPOUZ.mjs";
-import { n as mappingsToEntitiesConfig } from "./mappings-config-DQS_s4dg.mjs";
-import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
+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-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 suggestJoinConditions, i as emptyProjectionDraft, n as draftErrors, r as draftToProjection, t as describeCardinality } from "./internal-CykXpEGk.mjs";
-import { a as quoteIdent, n as compileProjectionIdentity, r as compileProjectionJoins, t as compileProjectionFrom } from "./projection-sql-BgnfiGqF.mjs";
-import { i as explainEntitiesConfig, n as compileEntityView, r as compileEntityViews, t as DEFAULT_VIEW_PREFIX } from "./view-compiler-CSYwEWf5.mjs";
-import { i as runSync, r as reconcile } from "./sync-engine-Dt5QQSKO.mjs";
+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
-export { BASE_REF, CANONICAL_FIELDS, CRM_CONCEPTS, ClivlyConfigError, DEFAULT_VIEW_PREFIX, MATERIALIZING_CONCEPTS, authCustom, buildFilterFromDiscriminator, buildRelationships, columnMetaFor, compileEntityView, compileEntityViews, compileProjectionFrom, compileProjectionIdentity, compileProjectionJoins, coversUniqueKey, defineClivlyConfig, describeCardinality, draftErrors, draftToProjection, emptyProjectionDraft, entitiesConfigSchema, explainEntitiesConfig, fanOutJoins, filterSchema, hasRichMeta, identityRefs, joinFansOut, mappingsToEntitiesConfig, primaryKeyColumns, projectionSchema, quoteIdent, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, runSync, suggestJoinConditions, validateEntitiesConfig, validateProjection };
+export { BASE_REF, CANONICAL_FIELDS, CRM_CONCEPTS, ClivlyConfigError, DEFAULT_VIEW_PREFIX, MATERIALIZING_CONCEPTS, PREVIEW_MAX_ROWS, addDraftJoin, authCustom, buildFilterFromDiscriminator, buildRelationships, columnMetaFor, compileEntityView, compileEntityViews, compileProjectionFrom, compileProjectionIdentity, compileProjectionJoins, compileProjectionPreview, compileProjectionSelect, coversUniqueKey, defineClivlyConfig, describeCardinality, draftErrors, draftRefOptions, draftToProjection, emptyProjectionDraft, entitiesConfigSchema, explainEntitiesConfig, fanOutJoins, filterSchema, hasRichMeta, identityRefs, joinFansOut, mappingsToEntitiesConfig, primaryKeyColumns, projectionSchema, quoteIdent, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, removeDraftJoin, runSync, suggestJoinConditions, validateEntitiesConfig, validateProjection };

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

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_projection = require("./projection-Dz6_i1-w.cjs");
+const require_projection = require("./projection-DEwL-D8R.cjs");
 const require_drizzle_meta = require("./drizzle-meta-Bb1JWYqf.cjs");
-const require_projection_sql = require("./projection-sql-Cl1qIn8m.cjs");
-const require_drizzle = require("./drizzle-bfjVzYR6.cjs");
+const require_projection_sql = require("./projection-sql-iHy-Cx6V.cjs");
+const require_drizzle = require("./drizzle-DcB7OfBp.cjs");
 let drizzle_orm = require("drizzle-orm");
 //#region ../sdk/src/drizzle-projection.ts
 /** `<ref>.<column>` — the token `fields` carries and cloud-ingest reads. */
@@ -40,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"')`;
@@ -55,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,
@@ -72,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) {
@@ -135,6 +176,16 @@ function drizzleIntrospector(db) {
 		},
 		async sampleSelect(table) {
 			await client.execute(drizzle_orm.sql`select 1 from ${drizzle_orm.sql.identifier(table)} limit 1`);
+		},
+		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-BoGI18dQ.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-Cn7voAd0.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;
   /**