@clivly/core 0.9.1 → 0.9.3

package/dist/mapping-form.d.cts

@@ -1,4 +1,4 @@
-import { b as RelationshipsMap, m as FilterExpr, y as RelationshipVia } from "./entity-config-CLxI8dVb.cjs";
+import { b as RelationshipVia, h as FilterExpr, x as RelationshipsMap } from "./entity-config-buOIVtMM.cjs";
 //#region src/mapping-form.d.ts
 /**
  * A relationship the mapping UI can offer or has configured, in the shape the

package/dist/mapping-form.d.mts

@@ -1,4 +1,4 @@
-import { b as RelationshipsMap, m as FilterExpr, y as RelationshipVia } from "./entity-config-CLxI8dVb.mjs";
+import { b as RelationshipVia, h as FilterExpr, x as RelationshipsMap } from "./entity-config-buOIVtMM.mjs";
 //#region src/mapping-form.d.ts
 /**
  * A relationship the mapping UI can offer or has configured, in the shape the

package/dist/mappings-config.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");
 //#region src/mappings-config.ts
 const RESERVED_FIELD = "id";
 /**
@@ -122,5 +122,29 @@ function mappingsToEntitiesConfig(rows) {
 	for (const { row, key } of assigned) entities[key] = buildEntity(row, refIndex);
 	return { entities };
 }
+const CUSTOM_CONCEPT = "custom";
+function entitiesToMappings(config) {
+	const rows = [];
+	for (const [entityKey, entity] of Object.entries(config.entities)) {
+		const row = {
+			entityKey,
+			sourceTable: entity.projection?.baseTable ?? entity.source,
+			targetConcept: entity.concept,
+			role: entity.role ?? DEFAULT_ROLE,
+			fieldMap: entity.projection ? {} : entity.fields
+		};
+		if (entity.filter) row.filter = entity.filter;
+		if (entity.relationships) row.relationships = entity.relationships;
+		if (entity.projection) row.projection = entity.projection;
+		if (entity.concept === CUSTOM_CONCEPT) {
+			row.objectTypeSlug = entityKey;
+			if (entity.objectType) row.objectType = entity.objectType;
+		}
+		if (entity.targetObjectTypeId) row.targetObjectTypeId = entity.targetObjectTypeId;
+		rows.push(row);
+	}
+	return rows;
+}
 //#endregion
+exports.entitiesToMappings = entitiesToMappings;
 exports.mappingsToEntitiesConfig = mappingsToEntitiesConfig;

package/dist/mappings-config.d.cts

@@ -1,4 +1,4 @@
-import { M as ProjectionMapping, a as ClivlyEntitiesConfig } from "./entity-config-CLxI8dVb.cjs";
+import { P as ProjectionMapping, a as ClivlyEntitiesConfig, h as FilterExpr, x as RelationshipsMap } from "./entity-config-buOIVtMM.cjs";
 //#region src/mappings-config.d.ts
 /**
  * Mappings → Entity Config bridge.
@@ -43,5 +43,43 @@ interface EntityMappingRow {
  * eligible — a no-op the view compiler and sync engine both tolerate.
  */
 declare function mappingsToEntitiesConfig(rows: EntityMappingRow[]): ClivlyEntitiesConfig;
+/**
+ * Entity Config → Mappings, the inverse of `mappingsToEntitiesConfig`.
+ *
+ * `objectType` in config creates the custom object but nothing creates the
+ * MAPPING, so config-as-code ended at a created object and a sync that stored
+ * nothing. This produces the rows that close that gap.
+ *
+ * The two shapes align column for column, with one asymmetry that cannot be
+ * resolved by naming: the row model has no entity-key column — a row is keyed by
+ * `(sourceTable, targetConcept, role)` — while a CUSTOM entity's key *is* its
+ * object type slug, and is routinely different from its source table
+ * ("client-accounts" derived from "accounts"). So the key travels explicitly on
+ * every row rather than being left for the reverse derivation to guess.
+ */
+interface MappingFromConfig {
+  /**
+   * The config entity key this row came from. Not a row column — the caller
+   * needs it to resolve a custom object type and to report what it wrote.
+   */
+  entityKey: string;
+  fieldMap: Record<string, string>;
+  filter?: FilterExpr;
+  /** Declared custom object, when the config declares one rather than pinning an id. */
+  objectType?: {
+    iconKey?: string;
+    name: string;
+    pluralName?: string;
+  };
+  /** The custom object type's slug — the entity key. Custom entities only. */
+  objectTypeSlug?: string;
+  projection?: ProjectionMapping;
+  relationships?: RelationshipsMap;
+  role: string;
+  sourceTable: string;
+  targetConcept: string;
+  targetObjectTypeId?: string;
+}
+declare function entitiesToMappings(config: ClivlyEntitiesConfig): MappingFromConfig[];
 //#endregion
-export { EntityMappingRow, mappingsToEntitiesConfig };
+export { EntityMappingRow, MappingFromConfig, entitiesToMappings, mappingsToEntitiesConfig };

package/dist/mappings-config.d.mts

@@ -1,4 +1,4 @@
-import { M as ProjectionMapping, a as ClivlyEntitiesConfig } from "./entity-config-CLxI8dVb.mjs";
+import { P as ProjectionMapping, a as ClivlyEntitiesConfig, h as FilterExpr, x as RelationshipsMap } from "./entity-config-buOIVtMM.mjs";
 //#region src/mappings-config.d.ts
 /**
  * Mappings → Entity Config bridge.
@@ -43,5 +43,43 @@ interface EntityMappingRow {
  * eligible — a no-op the view compiler and sync engine both tolerate.
  */
 declare function mappingsToEntitiesConfig(rows: EntityMappingRow[]): ClivlyEntitiesConfig;
