clivly 0.11.0 → 0.13.0

package/{adapter-BWrOtOw5.d.mts → adapter-DTMeGGsl.d.cts}

@@ -1,4 +1,4 @@
-import { A as UpdateDealInput, C as Task, O as UpdateCompanyInput, T as TaskFilters, a as Contact, c as CreateActivityInput, d as CreateDealInput, f as CreateTaskInput, i as CompanyFilters, j as UpdateTaskInput, k as UpdateContactInput, l as CreateCompanyInput, m as Deal, o as ContactFilters, r as Company, t as Activity, u as CreateContactInput, x as RecordSource } from "./types-D08UzDqe.mjs";
+import { A as UpdateCompanyInput, C as RecordSource, D as TaskFilters, M as UpdateDealInput, N as UpdateTaskInput, T as Task, a as Contact, c as CreateActivityInput, d as CreateDealInput, f as CreateTaskInput, i as CompanyFilters, j as UpdateContactInput, l as CreateCompanyInput, m as Deal, o as ContactFilters, r as Company, t as Activity, u as CreateContactInput, v as Page, y as PageRequest } from "./types-B17TWEOL.cjs";
 //#region ../core/src/adapter.d.ts
 /**
  * The contract every ORM implementation fulfils. `packages/drizzle` is the first
@@ -58,6 +58,24 @@ 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/{adapter-Bd5HjLYa.d.cts → adapter-DhPBRNpi.d.mts}

@@ -1,4 +1,4 @@
-import { A as UpdateDealInput, C as Task, O as UpdateCompanyInput, T as TaskFilters, a as Contact, c as CreateActivityInput, d as CreateDealInput, f as CreateTaskInput, i as CompanyFilters, j as UpdateTaskInput, k as UpdateContactInput, l as CreateCompanyInput, m as Deal, o as ContactFilters, r as Company, t as Activity, u as CreateContactInput, x as RecordSource } from "./types-D08UzDqe.cjs";
+import { A as UpdateCompanyInput, C as RecordSource, D as TaskFilters, M as UpdateDealInput, N as UpdateTaskInput, T as Task, a as Contact, c as CreateActivityInput, d as CreateDealInput, f as CreateTaskInput, i as CompanyFilters, j as UpdateContactInput, l as CreateCompanyInput, m as Deal, o as ContactFilters, r as Company, t as Activity, u as CreateContactInput, v as Page, y as PageRequest } from "./types-B17TWEOL.mjs";
 //#region ../core/src/adapter.d.ts
 /**
  * The contract every ORM implementation fulfils. `packages/drizzle` is the first
@@ -58,6 +58,24 @@ 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/{auth-adapter-C3BQpc-q.d.cts → auth-adapter-C6rDx3XH.d.mts}

@@ -1,4 +1,4 @@
-import { p as CrmRole } from "./types-D08UzDqe.cjs";
+import { p as CrmRole } from "./types-B17TWEOL.mjs";
 //#region ../core/src/auth-adapter.d.ts
 interface ClivlyUser {
   email: string;

package/{auth-adapter-D54ajbl7.d.mts → auth-adapter-Csk9KkvI.d.cts}

@@ -1,4 +1,4 @@
-import { p as CrmRole } from "./types-D08UzDqe.mjs";
+import { p as CrmRole } from "./types-B17TWEOL.cjs";
 //#region ../core/src/auth-adapter.d.ts
 interface ClivlyUser {
   email: string;

package/auth-better-auth.d.cts

@@ -1,4 +1,4 @@
-import { n as ClivlyUser, t as ClivlyAuthAdapter } from "./auth-adapter-C3BQpc-q.cjs";
+import { n as ClivlyUser, t as ClivlyAuthAdapter } from "./auth-adapter-Csk9KkvI.cjs";
 //#region ../auth-better-auth/src/map.d.ts
 interface BetterAuthLikeUser {
   email?: string | null;

package/auth-better-auth.d.mts

@@ -1,4 +1,4 @@
-import { n as ClivlyUser, t as ClivlyAuthAdapter } from "./auth-adapter-D54ajbl7.mjs";
+import { n as ClivlyUser, t as ClivlyAuthAdapter } from "./auth-adapter-C6rDx3XH.mjs";
 //#region ../auth-better-auth/src/map.d.ts
 interface BetterAuthLikeUser {
   email?: string | null;

package/auth-clerk.d.cts

@@ -1,4 +1,4 @@
-import { n as ClivlyUser, t as ClivlyAuthAdapter } from "./auth-adapter-C3BQpc-q.cjs";
+import { n as ClivlyUser, t as ClivlyAuthAdapter } from "./auth-adapter-Csk9KkvI.cjs";
 //#region ../auth-clerk/src/map.d.ts
 interface ClerkLikeUser {
   emailAddresses?: Array<{

package/auth-clerk.d.mts

@@ -1,4 +1,4 @@
-import { n as ClivlyUser, t as ClivlyAuthAdapter } from "./auth-adapter-D54ajbl7.mjs";
+import { n as ClivlyUser, t as ClivlyAuthAdapter } from "./auth-adapter-C6rDx3XH.mjs";
 //#region ../auth-clerk/src/map.d.ts
 interface ClerkLikeUser {
   emailAddresses?: Array<{

package/auth-workos.d.cts

@@ -1,4 +1,4 @@
-import { n as ClivlyUser, t as ClivlyAuthAdapter } from "./auth-adapter-C3BQpc-q.cjs";
+import { n as ClivlyUser, t as ClivlyAuthAdapter } from "./auth-adapter-Csk9KkvI.cjs";
 //#region ../auth-workos/src/map.d.ts
 interface WorkOSLikeUser {
   email: string;

package/auth-workos.d.mts

@@ -1,4 +1,4 @@
-import { n as ClivlyUser, t as ClivlyAuthAdapter } from "./auth-adapter-D54ajbl7.mjs";
+import { n as ClivlyUser, t as ClivlyAuthAdapter } from "./auth-adapter-C6rDx3XH.mjs";
 //#region ../auth-workos/src/map.d.ts
 interface WorkOSLikeUser {
   email: string;

package/core-adapter.d.cts

@@ -1,2 +1,2 @@
-import { t as CRMAdapter } from "./adapter-Bd5HjLYa.cjs";
+import { t as CRMAdapter } from "./adapter-DTMeGGsl.cjs";
 export { CRMAdapter };

package/core-adapter.d.mts

@@ -1,2 +1,2 @@
-import { t as CRMAdapter } from "./adapter-BWrOtOw5.mjs";
+import { t as CRMAdapter } from "./adapter-DhPBRNpi.mjs";
 export { CRMAdapter };

package/core-auth-adapter.d.cts

@@ -1,2 +1,2 @@
-import { a as authCustom, i as MembershipResolver, n as ClivlyUser, r as CrmMembership, t as ClivlyAuthAdapter } from "./auth-adapter-C3BQpc-q.cjs";
+import { a as authCustom, i as MembershipResolver, n as ClivlyUser, r as CrmMembership, t as ClivlyAuthAdapter } from "./auth-adapter-Csk9KkvI.cjs";
 export { ClivlyAuthAdapter, ClivlyUser, CrmMembership, MembershipResolver, authCustom };

package/core-auth-adapter.d.mts

@@ -1,2 +1,2 @@
-import { a as authCustom, i as MembershipResolver, n as ClivlyUser, r as CrmMembership, t as ClivlyAuthAdapter } from "./auth-adapter-D54ajbl7.mjs";
+import { a as authCustom, i as MembershipResolver, n as ClivlyUser, r as CrmMembership, t as ClivlyAuthAdapter } from "./auth-adapter-C6rDx3XH.mjs";
 export { ClivlyAuthAdapter, ClivlyUser, CrmMembership, MembershipResolver, authCustom };

package/core-types.d.cts

@@ -1,2 +1,2 @@
-import { A as UpdateDealInput, C as Task, D as TaskStatus, E as TaskPriority, M as ValueInterval, N as isClosedStageType, O as UpdateCompanyInput, S as StageType, T as TaskFilters, _ as OPEN_STAGE_TYPE, a as Contact, b as PipelineStageConfig, c as CreateActivityInput, d as CreateDealInput, f as CreateTaskInput, g as Note, h as DealStage, i as CompanyFilters, j as UpdateTaskInput, k as UpdateContactInput, 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 PipelineConfig, w as TaskEntityType, x as RecordSource, y as PipelineKind } from "./types-D08UzDqe.cjs";
-export { 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 };
+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/core-types.d.mts

@@ -1,2 +1,2 @@
-import { A as UpdateDealInput, C as Task, D as TaskStatus, E as TaskPriority, M as ValueInterval, N as isClosedStageType, O as UpdateCompanyInput, S as StageType, T as TaskFilters, _ as OPEN_STAGE_TYPE, a as Contact, b as PipelineStageConfig, c as CreateActivityInput, d as CreateDealInput, f as CreateTaskInput, g as Note, h as DealStage, i as CompanyFilters, j as UpdateTaskInput, k as UpdateContactInput, 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 PipelineConfig, w as TaskEntityType, x as RecordSource, y as PipelineKind } from "./types-D08UzDqe.mjs";
-export { 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 };
+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/core.cjs

@@ -3,7 +3,7 @@ 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-CRIgf9jS.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-DuCtFE9t.cjs");
 const require_view_compiler = require("./view-compiler-xiwm5iar.cjs");
@@ -33,6 +33,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;

package/core.d.cts

@@ -1,11 +1,11 @@
 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-ApnT5j3X.cjs";
-import { A as UpdateDealInput, C as Task, D as TaskStatus, E as TaskPriority, M as ValueInterval, N as isClosedStageType, O as UpdateCompanyInput, S as StageType, T as TaskFilters, _ as OPEN_STAGE_TYPE, a as Contact, b as PipelineStageConfig, c as CreateActivityInput, d as CreateDealInput, f as CreateTaskInput, g as Note, h as DealStage, i as CompanyFilters, j as UpdateTaskInput, k as UpdateContactInput, 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 PipelineConfig, w as TaskEntityType, x as RecordSource, y as PipelineKind } from "./types-D08UzDqe.cjs";
-import { a as authCustom, i as MembershipResolver, n as ClivlyUser, r as CrmMembership, t as ClivlyAuthAdapter } from "./auth-adapter-C3BQpc-q.cjs";
-import { t as CRMAdapter } from "./adapter-Bd5HjLYa.cjs";
+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";
+import { a as authCustom, i as MembershipResolver, n as ClivlyUser, r as CrmMembership, t as ClivlyAuthAdapter } from "./auth-adapter-Csk9KkvI.cjs";
+import { t as CRMAdapter } from "./adapter-DTMeGGsl.cjs";
 import { i as relationshipViaSignature, n as buildFilterFromDiscriminator, r as buildRelationships, t as RelationshipCandidate } from "./mapping-form-XsLLCqW_.cjs";
 import { i as mappingsToEntitiesConfig, t as EntityMappingRow } from "./mappings-config-iJzbcUMp.cjs";
 import { a as compileEntityView, 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";
 import { c as SyncResult, f as reconcile, l as SyncStore, n as MirrorRecord, o as SourceRow, p as runSync, r as PersistAction, s as SyncAction, t as EntitySyncResult } from "./sync-engine-V3_UutGv.cjs";
-import { C as HostOwnedCompanyField, D as isHostOwned, E as hostOwnedFieldMessage, O as rejectedCompanyFields, S as joinFansOut, T as SourcedRecord, _ as compileProjectionJoins, a as matchesCondition, b as quoteIdent, c as columnMetaFor, d as primaryKeyColumns, f as validateProjection, g as compileProjectionIdentity, h as compileProjectionFrom, i as evaluateStage, k as rejectedContactFields, l as coversUniqueKey, m as PREVIEW_MAX_ROWS, n as ConditionOp, o as slugify, p as validateProjectionFilter, r as EvaluableRule, s as toObjectTypeSlug, t as Condition, u as hasRichMeta, v as compileProjectionPreview, w as HostOwnedContactField, x as fanOutJoins, y as compileProjectionSelect } from "./internal-D9kqkhPs.cjs";
+import { A as PerSeatValueSource, C as HostOwnedCompanyField, D as isHostOwned, E as hostOwnedFieldMessage, O as rejectedCompanyFields, S as joinFansOut, T as SourcedRecord, _ as compileProjectionJoins, a as matchesCondition, b as quoteIdent, c as columnMetaFor, d as primaryKeyColumns, f as validateProjection, g as compileProjectionIdentity, h as compileProjectionFrom, i as evaluateStage, j as computeDealValue, k as rejectedContactFields, l as coversUniqueKey, m as PREVIEW_MAX_ROWS, n as ConditionOp, o as slugify, p as validateProjectionFilter, r as EvaluableRule, s as toObjectTypeSlug, t as Condition, u as hasRichMeta, v as compileProjectionPreview, w as HostOwnedContactField, x as fanOutJoins, y as compileProjectionSelect } from "./internal-vH5Rlg6Q.cjs";
 import { a as IntegrationStep, c as StepProblem, i as IntegrationStatus, l as StepState, n as IntegrationFacts, o as NextAction, r as IntegrationState, s as StepId, t as ConnectionLiveness } from "./integration-state-BA4c0RbD.cjs";
-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, PREVIEW_MAX_ROWS, 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, 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 { 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, PREVIEW_MAX_ROWS, 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, 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/core.d.mts

@@ -1,11 +1,11 @@
 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-CKcj4-M_.mjs";
-import { A as UpdateDealInput, C as Task, D as TaskStatus, E as TaskPriority, M as ValueInterval, N as isClosedStageType, O as UpdateCompanyInput, S as StageType, T as TaskFilters, _ as OPEN_STAGE_TYPE, a as Contact, b as PipelineStageConfig, c as CreateActivityInput, d as CreateDealInput, f as CreateTaskInput, g as Note, h as DealStage, i as CompanyFilters, j as UpdateTaskInput, k as UpdateContactInput, 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 PipelineConfig, w as TaskEntityType, x as RecordSource, y as PipelineKind } from "./types-D08UzDqe.mjs";
-import { a as authCustom, i as MembershipResolver, n as ClivlyUser, r as CrmMembership, t as ClivlyAuthAdapter } from "./auth-adapter-D54ajbl7.mjs";
-import { t as CRMAdapter } from "./adapter-BWrOtOw5.mjs";
+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";
+import { a as authCustom, i as MembershipResolver, n as ClivlyUser, r as CrmMembership, t as ClivlyAuthAdapter } from "./auth-adapter-C6rDx3XH.mjs";
+import { t as CRMAdapter } from "./adapter-DhPBRNpi.mjs";
 import { i as relationshipViaSignature, n as buildFilterFromDiscriminator, r as buildRelationships, t as RelationshipCandidate } from "./mapping-form-Btn-7gzv.mjs";
 import { i as mappingsToEntitiesConfig, t as EntityMappingRow } from "./mappings-config-D6_oCi2Q.mjs";
 import { a as compileEntityView, 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";
 import { c as SyncResult, f as reconcile, l as SyncStore, n as MirrorRecord, o as SourceRow, p as runSync, r as PersistAction, s as SyncAction, t as EntitySyncResult } from "./sync-engine--M9EaONC.mjs";
-import { C as HostOwnedCompanyField, D as isHostOwned, E as hostOwnedFieldMessage, O as rejectedCompanyFields, S as joinFansOut, T as SourcedRecord, _ as compileProjectionJoins, a as matchesCondition, b as quoteIdent, c as columnMetaFor, d as primaryKeyColumns, f as validateProjection, g as compileProjectionIdentity, h as compileProjectionFrom, i as evaluateStage, k as rejectedContactFields, l as coversUniqueKey, m as PREVIEW_MAX_ROWS, n as ConditionOp, o as slugify, p as validateProjectionFilter, r as EvaluableRule, s as toObjectTypeSlug, t as Condition, u as hasRichMeta, v as compileProjectionPreview, w as HostOwnedContactField, x as fanOutJoins, y as compileProjectionSelect } from "./internal-Bjpq7S2G.mjs";
+import { A as PerSeatValueSource, C as HostOwnedCompanyField, D as isHostOwned, E as hostOwnedFieldMessage, O as rejectedCompanyFields, S as joinFansOut, T as SourcedRecord, _ as compileProjectionJoins, a as matchesCondition, b as quoteIdent, c as columnMetaFor, d as primaryKeyColumns, f as validateProjection, g as compileProjectionIdentity, h as compileProjectionFrom, i as evaluateStage, j as computeDealValue, k as rejectedContactFields, l as coversUniqueKey, m as PREVIEW_MAX_ROWS, n as ConditionOp, o as slugify, p as validateProjectionFilter, r as EvaluableRule, s as toObjectTypeSlug, t as Condition, u as hasRichMeta, v as compileProjectionPreview, w as HostOwnedContactField, x as fanOutJoins, y as compileProjectionSelect } from "./internal-Cmx7Zevf.mjs";
 import { a as IntegrationStep, c as StepProblem, i as IntegrationStatus, l as StepState, n as IntegrationFacts, o as NextAction, r as IntegrationState, s as StepId, t as ConnectionLiveness } from "./integration-state-BA4c0RbD.mjs";
-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, PREVIEW_MAX_ROWS, 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, 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 { 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, PREVIEW_MAX_ROWS, 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, 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/core.mjs

@@ -2,7 +2,7 @@ import { i as projectionSchema, n as PROJECTION_KEY_PATTERN, r as identityRefs,
 import { C as hasRichMeta, S as coversUniqueKey, _ as validateProjection, a as MATERIALIZING_CONCEPTS, b as joinFansOut, c as defineClivlyConfig, d as missingRequiredFields, f as projectionFields, g as validateEntitiesConfig, h as requiredFieldsFor, i as ClivlyConfigError, l as entitiesConfigSchema, m as relationshipsSchema, n as CRM_CONCEPTS, o as REQUIRED_FIELDS, p as relationshipSchema, t as CANONICAL_FIELDS, u as filterSchema, v as validateProjectionFilter, w as primaryKeyColumns, x as columnMetaFor, y as fanOutJoins } from "./entity-config-Ccfb2IL9.mjs";
 import { n as mappingsToEntitiesConfig } from "./mappings-config-CwQNQ6bA.mjs";
 import { t as authCustom } from "./auth-adapter-gfVDxf3d.mjs";
-import { a as hostOwnedFieldMessage, c as rejectedContactFields, i as toObjectTypeSlug, n as matchesCondition, o as isHostOwned, r as slugify, s as rejectedCompanyFields, t as evaluateStage } from "./internal-v6P9MZY1.mjs";
+import { a as hostOwnedFieldMessage, c as rejectedContactFields, i as toObjectTypeSlug, l as computeDealValue, n as matchesCondition, o as isHostOwned, r as slugify, s as rejectedCompanyFields, t as evaluateStage } from "./internal-u0Bks5Gr.mjs";
 import { n as buildRelationships, r as relationshipViaSignature, t as buildFilterFromDiscriminator } from "./mapping-form-DigkuvFc.mjs";
 import { a as compileProjectionPreview, i as compileProjectionJoins, n as compileProjectionFrom, o as compileProjectionSelect, r as compileProjectionIdentity, s as quoteIdent, t as PREVIEW_MAX_ROWS } from "./projection-sql-DweUaWRc.mjs";
 import { i as explainEntitiesConfig, n as compileEntityView, r as compileEntityViews, t as DEFAULT_VIEW_PREFIX } from "./view-compiler-C-6RydKK.mjs";
@@ -12,4 +12,4 @@ import { t as warnDeprecatedSubpath } from "./deprecate-subpath-CmvZtCpE.mjs";
 //#region src/core.ts
 warnDeprecatedSubpath("clivly/core", "clivly/sdk", "Import \"defineClivlyConfig\" and its config types from \"clivly/sdk\"; import everything else from \"clivly/internal\" (no stability guarantee — see STABILITY.md).");
 //#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/drizzle.cjs

@@ -142,6 +142,7 @@ function fromDrizzle(db, table, opts) {
 	const idColumnName = idColumn.name;
 	const source = {
 		entity: opts.entity,
+		...opts.pushSource === void 0 ? {} : { pushSource: opts.pushSource },
 		cursorField: cursorColumnName,
 		idField: idColumnName,
 		fetchPage: ({ since, limit }) => drizzleDb.select(projection).from(table).where(since ? drizzle_orm.sql`(${cursorColumn}, ${idColumn}) > (${since.time}, ${since.id})` : void 0).orderBy((0, drizzle_orm.asc)(cursorColumn), (0, drizzle_orm.asc)(idColumn)).limit(limit),
@@ -163,6 +164,69 @@ function fromDrizzle(db, table, opts) {
 	return source;
 }
 /**
+* Insert a row into a mapped Drizzle table and push it to Clivly immediately
+* — the "one call does both" instant-push API (see
+* docs/reviews/2026-09-19-near-real-time-sync-plan.md, question 1). Returns
+* only after the write completes; the push itself is fire-and-forget (see
+* `pushOne`), so this resolves at the same time a plain `db.insert(...)`
+* would.
+*
+* Created once per mapped table, mirroring `fromDrizzle`'s own convention —
+* no per-call table-to-entity lookup, so a table two entities share (e.g.
+* `user` for both `user` and `organizationOwner`) is never ambiguous:
+* ```ts
+* const insertUser = insertAndPush(clivly, db, schema.user, { entity: "user" });
+* // in the signup handler:
+* const created = await insertUser(newUserValues, c.executionCtx);
+* ```
+*
+* `waitUntil`, when provided (Hono exposes it as `c.executionCtx.waitUntil`),
+* extends the request's lifetime past the response so the push survives on
+* Cloudflare Workers and similar runtimes, which otherwise kill background
+* work the instant a response is sent. Omit it on a long-lived process where
+* nothing tears the request down early.
+*
+* Table property keys are translated to real database column names before
+* the push — the same translation `fromDrizzle` performs on `fetchPage` rows
+* — because a raw `.returning()` result is keyed by Drizzle property name
+* (`fullName`), and every consumer downstream of a push (the fieldMap, the
+* cloud's ingest) addresses columns by their database name (`full_name`).
+* Skipping this would silently push empty fields with no error anywhere.
+*/
+/**
+* Translate a Drizzle-property-keyed row (e.g. a `.returning()` result, or a
+* plain unprojected `select()`) to real database column names — the same
+* translation `fromDrizzle` performs on `fetchPage` rows. Every consumer
+* downstream of a push (the fieldMap, the cloud's ingest) addresses columns
+* by their database name (`full_name`), not the property name (`fullName`);
+* skipping this would silently push empty fields with no error anywhere.
+*
+* Exported so a host can build the same translated row from a table it read
+* some other way — e.g. re-querying a row inside an auth library's own
+* lifecycle hook, where there is no `insertAndPush` call site to wrap
+* because the library performs the insert internally.
+*/
+function toColumnKeyedRow(table, row) {
+	const columns = (0, drizzle_orm.getTableColumns)(table);
+	const columnNameByPropertyKey = /* @__PURE__ */ new Map();
+	for (const [propertyKey, column] of Object.entries(columns)) columnNameByPropertyKey.set(propertyKey, column.name);
+	const out = {};
+	for (const [propertyKey, value] of Object.entries(row)) out[columnNameByPropertyKey.get(propertyKey) ?? propertyKey] = value;
+	return out;
+}
+function insertAndPush(clivly, db, table, opts) {
+	const insertableDb = db;
+	return async (values, waitUntil) => {
+		const [created] = await insertableDb.insert(table).values(values).returning();
+		if (!created) throw new Error(`insertAndPush: insert into "${(0, drizzle_orm.getTableName)(table)}" returned no row.`);
+		const row = toColumnKeyedRow(table, created);
+		const pushed = clivly.pushOne(opts.entity, row);
+		if (waitUntil) waitUntil(pushed);
+		else await pushed;
+		return created;
+	};
+}
+/**
 * Build a `NamespaceIntrospector` from any Drizzle client that exposes
 * `.execute()`. Reads `information_schema` in the connection's default schema
 * (`current_schema()`), so it reports exactly the tables the app can reach.
@@ -197,3 +261,5 @@ exports.discoverFromDrizzle = require_drizzle.discoverFromDrizzle;
 exports.drizzleIntrospector = drizzleIntrospector;
 exports.fromDrizzle = fromDrizzle;
 exports.fromDrizzleProjection = fromDrizzleProjection;
+exports.insertAndPush = insertAndPush;
+exports.toColumnKeyedRow = toColumnKeyedRow;

package/drizzle.d.cts

@@ -1,6 +1,6 @@
 import { R as ProjectionMapping, z as ProjectionRef } from "./entity-config-ApnT5j3X.cjs";
 import { n as buildUniqueConstraints, r as discoverFromDrizzle } from "./drizzle-CiK37zJm.cjs";
-import { t as NamespaceIntrospector, v as SyncSource } from "./namespace-probe-C5RLl74M.cjs";
+import { t as NamespaceIntrospector, v as SyncSource } from "./namespace-probe-H7yWc0JV.cjs";
 import { Table } from "drizzle-orm";
 //#region ../sdk/src/drizzle-projection.d.ts
 /**
@@ -82,6 +82,21 @@ interface FromDrizzleOptions {
    * check and a false explanation.
    */
   objectType?: string;
