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

package/dist/lib/existing-record-index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview Finds existing file records by a database primary key. An `@env:` key value is
+ * replaced by its variable (trimmed) for the match, and UUID key fields are compared without case.
+ * @module existing-record-index
+ */
+import type { EntityInfo } from '@memberjunction/core';
+import type { RecordData } from './sync-engine.js';
+import { PrimaryKeyValues } from './record-primary-key.js';
+/** A primaryKey field whose `@env:` variable is not set. Never holds a value. */
+export interface UnsetKeyVariable {
+    VariableName: string;
+    Field: string;
+    /** File that holds the record, when known. */
+    FilePath?: string;
+}
+/** One existing file record. */
+export interface ExistingRecordEntry {
+    Record: RecordData;
+    /** File that holds the record, when known. */
+    FilePath?: string;
+    /** True when the file holds an array of records. */
+    InArray?: boolean;
+}
+/** Thrown when a primaryKey `@env:` variable is not set, so pull cannot match the record. */
+export declare class UnsetPrimaryKeyVariableError extends Error {
+    readonly Variables: ReadonlyArray<UnsetKeyVariable>;
+    /** Entity whose key uses the variables. */
+    readonly EntityName: string;
+    /** Entity the user pulls, when it differs from `EntityName`. */
+    readonly PulledEntityName?: string;
+    constructor(entityName: string, variables: ReadonlyArray<UnsetKeyVariable>, pulledEntityName?: string);
+    /** The same error with `filePath` on each variable that names no file, and the entity the user pulls. */
+    InRecordFile(filePath: string | undefined, pulledEntityName: string): UnsetPrimaryKeyVariableError;
+}
+/** Existing file records, found by the database primary key. The first record wins for a repeated key. */
+export declare class ExistingRecordIndex {
+    private readonly uuidFields;
+    private readonly env;
+    private readonly byKey;
+    private readonly unsetVariables;
+    private duplicates;
+    private constructor();
+    /** Indexes the entries. Records without a primaryKey, or with an unset key variable, are not indexed. */
+    static Build(entries: ReadonlyArray<ExistingRecordEntry>, entityInfo: EntityInfo | null | undefined, env?: NodeJS.ProcessEnv): ExistingRecordIndex;
+    /** The lookup string of a record as the file writes it, for `FileWriteBatch` array updates. */
+    static FileLookupOf(record: RecordData): string;
+    /** Key variables that are not set. The records that use them are not indexed. */
+    get UnsetKeyVariables(): ReadonlyArray<UnsetKeyVariable>;
+    /** Number of records whose key repeats an earlier record's key. */
+    get DuplicateCount(): number;
+    /** @throws UnsetPrimaryKeyVariableError when any key variable is not set */
+    ThrowIfUnsetKeyVariables(entityName: string): void;
+    /** The existing entry whose resolved key equals the database key, or undefined. */
+    Find(databaseKey: PrimaryKeyValues): ExistingRecordEntry | undefined;
+    /** The match string of a database key. */
+    MatchKey(databaseKey: PrimaryKeyValues): string;
+    /** The match string of a file record's key, or null when the key is empty or a key variable is not set. */
+    KeyOf(record: RecordData): string | null;
+    private add;
+    /** A file key value as text: the variable (trimmed) for `@env:`, the value otherwise; null when unusable. */
+    private resolve;
+    /** Trimmed, as a fixed-width key is padded; UUID fields lowercased. */
+    private normalize;
+}
+/**
+ * The primary key pull writes: the file's `@env:` value for each field whose variable (trimmed)
+ * equals the database value, with UUID fields compared without case; the database value otherwise.
+ */
+export declare function KeepPrimaryKeyEnvReferences(fileKey: Record<string, unknown> | undefined, databaseKey: Record<string, unknown>, entityInfo: EntityInfo | null | undefined, env?: NodeJS.ProcessEnv): Record<string, unknown>;
+//# sourceMappingURL=existing-record-index.d.ts.map

