@clivly/core 0.9.1 → 0.9.2

package/README.md

@@ -14,6 +14,9 @@ the view compiler that turns a mapping into SQL. Its only runtime dependency is
 > to import it from. Reach for `@clivly/core` when you are building an adapter
 > or working with the entity config outside an SDK instance.
 
+Connection and presence transport live in `@clivly/sdk`, not this package.
+That includes the opt-in WebSocket presence transport and its HTTP fallback.
+
 ## Prerequisites
 
 | Requirement | Version / note |

package/dist/drizzle.d.cts

@@ -1,4 +1,4 @@
-import { f as DiscoveredColumnMeta, p as DiscoveredSchemaTable } from "./entity-config-CLxI8dVb.cjs";
+import { m as DiscoveredSchemaTable, p as DiscoveredColumnMeta } from "./entity-config-buOIVtMM.cjs";
 import { Table } from "drizzle-orm";
 //#region src/drizzle.d.ts
 /**

package/dist/drizzle.d.mts

@@ -1,4 +1,4 @@
-import { f as DiscoveredColumnMeta, p as DiscoveredSchemaTable } from "./entity-config-CLxI8dVb.mjs";
+import { m as DiscoveredSchemaTable, p as DiscoveredColumnMeta } from "./entity-config-buOIVtMM.mjs";
 import { Table } from "drizzle-orm";
 //#region src/drizzle.d.ts
 /**

package/dist/{entity-config-Dh8aEcgj.cjs → entity-config-Bfq3OkCU.cjs}

@@ -438,10 +438,23 @@ const entitySchema = zod.z.strictObject({
 	relationships: zod.z.record(zod.z.string(), relationshipSchema).optional(),
 	/**
 	* For a "custom" entity, the crm_object_types row this materializes into.
-	* Required for custom (enforced at the API layer), unused for standard concepts.
+	* Server-generated, so pasting one into config couples the file to a
+	* specific workspace. Prefer declaring `objectType` and letting
+	* `clivly push-schema` resolve the id by slug.
 	*/
 	targetObjectTypeId: zod.z.string().min(1).optional(),
 	/**
+	* Declares the custom object this entity materializes into, so config is
+	* self-contained: the entity key is the slug (unique per org and immutable),
+	* and `clivly push-schema` creates the object type if the workspace does not
+	* have it yet. An alternative to pasting a `targetObjectTypeId`.
+	*/
+	objectType: zod.z.strictObject({
+		name: zod.z.string().min(1),
+		pluralName: zod.z.string().min(1).optional(),
+		iconKey: zod.z.string().min(1).optional()
+	}).optional(),
+	/**
 	* Advanced mapping: derive this entity from a base table plus explicit joins
 	* instead of a single source table. Valid only for `concept: "custom"`.
 	*
@@ -483,17 +496,22 @@ function defaultWarn(message) {
 	console.warn(message);
 }
 /**
-* Structural helper for `clivly.config.ts`. Gives full type inference on the
-* literal you pass and eagerly parses it, so shape errors surface at config
-* load rather than at sync time.
-*
-* It also catches the silent-data-loss footgun: a non-canonical field key for a
-* materialised concept (e.g. `fullName` instead of `name` on a `contact`) has no
-* destination column, so the store would write an empty value. By default these
-* are reported via `onWarn` (a `console.warn`); pass `{ strict: true }` to throw
-* a `ClivlyConfigError` instead. Does NOT validate against the host schema — that
-* needs the discovered schema; see `validateEntitiesConfig`.
+* The custom objects a config declares, keyed by entity slug. Entities that
+* already carry an explicit `targetObjectTypeId` are omitted: their object type
+* exists server-side and re-declaring it would be a no-op at best.
 */
+function customObjectDeclarations(config) {
+	const declarations = [];
+	for (const [slug, entity] of Object.entries(config.entities)) {
+		if (entity.concept !== "custom" || entity.targetObjectTypeId) continue;
+		if (!entity.objectType) continue;
+		declarations.push({
+			slug,
+			...entity.objectType
+		});
+	}
+	return declarations;
+}
 /**
 * The `fields` entry a projection binding implies, qualified as `ref.column`.
 * Qualified rather than bare: two bindings can pull the same column name from
@@ -633,7 +651,7 @@ function validateEntity(v, config, key, entity, schema) {
 	}
 	if (entity.projection) {
 		if (entity.concept !== "custom") v.report(`${base}.projection`, `projection mappings are only supported for concept "${CUSTOM_CONCEPT}"`);
-		if (!entity.targetObjectTypeId) v.report(`${base}.targetObjectTypeId`, "a projection mapping must target a custom object type");
+		if (!(entity.targetObjectTypeId || entity.objectType)) v.report(`${base}.targetObjectTypeId`, "a projection mapping must target a custom object type — declare `objectType: { name: \"…\" }` (recommended: the entity key becomes its slug) or set an explicit `targetObjectTypeId`");
 		if (entity.source !== entity.projection.baseTable) v.report(`${base}.source`, `"source" ("${entity.source}") must match "projection.baseTable" ("${entity.projection.baseTable}") — the view compiler reads baseTable and the sync engine reads source, so a mismatch makes them disagree about which table this entity is`);
 		for (const error of validateProjection(entity.projection, schema, base)) v.report(error.path, error.message);
 		validateReadOnly(v, base, entity);
@@ -705,6 +723,12 @@ Object.defineProperty(exports, "coversUniqueKey", {
 		return coversUniqueKey;
 	}
 });
+Object.defineProperty(exports, "customObjectDeclarations", {
+	enumerable: true,
+	get: function() {
+		return customObjectDeclarations;
+	}
+});
 Object.defineProperty(exports, "defineClivlyConfig", {
 	enumerable: true,
 	get: function() {

package/dist/{entity-config-8Fgr6IOH.mjs → entity-config-DFJ8L9jm.mjs}

@@ -438,10 +438,23 @@ const entitySchema = z.strictObject({
 	relationships: z.record(z.string(), relationshipSchema).optional(),
 	/**
 	* For a "custom" entity, the crm_object_types row this materializes into.
-	* Required for custom (enforced at the API layer), unused for standard concepts.
+	* Server-generated, so pasting one into config couples the file to a
+	* specific workspace. Prefer declaring `objectType` and letting
+	* `clivly push-schema` resolve the id by slug.
 	*/
 	targetObjectTypeId: z.string().min(1).optional(),
 	/**
+	* Declares the custom object this entity materializes into, so config is
+	* self-contained: the entity key is the slug (unique per org and immutable),
+	* and `clivly push-schema` creates the object type if the workspace does not
+	* have it yet. An alternative to pasting a `targetObjectTypeId`.
+	*/
+	objectType: z.strictObject({
+		name: z.string().min(1),
+		pluralName: z.string().min(1).optional(),
+		iconKey: z.string().min(1).optional()
+	}).optional(),
+	/**
 	* Advanced mapping: derive this entity from a base table plus explicit joins
 	* instead of a single source table. Valid only for `concept: "custom"`.
 	*
@@ -483,17 +496,22 @@ function defaultWarn(message) {
 	console.warn(message);
 }
 /**
-* Structural helper for `clivly.config.ts`. Gives full type inference on the
-* literal you pass and eagerly parses it, so shape errors surface at config
-* load rather than at sync time.
-*
-* It also catches the silent-data-loss footgun: a non-canonical field key for a
-* materialised concept (e.g. `fullName` instead of `name` on a `contact`) has no
-* destination column, so the store would write an empty value. By default these
-* are reported via `onWarn` (a `console.warn`); pass `{ strict: true }` to throw
-* a `ClivlyConfigError` instead. Does NOT validate against the host schema — that
-* needs the discovered schema; see `validateEntitiesConfig`.
+* The custom objects a config declares, keyed by entity slug. Entities that
+* already carry an explicit `targetObjectTypeId` are omitted: their object type
+* exists server-side and re-declaring it would be a no-op at best.
 */
