@clivly/core 0.11.0 → 0.12.0

package/dist/adapter.d.cts

@@ -1,4 +1,4 @@
-import { Activity, Company, CompanyFilters, Contact, ContactFilters, CreateActivityInput, CreateCompanyInput, CreateContactInput, CreateDealInput, CreateTaskInput, Deal, RecordSource, Task, TaskFilters, UpdateCompanyInput, UpdateContactInput, UpdateDealInput, UpdateTaskInput } from "./types.cjs";
+import { Activity, Company, CompanyFilters, Contact, ContactFilters, CreateActivityInput, CreateCompanyInput, CreateContactInput, CreateDealInput, CreateTaskInput, Deal, Page, PageRequest, RecordSource, Task, TaskFilters, UpdateCompanyInput, UpdateContactInput, UpdateDealInput, UpdateTaskInput } from "./types.cjs";
 //#region src/adapter.d.ts
 /**
  * The contract every ORM implementation fulfils. `packages/drizzle` is the first
@@ -58,6 +58,24 @@ export interface CRMAdapter {
     source?: RecordSource;
   }): Promise<Deal[]>;
   getTasks(orgId: string, filters?: TaskFilters): Promise<Task[]>;
+  /**
+   * One page of companies, newest first.
+   *
+   * Separate from `getCompanies` rather than a `limit` on `CompanyFilters`,
+   * and that is the whole point: an optional field on a shared filter type is
+   * silently inheritable, and the callers that must never inherit it are the
+   * ones where truncation corrupts data rather than merely hiding rows.
+   * `importContacts` builds its dedup set from the unpaged read — a truncated
+   * set resurrects a contact archived as a duplicate. A distinct method makes
+   * "this call is paginated" a decision at every call site.
+   */
+  listCompaniesPage(orgId: string, filters?: CompanyFilters, page?: PageRequest): Promise<Page<Company>>;
+  /** One page of contacts, newest first. See {@link CRMAdapter.listCompaniesPage}. */
+  listContactsPage(orgId: string, filters?: ContactFilters, page?: PageRequest): Promise<Page<Contact>>;
+  /** One page of deals, newest first. See {@link CRMAdapter.listCompaniesPage}. */
+  listDealsPage(orgId: string, filters?: {
+    source?: RecordSource;
+  }, page?: PageRequest): Promise<Page<Deal>>;
   /**
    * Move a deal to `stage` and reorder it directly after `afterId` (null = top
    * of the column). The adapter computes the fractional `position` from the

package/dist/adapter.d.mts

@@ -1,4 +1,4 @@
-import { Activity, Company, CompanyFilters, Contact, ContactFilters, CreateActivityInput, CreateCompanyInput, CreateContactInput, CreateDealInput, CreateTaskInput, Deal, RecordSource, Task, TaskFilters, UpdateCompanyInput, UpdateContactInput, UpdateDealInput, UpdateTaskInput } from "./types.mjs";
+import { Activity, Company, CompanyFilters, Contact, ContactFilters, CreateActivityInput, CreateCompanyInput, CreateContactInput, CreateDealInput, CreateTaskInput, Deal, Page, PageRequest, RecordSource, Task, TaskFilters, UpdateCompanyInput, UpdateContactInput, UpdateDealInput, UpdateTaskInput } from "./types.mjs";
 //#region src/adapter.d.ts
 /**
  * The contract every ORM implementation fulfils. `packages/drizzle` is the first
@@ -58,6 +58,24 @@ export interface CRMAdapter {
     source?: RecordSource;
   }): Promise<Deal[]>;
   getTasks(orgId: string, filters?: TaskFilters): Promise<Task[]>;
+  /**
+   * One page of companies, newest first.
+   *
+   * Separate from `getCompanies` rather than a `limit` on `CompanyFilters`,
+   * and that is the whole point: an optional field on a shared filter type is
+   * silently inheritable, and the callers that must never inherit it are the
+   * ones where truncation corrupts data rather than merely hiding rows.
+   * `importContacts` builds its dedup set from the unpaged read — a truncated
+   * set resurrects a contact archived as a duplicate. A distinct method makes
+   * "this call is paginated" a decision at every call site.
+   */
+  listCompaniesPage(orgId: string, filters?: CompanyFilters, page?: PageRequest): Promise<Page<Company>>;
+  /** One page of contacts, newest first. See {@link CRMAdapter.listCompaniesPage}. */
+  listContactsPage(orgId: string, filters?: ContactFilters, page?: PageRequest): Promise<Page<Contact>>;
+  /** One page of deals, newest first. See {@link CRMAdapter.listCompaniesPage}. */
+  listDealsPage(orgId: string, filters?: {
+    source?: RecordSource;
+  }, page?: PageRequest): Promise<Page<Deal>>;
   /**
    * Move a deal to `stage` and reorder it directly after `afterId` (null = top
    * of the column). The adapter computes the fractional `position` from the

package/dist/index.cjs

@@ -8,6 +8,34 @@ const require_mappings_config = require("./mappings-config.cjs");
 const require_view_compiler = require("./view-compiler-DP4Fbj7-.cjs");
 const require_sync_engine = require("./sync-engine.cjs");
 const require_types = require("./types.cjs");
+//#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.
@@ -250,6 +278,7 @@ exports.compileProjectionIdentity = require_view_compiler.compileProjectionIdent
 exports.compileProjectionJoins = require_view_compiler.compileProjectionJoins;
 exports.compileProjectionPreview = require_view_compiler.compileProjectionPreview;
 exports.compileProjectionSelect = require_view_compiler.compileProjectionSelect;
+exports.computeDealValue = computeDealValue;
 exports.coversUniqueKey = require_schema_meta.coversUniqueKey;
 exports.defineClivlyConfig = require_entity_config.defineClivlyConfig;
 exports.entitiesConfigSchema = require_entity_config.entitiesConfigSchema;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Activity, ActivityType, Company, CompanyFilters, 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, UpdateCompanyInput, UpdateContactInput, UpdateDealInput, UpdateTaskInput, ValueInterval, isClosedStageType } from "./types.cjs";
+import { 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 } from "./types.cjs";
 import { CRMAdapter } from "./adapter.cjs";
 import { ClivlyAuthAdapter, ClivlyUser, CrmMembership, MembershipResolver, authCustom } from "./auth-adapter.cjs";
 import { A as relationshipsSchema, B as identityRefs, D as missingRequiredFields, E as filterSchema, F as ProjectionFieldBinding, I as ProjectionIdentity, L as ProjectionJoin, M as validateEntitiesConfig, N as BASE_REF, O as projectionFields, P as PROJECTION_KEY_PATTERN, R as ProjectionMapping, S as RelationshipsMap, T as entitiesConfigSchema, V as projectionSchema, _ as MATERIALIZING_CONCEPTS, a as ClivlyEntitiesConfig, b as RelationshipSpec, d as CrmConcept, g as FilterValue, h as FilterExpr, i as ClivlyConfigError, j as requiredFieldsFor, k as relationshipSchema, l as ConfigValidationError, m as DiscoveredSchemaTable, n as CRM_CONCEPTS, p as DiscoveredColumnMeta, s as ClivlyEntityConfig, t as CANONICAL_FIELDS, u as ConfigValidationResult, v as MaterializingConcept, w as defineClivlyConfig, x as RelationshipVia, y as REQUIRED_FIELDS, z as ProjectionRef } from "./entity-config-OhC4Otkz.cjs";
@@ -7,6 +7,41 @@ import { RelationshipCandidate, buildFilterFromDiscriminator, buildRelationships
 import { EntityMappingRow, mappingsToEntitiesConfig } from "./mappings-config.cjs";
 import { CompileOptions, CompiledView, DEFAULT_VIEW_PREFIX, ExplainResult, compileEntityView, compileEntityViews, explainEntitiesConfig } from "./view-compiler.cjs";
 import { EntitySyncResult, MirrorRecord, PersistAction, SourceRow, SyncAction, SyncResult, SyncStore, reconcile, runSync } from "./sync-engine.cjs";
+//#region 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.
+ */
+export declare function computeDealValue(source: PerSeatValueSource, fields: Record<string, string | null>, mappedFields: Set<string>, stageType: string): number | null;
+//#endregion
 //#region src/host-owned-fields.d.ts
 /**
  * Which fields a CRM record lets a user edit.
@@ -298,4 +333,4 @@ export declare function matchesCondition(condition: Condition, fields: Record<st
  */
 export declare function evaluateStage(rules: EvaluableRule[], fields: Record<string, string | null>, mappedFields: Set<string>): string | null;
 //#endregion
