@clivly/core 0.10.9 → 0.11.0

package/dist/integration-state.d.cts

@@ -1,20 +1,20 @@
 //#region src/integration-state.d.ts
-declare const INTEGRATION_STEPS: readonly ["credential", "application", "schema", "mapping", "trigger", "sync", "widget"];
-type StepId = (typeof INTEGRATION_STEPS)[number];
+export declare const INTEGRATION_STEPS: readonly ["credential", "application", "schema", "mapping", "trigger", "sync", "widget"];
+export type StepId = (typeof INTEGRATION_STEPS)[number];
 /** `blocked` means "prerequisite unmet", never "broken" — see C-19. */
-type StepState = "done" | "active" | "blocked" | "failed" | "skipped";
-type IntegrationStatus = "not_configured" | "sdk_installed" | "awaiting_connection" | "connected" | "schema_discovered" | "mapping_required" | "trigger_required" | "ready_to_sync" | "syncing" | "healthy" | "warning" | "error" |
+export type StepState = "done" | "active" | "blocked" | "failed" | "skipped";
+export type IntegrationStatus = "not_configured" | "sdk_installed" | "awaiting_connection" | "connected" | "schema_discovered" | "mapping_required" | "trigger_required" | "ready_to_sync" | "syncing" | "healthy" | "warning" | "error" |
 /**
  * @deprecated No longer derived. Liveness is its own dimension — read
  * `ConnectionHealth` from `deriveLiveness`. Setup progress does not move
  * backwards just because an app stopped running.
  */
 "disconnected";
-declare const INTEGRATION_STEP_LABELS: Record<StepId, string>;
+export declare const INTEGRATION_STEP_LABELS: Record<StepId, string>;
 /** Each step's prerequisites. Ordering is enforced by a test, not convention. */
