@syntax-syllogism/warden-core 0.2.0

package/lib/lifecycle/userDiff.js

@@ -0,0 +1,393 @@
+import { validateAndCanonicalizeUsers, validateExternalIdFieldForFlag, validatePersonaModes, } from '../provisioning/planner.js';
+import { getExistingUsers } from '../provisioning/provisionUserUseCase.js';
+import { buildTarget } from '../provisioning/userPlan.js';
+import { resolveReferences } from '../provisioning/referenceResolution.js';
+import { computeAssignmentDeltaFromState, extractCurrentIds, } from '../provisioning/assignmentPlan.js';
+import { batch, soqlIn } from '../shared/sfUtils.js';
+import { describeUserFields } from '../shared/userFields.js';
+import { loadValidatedDefinitions, } from '../provisioning/definitionReader.js';
+import { matchKey } from '../matching/index.js';
+import { groupMemberLabel, loadAssignmentState, permissionSetAssignmentLabel, } from './assignmentState.js';
+import { parseUserFlag, resolveTargetField, resolveTargets } from './targeting.js';
+import { LifecycleError } from './errors.js';
+import { lifecycleMessage } from './messages.js';
+const diffDefinitionMessages = {
+    invalidPersonaDefinition: () => lifecycleMessage('errorInvalidPersonaDefinition'),
+    personasWithoutDefinition: (userKey) => lifecycleMessage('errorPersonasWithoutDefinition', [userKey]),
+    invalidJson: (path, error) => lifecycleMessage('errorInvalidJson', [path, error]),
+};
+const QUERY_BATCH_SIZE = 100;
+const emptyCategory = (mode) => ({
+    adds: [],
+    removes: [],
+    inBoth: [],
+    onlyInOrg: [],
+    ...(mode ? { mode } : {}),
+});
+const emptyAssignments = () => ({
+    permissionSets: emptyCategory(),
+    permissionSetGroups: emptyCategory(),
+    publicGroups: emptyCategory(),
+    queues: emptyCategory(),
+});
+const summarize = (users) => ({
+    total: users.length,
+    compared: users.filter((user) => user.status === 'compared').length,
+    wouldCreate: users.filter((user) => user.status === 'would-create').length,
+    failed: users.filter((user) => user.status === 'failed').length,
+    changed: users.filter(hasChanges).length,
+});
+const hasCategoryChanges = (category) => category.adds.length > 0 || category.removes.length > 0;
+const hasChanges = (user) => user.status !== 'failed' &&
+    (!user.profile.matches ||
+        !user.role.matches ||
+        hasCategoryChanges(user.assignments.permissionSets) ||
+        hasCategoryChanges(user.assignments.permissionSetGroups) ||
+        hasCategoryChanges(user.assignments.publicGroups) ||
+        hasCategoryChanges(user.assignments.queues));
+const rowsForUser = (user) => {
+    const rows = [];
+    const identity = { userName: user.userName ?? '', username: user.username ?? '' };
+    const pushCategory = (category, delta) => {
+        for (const kind of ['adds', 'removes', 'inBoth', 'onlyInOrg']) {
+            const rowKind = kind === 'adds' ? 'add' : kind === 'removes' ? 'remove' : kind;
+            for (const value of delta[kind]) {
+                rows.push({
+                    userKey: user.key,
+                    userId: user.id ?? '',
+                    ...identity,
+                    category,
+                    kind: rowKind,
+                    value,
+                    mode: delta.mode,
+                });
+            }
+        }
+    };
+    pushCategory('permissionSets', user.assignments.permissionSets);
+    pushCategory('permissionSetGroups', user.assignments.permissionSetGroups);
+    pushCategory('publicGroups', user.assignments.publicGroups);
+    pushCategory('queues', user.assignments.queues);
+    if (!user.profile.matches) {
+        rows.push({
+            userKey: user.key,
+            userId: user.id ?? '',
+            ...identity,
+            category: 'profile',
+            kind: 'profile',
+            value: `${user.profile.current ?? ''} -> ${user.profile.intended ?? ''}`,
+            valueBefore: user.profile.current ?? '',
+            valueAfter: user.profile.intended ?? '',
+        });
+    }
+    if (!user.role.matches) {
+        rows.push({
+            userKey: user.key,
+            userId: user.id ?? '',
+            ...identity,
+            category: 'role',
+            kind: 'role',
+            value: `${user.role.current ?? ''} -> ${user.role.intended ?? ''}`,
+            valueBefore: user.role.current ?? '',
+            valueAfter: user.role.intended ?? '',
+        });
+    }
+    for (const error of user.errors) {
+        rows.push({
+            ...identity,
+            userKey: user.key,
+            userId: user.id ?? '',
+            category: 'error',
+            kind: 'error',
+            value: error,
+        });
+    }
+    return rows;
+};
+const buildResult = (users, warnings = [], labels) => ({
+    summary: summarize(users),
+    users,
+    rows: users.flatMap(rowsForUser),
+    warnings,
+    labels,
+});
+const addSourceContext = (user, errors) => {
+    if (!user.source)
+        return errors;
+    const source = user.source;
+    return errors.map((error) => `${source.path}:${String(source.line)} — ${error}`);
+};
+const validationErrorsFor = (user) => addSourceContext(user, (user.validationErrors ?? []).map((error) => lifecycleMessage(error.code, error.messageArgs)));
+const findExisting = (user, target, defaultExternalIdField, existingByField) => {
+    const matchedBy = user.matchField ?? defaultExternalIdField ?? null;
+    const matchValue = matchedBy ? target[matchedBy] : undefined;
+    const existing = matchedBy && typeof matchValue === 'string' ? existingByField.get(matchedBy)?.get(matchValue) : undefined;
+    return { matchedBy, existing };
+};
+const makeProfileRole = (existing, target) => {
+    const intendedProfile = typeof target.ProfileId === 'string' ? target.ProfileId : null;
+    const intendedRole = typeof target.UserRoleId === 'string' ? target.UserRoleId : null;
+    return {
+        profile: {
+            current: existing?.ProfileId ?? null,
+            intended: intendedProfile,
+            matches: intendedProfile === null || (existing?.ProfileId ?? null) === intendedProfile,
+        },
+        role: {
+            current: existing?.UserRoleId ?? null,
+            intended: intendedRole,
+            matches: intendedRole === null || (existing?.UserRoleId ?? null) === intendedRole,
+        },
+    };
+};
+const addLabel = (labels, bundle) => {
+    const current = labels[bundle.id];
+    const merged = {
+        ...current,
+        ...bundle,
+        id: bundle.id,
+    };
+    if (bundle.apiName ?? current?.apiName)
+        merged.apiName = bundle.apiName ?? current?.apiName;
+    if (bundle.label ?? current?.label)
+        merged.label = bundle.label ?? current?.label;
+    if (bundle.type ?? current?.type)
+        merged.type = bundle.type ?? current?.type;
+    labels[bundle.id] = merged;
+};
+const addAssignmentLabels = (labels, psaRows, groupRows) => {
+    for (const row of psaRows) {
+        const bundle = permissionSetAssignmentLabel(row);
+        if (bundle)
+            addLabel(labels, bundle);
+    }
+    for (const row of groupRows)
+        addLabel(labels, groupMemberLabel(row));
+};
+export const displayName = (id, relationship) => relationship?.Name ?? id ?? '';
+const addProfileRoleLabels = (labels, states) => {
+    for (const state of states.values()) {
+        if (state.ProfileId)
+            addLabel(labels, { id: state.ProfileId, label: state.profileName, type: 'Profile' });
+        if (state.UserRoleId)
+            addLabel(labels, { id: state.UserRoleId, label: state.roleName, type: 'UserRole' });
+    }
+};
+const buildLabelMap = (refs, assignmentState, profileRoles) => {
+    const labels = {};
+    if (refs?.labels)
+        Object.assign(labels, refs.labels);
+    addAssignmentLabels(labels, [...assignmentState.psaByUserId.values()].flat(), [...assignmentState.groupByUserId.values()].flat());
+    addProfileRoleLabels(labels, profileRoles);
+    return labels;
+};
+const diffForMissingUser = (user, refs, target, matchedBy) => ({
+    key: user.inputKey,
+    userName: [user.fields.FirstName, user.fields.LastName]
+        .filter((value) => typeof value === 'string' && value.length > 0)
+        .join(' '),
+    username: typeof user.fields.Username === 'string' ? user.fields.Username : undefined,
+    personas: user.personas,
+    matchedBy,
+    status: 'would-create',
+    ...makeProfileRole(undefined, target),
+    assignments: computeAssignmentDeltaFromState(user.effectivePersona, refs, [], []),
+    errors: [],
+});
+export const executePersonaDiff = async (request) => {
+    const { connection: conn } = request;
+    let fieldMap;
+    let definitions;
+    if (request.usersDoc) {
+        definitions = await loadValidatedDefinitions(request, new Map(), diffDefinitionMessages);
+        fieldMap = await describeUserFields(conn);
+    }
+    else {
+        fieldMap = await describeUserFields(conn);
+        definitions = await loadValidatedDefinitions(request, fieldMap, diffDefinitionMessages);
+    }
+    const { usersDoc, personasDoc } = definitions;
+    const personasSupplied = request.personasSupplied ?? definitions.personasSupplied;
+    const personas = personasDoc.personas;
+    validatePersonaModes(personas);
+    validateExternalIdFieldForFlag(request.externalId, fieldMap);
+    const users = validateAndCanonicalizeUsers(usersDoc.users, personas, fieldMap, personasSupplied);
+    const defaultExternalIdField = request.externalId ? fieldMap.get(request.externalId.toLowerCase())?.name : undefined;
+    const validUsers = users.filter((user) => !user.validationErrors || user.validationErrors.length === 0);
+    const [refs, existingResolution] = await Promise.all([
+        resolveReferences(conn, personas, validUsers),
+        getExistingUsers(conn, validUsers, { defaultExternalIdField, fieldMap }),
+    ]);
+    const existingIds = [...existingResolution.existingByField.values()].flatMap((byValue) => [...byValue.values()].map((user) => user.Id));
+    const uniqueExistingIds = [...new Set(existingIds)];
+    const [existingProfileRoles, assignmentState] = await Promise.all([
+        queryUserRoles(conn, uniqueExistingIds),
+        loadAssignmentState(conn, uniqueExistingIds, { permissionSetAssignments: true, groupMemberships: true }),
+    ]);
+    const results = users.map((user) => {
+        const validationErrors = validationErrorsFor(user);
+        if (validationErrors.length > 0) {
+            return {
+                key: user.inputKey,
+                userName: [user.fields.FirstName, user.fields.LastName]
+                    .filter((value) => typeof value === 'string' && value.length > 0)
+                    .join(' '),
+                username: typeof user.fields.Username === 'string' ? user.fields.Username : undefined,
+                personas: user.personas,
+                matchedBy: user.matchField ?? null,
+                status: 'failed',
+                profile: { matches: true },
+                role: { matches: true },
+                assignments: emptyAssignments(),
+                errors: validationErrors,
+            };
+        }
+        const errors = [];
+        const target = buildTarget(user, refs, errors);
+        const { matchedBy, existing: existingMatch } = findExisting(user, target, defaultExternalIdField, existingResolution.existingByField);
+        const profileRole = existingMatch ? existingProfileRoles.get(existingMatch.Id) : undefined;
+        const existing = existingMatch ? { ...existingMatch, ...profileRole } : undefined;
+        const matchValue = matchedBy ? target[matchedBy] : undefined;
+        if (matchedBy &&
+            typeof matchValue === 'string' &&
+            existingResolution.duplicates.has(matchKey(matchedBy, matchValue))) {
+            errors.push(lifecycleMessage('errorDuplicateExternalIdMatch', [matchedBy, matchValue]));
+        }
+        if (errors.length > 0) {
+            return {
+                key: user.inputKey,
+                id: existing?.Id,
+                userName: existing?.Name,
+                username: existing?.Username,
+                personas: user.personas,
+                matchedBy,
+                status: 'failed',
+                ...makeProfileRole(existing, target),
+                assignments: emptyAssignments(),
+                errors: addSourceContext(user, errors),
+            };
+        }
+        if (!existing) {
+            return diffForMissingUser(user, refs, target, matchedBy);
+        }
+        const assignments = computeAssignmentDeltaFromState(user.effectivePersona, refs, assignmentState.psaByUserId.get(existing.Id) ?? [], assignmentState.groupByUserId.get(existing.Id) ?? []);
+        return {
+            key: user.inputKey,
+            id: existing.Id,
+            userName: existing.Name,
+            username: existing.Username,
+            personas: user.personas,
+            matchedBy,
+            status: 'compared',
+            ...makeProfileRole(existing, target),
+            assignments,
+            errors: [],
+        };
+    });
+    return buildResult(results, refs.warnings, buildLabelMap(refs, assignmentState, existingProfileRoles));
+};
+const queryUserRoles = async (conn, ids) => {
+    if (ids.length === 0)
+        return new Map();
+    const rowBatches = await Promise.all(batch([...new Set(ids)], QUERY_BATCH_SIZE).map(async (idBatch) => (await conn.query(`SELECT Id, ProfileId, Profile.Name, UserRoleId, UserRole.Name FROM User WHERE Id IN (${soqlIn(idBatch)})`)).records));
+    return new Map(rowBatches.flat().map((row) => [
+        row.Id,
+        {
+            ProfileId: row.ProfileId,
+            UserRoleId: row.UserRoleId,
+            profileName: displayName(row.ProfileId, row.Profile),
+            roleName: displayName(row.UserRoleId, row.UserRole),
+        },
+    ]));
+};
+const partitionIds = (currentIds, intendedIds, mode) => {
+    const current = new Set(currentIds);
+    const intended = new Set(intendedIds);
+    const extras = [...current].filter((id) => !intended.has(id));
+    const sorted = (ids) => ids.sort((a, b) => a.localeCompare(b));
+    const removes = mode === 'additive' ? [] : sorted(extras);
+    return {
+        adds: sorted([...intended].filter((id) => !current.has(id))),
+        removes,
+        inBoth: sorted([...intended].filter((id) => current.has(id))),
+        onlyInOrg: sorted(extras).filter((id) => !removes.includes(id)),
+        ...(mode ? { mode } : {}),
+    };
+};
+const loadCurrentAssignmentIds = (state, userId) => extractCurrentIds(state.psaByUserId.get(userId) ?? [], state.groupByUserId.get(userId) ?? []);
+const parseUserFlagOrThrow = (raw, code) => {
+    try {
+        return parseUserFlag(raw);
+    }
+    catch {
+        throw new LifecycleError(code, lifecycleMessage(code, [raw]), { raw });
+    }
+};
+export const executeUserToUserDiff = async (request) => {
+    const { connection: conn } = request;
+    const fieldMap = await describeUserFields(conn);
+    const parsedUser = parseUserFlagOrThrow(request.user, 'errorInvalidUserValue');
+    const parsedAgainst = parseUserFlagOrThrow(request.against, 'errorInvalidAgainstValue');
+    const userField = resolveTargetField(parsedUser.field, fieldMap);
+    const againstField = resolveTargetField(parsedAgainst.field, fieldMap);
+    if (!userField)
+        throw new LifecycleError('errorInvalidUserMatchField', lifecycleMessage('errorInvalidUserMatchField', [parsedUser.field]));
+    if (!againstField)
+        throw new LifecycleError('errorInvalidAgainstMatchField', lifecycleMessage('errorInvalidAgainstMatchField', [parsedAgainst.field]));
+    const { targets, errors } = await resolveTargets(conn, [
+        { key: `${userField}:${parsedUser.value}`, field: userField, value: parsedUser.value, order: 0 },
+        { key: `${againstField}:${parsedAgainst.value}`, field: againstField, value: parsedAgainst.value, order: 1 },
+    ], fieldMap);
+    if (errors.length > 0) {
+        return buildResult(errors.map((error) => ({
+            key: error.key,
+            id: undefined,
+            userName: '',
+            username: '',
+            matchedBy: error.field,
+            status: 'failed',
+            profile: { matches: true },
+            role: { matches: true },
+            assignments: emptyAssignments(),
+            errors: [error.message],
+        })), [], {});
+    }
+    const target = targets[0];
+    const against = targets[1];
+    const state = await loadAssignmentState(conn, [target.Id, against.Id], {
+        permissionSetAssignments: true,
+        groupMemberships: true,
+    });
+    const profilesById = await queryUserRoles(conn, [target.Id, against.Id]);
+    const targetAssignments = loadCurrentAssignmentIds(state, target.Id);
+    const againstAssignments = loadCurrentAssignmentIds(state, against.Id);
+    const userProfile = profilesById.get(target.Id);
+    const againstProfile = profilesById.get(against.Id);
+    const result = {
+        key: target.key,
+        id: target.Id,
+        userName: target.name,
+        username: target.username,
+        matchedBy: target.field,
+        status: 'compared',
+        profile: {
+            current: userProfile?.ProfileId ?? null,
+            intended: againstProfile?.ProfileId ?? null,
+            matches: (userProfile?.ProfileId ?? null) === (againstProfile?.ProfileId ?? null),
+        },
+        role: {
+            current: userProfile?.UserRoleId ?? null,
+            intended: againstProfile?.UserRoleId ?? null,
+            matches: (userProfile?.UserRoleId ?? null) === (againstProfile?.UserRoleId ?? null),
+        },
+        assignments: {
+            permissionSets: partitionIds(targetAssignments.permissionSets, againstAssignments.permissionSets),
+            permissionSetGroups: partitionIds(targetAssignments.permissionSetGroups, againstAssignments.permissionSetGroups),
+            publicGroups: partitionIds(targetAssignments.publicGroups, againstAssignments.publicGroups),
+            queues: partitionIds(targetAssignments.queues, againstAssignments.queues),
+        },
+        errors: [],
+    };
+    return buildResult([result], [], buildLabelMap(undefined, state, profilesById));
+};
+//# sourceMappingURL=userDiff.js.map

