clivly 0.9.0 → 0.9.1

package/{mapping-form-43bwOTat.d.cts → mapping-form-DhY0iFmN.d.cts}

@@ -1,4 +1,4 @@
-import { _ as RelationshipVia, f as FilterExpr, v as RelationshipsMap } from "./entity-config-C4Yf_fPj.cjs";
+import { b as RelationshipsMap, m as FilterExpr, y as RelationshipVia } from "./entity-config-fKQhimtD.cjs";
 //#region ../core/src/mapping-form.d.ts
 /**
  * A relationship the mapping UI can offer or has configured, in the shape the

package/{mapping-form-DUvWUYCo.d.mts → mapping-form-Du36VZr1.d.mts}

@@ -1,4 +1,4 @@
-import { _ as RelationshipVia, f as FilterExpr, v as RelationshipsMap } from "./entity-config-C4Yf_fPj.mjs";
+import { b as RelationshipsMap, m as FilterExpr, y as RelationshipVia } from "./entity-config-fKQhimtD.mjs";
 //#region ../core/src/mapping-form.d.ts
 /**
  * A relationship the mapping UI can offer or has configured, in the shape the

package/mappings-config-B1qNM8VL.d.cts

@@ -0,0 +1,47 @@
+import { M as ProjectionMapping, a as ClivlyEntitiesConfig } from "./entity-config-fKQhimtD.cjs";
+//#region ../core/src/mappings-config.d.ts
+/**
+ * Mappings → Entity Config bridge.
+ *
+ * `crm_entity_mappings` rows are the single source of truth for how a host
+ * schema maps onto Clivly's CRM concepts. This module compiles those rows into
+ * a `ClivlyEntitiesConfig` — the contract the view compiler and sync engine
+ * consume — so the persisted mapping and the runtime pipeline never diverge.
+ *
+ * The row model has no explicit entity-key column (it's keyed by
+ * `sourceTable + targetConcept + role`), but the config's `relationships`
+ * reference other entities *by key*. This builder therefore derives a stable
+ * key per row and resolves each relationship's `entity` reference through the
+ * same derivation — so a relationship stored as `entity: "<relatedTable>"`
+ * (the shape `mappings.suggest` produces) resolves to the right entity.
+ */
+/**
+ * A persisted `crm_entity_mappings` row, narrowed to the columns the builder
+ * reads. Structurally compatible with the Drizzle row (jsonb columns typed
+ * loosely) so the API layer can pass `db.select()` results straight in.
+ */
+interface EntityMappingRow {
+  fieldMap: Record<string, string>;
+  filter?: Record<string, unknown> | null;
+  /**
+   * Advanced mapping: a base table plus explicit joins. When set, this — not
+   * `fieldMap` — is the authored source of truth, and `sourceTable` merely
+   * mirrors `projection.baseTable`.
+   */
+  projection?: ProjectionMapping | null;
+  relationships?: Record<string, unknown> | null;
+  role?: string | null;
+  sourceTable: string;
+  status?: string | null;
+  targetConcept: string;
+  targetObjectTypeId?: string | null;
+}
+/**
+ * Compile persisted mapping rows into a `ClivlyEntitiesConfig`. Only `active`
+ * rows with at least one mapped field are included; disabled/suggested rows and
+ * unmapped rows are skipped. Returns `{ entities: {} }` when nothing is
+ * eligible — a no-op the view compiler and sync engine both tolerate.
+ */
+declare function mappingsToEntitiesConfig(rows: EntityMappingRow[]): ClivlyEntitiesConfig;
+//#endregion
+export { mappingsToEntitiesConfig as n, EntityMappingRow as t };

package/mappings-config-BChZsany.d.mts