+/**
+ * Entity Config → Mappings, the inverse of `mappingsToEntitiesConfig`.
+ *
+ * `objectType` in config creates the custom object but nothing creates the
+ * MAPPING, so config-as-code ended at a created object and a sync that stored
+ * nothing. This produces the rows that close that gap.
+ *
+ * The two shapes align column for column, with one asymmetry that cannot be
+ * resolved by naming: the row model has no entity-key column — a row is keyed by
+ * `(sourceTable, targetConcept, role)` — while a CUSTOM entity's key *is* its
+ * object type slug, and is routinely different from its source table
+ * ("client-accounts" derived from "accounts"). So the key travels explicitly on
+ * every row rather than being left for the reverse derivation to guess.
+ */
+interface MappingFromConfig {
+  /**
+   * The config entity key this row came from. Not a row column — the caller
+   * needs it to resolve a custom object type and to report what it wrote.
+   */
+  entityKey: string;
+  fieldMap: Record<string, string>;
+  filter?: FilterExpr;
+  /** Declared custom object, when the config declares one rather than pinning an id. */
+  objectType?: {
+    iconKey?: string;
+    name: string;
+    pluralName?: string;
+  };
+  /** The custom object type's slug — the entity key. Custom entities only. */
+  objectTypeSlug?: string;
+  projection?: ProjectionMapping;
+  relationships?: RelationshipsMap;
+  role: string;
+  sourceTable: string;
+  targetConcept: string;
+  targetObjectTypeId?: string;
+}
+declare function entitiesToMappings(config: ClivlyEntitiesConfig): MappingFromConfig[];
 //#endregion
-export { EntityMappingRow, mappingsToEntitiesConfig };
+export { EntityMappingRow, MappingFromConfig, entitiesToMappings, mappingsToEntitiesConfig };

package/dist/mappings-config.mjs

@@ -1,4 +1,4 @@
-import { t as CANONICAL_FIELDS } from "./entity-config-8Fgr6IOH.mjs";
+import { t as CANONICAL_FIELDS } from "./entity-config-DFJ8L9jm.mjs";
 //#region src/mappings-config.ts
 const RESERVED_FIELD = "id";
 /**
@@ -121,5 +121,28 @@ function mappingsToEntitiesConfig(rows) {
 	for (const { row, key } of assigned) entities[key] = buildEntity(row, refIndex);
 	return { entities };
 }
+const CUSTOM_CONCEPT = "custom";
+function entitiesToMappings(config) {
+	const rows = [];
+	for (const [entityKey, entity] of Object.entries(config.entities)) {
+		const row = {
+			entityKey,
+			sourceTable: entity.projection?.baseTable ?? entity.source,
+			targetConcept: entity.concept,
+			role: entity.role ?? DEFAULT_ROLE,
+			fieldMap: entity.projection ? {} : entity.fields
+		};
+		if (entity.filter) row.filter = entity.filter;
+		if (entity.relationships) row.relationships = entity.relationships;
+		if (entity.projection) row.projection = entity.projection;
+		if (entity.concept === CUSTOM_CONCEPT) {
+			row.objectTypeSlug = entityKey;
+			if (entity.objectType) row.objectType = entity.objectType;
+		}
+		if (entity.targetObjectTypeId) row.targetObjectTypeId = entity.targetObjectTypeId;
+		rows.push(row);
+	}
+	return rows;
+}
 //#endregion
-export { mappingsToEntitiesConfig };
+export { entitiesToMappings, mappingsToEntitiesConfig };

package/dist/sync-engine.d.cts

@@ -1,4 +1,4 @@
-import { a as ClivlyEntitiesConfig } from "./entity-config-CLxI8dVb.cjs";
+import { a as ClivlyEntitiesConfig } from "./entity-config-buOIVtMM.cjs";
 import { CompileOptions, CompiledView } from "./view-compiler.cjs";
 //#region src/sync-engine.d.ts
 /**

package/dist/sync-engine.d.mts

@@ -1,4 +1,4 @@
-import { a as ClivlyEntitiesConfig } from "./entity-config-CLxI8dVb.mjs";
+import { a as ClivlyEntitiesConfig } from "./entity-config-buOIVtMM.mjs";
 import { CompileOptions, CompiledView } from "./view-compiler.mjs";
 //#region src/sync-engine.d.ts
 /**

package/dist/view-compiler.d.cts

@@ -1,4 +1,4 @@
-import { a as ClivlyEntitiesConfig } from "./entity-config-CLxI8dVb.cjs";
+import { a as ClivlyEntitiesConfig } from "./entity-config-buOIVtMM.cjs";
 //#region src/view-compiler.d.ts
 declare const DEFAULT_VIEW_PREFIX = "crm_src_";
 interface CompileOptions {

package/dist/view-compiler.d.mts

@@ -1,4 +1,4 @@
-import { a as ClivlyEntitiesConfig } from "./entity-config-CLxI8dVb.mjs";
+import { a as ClivlyEntitiesConfig } from "./entity-config-buOIVtMM.mjs";
 //#region src/view-compiler.d.ts
 declare const DEFAULT_VIEW_PREFIX = "crm_src_";
 interface CompileOptions {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clivly/core",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "private": false,
   "type": "module",
   "description": "ORM/auth-agnostic CRM adapter contracts and shared domain types for Clivly.",