@memberjunction/metadata-sync 6.2.0-edge.4 → 6.2.0-edge.6

package/dist/lib/lookup-sql.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @fileoverview Writes `@lookup` values into the push SQL log as subqueries on the natural key
+ * (#5626, #3619).
+ *
+ * A lookup resolves at push time to this database's ID. When the push is captured as a migration,
+ * that literal ID matches nothing on a database whose row has another ID (one CodeGen created, or
+ * one created before a baseline shipped), so an update is a silent no-op and an insert fails on a
+ * foreign key. For a primary-key or foreign-key field whose value came from a `@lookup`, the logged
+ * `SET @<Field>_<hash> = '<id>'` line is replaced with `SET @<Field>_<hash> = (SELECT …)` on the
+ * lookup's criteria. Nested lookups nest. The subquery names the real schema; the logger's schema
+ * placeholder rewrite runs after `TransformStatement` and turns it into a placeholder.
+ *
+ * Only SQL Server save statements have SET lines, so a PostgreSQL log keeps literal IDs.
+ * @module lookup-sql
+ */
+import type { BaseEntity, EntityInfo } from '@memberjunction/core';
+import type { SyncEngine } from './sync-engine.js';
+/** One `Field=Value` pair of a `@lookup`. A nested `@lookup` value keeps its own source. */
+export interface LookupSqlCriterion {
+    FieldName: string;
+    /** The resolved value as text, or the source of a nested `@lookup`. */
+    Value: string | LookupSqlSource;
+}
+/** What a `@lookup` matched on, kept so the SQL log can match on it too. */
+export interface LookupSqlSource {
+    /** The `@lookup:` text as written. */
+    Expression: string;
+    EntityName: string;
+    Criteria: LookupSqlCriterion[];
+    /** True when a criterion value (or a nested lookup's) came from `@env:`. */
+    EnvSourced: boolean;
+}
+/** A built subquery (`Sql`), or why none could be built (`Problem`). Exactly one is set. */
+export interface LookupSubquery {
+    Sql?: string;
+    Problem?: string;
+}
+/** Looks up entity metadata by name. */
+export type EntityInfoLookup = (entityName: string) => EntityInfo | null | undefined;
+/**
+ * Builds `(SELECT [PK] FROM [schema].[BaseTable] WHERE …)` for a lookup source. Each criterion is
+ * matched with `=` on the entity's own table (SQL Server's default collation is case-insensitive,
+ * as the push lookup is). `null` matches `IS NULL`. A criterion must be a column of the entity's
+ * own table: a virtual field or one an IS-A parent holds has no column there.
+ */
+export declare class LookupSubqueryBuilder {
+    private readonly entityInfo;
+    constructor(entityInfo: EntityInfoLookup);
+    Build(source: LookupSqlSource): LookupSubquery;
+    private condition;
+}
+/**
+ * Replaces the logged SET lines of lookup-sourced fields with subqueries, for one push. Registrations
+ * are keyed by the save-call hash of the record (`GenericDatabaseProvider.SaveCallVariableHash`), so
+ * only the SET line of that record's save is rewritten. A registration stays for the whole push.
+ */
+export declare class LookupSqlRewriter {
+    private readonly builder;
+    private readonly linesByHash;
+    private readonly warnings;
+    constructor(builder: LookupSubqueryBuilder);
+    /**
+     * Registers one field of one save call. `value` is the resolved ID the statement holds. Returns
+     * false (and keeps a warning) when no subquery can be built, so the log keeps the literal ID.
+     */
+    Register(entityName: string, fieldName: string, codeName: string, value: unknown, lookup: LookupSqlSource, saveCallHash: string): boolean;
+    /**
+     * Registers each lookup-sourced field of the save statement of `entity`. A primary key is
+     * registered at every IS-A level, because each level's save sets it; another field at the level
+     * whose table holds it. Call it right before the save, so the hash uses the key values the
+     * provider hashes. `lookups` keys are matched without regard to case.
+     */
+    RegisterEntityLookups(entity: BaseEntity, lookups: ReadonlyMap<string, LookupSqlSource> | undefined): void;
+    /**
+     * Registers the primary key of a record that a `@lookup:…?create` made, keyed by the lookup that
+     * made it, and keeps a warning: where no row matches, the replay passes a NULL ID, so the
+     * `IF NOT EXISTS` guard inserts the row with an ID that database generates.
+     */
+    RegisterLookupCreate(created: BaseEntity, lookup: LookupSqlSource): void;
+    /**
+     * The `SqlLoggingOptions.TransformStatement` function. It can run many times on the same text and
+     * on text that is never written. On an unexpected error it returns the text unchanged, so the log
+     * keeps the literal IDs, and keeps a warning.
+     */
+    readonly Transform: (sql: string) => string;
+    /** The warnings of this run, each once. */
+    Warnings(): string[];
+    private registerLevelField;
+    private replaceSetLines;
+}
+/** The sync engine members a `LookupSqlLog` uses. */
+type LookupSqlLogEngine = Pick<SyncEngine, 'BeforeLookupCreateSaveSource' | 'GetEntityInfo'>;
+/**
+ * The lookup rewriter of one open SQL log, with the `SyncEngine.BeforeLookupCreateSaveSource` hook
+ * that registers each record a `?create` lookup makes.
+ */
+export declare class LookupSqlLog {
+    readonly Rewriter: LookupSqlRewriter;
+    private readonly engine;
+    private readonly hook;
+    constructor(engine: LookupSqlLogEngine);
+    /** Clears the engine's hook when it is still this log's hook. */
+    Close(): void;
+}
+/** One `TransformStatement` that runs each transform in turn. */
+export declare function ComposeStatementTransforms(...transforms: Array<(sql: string) => string>): (sql: string) => string;
+export {};
+//# sourceMappingURL=lookup-sql.d.ts.map

package/dist/lib/lookup-sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup-sql.d.ts","sourceRoot":"","sources":["../../src/lib/lookup-sql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,UAAU,EAAmB,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAIpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,4FAA4F;AAC5F,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC;CACjC;AAED,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,4EAA4E;IAC5E,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,4FAA4F;AAC5F,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wCAAwC;AACxC,MAAM,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC;AAErF;;;;;GAKG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;gBAElC,UAAU,EAAE,gBAAgB;IAIxC,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc;IA0B9C,OAAO,CAAC,SAAS;CAsBlB;AA8BD;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiD;IAC7E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;gBAElC,OAAO,EAAE,qBAAqB;IAI1C;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;IAwBzI;;;;;OAKG;IACH,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS,GAAG,IAAI;IAiB1G;;;;OAIG;IACH,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAwBxE;;;;OAIG;IACH,QAAQ,CAAC,SAAS,GAAI,KAAK,MAAM,KAAG,MAAM,CAOxC;IAEF,2CAA2C;IAC3C,QAAQ,IAAI,MAAM,EAAE;IAIpB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,eAAe;CAYxB;AAED,qDAAqD;AACrD,KAAK,kBAAkB,GAAG,IAAI,CAAC,UAAU,EAAE,8BAA8B,GAAG,eAAe,CAAC,CAAC;AAE7F;;;GAGG;AACH,qBAAa,YAAY;IACvB,SAAgB,QAAQ,EAAE,iBAAiB,CAAC;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0D;gBAEnE,MAAM,EAAE,kBAAkB;IAOtC,iEAAiE;IACjE,KAAK,IAAI,IAAI;CAKd;AAED,iEAAiE;AACjE,wBAAgB,0BAA0B,CAAC,GAAG,UAAU,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAEjH"}

package/dist/lib/lookup-sql.js

@@ -0,0 +1,231 @@
+import { GenericDatabaseProvider } from '@memberjunction/generic-database-provider';
+import { IsDateSQLType, IsUuidSQLType } from '@memberjunction/sql-dialect';
+import { IsALevels, OwningLevel, SaveCallHashesIn, SetLinePattern, SqlLiteralsOf } from './sql-set-line.js';
+/**
+ * Builds `(SELECT [PK] FROM [schema].[BaseTable] WHERE …)` for a lookup source. Each criterion is
+ * matched with `=` on the entity's own table (SQL Server's default collation is case-insensitive,
+ * as the push lookup is). `null` matches `IS NULL`. A criterion must be a column of the entity's
+ * own table: a virtual field or one an IS-A parent holds has no column there.
+ */
+export class LookupSubqueryBuilder {
+    constructor(entityInfo) {
+        this.entityInfo = entityInfo;
+    }
+    Build(source) {
+        if (source.EnvSourced) {
+            return { Problem: 'its @lookup criteria use an @env value, which the log never holds' };
+        }
+        const info = this.entityInfo(source.EntityName);
+        if (!info) {
+            return { Problem: `entity '${source.EntityName}' was not found` };
+        }
+        if (info.PrimaryKeys.length !== 1) {
+            return { Problem: `'${source.EntityName}' does not have a single-column primary key` };
+        }
+        if (source.Criteria.length === 0) {
+            return { Problem: 'the @lookup has no criteria' };
+        }
+        const conditions = [];
+        for (const criterion of source.Criteria) {
+            const condition = this.condition(info, criterion);
+            if (condition.Problem !== undefined) {
+                return condition;
+            }
+            conditions.push(condition.Sql);
+        }
+        const key = info.FirstPrimaryKey.Name; // first-pk-ok: a single-column key was checked above; a lookup yields one value
+        return { Sql: `(SELECT [${key}] FROM [${info.SchemaName}].[${info.BaseTable}] WHERE ${conditions.join(' AND ')})` };
+    }
+    condition(info, criterion) {
+        const wanted = criterion.FieldName.trim().toLowerCase();
+        const field = info.Fields.find((candidate) => candidate.Name.toLowerCase() === wanted);
+        if (!field) {
+            return { Problem: `'${info.Name}' has no field '${criterion.FieldName}'` };
+        }
+        if (field.IsVirtual || info.ParentEntityFieldNames?.has(field.Name)) {
+            return { Problem: `${info.Name}.${field.Name} is not a column of table ${info.BaseTable}` };
+        }
+        if (typeof criterion.Value !== 'string') {
+            const nested = this.Build(criterion.Value);
+            return nested.Problem !== undefined ? nested : { Sql: `[${field.Name}] = ${nested.Sql}` };
+        }
+        if (criterion.Value.trim().toLowerCase() === 'null') {
+            return { Sql: `[${field.Name}] IS NULL` };
+        }
+        const literal = criterionLiteral(field, criterion.Value);
+        if (literal === null) {
+            return { Problem: `the value of ${info.Name}.${field.Name} cannot be written as a ${field.Type} literal` };
+        }
+        return { Sql: `[${field.Name}] = ${literal}` };
+    }
+}
+/** The SQL Server literal for a criterion value, or null when the value does not fit the field type. */
+function criterionLiteral(field, value) {
+    const escaped = value.replace(/'/g, "''");
+    if (!field.NeedsQuotes) {
+        const type = field.Type.trim().toLowerCase();
+        const lower = value.trim().toLowerCase();
+        if (type === 'bit' || type === 'boolean') {
+            if (lower === 'true' || lower === '1') {
+                return '1';
+            }
+            if (lower === 'false' || lower === '0') {
+                return '0';
+            }
+            return null;
+        }
+        return /^-?\d+(\.\d+)?$/.test(value.trim()) ? value.trim() : null;
+    }
+    if (IsUuidSQLType(field.Type) || IsDateSQLType(field.Type)) {
+        return `'${escaped}'`;
+    }
+    return `N'${escaped}'`;
+}
+/**
+ * Replaces the logged SET lines of lookup-sourced fields with subqueries, for one push. Registrations
+ * are keyed by the save-call hash of the record (`GenericDatabaseProvider.SaveCallVariableHash`), so
+ * only the SET line of that record's save is rewritten. A registration stays for the whole push.
+ */
+export class LookupSqlRewriter {
+    constructor(builder) {
+        this.linesByHash = new Map();
+        this.warnings = new Set();
+        /**
+         * The `SqlLoggingOptions.TransformStatement` function. It can run many times on the same text and
+         * on text that is never written. On an unexpected error it returns the text unchanged, so the log
+         * keeps the literal IDs, and keeps a warning.
+         */
+        this.Transform = (sql) => {
+            try {
+                return this.replaceSetLines(sql);
+            }
+            catch {
+                this.warnings.add('SQL log: a statement kept its literal lookup IDs because the rewrite to subqueries failed.');
+                return sql;
+            }
+        };
+        this.builder = builder;
+    }
+    /**
+     * Registers one field of one save call. `value` is the resolved ID the statement holds. Returns
+     * false (and keeps a warning) when no subquery can be built, so the log keeps the literal ID.
+     */
+    Register(entityName, fieldName, codeName, value, lookup, saveCallHash) {
+        const literals = SqlLiteralsOf(value);
+        if (literals.length === 0) {
+            return false;
+        }
+        const subquery = this.builder.Build(lookup);
+        if (subquery.Problem !== undefined || subquery.Sql === undefined) {
+            this.warnings.add(`SQL log: ${entityName}.${fieldName} is written with this database's ID because ${subquery.Problem} (${lookup.Expression}). A database where that row has another ID will not match it.`);
+            return false;
+        }
+        const hash = saveCallHash.toLowerCase();
+        let lines = this.linesByHash.get(hash);
+        if (!lines) {
+            lines = new Map();
+            this.linesByHash.set(hash, lines);
+        }
+        const key = [codeName, ...literals].join('\u0000');
+        // Case-insensitive: SQL Server returns upper-case UUIDs where a lookup can return either case
+        lines.set(key, { Pattern: SetLinePattern(codeName, hash, literals, 'gmi'), Subquery: subquery.Sql });
+        return true;
+    }
+    /**
+     * Registers each lookup-sourced field of the save statement of `entity`. A primary key is
+     * registered at every IS-A level, because each level's save sets it; another field at the level
+     * whose table holds it. Call it right before the save, so the hash uses the key values the
+     * provider hashes. `lookups` keys are matched without regard to case.
+     */
+    RegisterEntityLookups(entity, lookups) {
+        if (!lookups || lookups.size === 0) {
+            return;
+        }
+        const keyNames = new Set(entity.EntityInfo.PrimaryKeys.map((pk) => pk.Name));
+        for (const [key, lookup] of lookups) {
+            const fieldName = entity.GetFieldByName(key)?.Name;
+            if (!fieldName) {
+                continue;
+            }
+            const levels = keyNames.has(fieldName) ? IsALevels(entity) : [OwningLevel(entity, fieldName)];
+            for (const level of levels) {
+                this.registerLevelField(level, fieldName, lookup);
+            }
+        }
+    }
+    /**
+     * Registers the primary key of a record that a `@lookup:…?create` made, keyed by the lookup that
+     * made it, and keeps a warning: where no row matches, the replay passes a NULL ID, so the
+     * `IF NOT EXISTS` guard inserts the row with an ID that database generates.
+     */
+    RegisterLookupCreate(created, lookup) {
+        if (created.EntityInfo.PrimaryKeys.length !== 1) {
+            return;
+        }
+        // Criteria that were lookups themselves are foreign keys the create sets: they nest too
+        const nested = new Map();
+        for (const criterion of lookup.Criteria) {
+            if (typeof criterion.Value !== 'string') {
+                nested.set(criterion.FieldName, criterion.Value);
+            }
+        }
+        this.RegisterEntityLookups(created, nested);
+        const keyName = created.EntityInfo.FirstPrimaryKey.Name; // first-pk-ok: a single-column key was checked above
+        let registered = false;
+        for (const level of IsALevels(created)) {
+            registered = this.registerLevelField(level, keyName, lookup) || registered;
+        }
+        if (registered) {
+            this.warnings.add(`SQL log: the ${created.EntityInfo.Name} row that ${lookup.Expression} created is logged keyed by that lookup. On a database with no matching row the replay passes a NULL ID, so the IF NOT EXISTS guard inserts the row with an ID that database generates.`);
+        }
+    }
+    /** The warnings of this run, each once. */
+    Warnings() {
+        return [...this.warnings];
+    }
+    registerLevelField(level, fieldName, lookup) {
+        const field = level.GetFieldByName(fieldName);
+        if (!field) {
+            return false;
+        }
+        const levelInfo = level.EntityInfo;
+        const keyValues = level.PrimaryKey?.KeyValuePairs?.map((pair) => pair.Value) ?? [];
+        const saveCallHash = GenericDatabaseProvider.SaveCallVariableHash(levelInfo.SchemaName, levelInfo.BaseTable, keyValues);
+        return this.Register(levelInfo.Name, fieldName, field.EntityFieldInfo.CodeName, level.Get(fieldName), lookup, saveCallHash);
+    }
+    replaceSetLines(sql) {
+        if (this.linesByHash.size === 0) {
+            return sql;
+        }
+        let result = sql;
+        for (const hash of SaveCallHashesIn(sql)) {
+            for (const line of this.linesByHash.get(hash)?.values() ?? []) {
+                result = result.replace(line.Pattern, (_line, indent, variable) => `${indent}SET ${variable} = ${line.Subquery}`);
+            }
+        }
+        return result;
+    }
+}
+/**
+ * The lookup rewriter of one open SQL log, with the `SyncEngine.BeforeLookupCreateSaveSource` hook
+ * that registers each record a `?create` lookup makes.
+ */
+export class LookupSqlLog {
+    constructor(engine) {
+        this.engine = engine;
+        this.Rewriter = new LookupSqlRewriter(new LookupSubqueryBuilder((name) => engine.GetEntityInfo(name)));
+        this.hook = (created, lookup) => this.Rewriter.RegisterLookupCreate(created, lookup);
+        engine.BeforeLookupCreateSaveSource = this.hook;
+    }
+    /** Clears the engine's hook when it is still this log's hook. */
+    Close() {
+        if (this.engine.BeforeLookupCreateSaveSource === this.hook) {
+            this.engine.BeforeLookupCreateSaveSource = null;
+        }
+    }
+}
+/** One `TransformStatement` that runs each transform in turn. */
+export function ComposeStatementTransforms(...transforms) {
+    return (sql) => transforms.reduce((text, transform) => transform(text), sql);
+}
+//# sourceMappingURL=lookup-sql.js.map

package/dist/lib/lookup-sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup-sql.js","sourceRoot":"","sources":["../../src/lib/lookup-sql.ts"],"names":[],"mappings":"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"}

package/dist/lib/natural-key-preflight.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview Pre-flight for a create that a unique constraint would reject (#4400).
+ *
+ * A seed record with a literal primary key that is not in the database is created with that key.
+ * When the database already has a row with the same natural key under another ID (CodeGen and
+ * other server-side code create rows with database-generated IDs), the create violates the unique
+ * constraint and the push stops on a driver error. This check runs first: for each unique key of
+ * the table, it looks the record's values up and, on a hit, reports the existing row's key so the
+ * seed can be re-keyed with `@lookup`.
+ * @module natural-key-preflight
+ */
+import { type BaseEntity, type DatabaseProviderBase, type EntityFieldInfo, type EntityInfo, type IMetadataProvider, type UserInfo } from '@memberjunction/core';
+/** One unique key of a table: its name and its columns in key order. */
+export interface UniqueKeyColumns {
+    Name: string;
+    Columns: string[];
+}
+/** A row that already holds the natural key a create would add. */
+export interface NaturalKeyConflict {
+    /** Unique constraint or index name. */
+    KeyName: string;
+    /** The entity's field names that make up the key. */
+    Fields: string[];
+    /** The primary key of the existing row. */
+    ExistingKey: Record<string, unknown>;
+}
+/** Reads unique keys and finds rows by them. */
+export interface NaturalKeyReader {
+    /** The unique keys of the entity's table, other than the primary key. */
+    UniqueKeys(info: EntityInfo): Promise<UniqueKeyColumns[]>;
+    /** The primary key of a row whose fields equal `values`, or null when there is none. */
+    FindKey(info: EntityInfo, values: ReadonlyArray<{
+        Field: EntityFieldInfo;
+        Value: unknown;
+    }>): Promise<Record<string, unknown> | null>;
+}
+/** Finds the existing row, if any, that a create of `entity` would collide with on a unique key. */
+export declare class NaturalKeyPreflight {
+    private readonly reader;
+    constructor(reader: NaturalKeyReader);
+    /**
+     * The first unique key whose values another row already holds, or null. A key is checked only
+     * when every one of its columns is a field of the entity with a non-null value and no column is
+     * part of the primary key.
+     */
+    Check(entity: BaseEntity): Promise<NaturalKeyConflict | null>;
+    private keyValues;
+}
+/** Row shape of the unique-key catalog queries. */
+interface UniqueKeyCatalogRow {
+    IndexName: string;
+    ColumnName: string;
+}
+/**
+ * Reads unique keys from the database catalog (unfiltered unique indexes and unique constraints,
+ * not the primary key) and finds rows with `RunView` on the record's provider, so the lookup sees
+ * rows the push transaction wrote. Catalog reads go to the pool and are never logged. A catalog
+ * read that fails gives no keys, so the check is skipped rather than failing the push.
+ */
+export declare class DatabaseNaturalKeyReader implements NaturalKeyReader {
+    private readonly provider;
+    private readonly contextUser;
+    private readonly rowProvider;
+    private readonly cache;
+    /**
+     * `rowProvider` is the provider rows are found on (the record's, so the read joins its
+     * transaction); `cache` (entity name → keys) can be shared by readers that find rows on
+     * different providers.
+     */
+    constructor(provider: DatabaseProviderBase, contextUser: UserInfo, rowProvider?: IMetadataProvider, cache?: Map<string, Promise<UniqueKeyColumns[]>>);
+    UniqueKeys(info: EntityInfo): Promise<UniqueKeyColumns[]>;
+    FindKey(info: EntityInfo, values: ReadonlyArray<{
+        Field: EntityFieldInfo;
+        Value: unknown;
+    }>): Promise<Record<string, unknown> | null>;
+    private readUniqueKeys;
+    private literal;
+}
+/** The catalog query listing a table's unfiltered unique keys other than the primary key, one row per column in key order. */
+export declare function UniqueKeyCatalogSQL(platformKey: string, schemaName: string, tableName: string): string;
+/** Catalog rows grouped into keys, in row order. */
+export declare function GroupUniqueKeyRows(rows: ReadonlyArray<UniqueKeyCatalogRow>): UniqueKeyColumns[];
+/** The pre-flight error for a conflict. `recordKey` is the record's key as it may be shown. */
+export declare function NaturalKeyConflictMessage(entityName: string, recordKey: string, conflict: NaturalKeyConflict): string;
+export {};
+//# sourceMappingURL=natural-key-preflight.d.ts.map

package/dist/lib/natural-key-preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"natural-key-preflight.d.ts","sourceRoot":"","sources":["../../src/lib/natural-key-preflight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAW,KAAK,UAAU,EAAE,KAAK,oBAAoB,EAAE,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEzK,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC1D,wFAAwF;IACxF,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC;QAAE,KAAK,EAAE,eAAe,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;CACvI;AAED,oGAAoG;AACpG,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAE9B,MAAM,EAAE,gBAAgB;IAIpC;;;;OAIG;IACG,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAoBnE,OAAO,CAAC,SAAS;CAkBlB;AASD,mDAAmD;AACnD,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAW;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgC;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2C;IAEjE;;;;OAIG;gBAED,QAAQ,EAAE,oBAAoB,EAC9B,WAAW,EAAE,QAAQ,EACrB,WAAW,CAAC,EAAE,iBAAiB,EAC/B,KAAK,GAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAa;IAQ7D,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IASnD,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC;QAAE,KAAK,EAAE,eAAe,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;YAiB7H,cAAc;IAc5B,OAAO,CAAC,OAAO;CAahB;AAED,8HAA8H;AAC9H,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAsBtG;AAED,oDAAoD;AACpD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,CAAC,mBAAmB,CAAC,GAAG,gBAAgB,EAAE,CAQ/F;AAED,+FAA+F;AAC/F,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAYrH"}

package/dist/lib/natural-key-preflight.js

@@ -0,0 +1,173 @@
+/**
+ * @fileoverview Pre-flight for a create that a unique constraint would reject (#4400).
+ *
+ * A seed record with a literal primary key that is not in the database is created with that key.
+ * When the database already has a row with the same natural key under another ID (CodeGen and
+ * other server-side code create rows with database-generated IDs), the create violates the unique
+ * constraint and the push stops on a driver error. This check runs first: for each unique key of
+ * the table, it looks the record's values up and, on a hit, reports the existing row's key so the
+ * seed can be re-keyed with `@lookup`.
+ * @module natural-key-preflight
+ */
+import { RunView } from '@memberjunction/core';
+/** Finds the existing row, if any, that a create of `entity` would collide with on a unique key. */
+export class NaturalKeyPreflight {
+    constructor(reader) {
+        this.reader = reader;
+    }
+    /**
+     * The first unique key whose values another row already holds, or null. A key is checked only
+     * when every one of its columns is a field of the entity with a non-null value and no column is
+     * part of the primary key.
+     */
+    async Check(entity) {
+        const info = entity.EntityInfo;
+        const keys = await this.reader.UniqueKeys(info);
+        if (keys.length === 0) {
+            return null;
+        }
+        const keyNames = new Set(info.PrimaryKeys.map((pk) => pk.Name.toLowerCase()));
+        for (const key of keys) {
+            const values = this.keyValues(entity, key, keyNames);
+            if (!values) {
+                continue;
+            }
+            const existing = await this.reader.FindKey(info, values);
+            if (existing && !samePrimaryKey(entity, existing)) {
+                return { KeyName: key.Name, Fields: values.map((value) => value.Field.Name), ExistingKey: existing };
+            }
+        }
+        return null;
+    }
+    keyValues(entity, key, keyNames) {
+        if (key.Columns.length === 0) {
+            return null;
+        }
+        const values = [];
+        for (const column of key.Columns) {
+            if (keyNames.has(column.toLowerCase())) {
+                return null;
+            }
+            const field = entity.EntityInfo.Fields.find((candidate) => candidate.Name.toLowerCase() === column.toLowerCase());
+            const value = field ? entity.Get(field.Name) : undefined;
+            if (!field || value === null || value === undefined) {
+                return null;
+            }
+            values.push({ Field: field, Value: value });
+        }
+        return values;
+    }
+}
+/** True when `existing` is the entity's own key (compared without regard to case). */
+function samePrimaryKey(entity, existing) {
+    return entity.EntityInfo.PrimaryKeys.every((pk) => String(entity.Get(pk.Name) ?? '').trim().toLowerCase() === String(existing[pk.Name] ?? '').trim().toLowerCase());
+}
+/**
+ * Reads unique keys from the database catalog (unfiltered unique indexes and unique constraints,
+ * not the primary key) and finds rows with `RunView` on the record's provider, so the lookup sees
+ * rows the push transaction wrote. Catalog reads go to the pool and are never logged. A catalog
+ * read that fails gives no keys, so the check is skipped rather than failing the push.
+ */
+export class DatabaseNaturalKeyReader {
+    /**
+     * `rowProvider` is the provider rows are found on (the record's, so the read joins its
+     * transaction); `cache` (entity name → keys) can be shared by readers that find rows on
+     * different providers.
+     */
+    constructor(provider, contextUser, rowProvider, cache = new Map()) {
+        this.provider = provider;
+        this.contextUser = contextUser;
+        this.rowProvider = rowProvider;
+        this.cache = cache;
+    }
+    UniqueKeys(info) {
+        let keys = this.cache.get(info.Name);
+        if (!keys) {
+            keys = this.readUniqueKeys(info);
+            this.cache.set(info.Name, keys);
+        }
+        return keys;
+    }
+    async FindKey(info, values) {
+        // Quoted, so a reserved-word or spaced column name still filters (rather than failing the read)
+        const filter = values.map(({ Field, Value }) => `${this.provider.QuoteIdentifier(Field.Name)} = ${this.literal(Field, Value)}`).join(' AND ');
+        const rv = this.rowProvider ? RunView.FromMetadataProvider(this.rowProvider) : new RunView();
+        const result = await rv.RunView({
+            EntityName: info.Name,
+            ExtraFilter: filter,
+            Fields: info.PrimaryKeys.map((pk) => pk.Name),
+            MaxRows: 1,
+            ResultType: 'simple',
+        }, this.contextUser);
+        return result.Success && result.Results.length > 0 ? result.Results[0] : null;
+    }
+    async readUniqueKeys(info) {
+        try {
+            const rows = await this.provider.ExecuteSQL(UniqueKeyCatalogSQL(this.provider.PlatformKey, info.SchemaName, info.BaseTable), undefined, { ignoreLogging: true, isMutation: false, ignoreAmbientTransaction: true }, this.contextUser);
+            return GroupUniqueKeyRows(rows);
+        }
+        catch {
+            return [];
+        }
+    }
+    literal(field, value) {
+        if (value instanceof Date) {
+            return `'${value.toISOString()}'`;
+        }
+        if (typeof value === 'boolean') {
+            if (this.provider.PlatformKey === 'postgresql') {
+                return value ? 'true' : 'false';
+            }
+            return value ? '1' : '0';
+        }
+        const text = String(value).replace(/'/g, "''");
+        return field.NeedsQuotes ? `'${text}'` : text;
+    }
+}
+/** The catalog query listing a table's unfiltered unique keys other than the primary key, one row per column in key order. */
+export function UniqueKeyCatalogSQL(platformKey, schemaName, tableName) {
+    const schema = schemaName.replace(/'/g, "''");
+    const table = tableName.replace(/'/g, "''");
+    if (platformKey === 'postgresql') {
+        return `SELECT ix.relname AS "IndexName", a.attname AS "ColumnName"
+FROM pg_index x
+JOIN pg_class t ON t.oid = x.indrelid
+JOIN pg_namespace n ON n.oid = t.relnamespace
+JOIN pg_class ix ON ix.oid = x.indexrelid
+JOIN LATERAL unnest(x.indkey) WITH ORDINALITY AS k(attnum, ord) ON true
+JOIN pg_attribute a ON a.attrelid = t.oid AND a.attnum = k.attnum
+WHERE x.indisunique AND NOT x.indisprimary AND x.indpred IS NULL
+  AND n.nspname = '${schema}' AND t.relname = '${table}'
+ORDER BY ix.relname, k.ord`;
+    }
+    return `SELECT i.name AS IndexName, c.name AS ColumnName
+FROM sys.indexes i
+JOIN sys.index_columns ic ON ic.object_id = i.object_id AND ic.index_id = i.index_id
+JOIN sys.columns c ON c.object_id = ic.object_id AND c.column_id = ic.column_id
+WHERE i.object_id = OBJECT_ID(N'[${schema.replace(/]/g, ']]')}].[${table.replace(/]/g, ']]')}]')
+  AND i.is_unique = 1 AND i.is_primary_key = 0 AND i.has_filter = 0 AND ic.is_included_column = 0
+ORDER BY i.name, ic.key_ordinal`;
+}
+/** Catalog rows grouped into keys, in row order. */
+export function GroupUniqueKeyRows(rows) {
+    const byName = new Map();
+    for (const row of rows) {
+        const columns = byName.get(row.IndexName) ?? [];
+        columns.push(row.ColumnName);
+        byName.set(row.IndexName, columns);
+    }
+    return [...byName].map(([Name, Columns]) => ({ Name, Columns }));
+}
+/** The pre-flight error for a conflict. `recordKey` is the record's key as it may be shown. */
+export function NaturalKeyConflictMessage(entityName, recordKey, conflict) {
+    const existing = Object.entries(conflict.ExistingKey)
+        .map(([field, value]) => `${field}=${String(value)}`)
+        .join(', ');
+    const fields = conflict.Fields.join(', ');
+    const example = conflict.Fields.map((field) => `${field}=…`).join('&');
+    return (`${entityName}: no row has primary key {${recordKey}}, but row {${existing}} already has the same ${fields} ` +
+        `(unique key ${conflict.KeyName}), so creating this record would violate it. That row's ID was made by this ` +
+        `database, so a literal ID in metadata cannot match it. Re-key the record's primaryKey with @lookup on ` +
+        `${fields}, for example "@lookup:${entityName}.${example}".`);
+}
+//# sourceMappingURL=natural-key-preflight.js.map

package/dist/lib/natural-key-preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"natural-key-preflight.js","sourceRoot":"","sources":["../../src/lib/natural-key-preflight.ts"],"names":[],"mappings":"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"}

package/dist/lib/provider-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-utils.d.ts","sourceRoot":"","sources":["../../src/lib/provider-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG1C,OAAO,EAAE,oBAAoB,EAA6D,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAgBjI;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAkBxF;AAED,kDAAkD;AAClD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAExF;AAwGD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CA2BrD;AAED,+CAA+C;AAC/C,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAErD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,IAAI,QAAQ,CAqBxC;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,IAAI,QAAQ,CAExC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,IAAI,oBAAoB,GAAG,IAAI,CAE7D;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,IAAI,oBAAoB,GAAG,IAAI,CAE7D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,MAAM,EAAE,EACzB,iBAAiB,CAAC,EAAE,MAAM,EAAE,EAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,EACxB,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,MAAM,EAAE,CAwGV;AAED,qDAAqD;AACrD,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,MAAM,EAAE,EACzB,iBAAiB,CAAC,EAAE,MAAM,EAAE,EAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,EACxB,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,MAAM,EAAE,CAEV"}
+{"version":3,"file":"provider-utils.d.ts","sourceRoot":"","sources":["../../src/lib/provider-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG1C,OAAO,EAAE,oBAAoB,EAA6D,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAiBjI;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAkBxF;AAED,kDAAkD;AAClD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAExF;AAwGD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CA2BrD;AAED,+CAA+C;AAC/C,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAErD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,IAAI,QAAQ,CAqBxC;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,IAAI,QAAQ,CAExC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,IAAI,oBAAoB,GAAG,IAAI,CAE7D;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,IAAI,oBAAoB,GAAG,IAAI,CAE7D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,MAAM,EAAE,EACzB,iBAAiB,CAAC,EAAE,MAAM,EAAE,EAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,EACxB,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,MAAM,EAAE,CAqGV;AAED,qDAAqD;AACrD,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,MAAM,EAAE,EACzB,iBAAiB,CAAC,EAAE,MAAM,EAAE,EAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,EACxB,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,MAAM,EAAE,CAEV"}