@@ -0,0 +1,47 @@
+import { M as ProjectionMapping, a as ClivlyEntitiesConfig } from "./entity-config-fKQhimtD.mjs";
+//#region ../core/src/mappings-config.d.ts
+/**
+ * Mappings → Entity Config bridge.
+ *
+ * `crm_entity_mappings` rows are the single source of truth for how a host
+ * schema maps onto Clivly's CRM concepts. This module compiles those rows into
+ * a `ClivlyEntitiesConfig` — the contract the view compiler and sync engine
+ * consume — so the persisted mapping and the runtime pipeline never diverge.
+ *
+ * The row model has no explicit entity-key column (it's keyed by
+ * `sourceTable + targetConcept + role`), but the config's `relationships`
+ * reference other entities *by key*. This builder therefore derives a stable
+ * key per row and resolves each relationship's `entity` reference through the
+ * same derivation — so a relationship stored as `entity: "<relatedTable>"`
+ * (the shape `mappings.suggest` produces) resolves to the right entity.
+ */
+/**
+ * A persisted `crm_entity_mappings` row, narrowed to the columns the builder
+ * reads. Structurally compatible with the Drizzle row (jsonb columns typed
+ * loosely) so the API layer can pass `db.select()` results straight in.
+ */
+interface EntityMappingRow {
+  fieldMap: Record<string, string>;
+  filter?: Record<string, unknown> | null;
+  /**
+   * Advanced mapping: a base table plus explicit joins. When set, this — not
+   * `fieldMap` — is the authored source of truth, and `sourceTable` merely
+   * mirrors `projection.baseTable`.
+   */
+  projection?: ProjectionMapping | null;
+  relationships?: Record<string, unknown> | null;
+  role?: string | null;
+  sourceTable: string;
+  status?: string | null;
+  targetConcept: string;
+  targetObjectTypeId?: string | null;
+}
+/**
+ * Compile persisted mapping rows into a `ClivlyEntitiesConfig`. Only `active`
+ * rows with at least one mapped field are included; disabled/suggested rows and
+ * unmapped rows are skipped. Returns `{ entities: {} }` when nothing is
+ * eligible — a no-op the view compiler and sync engine both tolerate.
+ */
+declare function mappingsToEntitiesConfig(rows: EntityMappingRow[]): ClivlyEntitiesConfig;
+//#endregion
+export { mappingsToEntitiesConfig as n, EntityMappingRow as t };

package/{mappings-config-BSSwdHiq.cjs → mappings-config-C8ynKmDK.cjs}

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

package/{mappings-config-bJQT_gSa.mjs → mappings-config-DNaYGyKN.mjs}

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

package/{namespace-probe-BSH_p9TK.d.cts → namespace-probe-BkUs8raG.d.mts}