-export { type Activity, type ActivityType, BASE_REF, CANONICAL_FIELDS, type CRMAdapter, CRM_CONCEPTS, type ClivlyAuthAdapter, ClivlyConfigError, type ClivlyEntitiesConfig, type ClivlyEntityConfig, type ClivlyUser, type Company, type CompanyFilters, type CompileOptions, type CompiledView, type Condition, type ConditionOp, type ConfigValidationError, type ConfigValidationResult, type ConnectionLiveness, type Contact, type ContactFilters, type ContactStatus, type CreateActivityInput, type CreateCompanyInput, type CreateContactInput, type CreateDealInput, type CreateTaskInput, type CrmConcept, type CrmMembership, type CrmRole, DEFAULT_VIEW_PREFIX, type Deal, type DealStage, type DiscoveredColumnMeta, type DiscoveredSchemaTable, type EntityMappingRow, type EntitySyncResult, type EvaluableRule, type ExplainResult, type FilterExpr, type FilterValue, type HostOwnedCompanyField, type HostOwnedContactField, type IntegrationFacts, type IntegrationState, type IntegrationStatus, type IntegrationStep, MATERIALIZING_CONCEPTS, type MaterializingConcept, type MembershipResolver, type MirrorRecord, type NextAction, type Note, OPEN_STAGE_TYPE, PROJECTION_KEY_PATTERN, type PersistAction, type PipelineConfig, type PipelineKind, type PipelineStageConfig, type ProjectionFieldBinding, type ProjectionIdentity, type ProjectionJoin, type ProjectionMapping, type ProjectionRef, REQUIRED_FIELDS, type RecordSource, type RelationshipCandidate, type RelationshipSpec, type RelationshipVia, type RelationshipsMap, type SourceRow, type SourcedRecord, type StageType, type StepId, type StepProblem, type StepState, type SyncAction, type SyncResult, type SyncStore, type Task, type TaskEntityType, type TaskFilters, type TaskPriority, type TaskStatus, type UpdateCompanyInput, type UpdateContactInput, type UpdateDealInput, type UpdateTaskInput, type ValueInterval, authCustom, buildFilterFromDiscriminator, buildRelationships, compileEntityView, compileEntityViews, defineClivlyConfig, entitiesConfigSchema, explainEntitiesConfig, filterSchema, identityRefs, isClosedStageType, mappingsToEntitiesConfig, missingRequiredFields, projectionFields, projectionSchema, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, requiredFieldsFor, runSync, validateEntitiesConfig };
+export { type Activity, type ActivityType, BASE_REF, CANONICAL_FIELDS, type CRMAdapter, CRM_CONCEPTS, type ClivlyAuthAdapter, ClivlyConfigError, type ClivlyEntitiesConfig, type ClivlyEntityConfig, type ClivlyUser, type Company, type CompanyFilters, type CompileOptions, type CompiledView, type Condition, type ConditionOp, type ConfigValidationError, type ConfigValidationResult, type ConnectionLiveness, type Contact, type ContactFilters, type ContactStatus, type CreateActivityInput, type CreateCompanyInput, type CreateContactInput, type CreateDealInput, type CreateTaskInput, type CrmConcept, type CrmMembership, type CrmRole, DEFAULT_VIEW_PREFIX, type Deal, type DealStage, type DiscoveredColumnMeta, type DiscoveredSchemaTable, type EntityMappingRow, type EntitySyncResult, type EvaluableRule, type ExplainResult, type FilterExpr, type FilterValue, type HostOwnedCompanyField, type HostOwnedContactField, type IntegrationFacts, type IntegrationState, type IntegrationStatus, type IntegrationStep, MATERIALIZING_CONCEPTS, type MaterializingConcept, type MembershipResolver, type MirrorRecord, type NextAction, type Note, OPEN_STAGE_TYPE, PROJECTION_KEY_PATTERN, type Page, type PageRequest, type PerSeatValueSource, type PersistAction, type PipelineConfig, type PipelineKind, type PipelineStageConfig, type ProjectionFieldBinding, type ProjectionIdentity, type ProjectionJoin, type ProjectionMapping, type ProjectionRef, REQUIRED_FIELDS, type RecordSource, type RelationshipCandidate, type RelationshipSpec, type RelationshipVia, type RelationshipsMap, type SourceRow, type SourcedRecord, type StageType, type StepId, type StepProblem, type StepState, type SyncAction, type SyncResult, type SyncStore, type Task, type TaskEntityType, type TaskFilters, type TaskPriority, type TaskStatus, type UpdateCompanyInput, type UpdateContactInput, type UpdateDealInput, type UpdateTaskInput, type ValueInterval, authCustom, buildFilterFromDiscriminator, buildRelationships, compileEntityView, compileEntityViews, defineClivlyConfig, entitiesConfigSchema, explainEntitiesConfig, filterSchema, identityRefs, isClosedStageType, mappingsToEntitiesConfig, missingRequiredFields, projectionFields, projectionSchema, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, requiredFieldsFor, runSync, validateEntitiesConfig };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { Activity, ActivityType, Company, CompanyFilters, 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, UpdateCompanyInput, UpdateContactInput, UpdateDealInput, UpdateTaskInput, ValueInterval, isClosedStageType } from "./types.mjs";
+import { 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 } from "./types.mjs";
 import { CRMAdapter } from "./adapter.mjs";
 import { ClivlyAuthAdapter, ClivlyUser, CrmMembership, MembershipResolver, authCustom } from "./auth-adapter.mjs";
 import { A as relationshipsSchema, B as identityRefs, D as missingRequiredFields, E as filterSchema, F as ProjectionFieldBinding, I as ProjectionIdentity, L as ProjectionJoin, M as validateEntitiesConfig, N as BASE_REF, O as projectionFields, P as PROJECTION_KEY_PATTERN, R as ProjectionMapping, S as RelationshipsMap, T as entitiesConfigSchema, V as projectionSchema, _ as MATERIALIZING_CONCEPTS, a as ClivlyEntitiesConfig, b as RelationshipSpec, d as CrmConcept, g as FilterValue, h as FilterExpr, i as ClivlyConfigError, j as requiredFieldsFor, k as relationshipSchema, l as ConfigValidationError, m as DiscoveredSchemaTable, n as CRM_CONCEPTS, p as DiscoveredColumnMeta, s as ClivlyEntityConfig, t as CANONICAL_FIELDS, u as ConfigValidationResult, v as MaterializingConcept, w as defineClivlyConfig, x as RelationshipVia, y as REQUIRED_FIELDS, z as ProjectionRef } from "./entity-config-OhC4Otkz.mjs";
