clivly 0.12.0 → 0.14.1

package/index.cjs

@@ -3,7 +3,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_entity_config = require("./entity-config-BI4RYNKL.cjs");
 require("./mapping-score-CaB3F4Uu.cjs");
 const require_internal_entity_heuristics = require("./internal-entity-heuristics.cjs");
-const require_sdk = require("./sdk-BvGSxBQc.cjs");
+const require_sdk = require("./sdk-ZMy4C4VK.cjs");
 let node_child_process = require("node:child_process");
 let node_fs = require("node:fs");
 let node_module = require("node:module");
@@ -3357,6 +3357,87 @@ function checkBootHook(readFile) {
 	};
 }
 //#endregion
+//#region src/cursor-store-check.ts
+/**
+* Whether a config that will run on a serverless runtime persists its sync
+* cursor.
+*
+* Without a persisted cursor, every `delta` sync starts from `null` and
+* re-reads the whole source table — because the SDK's default store lives in
+* memory, and a request-scoped runtime discards memory between invocations.
+* Nothing about this is visible from the outside: the run reports success, the
+* row counts look plausible, and the only symptom is the database bill. One
+* deployment on Workers burned a 5 GB monthly network allowance before launch
+* with two users, and `clivly status` was green the whole time.
+*
+* Read from source text rather than by loading the config: an edge config
+* frequently cannot be imported in Node at all, and that is exactly the case
+* that most needs an answer here.
+*/
+/** `cursorStore:` or `cursorStore,` as a real property, not in a comment. */
+const CURSOR_STORE_PROPERTY = /(^|[{,\s])cursorStore\s*[:,}]/;
+/** Marker files that pin a project to a specific serverless platform. */
+const PLATFORM_MARKERS = [
+	{
+		file: "wrangler.jsonc",
+		label: "Cloudflare Workers"
+	},
+	{
+		file: "wrangler.json",
+		label: "Cloudflare Workers"
+	},
+	{
+		file: "wrangler.toml",
+		label: "Cloudflare Workers"
+	},
+	{
+		file: "vercel.json",
+		label: "Vercel"
+	},
+	{
+		file: "netlify.toml",
+		label: "Netlify"
+	}
+];
+/** Next.js and friends: `export const runtime = "edge"`. */
+const INLINE_EDGE_RUNTIME = /export\s+const\s+runtime\s*=\s*["']edge["']/;
+/**
+* Strip comments and string literals before looking for the property.
+*
+* The scaffolded config ships `cursorStore` commented out as an example, and a
+* scan that counted that as configured would hand back a green rung for the
+* precise setup it exists to catch.
+*/
+function stripCommentsAndStrings(source) {
+	return source.replace(/\/\*[\s\S]*?\*\//g, " ").replace(/(^|[^:])\/\/[^\n]*/g, "$1 ").replace(/"(?:[^"\\]|\\.)*"/g, "\"\"").replace(/'(?:[^'\\]|\\.)*'/g, "''").replace(/`(?:[^`\\]|\\.)*`/g, "``");
+}
+function detectEdgeRuntime(source, readFile) {
+	for (const { file, label } of PLATFORM_MARKERS) if (readFile(file) !== null) return label;
+	return INLINE_EDGE_RUNTIME.test(source) ? "edge runtime" : null;
+}
+/**
+* `readFile` resolves paths against the project root and is used only to spot
+* platform marker files. A project with none is treated as a long-lived host —
+* the safe default, since warning a Node host would be noise, and noise is
+* what teaches people to ignore warnings.
+*/
+function detectCursorStore(source, readFile = () => null) {
+	const configured = CURSOR_STORE_PROPERTY.test(stripCommentsAndStrings(source));
+	const edgeRuntime = detectEdgeRuntime(source, readFile);
+	return {
+		configured,
+		edgeRuntime,
+		shouldWarn: edgeRuntime !== null && !configured
+	};
+}
+/** The remediation shown under the warning. */
+const CURSOR_STORE_HINT = "Pass `cursorStore: kvCursorStore(env.MY_KV)` (exported from `@clivly/sdk`) so delta syncs resume instead of re-reading every table. See https://clivly.com/docs/concepts/sync#cursor-stores";
+function cursorStoreDetail(verdict) {
+	if (verdict.configured) return "delta syncs resume from a persisted cursor";
+	if (verdict.edgeRuntime === null) return "in-memory (fine on a long-lived host)";
+	return `No \`cursorStore\` on ${verdict.edgeRuntime} — memory does not survive between invocations, so every delta sync re-reads your entire source tables.`;
+}
+//#endregion
 //#region src/edge-safety.ts
 const NODE_BUILTINS = /* @__PURE__ */ new Set([
 	"assert",
@@ -3700,6 +3781,26 @@ const STATUS_STAGES = [
 			});
 		}
 	},
+	{
+		id: "cursor-store",
+		label: "Sync cursor persists",
+		needs: [configStage.id],
+		run(ctx) {
+			const read = ctx.readConfigSource ?? defaultReadConfigSource;
+			const source = read(ctx.configPath);
+			if (source === null) return Promise.resolve({
+				state: "skip",
+				detail: "config not readable"
+			});
+			const root = (0, node_path.dirname)(ctx.configPath);
+			const verdict = detectCursorStore(source, (relative) => read((0, node_path.resolve)(root, relative)));
+			return Promise.resolve({
+				state: verdict.shouldWarn ? "warn" : "pass",
+				detail: cursorStoreDetail(verdict),
+				...verdict.shouldWarn ? { hint: CURSOR_STORE_HINT } : {}
+			});
+		}
+	},
 	{
 		id: "boot-hook",
 		label: "Boot hook wired",

package/index.mjs

@@ -2,7 +2,7 @@
 import { t as CANONICAL_FIELDS } from "./entity-config-Ccfb2IL9.mjs";
 import "./mapping-score-C68uAqGB.mjs";
 import { hasDefiningColumn, isFrameworkTable, matchesConcept, requiredFieldsFor, scoreFieldMap, scoreRelationships, suggestCursorField, toFieldMap } from "./internal-entity-heuristics.mjs";
-import { s as isPlaceholderUrl, t as createClivlySDK } from "./sdk-C-Pjxj2y.mjs";
+import { n as createClivlySDK, u as isPlaceholderUrl } from "./sdk-DLoVPlGB.mjs";
 import { createRequire } from "node:module";
 import { spawn } from "node:child_process";
 import { accessSync, constants, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, statSync, watch, writeFileSync } from "node:fs";
@@ -3356,6 +3356,87 @@ function checkBootHook(readFile) {
 	};
 }
 //#endregion
+//#region src/cursor-store-check.ts
+/**
+* Whether a config that will run on a serverless runtime persists its sync
+* cursor.
+*
+* Without a persisted cursor, every `delta` sync starts from `null` and
+* re-reads the whole source table — because the SDK's default store lives in
+* memory, and a request-scoped runtime discards memory between invocations.
+* Nothing about this is visible from the outside: the run reports success, the
+* row counts look plausible, and the only symptom is the database bill. One
+* deployment on Workers burned a 5 GB monthly network allowance before launch
+* with two users, and `clivly status` was green the whole time.
+*
+* Read from source text rather than by loading the config: an edge config
+* frequently cannot be imported in Node at all, and that is exactly the case
+* that most needs an answer here.
+*/
+/** `cursorStore:` or `cursorStore,` as a real property, not in a comment. */
+const CURSOR_STORE_PROPERTY = /(^|[{,\s])cursorStore\s*[:,}]/;
+/** Marker files that pin a project to a specific serverless platform. */
+const PLATFORM_MARKERS = [
+	{
+		file: "wrangler.jsonc",
+		label: "Cloudflare Workers"
+	},
+	{
+		file: "wrangler.json",
+		label: "Cloudflare Workers"
+	},
+	{
+		file: "wrangler.toml",
+		label: "Cloudflare Workers"
+	},
+	{
+		file: "vercel.json",
+		label: "Vercel"
+	},
+	{
+		file: "netlify.toml",
+		label: "Netlify"
+	}
+];
+/** Next.js and friends: `export const runtime = "edge"`. */
+const INLINE_EDGE_RUNTIME = /export\s+const\s+runtime\s*=\s*["']edge["']/;
+/**
+* Strip comments and string literals before looking for the property.
+*
+* The scaffolded config ships `cursorStore` commented out as an example, and a
+* scan that counted that as configured would hand back a green rung for the
+* precise setup it exists to catch.
+*/
+function stripCommentsAndStrings(source) {
+	return source.replace(/\/\*[\s\S]*?\*\//g, " ").replace(/(^|[^:])\/\/[^\n]*/g, "$1 ").replace(/"(?:[^"\\]|\\.)*"/g, "\"\"").replace(/'(?:[^'\\]|\\.)*'/g, "''").replace(/`(?:[^`\\]|\\.)*`/g, "``");
+}
+function detectEdgeRuntime(source, readFile) {
+	for (const { file, label } of PLATFORM_MARKERS) if (readFile(file) !== null) return label;
+	return INLINE_EDGE_RUNTIME.test(source) ? "edge runtime" : null;
+}
+/**
+* `readFile` resolves paths against the project root and is used only to spot
+* platform marker files. A project with none is treated as a long-lived host —
+* the safe default, since warning a Node host would be noise, and noise is
+* what teaches people to ignore warnings.
+*/
+function detectCursorStore(source, readFile = () => null) {
+	const configured = CURSOR_STORE_PROPERTY.test(stripCommentsAndStrings(source));
+	const edgeRuntime = detectEdgeRuntime(source, readFile);
+	return {
+		configured,
+		edgeRuntime,
+		shouldWarn: edgeRuntime !== null && !configured
+	};
+}
+/** The remediation shown under the warning. */
+const CURSOR_STORE_HINT = "Pass `cursorStore: kvCursorStore(env.MY_KV)` (exported from `@clivly/sdk`) so delta syncs resume instead of re-reading every table. See https://clivly.com/docs/concepts/sync#cursor-stores";
+function cursorStoreDetail(verdict) {
+	if (verdict.configured) return "delta syncs resume from a persisted cursor";
+	if (verdict.edgeRuntime === null) return "in-memory (fine on a long-lived host)";
+	return `No \`cursorStore\` on ${verdict.edgeRuntime} — memory does not survive between invocations, so every delta sync re-reads your entire source tables.`;
+}
+//#endregion
 //#region src/edge-safety.ts
 const NODE_BUILTINS = /* @__PURE__ */ new Set([
 	"assert",
@@ -3699,6 +3780,26 @@ const STATUS_STAGES = [
 			});
 		}
 	},
+	{
+		id: "cursor-store",
+		label: "Sync cursor persists",
+		needs: [configStage.id],
+		run(ctx) {
+			const read = ctx.readConfigSource ?? defaultReadConfigSource;
+			const source = read(ctx.configPath);
+			if (source === null) return Promise.resolve({
+				state: "skip",
+				detail: "config not readable"
+			});
+			const root = dirname(ctx.configPath);
+			const verdict = detectCursorStore(source, (relative) => read(resolve(root, relative)));
+			return Promise.resolve({
+				state: verdict.shouldWarn ? "warn" : "pass",
+				detail: cursorStoreDetail(verdict),
+				...verdict.shouldWarn ? { hint: CURSOR_STORE_HINT } : {}
+			});
+		}
+	},
 	{
 		id: "boot-hook",
 		label: "Boot hook wired",

package/internal-adapter.d.cts

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

package/internal-adapter.d.mts

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

package/internal-sync-engine.cjs

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

package/internal-sync-engine.d.cts

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

package/internal-sync-engine.d.mts

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

package/internal-sync-engine.mjs

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

package/internal.cjs

@@ -7,7 +7,7 @@ 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");
-const require_sync_engine = require("./sync-engine-Dwm_KDUS.cjs");
+const require_sync_engine = require("./sync-engine-BGVDsrOQ.cjs");
 const require_types = require("./types-Cq5gHCTq.cjs");
 exports.BASE_REF = require_projection.BASE_REF;
 exports.CANONICAL_FIELDS = require_entity_config.CANONICAL_FIELDS;
@@ -43,6 +43,7 @@ exports.hostOwnedFieldMessage = require_internal.hostOwnedFieldMessage;
 exports.identityRefs = require_projection.identityRefs;
 exports.isClosedStageType = require_types.isClosedStageType;
 exports.isHostOwned = require_internal.isHostOwned;
+exports.isRemovalAction = require_sync_engine.isRemovalAction;
 exports.joinFansOut = require_entity_config.joinFansOut;
 exports.mappingsToEntitiesConfig = require_mappings_config.mappingsToEntitiesConfig;
 exports.matchesCondition = require_internal.matchesCondition;
@@ -58,6 +59,7 @@ exports.relationshipSchema = require_entity_config.relationshipSchema;
 exports.relationshipViaSignature = require_mapping_form.relationshipViaSignature;
 exports.relationshipsSchema = require_entity_config.relationshipsSchema;
 exports.requiredFieldsFor = require_entity_config.requiredFieldsFor;
+exports.resolveActions = require_sync_engine.resolveActions;
 exports.runSync = require_sync_engine.runSync;
 exports.slugify = require_internal.slugify;
 exports.toObjectTypeSlug = require_internal.toObjectTypeSlug;

package/internal.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 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 { t as CRMAdapter } from "./adapter-JpXSAnj-.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 SyncAction, f as isRemovalAction, g as runSync, h as resolveActions, l as SyncResult, m as reconcile, n as MirrorRecord, o as ResolvedMembership, r as PersistAction, s as SourceRow, t as EntitySyncResult, u as SyncStore } from "./sync-engine-CYsWOujz.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 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 };
+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 ResolvedMembership, 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, isRemovalAction, joinFansOut, mappingsToEntitiesConfig, matchesCondition, missingRequiredFields, primaryKeyColumns, projectionFields, projectionSchema, quoteIdent, reconcile, rejectedCompanyFields, rejectedContactFields, relationshipSchema, relationshipViaSignature, relationshipsSchema, requiredFieldsFor, resolveActions, runSync, slugify, toObjectTypeSlug, validateEntitiesConfig, validateProjection, validateProjectionFilter };

package/internal.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 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 { t as CRMAdapter } from "./adapter-B-iBMhl0.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 SyncAction, f as isRemovalAction, g as runSync, h as resolveActions, l as SyncResult, m as reconcile, n as MirrorRecord, o as ResolvedMembership, r as PersistAction, s as SourceRow, t as EntitySyncResult, u as SyncStore } from "./sync-engine-C_5TpvfX.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 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 };
+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 ResolvedMembership, 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, isRemovalAction, joinFansOut, mappingsToEntitiesConfig, matchesCondition, missingRequiredFields, primaryKeyColumns, projectionFields, projectionSchema, quoteIdent, reconcile, rejectedCompanyFields, rejectedContactFields, relationshipSchema, relationshipViaSignature, relationshipsSchema, requiredFieldsFor, resolveActions, runSync, slugify, toObjectTypeSlug, validateEntitiesConfig, validateProjection, validateProjectionFilter };