@@ -1,4 +1,4 @@
-import { a as ClivlyEntitiesConfig } from "./entity-config-C4Yf_fPj.cjs";
+import { a as ClivlyEntitiesConfig } from "./entity-config-fKQhimtD.mjs";
 //#region ../sdk/src/drizzle-meta.d.ts
 declare const DRIZZLE_META: "__clivly_drizzle_source_meta__";
 interface DrizzleSourceMeta {

package/{namespace-probe-Dsp5uNkS.d.mts → namespace-probe-aRFmpU85.d.cts}

@@ -1,4 +1,4 @@
-import { a as ClivlyEntitiesConfig } from "./entity-config-C4Yf_fPj.mjs";
+import { a as ClivlyEntitiesConfig } from "./entity-config-fKQhimtD.cjs";
 //#region ../sdk/src/drizzle-meta.d.ts
 declare const DRIZZLE_META: "__clivly_drizzle_source_meta__";
 interface DrizzleSourceMeta {

package/package.json

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

package/sdk.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_entity_config = require("./entity-config-CsLl-ftC.cjs");
+const require_entity_config = require("./entity-config-nuXge6rY.cjs");
 const require_sdk = require("./sdk-Bj-ZDf4u.cjs");
 exports.ClivlyAuthError = require_sdk.ClivlyAuthError;
 exports.ClivlyError = require_sdk.ClivlyError;

package/sdk.d.cts

@@ -1,5 +1,5 @@
-import { a as ClivlyEntitiesConfig, y as defineClivlyConfig } from "./entity-config-C4Yf_fPj.cjs";
-import { a as ClivlyConnectResult, c as ClivlyUser, d as DiscoveredTable, f as DoctorCheck, i as ClivlyConnectReason, l as CreateChatSessionHandlerOptions, n as ChatSessionRequestBody, o as ClivlySDK, p as DoctorReport, r as ChatWidgetVisitor, s as ClivlySDKConfig, u as CursorStore } from "./namespace-probe-BSH_p9TK.cjs";
+import { a as ClivlyEntitiesConfig, x as defineClivlyConfig } from "./entity-config-fKQhimtD.cjs";
+import { a as ClivlyConnectResult, c as ClivlyUser, d as DiscoveredTable, f as DoctorCheck, i as ClivlyConnectReason, l as CreateChatSessionHandlerOptions, n as ChatSessionRequestBody, o as ClivlySDK, p as DoctorReport, r as ChatWidgetVisitor, s as ClivlySDKConfig, u as CursorStore } from "./namespace-probe-aRFmpU85.cjs";
 //#region ../sdk/src/chat-session.d.ts
 declare function createChatSessionHandler({ allowedOrigins, apiKey, apiUrl, fetchImpl, resolveUser }: CreateChatSessionHandlerOptions): (request: Request) => Promise<Response>;
 //#endregion

package/sdk.d.mts

@@ -1,5 +1,5 @@
-import { a as ClivlyEntitiesConfig, y as defineClivlyConfig } from "./entity-config-C4Yf_fPj.mjs";
-import { a as ClivlyConnectResult, c as ClivlyUser, d as DiscoveredTable, f as DoctorCheck, i as ClivlyConnectReason, l as CreateChatSessionHandlerOptions, n as ChatSessionRequestBody, o as ClivlySDK, p as DoctorReport, r as ChatWidgetVisitor, s as ClivlySDKConfig, u as CursorStore } from "./namespace-probe-Dsp5uNkS.mjs";
+import { a as ClivlyEntitiesConfig, x as defineClivlyConfig } from "./entity-config-fKQhimtD.mjs";
+import { a as ClivlyConnectResult, c as ClivlyUser, d as DiscoveredTable, f as DoctorCheck, i as ClivlyConnectReason, l as CreateChatSessionHandlerOptions, n as ChatSessionRequestBody, o as ClivlySDK, p as DoctorReport, r as ChatWidgetVisitor, s as ClivlySDKConfig, u as CursorStore } from "./namespace-probe-BkUs8raG.mjs";
 //#region ../sdk/src/chat-session.d.ts
 declare function createChatSessionHandler({ allowedOrigins, apiKey, apiUrl, fetchImpl, resolveUser }: CreateChatSessionHandlerOptions): (request: Request) => Promise<Response>;
 //#endregion

package/sdk.mjs

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

package/{sync-engine-GNqRB8eS.d.cts → sync-engine-DHQ7rXZe.d.mts}

@@ -1,5 +1,5 @@
-import { a as ClivlyEntitiesConfig } from "./entity-config-C4Yf_fPj.cjs";
-import { n as CompiledView, t as CompileOptions } from "./view-compiler-Ll9cbIJz.cjs";
+import { a as ClivlyEntitiesConfig } from "./entity-config-fKQhimtD.mjs";
+import { n as CompiledView, t as CompileOptions } from "./view-compiler-CcUwzZut.mjs";
 //#region ../core/src/sync-engine.d.ts
 /**
  * Sync engine (Phase 3) — materializes the read-only entity views into Clivly's

package/{sync-engine-ZsusW-q_.d.mts → sync-engine-DiPjH53O.d.cts}

@@ -1,5 +1,5 @@
-import { a as ClivlyEntitiesConfig } from "./entity-config-C4Yf_fPj.mjs";
-import { n as CompiledView, t as CompileOptions } from "./view-compiler-Cin0neDO.mjs";
+import { a as ClivlyEntitiesConfig } from "./entity-config-fKQhimtD.cjs";
+import { n as CompiledView, t as CompileOptions } from "./view-compiler-DqAdVxLq.cjs";
 //#region ../core/src/sync-engine.d.ts
 /**
  * Sync engine (Phase 3) — materializes the read-only entity views into Clivly's

package/{sync-engine-Bg6-SznL.mjs → sync-engine-SuxSzbZ4.mjs}

@@ -1,4 +1,4 @@
-import { r as compileEntityViews } from "./view-compiler-DlTpOfZi.mjs";
+import { r as compileEntityViews } from "./view-compiler-CQx8TRrW.mjs";
 //#region ../core/src/sync-engine.ts
 /**
 * Diff a view's rows against the current mirror population for one entity.

package/{sync-engine-DEJvKw6E.cjs → sync-engine-abE94g6X.cjs}

@@ -1,4 +1,4 @@
-const require_view_compiler = require("./view-compiler-DplczSjF.cjs");
+const require_view_compiler = require("./view-compiler-Blu4OXJ7.cjs");
 //#region ../core/src/sync-engine.ts
 /**
 * Diff a view's rows against the current mirror population for one entity.

package/{view-compiler-DplczSjF.cjs → view-compiler-Blu4OXJ7.cjs}

@@ -186,6 +186,22 @@ function legacyJoins(config, entity, columns, selectItems) {
 	}
 	return joins;
 }
+/**
+* Translate a driver error from executing a compiled view into something
+* actionable, or `undefined` when it is not one we recognise (caller rethrows).
+*
+* The case that matters: `WITH (security_invoker = true)` needs Postgres 15,
+* and PG 14 rejects it with sqlstate 22023 naming a Postgres internal
+* (`reloptions.c`) — no mention of Clivly, the option, or the version. The
+* compiler cannot catch this itself because the host executes the SQL.
+*/
+function explainViewExecutionError(error) {
+	if (typeof error !== "object" || error === null) return;
+	const { code, routine } = error;
+	const message = error instanceof Error ? error.message : "";
+	if (!(code === "22023" && (routine === "parseRelOptionsInternal" || message.includes("security_invoker")))) return;
+	return "CREATE VIEW … WITH (security_invoker = true) requires Postgres 15+. Pass `securityInvoker: false` to compile without it — but note the view then runs with its owner's privileges instead of the querying role's, which bypasses row-level security (RLS) on the underlying tables. Prefer upgrading Postgres if you rely on RLS to separate tenants.";
+}
 function compileEntityView(config, entityKey, options = {}) {
 	const entity = config.entities[entityKey];
 	if (!entity) throw new Error(`entity "${entityKey}" is not defined`);
@@ -275,3 +291,9 @@ Object.defineProperty(exports, "explainEntitiesConfig", {
 		return explainEntitiesConfig;
 	}
 });
+Object.defineProperty(exports, "explainViewExecutionError", {
+	enumerable: true,
+	get: function() {
+		return explainViewExecutionError;
+	}
+});

package/{view-compiler-DlTpOfZi.mjs → view-compiler-CQx8TRrW.mjs}

@@ -186,6 +186,22 @@ function legacyJoins(config, entity, columns, selectItems) {
 	}
 	return joins;
 }
+/**
+* Translate a driver error from executing a compiled view into something
+* actionable, or `undefined` when it is not one we recognise (caller rethrows).
+*
+* The case that matters: `WITH (security_invoker = true)` needs Postgres 15,
+* and PG 14 rejects it with sqlstate 22023 naming a Postgres internal
+* (`reloptions.c`) — no mention of Clivly, the option, or the version. The
+* compiler cannot catch this itself because the host executes the SQL.
+*/
+function explainViewExecutionError(error) {
+	if (typeof error !== "object" || error === null) return;
+	const { code, routine } = error;
+	const message = error instanceof Error ? error.message : "";
+	if (!(code === "22023" && (routine === "parseRelOptionsInternal" || message.includes("security_invoker")))) return;
+	return "CREATE VIEW … WITH (security_invoker = true) requires Postgres 15+. Pass `securityInvoker: false` to compile without it — but note the view then runs with its owner's privileges instead of the querying role's, which bypasses row-level security (RLS) on the underlying tables. Prefer upgrading Postgres if you rely on RLS to separate tenants.";
+}
 function compileEntityView(config, entityKey, options = {}) {
 	const entity = config.entities[entityKey];
 	if (!entity) throw new Error(`entity "${entityKey}" is not defined`);
@@ -251,4 +267,4 @@ async function explainEntitiesConfig(config, run, options = {}) {
 	return results;
 }
 //#endregion
-export { explainEntitiesConfig as i, compileEntityView as n, compileEntityViews as r, DEFAULT_VIEW_PREFIX as t };
+export { explainViewExecutionError as a, explainEntitiesConfig as i, compileEntityView as n, compileEntityViews as r, DEFAULT_VIEW_PREFIX as t };

package/{view-compiler-Cin0neDO.d.mts → view-compiler-CcUwzZut.d.mts}

@@ -1,4 +1,4 @@
-import { a as ClivlyEntitiesConfig } from "./entity-config-C4Yf_fPj.mjs";
+import { a as ClivlyEntitiesConfig } from "./entity-config-fKQhimtD.mjs";
 //#region ../core/src/view-compiler.d.ts
 declare const DEFAULT_VIEW_PREFIX = "crm_src_";
 interface CompileOptions {
@@ -43,6 +43,16 @@ interface CompiledView {
   sql: string;
   viewName: string;
 }
+/**
+ * Translate a driver error from executing a compiled view into something
+ * actionable, or `undefined` when it is not one we recognise (caller rethrows).
+ *
+ * The case that matters: `WITH (security_invoker = true)` needs Postgres 15,
+ * and PG 14 rejects it with sqlstate 22023 naming a Postgres internal
+ * (`reloptions.c`) — no mention of Clivly, the option, or the version. The
+ * compiler cannot catch this itself because the host executes the SQL.
+ */
+declare function explainViewExecutionError(error: unknown): string | undefined;
 declare function compileEntityView(config: ClivlyEntitiesConfig, entityKey: string, options?: CompileOptions): CompiledView;
 /** Compile every entity in the config into its view, in declaration order. */
 declare function compileEntityViews(config: ClivlyEntitiesConfig, options?: CompileOptions): CompiledView[];
@@ -68,4 +78,4 @@ interface ExplainResult {
  */
 declare function explainEntitiesConfig(config: ClivlyEntitiesConfig, run: (sql: string) => Promise<unknown>, options?: CompileOptions): Promise<ExplainResult[]>;
 //#endregion
-export { compileEntityView as a, ExplainResult as i, CompiledView as n, compileEntityViews as o, DEFAULT_VIEW_PREFIX as r, explainEntitiesConfig as s, CompileOptions as t };
+export { compileEntityView as a, explainViewExecutionError as c, ExplainResult as i, CompiledView as n, compileEntityViews as o, DEFAULT_VIEW_PREFIX as r, explainEntitiesConfig as s, CompileOptions as t };

package/{view-compiler-Ll9cbIJz.d.cts → view-compiler-DqAdVxLq.d.cts}

@@ -1,4 +1,4 @@
-import { a as ClivlyEntitiesConfig } from "./entity-config-C4Yf_fPj.cjs";
+import { a as ClivlyEntitiesConfig } from "./entity-config-fKQhimtD.cjs";
 //#region ../core/src/view-compiler.d.ts
 declare const DEFAULT_VIEW_PREFIX = "crm_src_";
 interface CompileOptions {
@@ -43,6 +43,16 @@ interface CompiledView {
   sql: string;
   viewName: string;
 }
+/**
+ * Translate a driver error from executing a compiled view into something
+ * actionable, or `undefined` when it is not one we recognise (caller rethrows).
+ *
+ * The case that matters: `WITH (security_invoker = true)` needs Postgres 15,
+ * and PG 14 rejects it with sqlstate 22023 naming a Postgres internal
+ * (`reloptions.c`) — no mention of Clivly, the option, or the version. The
+ * compiler cannot catch this itself because the host executes the SQL.
+ */
+declare function explainViewExecutionError(error: unknown): string | undefined;
 declare function compileEntityView(config: ClivlyEntitiesConfig, entityKey: string, options?: CompileOptions): CompiledView;
 /** Compile every entity in the config into its view, in declaration order. */
 declare function compileEntityViews(config: ClivlyEntitiesConfig, options?: CompileOptions): CompiledView[];
@@ -68,4 +78,4 @@ interface ExplainResult {
  */
 declare function explainEntitiesConfig(config: ClivlyEntitiesConfig, run: (sql: string) => Promise<unknown>, options?: CompileOptions): Promise<ExplainResult[]>;
 //#endregion
-export { compileEntityView as a, ExplainResult as i, CompiledView as n, compileEntityViews as o, DEFAULT_VIEW_PREFIX as r, explainEntitiesConfig as s, CompileOptions as t };
+export { compileEntityView as a, explainViewExecutionError as c, ExplainResult as i, CompiledView as n, compileEntityViews as o, DEFAULT_VIEW_PREFIX as r, explainEntitiesConfig as s, CompileOptions as t };

package/vite.d.cts

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

package/vite.d.mts

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

package/mappings-config-BpcR8bBo.d.mts

@@ -1,167 +0,0 @@
-import { A as ZodRecord, D as ZodLiteral, E as ZodEnum, M as ZodUnion, N as output, O as ZodObject, P as $strict, T as ZodArray, a as ClivlyEntitiesConfig, j as ZodString, k as ZodOptional } from "./entity-config-C4Yf_fPj.mjs";
-//#region ../core/src/projection.d.ts
-/**
- * Projection-backed custom mappings — one custom object derived from a base
- * table plus explicit joins.
- *
- * A projection is deliberately narrow: equality joins only, direct column
- * bindings only, no expressions and no aggregation. Everything a user can
- * express here compiles to a single read-only view whose `id` column is
- * provably unique per row, which is what lets the sync engine consume it
- * unchanged.
- *
- * Refs address tables symbolically: `"base"` for the base table, or a join's
- * `key`. Raw table names are never accepted in a ref, so a projection can
- * never reach a table it did not declare.
- */
-/** The reserved ref name for the projection's base table. */
-declare const BASE_REF = "base";
-declare const projectionRefSchema: ZodObject<{
-  table: ZodString;
-  column: ZodString;
-}, $strict>;
-type ProjectionRef = output<typeof projectionRefSchema>;
-declare const projectionJoinSchema: ZodObject<{
-  key: ZodString;
-  table: ZodString;
-  type: ZodEnum<{
-    inner: "inner";
-    left: "left";
-  }>;
-  on: ZodArray<ZodObject<{
-    left: ZodObject<{
-      table: ZodString;
-      column: ZodString;
-    }, $strict>;
-    op: ZodLiteral<"eq">;
-    right: ZodObject<{
-      table: ZodString;
-      column: ZodString;
-    }, $strict>;
-  }, $strict>>;
-}, $strict>;
-type ProjectionJoin = output<typeof projectionJoinSchema>;
-declare const projectionFieldBindingSchema: ZodObject<{
-  from: ZodObject<{
-    table: ZodString;
-    column: ZodString;
-  }, $strict>;
-}, $strict>;
-type ProjectionFieldBinding = output<typeof projectionFieldBindingSchema>;
-declare const projectionIdentitySchema: ZodUnion<readonly [ZodObject<{
-  kind: ZodLiteral<"base_pk">;
-  column: ZodOptional<ZodString>;
-}, $strict>, ZodObject<{
-  kind: ZodLiteral<"column">;
-  from: ZodObject<{
-    table: ZodString;
-    column: ZodString;
-  }, $strict>;
-}, $strict>, ZodObject<{
-  kind: ZodLiteral<"composite">;
-  parts: ZodArray<ZodObject<{
-    table: ZodString;
-    column: ZodString;
-  }, $strict>>;
-}, $strict>]>;
-type ProjectionIdentity = output<typeof projectionIdentitySchema>;
-declare const projectionSchema: ZodObject<{
-  version: ZodLiteral<1>;
-  kind: ZodLiteral<"projection">;
-  entityKey: ZodString;
-  baseTable: ZodString;
-  joins: ZodArray<ZodObject<{
-    key: ZodString;
-    table: ZodString;
-    type: ZodEnum<{
-      inner: "inner";
-      left: "left";
-    }>;
-    on: ZodArray<ZodObject<{
-      left: ZodObject<{
-        table: ZodString;
-        column: ZodString;
-      }, $strict>;
-      op: ZodLiteral<"eq">;
-      right: ZodObject<{
-        table: ZodString;
-        column: ZodString;
-      }, $strict>;
-    }, $strict>>;
-  }, $strict>>;
-  fieldBindings: ZodRecord<ZodString, ZodObject<{
-    from: ZodObject<{
-      table: ZodString;
-      column: ZodString;
-    }, $strict>;
-  }, $strict>>;
-  identity: ZodUnion<readonly [ZodObject<{
-    kind: ZodLiteral<"base_pk">;
-    column: ZodOptional<ZodString>;
-  }, $strict>, ZodObject<{
-    kind: ZodLiteral<"column">;
-    from: ZodObject<{
-      table: ZodString;
-      column: ZodString;
-    }, $strict>;
-  }, $strict>, ZodObject<{
-    kind: ZodLiteral<"composite">;
-    parts: ZodArray<ZodObject<{
-      table: ZodString;
-      column: ZodString;
-    }, $strict>>;
-  }, $strict>]>;
-}, $strict>;
-type ProjectionMapping = output<typeof projectionSchema>;
-/**
- * Every column ref an identity depends on. `basePkColumn` is the base table's
- * discovered PK, used only when a `base_pk` identity omits an explicit column.
- */
-declare function identityRefs(identity: ProjectionIdentity, basePkColumn: string): ProjectionRef[];
-//#endregion
-//#region ../core/src/mappings-config.d.ts
-/**
- * Mappings → Entity Config bridge.
- *
- * `crm_entity_mappings` rows are the single source of truth for how a host
- * schema maps onto Clivly's CRM concepts. This module compiles those rows into
- * a `ClivlyEntitiesConfig` — the contract the view compiler and sync engine
- * consume — so the persisted mapping and the runtime pipeline never diverge.
- *
- * The row model has no explicit entity-key column (it's keyed by
- * `sourceTable + targetConcept + role`), but the config's `relationships`
- * reference other entities *by key*. This builder therefore derives a stable
- * key per row and resolves each relationship's `entity` reference through the
- * same derivation — so a relationship stored as `entity: "<relatedTable>"`
- * (the shape `mappings.suggest` produces) resolves to the right entity.
- */
-/**
- * A persisted `crm_entity_mappings` row, narrowed to the columns the builder
- * reads. Structurally compatible with the Drizzle row (jsonb columns typed
- * loosely) so the API layer can pass `db.select()` results straight in.
- */
-interface EntityMappingRow {
-  fieldMap: Record<string, string>;
-  filter?: Record<string, unknown> | null;
-  /**
-   * Advanced mapping: a base table plus explicit joins. When set, this — not
-   * `fieldMap` — is the authored source of truth, and `sourceTable` merely
-   * mirrors `projection.baseTable`.
-   */
-  projection?: ProjectionMapping | null;
-  relationships?: Record<string, unknown> | null;
-  role?: string | null;
-  sourceTable: string;
-  status?: string | null;
-  targetConcept: string;
-  targetObjectTypeId?: string | null;
-}
-/**
- * Compile persisted mapping rows into a `ClivlyEntitiesConfig`. Only `active`
- * rows with at least one mapped field are included; disabled/suggested rows and
- * unmapped rows are skipped. Returns `{ entities: {} }` when nothing is
- * eligible — a no-op the view compiler and sync engine both tolerate.
- */
-declare function mappingsToEntitiesConfig(rows: EntityMappingRow[]): ClivlyEntitiesConfig;
-//#endregion
-export { ProjectionIdentity as a, ProjectionRef as c, ProjectionFieldBinding as i, identityRefs as l, mappingsToEntitiesConfig as n, ProjectionJoin as o, BASE_REF as r, ProjectionMapping as s, EntityMappingRow as t, projectionSchema as u };