@clivly/core 0.11.0-next.0 → 0.11.0

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) {

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

package/dist/sync-engine.d.cts

@@ -1,4 +1,4 @@
-import { a as ClivlyEntitiesConfig } from "./entity-config-Ddgukq_E.cjs";
+import { a as ClivlyEntitiesConfig } from "./entity-config-OhC4Otkz.cjs";
 import { CompileOptions, CompiledView } from "./view-compiler.cjs";
 //#region src/sync-engine.d.ts
 /**
@@ -19,7 +19,7 @@ import { CompileOptions, CompiledView } from "./view-compiler.cjs";
  * package provides the concrete store.
  */
 /** A row read from a compiled view (what Postgres returns). */
-interface SourceRow {
+export interface SourceRow {
   /** Host-side company key from `<relationship>_ref`; resolved before persist. */
   companyRef?: string | null;
   /** Mapped identity fields (clivly field → value). */
@@ -28,14 +28,14 @@ interface SourceRow {
   sourceRef: string;
 }
 /** An existing mirror row, as far as reconciliation needs to know. */
-interface MirrorRecord {
+export interface MirrorRecord {
   archivedAt: Date | null;
   /** Host-side company key; only consulted in composite (join-table) mode. */
   companyRef: string | null;
   id: string;
   sourceRef: string;
 }
-type SyncAction = {
+export type SyncAction = {
   kind: "create";
   sourceRef: string;
   fields: Record<string, string | null>;
@@ -58,7 +58,7 @@ type SyncAction = {
   sourceRef: string;
 };
 /** A persist action with the company ref resolved to a `crm_companies.id`. */
-type PersistAction = {
+export type PersistAction = {
   kind: "create";
   sourceRef: string;
   fields: Record<string, string | null>;
@@ -99,11 +99,11 @@ type PersistAction = {
  * person in several companies materializes one mirror row per company and a
  * single membership leaving archives only that one row.
  */
-declare function reconcile(source: SourceRow[], mirror: MirrorRecord[], opts?: {
+export declare function reconcile(source: SourceRow[], mirror: MirrorRecord[], opts?: {
   composite?: boolean;
 }): SyncAction[];
 /** DB I/O port. The concrete store lives in the SDK/drizzle package. */
-interface SyncStore {
+export interface SyncStore {
   /** Current mirror rows for a concept + role (including archived). */
   listMirror(input: {
     concept: string;
@@ -129,7 +129,7 @@ interface SyncStore {
   /** Map host-side company refs → `crm_companies.id` (already-synced companies only). */
   resolveCompanyRefs(refs: string[]): Promise<Map<string, string>>;
 }
-interface EntitySyncResult {
+export interface EntitySyncResult {
   archived: number;
   concept: string;
   created: number;
@@ -138,7 +138,7 @@ interface EntitySyncResult {
   role: string;
   updated: number;
 }
-interface SyncResult {
+export interface SyncResult {
   entities: EntitySyncResult[];
   totals: {
     created: number;
@@ -151,12 +151,12 @@ interface SyncResult {
  * Run a full sync: compile the config's views, then reconcile + persist each,
  * companies first. Returns per-entity and total action counts.
  */
-declare function runSync(config: ClivlyEntitiesConfig, store: SyncStore, options?: CompileOptions): Promise<SyncResult>;
-interface PreviewWarning {
+export declare function runSync(config: ClivlyEntitiesConfig, store: SyncStore, options?: CompileOptions): Promise<SyncResult>;
+export interface PreviewWarning {
   field?: string;
   message: string;
 }
-interface PreviewResult {
+export interface PreviewResult {
   rows: SourceRow[];
   sampledCount: number;
   warnings: PreviewWarning[];
@@ -167,7 +167,7 @@ interface PreviewResult {
  * a required field empty in ≥1 row → `K/N` form; an optional field empty in
  * ALL rows → all-empty form; zero source rows → a single table-level warning.
  */
-declare function computeSampleWarnings(rows: SourceRow[], requiredFields: string[], sourceTable: string): PreviewWarning[];
+export declare function computeSampleWarnings(rows: SourceRow[], requiredFields: string[], sourceTable: string): PreviewWarning[];
 /**
  * Zero-write preview: read ≤`limit` rows through the compiled view (a pure
  * SELECT whose SQL already projects each row into its mapped fields) and
@@ -175,10 +175,9 @@ declare function computeSampleWarnings(rows: SourceRow[], requiredFields: string
  * so it can never mutate the mirror. The distinct, write-one-row sibling is
  * `runSync`'s sample mode (T13).
  */
-declare function previewSync(store: SyncStore, view: CompiledView, opts: {
+export declare function previewSync(store: SyncStore, view: CompiledView, opts: {
   limit: number;
   requiredFields: string[];
   sourceTable: string;
 }): Promise<PreviewResult>;
-//#endregion
-export { EntitySyncResult, MirrorRecord, PersistAction, PreviewResult, PreviewWarning, SourceRow, SyncAction, SyncResult, SyncStore, computeSampleWarnings, previewSync, reconcile, runSync };
+//#endregion

package/dist/sync-engine.d.mts

@@ -1,4 +1,4 @@
-import { a as ClivlyEntitiesConfig } from "./entity-config-Ddgukq_E.mjs";
+import { a as ClivlyEntitiesConfig } from "./entity-config-OhC4Otkz.mjs";
 import { CompileOptions, CompiledView } from "./view-compiler.mjs";
 //#region src/sync-engine.d.ts
 /**
@@ -19,7 +19,7 @@ import { CompileOptions, CompiledView } from "./view-compiler.mjs";
  * package provides the concrete store.
  */
 /** A row read from a compiled view (what Postgres returns). */
-interface SourceRow {
+export interface SourceRow {
   /** Host-side company key from `<relationship>_ref`; resolved before persist. */
   companyRef?: string | null;
   /** Mapped identity fields (clivly field → value). */
@@ -28,14 +28,14 @@ interface SourceRow {
   sourceRef: string;
 }
 /** An existing mirror row, as far as reconciliation needs to know. */
-interface MirrorRecord {
+export interface MirrorRecord {
   archivedAt: Date | null;
   /** Host-side company key; only consulted in composite (join-table) mode. */
   companyRef: string | null;
   id: string;
   sourceRef: string;
 }
-type SyncAction = {
+export type SyncAction = {
   kind: "create";
   sourceRef: string;
   fields: Record<string, string | null>;
@@ -58,7 +58,7 @@ type SyncAction = {
   sourceRef: string;
 };
 /** A persist action with the company ref resolved to a `crm_companies.id`. */
-type PersistAction = {
+export type PersistAction = {
   kind: "create";
   sourceRef: string;
   fields: Record<string, string | null>;
@@ -99,11 +99,11 @@ type PersistAction = {
  * person in several companies materializes one mirror row per company and a
  * single membership leaving archives only that one row.
  */
-declare function reconcile(source: SourceRow[], mirror: MirrorRecord[], opts?: {
+export declare function reconcile(source: SourceRow[], mirror: MirrorRecord[], opts?: {
   composite?: boolean;
 }): SyncAction[];
 /** DB I/O port. The concrete store lives in the SDK/drizzle package. */
-interface SyncStore {
+export interface SyncStore {
   /** Current mirror rows for a concept + role (including archived). */
   listMirror(input: {
     concept: string;
@@ -129,7 +129,7 @@ interface SyncStore {
   /** Map host-side company refs → `crm_companies.id` (already-synced companies only). */
   resolveCompanyRefs(refs: string[]): Promise<Map<string, string>>;
 }
-interface EntitySyncResult {
+export interface EntitySyncResult {
   archived: number;
   concept: string;
   created: number;
@@ -138,7 +138,7 @@ interface EntitySyncResult {
   role: string;
   updated: number;
 }
-interface SyncResult {
+export interface SyncResult {
   entities: EntitySyncResult[];
   totals: {
     created: number;
@@ -151,12 +151,12 @@ interface SyncResult {
  * Run a full sync: compile the config's views, then reconcile + persist each,
  * companies first. Returns per-entity and total action counts.
  */
-declare function runSync(config: ClivlyEntitiesConfig, store: SyncStore, options?: CompileOptions): Promise<SyncResult>;
-interface PreviewWarning {
+export declare function runSync(config: ClivlyEntitiesConfig, store: SyncStore, options?: CompileOptions): Promise<SyncResult>;
+export interface PreviewWarning {
   field?: string;
   message: string;
 }
-interface PreviewResult {
+export interface PreviewResult {
   rows: SourceRow[];
   sampledCount: number;
   warnings: PreviewWarning[];
@@ -167,7 +167,7 @@ interface PreviewResult {
  * a required field empty in ≥1 row → `K/N` form; an optional field empty in
  * ALL rows → all-empty form; zero source rows → a single table-level warning.
  */
-declare function computeSampleWarnings(rows: SourceRow[], requiredFields: string[], sourceTable: string): PreviewWarning[];
+export declare function computeSampleWarnings(rows: SourceRow[], requiredFields: string[], sourceTable: string): PreviewWarning[];
 /**
  * Zero-write preview: read ≤`limit` rows through the compiled view (a pure
  * SELECT whose SQL already projects each row into its mapped fields) and
@@ -175,10 +175,9 @@ declare function computeSampleWarnings(rows: SourceRow[], requiredFields: string
  * so it can never mutate the mirror. The distinct, write-one-row sibling is
  * `runSync`'s sample mode (T13).
  */
-declare function previewSync(store: SyncStore, view: CompiledView, opts: {
+export declare function previewSync(store: SyncStore, view: CompiledView, opts: {
   limit: number;
   requiredFields: string[];
   sourceTable: string;
 }): Promise<PreviewResult>;
-//#endregion
-export { EntitySyncResult, MirrorRecord, PersistAction, PreviewResult, PreviewWarning, SourceRow, SyncAction, SyncResult, SyncStore, computeSampleWarnings, previewSync, reconcile, runSync };
+//#endregion