@syntax-syllogism/warden-core 0.2.0

package/lib/provisioning/planner.js

@@ -0,0 +1,407 @@
+import { validateMatchField } from '../matching/index.js';
+import { getCsvRowInfo } from '../shared/csv.js';
+export const modeKeys = ['permissionSetMode', 'permissionSetGroupMode', 'publicGroupMode', 'queueMode'];
+export const assignmentListKeys = ['permissionSets', 'permissionSetGroups', 'publicGroups', 'queues'];
+const reservedUserKeys = new Set(['personas', 'match', 'profile', 'role', 'fuzzyusername', 'related']);
+/**
+ * Lightweight shape check only.
+ * Callers should apply object-specific Id prefix filtering at use sites.
+ */
+export const isSalesforceId = (value) => /^[a-zA-Z0-9]{3}[a-zA-Z0-9]{12}(?:[a-zA-Z0-9]{3})?$/.test(value);
+export const normalizeMode = (value) => {
+    if (value === undefined)
+        return 'additive';
+    if (value === 'additive' || value === 'sync')
+        return value;
+    throw new Error(`Invalid assignment mode "${String(value)}". Expected additive or sync.`);
+};
+export const buildFieldMap = (fields) => {
+    const map = new Map();
+    for (const field of fields)
+        map.set(field.name.toLowerCase(), field);
+    return map;
+};
+export const canonicalizeFieldObject = (source, fieldMap, context) => {
+    if (!source)
+        return {};
+    const output = {};
+    for (const [rawKey, value] of Object.entries(source)) {
+        const meta = fieldMap.get(rawKey.toLowerCase());
+        if (!meta)
+            throw new Error(`${context}: unknown User field "${rawKey}".`);
+        output[meta.name] = value;
+    }
+    return output;
+};
+export const validateExternalIdField = (externalId, fieldMap) => validateMatchField(externalId, fieldMap);
+export const validateExternalIdFieldForFlag = (externalId, fieldMap) => {
+    if (!externalId)
+        return undefined;
+    try {
+        return validateExternalIdField(externalId, fieldMap);
+    }
+    catch {
+        throw new Error(`Invalid --external-id field "${externalId}". Must be a filterable User field.`);
+    }
+};
+const buildValidationError = (code, messageArgs) => ({
+    code,
+    messageArgs,
+});
+const resolveUserMatchField = (rawMatch, merged, fieldMap) => {
+    if (rawMatch === undefined)
+        return { validationErrors: [] };
+    if (typeof rawMatch !== 'string') {
+        return {
+            validationErrors: [buildValidationError('errorInvalidUserMatchField', [String(rawMatch)])],
+        };
+    }
+    try {
+        const meta = validateExternalIdField(rawMatch, fieldMap);
+        const matchField = meta.name;
+        const matchValue = merged[matchField];
+        if (typeof matchValue !== 'string' || matchValue.length === 0) {
+            return {
+                matchField,
+                validationErrors: [buildValidationError('errorUserMatchFieldEmpty', [matchField])],
+            };
+        }
+        return { matchField, validationErrors: [] };
+    }
+    catch {
+        return {
+            validationErrors: [buildValidationError('errorInvalidUserMatchField', [rawMatch])],
+        };
+    }
+};
+export const mergeUserFields = (personaUserAttributes, userFields) => ({
+    ...personaUserAttributes,
+    ...userFields,
+});
+const unionArray = (arrays) => {
+    const seen = new Set();
+    const result = [];
+    for (const arr of arrays) {
+        for (const item of arr ?? []) {
+            if (!seen.has(item)) {
+                seen.add(item);
+                result.push(item);
+            }
+        }
+    }
+    return result;
+};
+// Extracted to keep mergePersonas under the eslint complexity ceiling (max 20).
+const mergePersonaAttributes = (validDefs, userOverrideFields, fieldMap) => {
+    const attrMap = new Map();
+    const attrConflicts = new Set();
+    for (const def of validDefs) {
+        for (const [rawKey, value] of Object.entries(def.userAttributes ?? {})) {
+            const canonicalKey = fieldMap.get(rawKey.toLowerCase())?.name ?? rawKey;
+            if (attrMap.has(canonicalKey) && attrMap.get(canonicalKey) !== value) {
+                attrConflicts.add(canonicalKey);
+            }
+            else {
+                attrMap.set(canonicalKey, value);
+            }
+        }
+    }
+    const errors = [];
+    for (const conflictKey of attrConflicts) {
+        if (!(conflictKey in userOverrideFields)) {
+            errors.push(buildValidationError('errorPersonaConflictUserAttribute', [conflictKey]));
+        }
+    }
+    return { userAttributes: attrMap.size > 0 ? Object.fromEntries(attrMap) : undefined, errors };
+};
+export const mergePersonas = (names, personas, userOverrideFields, fieldMap, hasProfileOverride = false, hasRoleOverride = false) => {
+    const errors = [];
+    const validDefs = [];
+    for (const name of names) {
+        const def = personas[name];
+        if (!def) {
+            errors.push(buildValidationError('errorUnknownPersona', [name]));
+        }
+        else {
+            validDefs.push(def);
+        }
+    }
+    const effective = {};
+    // Union assignment lists
+    for (const listKey of assignmentListKeys) {
+        const unioned = unionArray(validDefs.map((d) => d[listKey]));
+        if (unioned.length > 0)
+            effective[listKey] = unioned;
+    }
+    // Singular: profile
+    const profiles = [...new Set(validDefs.map((d) => d.profile).filter((v) => Boolean(v)))];
+    if (profiles.length > 1 && !hasProfileOverride) {
+        errors.push(buildValidationError('errorPersonaConflictProfile', [profiles.join(', ')]));
+    }
+    else if (profiles.length === 1) {
+        effective.profile = profiles[0];
+    }
+    // Singular: role
+    const roles = [...new Set(validDefs.map((d) => d.role).filter((v) => Boolean(v)))];
+    if (roles.length > 1 && !hasRoleOverride) {
+        errors.push(buildValidationError('errorPersonaConflictRole', [roles.join(', ')]));
+    }
+    else if (roles.length === 1) {
+        effective.role = roles[0];
+    }
+    // Modes
+    for (const modeKey of modeKeys) {
+        const modes = [...new Set(validDefs.map((d) => d[modeKey]).filter((v) => v !== undefined))];
+        if (modes.length > 1) {
+            errors.push(buildValidationError('errorPersonaConflictMode', [modeKey]));
+        }
+        else if (modes.length === 1) {
+            effective[modeKey] = modes[0];
+        }
+    }
+    const { userAttributes, errors: attrErrors } = mergePersonaAttributes(validDefs, userOverrideFields, fieldMap);
+    errors.push(...attrErrors);
+    if (userAttributes)
+        effective.userAttributes = userAttributes;
+    return { effective, errors };
+};
+const sanitizeAliasPart = (s) => (typeof s === 'string' ? s : '').replace(/[^a-z0-9]/gi, '');
+export const buildDefaultAlias = (firstName, lastName) => {
+    const first = sanitizeAliasPart(firstName);
+    const last = sanitizeAliasPart(lastName);
+    if (!first && !last)
+        return undefined;
+    const firstDeficit = Math.max(0, 3 - first.length);
+    const lastDeficit = Math.max(0, 3 - last.length);
+    const firstPart = first.slice(0, 3 + lastDeficit);
+    const lastPart = last.slice(0, 3 + firstDeficit);
+    const alias = (firstPart + lastPart).toLowerCase().slice(0, 8);
+    return alias || undefined;
+};
+export const buildDefaultUsername = (email, myDomain) => typeof email === 'string' && email.length > 0 ? `${email}.${myDomain}` : undefined;
+export const deriveMyDomain = (instanceUrl) => {
+    try {
+        const host = new URL(instanceUrl).hostname;
+        const firstLabel = host.split('.')[0];
+        return firstLabel || undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+const resolveInputKey = (fields, fallback) => (typeof fields.FederationIdentifier === 'string' && fields.FederationIdentifier) ||
+    (typeof fields.Username === 'string' && fields.Username) ||
+    (typeof fields.Email === 'string' && fields.Email) ||
+    fallback;
+export const findFirstUserWithPersonas = (rawUsers) => {
+    if (!Array.isArray(rawUsers))
+        return undefined;
+    const identityFields = ['FederationIdentifier', 'Username', 'Email'];
+    for (const [index, rawUser] of rawUsers.entries()) {
+        if (!rawUser || typeof rawUser !== 'object')
+            continue;
+        const input = rawUser;
+        const personasKey = Object.keys(input).find((key) => key.toLowerCase() === 'personas');
+        if (!personasKey)
+            continue;
+        for (const identityField of identityFields) {
+            const fieldKey = Object.keys(input).find((key) => key.toLowerCase() === identityField.toLowerCase());
+            const value = fieldKey ? input[fieldKey] : undefined;
+            if (typeof value === 'string' && value.length > 0)
+                return value;
+        }
+        return String(index + 1);
+    }
+    return undefined;
+};
+// Reads a user-level profile/role meta key. Empty/whitespace and null are treated as
+// "not provided"; any other non-string value is reported so malformed input is not silently dropped.
+const extractUserRef = (value, invalidKey, errors) => {
+    if (value === null || value === undefined)
+        return undefined;
+    if (typeof value !== 'string') {
+        errors.push(buildValidationError(invalidKey, [String(value)]));
+        return undefined;
+    }
+    return value.trim() === '' ? undefined : value;
+};
+// Reads the user-level `related` meta key. Every problem is per-user: one row carrying a
+// stale `related` key must not abort a batch that otherwise does not use the feature.
+const resolveRelatedSelection = (rawRelated, related, errors) => {
+    if (rawRelated === null || rawRelated === undefined)
+        return undefined;
+    if (!Array.isArray(rawRelated) || rawRelated.some((name) => typeof name !== 'string')) {
+        errors.push(buildValidationError('errorInvalidRelatedKey', [JSON.stringify(rawRelated) ?? String(rawRelated)]));
+        return undefined;
+    }
+    const names = rawRelated;
+    if (names.length === 0)
+        return [];
+    if (!related?.catalogSupplied) {
+        errors.push(buildValidationError('errorRelatedWithoutCatalog', []));
+        return undefined;
+    }
+    const seen = new Set();
+    const selected = [];
+    for (const name of names) {
+        if (seen.has(name)) {
+            errors.push(buildValidationError('errorDuplicateRelationshipSelection', [name]));
+            continue;
+        }
+        seen.add(name);
+        if (!related.names.has(name)) {
+            errors.push(buildValidationError('errorUnknownRelationship', [name]));
+            continue;
+        }
+        selected.push(name);
+    }
+    return selected;
+};
+const attachCsvSource = (user, input) => {
+    const source = getCsvRowInfo(input);
+    if (source)
+        Object.defineProperty(user, 'source', { value: source, enumerable: false });
+    return user;
+};
+const canonicalizeValidUser = (input, names, personas, fieldMap, fallback, related) => {
+    const candidateFields = {};
+    const errors = [];
+    let profileRef;
+    let roleRef;
+    for (const [k, v] of Object.entries(input)) {
+        const lower = k.toLowerCase();
+        if (lower === 'profile')
+            profileRef = extractUserRef(v, 'errorInvalidUserProfile', errors);
+        else if (lower === 'role')
+            roleRef = extractUserRef(v, 'errorInvalidUserRole', errors);
+        else if (!reservedUserKeys.has(lower))
+            candidateFields[k] = v;
+    }
+    const userFields = canonicalizeFieldObject(candidateFields, fieldMap, `user personas=${names.join('+')}`);
+    if (profileRef !== undefined && 'ProfileId' in userFields) {
+        errors.push(buildValidationError('errorUserProfileConflict', []));
+        profileRef = undefined;
+    }
+    if (roleRef !== undefined && 'UserRoleId' in userFields) {
+        errors.push(buildValidationError('errorUserRoleConflict', []));
+        roleRef = undefined;
+    }
+    // A raw ProfileId/UserRoleId is also a user-level override, so it must suppress
+    // a persona profile/role conflict the same way the profile/role meta keys do.
+    const hasProfileOverride = profileRef !== undefined || 'ProfileId' in userFields;
+    const hasRoleOverride = roleRef !== undefined || 'UserRoleId' in userFields;
+    const { effective, errors: mergeErrors } = mergePersonas(names, personas, userFields, fieldMap, hasProfileOverride, hasRoleOverride);
+    const personaFields = canonicalizeFieldObject(effective.userAttributes, fieldMap, 'effective persona');
+    const merged = mergeUserFields(personaFields, userFields);
+    const rawMatch = Object.entries(input).find(([k]) => k.toLowerCase() === 'match')?.[1];
+    const { matchField, validationErrors: matchErrors } = resolveUserMatchField(rawMatch, merged, fieldMap);
+    const rawFuzzy = Object.entries(input).find(([k]) => k.toLowerCase() === 'fuzzyusername')?.[1];
+    let fuzzyUsername;
+    if (rawFuzzy === undefined || typeof rawFuzzy === 'boolean') {
+        fuzzyUsername = rawFuzzy;
+    }
+    else {
+        const displayValue = typeof rawFuzzy === 'string' ? rawFuzzy : JSON.stringify(rawFuzzy) ?? typeof rawFuzzy;
+        errors.push(buildValidationError('errorInvalidFuzzyUsername', [displayValue]));
+    }
+    const rawRelated = Object.entries(input).find(([k]) => k.toLowerCase() === 'related')?.[1];
+    const relatedErrors = [];
+    const selectedRelated = resolveRelatedSelection(rawRelated, related, relatedErrors);
+    const allErrors = [...errors, ...mergeErrors, ...matchErrors, ...relatedErrors];
+    const result = {
+        inputKey: resolveInputKey(merged, names.length > 0 ? `${names.join('+')}:${fallback}` : fallback),
+        personas: names,
+        effectivePersona: effective,
+        profileRef,
+        roleRef,
+        matchField,
+        fuzzyUsername,
+        related: selectedRelated,
+        fields: merged,
+        validationErrors: allErrors.length > 0 ? allErrors : undefined,
+    };
+    return attachCsvSource(result, input);
+};
+export const validateAndCanonicalizeUsers = (rawUsers, personas, fieldMap, personasSupplied = true, related) => {
+    if (!Array.isArray(rawUsers))
+        throw new Error('user-def.json must contain a users array.');
+    const users = [];
+    for (const rawUser of rawUsers) {
+        if (!rawUser || typeof rawUser !== 'object')
+            throw new Error('Each user entry must be an object.');
+        const input = rawUser;
+        const fallback = String(users.length + 1);
+        const hasLegacyPersonaKey = Object.keys(input).some((k) => k.toLowerCase() === 'persona');
+        if (hasLegacyPersonaKey) {
+            const fields = {};
+            for (const [k, v] of Object.entries(input)) {
+                if (k.toLowerCase() !== 'persona')
+                    fields[k] = v;
+            }
+            const userFields = canonicalizeFieldObject(fields, fieldMap, 'user');
+            users.push(attachCsvSource({
+                inputKey: resolveInputKey(userFields, `unknown:${fallback}`),
+                personas: [],
+                effectivePersona: {},
+                fields: userFields,
+                validationErrors: [buildValidationError('errorLegacyPersonaKey', [])],
+            }, input));
+            continue;
+        }
+        const personaNames = input.personas;
+        const validNames = Array.isArray(personaNames) && personaNames.length > 0 && personaNames.every((n) => typeof n === 'string');
+        if (!validNames) {
+            if (!personasSupplied) {
+                users.push(canonicalizeValidUser(input, [], personas, fieldMap, fallback, related));
+                continue;
+            }
+            const fields = {};
+            for (const [k, v] of Object.entries(input)) {
+                if (!reservedUserKeys.has(k.toLowerCase()))
+                    fields[k] = v;
+            }
+            const userFields = canonicalizeFieldObject(fields, fieldMap, 'user');
+            users.push(attachCsvSource({
+                inputKey: resolveInputKey(userFields, `unknown:${fallback}`),
+                personas: [],
+                effectivePersona: {},
+                fields: userFields,
+                validationErrors: [buildValidationError('errorNoPersonas', [])],
+            }, input));
+            continue;
+        }
+        users.push(canonicalizeValidUser(input, personaNames, personas, fieldMap, fallback, related));
+    }
+    return users;
+};
+export const validatePersonaModes = (personas) => {
+    for (const [personaKey, persona] of Object.entries(personas)) {
+        for (const modeKey of modeKeys)
+            normalizeMode(persona[modeKey]);
+        for (const listKey of assignmentListKeys) {
+            const candidate = persona[listKey];
+            if (candidate !== undefined && !Array.isArray(candidate)) {
+                throw new Error(`Persona "${personaKey}" has non-array ${listKey}.`);
+            }
+        }
+    }
+};
+export const practicalRequiredUserFields = [
+    'Username',
+    'LastName',
+    'Alias',
+    'TimeZoneSidKey',
+    'LocaleSidKey',
+    'EmailEncodingKey',
+    'LanguageLocaleKey',
+];
+// `profileIntended` is true when a profile was specified from any source (user `profile` meta key,
+// raw `ProfileId`, or persona `profile`). When intended but unresolved, buildTarget already reports a
+// reference-missing error, so we must not also report ProfileId as missing here (avoids a double error).
+export const missingRequiredFieldsForInsert = (fields, profileIntended) => {
+    const missing = practicalRequiredUserFields.filter((field) => !fields[field]);
+    if (!profileIntended && !fields.ProfileId)
+        missing.push('ProfileId');
+    return missing;
+};
+//# sourceMappingURL=planner.js.map

package/lib/provisioning/planner.js.map

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

package/lib/provisioning/provisionUserUseCase.d.ts

@@ -0,0 +1,52 @@
+import type { Connection } from '@salesforce/core';
+import { type ExistingUser } from '../matching/index.js';
+export type { ExistingUser } from '../matching/index.js';
+import { CanonicalizedUser, UserFieldMeta } from './planner.js';
+import { type PermissionSetLicenseSummary, type UserLicenseUsage } from './licenseUsage.js';
+import { type UserResult } from './userPlan.js';
+export type { OrderedUserResult, UserPlan, UserResult } from './userPlan.js';
+export type { PermissionSetLicenseSummary, UserLicenseUsage } from './licenseUsage.js';
+type JsonRecord = Record<string, unknown>;
+export type ProvisionResult = {
+    summary: {
+        total: number;
+        created: number;
+        updated: number;
+        failed: number;
+        warnings: number;
+    };
+    users: UserResult[];
+    licenses?: UserLicenseUsage[];
+    permissionSetLicenses?: PermissionSetLicenseSummary;
+};
+export type ExistingUserMatchOptions = {
+    defaultExternalIdField?: string;
+    defaultFuzzyUsername?: boolean;
+    fieldMap: Map<string, UserFieldMeta>;
+};
+export declare const getExistingUsers: (conn: Connection, users: CanonicalizedUser[], options: ExistingUserMatchOptions) => Promise<{
+    existingByField: Map<string, Map<string, ExistingUser>>;
+    duplicates: Set<string>;
+}>;
+export type ProvisionUserRequest = {
+    connection: Connection;
+    usersDoc?: JsonRecord;
+    personasDoc?: JsonRecord;
+    usersPath?: string;
+    personasPath?: string;
+    inputFormat?: 'json' | 'csv';
+    csvListDelimiter?: string;
+    externalId?: string;
+    fuzzyUsername?: boolean;
+    dryRun: boolean;
+    personasSupplied?: boolean;
+    relatedDoc?: JsonRecord;
+    relatedPath?: string;
+    acknowledgeWarnings?: (warnings: string[]) => Promise<void>;
+};
+export declare class ProvisionUserUseCase {
+    private readonly userProcessConcurrency;
+    private runDryRun;
+    private runLive;
+    execute(request: ProvisionUserRequest): Promise<ProvisionResult>;
+}