+  /**
+   * The label this source's pushes carry, when it differs from `entity`.
+   *
+   * `entity` is the CURSOR KEY — two sources sharing it share a cursor, so the
+   * first to run advances it and the second silently pushes nothing. The push
+   * LABEL is matched against a mapping's `sourceTable`, which is the host
+   * table name. Those two requirements conflict whenever one table feeds two
+   * concepts: an `organization` table mapped as both a company and a
+   * subscription deal needs distinct cursors but the same table name on the
+   * wire.
+   *
+   * `fromDrizzleProjection` stamps this itself for the projection case. This
+   * is the same escape hatch for a plain single-table source.
+   */
+  pushSource?: string;
 }
 /**
  * Build a `SyncSource` from a Drizzle table, generating the keyset-paginated
@@ -100,6 +115,56 @@ export declare function fromDrizzle(db: DrizzleDb, table: Table, opts: FromDrizz
   objectType: string;
 };
 export declare function fromDrizzle(db: DrizzleDb, table: Table, opts: FromDrizzleOptions): SyncSource;
+interface PushOneCapable {
+  pushOne(entityKey: string, row: Record<string, unknown>): Promise<void>;
+}
+/**
+ * Insert a row into a mapped Drizzle table and push it to Clivly immediately
+ * — the "one call does both" instant-push API (see
+ * docs/reviews/2026-09-19-near-real-time-sync-plan.md, question 1). Returns
+ * only after the write completes; the push itself is fire-and-forget (see
+ * `pushOne`), so this resolves at the same time a plain `db.insert(...)`
+ * would.
+ *
+ * Created once per mapped table, mirroring `fromDrizzle`'s own convention —
+ * no per-call table-to-entity lookup, so a table two entities share (e.g.
+ * `user` for both `user` and `organizationOwner`) is never ambiguous:
+ * ```ts
+ * const insertUser = insertAndPush(clivly, db, schema.user, { entity: "user" });
+ * // in the signup handler:
+ * const created = await insertUser(newUserValues, c.executionCtx);
+ * ```
+ *
+ * `waitUntil`, when provided (Hono exposes it as `c.executionCtx.waitUntil`),
+ * extends the request's lifetime past the response so the push survives on
+ * Cloudflare Workers and similar runtimes, which otherwise kill background
+ * work the instant a response is sent. Omit it on a long-lived process where
+ * nothing tears the request down early.
+ *
+ * Table property keys are translated to real database column names before
+ * the push — the same translation `fromDrizzle` performs on `fetchPage` rows
+ * — because a raw `.returning()` result is keyed by Drizzle property name
+ * (`fullName`), and every consumer downstream of a push (the fieldMap, the
+ * cloud's ingest) addresses columns by their database name (`full_name`).
+ * Skipping this would silently push empty fields with no error anywhere.
+ */
+/**
+ * Translate a Drizzle-property-keyed row (e.g. a `.returning()` result, or a
+ * plain unprojected `select()`) to real database column names — the same
+ * translation `fromDrizzle` performs on `fetchPage` rows. Every consumer
+ * downstream of a push (the fieldMap, the cloud's ingest) addresses columns
+ * by their database name (`full_name`), not the property name (`fullName`);
+ * skipping this would silently push empty fields with no error anywhere.
+ *
+ * Exported so a host can build the same translated row from a table it read
+ * some other way — e.g. re-querying a row inside an auth library's own
+ * lifecycle hook, where there is no `insertAndPush` call site to wrap
+ * because the library performs the insert internally.
+ */
+export declare function toColumnKeyedRow(table: Table, row: Record<string, unknown>): Record<string, unknown>;
+export declare function insertAndPush(clivly: PushOneCapable, db: unknown, table: Table, opts: {
+  entity: string;
+}): (values: Record<string, unknown>, waitUntil?: (promise: Promise<unknown>) => void) => Promise<Record<string, unknown>>;
 /**
  * Build a `NamespaceIntrospector` from any Drizzle client that exposes
  * `.execute()`. Reads `information_schema` in the connection's default schema

package/drizzle.d.mts

@@ -1,6 +1,6 @@
 import { R as ProjectionMapping, z as ProjectionRef } from "./entity-config-CKcj4-M_.mjs";
 import { n as buildUniqueConstraints, r as discoverFromDrizzle } from "./drizzle-ehVWLSrN.mjs";
-import { t as NamespaceIntrospector, v as SyncSource } from "./namespace-probe-CNQKSmxz.mjs";
+import { t as NamespaceIntrospector, v as SyncSource } from "./namespace-probe-DykR0kgh.mjs";
 import { Table } from "drizzle-orm";
 //#region ../sdk/src/drizzle-projection.d.ts
 /**
@@ -82,6 +82,21 @@ interface FromDrizzleOptions {
    * check and a false explanation.
    */
   objectType?: string;