package/dist/lib/existing-record-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"existing-record-index.d.ts","sourceRoot":"","sources":["../../src/lib/existing-record-index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAA0B,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGhF,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gCAAgC;AAChC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,UAAU,CAAC;IACnB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,6FAA6F;AAC7F,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,SAAgB,SAAS,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC3D,2CAA2C;IAC3C,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,gEAAgE;IAChE,SAAgB,gBAAgB,CAAC,EAAE,MAAM,CAAC;gBAE9B,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,EAAE,MAAM;IAYrG,yGAAyG;IACzG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,gBAAgB,EAAE,MAAM,GAAG,4BAA4B;CAInG;AAMD,0GAA0G;AAC1G,qBAAa,mBAAmB;IAM5B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG;IANtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;IAChE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0B;IACzD,OAAO,CAAC,UAAU,CAAK;IAEvB,OAAO;IAKP,yGAAyG;IACzG,MAAM,CAAC,KAAK,CACV,OAAO,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAC3C,UAAU,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACzC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,mBAAmB;IAQtB,+FAA+F;IAC/F,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IAI/C,iFAAiF;IACjF,IAAI,iBAAiB,IAAI,aAAa,CAAC,gBAAgB,CAAC,CAEvD;IAED,mEAAmE;IACnE,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,4EAA4E;IAC5E,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAMlD,mFAAmF;IACnF,IAAI,CAAC,WAAW,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,SAAS;IAIpE,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,gBAAgB,GAAG,MAAM;IAQ/C,2GAA2G;IAC3G,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAgBxC,OAAO,CAAC,GAAG;IA2BX,6GAA6G;IAC7G,OAAO,CAAC,OAAO;IAYf,uEAAuE;IACvE,OAAO,CAAC,SAAS;CAIlB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC5C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,UAAU,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACzC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzB"}

package/dist/lib/existing-record-index.js