package/internal.mjs

@@ -6,6 +6,6 @@ import { a as hostOwnedFieldMessage, c as rejectedContactFields, i as toObjectTy
 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";
-import { i as runSync, r as reconcile } from "./sync-engine-Df2MCs_n.mjs";
+import { a as resolveActions, i as reconcile, n as isRemovalAction, o as runSync } from "./sync-engine-DH058G3w.mjs";
 import { n as isClosedStageType, t as OPEN_STAGE_TYPE } from "./types-YJTkXKzU.mjs";
-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 };
+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, isRemovalAction, joinFansOut, mappingsToEntitiesConfig, matchesCondition, missingRequiredFields, primaryKeyColumns, projectionFields, projectionSchema, quoteIdent, reconcile, rejectedCompanyFields, rejectedContactFields, relationshipSchema, relationshipViaSignature, relationshipsSchema, requiredFieldsFor, resolveActions, runSync, slugify, toObjectTypeSlug, validateEntitiesConfig, validateProjection, validateProjectionFilter };

package/{namespace-probe-CNQKSmxz.d.mts → namespace-probe-DykR0kgh.d.mts}

@@ -164,6 +164,23 @@ interface ClivlySDKConfig {
      */
     intervalMs?: number;
     batchSize?: number;
+    /**
+     * Opt into `pushOne()`/`insertAndPush()` pushing a single changed row to
+     * Clivly immediately, instead of waiting for the next delta sync. Off by
+     * default: turning it on changes a write's async failure surface (a push
+     * can fail independently of the write that triggered it, swallowed and
+     * left for the next delta sync to catch), which an existing install
+     * upgrading to a newer `clivly` should opt into deliberately rather than
+     * inherit silently. Requires a real scheduled delta sync running
+     * underneath as the safety net for anything the instant push misses (a
+     * failed push, a raw SQL write, a bulk import) — see
+     * docs/reviews/2026-09-19-near-real-time-sync-plan.md.
+     *
+     * Can also be disabled at runtime without a redeploy via the
+     * `CLIVLY_INSTANT_PUSH_DISABLED=true` environment variable — the fast
+     * rollback switch if this misbehaves in production.
+     */
+    instant?: boolean;
   };
   /**
    * The remote sync trigger: how Clivly Cloud asks this app to run a sync.
@@ -477,6 +494,31 @@ interface ClivlySDK {
    * own state.
    */
   ping(): Promise<ClivlyConnectResult>;