+function customObjectDeclarations(config) {
+	const declarations = [];
+	for (const [slug, entity] of Object.entries(config.entities)) {
+		if (entity.concept !== "custom" || entity.targetObjectTypeId) continue;
+		if (!entity.objectType) continue;
+		declarations.push({
+			slug,
+			...entity.objectType
+		});
+	}
+	return declarations;
+}
 /**
 * The `fields` entry a projection binding implies, qualified as `ref.column`.
 * Qualified rather than bare: two bindings can pull the same column name from
@@ -633,7 +651,7 @@ function validateEntity(v, config, key, entity, schema) {
 	}
 	if (entity.projection) {
 		if (entity.concept !== "custom") v.report(`${base}.projection`, `projection mappings are only supported for concept "${CUSTOM_CONCEPT}"`);
-		if (!entity.targetObjectTypeId) v.report(`${base}.targetObjectTypeId`, "a projection mapping must target a custom object type");
+		if (!(entity.targetObjectTypeId || entity.objectType)) v.report(`${base}.targetObjectTypeId`, "a projection mapping must target a custom object type — declare `objectType: { name: \"…\" }` (recommended: the entity key becomes its slug) or set an explicit `targetObjectTypeId`");
 		if (entity.source !== entity.projection.baseTable) v.report(`${base}.source`, `"source" ("${entity.source}") must match "projection.baseTable" ("${entity.projection.baseTable}") — the view compiler reads baseTable and the sync engine reads source, so a mismatch makes them disagree about which table this entity is`);
 		for (const error of validateProjection(entity.projection, schema, base)) v.report(error.path, error.message);
 		validateReadOnly(v, base, entity);
@@ -663,4 +681,4 @@ function validateEntitiesConfig(config, schema) {
 	};
 }
 //#endregion
-export { coversUniqueKey as _, MATERIALIZING_CONCEPTS as a, filterSchema as c, relationshipsSchema as d, validateEntitiesConfig as f, columnMetaFor as g, joinFansOut as h, ClivlyConfigError as i, projectionFields as l, fanOutJoins as m, CRM_CONCEPTS as n, defineClivlyConfig as o, validateProjection as p, CUSTOM_CONCEPT as r, entitiesConfigSchema as s, CANONICAL_FIELDS as t, relationshipSchema as u, hasRichMeta as v, primaryKeyColumns as y };
+export { columnMetaFor as _, MATERIALIZING_CONCEPTS as a, primaryKeyColumns as b, entitiesConfigSchema as c, relationshipSchema as d, relationshipsSchema as f, joinFansOut as g, fanOutJoins as h, ClivlyConfigError as i, filterSchema as l, validateProjection as m, CRM_CONCEPTS as n, customObjectDeclarations as o, validateEntitiesConfig as p, CUSTOM_CONCEPT as r, defineClivlyConfig as s, CANONICAL_FIELDS as t, projectionFields as u, coversUniqueKey as v, hasRichMeta as y };

package/dist/{entity-config-CLxI8dVb.d.cts → entity-config-buOIVtMM.d.cts}

@@ -311,6 +311,11 @@ declare const entitySchema: z.ZodObject<{
     }, z.core.$strict>]>;
   }, z.core.$strict>>>;
   targetObjectTypeId: z.ZodOptional<z.ZodString>;
+  objectType: z.ZodOptional<z.ZodObject<{
+    name: z.ZodString;
+    pluralName: z.ZodOptional<z.ZodString>;
+    iconKey: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
   projection: z.ZodOptional<z.ZodObject<{
     version: z.ZodLiteral<1>;
     kind: z.ZodLiteral<"projection">;
@@ -406,6 +411,11 @@ declare const entitiesConfigSchema: z.ZodObject<{
       }, z.core.$strict>]>;
     }, z.core.$strict>>>;
     targetObjectTypeId: z.ZodOptional<z.ZodString>;
+    objectType: z.ZodOptional<z.ZodObject<{
+      name: z.ZodString;
+      pluralName: z.ZodOptional<z.ZodString>;
+      iconKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
     projection: z.ZodOptional<z.ZodObject<{
       version: z.ZodLiteral<1>;
       kind: z.ZodLiteral<"projection">;
@@ -488,6 +498,20 @@ declare class ClivlyConfigError extends Error {
  * a `ClivlyConfigError` instead. Does NOT validate against the host schema — that
  * needs the discovered schema; see `validateEntitiesConfig`.
  */