+  /**
+   * The label this source's pushes carry, when it differs from `entity`.
+   *
+   * `entity` is the CURSOR KEY — two sources sharing it share a cursor, so the
+   * first to run advances it and the second silently pushes nothing. The push
+   * LABEL is matched against a mapping's `sourceTable`, which is the host
+   * table name. Those two requirements conflict whenever one table feeds two
+   * concepts: an `organization` table mapped as both a company and a
+   * subscription deal needs distinct cursors but the same table name on the
+   * wire.
+   *
+   * `fromDrizzleProjection` stamps this itself for the projection case. This
+   * is the same escape hatch for a plain single-table source.
+   */
+  pushSource?: string;
 }
 /**
  * Build a `SyncSource` from a Drizzle table, generating the keyset-paginated
@@ -100,6 +115,56 @@ export declare function fromDrizzle(db: DrizzleDb, table: Table, opts: FromDrizz
   objectType: string;
 };
 export declare function fromDrizzle(db: DrizzleDb, table: Table, opts: FromDrizzleOptions): SyncSource;
+interface PushOneCapable {
+  pushOne(entityKey: string, row: Record<string, unknown>): Promise<void>;
+}
+/**
+ * Insert a row into a mapped Drizzle table and push it to Clivly immediately
+ * — the "one call does both" instant-push API (see
+ * docs/reviews/2026-09-19-near-real-time-sync-plan.md, question 1). Returns
+ * only after the write completes; the push itself is fire-and-forget (see
+ * `pushOne`), so this resolves at the same time a plain `db.insert(...)`
+ * would.
+ *
+ * Created once per mapped table, mirroring `fromDrizzle`'s own convention —
+ * no per-call table-to-entity lookup, so a table two entities share (e.g.
+ * `user` for both `user` and `organizationOwner`) is never ambiguous:
+ * ```ts
+ * const insertUser = insertAndPush(clivly, db, schema.user, { entity: "user" });
+ * // in the signup handler:
+ * const created = await insertUser(newUserValues, c.executionCtx);
+ * ```
+ *
+ * `waitUntil`, when provided (Hono exposes it as `c.executionCtx.waitUntil`),
+ * extends the request's lifetime past the response so the push survives on
+ * Cloudflare Workers and similar runtimes, which otherwise kill background
+ * work the instant a response is sent. Omit it on a long-lived process where
+ * nothing tears the request down early.
+ *
+ * Table property keys are translated to real database column names before
+ * the push — the same translation `fromDrizzle` performs on `fetchPage` rows
+ * — because a raw `.returning()` result is keyed by Drizzle property name
+ * (`fullName`), and every consumer downstream of a push (the fieldMap, the
+ * cloud's ingest) addresses columns by their database name (`full_name`).
+ * Skipping this would silently push empty fields with no error anywhere.
+ */
+/**
+ * Translate a Drizzle-property-keyed row (e.g. a `.returning()` result, or a
+ * plain unprojected `select()`) to real database column names — the same
+ * translation `fromDrizzle` performs on `fetchPage` rows. Every consumer
+ * downstream of a push (the fieldMap, the cloud's ingest) addresses columns
+ * by their database name (`full_name`), not the property name (`fullName`);
+ * skipping this would silently push empty fields with no error anywhere.
+ *
+ * Exported so a host can build the same translated row from a table it read
+ * some other way — e.g. re-querying a row inside an auth library's own
+ * lifecycle hook, where there is no `insertAndPush` call site to wrap
+ * because the library performs the insert internally.
+ */
+export declare function toColumnKeyedRow(table: Table, row: Record<string, unknown>): Record<string, unknown>;
+export declare function insertAndPush(clivly: PushOneCapable, db: unknown, table: Table, opts: {
+  entity: string;
+}): (values: Record<string, unknown>, waitUntil?: (promise: Promise<unknown>) => void) => Promise<Record<string, unknown>>;
 /**
  * Build a `NamespaceIntrospector` from any Drizzle client that exposes
  * `.execute()`. Reads `information_schema` in the connection's default schema

package/drizzle.mjs

@@ -141,6 +141,7 @@ function fromDrizzle(db, table, opts) {
 	const idColumnName = idColumn.name;
 	const source = {
 		entity: opts.entity,
+		...opts.pushSource === void 0 ? {} : { pushSource: opts.pushSource },
 		cursorField: cursorColumnName,
 		idField: idColumnName,
 		fetchPage: ({ since, limit }) => drizzleDb.select(projection).from(table).where(since ? sql`(${cursorColumn}, ${idColumn}) > (${since.time}, ${since.id})` : void 0).orderBy(asc(cursorColumn), asc(idColumn)).limit(limit),
@@ -162,6 +163,69 @@ function fromDrizzle(db, table, opts) {
 	return source;
 }
 /**
+* Insert a row into a mapped Drizzle table and push it to Clivly immediately
+* — the "one call does both" instant-push API (see
+* docs/reviews/2026-09-19-near-real-time-sync-plan.md, question 1). Returns
+* only after the write completes; the push itself is fire-and-forget (see
+* `pushOne`), so this resolves at the same time a plain `db.insert(...)`
+* would.
+*
+* Created once per mapped table, mirroring `fromDrizzle`'s own convention —
+* no per-call table-to-entity lookup, so a table two entities share (e.g.
+* `user` for both `user` and `organizationOwner`) is never ambiguous:
+* ```ts
+* const insertUser = insertAndPush(clivly, db, schema.user, { entity: "user" });
+* // in the signup handler:
+* const created = await insertUser(newUserValues, c.executionCtx);
+* ```
+*
+* `waitUntil`, when provided (Hono exposes it as `c.executionCtx.waitUntil`),
+* extends the request's lifetime past the response so the push survives on
+* Cloudflare Workers and similar runtimes, which otherwise kill background
+* work the instant a response is sent. Omit it on a long-lived process where
+* nothing tears the request down early.
+*
+* Table property keys are translated to real database column names before
+* the push — the same translation `fromDrizzle` performs on `fetchPage` rows
+* — because a raw `.returning()` result is keyed by Drizzle property name
+* (`fullName`), and every consumer downstream of a push (the fieldMap, the
+* cloud's ingest) addresses columns by their database name (`full_name`).
+* Skipping this would silently push empty fields with no error anywhere.
+*/
+/**
+* Translate a Drizzle-property-keyed row (e.g. a `.returning()` result, or a
+* plain unprojected `select()`) to real database column names — the same
+* translation `fromDrizzle` performs on `fetchPage` rows. Every consumer
+* downstream of a push (the fieldMap, the cloud's ingest) addresses columns
+* by their database name (`full_name`), not the property name (`fullName`);
+* skipping this would silently push empty fields with no error anywhere.
+*
+* Exported so a host can build the same translated row from a table it read
+* some other way — e.g. re-querying a row inside an auth library's own
+* lifecycle hook, where there is no `insertAndPush` call site to wrap
+* because the library performs the insert internally.
+*/
+function toColumnKeyedRow(table, row) {
+	const columns = getTableColumns(table);
+	const columnNameByPropertyKey = /* @__PURE__ */ new Map();
+	for (const [propertyKey, column] of Object.entries(columns)) columnNameByPropertyKey.set(propertyKey, column.name);
+	const out = {};
+	for (const [propertyKey, value] of Object.entries(row)) out[columnNameByPropertyKey.get(propertyKey) ?? propertyKey] = value;
+	return out;
+}
+function insertAndPush(clivly, db, table, opts) {
+	const insertableDb = db;
+	return async (values, waitUntil) => {
+		const [created] = await insertableDb.insert(table).values(values).returning();
+		if (!created) throw new Error(`insertAndPush: insert into "${getTableName(table)}" returned no row.`);
+		const row = toColumnKeyedRow(table, created);
+		const pushed = clivly.pushOne(opts.entity, row);
+		if (waitUntil) waitUntil(pushed);
+		else await pushed;
+		return created;
+	};
+}
+/**
 * Build a `NamespaceIntrospector` from any Drizzle client that exposes
 * `.execute()`. Reads `information_schema` in the connection's default schema
 * (`current_schema()`), so it reports exactly the tables the app can reach.
@@ -191,4 +255,4 @@ function drizzleIntrospector(db) {
 	};
 }
 //#endregion
-export { buildUniqueConstraints, discoverFromDrizzle, drizzleIntrospector, fromDrizzle, fromDrizzleProjection };
+export { buildUniqueConstraints, discoverFromDrizzle, drizzleIntrospector, fromDrizzle, fromDrizzleProjection, insertAndPush, toColumnKeyedRow };