@@ -0,0 +1,158 @@
+import { CreatePrimaryKeyLookup } from './record-primary-key.js';
+import { ParseEnvReference } from './env-reference.js';
+/** Thrown when a primaryKey `@env:` variable is not set, so pull cannot match the record. */
+export class UnsetPrimaryKeyVariableError extends Error {
+    constructor(entityName, variables, pulledEntityName) {
+        const details = variables
+            .map((v) => `${v.FilePath ? `${v.FilePath}: ` : ''}primaryKey field ${v.Field} uses @env:${v.VariableName}, which is not set`)
+            .join('; ');
+        const pulled = pulledEntityName && pulledEntityName !== entityName ? pulledEntityName : undefined;
+        super(pulled ? `${details}. Set it to pull ${pulled}; the key belongs to ${entityName}.` : `${details}. Set it to pull ${entityName}.`);
+        this.name = 'UnsetPrimaryKeyVariableError';
+        this.Variables = variables;
+        this.EntityName = entityName;
+        this.PulledEntityName = pulled;
+    }
+    /** The same error with `filePath` on each variable that names no file, and the entity the user pulls. */
+    InRecordFile(filePath, pulledEntityName) {
+        const variables = this.Variables.map((v) => ({ ...v, FilePath: v.FilePath ?? filePath }));
+        return new UnsetPrimaryKeyVariableError(this.EntityName, variables, pulledEntityName);
+    }
+}
+function uuidKeyFields(entityInfo) {
+    return new Set((entityInfo?.PrimaryKeys ?? []).filter((pk) => pk.IsUniqueIdentifier).map((pk) => pk.Name));
+}
+/** Existing file records, found by the database primary key. The first record wins for a repeated key. */
+export class ExistingRecordIndex {
+    constructor(uuidFields, env) {
+        this.uuidFields = uuidFields;
+        this.env = env;
+        this.byKey = new Map();
+        this.unsetVariables = [];
+        this.duplicates = 0;
+    }
+    /** Indexes the entries. Records without a primaryKey, or with an unset key variable, are not indexed. */
+    static Build(entries, entityInfo, env = process.env) {
+        const index = new ExistingRecordIndex(uuidKeyFields(entityInfo), env);
+        for (const entry of entries) {
+            index.add(entry);
+        }
+        return index;
+    }
+    /** The lookup string of a record as the file writes it, for `FileWriteBatch` array updates. */
+    static FileLookupOf(record) {
+        return CreatePrimaryKeyLookup(record.primaryKey);
+    }
+    /** Key variables that are not set. The records that use them are not indexed. */
+    get UnsetKeyVariables() {
+        return this.unsetVariables;
+    }
+    /** Number of records whose key repeats an earlier record's key. */
+    get DuplicateCount() {
+        return this.duplicates;
+    }
+    /** @throws UnsetPrimaryKeyVariableError when any key variable is not set */
+    ThrowIfUnsetKeyVariables(entityName) {
+        if (this.unsetVariables.length > 0) {
+            throw new UnsetPrimaryKeyVariableError(entityName, this.unsetVariables);
+        }
+    }
+    /** The existing entry whose resolved key equals the database key, or undefined. */
+    Find(databaseKey) {
+        return this.byKey.get(this.MatchKey(databaseKey));
+    }
+    /** The match string of a database key. */
+    MatchKey(databaseKey) {
+        const normalized = {};
+        for (const [field, value] of Object.entries(databaseKey)) {
+            normalized[field] = this.normalize(field, String(value));
+        }
+        return CreatePrimaryKeyLookup(normalized);
+    }
+    /** The match string of a file record's key, or null when the key is empty or a key variable is not set. */
+    KeyOf(record) {
+        const primaryKey = record.primaryKey;
+        if (!primaryKey || Object.keys(primaryKey).length === 0) {
+            return null;
+        }
+        const normalized = {};
+        for (const [field, value] of Object.entries(primaryKey)) {
+            const resolved = this.resolve(value);
+            if (resolved === null) {
+                return null;
+            }
+            normalized[field] = this.normalize(field, resolved);
+        }
+        return CreatePrimaryKeyLookup(normalized);
+    }
+    add(entry) {
+        const primaryKey = entry.Record?.primaryKey;
+        if (!primaryKey || Object.keys(primaryKey).length === 0) {
+            return;
+        }
+        let hasUnset = false;
+        for (const [field, value] of Object.entries(primaryKey)) {
+            const reference = ParseEnvReference(value);
+            if (reference && this.env[reference.VariableName] === undefined) {
+                this.unsetVariables.push({ VariableName: reference.VariableName, Field: field, FilePath: entry.FilePath });
+                hasUnset = true;
+            }
+        }
+        if (hasUnset) {
+            return;
+        }
+        const key = this.KeyOf(entry.Record);
+        if (key === null) {
+            return;
+        }
+        if (this.byKey.has(key)) {
+            this.duplicates++;
+            return;
+        }
+        this.byKey.set(key, entry);
+    }
+    /** A file key value as text: the variable (trimmed) for `@env:`, the value otherwise; null when unusable. */
+    resolve(value) {
+        const reference = ParseEnvReference(value);
+        if (reference) {
+            const envValue = this.env[reference.VariableName];
+            return envValue === undefined ? null : envValue.trim();
+        }
+        if (value === null || value === undefined) {
+            return null;
+        }
+        return String(value);
+    }
+    /** Trimmed, as a fixed-width key is padded; UUID fields lowercased. */
+    normalize(field, value) {
+        const trimmed = value.trim();
+        return this.uuidFields.has(field) ? trimmed.toLowerCase() : trimmed;
+    }
+}
+/**
+ * The primary key pull writes: the file's `@env:` value for each field whose variable (trimmed)
+ * equals the database value, with UUID fields compared without case; the database value otherwise.
+ */
+export function KeepPrimaryKeyEnvReferences(fileKey, databaseKey, entityInfo, env = process.env) {
+    if (!fileKey) {
+        return databaseKey;
+    }
+    const uuidFields = uuidKeyFields(entityInfo);
+    const result = { ...databaseKey };
+    for (const [field, databaseValue] of Object.entries(databaseKey)) {
+        const fileValue = fileKey[field];
+        const reference = ParseEnvReference(fileValue);
+        const envValue = reference ? env[reference.VariableName] : undefined;
+        if (envValue === undefined || databaseValue === null || databaseValue === undefined) {
+            continue;
+        }
+        const fromEnv = envValue.trim();
+        const fromDatabase = String(databaseValue).trim();
+        const equal = uuidFields.has(field) ? fromEnv.toLowerCase() === fromDatabase.toLowerCase() : fromEnv === fromDatabase;
+        if (equal) {
+            result[field] = fileValue;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=existing-record-index.js.map

package/dist/lib/existing-record-index.js.map

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

package/dist/lib/ignore-directories.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview The `ignoreDirectories` name rule shared by push, watch, status and validation.
+ * @module ignore-directories
+ */
+/**
+ * True when a directory name equals one of the patterns or ends with it.
+ * Used for `ignoreDirectories` by push (and watch, which chooses folders as push does), status and validation.
+ */
+export declare function IsIgnoredDirectoryName(name: string, patterns: readonly string[] | undefined): boolean;
+//# sourceMappingURL=ignore-directories.d.ts.map

package/dist/lib/ignore-directories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-directories.d.ts","sourceRoot":"","sources":["../../src/lib/ignore-directories.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,OAAO,CAErG"}

package/dist/lib/ignore-directories.js

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview The `ignoreDirectories` name rule shared by push, watch, status and validation.
+ * @module ignore-directories
+ */
+/**
+ * True when a directory name equals one of the patterns or ends with it.
+ * Used for `ignoreDirectories` by push (and watch, which chooses folders as push does), status and validation.
+ */
+export function IsIgnoredDirectoryName(name, patterns) {
+    return !!patterns && patterns.some((pattern) => name === pattern || name.endsWith(pattern));
+}
+//# sourceMappingURL=ignore-directories.js.map

package/dist/lib/ignore-directories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-directories.js","sourceRoot":"","sources":["../../src/lib/ignore-directories.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,QAAuC;IAC1F,OAAO,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9F,CAAC"}

package/dist/lib/json-record-lines.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Start line numbers of the objects in a JSON text, keyed by the parsed objects.
+ * @module json-record-lines
+ */
+/**
+ * Maps each object and array in `parsed` to the 1-based line of its opening bracket in `text`.
+ * `parsed` must be `JSON.parse(text)`. For a repeated key, the last one is used, as in `JSON.parse`.
+ */
+export declare function MapJsonStartLines(text: string, parsed: unknown): WeakMap<object, number>;
+/**
+ * The start line of the record at a push record path (`Entity[1]/Child Entity[0]`) in a record
+ * file's text: the top-level item, then `relatedEntities` items. Undefined when the text is not
+ * valid JSON, when it uses `@include` (push numbers records after the include is applied, so a raw
+ * position can point to another record), or when the path does not lead to a record.
+ */
+export declare function RecordStartLine(text: string, recordPath: string): number | undefined;
+//# sourceMappingURL=json-record-lines.d.ts.map

package/dist/lib/json-record-lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-record-lines.d.ts","sourceRoot":"","sources":["../../src/lib/json-record-lines.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8HH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAIxF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAwBpF"}

package/dist/lib/json-record-lines.js

@@ -0,0 +1,170 @@
+/**
+ * @fileoverview Start line numbers of the objects in a JSON text, keyed by the parsed objects.
+ * @module json-record-lines
+ */
+/** Reads the positions of the values in a valid JSON text. */
+class JsonPositionScanner {
+    constructor(text) {
+        this.text = text;
+        this.offset = 0;
+        this.line = 1;
+    }
+    ScanDocument() {
+        this.skipWhitespace();
+        return this.scanValue();
+    }
+    scanValue() {
+        const line = this.line;
+        const char = this.text[this.offset];
+        if (char === '{') {
+            return { Line: line, Members: this.scanObject(), Items: null };
+        }
+        if (char === '[') {
+            return { Line: line, Members: null, Items: this.scanArray() };
+        }
+        if (char === '"') {
+            this.scanString();
+        }
+        else {
+            this.scanLiteral();
+        }
+        return { Line: line, Members: null, Items: null };
+    }
+    scanObject() {
+        const members = new Map();
+        this.offset++;
+        this.skipWhitespace();
+        while (this.offset < this.text.length && this.text[this.offset] !== '}') {
+            const key = this.scanString();
+            this.skipWhitespace();
+            this.offset++; // ':'
+            this.skipWhitespace();
+            members.set(key, this.scanValue());
+            this.skipWhitespace();
+            if (this.text[this.offset] === ',') {
+                this.offset++;
+                this.skipWhitespace();
+            }
+        }
+        this.offset++;
+        return members;
+    }
+    scanArray() {
+        const items = [];
+        this.offset++;
+        this.skipWhitespace();
+        while (this.offset < this.text.length && this.text[this.offset] !== ']') {
+            items.push(this.scanValue());
+            this.skipWhitespace();
+            if (this.text[this.offset] === ',') {
+                this.offset++;
+                this.skipWhitespace();
+            }
+        }
+        this.offset++;
+        return items;
+    }
+    /** Reads a string token and returns its decoded text. */
+    scanString() {
+        const start = this.offset;
+        this.offset++;
+        while (this.offset < this.text.length && this.text[this.offset] !== '"') {
+            this.offset += this.text[this.offset] === '\\' ? 2 : 1;
+        }
+        this.offset++;
+        const decoded = JSON.parse(this.text.slice(start, this.offset));
+        return typeof decoded === 'string' ? decoded : '';
+    }
+    /** Reads a number, true, false or null. */
+    scanLiteral() {
+        while (this.offset < this.text.length && !/[\s,\]}]/.test(this.text[this.offset])) {
+            this.offset++;
+        }
+    }
+    skipWhitespace() {
+        while (this.offset < this.text.length) {
+            const char = this.text[this.offset];
+            if (char === '\n') {
+                this.line++;
+            }
+            else if (char !== ' ' && char !== '\t' && char !== '\r') {
+                return;
+            }
+            this.offset++;
+        }
+    }
+}
+function mapStartLines(value, position, lines) {
+    if (Array.isArray(value)) {
+        lines.set(value, position.Line);
+        value.forEach((item, index) => {
+            const itemPosition = position.Items?.[index];
+            if (itemPosition) {
+                mapStartLines(item, itemPosition, lines);
+            }
+        });
+    }
+    else if (value !== null && typeof value === 'object') {
+        lines.set(value, position.Line);
+        for (const [key, member] of Object.entries(value)) {
+            const memberPosition = position.Members?.get(key);
+            if (memberPosition) {
+                mapStartLines(member, memberPosition, lines);
+            }
+        }
+    }
+}
+/**
+ * Maps each object and array in `parsed` to the 1-based line of its opening bracket in `text`.
+ * `parsed` must be `JSON.parse(text)`. For a repeated key, the last one is used, as in `JSON.parse`.
+ */
+export function MapJsonStartLines(text, parsed) {
+    const lines = new WeakMap();
+    mapStartLines(parsed, new JsonPositionScanner(text).ScanDocument(), lines);
+    return lines;
+}
+/**
+ * The start line of the record at a push record path (`Entity[1]/Child Entity[0]`) in a record
+ * file's text: the top-level item, then `relatedEntities` items. Undefined when the text is not
+ * valid JSON, when it uses `@include` (push numbers records after the include is applied, so a raw
+ * position can point to another record), or when the path does not lead to a record.
+ */
+export function RecordStartLine(text, recordPath) {
+    if (text.includes('"@include')) {
+        return undefined;
+    }
+    const content = text.replace(/^/, '');
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        return undefined;
+    }
+    const lines = MapJsonStartLines(content, parsed);
+    let current = undefined;
+    let first = true;
+    for (const [, entityName, indexText] of recordPath.matchAll(/(.+?)\[(\d+)\](?:\/|$)/g)) {
+        const index = Number(indexText);
+        if (first) {
+            current = Array.isArray(parsed) ? parsed[index] : index === 0 ? parsed : undefined;
+            first = false;
+        }
+        else {
+            current = relatedItem(current, entityName, index);
+        }
+    }
+    return current !== null && typeof current === 'object' ? lines.get(current) : undefined;
+}
+function relatedItem(record, entityName, index) {
+    if (record === null || typeof record !== 'object' || !('relatedEntities' in record)) {
+        return undefined;
+    }
+    const related = record.relatedEntities;
+    if (related === null || typeof related !== 'object') {
+        return undefined;
+    }
+    const items = Reflect.get(related, entityName);
+    return Array.isArray(items) ? items[index] : undefined;
+}
+//# sourceMappingURL=json-record-lines.js.map