+/** A custom object the host declares in config, for `push-schema` to ensure. */
+interface CustomObjectDeclaration {
+  iconKey?: string;
+  name: string;
+  pluralName?: string;
+  /** Unique per org and immutable — the entity key. */
+  slug: string;
+}
+/**
+ * The custom objects a config declares, keyed by entity slug. Entities that
+ * already carry an explicit `targetObjectTypeId` are omitted: their object type
+ * exists server-side and re-declaring it would be a no-op at best.
+ */
+declare function customObjectDeclarations(config: ClivlyEntitiesConfig): CustomObjectDeclaration[];
 /**
  * The `fields` entry a projection binding implies, qualified as `ref.column`.
  * Qualified rather than bare: two bindings can pull the same column name from
@@ -553,4 +577,4 @@ interface ConfigValidationResult {
  */
 declare function validateEntitiesConfig(config: ClivlyEntitiesConfig, schema: DiscoveredSchemaTable[]): ConfigValidationResult;
 //#endregion
-export { ProjectionIdentity as A, filterSchema as C, validateEntitiesConfig as D, relationshipsSchema as E, projectionSchema as F, ProjectionMapping as M, ProjectionRef as N, BASE_REF as O, identityRefs as P, entitiesConfigSchema as S, relationshipSchema as T, MaterializingConcept as _, ClivlyEntitiesConfig as a, RelationshipsMap as b, ClivlyEntityConfigInput as c, CrmConcept as d, DiscoveredColumnMeta as f, MATERIALIZING_CONCEPTS as g, FilterValue as h, ClivlyConfigError as i, ProjectionJoin as j, ProjectionFieldBinding as k, ConfigValidationError as l, FilterExpr as m, CRM_CONCEPTS as n, ClivlyEntitiesConfigInput as o, DiscoveredSchemaTable as p, CUSTOM_CONCEPT as r, ClivlyEntityConfig as s, CANONICAL_FIELDS as t, ConfigValidationResult as u, RelationshipSpec as v, projectionFields as w, defineClivlyConfig as x, RelationshipVia as y };
+export { BASE_REF as A, defineClivlyConfig as C, relationshipSchema as D, projectionFields as E, ProjectionRef as F, identityRefs as I, projectionSchema as L, ProjectionIdentity as M, ProjectionJoin as N, relationshipsSchema as O, ProjectionMapping as P, customObjectDeclarations as S, filterSchema as T, MATERIALIZING_CONCEPTS as _, ClivlyEntitiesConfig as a, RelationshipVia as b, ClivlyEntityConfigInput as c, CrmConcept as d, CustomObjectDeclaration as f, FilterValue as g, FilterExpr as h, ClivlyConfigError as i, ProjectionFieldBinding as j, validateEntitiesConfig as k, ConfigValidationError as l, DiscoveredSchemaTable as m, CRM_CONCEPTS as n, ClivlyEntitiesConfigInput as o, DiscoveredColumnMeta as p, CUSTOM_CONCEPT as r, ClivlyEntityConfig as s, CANONICAL_FIELDS as t, ConfigValidationResult as u, MaterializingConcept as v, entitiesConfigSchema as w, RelationshipsMap as x, RelationshipSpec as y };

package/dist/{entity-config-CLxI8dVb.d.mts → entity-config-buOIVtMM.d.mts}

@@ -311,6 +311,11 @@ declare const entitySchema: z.ZodObject<{
     }, z.core.$strict>]>;
   }, z.core.$strict>>>;
   targetObjectTypeId: z.ZodOptional<z.ZodString>;
+  objectType: z.ZodOptional<z.ZodObject<{
+    name: z.ZodString;
+    pluralName: z.ZodOptional<z.ZodString>;
+    iconKey: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
   projection: z.ZodOptional<z.ZodObject<{
     version: z.ZodLiteral<1>;
     kind: z.ZodLiteral<"projection">;
@@ -406,6 +411,11 @@ declare const entitiesConfigSchema: z.ZodObject<{
       }, z.core.$strict>]>;
     }, z.core.$strict>>>;
     targetObjectTypeId: z.ZodOptional<z.ZodString>;