@@ -7,6 +7,41 @@ import { RelationshipCandidate, buildFilterFromDiscriminator, buildRelationships
 import { EntityMappingRow, mappingsToEntitiesConfig } from "./mappings-config.mjs";
 import { CompileOptions, CompiledView, DEFAULT_VIEW_PREFIX, ExplainResult, compileEntityView, compileEntityViews, explainEntitiesConfig } from "./view-compiler.mjs";
 import { EntitySyncResult, MirrorRecord, PersistAction, SourceRow, SyncAction, SyncResult, SyncStore, reconcile, runSync } from "./sync-engine.mjs";
+//#region 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.
+ */
+export declare function computeDealValue(source: PerSeatValueSource, fields: Record<string, string | null>, mappedFields: Set<string>, stageType: string): number | null;
+//#endregion
 //#region src/host-owned-fields.d.ts
 /**
  * Which fields a CRM record lets a user edit.
@@ -298,4 +333,4 @@ export declare function matchesCondition(condition: Condition, fields: Record<st
  */
 export declare function evaluateStage(rules: EvaluableRule[], fields: Record<string, string | null>, mappedFields: Set<string>): string | null;
 //#endregion
-export { type Activity, type ActivityType, BASE_REF, CANONICAL_FIELDS, type CRMAdapter, CRM_CONCEPTS, type ClivlyAuthAdapter, ClivlyConfigError, type ClivlyEntitiesConfig, type ClivlyEntityConfig, type ClivlyUser, type Company, type CompanyFilters, type CompileOptions, type CompiledView, type Condition, type ConditionOp, type ConfigValidationError, type ConfigValidationResult, type ConnectionLiveness, type Contact, type ContactFilters, type ContactStatus, type CreateActivityInput, type CreateCompanyInput, type CreateContactInput, type CreateDealInput, type CreateTaskInput, type CrmConcept, type CrmMembership, type CrmRole, DEFAULT_VIEW_PREFIX, type Deal, type DealStage, type DiscoveredColumnMeta, type DiscoveredSchemaTable, type EntityMappingRow, type EntitySyncResult, type EvaluableRule, type ExplainResult, type FilterExpr, type FilterValue, type HostOwnedCompanyField, type HostOwnedContactField, type IntegrationFacts, type IntegrationState, type IntegrationStatus, type IntegrationStep, MATERIALIZING_CONCEPTS, type MaterializingConcept, type MembershipResolver, type MirrorRecord, type NextAction, type Note, OPEN_STAGE_TYPE, PROJECTION_KEY_PATTERN, type PersistAction, type PipelineConfig, type PipelineKind, type PipelineStageConfig, type ProjectionFieldBinding, type ProjectionIdentity, type ProjectionJoin, type ProjectionMapping, type ProjectionRef, REQUIRED_FIELDS, type RecordSource, type RelationshipCandidate, type RelationshipSpec, type RelationshipVia, type RelationshipsMap, type SourceRow, type SourcedRecord, type StageType, type StepId, type StepProblem, type StepState, type SyncAction, type SyncResult, type SyncStore, type Task, type TaskEntityType, type TaskFilters, type TaskPriority, type TaskStatus, type UpdateCompanyInput, type UpdateContactInput, type UpdateDealInput, type UpdateTaskInput, type ValueInterval, authCustom, buildFilterFromDiscriminator, buildRelationships, compileEntityView, compileEntityViews, defineClivlyConfig, entitiesConfigSchema, explainEntitiesConfig, filterSchema, identityRefs, isClosedStageType, mappingsToEntitiesConfig, missingRequiredFields, projectionFields, projectionSchema, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, requiredFieldsFor, runSync, validateEntitiesConfig };
+export { type Activity, type ActivityType, BASE_REF, CANONICAL_FIELDS, type CRMAdapter, CRM_CONCEPTS, type ClivlyAuthAdapter, ClivlyConfigError, type ClivlyEntitiesConfig, type ClivlyEntityConfig, type ClivlyUser, type Company, type CompanyFilters, type CompileOptions, type CompiledView, type Condition, type ConditionOp, type ConfigValidationError, type ConfigValidationResult, type ConnectionLiveness, type Contact, type ContactFilters, type ContactStatus, type CreateActivityInput, type CreateCompanyInput, type CreateContactInput, type CreateDealInput, type CreateTaskInput, type CrmConcept, type CrmMembership, type CrmRole, DEFAULT_VIEW_PREFIX, type Deal, type DealStage, type DiscoveredColumnMeta, type DiscoveredSchemaTable, type EntityMappingRow, type EntitySyncResult, type EvaluableRule, type ExplainResult, type FilterExpr, type FilterValue, type HostOwnedCompanyField, type HostOwnedContactField, type IntegrationFacts, type IntegrationState, type IntegrationStatus, type IntegrationStep, MATERIALIZING_CONCEPTS, type MaterializingConcept, type MembershipResolver, type MirrorRecord, type NextAction, type Note, OPEN_STAGE_TYPE, PROJECTION_KEY_PATTERN, type Page, type PageRequest, type PerSeatValueSource, type PersistAction, type PipelineConfig, type PipelineKind, type PipelineStageConfig, type ProjectionFieldBinding, type ProjectionIdentity, type ProjectionJoin, type ProjectionMapping, type ProjectionRef, REQUIRED_FIELDS, type RecordSource, type RelationshipCandidate, type RelationshipSpec, type RelationshipVia, type RelationshipsMap, type SourceRow, type SourcedRecord, type StageType, type StepId, type StepProblem, type StepState, type SyncAction, type SyncResult, type SyncStore, type Task, type TaskEntityType, type TaskFilters, type TaskPriority, type TaskStatus, type UpdateCompanyInput, type UpdateContactInput, type UpdateDealInput, type UpdateTaskInput, type ValueInterval, authCustom, buildFilterFromDiscriminator, buildRelationships, compileEntityView, compileEntityViews, defineClivlyConfig, entitiesConfigSchema, explainEntitiesConfig, filterSchema, identityRefs, isClosedStageType, mappingsToEntitiesConfig, missingRequiredFields, projectionFields, projectionSchema, reconcile, relationshipSchema, relationshipViaSignature, relationshipsSchema, requiredFieldsFor, runSync, validateEntitiesConfig };

package/dist/index.mjs

@@ -7,6 +7,34 @@ 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.
@@ -228,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, 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 };
+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/types.d.cts