package/dist/lib/json-record-lines.js.map

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

package/dist/lib/json-subproperty-externalization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-subproperty-externalization.d.ts","sourceRoot":"","sources":["../../src/lib/json-subproperty-externalization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,iEAAiE;AACjE,MAAM,WAAW,0BAA0B;IACvC,sEAAsE;IACtE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,6EAA6E;AAC7E,MAAM,MAAM,eAAe,GAAG,CAC1B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,KAChB,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IAClC,gBAAgB,CACZ,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,SAAS,EAAE,MAAM,EACjB,qBAAqB,CAAC,EAAE,MAAM,EAC9B,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB;AAMD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAG3F;AAED,oDAAoD;AACpD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAE3F;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC3C,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,OAAO,GAC3B,0BAA0B,EAAE,CAe9B;AAED,+DAA+D;AAC/D,wBAAgB,+BAA+B,CAC3C,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,OAAO,GAC3B,0BAA0B,EAAE,CAE9B;AAED,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CASjE;AAED,yCAAyC;AACzC,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAEjE;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACpC,YAAY,EAAE,qBAAqB,EACnC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,MAAgB,EAC/B,OAAO,CAAC,EAAE,OAAO,GAClB,eAAe,CAcjB;AAED,wDAAwD;AACxD,wBAAgB,wBAAwB,CACpC,YAAY,EAAE,qBAAqB,EACnC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,MAAgB,EAC/B,OAAO,CAAC,EAAE,OAAO,GAClB,eAAe,CAEjB;AA+BD;;;;;;;;;;;GAWG;AACH,wBAAsB,wBAAwB,CAC1C,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,0BAA0B,EAAE,EACrC,WAAW,EAAE,eAAe,EAC5B,kBAAkB,CAAC,EAAE,OAAO,GAC7B,OAAO,CAAC,OAAO,CAAC,CA4BlB;AAED,wDAAwD;AACxD,wBAAsB,wBAAwB,CAC1C,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,0BAA0B,EAAE,EACrC,WAAW,EAAE,eAAe,EAC5B,kBAAkB,CAAC,EAAE,OAAO,GAC7B,OAAO,CAAC,OAAO,CAAC,CAElB"}
+{"version":3,"file":"json-subproperty-externalization.d.ts","sourceRoot":"","sources":["../../src/lib/json-subproperty-externalization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,iEAAiE;AACjE,MAAM,WAAW,0BAA0B;IACvC,sEAAsE;IACtE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,6EAA6E;AAC7E,MAAM,MAAM,eAAe,GAAG,CAC1B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,KAChB,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IAClC,gBAAgB,CACZ,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,SAAS,EAAE,MAAM,EACjB,qBAAqB,CAAC,EAAE,MAAM,EAC9B,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB;AAMD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAG3F;AAED,oDAAoD;AACpD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAE3F;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC3C,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,OAAO,GAC3B,0BAA0B,EAAE,CAe9B;AAED,+DAA+D;AAC/D,wBAAgB,+BAA+B,CAC3C,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,OAAO,GAC3B,0BAA0B,EAAE,CAE9B;AAED,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CASjE;AAED,yCAAyC;AACzC,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAEjE;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACpC,YAAY,EAAE,qBAAqB,EACnC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,MAAgB,EAC/B,OAAO,CAAC,EAAE,OAAO,GAClB,eAAe,CAcjB;AAED,wDAAwD;AACxD,wBAAgB,wBAAwB,CACpC,YAAY,EAAE,qBAAqB,EACnC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,MAAgB,EAC/B,OAAO,CAAC,EAAE,OAAO,GAClB,eAAe,CAEjB;AA+BD;;;;;;;;;;;GAWG;AACH,wBAAsB,wBAAwB,CAC1C,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,0BAA0B,EAAE,EACrC,WAAW,EAAE,eAAe,EAC5B,kBAAkB,CAAC,EAAE,OAAO,GAC7B,OAAO,CAAC,OAAO,CAAC,CA6BlB;AAED,wDAAwD;AACxD,wBAAsB,wBAAwB,CAC1C,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,0BAA0B,EAAE,EACrC,WAAW,EAAE,eAAe,EAC5B,kBAAkB,CAAC,EAAE,OAAO,GAC7B,OAAO,CAAC,OAAO,CAAC,CAElB"}

package/dist/lib/json-subproperty-externalization.js

@@ -17,6 +17,7 @@
  * back. Pattern placeholders, path preservation and the unchanged-content skip all come
  * from that existing code.
  */
+import { HasNestedEnvReference, ParseEnvReference } from './env-reference.js';
 function isPlainObject(value) {
     return value !== null && typeof value === 'object' && !Array.isArray(value);
 }
@@ -143,7 +144,8 @@ export async function ExternalizeSubProperties(fieldValue, configs, externalize,
     let result = parsed;
     for (const { path, pattern } of configs) {
         const leaf = GetAtPath(result, path);
-        if (leaf === undefined || leaf === null) {
+        // A leaf that is or holds an `@env:` reference stays inline, so no side file gets a resolved value.
+        if (leaf === undefined || leaf === null || ParseEnvReference(leaf) !== null || HasNestedEnvReference(leaf)) {
             continue;
         }
         const existingRef = existing ? GetAtPath(existing, path) : undefined;

package/dist/lib/json-subproperty-externalization.js.map

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

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

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview Splits a `@lookup:` reference the way push reads it, so push, validation and pull agree.
+ * Format: `@lookup:Entity.Field1=Value1&Field2=Value2?create&allowDefer&CreateField=Value`.
+ * The entity ends at the first `.`; the criteria end at the first `?`; the rest is flags.
+ * @module lookup-reference
+ */
+/** A split `@lookup:` reference. */
+export interface LookupSplit {
+    EntityName: string;
+    /** From after the entity's `.` up to the first `?`. */
+    CriteriaText: string;
+    /** After the first `?`, or an empty string. */
+    FlagsText: string;
+    /** Lowercased name of every flags item (the part before `=`). */
+    FlagNames: Set<string>;
+    /** Lowercased flags items without `=` other than `create` and `allowdefer`. */
+    UnknownBareFlags: string[];
+}
+/** One `name=value` item of a lookup. */
+export interface LookupPair {
+    Name: string;
+    Value: string;
+}
+/** The error text for `?optional` inside a lookup. */
+export declare const LOOKUP_OPTIONAL_MESSAGE = "?optional is not supported in @lookup: (the ? starts lookup flags)";
+/**
+ * Splits the text after `@lookup:`.
+ * @returns The split, or null when there is no entity name before a `.`
+ */
+export declare function SplitLookupReference(lookupText: string): LookupSplit | null;
+/**
+ * Parses `Field1=Value1&Field2=Value2`. Names and values are trimmed; a value may hold `=`.
+ * @returns The pairs, or null when an item has no `=`
+ */
+export declare function ParseLookupPairs(criteriaText: string): LookupPair[] | null;
+/** The `key=value` flags items that are not `create` or `allowDefer`, with URI-decoded values. */
+export declare function ParseLookupCreateFields(flagsText: string): LookupPair[];
+//# sourceMappingURL=lookup-reference.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lookup-reference.d.ts","sourceRoot":"","sources":["../../src/lib/lookup-reference.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,+EAA+E;IAC/E,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,yCAAyC;AACzC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,sDAAsD;AACtD,eAAO,MAAM,uBAAuB,uEAAuE,CAAC;AAI5G;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAkB3E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,EAAE,GAAG,IAAI,CAU1E;AAED,kGAAkG;AAClG,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,CAYvE"}

package/dist/lib/lookup-reference.js

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview Splits a `@lookup:` reference the way push reads it, so push, validation and pull agree.
+ * Format: `@lookup:Entity.Field1=Value1&Field2=Value2?create&allowDefer&CreateField=Value`.
+ * The entity ends at the first `.`; the criteria end at the first `?`; the rest is flags.
+ * @module lookup-reference
+ */
+/** The error text for `?optional` inside a lookup. */
+export const LOOKUP_OPTIONAL_MESSAGE = '?optional is not supported in @lookup: (the ? starts lookup flags)';
+const KNOWN_BARE_FLAGS = new Set(['create', 'allowdefer']);
+/**
+ * Splits the text after `@lookup:`.
+ * @returns The split, or null when there is no entity name before a `.`
+ */
+export function SplitLookupReference(lookupText) {
+    const entityMatch = lookupText.match(/^([^.]+)\./);
+    if (!entityMatch) {
+        return null;
+    }
+    const entityName = entityMatch[1];
+    const remaining = lookupText.substring(entityName.length + 1);
+    const questionMarkIndex = remaining.indexOf('?');
+    const criteriaText = questionMarkIndex >= 0 ? remaining.substring(0, questionMarkIndex) : remaining;
+    const flagsText = questionMarkIndex >= 0 ? remaining.substring(questionMarkIndex + 1) : '';
+    const items = flagsText ? flagsText.split('&') : [];
+    const flagNames = new Set(items.map((item) => item.split('=')[0].toLowerCase()));
+    const unknownBareFlags = items
+        .map((item) => item.trim())
+        .filter((item) => item !== '' && !item.includes('='))
+        .map((item) => item.toLowerCase())
+        .filter((item) => !KNOWN_BARE_FLAGS.has(item));
+    return { EntityName: entityName, CriteriaText: criteriaText, FlagsText: flagsText, FlagNames: flagNames, UnknownBareFlags: unknownBareFlags };
+}
+/**
+ * Parses `Field1=Value1&Field2=Value2`. Names and values are trimmed; a value may hold `=`.
+ * @returns The pairs, or null when an item has no `=`
+ */
+export function ParseLookupPairs(criteriaText) {
+    const pairs = [];
+    for (const item of criteriaText.split('&')) {
+        const match = item.match(/^(.+?)=(.+)$/);
+        if (!match) {
+            return null;
+        }
+        pairs.push({ Name: match[1].trim(), Value: match[2].trim() });
+    }
+    return pairs;
+}
+/** The `key=value` flags items that are not `create` or `allowDefer`, with URI-decoded values. */
+export function ParseLookupCreateFields(flagsText) {
+    const fields = [];
+    for (const item of flagsText.split('&')) {
+        if (KNOWN_BARE_FLAGS.has(item.toLowerCase())) {
+            continue;
+        }
+        const [key, value] = item.split('=');
+        if (key && value) {
+            fields.push({ Name: key, Value: decodeURIComponent(value) });
+        }
+    }
+    return fields;
+}
+//# sourceMappingURL=lookup-reference.js.map