clivly 0.11.0-next.0 → 0.12.0

package/internal-entity-heuristics.d.cts

@@ -1,13 +1,13 @@
-import { p as DiscoveredColumnMeta } from "./entity-config-CbS2DGmA.cjs";
+import { p as DiscoveredColumnMeta } from "./entity-config-ApnT5j3X.cjs";
 import { a as Scored } from "./mapping-score-D7Gzg7Ii.cjs";
 //#region ../core/src/entity-heuristics.d.ts
-declare const TARGET_CONCEPTS: readonly ["contact", "company", "deal", "activity", "conversation", "note"];
-type TargetConcept = (typeof TARGET_CONCEPTS)[number];
-declare function suggestCursorField(columnKeys: string[]): string | null;
-declare function matchesConcept(tableName: string, concept: TargetConcept): {
+export declare const TARGET_CONCEPTS: readonly ["contact", "company", "deal", "activity", "conversation", "note"];
+export type TargetConcept = (typeof TARGET_CONCEPTS)[number];
+export declare function suggestCursorField(columnKeys: string[]): string | null;
+export declare function matchesConcept(tableName: string, concept: TargetConcept): {
   exact: boolean;
 } | null;
-interface ScoredTable {
+export interface ScoredTable {
   columns: string[];
   columnsMeta?: DiscoveredColumnMeta[];
   name: string;
@@ -18,7 +18,7 @@ interface ScoredTable {
  * and from bulk apply, so one click can never map an auth table into the CRM.
  * They stay manually selectable — an explicit, informed choice is legitimate.
  */
-declare function hasSensitiveColumns(columns: string[]): boolean;
+export declare function hasSensitiveColumns(columns: string[]): boolean;
 /**
  * Is this table one your auth library created, rather than one you wrote?
  *
@@ -26,20 +26,20 @@ declare function hasSensitiveColumns(columns: string[]): boolean;
  * concept. Never to exclude them: mapping `user` as the contact entity is
  * legitimate for plenty of apps, and it stays selectable.
  */
-declare function isFrameworkTable(name: string): boolean;
-declare function hasDefiningColumn(concept: TargetConcept, columns: string[]): boolean;
-declare function scoreConcepts(table: ScoredTable): Scored<TargetConcept>[];
-declare function topConcept(table: ScoredTable): {
+export declare function isFrameworkTable(name: string): boolean;
+export declare function hasDefiningColumn(concept: TargetConcept, columns: string[]): boolean;
+export declare function scoreConcepts(table: ScoredTable): Scored<TargetConcept>[];
+export declare function topConcept(table: ScoredTable): {
   best: Scored<TargetConcept>;
   ambiguous: boolean;
 } | null;
-declare function requiredFieldsFor(concept: TargetConcept | "custom"): string[];
-declare function validateMapping(requiredFields: string[], fieldMap: Record<string, string>): {
+export declare function requiredFieldsFor(concept: TargetConcept | "custom"): string[];
+export declare function validateMapping(requiredFields: string[], fieldMap: Record<string, string>): {
   valid: boolean;
   missing: string[];
 };
-declare function suggestDiscriminatorColumns(columns: string[]): string[];
-type SuggestedVia = {
+export declare function suggestDiscriminatorColumns(columns: string[]): string[];
+export type SuggestedVia = {
   fkOn: "company" | "contact";
   column: string;
 } | {
@@ -47,7 +47,7 @@ type SuggestedVia = {
   localKey: string;
   foreignKey: string;
 };
-interface RelationshipSuggestion {
+export interface RelationshipSuggestion {
   /** The related host table. */
   entityTable: string;
   /** Suggested relationship name (defaults to the related concept). */
@@ -60,13 +60,13 @@ interface RelationshipSuggestion {
  * that scores highest. Without metadata (v1 hosts) we fall back to the legacy
  * FK-name hints at a lower tier.
  */
-declare function scoreRelationships(source: ScoredTable, allTables: ScoredTable[]): Scored<RelationshipSuggestion>[];
-interface FieldSuggestion {
+export declare function scoreRelationships(source: ScoredTable, allTables: ScoredTable[]): Scored<RelationshipSuggestion>[];
+export interface FieldSuggestion {
   column: string;
   field: string;
   required: boolean;
 }
-declare function scoreFieldMap(concept: TargetConcept, table: ScoredTable): Scored<FieldSuggestion>[];
-declare function toFieldMap(scored: Scored<FieldSuggestion>[]): Record<string, string>;
+export declare function scoreFieldMap(concept: TargetConcept, table: ScoredTable): Scored<FieldSuggestion>[];
+export declare function toFieldMap(scored: Scored<FieldSuggestion>[]): Record<string, string>;
 //#endregion
-export { type DiscoveredColumnMeta, FieldSuggestion, RelationshipSuggestion, ScoredTable, SuggestedVia, TARGET_CONCEPTS, TargetConcept, hasDefiningColumn, hasSensitiveColumns, isFrameworkTable, matchesConcept, requiredFieldsFor, scoreConcepts, scoreFieldMap, scoreRelationships, suggestCursorField, suggestDiscriminatorColumns, toFieldMap, topConcept, validateMapping };
+export type { DiscoveredColumnMeta };

package/internal-entity-heuristics.d.mts

@@ -1,13 +1,13 @@
-import { p as DiscoveredColumnMeta } from "./entity-config-CbS2DGmA.mjs";
+import { p as DiscoveredColumnMeta } from "./entity-config-CKcj4-M_.mjs";
 import { a as Scored } from "./mapping-score-D7Gzg7Ii.mjs";
 //#region ../core/src/entity-heuristics.d.ts
-declare const TARGET_CONCEPTS: readonly ["contact", "company", "deal", "activity", "conversation", "note"];
-type TargetConcept = (typeof TARGET_CONCEPTS)[number];
-declare function suggestCursorField(columnKeys: string[]): string | null;
-declare function matchesConcept(tableName: string, concept: TargetConcept): {
+export declare const TARGET_CONCEPTS: readonly ["contact", "company", "deal", "activity", "conversation", "note"];
+export type TargetConcept = (typeof TARGET_CONCEPTS)[number];
+export declare function suggestCursorField(columnKeys: string[]): string | null;
+export declare function matchesConcept(tableName: string, concept: TargetConcept): {
   exact: boolean;
 } | null;
-interface ScoredTable {
+export interface ScoredTable {
   columns: string[];
   columnsMeta?: DiscoveredColumnMeta[];
   name: string;
@@ -18,7 +18,7 @@ interface ScoredTable {
  * and from bulk apply, so one click can never map an auth table into the CRM.
  * They stay manually selectable — an explicit, informed choice is legitimate.
  */
-declare function hasSensitiveColumns(columns: string[]): boolean;
+export declare function hasSensitiveColumns(columns: string[]): boolean;
 /**
  * Is this table one your auth library created, rather than one you wrote?
  *
@@ -26,20 +26,20 @@ declare function hasSensitiveColumns(columns: string[]): boolean;
  * concept. Never to exclude them: mapping `user` as the contact entity is
  * legitimate for plenty of apps, and it stays selectable.
  */
-declare function isFrameworkTable(name: string): boolean;
-declare function hasDefiningColumn(concept: TargetConcept, columns: string[]): boolean;
-declare function scoreConcepts(table: ScoredTable): Scored<TargetConcept>[];
-declare function topConcept(table: ScoredTable): {
+export declare function isFrameworkTable(name: string): boolean;
+export declare function hasDefiningColumn(concept: TargetConcept, columns: string[]): boolean;
+export declare function scoreConcepts(table: ScoredTable): Scored<TargetConcept>[];
+export declare function topConcept(table: ScoredTable): {
   best: Scored<TargetConcept>;
   ambiguous: boolean;
 } | null;
-declare function requiredFieldsFor(concept: TargetConcept | "custom"): string[];
-declare function validateMapping(requiredFields: string[], fieldMap: Record<string, string>): {
+export declare function requiredFieldsFor(concept: TargetConcept | "custom"): string[];
+export declare function validateMapping(requiredFields: string[], fieldMap: Record<string, string>): {
   valid: boolean;
   missing: string[];
 };
-declare function suggestDiscriminatorColumns(columns: string[]): string[];
-type SuggestedVia = {
+export declare function suggestDiscriminatorColumns(columns: string[]): string[];
+export type SuggestedVia = {
   fkOn: "company" | "contact";
   column: string;
 } | {
@@ -47,7 +47,7 @@ type SuggestedVia = {
   localKey: string;
   foreignKey: string;
 };
-interface RelationshipSuggestion {
+export interface RelationshipSuggestion {
   /** The related host table. */
   entityTable: string;
   /** Suggested relationship name (defaults to the related concept). */
@@ -60,13 +60,13 @@ interface RelationshipSuggestion {
  * that scores highest. Without metadata (v1 hosts) we fall back to the legacy
  * FK-name hints at a lower tier.
  */
-declare function scoreRelationships(source: ScoredTable, allTables: ScoredTable[]): Scored<RelationshipSuggestion>[];
-interface FieldSuggestion {
+export declare function scoreRelationships(source: ScoredTable, allTables: ScoredTable[]): Scored<RelationshipSuggestion>[];
+export interface FieldSuggestion {
   column: string;
   field: string;
   required: boolean;
 }
-declare function scoreFieldMap(concept: TargetConcept, table: ScoredTable): Scored<FieldSuggestion>[];
-declare function toFieldMap(scored: Scored<FieldSuggestion>[]): Record<string, string>;
+export declare function scoreFieldMap(concept: TargetConcept, table: ScoredTable): Scored<FieldSuggestion>[];
+export declare function toFieldMap(scored: Scored<FieldSuggestion>[]): Record<string, string>;
 //#endregion
-export { type DiscoveredColumnMeta, FieldSuggestion, RelationshipSuggestion, ScoredTable, SuggestedVia, TARGET_CONCEPTS, TargetConcept, hasDefiningColumn, hasSensitiveColumns, isFrameworkTable, matchesConcept, requiredFieldsFor, scoreConcepts, scoreFieldMap, scoreRelationships, suggestCursorField, suggestDiscriminatorColumns, toFieldMap, topConcept, validateMapping };
+export type { DiscoveredColumnMeta };

package/internal-entity-heuristics.mjs

@@ -1,4 +1,4 @@
-import { a as MATERIALIZING_CONCEPTS } from "./entity-config-CO0TEwZC.mjs";
+import { a as MATERIALIZING_CONCEPTS } from "./entity-config-Ccfb2IL9.mjs";
 import { a as W, c as isTextLike, i as RELATIONSHIP_TIERS, l as isTimestampLike, n as CONCEPT_TIERS, o as isAmbiguous, r as FIELD_TIERS, s as isNumericLike, u as tierFor } from "./mapping-score-C68uAqGB.mjs";
 //#region ../core/src/entity-heuristics.ts
 const TARGET_CONCEPTS = [
@@ -378,12 +378,14 @@ function scoreConcepts(table) {
 			score += W.hasPrimaryKey;
 			reasons.push("has primary key");
 		}
-		if (table.rowCount !== void 0) if (table.rowCount === 0) {
-			score += W.emptyTable;
-			reasons.push("table is empty");
-		} else {
-			score += W.hasRows;
-			reasons.push(`${table.rowCount.toLocaleString("en-US")} rows`);
+		if (table.rowCount !== void 0) {
+			if (table.rowCount === 0) {
+				score += W.emptyTable;
+				reasons.push("table is empty");
+			} else {
+				score += W.hasRows;
+				reasons.push(`${table.rowCount.toLocaleString("en-US")} rows`);
+			}
 		}
 		out.push({
 			value: concept,

package/internal-mapping-form.d.cts

@@ -1,2 +1,2 @@
-import { i as relationshipViaSignature, n as buildFilterFromDiscriminator, r as buildRelationships, t as RelationshipCandidate } from "./mapping-form-BBgP1iEf.cjs";
+import { i as relationshipViaSignature, n as buildFilterFromDiscriminator, r as buildRelationships, t as RelationshipCandidate } from "./mapping-form-XsLLCqW_.cjs";
 export { RelationshipCandidate, buildFilterFromDiscriminator, buildRelationships, relationshipViaSignature };

package/internal-mapping-form.d.mts

@@ -1,2 +1,2 @@
-import { i as relationshipViaSignature, n as buildFilterFromDiscriminator, r as buildRelationships, t as RelationshipCandidate } from "./mapping-form-B_vX_kZJ.mjs";
+import { i as relationshipViaSignature, n as buildFilterFromDiscriminator, r as buildRelationships, t as RelationshipCandidate } from "./mapping-form-Btn-7gzv.mjs";
 export { RelationshipCandidate, buildFilterFromDiscriminator, buildRelationships, relationshipViaSignature };

package/internal-mappings-config.cjs

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

package/internal-mappings-config.d.cts

@@ -1,2 +1,2 @@
-import { i as mappingsToEntitiesConfig, n as MappingFromConfig, r as entitiesToMappings, t as EntityMappingRow } from "./mappings-config-Cvw7RDSb.cjs";
+import { i as mappingsToEntitiesConfig, n as MappingFromConfig, r as entitiesToMappings, t as EntityMappingRow } from "./mappings-config-iJzbcUMp.cjs";
 export { EntityMappingRow, MappingFromConfig, entitiesToMappings, mappingsToEntitiesConfig };

package/internal-mappings-config.d.mts

@@ -1,2 +1,2 @@
-import { i as mappingsToEntitiesConfig, n as MappingFromConfig, r as entitiesToMappings, t as EntityMappingRow } from "./mappings-config-BXdSUl-K.mjs";
+import { i as mappingsToEntitiesConfig, n as MappingFromConfig, r as entitiesToMappings, t as EntityMappingRow } from "./mappings-config-D6_oCi2Q.mjs";
 export { EntityMappingRow, MappingFromConfig, entitiesToMappings, mappingsToEntitiesConfig };

package/internal-mappings-config.mjs

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

package/internal-sync-engine.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sync_engine = require("./sync-engine-B0FT1ax6.cjs");
+const require_sync_engine = require("./sync-engine-Dwm_KDUS.cjs");
 exports.computeSampleWarnings = require_sync_engine.computeSampleWarnings;
 exports.previewSync = require_sync_engine.previewSync;
 exports.reconcile = require_sync_engine.reconcile;

package/internal-sync-engine.d.cts

@@ -1,2 +1,2 @@
-import { a as PreviewWarning, c as SyncResult, d as previewSync, f as reconcile, i as PreviewResult, l as SyncStore, n as MirrorRecord, o as SourceRow, p as runSync, r as PersistAction, s as SyncAction, t as EntitySyncResult, u as computeSampleWarnings } from "./sync-engine-qxbrOEJX.cjs";
+import { a as PreviewWarning, c as SyncResult, d as previewSync, f as reconcile, i as PreviewResult, l as SyncStore, n as MirrorRecord, o as SourceRow, p as runSync, r as PersistAction, s as SyncAction, t as EntitySyncResult, u as computeSampleWarnings } from "./sync-engine-V3_UutGv.cjs";
 export { EntitySyncResult, MirrorRecord, PersistAction, PreviewResult, PreviewWarning, SourceRow, SyncAction, SyncResult, SyncStore, computeSampleWarnings, previewSync, reconcile, runSync };

package/internal-sync-engine.d.mts

@@ -1,2 +1,2 @@
-import { a as PreviewWarning, c as SyncResult, d as previewSync, f as reconcile, i as PreviewResult, l as SyncStore, n as MirrorRecord, o as SourceRow, p as runSync, r as PersistAction, s as SyncAction, t as EntitySyncResult, u as computeSampleWarnings } from "./sync-engine-BQRApDAG.mjs";
+import { a as PreviewWarning, c as SyncResult, d as previewSync, f as reconcile, i as PreviewResult, l as SyncStore, n as MirrorRecord, o as SourceRow, p as runSync, r as PersistAction, s as SyncAction, t as EntitySyncResult, u as computeSampleWarnings } from "./sync-engine--M9EaONC.mjs";
 export { EntitySyncResult, MirrorRecord, PersistAction, PreviewResult, PreviewWarning, SourceRow, SyncAction, SyncResult, SyncStore, computeSampleWarnings, previewSync, reconcile, runSync };

package/internal-sync-engine.mjs

@@ -1,2 +1,2 @@
-import { i as runSync, n as previewSync, r as reconcile, t as computeSampleWarnings } from "./sync-engine-CTSIcLlZ.mjs";
+import { i as runSync, n as previewSync, r as reconcile, t as computeSampleWarnings } from "./sync-engine-Df2MCs_n.mjs";
 export { computeSampleWarnings, previewSync, reconcile, runSync };

package/internal-types.d.cts

@@ -1,2 +1,2 @@
-import { A as ValueInterval, C as TaskEntityType, D as UpdateContactInput, E as TaskStatus, O as UpdateDealInput, S as Task, T as TaskPriority, _ as PipelineConfig, a as ContactFilters, b as RecordSource, c as CreateCompanyInput, d as CreateTaskInput, f as CrmRole, g as OPEN_STAGE_TYPE, h as Note, i as Contact, j as isClosedStageType, k as UpdateTaskInput, l as CreateContactInput, m as DealStage, n as ActivityType, o as ContactStatus, p as Deal, r as Company, s as CreateActivityInput, t as Activity, u as CreateDealInput, v as PipelineKind, w as TaskFilters, x as StageType, y as PipelineStageConfig } from "./types-S0N0hqOV.cjs";
-export { Activity, ActivityType, Company, Contact, ContactFilters, ContactStatus, CreateActivityInput, CreateCompanyInput, CreateContactInput, CreateDealInput, CreateTaskInput, CrmRole, Deal, DealStage, Note, OPEN_STAGE_TYPE, PipelineConfig, PipelineKind, PipelineStageConfig, RecordSource, StageType, Task, TaskEntityType, TaskFilters, TaskPriority, TaskStatus, UpdateContactInput, UpdateDealInput, UpdateTaskInput, ValueInterval, isClosedStageType };
+import { A as UpdateCompanyInput, C as RecordSource, D as TaskFilters, E as TaskEntityType, F as isClosedStageType, M as UpdateDealInput, N as UpdateTaskInput, O as TaskPriority, P as ValueInterval, S as PipelineStageConfig, T as Task, _ as OPEN_STAGE_TYPE, a as Contact, b as PipelineConfig, c as CreateActivityInput, d as CreateDealInput, f as CreateTaskInput, g as Note, h as DealStage, i as CompanyFilters, j as UpdateContactInput, k as TaskStatus, l as CreateCompanyInput, m as Deal, n as ActivityType, o as ContactFilters, p as CrmRole, r as Company, s as ContactStatus, t as Activity, u as CreateContactInput, v as Page, w as StageType, x as PipelineKind, y as PageRequest } from "./types-B17TWEOL.cjs";
+export { Activity, ActivityType, Company, CompanyFilters, Contact, ContactFilters, ContactStatus, CreateActivityInput, CreateCompanyInput, CreateContactInput, CreateDealInput, CreateTaskInput, CrmRole, Deal, DealStage, Note, OPEN_STAGE_TYPE, Page, PageRequest, PipelineConfig, PipelineKind, PipelineStageConfig, RecordSource, StageType, Task, TaskEntityType, TaskFilters, TaskPriority, TaskStatus, UpdateCompanyInput, UpdateContactInput, UpdateDealInput, UpdateTaskInput, ValueInterval, isClosedStageType };

package/internal-types.d.mts

@@ -1,2 +1,2 @@
-import { A as ValueInterval, C as TaskEntityType, D as UpdateContactInput, E as TaskStatus, O as UpdateDealInput, S as Task, T as TaskPriority, _ as PipelineConfig, a as ContactFilters, b as RecordSource, c as CreateCompanyInput, d as CreateTaskInput, f as CrmRole, g as OPEN_STAGE_TYPE, h as Note, i as Contact, j as isClosedStageType, k as UpdateTaskInput, l as CreateContactInput, m as DealStage, n as ActivityType, o as ContactStatus, p as Deal, r as Company, s as CreateActivityInput, t as Activity, u as CreateDealInput, v as PipelineKind, w as TaskFilters, x as StageType, y as PipelineStageConfig } from "./types-S0N0hqOV.mjs";
-export { Activity, ActivityType, Company, Contact, ContactFilters, ContactStatus, CreateActivityInput, CreateCompanyInput, CreateContactInput, CreateDealInput, CreateTaskInput, CrmRole, Deal, DealStage, Note, OPEN_STAGE_TYPE, PipelineConfig, PipelineKind, PipelineStageConfig, RecordSource, StageType, Task, TaskEntityType, TaskFilters, TaskPriority, TaskStatus, UpdateContactInput, UpdateDealInput, UpdateTaskInput, ValueInterval, isClosedStageType };
+import { A as UpdateCompanyInput, C as RecordSource, D as TaskFilters, E as TaskEntityType, F as isClosedStageType, M as UpdateDealInput, N as UpdateTaskInput, O as TaskPriority, P as ValueInterval, S as PipelineStageConfig, T as Task, _ as OPEN_STAGE_TYPE, a as Contact, b as PipelineConfig, c as CreateActivityInput, d as CreateDealInput, f as CreateTaskInput, g as Note, h as DealStage, i as CompanyFilters, j as UpdateContactInput, k as TaskStatus, l as CreateCompanyInput, m as Deal, n as ActivityType, o as ContactFilters, p as CrmRole, r as Company, s as ContactStatus, t as Activity, u as CreateContactInput, v as Page, w as StageType, x as PipelineKind, y as PageRequest } from "./types-B17TWEOL.mjs";
+export { Activity, ActivityType, Company, CompanyFilters, Contact, ContactFilters, ContactStatus, CreateActivityInput, CreateCompanyInput, CreateContactInput, CreateDealInput, CreateTaskInput, CrmRole, Deal, DealStage, Note, OPEN_STAGE_TYPE, Page, PageRequest, PipelineConfig, PipelineKind, PipelineStageConfig, RecordSource, StageType, Task, TaskEntityType, TaskFilters, TaskPriority, TaskStatus, UpdateCompanyInput, UpdateContactInput, UpdateDealInput, UpdateTaskInput, ValueInterval, isClosedStageType };

package/{internal-Bgiimp5D.mjs → internal-u0Bks5Gr.mjs}

@@ -1,3 +1,109 @@
+//#region ../core/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 ../core/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 ../core/src/slug.ts
 /**
 * The one `slugify`.
@@ -141,4 +247,4 @@ function evaluateStage(rules, fields, mappedFields) {
 	return null;
 }
 //#endregion
-export { toObjectTypeSlug as i, matchesCondition as n, slugify as r, evaluateStage as t };
+export { hostOwnedFieldMessage as a, rejectedContactFields as c, toObjectTypeSlug as i, computeDealValue as l, matchesCondition as n, isHostOwned as o, slugify as r, rejectedCompanyFields as s, evaluateStage as t };

package/{internal-DEV1NCQc.d.mts → internal-vH5Rlg6Q.d.cts}

@@ -1,4 +1,106 @@
-import { L as ProjectionJoin, R as ProjectionMapping, h as FilterExpr, l as ConfigValidationError, m as DiscoveredSchemaTable, p as DiscoveredColumnMeta } from "./entity-config-CbS2DGmA.mjs";
+import { L as ProjectionJoin, R as ProjectionMapping, h as FilterExpr, l as ConfigValidationError, m as DiscoveredSchemaTable, p as DiscoveredColumnMeta } from "./entity-config-ApnT5j3X.cjs";
+//#region ../core/src/deal-value.d.ts
+/**
+ * Value derived as a flat fee plus a per-seat price that depends on the plan.
+ *
+ * Every field name is configuration and every plan key is data, so a second
+ * subscription business configures this without a code change. The formula is
+ * fixed with named slots rather than an expression language — the same choice
+ * D8 made for stage-rule conditions.
+ */
+interface PerSeatValueSource {
+  /** Flat monthly fee in cents, added before the interval is normalised. */
+  baseFeeCents?: number;
+  /** Mapped column holding "month" or "year". Absent means always monthly. */
+  intervalField?: string;
+  kind: "per_seat";
+  /** Mapped column holding the plan key. */
+  planField: string;
+  /** Unit price in cents, keyed by the value found in `planField`. */
+  plans: Record<string, number>;
+  /** Mapped column holding the seat count. */
+  seatField: string;
+  /** Stage types whose deals are worth nothing (usually `["lost"]`). */
+  zeroInStageTypes?: string[];
+}
+/**
+ * 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.
+ */
+declare function computeDealValue(source: PerSeatValueSource, fields: Record<string, string | null>, mappedFields: Set<string>, stageType: string): number | null;
+//#endregion
+//#region ../core/src/host-owned-fields.d.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. */
+declare const HOST_OWNED_CONTACT_FIELDS: readonly ["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.
+ */
+declare const HOST_OWNED_COMPANY_FIELDS: readonly ["domain", "name", "email", "phone"];
+type HostOwnedContactField = (typeof HOST_OWNED_CONTACT_FIELDS)[number];
+type HostOwnedCompanyField = (typeof HOST_OWNED_COMPANY_FIELDS)[number];
+/** The subset of a record this module needs to make its decision. */
+interface SourcedRecord {
+  sourceRef?: string | null;
+}
+/**
+ * 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.
+ */
+declare function isHostOwned(record: SourcedRecord): boolean;
+/**
+ * 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.
+ */
+declare function rejectedContactFields(contact: SourcedRecord, patch: Readonly<Record<string, unknown>>): HostOwnedContactField[];
+/** Host-owned company fields this patch would change, or `[]`. */
+declare function rejectedCompanyFields(company: SourcedRecord, patch: Readonly<Record<string, unknown>>): HostOwnedCompanyField[];
+/**
+ * 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".
+ */
+declare function hostOwnedFieldMessage(fields: readonly string[]): string;
+//#endregion
 //#region ../core/src/projection-cardinality.d.ts
 declare function joinFansOut(join: ProjectionJoin, joinTable: DiscoveredSchemaTable): boolean;
 /** Every join in the projection that can multiply rows. */
@@ -223,4 +325,4 @@ declare function matchesCondition(condition: Condition, fields: Record<string, s
  */
 declare function evaluateStage(rules: EvaluableRule[], fields: Record<string, string | null>, mappedFields: Set<string>): string | null;
 //#endregion
-export { joinFansOut as S, compileProjectionJoins as _, matchesCondition as a, quoteIdent as b, columnMetaFor as c, primaryKeyColumns as d, validateProjection as f, compileProjectionIdentity as g, compileProjectionFrom as h, evaluateStage as i, coversUniqueKey as l, PREVIEW_MAX_ROWS as m, ConditionOp as n, slugify as o, validateProjectionFilter as p, EvaluableRule as r, toObjectTypeSlug as s, Condition as t, hasRichMeta as u, compileProjectionPreview as v, fanOutJoins as x, compileProjectionSelect as y };
+export { PerSeatValueSource as A, HostOwnedCompanyField as C, isHostOwned as D, hostOwnedFieldMessage as E, rejectedCompanyFields as O, joinFansOut as S, SourcedRecord as T, compileProjectionJoins as _, matchesCondition as a, quoteIdent as b, columnMetaFor as c, primaryKeyColumns as d, validateProjection as f, compileProjectionIdentity as g, compileProjectionFrom as h, evaluateStage as i, computeDealValue as j, rejectedContactFields as k, coversUniqueKey as l, PREVIEW_MAX_ROWS as m, ConditionOp as n, slugify as o, validateProjectionFilter as p, EvaluableRule as r, toObjectTypeSlug as s, Condition as t, hasRichMeta as u, compileProjectionPreview as v, HostOwnedContactField as w, fanOutJoins as x, compileProjectionSelect as y };

package/internal-view-compiler.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_view_compiler = require("./view-compiler-ZKZbd3SK.cjs");
+const require_view_compiler = require("./view-compiler-xiwm5iar.cjs");
 exports.DEFAULT_VIEW_PREFIX = require_view_compiler.DEFAULT_VIEW_PREFIX;
 exports.compileEntityView = require_view_compiler.compileEntityView;
 exports.compileEntityViews = require_view_compiler.compileEntityViews;

package/internal-view-compiler.d.cts

@@ -1,2 +1,2 @@
-import { a as compileEntityView, c as explainViewExecutionError, i as ExplainResult, n as CompiledView, o as compileEntityViews, r as DEFAULT_VIEW_PREFIX, s as explainEntitiesConfig, t as CompileOptions } from "./view-compiler-P4GHpOHt.cjs";
+import { a as compileEntityView, c as explainViewExecutionError, i as ExplainResult, n as CompiledView, o as compileEntityViews, r as DEFAULT_VIEW_PREFIX, s as explainEntitiesConfig, t as CompileOptions } from "./view-compiler-Cq8apvZ4.cjs";
 export { CompileOptions, CompiledView, DEFAULT_VIEW_PREFIX, ExplainResult, compileEntityView, compileEntityViews, explainEntitiesConfig, explainViewExecutionError };

package/internal-view-compiler.d.mts

@@ -1,2 +1,2 @@
-import { a as compileEntityView, c as explainViewExecutionError, i as ExplainResult, n as CompiledView, o as compileEntityViews, r as DEFAULT_VIEW_PREFIX, s as explainEntitiesConfig, t as CompileOptions } from "./view-compiler-CdnLqPQx.mjs";
+import { a as compileEntityView, c as explainViewExecutionError, i as ExplainResult, n as CompiledView, o as compileEntityViews, r as DEFAULT_VIEW_PREFIX, s as explainEntitiesConfig, t as CompileOptions } from "./view-compiler-CwKVoK1w.mjs";
 export { CompileOptions, CompiledView, DEFAULT_VIEW_PREFIX, ExplainResult, compileEntityView, compileEntityViews, explainEntitiesConfig, explainViewExecutionError };

package/internal-view-compiler.mjs

@@ -1,2 +1,2 @@
-import { a as explainViewExecutionError, i as explainEntitiesConfig, n as compileEntityView, r as compileEntityViews, t as DEFAULT_VIEW_PREFIX } from "./view-compiler-BzKk8nY3.mjs";
+import { a as explainViewExecutionError, i as explainEntitiesConfig, n as compileEntityView, r as compileEntityViews, t as DEFAULT_VIEW_PREFIX } from "./view-compiler-C-6RydKK.mjs";
 export { DEFAULT_VIEW_PREFIX, compileEntityView, compileEntityViews, explainEntitiesConfig, explainViewExecutionError };

package/internal.cjs

@@ -1,13 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_projection = require("./projection-Dz6_i1-w.cjs");
-const require_entity_config = require("./entity-config-EZg9BtqD.cjs");
-const require_mappings_config = require("./mappings-config-BRP_Dev5.cjs");
+const require_projection = require("./projection-BELgANG2.cjs");
+const require_entity_config = require("./entity-config-BI4RYNKL.cjs");
+const require_mappings_config = require("./mappings-config-BCsRLohT.cjs");
 const require_auth_adapter = require("./auth-adapter-CiEXcweZ.cjs");
+const require_internal = require("./internal-BxtvxF7Z.cjs");
 const require_mapping_form = require("./mapping-form-BpfON_ME.cjs");
-const require_projection_sql = require("./projection-sql-CbXCKt3s.cjs");
-const require_internal = require("./internal-Cz59xMj8.cjs");
-const require_view_compiler = require("./view-compiler-ZKZbd3SK.cjs");
-const require_sync_engine = require("./sync-engine-B0FT1ax6.cjs");
+const require_projection_sql = require("./projection-sql-DuCtFE9t.cjs");
+const require_view_compiler = require("./view-compiler-xiwm5iar.cjs");
+const require_sync_engine = require("./sync-engine-Dwm_KDUS.cjs");
 const require_types = require("./types-Cq5gHCTq.cjs");
 exports.BASE_REF = require_projection.BASE_REF;
 exports.CANONICAL_FIELDS = require_entity_config.CANONICAL_FIELDS;
@@ -30,6 +30,7 @@ exports.compileProjectionIdentity = require_projection_sql.compileProjectionIden
 exports.compileProjectionJoins = require_projection_sql.compileProjectionJoins;
 exports.compileProjectionPreview = require_projection_sql.compileProjectionPreview;
 exports.compileProjectionSelect = require_projection_sql.compileProjectionSelect;
+exports.computeDealValue = require_internal.computeDealValue;
 exports.coversUniqueKey = require_entity_config.coversUniqueKey;
 exports.defineClivlyConfig = require_entity_config.defineClivlyConfig;
 exports.entitiesConfigSchema = require_entity_config.entitiesConfigSchema;
@@ -38,8 +39,10 @@ exports.explainEntitiesConfig = require_view_compiler.explainEntitiesConfig;
 exports.fanOutJoins = require_entity_config.fanOutJoins;
 exports.filterSchema = require_entity_config.filterSchema;
 exports.hasRichMeta = require_entity_config.hasRichMeta;
+exports.hostOwnedFieldMessage = require_internal.hostOwnedFieldMessage;
 exports.identityRefs = require_projection.identityRefs;
 exports.isClosedStageType = require_types.isClosedStageType;
+exports.isHostOwned = require_internal.isHostOwned;
 exports.joinFansOut = require_entity_config.joinFansOut;
 exports.mappingsToEntitiesConfig = require_mappings_config.mappingsToEntitiesConfig;
 exports.matchesCondition = require_internal.matchesCondition;
@@ -49,6 +52,8 @@ exports.projectionFields = require_entity_config.projectionFields;
 exports.projectionSchema = require_projection.projectionSchema;
 exports.quoteIdent = require_projection_sql.quoteIdent;
 exports.reconcile = require_sync_engine.reconcile;
+exports.rejectedCompanyFields = require_internal.rejectedCompanyFields;
+exports.rejectedContactFields = require_internal.rejectedContactFields;
 exports.relationshipSchema = require_entity_config.relationshipSchema;
 exports.relationshipViaSignature = require_mapping_form.relationshipViaSignature;
 exports.relationshipsSchema = require_entity_config.relationshipsSchema;