@clivly/core 0.11.0-next.0 → 0.12.0

package/dist/index.mjs

@@ -1,12 +1,118 @@
 import { authCustom } from "./auth-adapter.mjs";
 import { i as projectionSchema, n as PROJECTION_KEY_PATTERN, r as identityRefs, t as BASE_REF } from "./projection-SCNrLJMV.mjs";
 import { i as primaryKeyColumns, n as coversUniqueKey, r as hasRichMeta, t as columnMetaFor } from "./schema-meta-Ac7938mT.mjs";
-import { _ as validateProjection, a as MATERIALIZING_CONCEPTS, b as joinFansOut, c as defineClivlyConfig, d as missingRequiredFields, f as projectionFields, g as validateEntitiesConfig, h as requiredFieldsFor, i as ClivlyConfigError, l as entitiesConfigSchema, m as relationshipsSchema, n as CRM_CONCEPTS, o as REQUIRED_FIELDS, p as relationshipSchema, t as CANONICAL_FIELDS, u as filterSchema, v as validateProjectionFilter, y as fanOutJoins } from "./entity-config-BTAJe1Zj.mjs";
+import { _ as validateProjection, a as MATERIALIZING_CONCEPTS, b as joinFansOut, c as defineClivlyConfig, d as missingRequiredFields, f as projectionFields, g as validateEntitiesConfig, h as requiredFieldsFor, i as ClivlyConfigError, l as entitiesConfigSchema, m as relationshipsSchema, n as CRM_CONCEPTS, o as REQUIRED_FIELDS, p as relationshipSchema, t as CANONICAL_FIELDS, u as filterSchema, v as validateProjectionFilter, y as fanOutJoins } from "./entity-config-C0rtu-K_.mjs";
 import { buildFilterFromDiscriminator, buildRelationships, relationshipViaSignature } from "./mapping-form.mjs";
 import { mappingsToEntitiesConfig } from "./mappings-config.mjs";
 import { c as compileProjectionIdentity, d as compileProjectionSelect, f as quoteIdent, i as explainEntitiesConfig, l as compileProjectionJoins, n as compileEntityView, o as PREVIEW_MAX_ROWS, r as compileEntityViews, s as compileProjectionFrom, t as DEFAULT_VIEW_PREFIX, u as compileProjectionPreview } from "./view-compiler-CLvZ0wJW.mjs";
 import { reconcile, runSync } from "./sync-engine.mjs";
 import { OPEN_STAGE_TYPE, isClosedStageType } from "./types.mjs";