+  /**
+   * Push one row to Clivly immediately, instead of waiting for the next delta
+   * sync — the "instant" half of near-real-time sync (see
+   * docs/reviews/2026-09-19-near-real-time-sync-plan.md). No-ops unless
+   * `sync.instant` is set and `CLIVLY_INSTANT_PUSH_DISABLED` is unset.
+   *
+   * `entityKey` is a key of `config.entities.entities` (the same key
+   * `clivly.config.ts` declares the entity under), not a table name — an
+   * unresolvable key logs a warning and returns without throwing, the same
+   * fail-safe as every other call site here: a config mismatch never syncs
+   * the wrong thing, it just doesn't sync this row instantly (the safety-net
+   * delta sync still will).
+   *
+   * `row` must be keyed by the source table's real database column names
+   * (`full_name`, not `fullName`) — the same contract `fetchPage` rows
+   * satisfy. `insertAndPush` (from `clivly/drizzle`) performs this
+   * translation for you from a Drizzle table; calling `pushOne` directly with
+   * a raw Drizzle `.returning()` row will silently push empty fields.
+   *
+   * Never throws and never advances the delta cursor. Fire-and-forget by
+   * design: on Cloudflare Workers and similar runtimes, wrap the call in
+   * `ctx.waitUntil(...)` so it survives past the response, since nothing
+   * here blocks or awaits the caller's own write.
+   */
+  pushOne(entityKey: string, row: Record<string, unknown>): Promise<void>;
   /**
    * One-shot heartbeat + a single sync, with no keep-alive timers. The correct
    * entry point on serverless/edge (Workers, Vercel, Lambda), where `start()`'s

package/{namespace-probe-C5RLl74M.d.cts → namespace-probe-H7yWc0JV.d.cts}

@@ -164,6 +164,23 @@ interface ClivlySDKConfig {
      */
     intervalMs?: number;
     batchSize?: number;
