clivly 0.8.0 → 0.9.0

package/internal-B8ydhsKd.d.cts

@@ -0,0 +1,73 @@
+import { d as DiscoveredSchemaTable, s as ConfigValidationError, u as DiscoveredColumnMeta } from "./entity-config-C4Yf_fPj.cjs";
+import { a as ProjectionIdentity, i as ProjectionFieldBinding, o as ProjectionJoin, s as ProjectionMapping } from "./mappings-config-xsLMn3I-.cjs";
+//#region ../core/src/projection-cardinality.d.ts
+declare function joinFansOut(join: ProjectionJoin, joinTable: DiscoveredSchemaTable): boolean;
+/** Every join in the projection that can multiply rows. */
+declare function fanOutJoins(projection: ProjectionMapping, tablesByName: Map<string, DiscoveredSchemaTable>): ProjectionJoin[];
+//#endregion
+//#region ../core/src/projection-draft.d.ts
+/**
+ * The builder's in-progress shape.
+ *
+ * A draft is deliberately looser than a `ProjectionMapping`: it exists while
+ * the user is still choosing things, so every field can be empty. All of the
+ * builder's rules live here as pure functions, which keeps the React components
+ * presentational and lets the rules be tested without a DOM.
+ */
+interface ProjectionDraft {
+  baseTable: string;
+  entityKey: string;
+  fieldBindings: Record<string, ProjectionFieldBinding>;
+  identity: ProjectionIdentity;
+  joins: ProjectionJoin[];
+}
+declare function emptyProjectionDraft(baseTable: string): ProjectionDraft;
+/**
+ * The ON conditions implied by a foreign key between the two tables, so the
+ * builder can pre-fill a join instead of making the user hand-pick columns.
+ * Returns [] when no FK relates them — the user then picks manually.
+ */
+declare function suggestJoinConditions(baseTable: string, joinTable: string, schema: DiscoveredSchemaTable[], joinKey: string): ProjectionJoin["on"];
+/** A draft becomes a projection once it has a valid key and ≥1 binding. */
+declare function draftToProjection(draft: ProjectionDraft): ProjectionMapping | null;
+declare function draftErrors(draft: ProjectionDraft, schema: DiscoveredSchemaTable[]): ConfigValidationError[];
+/** Per-join fan-out, for the builder's inline cardinality hints. */
+declare function describeCardinality(draft: ProjectionDraft, schema: DiscoveredSchemaTable[]): Array<{
+  fansOut: boolean;
+  joinKey: string;
+}>;
+//#endregion
+//#region ../core/src/projection-validate.d.ts
+/**
+ * Validate a projection against the discovered schema. Returns every error
+ * found (not just the first) so a builder UI can show them all at once.
+ */
+declare function validateProjection(projection: ProjectionMapping, schema: DiscoveredSchemaTable[], base: string): ConfigValidationError[];
+//#endregion
+//#region ../core/src/schema-meta.d.ts
+/**
+ * Accessors over a discovered table's schema-v2 metadata.
+ *
+ * Every helper treats *absent* metadata as **unknown**, never as a negative
+ * fact. `coversUniqueKey` returning false on a v1 payload is what makes
+ * projection validation fail closed: we cannot prove a join is many-to-one, so
+ * we refuse to compile it rather than guess.
+ */
+declare function columnMetaFor(table: DiscoveredSchemaTable, column: string): DiscoveredColumnMeta | undefined;
+/**
+ * Every primary-key column. More than one entry means a composite PK, which is
+ * why `base_pk` identity is rejected for such tables.
+ */
+declare function primaryKeyColumns(table: DiscoveredSchemaTable): string[];
+/**
+ * Do `columns` contain every column of at least one unique key on `table`?
+ *
+ * This is the fan-out test. A join whose ON columns cover a unique key of the
+ * joined table matches at most one row per base row; one that does not can
+ * match many.
+ */
+declare function coversUniqueKey(table: DiscoveredSchemaTable, columns: string[]): boolean;
+/** Is this table's payload rich enough to validate a projection against? */
+declare function hasRichMeta(table: DiscoveredSchemaTable): boolean;
+//#endregion
+export { validateProjection as a, draftErrors as c, suggestJoinConditions as d, fanOutJoins as f, primaryKeyColumns as i, draftToProjection as l, coversUniqueKey as n, ProjectionDraft as o, joinFansOut as p, hasRichMeta as r, describeCardinality as s, columnMetaFor as t, emptyProjectionDraft as u };