+    objectType: z.ZodOptional<z.ZodObject<{
+      name: z.ZodString;
+      pluralName: z.ZodOptional<z.ZodString>;
+      iconKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
     projection: z.ZodOptional<z.ZodObject<{
       version: z.ZodLiteral<1>;
       kind: z.ZodLiteral<"projection">;
@@ -488,6 +498,20 @@ declare class ClivlyConfigError extends Error {
  * a `ClivlyConfigError` instead. Does NOT validate against the host schema — that
  * needs the discovered schema; see `validateEntitiesConfig`.
  */
+/** A custom object the host declares in config, for `push-schema` to ensure. */
+interface CustomObjectDeclaration {
+  iconKey?: string;
+  name: string;
+  pluralName?: string;
+  /** Unique per org and immutable — the entity key. */
+  slug: string;
+}
+/**
+ * The custom objects a config declares, keyed by entity slug. Entities that
+ * already carry an explicit `targetObjectTypeId` are omitted: their object type
+ * exists server-side and re-declaring it would be a no-op at best.
+ */
+declare function customObjectDeclarations(config: ClivlyEntitiesConfig): CustomObjectDeclaration[];
 /**
  * The `fields` entry a projection binding implies, qualified as `ref.column`.
  * Qualified rather than bare: two bindings can pull the same column name from
@@ -553,4 +577,4 @@ interface ConfigValidationResult {
  */
 declare function validateEntitiesConfig(config: ClivlyEntitiesConfig, schema: DiscoveredSchemaTable[]): ConfigValidationResult;
 //#endregion
-export { ProjectionIdentity as A, filterSchema as C, validateEntitiesConfig as D, relationshipsSchema as E, projectionSchema as F, ProjectionMapping as M, ProjectionRef as N, BASE_REF as O, identityRefs as P, entitiesConfigSchema as S, relationshipSchema as T, MaterializingConcept as _, ClivlyEntitiesConfig as a, RelationshipsMap as b, ClivlyEntityConfigInput as c, CrmConcept as d, DiscoveredColumnMeta as f, MATERIALIZING_CONCEPTS as g, FilterValue as h, ClivlyConfigError as i, ProjectionJoin as j, ProjectionFieldBinding as k, ConfigValidationError as l, FilterExpr as m, CRM_CONCEPTS as n, ClivlyEntitiesConfigInput as o, DiscoveredSchemaTable as p, CUSTOM_CONCEPT as r, ClivlyEntityConfig as s, CANONICAL_FIELDS as t, ConfigValidationResult as u, RelationshipSpec as v, projectionFields as w, defineClivlyConfig as x, RelationshipVia as y };
+export { BASE_REF as A, defineClivlyConfig as C, relationshipSchema as D, projectionFields as E, ProjectionRef as F, identityRefs as I, projectionSchema as L, ProjectionIdentity as M, ProjectionJoin as N, relationshipsSchema as O, ProjectionMapping as P, customObjectDeclarations as S, filterSchema as T, MATERIALIZING_CONCEPTS as _, ClivlyEntitiesConfig as a, RelationshipVia as b, ClivlyEntityConfigInput as c, CrmConcept as d, CustomObjectDeclaration as f, FilterValue as g, FilterExpr as h, ClivlyConfigError as i, ProjectionFieldBinding as j, validateEntitiesConfig as k, ConfigValidationError as l, DiscoveredSchemaTable as m, CRM_CONCEPTS as n, ClivlyEntitiesConfigInput as o, DiscoveredColumnMeta as p, CUSTOM_CONCEPT as r, ClivlyEntityConfig as s, CANONICAL_FIELDS as t, ConfigValidationResult as u, MaterializingConcept as v, entitiesConfigSchema as w, RelationshipsMap as x, RelationshipSpec as y };

package/dist/entity-config.cjs

@@ -1,10 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_entity_config = require("./entity-config-Dh8aEcgj.cjs");
+const require_entity_config = require("./entity-config-Bfq3OkCU.cjs");
 exports.CANONICAL_FIELDS = require_entity_config.CANONICAL_FIELDS;
 exports.CRM_CONCEPTS = require_entity_config.CRM_CONCEPTS;
 exports.CUSTOM_CONCEPT = require_entity_config.CUSTOM_CONCEPT;
 exports.ClivlyConfigError = require_entity_config.ClivlyConfigError;
 exports.MATERIALIZING_CONCEPTS = require_entity_config.MATERIALIZING_CONCEPTS;
+exports.customObjectDeclarations = require_entity_config.customObjectDeclarations;
 exports.defineClivlyConfig = require_entity_config.defineClivlyConfig;
 exports.entitiesConfigSchema = require_entity_config.entitiesConfigSchema;
 exports.filterSchema = require_entity_config.filterSchema;

package/dist/entity-config.d.cts

@@ -1,2 +1,2 @@
-import { C as filterSchema, D as validateEntitiesConfig, E as relationshipsSchema, S as entitiesConfigSchema, T as relationshipSchema, _ as MaterializingConcept, a as ClivlyEntitiesConfig, b as RelationshipsMap, c as ClivlyEntityConfigInput, d as CrmConcept, f as DiscoveredColumnMeta, g as MATERIALIZING_CONCEPTS, h as FilterValue, i as ClivlyConfigError, l as ConfigValidationError, m as FilterExpr, n as CRM_CONCEPTS, o as ClivlyEntitiesConfigInput, p as DiscoveredSchemaTable, r as CUSTOM_CONCEPT, s as ClivlyEntityConfig, t as CANONICAL_FIELDS, u as ConfigValidationResult, v as RelationshipSpec, w as projectionFields, x as defineClivlyConfig, y as RelationshipVia } from "./entity-config-CLxI8dVb.cjs";
-export { CANONICAL_FIELDS, CRM_CONCEPTS, CUSTOM_CONCEPT, ClivlyConfigError, ClivlyEntitiesConfig, ClivlyEntitiesConfigInput, ClivlyEntityConfig, ClivlyEntityConfigInput, ConfigValidationError, ConfigValidationResult, CrmConcept, DiscoveredColumnMeta, DiscoveredSchemaTable, FilterExpr, FilterValue, MATERIALIZING_CONCEPTS, MaterializingConcept, RelationshipSpec, RelationshipVia, RelationshipsMap, defineClivlyConfig, entitiesConfigSchema, filterSchema, projectionFields, relationshipSchema, relationshipsSchema, validateEntitiesConfig };
+import { C as defineClivlyConfig, D as relationshipSchema, E as projectionFields, O as relationshipsSchema, S as customObjectDeclarations, T as filterSchema, _ as MATERIALIZING_CONCEPTS, a as ClivlyEntitiesConfig, b as RelationshipVia, c as ClivlyEntityConfigInput, d as CrmConcept, f as CustomObjectDeclaration, g as FilterValue, h as FilterExpr, i as ClivlyConfigError, k as validateEntitiesConfig, l as ConfigValidationError, m as DiscoveredSchemaTable, n as CRM_CONCEPTS, o as ClivlyEntitiesConfigInput, p as DiscoveredColumnMeta, r as CUSTOM_CONCEPT, s as ClivlyEntityConfig, t as CANONICAL_FIELDS, u as ConfigValidationResult, v as MaterializingConcept, w as entitiesConfigSchema, x as RelationshipsMap, y as RelationshipSpec } from "./entity-config-buOIVtMM.cjs";
+export { CANONICAL_FIELDS, CRM_CONCEPTS, CUSTOM_CONCEPT, ClivlyConfigError, ClivlyEntitiesConfig, ClivlyEntitiesConfigInput, ClivlyEntityConfig, ClivlyEntityConfigInput, ConfigValidationError, ConfigValidationResult, CrmConcept, CustomObjectDeclaration, DiscoveredColumnMeta, DiscoveredSchemaTable, FilterExpr, FilterValue, MATERIALIZING_CONCEPTS, MaterializingConcept, RelationshipSpec, RelationshipVia, RelationshipsMap, customObjectDeclarations, defineClivlyConfig, entitiesConfigSchema, filterSchema, projectionFields, relationshipSchema, relationshipsSchema, validateEntitiesConfig };

package/dist/entity-config.d.mts

@@ -1,2 +1,2 @@
-import { C as filterSchema, D as validateEntitiesConfig, E as relationshipsSchema, S as entitiesConfigSchema, T as relationshipSchema, _ as MaterializingConcept, a as ClivlyEntitiesConfig, b as RelationshipsMap, c as ClivlyEntityConfigInput, d as CrmConcept, f as DiscoveredColumnMeta, g as MATERIALIZING_CONCEPTS, h as FilterValue, i as ClivlyConfigError, l as ConfigValidationError, m as FilterExpr, n as CRM_CONCEPTS, o as ClivlyEntitiesConfigInput, p as DiscoveredSchemaTable, r as CUSTOM_CONCEPT, s as ClivlyEntityConfig, t as CANONICAL_FIELDS, u as ConfigValidationResult, v as RelationshipSpec, w as projectionFields, x as defineClivlyConfig, y as RelationshipVia } from "./entity-config-CLxI8dVb.mjs";
-export { CANONICAL_FIELDS, CRM_CONCEPTS, CUSTOM_CONCEPT, ClivlyConfigError, ClivlyEntitiesConfig, ClivlyEntitiesConfigInput, ClivlyEntityConfig, ClivlyEntityConfigInput, ConfigValidationError, ConfigValidationResult, CrmConcept, DiscoveredColumnMeta, DiscoveredSchemaTable, FilterExpr, FilterValue, MATERIALIZING_CONCEPTS, MaterializingConcept, RelationshipSpec, RelationshipVia, RelationshipsMap, defineClivlyConfig, entitiesConfigSchema, filterSchema, projectionFields, relationshipSchema, relationshipsSchema, validateEntitiesConfig };
+import { C as defineClivlyConfig, D as relationshipSchema, E as projectionFields, O as relationshipsSchema, S as customObjectDeclarations, T as filterSchema, _ as MATERIALIZING_CONCEPTS, a as ClivlyEntitiesConfig, b as RelationshipVia, c as ClivlyEntityConfigInput, d as CrmConcept, f as CustomObjectDeclaration, g as FilterValue, h as FilterExpr, i as ClivlyConfigError, k as validateEntitiesConfig, l as ConfigValidationError, m as DiscoveredSchemaTable, n as CRM_CONCEPTS, o as ClivlyEntitiesConfigInput, p as DiscoveredColumnMeta, r as CUSTOM_CONCEPT, s as ClivlyEntityConfig, t as CANONICAL_FIELDS, u as ConfigValidationResult, v as MaterializingConcept, w as entitiesConfigSchema, x as RelationshipsMap, y as RelationshipSpec } from "./entity-config-buOIVtMM.mjs";
+export { CANONICAL_FIELDS, CRM_CONCEPTS, CUSTOM_CONCEPT, ClivlyConfigError, ClivlyEntitiesConfig, ClivlyEntitiesConfigInput, ClivlyEntityConfig, ClivlyEntityConfigInput, ConfigValidationError, ConfigValidationResult, CrmConcept, CustomObjectDeclaration, DiscoveredColumnMeta, DiscoveredSchemaTable, FilterExpr, FilterValue, MATERIALIZING_CONCEPTS, MaterializingConcept, RelationshipSpec, RelationshipVia, RelationshipsMap, customObjectDeclarations, defineClivlyConfig, entitiesConfigSchema, filterSchema, projectionFields, relationshipSchema, relationshipsSchema, validateEntitiesConfig };

package/dist/entity-config.mjs

@@ -1,2 +1,2 @@
-import { a as MATERIALIZING_CONCEPTS, c as filterSchema, d as relationshipsSchema, f as validateEntitiesConfig, i as ClivlyConfigError, l as projectionFields, n as CRM_CONCEPTS, o as defineClivlyConfig, r as CUSTOM_CONCEPT, s as entitiesConfigSchema, t as CANONICAL_FIELDS, u as relationshipSchema } from "./entity-config-8Fgr6IOH.mjs";
-export { CANONICAL_FIELDS, CRM_CONCEPTS, CUSTOM_CONCEPT, ClivlyConfigError, MATERIALIZING_CONCEPTS, defineClivlyConfig, entitiesConfigSchema, filterSchema, projectionFields, relationshipSchema, relationshipsSchema, validateEntitiesConfig };
+import { a as MATERIALIZING_CONCEPTS, c as entitiesConfigSchema, d as relationshipSchema, f as relationshipsSchema, i as ClivlyConfigError, l as filterSchema, n as CRM_CONCEPTS, o as customObjectDeclarations, p as validateEntitiesConfig, r as CUSTOM_CONCEPT, s as defineClivlyConfig, t as CANONICAL_FIELDS, u as projectionFields } from "./entity-config-DFJ8L9jm.mjs";
+export { CANONICAL_FIELDS, CRM_CONCEPTS, CUSTOM_CONCEPT, ClivlyConfigError, MATERIALIZING_CONCEPTS, customObjectDeclarations, defineClivlyConfig, entitiesConfigSchema, filterSchema, projectionFields, relationshipSchema, relationshipsSchema, validateEntitiesConfig };

package/dist/entity-heuristics.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_entity_config = require("./entity-config-Dh8aEcgj.cjs");
+const require_entity_config = require("./entity-config-Bfq3OkCU.cjs");
 const require_mapping_score = require("./mapping-score.cjs");
 //#region src/entity-heuristics.ts
 const TARGET_CONCEPTS = [

package/dist/entity-heuristics.d.cts

@@ -1,4 +1,4 @@
-import { f as DiscoveredColumnMeta } from "./entity-config-CLxI8dVb.cjs";
+import { p as DiscoveredColumnMeta } from "./entity-config-buOIVtMM.cjs";
 import { Scored } from "./mapping-score.cjs";
 //#region src/entity-heuristics.d.ts
 declare const TARGET_CONCEPTS: readonly ["contact", "company", "deal", "activity", "conversation", "note"];

package/dist/entity-heuristics.d.mts

@@ -1,4 +1,4 @@
-import { f as DiscoveredColumnMeta } from "./entity-config-CLxI8dVb.mjs";
+import { p as DiscoveredColumnMeta } from "./entity-config-buOIVtMM.mjs";
 import { Scored } from "./mapping-score.mjs";
 //#region src/entity-heuristics.d.ts
 declare const TARGET_CONCEPTS: readonly ["contact", "company", "deal", "activity", "conversation", "note"];

package/dist/entity-heuristics.mjs

@@ -1,4 +1,4 @@
-import { a as MATERIALIZING_CONCEPTS } from "./entity-config-8Fgr6IOH.mjs";
+import { a as MATERIALIZING_CONCEPTS } from "./entity-config-DFJ8L9jm.mjs";
 import { CONCEPT_TIERS, FIELD_TIERS, RELATIONSHIP_TIERS, W, isAmbiguous, isNumericLike, isTextLike, isTimestampLike, tierFor } from "./mapping-score.mjs";
 //#region src/entity-heuristics.ts
 const TARGET_CONCEPTS = [

package/dist/index.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_auth_adapter = require("./auth-adapter.cjs");
 const require_projection = require("./projection-BXBkh7qp.cjs");
-const require_entity_config = require("./entity-config-Dh8aEcgj.cjs");
+const require_entity_config = require("./entity-config-Bfq3OkCU.cjs");
 const require_mapping_form = require("./mapping-form.cjs");
 const require_mappings_config = require("./mappings-config.cjs");
 const require_view_compiler = require("./view-compiler-BpNI8Ttw.cjs");

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { Activity, ActivityType, Company, Contact, ContactFilters, ContactStatus, CreateActivityInput, CreateCompanyInput, CreateContactInput, CreateDealInput, CreateTaskInput, CrmRole, Deal, DealStage, Note, RecordSource, Task, TaskEntityType, TaskFilters, TaskPriority, TaskStatus, UpdateContactInput, UpdateDealInput, UpdateTaskInput } from "./types.cjs";
 import { CRMAdapter } from "./adapter.cjs";
 import { ClivlyAuthAdapter, ClivlyUser, CrmMembership, MembershipResolver, authCustom } from "./auth-adapter.cjs";
-import { A as ProjectionIdentity, C as filterSchema, D as validateEntitiesConfig, E as relationshipsSchema, F as projectionSchema, M as ProjectionMapping, N as ProjectionRef, O as BASE_REF, P as identityRefs, S as entitiesConfigSchema, T as relationshipSchema, _ as MaterializingConcept, a as ClivlyEntitiesConfig, b as RelationshipsMap, d as CrmConcept, f as DiscoveredColumnMeta, g as MATERIALIZING_CONCEPTS, h as FilterValue, i as ClivlyConfigError, j as ProjectionJoin, k as ProjectionFieldBinding, l as ConfigValidationError, m as FilterExpr, n as CRM_CONCEPTS, p as DiscoveredSchemaTable, s as ClivlyEntityConfig, t as CANONICAL_FIELDS, u as ConfigValidationResult, v as RelationshipSpec, x as defineClivlyConfig, y as RelationshipVia } from "./entity-config-CLxI8dVb.cjs";
+import { A as BASE_REF, C as defineClivlyConfig, D as relationshipSchema, F as ProjectionRef, I as identityRefs, L as projectionSchema, M as ProjectionIdentity, N as ProjectionJoin, O as relationshipsSchema, P as ProjectionMapping, T as filterSchema, _ as MATERIALIZING_CONCEPTS, a as ClivlyEntitiesConfig, b as RelationshipVia, d as CrmConcept, g as FilterValue, h as FilterExpr, i as ClivlyConfigError, j as ProjectionFieldBinding, k as validateEntitiesConfig, 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 entitiesConfigSchema, x as RelationshipsMap, y as RelationshipSpec } from "./entity-config-buOIVtMM.cjs";
 import { RelationshipCandidate, buildFilterFromDiscriminator, buildRelationships, relationshipViaSignature } from "./mapping-form.cjs";
 import { EntityMappingRow, mappingsToEntitiesConfig } from "./mappings-config.cjs";
 import { CompileOptions, CompiledView, DEFAULT_VIEW_PREFIX, ExplainResult, compileEntityView, compileEntityViews, explainEntitiesConfig } from "./view-compiler.cjs";

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { Activity, ActivityType, Company, Contact, ContactFilters, ContactStatus, CreateActivityInput, CreateCompanyInput, CreateContactInput, CreateDealInput, CreateTaskInput, CrmRole, Deal, DealStage, Note, RecordSource, Task, TaskEntityType, TaskFilters, TaskPriority, TaskStatus, UpdateContactInput, UpdateDealInput, UpdateTaskInput } from "./types.mjs";
 import { CRMAdapter } from "./adapter.mjs";
 import { ClivlyAuthAdapter, ClivlyUser, CrmMembership, MembershipResolver, authCustom } from "./auth-adapter.mjs";
-import { A as ProjectionIdentity, C as filterSchema, D as validateEntitiesConfig, E as relationshipsSchema, F as projectionSchema, M as ProjectionMapping, N as ProjectionRef, O as BASE_REF, P as identityRefs, S as entitiesConfigSchema, T as relationshipSchema, _ as MaterializingConcept, a as ClivlyEntitiesConfig, b as RelationshipsMap, d as CrmConcept, f as DiscoveredColumnMeta, g as MATERIALIZING_CONCEPTS, h as FilterValue, i as ClivlyConfigError, j as ProjectionJoin, k as ProjectionFieldBinding, l as ConfigValidationError, m as FilterExpr, n as CRM_CONCEPTS, p as DiscoveredSchemaTable, s as ClivlyEntityConfig, t as CANONICAL_FIELDS, u as ConfigValidationResult, v as RelationshipSpec, x as defineClivlyConfig, y as RelationshipVia } from "./entity-config-CLxI8dVb.mjs";
+import { A as BASE_REF, C as defineClivlyConfig, D as relationshipSchema, F as ProjectionRef, I as identityRefs, L as projectionSchema, M as ProjectionIdentity, N as ProjectionJoin, O as relationshipsSchema, P as ProjectionMapping, T as filterSchema, _ as MATERIALIZING_CONCEPTS, a as ClivlyEntitiesConfig, b as RelationshipVia, d as CrmConcept, g as FilterValue, h as FilterExpr, i as ClivlyConfigError, j as ProjectionFieldBinding, k as validateEntitiesConfig, 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 entitiesConfigSchema, x as RelationshipsMap, y as RelationshipSpec } from "./entity-config-buOIVtMM.mjs";
 import { RelationshipCandidate, buildFilterFromDiscriminator, buildRelationships, relationshipViaSignature } from "./mapping-form.mjs";
 import { EntityMappingRow, mappingsToEntitiesConfig } from "./mappings-config.mjs";
 import { CompileOptions, CompiledView, DEFAULT_VIEW_PREFIX, ExplainResult, compileEntityView, compileEntityViews, explainEntitiesConfig } from "./view-compiler.mjs";

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { authCustom } from "./auth-adapter.mjs";
 import { i as projectionSchema, n as PROJECTION_KEY_PATTERN, r as identityRefs, t as BASE_REF } from "./projection-C_EMRmZ8.mjs";
-import { _ as coversUniqueKey, a as MATERIALIZING_CONCEPTS, c as filterSchema, d as relationshipsSchema, f as validateEntitiesConfig, g as columnMetaFor, h as joinFansOut, i as ClivlyConfigError, m as fanOutJoins, n as CRM_CONCEPTS, o as defineClivlyConfig, p as validateProjection, s as entitiesConfigSchema, t as CANONICAL_FIELDS, u as relationshipSchema, v as hasRichMeta, y as primaryKeyColumns } from "./entity-config-8Fgr6IOH.mjs";
+import { _ as columnMetaFor, a as MATERIALIZING_CONCEPTS, b as primaryKeyColumns, c as entitiesConfigSchema, d as relationshipSchema, f as relationshipsSchema, g as joinFansOut, h as fanOutJoins, i as ClivlyConfigError, l as filterSchema, m as validateProjection, n as CRM_CONCEPTS, p as validateEntitiesConfig, s as defineClivlyConfig, t as CANONICAL_FIELDS, v as coversUniqueKey, y as hasRichMeta } from "./entity-config-DFJ8L9jm.mjs";
 import { buildFilterFromDiscriminator, buildRelationships, relationshipViaSignature } from "./mapping-form.mjs";
 import { mappingsToEntitiesConfig } from "./mappings-config.mjs";
 import { i as explainEntitiesConfig, n as compileEntityView, r as compileEntityViews, t as DEFAULT_VIEW_PREFIX } from "./view-compiler-CcqsGxv4.mjs";

package/dist/integration-state.cjs

@@ -31,8 +31,6 @@ const STEP_PREREQUISITES = {
 function stepIndex(id) {
 	return INTEGRATION_STEPS.indexOf(id);
 }
-/** A heartbeat older than this means the app stopped checking in. */
-const HEARTBEAT_STALE_MS = 600 * 1e3;
 function formatAge(ms) {
 	if (ms < 6e4) return `${Math.max(1, Math.round(ms / 1e3))}s ago`;
 	if (ms < 36e5) return `${Math.round(ms / 6e4)}m ago`;
@@ -41,12 +39,96 @@ function formatAge(ms) {
 function heartbeatAge(facts) {
 	return facts.lastHeartbeatAt === null ? null : facts.now - facts.lastHeartbeatAt;
 }
+/** The cadence `createClivlySDK` uses when the host app configures none. */
+const DEFAULT_HEARTBEAT_INTERVAL_MS = 6e4;
+const LIVE_INTERVALS = 2.5;
+const STALE_INTERVALS = 10;
+/**
+* The two boundaries that separate live from stale from offline, in terms of
+* the app's own reported cadence. A cadence we cannot believe — absent, zero,
+* negative — falls back to the SDK default rather than producing a window of
+* zero that would call every app offline.
+*/
+function livenessWindows(intervalMs) {
+	const interval = typeof intervalMs === "number" && intervalMs > 0 ? intervalMs : DEFAULT_HEARTBEAT_INTERVAL_MS;
+	return {
+		liveMs: interval * LIVE_INTERVALS,
+		staleMs: interval * STALE_INTERVALS
+	};
+}
+/**
+* Faults worth showing on an app that is up. Deliberately excludes anything the
+* developer simply has not done yet — no schema, no mapping, no trigger are all
+* setup stages, and painting a fresh install amber would make the signal
+* meaningless.
+*/
+function livenessIssues(facts) {
+	const issues = [...facts.reportedIssues ?? []];
+	if (facts.lastRun && !facts.lastRun.ok) issues.push({
+		code: "sync_failed",
+		message: facts.lastRun.message ?? "The last sync run failed.",
+		fix: "Open the run log to see how your app responded."
+	});
+	return issues;
+}
+function websocketLiveness(facts, presence, base) {
+	if (!(presence.connectionState === "connected" && presence.activeInstanceCount > 0)) {
+		const health = presence.connectionState === "reconnecting" ? "stale" : "offline";
+		return {
+			...base,
+			health,
+			issues: [],
+			reachable: false
+		};
+	}
+	const issues = livenessIssues(facts);
+	return {
+		...base,
+		health: issues.length > 0 ? "live_with_issues" : "live",
+		issues,
+		reachable: true
+	};
+}
+function deriveLiveness(facts) {
+	const ageMs = heartbeatAge(facts);
+	const environment = facts.environment ?? null;
+	const { liveMs, staleMs } = livenessWindows(facts.heartbeatIntervalMs);
+	const base = {
+		ageMs,
+		ageLabel: ageMs === null ? "No heartbeat yet" : formatAge(ageMs),
+		environment,
+		...facts.presence ? { presence: {
+			connectionState: facts.presence.connectionState,
+			transport: facts.presence.transport
+		} } : {}
+	};
+	if (facts.presence && facts.presence.transport === "websocket") return websocketLiveness(facts, facts.presence, base);
+	if (ageMs === null || ageMs >= staleMs) return {
+		...base,
+		health: "offline",
+		issues: [],
+		reachable: false
+	};
+	if (ageMs >= liveMs) return {
+		...base,
+		health: "stale",
+		issues: [],
+		reachable: false
+	};
+	const issues = livenessIssues(facts);
+	return {
+		...base,
+		health: issues.length > 0 ? "live_with_issues" : "live",
+		issues,
+		reachable: true
+	};
+}
 /** Is the raw condition behind each step met, ignoring prerequisites? */
 function isSatisfied(id, facts) {
 	const age = heartbeatAge(facts);
 	switch (id) {
 		case "credential": return facts.hasCredential;
-		case "application": return age !== null && age < HEARTBEAT_STALE_MS;
+		case "application": return facts.everConnected || age !== null;
 		case "schema": return facts.discoveredTableCount > 0;
 		case "mapping": return facts.mappedEntityCount > 0;
 		case "trigger": return facts.triggerConfigured;
@@ -69,19 +151,6 @@ function problemFor(id, facts) {
 		message: facts.lastRun.message ?? "The last sync run failed.",
 		fix: "Open the run log to see the host response."
 	};
-	if (id === "application") {
-		const age = heartbeatAge(facts);
-		if (age !== null && age >= HEARTBEAT_STALE_MS) return {
-			code: "heartbeat_stale",
-			message: `Your app stopped checking in ${formatAge(age)}.`,
-			fix: "Start your app, then run `npx clivly status`."
-		};
-		if (age === null && facts.everConnected) return {
-			code: "heartbeat_stale",
-			message: "Your application stopped checking in.",
-			fix: "Start your app, then run `npx clivly status`."
-		};
-	}
 	return null;
 }
 /**
@@ -147,14 +216,12 @@ const STEP_STATUS_WHEN_ACTIVE = {
 	widget: "healthy"
 };
 /**
-* Collapse the ladder to the single status the surfaces switch on. Live
-* conditions — a run in flight, a failure, a heartbeat gone quiet — win over
-* ladder position, because they describe the integration as it is now rather
-* than how far setup once got.
+* Collapse the ladder to the single status the surfaces switch on. This is the
+* setup dimension only: it answers how far configuration got, never whether the
+* app is up. Pair it with `deriveLiveness` for the second half of the picture.
 */
 function deriveStatus(steps, facts) {
 	if (facts.syncInFlight) return "syncing";
-	if (steps.find((step) => step.id === "application")?.problem?.code === "heartbeat_stale") return "disconnected";
 	if (steps.some((step) => step.state === "failed")) return "error";
 	const blocking = steps.find((step) => step.state === "active" || step.state === "blocked");
 	if (blocking) return STEP_STATUS_WHEN_ACTIVE[blocking.id];
@@ -209,13 +276,13 @@ const NEXT_BY_STEP = {
 * as the fix for a write problem (C-05). If you need a command for the
 * next-action slot, call this — do not write another one.
 */
-function nextAction(steps, status) {
+function nextAction(steps, status, liveness) {
 	if (status === "healthy" || status === "syncing") return null;
 	const blocking = steps.find((step) => step.state === "failed") ?? steps.find((step) => step.state === "active");
 	if (!blocking) return null;
-	if (blocking.problem?.code === "heartbeat_stale") return {
-		label: "Reconnect your app",
-		command: "npx clivly status",
+	if (steps.find((step) => step.id === "application")?.state === "done" && !liveness.reachable) return {
+		label: "Start your app",
+		command: null,
 		envFile: null
 	};
 	return NEXT_BY_STEP[blocking.id];
@@ -223,20 +290,25 @@ function nextAction(steps, status) {
 function computeIntegrationState(facts) {
 	const steps = resolveSteps(facts);
 	const status = deriveStatus(steps, facts);
+	const liveness = deriveLiveness(facts);
 	return {
 		status,
 		steps,
-		next: nextAction(steps, status)
+		liveness,
+		next: nextAction(steps, status, liveness)
 	};
 }
 //#endregion
+exports.DEFAULT_HEARTBEAT_INTERVAL_MS = DEFAULT_HEARTBEAT_INTERVAL_MS;
 exports.INSTALL_COMMAND = INSTALL_COMMAND;
 exports.INTEGRATION_STEPS = INTEGRATION_STEPS;
 exports.INTEGRATION_STEP_LABELS = INTEGRATION_STEP_LABELS;
 exports.STEP_PREREQUISITES = STEP_PREREQUISITES;
 exports.computeIntegrationState = computeIntegrationState;
+exports.deriveLiveness = deriveLiveness;
 exports.deriveStatus = deriveStatus;
 exports.formatAge = formatAge;
+exports.livenessWindows = livenessWindows;
 exports.nextAction = nextAction;
 exports.resolveSteps = resolveSteps;
 exports.stepIndex = stepIndex;