clivly 0.9.6 → 0.9.7

package/{entity-config-DE30_RpU.cjs → entity-config-CPM-Tp-d.cjs}

@@ -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 require_projection.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: require_projection.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;

package/index.cjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_entity_config = require("./entity-config-DE30_RpU.cjs");
+const require_entity_config = require("./entity-config-CPM-Tp-d.cjs");
 require("./mapping-score-CaB3F4Uu.cjs");
 const require_internal_entity_heuristics = require("./internal-entity-heuristics.cjs");
-const require_sdk = require("./sdk-w8Kv_XnW.cjs");
+const require_sdk = require("./sdk-BL9BCzyD.cjs");
 let node_child_process = require("node:child_process");
 let node_fs = require("node:fs");
 let node_module = require("node:module");
@@ -1871,6 +1871,7 @@ function renderImports(plan) {
 		"import { createClivlySDK, defineClivlyConfig } from \"clivly/sdk\";",
 		"import { fromDrizzle } from \"clivly/drizzle\";",
 		"import { discoverFromDrizzle } from \"clivly/drizzle\";",
+		"import { drizzleIntrospector } from \"clivly/drizzle\";",
 		`import * as schema from "${plan.importPath}";`
 	];
 	if (plan.db === null) {
@@ -1903,6 +1904,9 @@ export default createClivlySDK({
   // Every table in your Drizzle schema, so the Clivly dashboard can offer them
   // all when you add a mapping — not just the ones wired up as sources below.
   schema: discoverFromDrizzle(schema),
+  // Lets derived objects authored in the dashboard run against this database.
+  // Without it they are fetched, validated and then skipped.
+  introspector: drizzleIntrospector(${dbExpr}),
   source: {
     // Keyed by CRM concept — contacts/companies/deals/custom.
     // NOT by your entity key. The entity's own \`source:\` above is a table name.
@@ -3201,6 +3205,32 @@ const STATUS_STAGES = [
 		}
 	},
 	sdkChecksStage,
+	{
+		id: "derived-objects",
+		label: "Dashboard-authored objects",
+		needs: [configStage.id],
+		run(ctx) {
+			const remote = ctx.sdk?.describeRemoteProjections?.();
+			if (!remote) return Promise.resolve({
+				state: "skip",
+				detail: "This app's installed clivly predates dashboard-authored objects."
+			});
+			if (!remote.capable) return Promise.resolve({
+				state: "warn",
+				detail: "Objects authored in the dashboard cannot run against this app.",
+				hint: "Add `introspector: drizzleIntrospector(db)` to clivly.config.ts."
+			});
+			if (!remote.ran) return Promise.resolve({
+				state: "pass",
+				detail: "Ready; no sync has run in this process yet."
+			});
+			const broken = remote.invalid + remote.failed;
+			return Promise.resolve({
+				state: broken > 0 ? "warn" : "pass",
+				detail: broken > 0 ? `${remote.ok} running, ${broken} not — open the object in Clivly for the reason.` : `${remote.ok} running.`
+			});
+		}
+	},
 	triggerUrlStage
 ];
 function defaultLoadSdk(path) {
@@ -3254,7 +3284,8 @@ const ALIAS_STAGE_IDS = {
 		"config",
 		"runtime",
 		"boot-hook",
-		"setup-checks"
+		"setup-checks",
+		"derived-objects"
 	],
 	connect: [
 		"api-key",

package/index.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { t as CANONICAL_FIELDS } from "./entity-config-CusbTOJ1.mjs";
+import { t as CANONICAL_FIELDS } from "./entity-config-C8IIkrmX.mjs";
 import "./mapping-score-C68uAqGB.mjs";
 import { matchesConcept, requiredFieldsFor, scoreFieldMap, scoreRelationships, suggestCursorField, toFieldMap } from "./internal-entity-heuristics.mjs";
-import { s as isPlaceholderUrl, t as createClivlySDK } from "./sdk-Dkq6ELkf.mjs";
+import { s as isPlaceholderUrl, t as createClivlySDK } from "./sdk-CubnsyD9.mjs";
 import { createRequire } from "node:module";
 import { spawn } from "node:child_process";
 import { accessSync, constants, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, statSync, watch, writeFileSync } from "node:fs";
@@ -1870,6 +1870,7 @@ function renderImports(plan) {
 		"import { createClivlySDK, defineClivlyConfig } from \"clivly/sdk\";",
 		"import { fromDrizzle } from \"clivly/drizzle\";",
 		"import { discoverFromDrizzle } from \"clivly/drizzle\";",
+		"import { drizzleIntrospector } from \"clivly/drizzle\";",
 		`import * as schema from "${plan.importPath}";`
 	];
 	if (plan.db === null) {
@@ -1902,6 +1903,9 @@ export default createClivlySDK({
   // Every table in your Drizzle schema, so the Clivly dashboard can offer them
   // all when you add a mapping — not just the ones wired up as sources below.
   schema: discoverFromDrizzle(schema),
+  // Lets derived objects authored in the dashboard run against this database.
+  // Without it they are fetched, validated and then skipped.
+  introspector: drizzleIntrospector(${dbExpr}),
   source: {
     // Keyed by CRM concept — contacts/companies/deals/custom.
     // NOT by your entity key. The entity's own \`source:\` above is a table name.
@@ -3200,6 +3204,32 @@ const STATUS_STAGES = [
 		}
 	},
 	sdkChecksStage,
+	{
+		id: "derived-objects",
+		label: "Dashboard-authored objects",
+		needs: [configStage.id],
+		run(ctx) {
+			const remote = ctx.sdk?.describeRemoteProjections?.();
+			if (!remote) return Promise.resolve({
+				state: "skip",
+				detail: "This app's installed clivly predates dashboard-authored objects."
+			});
+			if (!remote.capable) return Promise.resolve({
+				state: "warn",
+				detail: "Objects authored in the dashboard cannot run against this app.",
+				hint: "Add `introspector: drizzleIntrospector(db)` to clivly.config.ts."
+			});
+			if (!remote.ran) return Promise.resolve({
+				state: "pass",
+				detail: "Ready; no sync has run in this process yet."
+			});
+			const broken = remote.invalid + remote.failed;
+			return Promise.resolve({
+				state: broken > 0 ? "warn" : "pass",
+				detail: broken > 0 ? `${remote.ok} running, ${broken} not — open the object in Clivly for the reason.` : `${remote.ok} running.`
+			});
+		}
+	},
 	triggerUrlStage
 ];
 function defaultLoadSdk(path) {
@@ -3253,7 +3283,8 @@ const ALIAS_STAGE_IDS = {
 		"config",
 		"runtime",
 		"boot-hook",
-		"setup-checks"
+		"setup-checks",
+		"derived-objects"
 	],
 	connect: [
 		"api-key",

package/{internal-BQ47iN6f.cjs → internal-BLKMnIIZ.cjs}

@@ -1,5 +1,5 @@
 const require_projection = require("./projection-DEwL-D8R.cjs");
-const require_entity_config = require("./entity-config-DE30_RpU.cjs");
+const require_entity_config = require("./entity-config-CPM-Tp-d.cjs");
 //#region ../core/src/projection-draft.ts
 function emptyProjectionDraft(baseTable) {
 	return {

package/{internal-ChufvXE6.mjs → internal-BpVh_J77.mjs}

@@ -1,5 +1,5 @@
 import { i as identityRefs, n as PROJECTION_KEY_MESSAGE, r as PROJECTION_KEY_PATTERN, t as BASE_REF } from "./projection-hnPSgH6G.mjs";
-import { h as fanOutJoins, m as validateProjection } from "./entity-config-CusbTOJ1.mjs";
+import { h as fanOutJoins, m as validateProjection } from "./entity-config-C8IIkrmX.mjs";
 //#region ../core/src/projection-draft.ts
 function emptyProjectionDraft(baseTable) {
 	return {

package/internal-drizzle.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_drizzle = require("./drizzle-bfjVzYR6.cjs");
+const require_drizzle = require("./drizzle-DcB7OfBp.cjs");
 exports.buildColumnsMeta = require_drizzle.buildColumnsMeta;
 exports.buildUniqueConstraints = require_drizzle.buildUniqueConstraints;
 exports.discoverFromDrizzle = require_drizzle.discoverFromDrizzle;

package/internal-drizzle.d.cts

@@ -1,2 +1,2 @@
-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";
 export { buildColumnsMeta, buildUniqueConstraints, discoverFromDrizzle };

package/internal-drizzle.d.mts

@@ -1,2 +1,2 @@
-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";
 export { buildColumnsMeta, buildUniqueConstraints, discoverFromDrizzle };

package/internal-drizzle.mjs

@@ -1,2 +1,2 @@
-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";
 export { buildColumnsMeta, buildUniqueConstraints, discoverFromDrizzle };

package/internal-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");
 exports.CANONICAL_FIELDS = require_entity_config.CANONICAL_FIELDS;
 exports.CRM_CONCEPTS = require_entity_config.CRM_CONCEPTS;
 exports.CUSTOM_CONCEPT = require_entity_config.CUSTOM_CONCEPT;

package/internal-entity-config.mjs

@@ -1,2 +1,2 @@
-import { a as MATERIALIZING_CONCEPTS, c as entitiesConfigSchema, d as relationshipSchema, f as relationshipsSchema, i as ClivlyConfigError, l as filterSchema, n as CRM_CONCEPTS, o as customObjectDeclarations, p as validateEntitiesConfig, r as CUSTOM_CONCEPT, s as defineClivlyConfig, t as CANONICAL_FIELDS, u as projectionFields } from "./entity-config-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";
 export { CANONICAL_FIELDS, CRM_CONCEPTS, CUSTOM_CONCEPT, ClivlyConfigError, MATERIALIZING_CONCEPTS, customObjectDeclarations, defineClivlyConfig, entitiesConfigSchema, filterSchema, projectionFields, relationshipSchema, relationshipsSchema, validateEntitiesConfig };

package/internal-entity-heuristics.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_entity_config = require("./entity-config-DE30_RpU.cjs");
+const require_entity_config = require("./entity-config-CPM-Tp-d.cjs");
 const require_mapping_score = require("./mapping-score-CaB3F4Uu.cjs");
 //#region ../core/src/entity-heuristics.ts
 const TARGET_CONCEPTS = [

package/internal-entity-heuristics.mjs

@@ -1,4 +1,4 @@
-import { a as MATERIALIZING_CONCEPTS } from "./entity-config-CusbTOJ1.mjs";
+import { a as MATERIALIZING_CONCEPTS } from "./entity-config-C8IIkrmX.mjs";
 import { a as W, c as isTextLike, i as RELATIONSHIP_TIERS, l as isTimestampLike, n as CONCEPT_TIERS, o as isAmbiguous, r as FIELD_TIERS, s as isNumericLike, u as tierFor } from "./mapping-score-C68uAqGB.mjs";
 //#region ../core/src/entity-heuristics.ts
 const TARGET_CONCEPTS = [

package/internal-mappings-config.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_mappings_config = require("./mappings-config-CjCmT-aU.cjs");
+const require_mappings_config = require("./mappings-config-CBwL3FVh.cjs");
 exports.entitiesToMappings = require_mappings_config.entitiesToMappings;
 exports.mappingsToEntitiesConfig = require_mappings_config.mappingsToEntitiesConfig;

package/internal-mappings-config.mjs

@@ -1,2 +1,2 @@
-import { n as mappingsToEntitiesConfig, t as entitiesToMappings } from "./mappings-config-7qQ47p9K.mjs";
+import { n as mappingsToEntitiesConfig, t as entitiesToMappings } from "./mappings-config-DUKBe6OS.mjs";
 export { entitiesToMappings, mappingsToEntitiesConfig };

package/internal.cjs

@@ -1,10 +1,10 @@
 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_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");

package/internal.mjs

@@ -1,9 +1,9 @@
 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 { _ 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";

package/{mappings-config-CjCmT-aU.cjs → mappings-config-CBwL3FVh.cjs}

@@ -1,4 +1,4 @@
-const require_entity_config = require("./entity-config-DE30_RpU.cjs");
+const require_entity_config = require("./entity-config-CPM-Tp-d.cjs");
 //#region ../core/src/mappings-config.ts
 const RESERVED_FIELD = "id";
 /**

package/{mappings-config-7qQ47p9K.mjs → mappings-config-DUKBe6OS.mjs}

@@ -1,4 +1,4 @@
-import { t as CANONICAL_FIELDS } from "./entity-config-CusbTOJ1.mjs";
+import { t as CANONICAL_FIELDS } from "./entity-config-C8IIkrmX.mjs";
 //#region ../core/src/mappings-config.ts
 const RESERVED_FIELD = "id";
 /**

package/{namespace-probe-Ckn9yJ6F.d.mts → namespace-probe-BQ4imnV7.d.mts}

@@ -354,6 +354,17 @@ interface SyncTriggerDescription {
    */
   resolved?: string;
 }
+/** @see ClivlySDK.describeRemoteProjections */
+interface RemoteProjectionsDescription {
+  /** False when no `introspector` is configured — nothing can run. */
+  capable: boolean;
+  failed: number;
+  invalid: number;
+  ok: number;
+  /** False until a sync has run in this process. */
+  ran: boolean;
+  skipped: number;
+}
 interface ClivlySDK {
   /**
    * Send a single heartbeat and report the outcome richly: `ok`, the HTTP
@@ -389,6 +400,15 @@ interface ClivlySDK {
    * anyone who can reach it — set a secret if it's publicly routable.
    */
   createClivlyHandler(): (req: Request) => Promise<Response>;
+  /**
+   * What this app would tell Clivly about dashboard-authored derived objects,
+   * right now. Counts rather than the outcomes themselves: this reports
+   * health, and the per-object reasons already travel to the dashboard, which
+   * is where an author fixes them.
+   *
+   * Read by `clivly status`.
+   */
+  describeRemoteProjections(): RemoteProjectionsDescription;
   /**
    * What this app would tell Clivly about its sync trigger route, right now.
    *
@@ -477,6 +497,26 @@ interface ClivlySDK {
 interface NamespaceIntrospector {
   /** All base table names in the reachable schema. */
   listTables(): Promise<string[]>;
+  /**
+   * Build a runnable sync source from a projection, for derived objects
+   * authored in the dashboard rather than in `clivly.config.ts`.
+   *
+   * Optional for the same reason `runProjection` is: an introspector may be
+   * hand-written. Absent, remote projections report `skipped` with a reason
+   * naming this method, rather than failing the run.
+   *
+   * This is deliberately the only route to a database handle for remote
+   * projections. `drizzleIntrospector(db)` already closes over the
+   * connection, so `introspector:` is the single config line that turns
+   * dashboard-authored objects on — and the SDK core never holds a raw
+   * client.
+   */
+  projectionSource?(projection: ProjectionMapping, opts: {
+    basePkColumn?: string;
+    objectType: string;
+  }): SyncSource & {
+    objectType: string;
+  };
   /**
    * Read a few rows through an unsaved projection, for the dashboard's derived
    * object preview. Rows are keyed by field name.
@@ -498,4 +538,4 @@ interface NamespaceIntrospector {
   sampleSelect(table: string): Promise<void>;
 }
 //#endregion
-export { SyncSource as _, ClivlyConnectResult as a, ClivlyUser as c, DiscoveredTable as d, DoctorCheck as f, EnsuredObjectTypeResult as g, EnsuredMappingResult as h, ClivlyConnectReason as i, CreateChatSessionHandlerOptions as l, EnsureSchemaResult as m, ChatSessionRequestBody as n, ClivlySDK as o, DoctorReport as p, ChatWidgetVisitor as r, ClivlySDKConfig as s, NamespaceIntrospector as t, CursorStore as u, SyncTriggerDescription as v };
+export { RemoteProjectionsDescription as _, ClivlyConnectResult as a, ClivlyUser as c, DiscoveredTable as d, DoctorCheck as f, EnsuredObjectTypeResult as g, EnsuredMappingResult as h, ClivlyConnectReason as i, CreateChatSessionHandlerOptions as l, EnsureSchemaResult as m, ChatSessionRequestBody as n, ClivlySDK as o, DoctorReport as p, ChatWidgetVisitor as r, ClivlySDKConfig as s, NamespaceIntrospector as t, CursorStore as u, SyncSource as v, SyncTriggerDescription as y };

package/{namespace-probe-DaTJINS-.d.cts → namespace-probe-DZIGdvlm.d.cts}

@@ -354,6 +354,17 @@ interface SyncTriggerDescription {
    */
   resolved?: string;
 }
+/** @see ClivlySDK.describeRemoteProjections */
+interface RemoteProjectionsDescription {
+  /** False when no `introspector` is configured — nothing can run. */
+  capable: boolean;
+  failed: number;
+  invalid: number;
+  ok: number;
+  /** False until a sync has run in this process. */
+  ran: boolean;
+  skipped: number;
+}
 interface ClivlySDK {
   /**
    * Send a single heartbeat and report the outcome richly: `ok`, the HTTP
@@ -389,6 +400,15 @@ interface ClivlySDK {
    * anyone who can reach it — set a secret if it's publicly routable.
    */
   createClivlyHandler(): (req: Request) => Promise<Response>;
+  /**
+   * What this app would tell Clivly about dashboard-authored derived objects,
+   * right now. Counts rather than the outcomes themselves: this reports
+   * health, and the per-object reasons already travel to the dashboard, which
+   * is where an author fixes them.
+   *
+   * Read by `clivly status`.
+   */
+  describeRemoteProjections(): RemoteProjectionsDescription;
   /**
    * What this app would tell Clivly about its sync trigger route, right now.
    *
@@ -477,6 +497,26 @@ interface ClivlySDK {
 interface NamespaceIntrospector {
   /** All base table names in the reachable schema. */
   listTables(): Promise<string[]>;
+  /**
+   * Build a runnable sync source from a projection, for derived objects
+   * authored in the dashboard rather than in `clivly.config.ts`.
+   *
+   * Optional for the same reason `runProjection` is: an introspector may be
+   * hand-written. Absent, remote projections report `skipped` with a reason
+   * naming this method, rather than failing the run.
+   *
+   * This is deliberately the only route to a database handle for remote
+   * projections. `drizzleIntrospector(db)` already closes over the
+   * connection, so `introspector:` is the single config line that turns
+   * dashboard-authored objects on — and the SDK core never holds a raw
+   * client.
+   */
+  projectionSource?(projection: ProjectionMapping, opts: {
+    basePkColumn?: string;
+    objectType: string;
+  }): SyncSource & {
+    objectType: string;
+  };
   /**
    * Read a few rows through an unsaved projection, for the dashboard's derived
    * object preview. Rows are keyed by field name.
@@ -498,4 +538,4 @@ interface NamespaceIntrospector {
   sampleSelect(table: string): Promise<void>;
 }
 //#endregion
-export { SyncSource as _, ClivlyConnectResult as a, ClivlyUser as c, DiscoveredTable as d, DoctorCheck as f, EnsuredObjectTypeResult as g, EnsuredMappingResult as h, ClivlyConnectReason as i, CreateChatSessionHandlerOptions as l, EnsureSchemaResult as m, ChatSessionRequestBody as n, ClivlySDK as o, DoctorReport as p, ChatWidgetVisitor as r, ClivlySDKConfig as s, NamespaceIntrospector as t, CursorStore as u, SyncTriggerDescription as v };
+export { RemoteProjectionsDescription as _, ClivlyConnectResult as a, ClivlyUser as c, DiscoveredTable as d, DoctorCheck as f, EnsuredObjectTypeResult as g, EnsuredMappingResult as h, ClivlyConnectReason as i, CreateChatSessionHandlerOptions as l, EnsureSchemaResult as m, ChatSessionRequestBody as n, ClivlySDK as o, DoctorReport as p, ChatWidgetVisitor as r, ClivlySDKConfig as s, NamespaceIntrospector as t, CursorStore as u, SyncSource as v, SyncTriggerDescription as y };

package/package.json

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