+//#region src/deal-value.ts
+const MONTHS_PER_YEAR = 12;
+/** Only two decimal-free seat counts make sense; anything else is bad data. */
+const SEAT_COUNT_REGEX = /^\d+$/;
+/**
+* The value one deal should have, in cents, or null to leave it alone.
+*
+* Returning null rather than 0 for unusable input is deliberate (D33). A
+* renamed column would otherwise zero an entire pipeline silently, and a zeroed
+* board reads as a business problem rather than a configuration problem. The
+* unmapped case is surfaced through the rule-health warning surface instead of
+* being written into the data — the same fail-safe `matchesCondition` applies.
+*/
+function computeDealValue(source, fields, mappedFields, stageType) {
+	if (source.zeroInStageTypes?.includes(stageType)) return 0;
+	if (!(mappedFields.has(source.seatField) && mappedFields.has(source.planField))) return null;
+	const planKey = fields[source.planField];
+	if (planKey == null || planKey === "") return null;
+	const unitPriceCents = source.plans[planKey];
+	if (unitPriceCents === void 0) return null;
+	const rawSeats = fields[source.seatField];
+	if (rawSeats == null || !SEAT_COUNT_REGEX.test(rawSeats)) return null;
+	const seats = Number(rawSeats);
+	if (!Number.isSafeInteger(seats)) return null;
+	const monthly = (source.baseFeeCents ?? 0) + seats * unitPriceCents;
+	return source.intervalField !== void 0 && mappedFields.has(source.intervalField) && fields[source.intervalField] === "year" ? Math.round(monthly / MONTHS_PER_YEAR) : monthly;
+}
+//#endregion
+//#region src/host-owned-fields.ts
+/**
+* Which fields a CRM record lets a user edit.
+*
+* A record synced from the host app carries a `sourceRef`. Its identity fields
+* are rewritten from the host view on every sync run, so an edit to one would
+* be silently reverted minutes later — the user sees their change accepted,
+* then gone, with nothing explaining why. That is worse than refusing it.
+*
+* So host-owned fields are rejected at the API, not merely disabled in the UI:
+* the UI is not the security boundary, and the SDK and any future public API
+* reach the same routers.
+*
+* Records created inside the CRM have no `sourceRef` and are fully editable —
+* nothing else owns them.
+*
+* This is the cheap half of a capability matrix. It answers "may a user write
+* this?" but not "may the sync engine write this?", which stays implicit
+* because sync bypasses these routers entirely. An override model (the
+* `stageOverrideAt` pattern on `crm_deals`) can replace this later without
+* changing callers.
+*/
+/** Contact fields the host view owns when the row is synced. */
+const HOST_OWNED_CONTACT_FIELDS = ["email", "name"];
+/**
+* Company fields the host view owns when the row is synced.
+*
+* `email` and `phone` joined this list in the same change that made them
+* mappable (migration 0048). They are not identity fields, but ownership here
+* follows what sync rewrites, not what feels identity-like: both flow from the
+* host view on every run, exactly as `email` does for contacts above. Widening
+* `CANONICAL_FIELDS.company` without widening this list is the specific bug
+* this module's doc comment calls worse than refusing the edit.
+*
+* `primaryContactId` is deliberately absent: it is a CRM-side judgement about
+* who to talk to, never sourced from the host, so it stays editable on synced
+* rows.
+*/
+const HOST_OWNED_COMPANY_FIELDS = [
+	"domain",
+	"name",
+	"email",
+	"phone"
+];
+/**
+* True when the record is owned by a host view rather than by the CRM.
+*
+* Deliberately keyed on `sourceRef` and not `entityRole`: `entityRole` is a
+* mapping label that can be absent on a synced row, while `sourceRef` is the
+* identity the sync engine reconciles against and is set for exactly the rows
+* sync will rewrite.
+*/
+function isHostOwned(record) {
+	return Boolean(record.sourceRef);
+}
+function rejectedFields(record, patch, owned) {
+	if (!isHostOwned(record)) return [];
+	return owned.filter((field) => patch[field] !== void 0);
+}
+/**
+* Host-owned contact fields this patch would change, or `[]` when the patch is
+* allowed. Callers turn a non-empty result into a 400 naming the fields.
+*/
+function rejectedContactFields(contact, patch) {
+	return rejectedFields(contact, patch, HOST_OWNED_CONTACT_FIELDS);
+}
+/** Host-owned company fields this patch would change, or `[]`. */
+function rejectedCompanyFields(company, patch) {
+	return rejectedFields(company, patch, HOST_OWNED_COMPANY_FIELDS);
+}
+/**
+* The message shown when a write is refused. Names the fields and says where
+* they come from, so the reason is actionable rather than a bare "forbidden".
+*/
+function hostOwnedFieldMessage(fields) {
+	return `The ${fields.join(", ")} ${fields.length > 1 ? "fields are" : "field is"} synced from your app and cannot be edited here. Change it in your app and it will update on the next sync.`;
+}
+//#endregion
 //#region src/slug.ts
 /**
 * The one `slugify`.
@@ -150,4 +256,4 @@ function evaluateStage(rules, fields, mappedFields) {
 	return null;
 }
 //#endregion
-export { BASE_REF, CANONICAL_FIELDS, CRM_CONCEPTS, ClivlyConfigError, DEFAULT_VIEW_PREFIX, MATERIALIZING_CONCEPTS, OPEN_STAGE_TYPE, PREVIEW_MAX_ROWS, PROJECTION_KEY_PATTERN, REQUIRED_FIELDS, authCustom, buildFilterFromDiscriminator, buildRelationships, columnMetaFor, compileEntityView, compileEntityViews, compileProjectionFrom, compileProjectionIdentity, compileProjectionJoins, compileProjectionPreview, compileProjectionSelect, coversUniqueKey, defineClivlyConfig, entitiesConfigSchema, evaluateStage, explainEntitiesConfig, fanOutJoins, filterSchema, hasRichMeta, identityRefs, isClosedStageType, joinFansOut, mappingsToEntitiesConfig, matchesCondition, missingRequiredFields, primaryKeyColumns, projectionFields, projectionSchema, quoteIdent, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, requiredFieldsFor, runSync, slugify, toObjectTypeSlug, validateEntitiesConfig, validateProjection, validateProjectionFilter };
+export { BASE_REF, CANONICAL_FIELDS, CRM_CONCEPTS, ClivlyConfigError, DEFAULT_VIEW_PREFIX, MATERIALIZING_CONCEPTS, OPEN_STAGE_TYPE, PREVIEW_MAX_ROWS, PROJECTION_KEY_PATTERN, REQUIRED_FIELDS, authCustom, buildFilterFromDiscriminator, buildRelationships, columnMetaFor, compileEntityView, compileEntityViews, compileProjectionFrom, compileProjectionIdentity, compileProjectionJoins, compileProjectionPreview, compileProjectionSelect, computeDealValue, coversUniqueKey, defineClivlyConfig, entitiesConfigSchema, evaluateStage, explainEntitiesConfig, fanOutJoins, filterSchema, hasRichMeta, hostOwnedFieldMessage, identityRefs, isClosedStageType, isHostOwned, joinFansOut, mappingsToEntitiesConfig, matchesCondition, missingRequiredFields, primaryKeyColumns, projectionFields, projectionSchema, quoteIdent, reconcile, rejectedCompanyFields, rejectedContactFields, relationshipSchema, relationshipViaSignature, relationshipsSchema, requiredFieldsFor, runSync, slugify, toObjectTypeSlug, validateEntitiesConfig, validateProjection, validateProjectionFilter };

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-Ddgukq_E.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-Ddgukq_E.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-CqJknGOn.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) {