+    /**
+     * Opt into `pushOne()`/`insertAndPush()` pushing a single changed row to
+     * Clivly immediately, instead of waiting for the next delta sync. Off by
+     * default: turning it on changes a write's async failure surface (a push
+     * can fail independently of the write that triggered it, swallowed and
+     * left for the next delta sync to catch), which an existing install
+     * upgrading to a newer `clivly` should opt into deliberately rather than
+     * inherit silently. Requires a real scheduled delta sync running
+     * underneath as the safety net for anything the instant push misses (a
+     * failed push, a raw SQL write, a bulk import) — see
+     * docs/reviews/2026-09-19-near-real-time-sync-plan.md.
+     *
+     * Can also be disabled at runtime without a redeploy via the
+     * `CLIVLY_INSTANT_PUSH_DISABLED=true` environment variable — the fast
+     * rollback switch if this misbehaves in production.
+     */
+    instant?: boolean;
   };
   /**
    * The remote sync trigger: how Clivly Cloud asks this app to run a sync.
@@ -477,6 +494,31 @@ interface ClivlySDK {
    * own state.
    */
   ping(): Promise<ClivlyConnectResult>;
+  /**
+   * Push one row to Clivly immediately, instead of waiting for the next delta
+   * sync — the "instant" half of near-real-time sync (see
+   * docs/reviews/2026-09-19-near-real-time-sync-plan.md). No-ops unless
+   * `sync.instant` is set and `CLIVLY_INSTANT_PUSH_DISABLED` is unset.
+   *
+   * `entityKey` is a key of `config.entities.entities` (the same key
+   * `clivly.config.ts` declares the entity under), not a table name — an
+   * unresolvable key logs a warning and returns without throwing, the same
+   * fail-safe as every other call site here: a config mismatch never syncs
+   * the wrong thing, it just doesn't sync this row instantly (the safety-net
+   * delta sync still will).
+   *
+   * `row` must be keyed by the source table's real database column names
+   * (`full_name`, not `fullName`) — the same contract `fetchPage` rows
+   * satisfy. `insertAndPush` (from `clivly/drizzle`) performs this
+   * translation for you from a Drizzle table; calling `pushOne` directly with
+   * a raw Drizzle `.returning()` row will silently push empty fields.
+   *
+   * Never throws and never advances the delta cursor. Fire-and-forget by
+   * design: on Cloudflare Workers and similar runtimes, wrap the call in
+   * `ctx.waitUntil(...)` so it survives past the response, since nothing
+   * here blocks or awaits the caller's own write.
+   */
+  pushOne(entityKey: string, row: Record<string, unknown>): Promise<void>;
   /**
    * One-shot heartbeat + a single sync, with no keep-alive timers. The correct
    * entry point on serverless/edge (Workers, Vercel, Lambda), where `start()`'s

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clivly",
-  "version": "0.12.0",
+  "version": "0.14.1",
   "private": false,
   "type": "module",
   "description": "Clivly CLI — scaffold a CRM into your app (clivly init).",