package/lib/lifecycle/userDiff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userDiff.js","sourceRoot":"","sources":["../../src/lifecycle/userDiff.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,4BAA4B,EAC5B,8BAA8B,EAC9B,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAqB,MAAM,yCAAyC,CAAC;AAC9F,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EACL,+BAA+B,EAC/B,iBAAiB,GAIlB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,wBAAwB,GAGzB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,4BAA4B,GAG7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEnF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,sBAAsB,GAAuB;IACjD,wBAAwB,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,+BAA+B,CAAC;IACjF,yBAAyB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,gCAAgC,EAAE,CAAC,OAAO,CAAC,CAAC;IACrG,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;CAClF,CAAC;AAoDF,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,aAAa,GAAG,CAAC,IAA0B,EAA2B,EAAE,CAAC,CAAC;IAC9E,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,EAAE;IACX,MAAM,EAAE,EAAE;IACV,SAAS,EAAE,EAAE;IACb,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CAC1B,CAAC,CAAC;AACH,MAAM,gBAAgB,GAAG,GAAoB,EAAE,CAAC,CAAC;IAC/C,cAAc,EAAE,aAAa,EAAE;IAC/B,mBAAmB,EAAE,aAAa,EAAE;IACpC,YAAY,EAAE,aAAa,EAAE;IAC7B,MAAM,EAAE,aAAa,EAAE;CACxB,CAAC,CAAC;AACH,MAAM,SAAS,GAAG,CAAC,KAA2B,EAA6B,EAAE,CAAC,CAAC;IAC7E,KAAK,EAAE,KAAK,CAAC,MAAM;IACnB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,MAAM;IACnE,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,cAAc,CAAC,CAAC,MAAM;IAC1E,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM;IAC/D,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM;CACzC,CAAC,CAAC;AACH,MAAM,kBAAkB,GAAG,CAAC,QAAiC,EAAW,EAAE,CACxE,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;AAC1D,MAAM,UAAU,GAAG,CAAC,IAAwB,EAAW,EAAE,CACvD,IAAI,CAAC,MAAM,KAAK,QAAQ;IACxB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO;QACpB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO;QAClB,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;QACnD,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC;QACxD,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC;QACjD,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AACjD,MAAM,WAAW,GAAG,CAAC,IAAwB,EAAiB,EAAE;IAC9D,MAAM,IAAI,GAAkB,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;IAClF,MAAM,YAAY,GAAG,CAAC,QAA+B,EAAE,KAA8B,EAAQ,EAAE;QAC7F,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAU,EAAE,CAAC;YACvE,MAAM,OAAO,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;YAC/E,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC,IAAI,CAAC;oBACR,OAAO,EAAE,IAAI,CAAC,GAAG;oBACjB,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;oBACrB,GAAG,QAAQ;oBACX,QAAQ;oBACR,IAAI,EAAE,OAAO;oBACb,KAAK;oBACL,IAAI,EAAE,KAAK,CAAC,IAAI;iBACjB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,YAAY,CAAC,gBAAgB,EAAE,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAChE,YAAY,CAAC,qBAAqB,EAAE,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAC1E,YAAY,CAAC,cAAc,EAAE,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAC5D,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC;YACR,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;YACrB,GAAG,QAAQ;YACX,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,EAAE;YACxE,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE;YACvC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE;SACxC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC;YACR,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;YACrB,GAAG,QAAQ;YACX,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE;YAClE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE;YACpC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE;SACrC,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC;YACR,GAAG,QAAQ;YACX,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;YACrB,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AACF,MAAM,WAAW,GAAG,CAAC,KAA2B,EAAE,WAAqB,EAAE,EAAE,MAAiB,EAAkB,EAAE,CAAC,CAAC;IAChH,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC;IACzB,KAAK;IACL,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;IAChC,QAAQ;IACR,MAAM;CACP,CAAC,CAAC;AACH,MAAM,gBAAgB,GAAG,CAAC,IAAuB,EAAE,MAAgB,EAAY,EAAE;IAC/E,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;AACnF,CAAC,CAAC;AACF,MAAM,mBAAmB,GAAG,CAAC,IAAuB,EAAY,EAAE,CAChE,gBAAgB,CACd,IAAI,EACJ,CAAC,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAC9F,CAAC;AACJ,MAAM,YAAY,GAAG,CACnB,IAAuB,EACvB,MAAkB,EAClB,sBAA0C,EAC1C,eAAuD,EACA,EAAE;IACzD,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,IAAI,sBAAsB,IAAI,IAAI,CAAC;IACpE,MAAM,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,MAAM,QAAQ,GACZ,SAAS,IAAI,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5G,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AACjC,CAAC,CAAC;AACF,MAAM,eAAe,GAAG,CACtB,QAA4C,EAC5C,MAAkB,EACuB,EAAE;IAC3C,MAAM,eAAe,GAAG,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IACvF,MAAM,YAAY,GAAG,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IACtF,OAAO;QACL,OAAO,EAAE;YACP,OAAO,EAAE,QAAQ,EAAE,SAAS,IAAI,IAAI;YACpC,QAAQ,EAAE,eAAe;YACzB,OAAO,EAAE,eAAe,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,SAAS,IAAI,IAAI,CAAC,KAAK,eAAe;SACvF;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,QAAQ,EAAE,UAAU,IAAI,IAAI;YACrC,QAAQ,EAAE,YAAY;YACtB,OAAO,EAAE,YAAY,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,UAAU,IAAI,IAAI,CAAC,KAAK,YAAY;SAClF;KACF,CAAC;AACJ,CAAC,CAAC;AACF,MAAM,QAAQ,GAAG,CAAC,MAAgB,EAAE,MAAmB,EAAQ,EAAE;IAC/D,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,MAAM,GAAgB;QAC1B,GAAG,OAAO;QACV,GAAG,MAAM;QACT,EAAE,EAAE,MAAM,CAAC,EAAE;KACd,CAAC;IACF,IAAI,MAAM,CAAC,OAAO,IAAI,OAAO,EAAE,OAAO;QAAE,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,OAAO,EAAE,OAAO,CAAC;IAC5F,IAAI,MAAM,CAAC,KAAK,IAAI,OAAO,EAAE,KAAK;QAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,OAAO,EAAE,KAAK,CAAC;IAClF,IAAI,MAAM,CAAC,IAAI,IAAI,OAAO,EAAE,IAAI;QAAE,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,OAAO,EAAE,IAAI,CAAC;IAC7E,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;AAC7B,CAAC,CAAC;AACF,MAAM,mBAAmB,GAAG,CAC1B,MAAgB,EAChB,OAAqC,EACrC,SAA2B,EACrB,EAAE;IACR,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,4BAA4B,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,MAAM;YAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,SAAS;QAAE,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;AACvE,CAAC,CAAC;AAOF,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,EAA6B,EAC7B,YAAkD,EAC1C,EAAE,CAAC,YAAY,EAAE,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC;AAC5C,MAAM,oBAAoB,GAAG,CAAC,MAAgB,EAAE,MAAqC,EAAQ,EAAE;IAC7F,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,SAAS;YAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAC1G,IAAI,KAAK,CAAC,UAAU;YAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5G,CAAC;AACH,CAAC,CAAC;AACF,MAAM,aAAa,GAAG,CACpB,IAA8B,EAC9B,eAAgE,EAChE,YAA2C,EACjC,EAAE;IACZ,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,IAAI,EAAE,MAAM;QAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACrD,mBAAmB,CACjB,MAAM,EACN,CAAC,GAAG,eAAe,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,EAChD,CAAC,GAAG,eAAe,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CACnD,CAAC;IACF,oBAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC3C,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AACF,MAAM,kBAAkB,GAAG,CACzB,IAAuB,EACvB,IAAkB,EAClB,MAAkB,EAClB,SAAwB,EACJ,EAAE,CAAC,CAAC;IACxB,GAAG,EAAE,IAAI,CAAC,QAAQ;IAClB,QAAQ,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;SACpD,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;SACjF,IAAI,CAAC,GAAG,CAAC;IACZ,QAAQ,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;IACrF,QAAQ,EAAE,IAAI,CAAC,QAAQ;IACvB,SAAS;IACT,MAAM,EAAE,cAAc;IACtB,GAAG,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC;IACrC,WAAW,EAAE,+BAA+B,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC;IACjF,MAAM,EAAE,EAAE;CACX,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,OAA2B,EAA2B,EAAE;IAC/F,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACrC,IAAI,QAAoC,CAAC;IACzC,IAAI,WAAyC,CAAC;IAC9C,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,WAAW,GAAG,MAAM,wBAAwB,CAAC,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,sBAAsB,CAAC,CAAC;QACzF,QAAQ,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC1C,WAAW,GAAG,MAAM,wBAAwB,CAAC,OAAO,EAAE,QAAQ,EAAE,sBAAsB,CAAC,CAAC;IAC1F,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,WAAW,CAAC;IAC9C,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,WAAW,CAAC,gBAAgB,CAAC;IAClF,MAAM,QAAQ,GAAG,WAAW,CAAC,QAA6C,CAAC;IAC3E,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/B,8BAA8B,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,4BAA4B,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IACjG,MAAM,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACrH,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;IACxG,MAAM,CAAC,IAAI,EAAE,kBAAkB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACnD,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC;QAC7C,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,sBAAsB,EAAE,QAAQ,EAAE,CAAC;KACzE,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,CAAC,GAAG,kBAAkB,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CACvF,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAC7C,CAAC;IACF,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;IACpD,MAAM,CAAC,oBAAoB,EAAE,eAAe,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAChE,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC;QACvC,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,EAAE,EAAE,wBAAwB,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;KACzG,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAsB,EAAE;QACrD,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO;gBACL,GAAG,EAAE,IAAI,CAAC,QAAQ;gBAClB,QAAQ,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;qBACpD,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;qBACjF,IAAI,CAAC,GAAG,CAAC;gBACZ,QAAQ,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;gBACrF,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,SAAS,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI;gBAClC,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;gBAC1B,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;gBACvB,WAAW,EAAE,gBAAgB,EAAE;gBAC/B,MAAM,EAAE,gBAAgB;aACzB,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC/C,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,YAAY,CACzD,IAAI,EACJ,MAAM,EACN,sBAAsB,EACtB,kBAAkB,CAAC,eAAe,CACnC,CAAC;QACF,MAAM,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3F,MAAM,QAAQ,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,aAAa,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAClF,MAAM,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7D,IACE,SAAS;YACT,OAAO,UAAU,KAAK,QAAQ;YAC9B,kBAAkB,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,EAClE,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,+BAA+B,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1F,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO;gBACL,GAAG,EAAE,IAAI,CAAC,QAAQ;gBAClB,EAAE,EAAE,QAAQ,EAAE,EAAE;gBAChB,QAAQ,EAAE,QAAQ,EAAE,IAAI;gBACxB,QAAQ,EAAE,QAAQ,EAAE,QAAQ;gBAC5B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,SAAS;gBACT,MAAM,EAAE,QAAQ;gBAChB,GAAG,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACpC,WAAW,EAAE,gBAAgB,EAAE;gBAC/B,MAAM,EAAE,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC;aACvC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,WAAW,GAAG,+BAA+B,CACjD,IAAI,CAAC,gBAAgB,EACrB,IAAI,EACJ,eAAe,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,EAClD,eAAe,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CACrD,CAAC;QACF,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,QAAQ;YAClB,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,QAAQ,EAAE,QAAQ,CAAC,IAAI;YACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS;YACT,MAAM,EAAE,UAAU;YAClB,GAAG,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC;YACpC,WAAW;YACX,MAAM,EAAE,EAAE;SACX,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE,oBAAoB,CAAC,CAAC,CAAC;AACzG,CAAC,CAAC;AACF,MAAM,cAAc,GAAG,KAAK,EAAE,IAAgB,EAAE,GAAa,EAA0C,EAAE;IACvG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,GAAG,EAAE,CAAC;IACvC,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAClC,KAAK,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,GAAG,CAC5C,KAAK,EAAE,OAAO,EAAE,EAAE,CAChB,CACE,MAAM,IAAI,CAAC,KAAK,CAMb,wFAAwF,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAC/G,CAAC,OAAO,CACZ,CACF,CAAC;IACF,OAAO,IAAI,GAAG,CACZ,UAAU,CAAC,IAAI,EAAE,CAAC,GAAG,CACnB,CAAC,GAAG,EAAE,EAAE,CACN;QACE,GAAG,CAAC,EAAE;QACN;YACE,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC;YACpD,QAAQ,EAAE,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC;SACpD;KAC4B,CAClC,CACF,CAAC;AACJ,CAAC,CAAC;AACF,MAAM,YAAY,GAAG,CACnB,UAAoB,EACpB,WAAqB,EACrB,IAAsC,EACb,EAAE;IAC3B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,CAAC,GAAa,EAAY,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1D,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5D,OAAO;QACP,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7D,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC/D,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1B,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAC/B,KAAsD,EACtD,MAAc,EACQ,EAAE,CACxB,iBAAiB,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAChG,MAAM,oBAAoB,GAAG,CAC3B,GAAW,EACX,IAA0D,EACxB,EAAE;IACpC,IAAI,CAAC;QACH,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACzE,CAAC;AACH,CAAC,CAAC;AACF,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EAAE,OAAwB,EAA2B,EAAE;IAC/F,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACrC,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;IAC/E,MAAM,aAAa,GAAG,oBAAoB,CAAC,OAAO,CAAC,OAAO,EAAE,0BAA0B,CAAC,CAAC;IACxF,MAAM,SAAS,GAAG,kBAAkB,CAAC,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,kBAAkB,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACvE,IAAI,CAAC,SAAS;QACZ,MAAM,IAAI,cAAc,CACtB,4BAA4B,EAC5B,gBAAgB,CAAC,4BAA4B,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CACnE,CAAC;IACJ,IAAI,CAAC,YAAY;QACf,MAAM,IAAI,cAAc,CACtB,+BAA+B,EAC/B,gBAAgB,CAAC,+BAA+B,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CACzE,CAAC;IACJ,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,cAAc,CAC9C,IAAI,EACJ;QACE,EAAE,GAAG,EAAE,GAAG,SAAS,IAAI,UAAU,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE;QAChG,EAAE,GAAG,EAAE,GAAG,YAAY,IAAI,aAAa,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE;KAC7G,EACD,QAAQ,CACT,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,WAAW,CAChB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,EAAE,EAAE,SAAS;YACb,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,EAAE;YACZ,SAAS,EAAE,KAAK,CAAC,KAAK;YACtB,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;YAC1B,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;YACvB,WAAW,EAAE,gBAAgB,EAAE;YAC/B,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;SACxB,CAAC,CAAC,EACH,EAAE,EACF,EAAE,CACH,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE;QACrE,wBAAwB,EAAE,IAAI;QAC9B,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IACzE,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACrE,MAAM,kBAAkB,GAAG,wBAAwB,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACvE,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChD,MAAM,cAAc,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpD,MAAM,MAAM,GAAuB;QACjC,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,QAAQ,EAAE,MAAM,CAAC,IAAI;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,KAAK;QACvB,MAAM,EAAE,UAAU;QAClB,OAAO,EAAE;YACP,OAAO,EAAE,WAAW,EAAE,SAAS,IAAI,IAAI;YACvC,QAAQ,EAAE,cAAc,EAAE,SAAS,IAAI,IAAI;YAC3C,OAAO,EAAE,CAAC,WAAW,EAAE,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,SAAS,IAAI,IAAI,CAAC;SAClF;QACD,IAAI,EAAE;YACJ,OAAO,EAAE,WAAW,EAAE,UAAU,IAAI,IAAI;YACxC,QAAQ,EAAE,cAAc,EAAE,UAAU,IAAI,IAAI;YAC5C,OAAO,EAAE,CAAC,WAAW,EAAE,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,UAAU,IAAI,IAAI,CAAC;SACpF;QACD,WAAW,EAAE;YACX,cAAc,EAAE,YAAY,CAAC,iBAAiB,CAAC,cAAc,EAAE,kBAAkB,CAAC,cAAc,CAAC;YACjG,mBAAmB,EAAE,YAAY,CAAC,iBAAiB,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,mBAAmB,CAAC;YAChH,YAAY,EAAE,YAAY,CAAC,iBAAiB,CAAC,YAAY,EAAE,kBAAkB,CAAC,YAAY,CAAC;YAC3F,MAAM,EAAE,YAAY,CAAC,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC;SAC1E;QACD,MAAM,EAAE,EAAE;KACX,CAAC;IACF,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,aAAa,CAAC,SAAS,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC"}