-declare const STEP_PREREQUISITES: Record<StepId, readonly StepId[]>;
-declare function stepIndex(id: StepId): number;
-interface RunFact {
+export declare const STEP_PREREQUISITES: Record<StepId, readonly StepId[]>;
+export declare function stepIndex(id: StepId): number;
+export interface RunFact {
   at: number;
   message?: string;
   ok: boolean;
@@ -36,8 +36,8 @@ interface RunFact {
  * such a host to `local_dev` would file a production box's faults under local
  * development, where nobody would look for them.
  */
-type HostEnvironment = "local_dev" | "preview" | "production" | "unknown";
-interface IntegrationFacts {
+export type HostEnvironment = "local_dev" | "preview" | "production" | "unknown";
+export interface IntegrationFacts {
   discoveredTableCount: number;
   /** The environment the app reported on its last heartbeat. */
   environment?: HostEnvironment | null;
@@ -95,12 +95,12 @@ interface IntegrationFacts {
   warnings: string[];
   widgetInstalled: boolean;
 }
-interface StepProblem {
+export interface StepProblem {
   code: string;
   fix: string;
   message: string;
 }
-interface IntegrationStep {
+export interface IntegrationStep {
   blockedBy: StepId | null;
   evidence: string | null;
   id: StepId;
@@ -108,10 +108,10 @@ interface IntegrationStep {
   problem: StepProblem | null;
   state: StepState;
 }
-declare function formatAge(ms: number): string;
+export declare function formatAge(ms: number): string;
 /** The cadence `createClivlySDK` uses when the host app configures none. */
-declare const DEFAULT_HEARTBEAT_INTERVAL_MS = 60000;
-type ConnectionHealth = "live" | "live_with_issues" | "stale" | "offline";
+export declare const DEFAULT_HEARTBEAT_INTERVAL_MS = 60000;
+export type ConnectionHealth = "live" | "live_with_issues" | "stale" | "offline";
 /**
  * Clivly's own answer to "is this app up", obtained by asking it rather than
  * waiting to be told.
@@ -121,15 +121,15 @@ type ConnectionHealth = "live" | "live_with_issues" | "stale" | "offline";
  * that answers `200`. Only silence — a timeout, a refused connection, DNS that
  * does not resolve — means offline.
  */
-interface ReachabilityProbe {
+export interface ReachabilityProbe {
   /** When Clivly performed the check. Probe results are cached, so this ages. */
   checkedAt: number;
   /** Did anything answer at the other end? */
   reachable: boolean;
 }
 /** Which algorithm decides whether this deployment is up. */
-type PresenceTransport = "websocket" | "http";
-type PresenceConnectionState = "connected" | "reconnecting" | "disconnected";
+export type PresenceTransport = "websocket" | "http";
+export type PresenceConnectionState = "connected" | "reconnecting" | "disconnected";
 /**
  * A deployment's connection state as its `PresenceRoom` last persisted it.
  *
@@ -138,13 +138,13 @@ type PresenceConnectionState = "connected" | "reconnecting" | "disconnected";
  * shown as live for 150 seconds and offline only after ten minutes, which is
  * the whole reason this transport exists.
  */
-interface DeploymentPresence {
+export interface DeploymentPresence {
   /** Sockets currently accepted in the room. */
   activeInstanceCount: number;
   connectionState: PresenceConnectionState;
   transport: PresenceTransport;
 }
-interface ConnectionLiveness {
+export interface ConnectionLiveness {
   /** `"8s ago"`, or `"No heartbeat yet"` when the app has never reported. */
   ageLabel: string;
   ageMs: number | null;
@@ -165,30 +165,30 @@ interface ConnectionLiveness {
  * negative — falls back to the SDK default rather than producing a window of
  * zero that would call every app offline.
  */
-declare function livenessWindows(intervalMs: number | null | undefined): {
+export declare function livenessWindows(intervalMs: number | null | undefined): {
   liveMs: number;
   staleMs: number;
 };
-declare function deriveLiveness(facts: IntegrationFacts): ConnectionLiveness;
+export declare function deriveLiveness(facts: IntegrationFacts): ConnectionLiveness;
 /**
  * Walk the ladder once. A step is `blocked` when an earlier step it needs has
  * not been satisfied — a prerequisite statement, not a verdict about this step
  * — and only the first unsatisfied step is `active`, so exactly one root cause
  * ever surfaces.
  */
-declare function resolveSteps(facts: IntegrationFacts): IntegrationStep[];
+export declare function resolveSteps(facts: IntegrationFacts): IntegrationStep[];
 /**
  * Collapse the ladder to the single status the surfaces switch on. This is the
  * setup dimension only: it answers how far configuration got, never whether the
  * app is up. Pair it with `deriveLiveness` for the second half of the picture.
  */
-declare function deriveStatus(steps: IntegrationStep[], facts: IntegrationFacts): IntegrationStatus;
-interface NextAction {
+export declare function deriveStatus(steps: IntegrationStep[], facts: IntegrationFacts): IntegrationStatus;
+export interface NextAction {
   command: string | null;
   envFile: string | null;
   label: string;
 }
-interface IntegrationState {
+export interface IntegrationState {
   /**
    * Is the app running right now. Deliberately alongside `status` rather than
    * folded into it: a surface must be able to say "setup reached mapping" and
@@ -205,14 +205,13 @@ interface IntegrationState {
  * dialog prints it too, and it must be the same string as the one the ladder
  * recommends — that pairing is what C-05 broke.
  */
-declare const INSTALL_COMMAND = "npx clivly init";
+export declare const INSTALL_COMMAND = "npx clivly init";
 /**
  * THE one producer of `next.command`. Six surfaces previously each invented
  * their own "run this next" string, and one of them named a read-only command
  * as the fix for a write problem (C-05). If you need a command for the
  * next-action slot, call this — do not write another one.
  */
-declare function nextAction(steps: IntegrationStep[], status: IntegrationStatus, liveness: ConnectionLiveness): NextAction | null;
-declare function computeIntegrationState(facts: IntegrationFacts): IntegrationState;
-//#endregion
-export { ConnectionHealth, ConnectionLiveness, DEFAULT_HEARTBEAT_INTERVAL_MS, DeploymentPresence, HostEnvironment, INSTALL_COMMAND, INTEGRATION_STEPS, INTEGRATION_STEP_LABELS, IntegrationFacts, IntegrationState, IntegrationStatus, IntegrationStep, NextAction, PresenceConnectionState, PresenceTransport, ReachabilityProbe, RunFact, STEP_PREREQUISITES, StepId, StepProblem, StepState, computeIntegrationState, deriveLiveness, deriveStatus, formatAge, livenessWindows, nextAction, resolveSteps, stepIndex };
+export declare function nextAction(steps: IntegrationStep[], status: IntegrationStatus, liveness: ConnectionLiveness): NextAction | null;
+export declare function computeIntegrationState(facts: IntegrationFacts): IntegrationState;
+//#endregion

package/dist/integration-state.d.mts

@@ -1,20 +1,20 @@
 //#region src/integration-state.d.ts
-declare const INTEGRATION_STEPS: readonly ["credential", "application", "schema", "mapping", "trigger", "sync", "widget"];
-type StepId = (typeof INTEGRATION_STEPS)[number];
+export declare const INTEGRATION_STEPS: readonly ["credential", "application", "schema", "mapping", "trigger", "sync", "widget"];
+export type StepId = (typeof INTEGRATION_STEPS)[number];
 /** `blocked` means "prerequisite unmet", never "broken" — see C-19. */
-type StepState = "done" | "active" | "blocked" | "failed" | "skipped";
-type IntegrationStatus = "not_configured" | "sdk_installed" | "awaiting_connection" | "connected" | "schema_discovered" | "mapping_required" | "trigger_required" | "ready_to_sync" | "syncing" | "healthy" | "warning" | "error" |
+export type StepState = "done" | "active" | "blocked" | "failed" | "skipped";
+export type IntegrationStatus = "not_configured" | "sdk_installed" | "awaiting_connection" | "connected" | "schema_discovered" | "mapping_required" | "trigger_required" | "ready_to_sync" | "syncing" | "healthy" | "warning" | "error" |
 /**
  * @deprecated No longer derived. Liveness is its own dimension — read
  * `ConnectionHealth` from `deriveLiveness`. Setup progress does not move
  * backwards just because an app stopped running.
  */
 "disconnected";
-declare const INTEGRATION_STEP_LABELS: Record<StepId, string>;
+export declare const INTEGRATION_STEP_LABELS: Record<StepId, string>;
 /** Each step's prerequisites. Ordering is enforced by a test, not convention. */
-declare const STEP_PREREQUISITES: Record<StepId, readonly StepId[]>;
-declare function stepIndex(id: StepId): number;
-interface RunFact {
+export declare const STEP_PREREQUISITES: Record<StepId, readonly StepId[]>;
+export declare function stepIndex(id: StepId): number;
+export interface RunFact {
   at: number;
   message?: string;
   ok: boolean;
@@ -36,8 +36,8 @@ interface RunFact {
  * such a host to `local_dev` would file a production box's faults under local
  * development, where nobody would look for them.
  */
-type HostEnvironment = "local_dev" | "preview" | "production" | "unknown";
-interface IntegrationFacts {
+export type HostEnvironment = "local_dev" | "preview" | "production" | "unknown";
+export interface IntegrationFacts {
   discoveredTableCount: number;
   /** The environment the app reported on its last heartbeat. */
   environment?: HostEnvironment | null;
@@ -95,12 +95,12 @@ interface IntegrationFacts {
   warnings: string[];
   widgetInstalled: boolean;
 }
-interface StepProblem {
+export interface StepProblem {
   code: string;
   fix: string;
   message: string;
 }
-interface IntegrationStep {
+export interface IntegrationStep {
   blockedBy: StepId | null;
   evidence: string | null;
   id: StepId;
@@ -108,10 +108,10 @@ interface IntegrationStep {
   problem: StepProblem | null;
   state: StepState;
 }
-declare function formatAge(ms: number): string;
+export declare function formatAge(ms: number): string;
 /** The cadence `createClivlySDK` uses when the host app configures none. */
-declare const DEFAULT_HEARTBEAT_INTERVAL_MS = 60000;
-type ConnectionHealth = "live" | "live_with_issues" | "stale" | "offline";
+export declare const DEFAULT_HEARTBEAT_INTERVAL_MS = 60000;
+export type ConnectionHealth = "live" | "live_with_issues" | "stale" | "offline";
 /**
  * Clivly's own answer to "is this app up", obtained by asking it rather than
  * waiting to be told.
@@ -121,15 +121,15 @@ type ConnectionHealth = "live" | "live_with_issues" | "stale" | "offline";
  * that answers `200`. Only silence — a timeout, a refused connection, DNS that
  * does not resolve — means offline.
  */
-interface ReachabilityProbe {
+export interface ReachabilityProbe {
   /** When Clivly performed the check. Probe results are cached, so this ages. */
   checkedAt: number;
   /** Did anything answer at the other end? */
   reachable: boolean;
 }
 /** Which algorithm decides whether this deployment is up. */
-type PresenceTransport = "websocket" | "http";
-type PresenceConnectionState = "connected" | "reconnecting" | "disconnected";
+export type PresenceTransport = "websocket" | "http";
+export type PresenceConnectionState = "connected" | "reconnecting" | "disconnected";
 /**
  * A deployment's connection state as its `PresenceRoom` last persisted it.
  *
@@ -138,13 +138,13 @@ type PresenceConnectionState = "connected" | "reconnecting" | "disconnected";
  * shown as live for 150 seconds and offline only after ten minutes, which is
  * the whole reason this transport exists.
  */
-interface DeploymentPresence {
+export interface DeploymentPresence {
   /** Sockets currently accepted in the room. */
   activeInstanceCount: number;
   connectionState: PresenceConnectionState;
   transport: PresenceTransport;
 }
-interface ConnectionLiveness {
+export interface ConnectionLiveness {
   /** `"8s ago"`, or `"No heartbeat yet"` when the app has never reported. */
   ageLabel: string;
   ageMs: number | null;
@@ -165,30 +165,30 @@ interface ConnectionLiveness {
  * negative — falls back to the SDK default rather than producing a window of
  * zero that would call every app offline.
  */
-declare function livenessWindows(intervalMs: number | null | undefined): {
+export declare function livenessWindows(intervalMs: number | null | undefined): {
   liveMs: number;
   staleMs: number;
 };
-declare function deriveLiveness(facts: IntegrationFacts): ConnectionLiveness;
+export declare function deriveLiveness(facts: IntegrationFacts): ConnectionLiveness;
 /**
  * Walk the ladder once. A step is `blocked` when an earlier step it needs has
  * not been satisfied — a prerequisite statement, not a verdict about this step
  * — and only the first unsatisfied step is `active`, so exactly one root cause
  * ever surfaces.
  */
-declare function resolveSteps(facts: IntegrationFacts): IntegrationStep[];
+export declare function resolveSteps(facts: IntegrationFacts): IntegrationStep[];
 /**
  * Collapse the ladder to the single status the surfaces switch on. This is the
  * setup dimension only: it answers how far configuration got, never whether the
  * app is up. Pair it with `deriveLiveness` for the second half of the picture.
  */
-declare function deriveStatus(steps: IntegrationStep[], facts: IntegrationFacts): IntegrationStatus;
-interface NextAction {
+export declare function deriveStatus(steps: IntegrationStep[], facts: IntegrationFacts): IntegrationStatus;
+export interface NextAction {
   command: string | null;
   envFile: string | null;
   label: string;
 }
-interface IntegrationState {
+export interface IntegrationState {
   /**
    * Is the app running right now. Deliberately alongside `status` rather than
    * folded into it: a surface must be able to say "setup reached mapping" and
@@ -205,14 +205,13 @@ interface IntegrationState {
  * dialog prints it too, and it must be the same string as the one the ladder
  * recommends — that pairing is what C-05 broke.
  */
-declare const INSTALL_COMMAND = "npx clivly init";
+export declare const INSTALL_COMMAND = "npx clivly init";
 /**
  * THE one producer of `next.command`. Six surfaces previously each invented
  * their own "run this next" string, and one of them named a read-only command
  * as the fix for a write problem (C-05). If you need a command for the
  * next-action slot, call this — do not write another one.
  */
-declare function nextAction(steps: IntegrationStep[], status: IntegrationStatus, liveness: ConnectionLiveness): NextAction | null;
-declare function computeIntegrationState(facts: IntegrationFacts): IntegrationState;
-//#endregion
-export { ConnectionHealth, ConnectionLiveness, DEFAULT_HEARTBEAT_INTERVAL_MS, DeploymentPresence, HostEnvironment, INSTALL_COMMAND, INTEGRATION_STEPS, INTEGRATION_STEP_LABELS, IntegrationFacts, IntegrationState, IntegrationStatus, IntegrationStep, NextAction, PresenceConnectionState, PresenceTransport, ReachabilityProbe, RunFact, STEP_PREREQUISITES, StepId, StepProblem, StepState, computeIntegrationState, deriveLiveness, deriveStatus, formatAge, livenessWindows, nextAction, resolveSteps, stepIndex };
+export declare function nextAction(steps: IntegrationStep[], status: IntegrationStatus, liveness: ConnectionLiveness): NextAction | null;
+export declare function computeIntegrationState(facts: IntegrationFacts): IntegrationState;
+//#endregion

package/dist/mapping-form.d.cts

@@ -1,4 +1,4 @@
-import { S as RelationshipsMap, h as FilterExpr, x as RelationshipVia } from "./entity-config-ChHLozko.cjs";
+import { S as RelationshipsMap, h as FilterExpr, x as RelationshipVia } from "./entity-config-OhC4Otkz.cjs";
 //#region src/mapping-form.d.ts
 /**
  * A relationship the mapping UI can offer or has configured, in the shape the
@@ -6,7 +6,7 @@ import { S as RelationshipsMap, h as FilterExpr, x as RelationshipVia } from "./
  * mappings→config compiler resolves it to the canonical entity key, so it is
  * persisted verbatim as the relationship's `entity` reference.
  */
-interface RelationshipCandidate {
+export interface RelationshipCandidate {
   entityTable: string;
   name: string;
   via: RelationshipVia;
@@ -16,19 +16,18 @@ interface RelationshipCandidate {
  * `value` belong to this entity (e.g. `role = "owner"`). Returns `undefined`
  * when either side is blank so the caller can omit the filter entirely.
  */
-declare function buildFilterFromDiscriminator(column: string | null | undefined, value: string): FilterExpr | undefined;
+export declare function buildFilterFromDiscriminator(column: string | null | undefined, value: string): FilterExpr | undefined;
 /**
  * A stable identity string for a relationship's `via`. Two candidates on the
  * same source table always differ in their join (`fkOn`+column, join-table
  * keys, or raw SQL), so this disambiguates candidates the heuristic gives the
  * same `name` (every contact→company candidate is named "company").
  */
-declare function relationshipViaSignature(via: RelationshipVia): string;
+export declare function relationshipViaSignature(via: RelationshipVia): string;
 /**
  * Compile the selected relationship candidates into the persisted
  * `RelationshipsMap`. Returns `undefined` for an empty selection so the caller
  * omits the field.
  */
-declare function buildRelationships(candidates: RelationshipCandidate[]): RelationshipsMap | undefined;
-//#endregion
-export { RelationshipCandidate, buildFilterFromDiscriminator, buildRelationships, relationshipViaSignature };
+export declare function buildRelationships(candidates: RelationshipCandidate[]): RelationshipsMap | undefined;
+//#endregion

package/dist/mapping-form.d.mts

@@ -1,4 +1,4 @@
-import { S as RelationshipsMap, h as FilterExpr, x as RelationshipVia } from "./entity-config-ChHLozko.mjs";
+import { S as RelationshipsMap, h as FilterExpr, x as RelationshipVia } from "./entity-config-OhC4Otkz.mjs";
 //#region src/mapping-form.d.ts
 /**
  * A relationship the mapping UI can offer or has configured, in the shape the
@@ -6,7 +6,7 @@ import { S as RelationshipsMap, h as FilterExpr, x as RelationshipVia } from "./
  * mappings→config compiler resolves it to the canonical entity key, so it is
  * persisted verbatim as the relationship's `entity` reference.
  */
-interface RelationshipCandidate {
+export interface RelationshipCandidate {
   entityTable: string;
   name: string;
   via: RelationshipVia;
@@ -16,19 +16,18 @@ interface RelationshipCandidate {
  * `value` belong to this entity (e.g. `role = "owner"`). Returns `undefined`
  * when either side is blank so the caller can omit the filter entirely.
  */
-declare function buildFilterFromDiscriminator(column: string | null | undefined, value: string): FilterExpr | undefined;
+export declare function buildFilterFromDiscriminator(column: string | null | undefined, value: string): FilterExpr | undefined;
 /**
  * A stable identity string for a relationship's `via`. Two candidates on the
  * same source table always differ in their join (`fkOn`+column, join-table
  * keys, or raw SQL), so this disambiguates candidates the heuristic gives the
  * same `name` (every contact→company candidate is named "company").
  */
-declare function relationshipViaSignature(via: RelationshipVia): string;
+export declare function relationshipViaSignature(via: RelationshipVia): string;
 /**
  * Compile the selected relationship candidates into the persisted
  * `RelationshipsMap`. Returns `undefined` for an empty selection so the caller
  * omits the field.
  */
-declare function buildRelationships(candidates: RelationshipCandidate[]): RelationshipsMap | undefined;
-//#endregion
-export { RelationshipCandidate, buildFilterFromDiscriminator, buildRelationships, relationshipViaSignature };
+export declare function buildRelationships(candidates: RelationshipCandidate[]): RelationshipsMap | undefined;
+//#endregion

package/dist/mapping-score.d.cts

@@ -1,6 +1,6 @@
 //#region src/mapping-score.d.ts
-type Tier = "High" | "Medium" | "Low";
-interface Scored<T> {
+export type Tier = "High" | "Medium" | "Low";
+export interface Scored<T> {
   /** Human-readable chips, e.g. `type text`, `name matches "contacts"`. */
   reasons: string[];
   /** Internal — used for ranking and the apply threshold. Never rendered. */
@@ -9,17 +9,17 @@ interface Scored<T> {
   value: T;
 }
 /** Tier cut-offs: score >= high → High; >= medium → Medium; else Low. */
-interface Thresholds {
+export interface Thresholds {
   high: number;
   medium: number;
 }
-declare const CONCEPT_TIERS: Thresholds;
-declare const FIELD_TIERS: Thresholds;
-declare const RELATIONSHIP_TIERS: Thresholds;
+export declare const CONCEPT_TIERS: Thresholds;
+export declare const FIELD_TIERS: Thresholds;
+export declare const RELATIONSHIP_TIERS: Thresholds;
 /** Two concept candidates closer than this are treated as ambiguous. */
-declare const AMBIGUITY_MARGIN = 15;
+export declare const AMBIGUITY_MARGIN = 15;
 /** Signal weights. Tuned against fixtures; adjust here, not at call sites. */
-declare const W: {
+export declare const W: {
   readonly nameExact: 50;
   readonly nameSubstring: 25;
   readonly definingColumn: 20;
@@ -34,16 +34,15 @@ declare const W: {
   readonly fkNameHint: 30;
   readonly joinTable: 20;
 };
-declare function tierFor(score: number, t: Thresholds): Tier;
-declare function isTextLike(type: string | undefined): boolean;
-declare function isNumericLike(type: string | undefined): boolean;
-declare function isTimestampLike(type: string | undefined): boolean;
+export declare function tierFor(score: number, t: Thresholds): Tier;
+export declare function isTextLike(type: string | undefined): boolean;
+export declare function isNumericLike(type: string | undefined): boolean;
+export declare function isTimestampLike(type: string | undefined): boolean;
 /**
  * True when the top two candidates are too close to call. Callers must never
  * one-click apply an ambiguous result — the user picks.
  */
-declare function isAmbiguous(ranked: Array<{
+export declare function isAmbiguous(ranked: Array<{
   score: number;
 }>): boolean;
-//#endregion
-export { AMBIGUITY_MARGIN, CONCEPT_TIERS, FIELD_TIERS, RELATIONSHIP_TIERS, Scored, Thresholds, Tier, W, isAmbiguous, isNumericLike, isTextLike, isTimestampLike, tierFor };
+//#endregion

package/dist/mapping-score.d.mts

@@ -1,6 +1,6 @@
 //#region src/mapping-score.d.ts
-type Tier = "High" | "Medium" | "Low";
-interface Scored<T> {
+export type Tier = "High" | "Medium" | "Low";
+export interface Scored<T> {
   /** Human-readable chips, e.g. `type text`, `name matches "contacts"`. */
   reasons: string[];
   /** Internal — used for ranking and the apply threshold. Never rendered. */
@@ -9,17 +9,17 @@ interface Scored<T> {
   value: T;
 }
 /** Tier cut-offs: score >= high → High; >= medium → Medium; else Low. */
-interface Thresholds {
+export interface Thresholds {
   high: number;
   medium: number;
 }
-declare const CONCEPT_TIERS: Thresholds;
-declare const FIELD_TIERS: Thresholds;
-declare const RELATIONSHIP_TIERS: Thresholds;
+export declare const CONCEPT_TIERS: Thresholds;
+export declare const FIELD_TIERS: Thresholds;
+export declare const RELATIONSHIP_TIERS: Thresholds;
 /** Two concept candidates closer than this are treated as ambiguous. */
-declare const AMBIGUITY_MARGIN = 15;
+export declare const AMBIGUITY_MARGIN = 15;
 /** Signal weights. Tuned against fixtures; adjust here, not at call sites. */
-declare const W: {
+export declare const W: {
   readonly nameExact: 50;
   readonly nameSubstring: 25;
   readonly definingColumn: 20;
@@ -34,16 +34,15 @@ declare const W: {
   readonly fkNameHint: 30;
   readonly joinTable: 20;
 };
-declare function tierFor(score: number, t: Thresholds): Tier;
-declare function isTextLike(type: string | undefined): boolean;
-declare function isNumericLike(type: string | undefined): boolean;
-declare function isTimestampLike(type: string | undefined): boolean;
+export declare function tierFor(score: number, t: Thresholds): Tier;
+export declare function isTextLike(type: string | undefined): boolean;
+export declare function isNumericLike(type: string | undefined): boolean;
+export declare function isTimestampLike(type: string | undefined): boolean;
 /**
  * True when the top two candidates are too close to call. Callers must never
  * one-click apply an ambiguous result — the user picks.
  */
-declare function isAmbiguous(ranked: Array<{
+export declare function isAmbiguous(ranked: Array<{
   score: number;
 }>): boolean;
-//#endregion
-export { AMBIGUITY_MARGIN, CONCEPT_TIERS, FIELD_TIERS, RELATIONSHIP_TIERS, Scored, Thresholds, Tier, W, isAmbiguous, isNumericLike, isTextLike, isTimestampLike, tierFor };
+//#endregion

package/dist/mappings-config.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_entity_config = require("./entity-config-J5KYJVTO.cjs");
+const require_entity_config = require("./entity-config-C2sKAti2.cjs");
 //#region src/mappings-config.ts
 const RESERVED_FIELD = "id";
 /**
@@ -120,6 +120,7 @@ function entitiesToMappings(config) {
 			fieldMap: entity.projection ? {} : entity.fields
 		};
 		if (entity.filter) row.filter = entity.filter;
+		if (entity.isPrimaryContact) row.isPrimaryContact = true;
 		if (entity.relationships) row.relationships = entity.relationships;
 		if (entity.projection) row.projection = entity.projection;
 		if (entity.concept === CUSTOM_CONCEPT) {

package/dist/mappings-config.d.cts

@@ -1,4 +1,4 @@
-import { R as ProjectionMapping, S as RelationshipsMap, a as ClivlyEntitiesConfig, h as FilterExpr } from "./entity-config-ChHLozko.cjs";
+import { R as ProjectionMapping, S as RelationshipsMap, a as ClivlyEntitiesConfig, h as FilterExpr } from "./entity-config-OhC4Otkz.cjs";
 //#region src/mappings-config.d.ts
 /**
  * Mappings → Entity Config bridge.
@@ -20,7 +20,7 @@ import { R as ProjectionMapping, S as RelationshipsMap, a as ClivlyEntitiesConfi
  * reads. Structurally compatible with the Drizzle row (jsonb columns typed
  * loosely) so the API layer can pass `db.select()` results straight in.
  */
-interface EntityMappingRow {
+export interface EntityMappingRow {
   fieldMap: Record<string, string>;
   filter?: Record<string, unknown> | null;
   /**
@@ -42,7 +42,7 @@ interface EntityMappingRow {
  * 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;
+export declare function mappingsToEntitiesConfig(rows: EntityMappingRow[]): ClivlyEntitiesConfig;
 /**
  * Entity Config → Mappings, the inverse of `mappingsToEntitiesConfig`.
  *
@@ -57,7 +57,7 @@ declare function mappingsToEntitiesConfig(rows: EntityMappingRow[]): ClivlyEntit
  * ("client-accounts" derived from "accounts"). So the key travels explicitly on
  * every row rather than being left for the reverse derivation to guess.
  */
-interface MappingFromConfig {
+export interface MappingFromConfig {
   /**
    * The config entity key this row came from. Not a row column — the caller
    * needs it to resolve a custom object type and to report what it wrote.
@@ -65,6 +65,8 @@ interface MappingFromConfig {
   entityKey: string;
   fieldMap: Record<string, string>;
   filter?: FilterExpr;
+  /** Rows from this entity are their company's point of contact. */
+  isPrimaryContact?: boolean;
   /** Declared custom object, when the config declares one rather than pinning an id. */
   objectType?: {
     iconKey?: string;
@@ -80,6 +82,5 @@ interface MappingFromConfig {
   targetConcept: string;
   targetObjectTypeId?: string;
 }
-declare function entitiesToMappings(config: ClivlyEntitiesConfig): MappingFromConfig[];
-//#endregion
-export { EntityMappingRow, MappingFromConfig, entitiesToMappings, mappingsToEntitiesConfig };
+export declare function entitiesToMappings(config: ClivlyEntitiesConfig): MappingFromConfig[];
+//#endregion

package/dist/mappings-config.d.mts

@@ -1,4 +1,4 @@
-import { R as ProjectionMapping, S as RelationshipsMap, a as ClivlyEntitiesConfig, h as FilterExpr } from "./entity-config-ChHLozko.mjs";
+import { R as ProjectionMapping, S as RelationshipsMap, a as ClivlyEntitiesConfig, h as FilterExpr } from "./entity-config-OhC4Otkz.mjs";
 //#region src/mappings-config.d.ts
 /**
  * Mappings → Entity Config bridge.
@@ -20,7 +20,7 @@ import { R as ProjectionMapping, S as RelationshipsMap, a as ClivlyEntitiesConfi
  * reads. Structurally compatible with the Drizzle row (jsonb columns typed
  * loosely) so the API layer can pass `db.select()` results straight in.
  */
-interface EntityMappingRow {
+export interface EntityMappingRow {
   fieldMap: Record<string, string>;
   filter?: Record<string, unknown> | null;
   /**
@@ -42,7 +42,7 @@ interface EntityMappingRow {
  * 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;
+export declare function mappingsToEntitiesConfig(rows: EntityMappingRow[]): ClivlyEntitiesConfig;
 /**
  * Entity Config → Mappings, the inverse of `mappingsToEntitiesConfig`.
  *
@@ -57,7 +57,7 @@ declare function mappingsToEntitiesConfig(rows: EntityMappingRow[]): ClivlyEntit
  * ("client-accounts" derived from "accounts"). So the key travels explicitly on
  * every row rather than being left for the reverse derivation to guess.
  */
-interface MappingFromConfig {
+export interface MappingFromConfig {
   /**
    * The config entity key this row came from. Not a row column — the caller
    * needs it to resolve a custom object type and to report what it wrote.
@@ -65,6 +65,8 @@ interface MappingFromConfig {
   entityKey: string;
   fieldMap: Record<string, string>;
   filter?: FilterExpr;
+  /** Rows from this entity are their company's point of contact. */
+  isPrimaryContact?: boolean;
   /** Declared custom object, when the config declares one rather than pinning an id. */
   objectType?: {
     iconKey?: string;
@@ -80,6 +82,5 @@ interface MappingFromConfig {
   targetConcept: string;
   targetObjectTypeId?: string;
 }
-declare function entitiesToMappings(config: ClivlyEntitiesConfig): MappingFromConfig[];
-//#endregion
-export { EntityMappingRow, MappingFromConfig, entitiesToMappings, mappingsToEntitiesConfig };
+export declare function entitiesToMappings(config: ClivlyEntitiesConfig): MappingFromConfig[];
+//#endregion

package/dist/mappings-config.mjs

@@ -1,4 +1,4 @@
-import { f as projectionFields, t as CANONICAL_FIELDS } from "./entity-config-C_NDVfrL.mjs";
+import { f as projectionFields, t as CANONICAL_FIELDS } from "./entity-config-C0rtu-K_.mjs";
 //#region src/mappings-config.ts
 const RESERVED_FIELD = "id";
 /**
@@ -119,6 +119,7 @@ function entitiesToMappings(config) {
 			fieldMap: entity.projection ? {} : entity.fields
 		};
 		if (entity.filter) row.filter = entity.filter;
+		if (entity.isPrimaryContact) row.isPrimaryContact = true;
 		if (entity.relationships) row.relationships = entity.relationships;
 		if (entity.projection) row.projection = entity.projection;
 		if (entity.concept === CUSTOM_CONCEPT) {