package/internal-BARjyN4n.cjs

@@ -0,0 +1,97 @@
+const require_projection = require("./projection-C5244vGa.cjs");
+const require_entity_config = require("./entity-config-CsLl-ftC.cjs");
+//#region ../core/src/projection-draft.ts
+function emptyProjectionDraft(baseTable) {
+	return {
+		baseTable,
+		entityKey: "",
+		fieldBindings: {},
+		identity: { kind: "base_pk" },
+		joins: []
+	};
+}
+/**
+* The ON conditions implied by a foreign key between the two tables, so the
+* builder can pre-fill a join instead of making the user hand-pick columns.
+* Returns [] when no FK relates them — the user then picks manually.
+*/
+function suggestJoinConditions(baseTable, joinTable, schema, joinKey) {
+	const join = schema.find((t) => t.name === joinTable);
+	const conditions = [];
+	for (const column of join?.columnsMeta ?? []) if (column.references?.table === baseTable) conditions.push({
+		left: {
+			table: joinKey,
+			column: column.name
+		},
+		op: "eq",
+		right: {
+			table: require_projection.BASE_REF,
+			column: column.references.column
+		}
+	});
+	return conditions;
+}
+/** A draft becomes a projection once it has a valid key and ≥1 binding. */
+function draftToProjection(draft) {
+	if (!require_projection.PROJECTION_KEY_PATTERN.test(draft.entityKey)) return null;
+	if (Object.keys(draft.fieldBindings).length === 0) return null;
+	return {
+		version: 1,
+		kind: "projection",
+		entityKey: draft.entityKey,
+		baseTable: draft.baseTable,
+		joins: draft.joins,
+		fieldBindings: draft.fieldBindings,
+		identity: draft.identity
+	};
+}
+function draftErrors(draft, schema) {
+	const projection = draftToProjection(draft);
+	if (!projection) return [{
+		path: "projection",
+		message: "Name the object and map a field."
+	}];
+	return require_entity_config.validateProjection(projection, schema, "projection");
+}
+/** Per-join fan-out, for the builder's inline cardinality hints. */
+function describeCardinality(draft, schema) {
+	const projection = draftToProjection(draft);
+	if (!projection) return [];
+	const tablesByName = new Map(schema.map((t) => [t.name, t]));
+	const fanning = new Set(require_entity_config.fanOutJoins(projection, tablesByName).map((j) => j.key));
+	return projection.joins.map((join) => ({
+		joinKey: join.key,
+		fansOut: fanning.has(join.key)
+	}));
+}
+//#endregion
+Object.defineProperty(exports, "describeCardinality", {
+	enumerable: true,
+	get: function() {
+		return describeCardinality;
+	}
+});
+Object.defineProperty(exports, "draftErrors", {
+	enumerable: true,
+	get: function() {
+		return draftErrors;
+	}
+});
+Object.defineProperty(exports, "draftToProjection", {
+	enumerable: true,
+	get: function() {
+		return draftToProjection;
+	}
+});
+Object.defineProperty(exports, "emptyProjectionDraft", {
+	enumerable: true,
+	get: function() {
+		return emptyProjectionDraft;
+	}
+});
+Object.defineProperty(exports, "suggestJoinConditions", {
+	enumerable: true,
+	get: function() {
+		return suggestJoinConditions;
+	}
+});

package/internal-DMySVbM0.mjs