package/lib/matching/index.d.ts

@@ -0,0 +1,53 @@
+import type { Connection } from '@salesforce/core';
+export type UserFieldMeta = {
+    name: string;
+    createable: boolean;
+    updateable: boolean;
+    filterable: boolean;
+    /** Field-read access when describe metadata supplies it. */
+    readable?: boolean;
+    externalId?: boolean;
+    /** Salesforce `unique` field metadata. Paired with `externalId` when validating match fields. */
+    unique?: boolean;
+    /** Whether Salesforce compares values for this field with case sensitivity. */
+    caseSensitive?: boolean;
+    isBoolean?: boolean;
+};
+export type ExistingUser = {
+    Id: string;
+    IsActive?: boolean;
+    Name?: string;
+    Username?: string;
+    Email?: string;
+    ProfileId?: string | null;
+    Profile?: {
+        Name?: string;
+    } | null;
+    UserRoleId?: string | null;
+    UserRole?: {
+        Name?: string;
+    } | null;
+};
+export type UserMatchRequest = {
+    field: string;
+    value: string;
+    fuzzy?: boolean;
+    key?: string;
+};
+export type ExistingUserResolution = {
+    existingByField: Map<string, Map<string, ExistingUser>>;
+    duplicates: Set<string>;
+    matchesByRequest: Map<string, ExistingUser[]>;
+};
+export declare const matchKey: (field: string, value: string) => string;
+/**
+ * The value a match request would actually be issued under, or `null` when there is none.
+ *
+ * `getExistingUsers` issues no request for a non-string or empty value, so reporting one as
+ * a `matchValue` would name a lookup that never happened. Whitespace is deliberately not
+ * trimmed: a whitespace-only value *is* queried, and can match.
+ */
+export declare const usableMatchValue: (value: unknown) => string | null;
+export declare const validateMatchField: (field: string, fieldMap: Map<string, UserFieldMeta>) => UserFieldMeta;
+export declare const escapeSoqlLike: (value: string) => string;
+export declare const resolveExistingUsers: (conn: Connection, requests: UserMatchRequest[], fieldMap: Map<string, UserFieldMeta>) => Promise<ExistingUserResolution>;