@@ -92,7 +92,21 @@ export interface Deal {
   owner: string | null;
   position: number | null;
   stage: DealStage;
+  /**
+   * When a human last moved this deal by hand. Non-null means stage derivation
+   * no longer touches it, so a board must be able to mark it as overridden and
+   * offer a way back — otherwise an overridden deal is indistinguishable from
+   * one the rules simply never matched.
+   */
+  stageOverrideAt: Date | null;
   value: number;
+  /**
+   * When a human last set this deal's value by hand. Non-null means value
+   * derivation no longer touches it. Mirrors {@link Deal.stageOverrideAt} — and
+   * needs the same visibility, since an honoured-but-invisible override reads
+   * as a stuck deal rather than a pinned one.
+   */
+  valueOverrideAt: Date | null;
 }
 export interface Task {
   archivedAt: Date | null;
@@ -234,6 +248,28 @@ export interface ContactFilters {
   source?: RecordSource;
   status?: ContactStatus;
 }
+/**
+ * One page of a keyset-paginated read.
+ *
+ * Keyset, not offset: `LIMIT/OFFSET` re-scans every skipped row, so page 200
+ * costs 200 pages of work, and a row inserted mid-listing shifts everything
+ * after it — the reader sees a record twice or never. A cursor anchored to
+ * `(createdAt, id)` is stable under concurrent writes and costs the same at
+ * page 1 and page 200.
+ *
+ * `audit.list` already does this; these types generalise its shape so the CRM
+ * lists cannot drift into a second convention.
+ */
+export interface PageRequest {
+  /** Opaque `${createdAtISO}|${id}`. Rows strictly older than this. */
+  cursor?: string;
+  limit?: number;
+}
+export interface Page<T> {
+  /** Null when this is the last page. */
+  nextCursor: string | null;
+  rows: T[];
+}
 export interface CompanyFilters {
   /** See {@link ContactFilters.excludeArchived}. */
   excludeArchived?: boolean;

package/dist/types.d.mts

@@ -92,7 +92,21 @@ export interface Deal {
   owner: string | null;
   position: number | null;
   stage: DealStage;
+  /**
+   * When a human last moved this deal by hand. Non-null means stage derivation
+   * no longer touches it, so a board must be able to mark it as overridden and
+   * offer a way back — otherwise an overridden deal is indistinguishable from
+   * one the rules simply never matched.
+   */
+  stageOverrideAt: Date | null;
   value: number;
+  /**
+   * When a human last set this deal's value by hand. Non-null means value
+   * derivation no longer touches it. Mirrors {@link Deal.stageOverrideAt} — and
+   * needs the same visibility, since an honoured-but-invisible override reads
+   * as a stuck deal rather than a pinned one.
+   */
+  valueOverrideAt: Date | null;
 }
 export interface Task {
   archivedAt: Date | null;
@@ -234,6 +248,28 @@ export interface ContactFilters {
   source?: RecordSource;
   status?: ContactStatus;
 }
+/**
+ * One page of a keyset-paginated read.
+ *
+ * Keyset, not offset: `LIMIT/OFFSET` re-scans every skipped row, so page 200
+ * costs 200 pages of work, and a row inserted mid-listing shifts everything
+ * after it — the reader sees a record twice or never. A cursor anchored to
+ * `(createdAt, id)` is stable under concurrent writes and costs the same at
+ * page 1 and page 200.
+ *
+ * `audit.list` already does this; these types generalise its shape so the CRM
+ * lists cannot drift into a second convention.
+ */
+export interface PageRequest {
+  /** Opaque `${createdAtISO}|${id}`. Rows strictly older than this. */
+  cursor?: string;
+  limit?: number;
+}
+export interface Page<T> {
+  /** Null when this is the last page. */
+  nextCursor: string | null;
+  rows: T[];
+}
 export interface CompanyFilters {
   /** See {@link ContactFilters.excludeArchived}. */
   excludeArchived?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clivly/core",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "private": false,
   "description": "ORM/auth-agnostic CRM adapter contracts and shared domain types for Clivly.",
   "license": "MIT",