@@ -0,0 +1,68 @@
+import { n as PROJECTION_KEY_PATTERN, t as BASE_REF } from "./projection-D7xmQP4S.mjs";
+import { f as validateProjection, p as fanOutJoins } from "./entity-config-D3LmzgLb.mjs";
+//#region ../core/src/projection-draft.ts
+function emptyProjectionDraft(baseTable) {
+	return {
+		baseTable,
+		entityKey: "",
+		fieldBindings: {},
+		identity: { kind: "base_pk" },
+		joins: []
+	};
+}
+/**
+* The ON conditions implied by a foreign key between the two tables, so the
+* builder can pre-fill a join instead of making the user hand-pick columns.
+* Returns [] when no FK relates them — the user then picks manually.
+*/
+function suggestJoinConditions(baseTable, joinTable, schema, joinKey) {
+	const join = schema.find((t) => t.name === joinTable);
+	const conditions = [];
+	for (const column of join?.columnsMeta ?? []) if (column.references?.table === baseTable) conditions.push({
+		left: {
+			table: joinKey,
+			column: column.name
+		},
+		op: "eq",
+		right: {
+			table: BASE_REF,
+			column: column.references.column
+		}
+	});
+	return conditions;
+}
+/** A draft becomes a projection once it has a valid key and ≥1 binding. */
+function draftToProjection(draft) {
+	if (!PROJECTION_KEY_PATTERN.test(draft.entityKey)) return null;
+	if (Object.keys(draft.fieldBindings).length === 0) return null;
+	return {
+		version: 1,
+		kind: "projection",
+		entityKey: draft.entityKey,
+		baseTable: draft.baseTable,
+		joins: draft.joins,
+		fieldBindings: draft.fieldBindings,
+		identity: draft.identity
+	};
+}
+function draftErrors(draft, schema) {
+	const projection = draftToProjection(draft);
+	if (!projection) return [{
+		path: "projection",
+		message: "Name the object and map a field."
+	}];
+	return validateProjection(projection, schema, "projection");
+}
+/** Per-join fan-out, for the builder's inline cardinality hints. */
+function describeCardinality(draft, schema) {
+	const projection = draftToProjection(draft);
+	if (!projection) return [];
+	const tablesByName = new Map(schema.map((t) => [t.name, t]));
+	const fanning = new Set(fanOutJoins(projection, tablesByName).map((j) => j.key));
+	return projection.joins.map((join) => ({
+		joinKey: join.key,
+		fansOut: fanning.has(join.key)
+	}));
+}
+//#endregion
+export { suggestJoinConditions as a, emptyProjectionDraft as i, draftErrors as n, draftToProjection as r, describeCardinality as t };

package/internal-MBkNo3bw.d.mts