package/lib/matching/index.js

@@ -0,0 +1,181 @@
+import { esc, soqlIn } from '../shared/sfUtils.js';
+const MATCH_QUERY_MAX_LENGTH = 18_000;
+export const matchKey = (field, value) => `${field}:${value}`;
+/**
+ * The value a match request would actually be issued under, or `null` when there is none.
+ *
+ * `getExistingUsers` issues no request for a non-string or empty value, so reporting one as
+ * a `matchValue` would name a lookup that never happened. Whitespace is deliberately not
+ * trimmed: a whitespace-only value *is* queried, and can match.
+ */
+export const usableMatchValue = (value) => typeof value === 'string' && value.length > 0 ? value : null;
+export const validateMatchField = (field, fieldMap) => {
+    const meta = fieldMap.get(field.toLowerCase());
+    if (!meta || !meta.filterable)
+        throw new Error(`Invalid match field "${field}".`);
+    return meta;
+};
+export const escapeSoqlLike = (value) => value.replaceAll('\\', '\\\\\\\\').replaceAll('%', '\\%').replaceAll('_', '\\_').replaceAll("'", "\\'");
+const batchesByQueryLength = (values, render, prefixLength, suffixLength = 0) => {
+    const batches = [];
+    let current = [];
+    let currentLength = prefixLength + suffixLength;
+    for (const value of values) {
+        const renderedLength = render(value).length;
+        const nextLength = currentLength + (current.length > 0 ? 1 : 0) + renderedLength;
+        if (current.length > 0 && nextLength > MATCH_QUERY_MAX_LENGTH) {
+            batches.push(current);
+            current = [];
+            currentLength = prefixLength + suffixLength;
+        }
+        current.push(value);
+        currentLength += (current.length > 1 ? 1 : 0) + renderedLength;
+    }
+    if (current.length > 0)
+        batches.push(current);
+    return batches;
+};
+const distinctUsers = (rows) => {
+    const seen = new Set();
+    return rows.filter((row) => {
+        if (seen.has(row.Id))
+            return false;
+        seen.add(row.Id);
+        return true;
+    });
+};
+const requestKey = (request) => request.key ?? matchKey(request.field, request.value);
+const selectUserFields = (matchField) => {
+    const fields = [
+        'Id',
+        'IsActive',
+        'Name',
+        'Username',
+        'Email',
+        'ProfileId',
+        'Profile.Name',
+        'UserRoleId',
+        'UserRole.Name',
+    ];
+    if (!fields.some((field) => field.toLowerCase() === matchField.toLowerCase()))
+        fields.push(matchField);
+    return fields;
+};
+const toExistingUser = (row) => ({
+    Id: row.Id,
+    IsActive: row.IsActive,
+    Name: row.Name,
+    Username: row.Username,
+    Email: row.Email,
+    ProfileId: row.ProfileId,
+    Profile: row.Profile,
+    UserRoleId: row.UserRoleId,
+    UserRole: row.UserRole,
+});
+const addRequestMatches = (matchesByRequest, request, matches) => {
+    matchesByRequest.set(requestKey(request), matches);
+};
+export const resolveExistingUsers = async (conn, requests, fieldMap) => {
+    const existingByField = new Map();
+    const duplicates = new Set();
+    const matchesByRequest = new Map();
+    const exactByField = new Map();
+    const fuzzyUsernameRequests = requests.filter((request) => request.fuzzy === true && request.field === 'Username');
+    for (const request of requests) {
+        if (request.field !== 'Id')
+            validateMatchField(request.field, fieldMap);
+        if (request.fuzzy === true && request.field === 'Username')
+            continue;
+        const group = exactByField.get(request.field) ?? [];
+        group.push(request);
+        exactByField.set(request.field, group);
+    }
+    const exactQueries = Promise.all([...exactByField.entries()].map(async ([field, fieldRequests]) => {
+        const values = [...new Set(fieldRequests.map((request) => request.value))];
+        if (values.length === 0)
+            return;
+        const prefix = `SELECT ${selectUserFields(field).join(', ')} FROM User WHERE ${field} IN (`;
+        const chunks = batchesByQueryLength(values, (value) => `'${esc(value)}'`, prefix.length, 1);
+        const rows = (await Promise.all(chunks.map(async (chunk) => (await conn.query(`${prefix}${soqlIn(chunk)})`)).records))).flat();
+        const fieldMatches = new Map();
+        const exactMatchesByRequest = new Map();
+        const exactDuplicates = new Set();
+        for (const request of fieldRequests) {
+            const matches = distinctUsers(rows
+                .filter((row) => String(row[field] ?? '').toLowerCase() === request.value.toLowerCase())
+                .map(toExistingUser));
+            addRequestMatches(exactMatchesByRequest, request, matches);
+            if (matches.length > 1)
+                exactDuplicates.add(matchKey(field, request.value));
+            else if (matches.length === 1)
+                fieldMatches.set(request.value, matches[0]);
+        }
+        return {
+            existingByField: new Map([[field, fieldMatches]]),
+            duplicates: exactDuplicates,
+            matchesByRequest: exactMatchesByRequest,
+        };
+    }));
+    const fuzzyQuery = (async () => {
+        if (fuzzyUsernameRequests.length === 0)
+            return;
+        const bases = [...new Set(fuzzyUsernameRequests.map((request) => request.value))];
+        const renderClause = (base) => `(Username = '${esc(base)}' OR Username LIKE '${escapeSoqlLike(base)}.%')`;
+        const prefix = `SELECT ${selectUserFields('Username').join(', ')} FROM User WHERE `;
+        const chunks = batchesByQueryLength(bases, renderClause, prefix.length);
+        const rows = (await Promise.all(chunks.map(async (chunk) => (await conn.query(`${prefix}${chunk.map(renderClause).join(' OR ')}`)).records))).flat();
+        const fieldMatches = new Map();
+        const fuzzyMatchesByRequest = new Map();
+        const fuzzyDuplicates = new Set();
+        const rowsByBase = new Map();
+        const basesByRowId = new Map();
+        for (const base of bases) {
+            const normalizedBase = base.toLowerCase();
+            const matches = distinctUsers(rows
+                .filter((row) => {
+                const username = row.Username?.toLowerCase() ?? '';
+                return username === normalizedBase || username.startsWith(`${normalizedBase}.`);
+            })
+                .map(toExistingUser));
+            rowsByBase.set(base, matches);
+            for (const match of matches) {
+                const matchingBases = basesByRowId.get(match.Id) ?? new Set();
+                matchingBases.add(base);
+                basesByRowId.set(match.Id, matchingBases);
+            }
+        }
+        for (const base of bases) {
+            const matches = rowsByBase.get(base) ?? [];
+            for (const request of fuzzyUsernameRequests.filter((candidate) => candidate.value === base)) {
+                addRequestMatches(fuzzyMatchesByRequest, request, matches);
+            }
+            const matchesAnotherBase = matches.some((match) => (basesByRowId.get(match.Id)?.size ?? 0) > 1);
+            if (matches.length > 1 || matchesAnotherBase)
+                fuzzyDuplicates.add(matchKey('Username', base));
+            else if (matches.length === 1)
+                fieldMatches.set(base, matches[0]);
+        }
+        return {
+            existingByField: new Map([['Username', fieldMatches]]),
+            duplicates: fuzzyDuplicates,
+            matchesByRequest: fuzzyMatchesByRequest,
+        };
+    })();
+    const [exactResolutions, fuzzyResolution] = await Promise.all([exactQueries, fuzzyQuery]);
+    for (const resolution of [...exactResolutions, fuzzyResolution]) {
+        if (!resolution)
+            continue;
+        for (const [field, fieldMatches] of resolution.existingByField) {
+            const mergedFieldMatches = existingByField.get(field) ?? new Map();
+            for (const [value, user] of fieldMatches)
+                mergedFieldMatches.set(value, user);
+            existingByField.set(field, mergedFieldMatches);
+        }
+        for (const duplicate of resolution.duplicates)
+            duplicates.add(duplicate);
+        for (const [key, matches] of resolution.matchesByRequest)
+            matchesByRequest.set(key, matches);
+    }
+    return { existingByField, duplicates, matchesByRequest };
+};
+//# sourceMappingURL=index.js.map