@@ -0,0 +1,73 @@
+import { d as DiscoveredSchemaTable, s as ConfigValidationError, u as DiscoveredColumnMeta } from "./entity-config-C4Yf_fPj.mjs";
+import { a as ProjectionIdentity, i as ProjectionFieldBinding, o as ProjectionJoin, s as ProjectionMapping } from "./mappings-config-BpcR8bBo.mjs";
+//#region ../core/src/projection-cardinality.d.ts
+declare function joinFansOut(join: ProjectionJoin, joinTable: DiscoveredSchemaTable): boolean;
+/** Every join in the projection that can multiply rows. */
+declare function fanOutJoins(projection: ProjectionMapping, tablesByName: Map<string, DiscoveredSchemaTable>): ProjectionJoin[];
+//#endregion
+//#region ../core/src/projection-draft.d.ts
+/**
+ * The builder's in-progress shape.
+ *
+ * A draft is deliberately looser than a `ProjectionMapping`: it exists while
+ * the user is still choosing things, so every field can be empty. All of the
+ * builder's rules live here as pure functions, which keeps the React components
+ * presentational and lets the rules be tested without a DOM.
+ */
+interface ProjectionDraft {
+  baseTable: string;
+  entityKey: string;
+  fieldBindings: Record<string, ProjectionFieldBinding>;
+  identity: ProjectionIdentity;
+  joins: ProjectionJoin[];
+}
+declare function emptyProjectionDraft(baseTable: string): ProjectionDraft;
+/**
+ * The ON conditions implied by a foreign key between the two tables, so the
+ * builder can pre-fill a join instead of making the user hand-pick columns.
+ * Returns [] when no FK relates them — the user then picks manually.
+ */
+declare function suggestJoinConditions(baseTable: string, joinTable: string, schema: DiscoveredSchemaTable[], joinKey: string): ProjectionJoin["on"];
+/** A draft becomes a projection once it has a valid key and ≥1 binding. */
+declare function draftToProjection(draft: ProjectionDraft): ProjectionMapping | null;
+declare function draftErrors(draft: ProjectionDraft, schema: DiscoveredSchemaTable[]): ConfigValidationError[];
+/** Per-join fan-out, for the builder's inline cardinality hints. */
+declare function describeCardinality(draft: ProjectionDraft, schema: DiscoveredSchemaTable[]): Array<{
+  fansOut: boolean;
+  joinKey: string;
+}>;
+//#endregion
+//#region ../core/src/projection-validate.d.ts
+/**
+ * Validate a projection against the discovered schema. Returns every error
+ * found (not just the first) so a builder UI can show them all at once.
+ */
+declare function validateProjection(projection: ProjectionMapping, schema: DiscoveredSchemaTable[], base: string): ConfigValidationError[];
+//#endregion
+//#region ../core/src/schema-meta.d.ts
+/**
+ * Accessors over a discovered table's schema-v2 metadata.
+ *
+ * Every helper treats *absent* metadata as **unknown**, never as a negative
+ * fact. `coversUniqueKey` returning false on a v1 payload is what makes
+ * projection validation fail closed: we cannot prove a join is many-to-one, so
+ * we refuse to compile it rather than guess.
+ */
+declare function columnMetaFor(table: DiscoveredSchemaTable, column: string): DiscoveredColumnMeta | undefined;
+/**
+ * Every primary-key column. More than one entry means a composite PK, which is
+ * why `base_pk` identity is rejected for such tables.
+ */
+declare function primaryKeyColumns(table: DiscoveredSchemaTable): string[];
+/**
+ * Do `columns` contain every column of at least one unique key on `table`?
+ *
+ * This is the fan-out test. A join whose ON columns cover a unique key of the
+ * joined table matches at most one row per base row; one that does not can
+ * match many.
+ */
+declare function coversUniqueKey(table: DiscoveredSchemaTable, columns: string[]): boolean;
+/** Is this table's payload rich enough to validate a projection against? */
+declare function hasRichMeta(table: DiscoveredSchemaTable): boolean;
+//#endregion
+export { validateProjection as a, draftErrors as c, suggestJoinConditions as d, fanOutJoins as f, primaryKeyColumns as i, draftToProjection as l, coversUniqueKey as n, ProjectionDraft as o, joinFansOut as p, hasRichMeta as r, describeCardinality as s, columnMetaFor as t, emptyProjectionDraft as u };

package/internal-drizzle.cjs

@@ -1,3 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_drizzle = require("./drizzle-DiReZf6d.cjs");
+const require_drizzle = require("./drizzle-bfjVzYR6.cjs");
+exports.buildColumnsMeta = require_drizzle.buildColumnsMeta;
+exports.buildUniqueConstraints = require_drizzle.buildUniqueConstraints;
 exports.discoverFromDrizzle = require_drizzle.discoverFromDrizzle;

package/internal-drizzle.d.cts

@@ -1,2 +1,2 @@
-import { t as discoverFromDrizzle } from "./drizzle-DmeKSqeF.cjs";
-export { discoverFromDrizzle };
+import { n as buildUniqueConstraints, r as discoverFromDrizzle, t as buildColumnsMeta } from "./drizzle-BhN5M9zt.cjs";
+export { buildColumnsMeta, buildUniqueConstraints, discoverFromDrizzle };

package/internal-drizzle.d.mts

@@ -1,2 +1,2 @@
-import { t as discoverFromDrizzle } from "./drizzle-CFOr9dU9.mjs";
-export { discoverFromDrizzle };
+import { n as buildUniqueConstraints, r as discoverFromDrizzle, t as buildColumnsMeta } from "./drizzle-kBULBAOa.mjs";
+export { buildColumnsMeta, buildUniqueConstraints, discoverFromDrizzle };

package/internal-drizzle.mjs

@@ -1,2 +1,2 @@
-import { t as discoverFromDrizzle } from "./drizzle-B89tLo4T.mjs";
-export { discoverFromDrizzle };
+import { n as buildUniqueConstraints, r as discoverFromDrizzle, t as buildColumnsMeta } from "./drizzle-3kvhkwO7.mjs";
+export { buildColumnsMeta, buildUniqueConstraints, discoverFromDrizzle };

package/internal-entity-config.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_entity_config = require("./entity-config-D87rV-tE.cjs");
+const require_entity_config = require("./entity-config-CsLl-ftC.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;

package/internal-entity-config.d.cts

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

package/internal-entity-config.d.mts

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

package/internal-entity-config.mjs

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

package/internal-entity-heuristics.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_entity_config = require("./entity-config-D87rV-tE.cjs");
+const require_entity_config = require("./entity-config-CsLl-ftC.cjs");
 const require_mapping_score = require("./mapping-score-CaB3F4Uu.cjs");
 //#region ../core/src/entity-heuristics.ts
 const TARGET_CONCEPTS = [
@@ -101,7 +101,10 @@ const CONCEPT_FIELDS = {
 			"name",
 			"full_name",
 			"fullname",
-			"display_name"
+			"display_name",
+			"first_name",
+			"firstname",
+			"given_name"
 		],
 		required: false
 	}, {
@@ -224,12 +227,28 @@ function suggestCursorField(columnKeys) {
 	return null;
 }
 const MATERIALIZING = new Set(require_entity_config.MATERIALIZING_CONCEPTS);
+const ENDS_IN_CONSONANT_Y = /[^aeiou]y$/;
+const NEEDS_ES = /(s|x|z|ch|sh)$/;
+const IRREGULAR_PLURALS = {
+	person: "people",
+	child: "children",
+	man: "men",
+	woman: "women"
+};
+function pluralize(name) {
+	const irregular = IRREGULAR_PLURALS[name];
+	if (irregular) return irregular;
+	if (ENDS_IN_CONSONANT_Y.test(name)) return `${name.slice(0, -1)}ies`;
+	if (NEEDS_ES.test(name)) return `${name}es`;
+	return `${name}s`;
+}
 function matchesConcept(tableName, concept) {
 	const normalized = tableName.toLowerCase();
 	const entry = TABLE_PATTERNS.find((p) => p.concept === concept);
 	if (!entry) return null;
-	if (entry.names.includes(normalized)) return { exact: true };
-	if (entry.names.some((name) => normalized.includes(name))) return { exact: false };
+	const candidates = [normalized, pluralize(normalized)];
+	if (candidates.some((candidate) => entry.names.includes(candidate))) return { exact: true };
+	if (entry.names.some((name) => candidates.some((candidate) => candidate.includes(name)))) return { exact: false };
 	return null;
 }
 function metaFor(table, column) {
@@ -245,17 +264,18 @@ function scoreConcepts(table) {
 	for (const concept of TARGET_CONCEPTS) {
 		if (!MATERIALIZING.has(concept)) continue;
 		const nameMatch = matchesConcept(table.name, concept);
-		if (!nameMatch) continue;
+		const definingColumns = hasDefiningColumn(concept, table.columns);
+		if (!(nameMatch || definingColumns)) continue;
 		let score = 0;
 		const reasons = [];
-		if (nameMatch.exact) {
+		if (nameMatch?.exact) {
 			score += require_mapping_score.W.nameExact;
 			reasons.push(`name matches "${table.name}"`);
-		} else {
+		} else if (nameMatch) {
 			score += require_mapping_score.W.nameSubstring;
 			reasons.push(`name looks like ${concept}`);
 		}
-		if (hasDefiningColumn(concept, table.columns)) {
+		if (definingColumns) {
 			score += require_mapping_score.W.definingColumn;
 			reasons.push(`has the columns a ${concept} needs`);
 		}

package/internal-entity-heuristics.d.cts

@@ -1,3 +1,4 @@
+import { u as DiscoveredColumnMeta } from "./entity-config-C4Yf_fPj.cjs";
 import { a as Scored } from "./mapping-score-D7Gzg7Ii.cjs";
 //#region ../core/src/entity-heuristics.d.ts
 declare const TARGET_CONCEPTS: readonly ["contact", "company", "deal", "activity", "conversation", "note"];
@@ -6,17 +7,6 @@ declare function suggestCursorField(columnKeys: string[]): string | null;
 declare function matchesConcept(tableName: string, concept: TargetConcept): {
   exact: boolean;
 } | null;
-interface DiscoveredColumnMeta {
-  isForeignKey?: boolean;
-  isPrimaryKey?: boolean;
-  name: string;
-  nullable?: boolean;
-  references?: {
-    table: string;
-    column: string;
-  };
-  type?: string;
-}
 interface ScoredTable {
   columns: string[];
   columnsMeta?: DiscoveredColumnMeta[];
@@ -64,4 +54,4 @@ interface FieldSuggestion {
 declare function scoreFieldMap(concept: TargetConcept, table: ScoredTable): Scored<FieldSuggestion>[];
 declare function toFieldMap(scored: Scored<FieldSuggestion>[]): Record<string, string>;
 //#endregion
-export { DiscoveredColumnMeta, FieldSuggestion, RelationshipSuggestion, ScoredTable, SuggestedVia, TARGET_CONCEPTS, TargetConcept, matchesConcept, requiredFieldsFor, scoreConcepts, scoreFieldMap, scoreRelationships, suggestCursorField, suggestDiscriminatorColumns, toFieldMap, topConcept, validateMapping };
+export { type DiscoveredColumnMeta, FieldSuggestion, RelationshipSuggestion, ScoredTable, SuggestedVia, TARGET_CONCEPTS, TargetConcept, matchesConcept, requiredFieldsFor, scoreConcepts, scoreFieldMap, scoreRelationships, suggestCursorField, suggestDiscriminatorColumns, toFieldMap, topConcept, validateMapping };

package/internal-entity-heuristics.d.mts

@@ -1,3 +1,4 @@
+import { u as DiscoveredColumnMeta } from "./entity-config-C4Yf_fPj.mjs";
 import { a as Scored } from "./mapping-score-D7Gzg7Ii.mjs";
 //#region ../core/src/entity-heuristics.d.ts
 declare const TARGET_CONCEPTS: readonly ["contact", "company", "deal", "activity", "conversation", "note"];
@@ -6,17 +7,6 @@ declare function suggestCursorField(columnKeys: string[]): string | null;
 declare function matchesConcept(tableName: string, concept: TargetConcept): {
   exact: boolean;
 } | null;
-interface DiscoveredColumnMeta {
-  isForeignKey?: boolean;
-  isPrimaryKey?: boolean;
-  name: string;
-  nullable?: boolean;
-  references?: {
-    table: string;
-    column: string;
-  };
-  type?: string;
-}
 interface ScoredTable {
   columns: string[];
   columnsMeta?: DiscoveredColumnMeta[];
@@ -64,4 +54,4 @@ interface FieldSuggestion {
 declare function scoreFieldMap(concept: TargetConcept, table: ScoredTable): Scored<FieldSuggestion>[];
 declare function toFieldMap(scored: Scored<FieldSuggestion>[]): Record<string, string>;
 //#endregion
-export { DiscoveredColumnMeta, FieldSuggestion, RelationshipSuggestion, ScoredTable, SuggestedVia, TARGET_CONCEPTS, TargetConcept, matchesConcept, requiredFieldsFor, scoreConcepts, scoreFieldMap, scoreRelationships, suggestCursorField, suggestDiscriminatorColumns, toFieldMap, topConcept, validateMapping };
+export { type DiscoveredColumnMeta, FieldSuggestion, RelationshipSuggestion, ScoredTable, SuggestedVia, TARGET_CONCEPTS, TargetConcept, matchesConcept, requiredFieldsFor, scoreConcepts, scoreFieldMap, scoreRelationships, suggestCursorField, suggestDiscriminatorColumns, toFieldMap, topConcept, validateMapping };

package/internal-entity-heuristics.mjs

@@ -1,4 +1,4 @@
-import { a as MATERIALIZING_CONCEPTS } from "./entity-config-va2bkH5o.mjs";
+import { a as MATERIALIZING_CONCEPTS } from "./entity-config-D3LmzgLb.mjs";
 import { a as W, c as isTextLike, i as RELATIONSHIP_TIERS, l as isTimestampLike, n as CONCEPT_TIERS, o as isAmbiguous, r as FIELD_TIERS, s as isNumericLike, u as tierFor } from "./mapping-score-C68uAqGB.mjs";
 //#region ../core/src/entity-heuristics.ts
 const TARGET_CONCEPTS = [
@@ -100,7 +100,10 @@ const CONCEPT_FIELDS = {
 			"name",
 			"full_name",
 			"fullname",
-			"display_name"
+			"display_name",
+			"first_name",
+			"firstname",
+			"given_name"
 		],
 		required: false
 	}, {
@@ -223,12 +226,28 @@ function suggestCursorField(columnKeys) {
 	return null;
 }
 const MATERIALIZING = new Set(MATERIALIZING_CONCEPTS);
+const ENDS_IN_CONSONANT_Y = /[^aeiou]y$/;
+const NEEDS_ES = /(s|x|z|ch|sh)$/;
+const IRREGULAR_PLURALS = {
+	person: "people",
+	child: "children",
+	man: "men",
+	woman: "women"
+};
+function pluralize(name) {
+	const irregular = IRREGULAR_PLURALS[name];
+	if (irregular) return irregular;
+	if (ENDS_IN_CONSONANT_Y.test(name)) return `${name.slice(0, -1)}ies`;
+	if (NEEDS_ES.test(name)) return `${name}es`;
+	return `${name}s`;
+}
 function matchesConcept(tableName, concept) {
 	const normalized = tableName.toLowerCase();
 	const entry = TABLE_PATTERNS.find((p) => p.concept === concept);
 	if (!entry) return null;
-	if (entry.names.includes(normalized)) return { exact: true };
-	if (entry.names.some((name) => normalized.includes(name))) return { exact: false };
+	const candidates = [normalized, pluralize(normalized)];
+	if (candidates.some((candidate) => entry.names.includes(candidate))) return { exact: true };
+	if (entry.names.some((name) => candidates.some((candidate) => candidate.includes(name)))) return { exact: false };
 	return null;
 }
 function metaFor(table, column) {
@@ -244,17 +263,18 @@ function scoreConcepts(table) {
 	for (const concept of TARGET_CONCEPTS) {
 		if (!MATERIALIZING.has(concept)) continue;
 		const nameMatch = matchesConcept(table.name, concept);
-		if (!nameMatch) continue;
+		const definingColumns = hasDefiningColumn(concept, table.columns);
+		if (!(nameMatch || definingColumns)) continue;
 		let score = 0;
 		const reasons = [];
-		if (nameMatch.exact) {
+		if (nameMatch?.exact) {
 			score += W.nameExact;
 			reasons.push(`name matches "${table.name}"`);
-		} else {
+		} else if (nameMatch) {
 			score += W.nameSubstring;
 			reasons.push(`name looks like ${concept}`);
 		}
-		if (hasDefiningColumn(concept, table.columns)) {
+		if (definingColumns) {
 			score += W.definingColumn;
 			reasons.push(`has the columns a ${concept} needs`);
 		}

package/internal-mapping-form.d.cts

@@ -1,2 +1,2 @@
-import { i as relationshipViaSignature, n as buildFilterFromDiscriminator, r as buildRelationships, t as RelationshipCandidate } from "./mapping-form-lfyEE7EJ.cjs";
+import { i as relationshipViaSignature, n as buildFilterFromDiscriminator, r as buildRelationships, t as RelationshipCandidate } from "./mapping-form-43bwOTat.cjs";
 export { RelationshipCandidate, buildFilterFromDiscriminator, buildRelationships, relationshipViaSignature };

package/internal-mapping-form.d.mts

@@ -1,2 +1,2 @@
-import { i as relationshipViaSignature, n as buildFilterFromDiscriminator, r as buildRelationships, t as RelationshipCandidate } from "./mapping-form-D93lhHEc.mjs";
+import { i as relationshipViaSignature, n as buildFilterFromDiscriminator, r as buildRelationships, t as RelationshipCandidate } from "./mapping-form-DUvWUYCo.mjs";
 export { RelationshipCandidate, buildFilterFromDiscriminator, buildRelationships, relationshipViaSignature };

package/internal-mappings-config.cjs

@@ -1,3 +1,3 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_mappings_config = require("./mappings-config-BsRADNRv.cjs");
+const require_mappings_config = require("./mappings-config-BSSwdHiq.cjs");
 exports.mappingsToEntitiesConfig = require_mappings_config.mappingsToEntitiesConfig;

package/internal-mappings-config.d.cts

@@ -1,2 +1,2 @@
-import { n as mappingsToEntitiesConfig, t as EntityMappingRow } from "./mappings-config-XmzB4dag.cjs";
+import { n as mappingsToEntitiesConfig, t as EntityMappingRow } from "./mappings-config-xsLMn3I-.cjs";
 export { EntityMappingRow, mappingsToEntitiesConfig };

package/internal-mappings-config.d.mts

@@ -1,2 +1,2 @@
-import { n as mappingsToEntitiesConfig, t as EntityMappingRow } from "./mappings-config-DsUa7-1w.mjs";
+import { n as mappingsToEntitiesConfig, t as EntityMappingRow } from "./mappings-config-BpcR8bBo.mjs";
 export { EntityMappingRow, mappingsToEntitiesConfig };

package/internal-mappings-config.mjs

@@ -1,2 +1,2 @@
-import { t as mappingsToEntitiesConfig } from "./mappings-config-Dbgxx3Nv.mjs";
+import { t as mappingsToEntitiesConfig } from "./mappings-config-bJQT_gSa.mjs";
 export { mappingsToEntitiesConfig };

package/internal-sync-engine.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sync_engine = require("./sync-engine-CzEbpQGv.cjs");
+const require_sync_engine = require("./sync-engine-DEJvKw6E.cjs");
 exports.computeSampleWarnings = require_sync_engine.computeSampleWarnings;
 exports.previewSync = require_sync_engine.previewSync;
 exports.reconcile = require_sync_engine.reconcile;

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-B7QIbXro.cjs";
+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-GNqRB8eS.cjs";
 export { EntitySyncResult, MirrorRecord, PersistAction, PreviewResult, PreviewWarning, SourceRow, SyncAction, SyncResult, SyncStore, computeSampleWarnings, previewSync, reconcile, 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-DGk_AeHJ.mjs";
+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-ZsusW-q_.mjs";
 export { EntitySyncResult, MirrorRecord, PersistAction, PreviewResult, PreviewWarning, SourceRow, SyncAction, SyncResult, SyncStore, computeSampleWarnings, previewSync, reconcile, 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-Do5ru3WF.mjs";
+import { i as runSync, n as previewSync, r as reconcile, t as computeSampleWarnings } from "./sync-engine-Bg6-SznL.mjs";
 export { computeSampleWarnings, previewSync, reconcile, runSync };

package/internal-view-compiler.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_view_compiler = require("./view-compiler-BIwvm-o2.cjs");
+const require_view_compiler = require("./view-compiler-DplczSjF.cjs");
 exports.DEFAULT_VIEW_PREFIX = require_view_compiler.DEFAULT_VIEW_PREFIX;
 exports.compileEntityView = require_view_compiler.compileEntityView;
 exports.compileEntityViews = require_view_compiler.compileEntityViews;