@syntax-syllogism/warden-core 0.2.0

package/lib/lifecycle/diffOutput.js

@@ -0,0 +1,94 @@
+import { serializeCsv } from '../shared/csv.js';
+export const renderUserDiffCsv = (result) => {
+    const header = [
+        'userKey',
+        'userId',
+        'category',
+        'kind',
+        'value',
+        'mode',
+        'userName',
+        'username',
+        'valueApiName',
+        'valueLabel',
+        'valueType',
+        'valueBefore',
+        'valueAfter',
+    ];
+    return serializeCsv(result.rows.map((row) => {
+        const label = result.labels?.[row.value] ?? (row.valueAfter ? result.labels?.[row.valueAfter] : undefined);
+        return {
+            userKey: row.userKey,
+            userId: row.userId,
+            category: row.category,
+            kind: row.kind,
+            value: row.value,
+            mode: row.mode ?? '',
+            userName: row.userName ?? '',
+            username: row.username ?? '',
+            valueApiName: label?.apiName ?? '',
+            valueLabel: label?.label ?? '',
+            valueType: label?.type ?? '',
+            valueBefore: row.valueBefore ?? '',
+            valueAfter: row.valueAfter ?? '',
+        };
+    }), header);
+};
+export const displayValue = (result, value) => result.labels?.[value]
+    ? result.labels[value].apiName &&
+        result.labels[value].label &&
+        result.labels[value].apiName !== result.labels[value].label
+        ? `${result.labels[value].apiName} (${result.labels[value].label})`
+        : result.labels[value].apiName ?? result.labels[value].label ?? value
+    : value;
+const renderFieldDiff = (result, label, field) => field.matches
+    ? undefined
+    : `  ${label}: ${displayValue(result, field.current ?? '')} -> ${displayValue(result, field.intended ?? '')}`;
+const renderCategoryDiff = (result, label, delta, verbose) => {
+    if (delta.adds.length === 0 &&
+        delta.removes.length === 0 &&
+        delta.inBoth.length === 0 &&
+        delta.onlyInOrg.length === 0) {
+        return [];
+    }
+    const lines = [`  ${label}${delta.mode ? ` (${delta.mode})` : ''}:`];
+    for (const value of delta.adds)
+        lines.push(`    + ${displayValue(result, value)}`);
+    for (const value of delta.removes)
+        lines.push(`    - ${displayValue(result, value)}`);
+    if (verbose)
+        for (const value of delta.inBoth)
+            lines.push(`    = ${displayValue(result, value)}`);
+    // onlyInOrg is exclusive of removes by construction.
+    for (const value of delta.onlyInOrg) {
+        lines.push(`    extra ${displayValue(result, value)}`);
+    }
+    return lines;
+};
+export const renderUserDiffHuman = (result, lookup, options = {}) => {
+    const lines = [
+        lookup('info.summary', [
+            String(result.summary.total),
+            String(result.summary.changed),
+            String(result.summary.failed),
+        ]),
+    ];
+    for (const warning of result.warnings)
+        lines.push(`warning: ${warning}`);
+    for (const user of result.users) {
+        lines.push('', `${user.key}${user.id ? ` (${user.id})` : ''}: ${user.status}`);
+        for (const error of user.errors)
+            lines.push(`  error: ${error}`);
+        const profileLine = renderFieldDiff(result, 'profile', user.profile);
+        const roleLine = renderFieldDiff(result, 'role', user.role);
+        if (profileLine)
+            lines.push(profileLine);
+        if (roleLine)
+            lines.push(roleLine);
+        for (const [label, delta] of Object.entries(user.assignments)) {
+            lines.push(...renderCategoryDiff(result, label, delta, options.verbose === true));
+        }
+    }
+    return lines.join('\n');
+};
+//# sourceMappingURL=diffOutput.js.map

package/lib/lifecycle/diffOutput.js.map

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

package/lib/lifecycle/dmlRunner.d.ts

@@ -0,0 +1,30 @@
+import type { Connection } from '@salesforce/core';
+import type { LabelBundle, LifecycleUserResult } from './types.js';
+export type AssignmentSObject = 'PermissionSetAssignment' | 'GroupMember' | 'PermissionSetLicenseAssign';
+/** Record a successful step without downgrading an already-failed result. */
+export declare const markSuccess: (result: LifecycleUserResult, actionKey: string, count?: number, items?: LabelBundle[]) => void;
+export declare const runAssignmentCreates: (options: {
+    conn: Connection;
+    result: LifecycleUserResult;
+    sobject: AssignmentSObject;
+    rows: Array<Record<string, string>>;
+    actionKey: string;
+    items: LabelBundle[];
+}) => Promise<void>;
+export declare const runAssignmentDeletes: (options: {
+    conn: Connection;
+    result: LifecycleUserResult;
+    sobject: AssignmentSObject;
+    ids: string[];
+    actionKey: string;
+    items: LabelBundle[];
+}) => Promise<void>;
+export declare const runRecordUpdate: (options: {
+    conn: Connection;
+    result: LifecycleUserResult;
+    sobject: "User" | "UserLogin";
+    rows: Array<{
+        Id: string;
+    } & Record<string, unknown>>;
+    actionKey: string;
+}) => Promise<void>;

package/lib/lifecycle/dmlRunner.js

@@ -0,0 +1,45 @@
+import { asArray, pushErrors } from '../shared/sfUtils.js';
+import { makeNotice } from './output.js';
+/** Record a successful step without downgrading an already-failed result. */
+export const markSuccess = (result, actionKey, count, items) => {
+    if (result.status !== 'failed')
+        result.status = 'changed';
+    result.actions.push(makeNotice(actionKey, count, items));
+};
+const recordAssignmentResults = (result, saveResults, items, actionKey) => {
+    const successfulItems = items.filter((_, index) => saveResults[index]?.success);
+    if (successfulItems.length > 0)
+        markSuccess(result, actionKey, successfulItems.length, successfulItems);
+    // Keep strip's immediate failure behavior so later sequential steps observe the failure.
+    if (successfulItems.length < items.length) {
+        result.status = 'failed';
+        pushErrors(result.errors, saveResults);
+    }
+};
+export const runAssignmentCreates = async (options) => {
+    const { conn, result, sobject, rows, actionKey, items } = options;
+    if (rows.length === 0)
+        return;
+    const saveResults = asArray(await conn.sobject(sobject).create(rows, { allOrNone: false }));
+    recordAssignmentResults(result, saveResults, items, actionKey);
+};
+export const runAssignmentDeletes = async (options) => {
+    const { conn, result, sobject, ids, actionKey, items } = options;
+    if (ids.length === 0)
+        return;
+    const saveResults = asArray(await conn.sobject(sobject).delete(ids, { allOrNone: false }));
+    recordAssignmentResults(result, saveResults, items, actionKey);
+};
+export const runRecordUpdate = async (options) => {
+    const { conn, result, sobject, rows, actionKey } = options;
+    if (rows.length === 0)
+        return;
+    const saveResults = asArray(await conn.sobject(sobject).update(rows, { allOrNone: false }));
+    if (saveResults.some((saveResult) => saveResult.success))
+        markSuccess(result, actionKey);
+    if (saveResults.some((saveResult) => !saveResult.success)) {
+        result.status = 'failed';
+        pushErrors(result.errors, saveResults);
+    }
+};
+//# sourceMappingURL=dmlRunner.js.map

package/lib/lifecycle/dmlRunner.js.map

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

package/lib/lifecycle/errors.d.ts

@@ -0,0 +1,5 @@
+import { WardenError } from '../errors.js';
+export type LifecycleErrorCode = 'errorInvalidJson' | 'errorInvalidUserMatchField' | 'errorInvalidUserValue' | 'errorInvalidAgainstValue' | 'errorInvalidAgainstMatchField' | 'errorInvalidSnapshot' | 'errorPromptDeclined';
+export declare class LifecycleError extends WardenError<LifecycleErrorCode> {
+    constructor(code: LifecycleErrorCode, message: string, data?: unknown);
+}

package/lib/lifecycle/errors.js

@@ -0,0 +1,8 @@
+import { WardenError } from '../errors.js';
+export class LifecycleError extends WardenError {
+    constructor(code, message, data) {
+        super(code, message, data);
+        this.name = 'LifecycleError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/lib/lifecycle/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lifecycle/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAW3C,MAAM,OAAO,cAAe,SAAQ,WAA+B;IACjE,YAAmB,IAAwB,EAAE,OAAe,EAAE,IAAc;QAC1E,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}

package/lib/lifecycle/freezeState.d.ts

@@ -0,0 +1,28 @@
+import type { Connection } from '@salesforce/core';
+import type { UserFieldMeta } from '../provisioning/planner.js';
+import type { UserLoginRow } from './assignmentState.js';
+import type { LifecycleResult, TargetError, TargetRequest } from './types.js';
+export type FreezeDirection = {
+    /** Value written to UserLogin.IsFrozen. */
+    targetState: boolean;
+    /** True when the user is already in targetState and no DML is needed. */
+    isAlreadyInState: (row: UserLoginRow) => boolean;
+    alreadyKey: string;
+    wouldKey: string;
+    actionKey: string;
+};
+export declare const FREEZE: FreezeDirection;
+export declare const UNFREEZE: FreezeDirection;
+export declare const executeFreezeToggle: (options: {
+    conn: Connection;
+    fieldMap: Map<string, UserFieldMeta>;
+    requests: TargetRequest[];
+    requestErrors: TargetError[];
+    direction: FreezeDirection;
+    dryRun: boolean;
+    noPrompt: boolean;
+    interactive: boolean;
+    message?: (key: string, args?: string[]) => string;
+    confirm: (message: string) => Promise<boolean>;
+    warn: (message: string) => void;
+}) => Promise<LifecycleResult>;

package/lib/lifecycle/freezeState.js

@@ -0,0 +1,88 @@
+import { asArray, esc, pushErrors } from '../shared/sfUtils.js';
+import { confirmWithTimeout } from '../shared/prompt.js';
+import { failedResult, makeNotice, resolvedTargetResult, summarizeLifecycle } from './output.js';
+import { resolveTargets } from './targeting.js';
+import { LifecycleError } from './errors.js';
+import { lifecycleMessage } from './messages.js';
+export const FREEZE = {
+    targetState: true,
+    isAlreadyInState: (row) => row.IsFrozen,
+    alreadyKey: 'alreadyFrozen',
+    wouldKey: 'wouldFreeze',
+    actionKey: 'frozen',
+};
+export const UNFREEZE = {
+    targetState: false,
+    isAlreadyInState: (row) => !row.IsFrozen,
+    alreadyKey: 'alreadyUnfrozen',
+    wouldKey: 'wouldUnfreeze',
+    actionKey: 'unfrozen',
+};
+export const executeFreezeToggle = async (options) => {
+    const { conn, fieldMap, requests, requestErrors, direction, dryRun, noPrompt, interactive, message = lifecycleMessage, confirm, warn, } = options;
+    const { targets, errors: resolutionErrors } = await resolveTargets(conn, requests, fieldMap);
+    const results = [];
+    for (const error of requestErrors.concat(resolutionErrors))
+        results.push(failedResult(error));
+    const loginRows = targets.length > 0
+        ? (await conn.query(`SELECT Id, UserId, IsFrozen FROM UserLogin WHERE UserId IN (${targets
+            .map((target) => `'${esc(target.Id)}'`)
+            .join(',')})`)).records
+        : [];
+    const loginRowsByUserId = new Map();
+    for (const row of loginRows)
+        loginRowsByUserId.set(row.UserId, row);
+    const pendingUpdates = [];
+    for (const target of targets) {
+        const resultIndex = results.length;
+        const loginRow = loginRowsByUserId.get(target.Id);
+        const result = resolvedTargetResult(target, loginRow);
+        if (!loginRow) {
+            result.warnings.push(message('warningMissingUserLogin'));
+            results.push(result);
+            continue;
+        }
+        if (direction.isAlreadyInState(loginRow)) {
+            result.actions.push(makeNotice(direction.alreadyKey));
+            results.push(result);
+            continue;
+        }
+        if (dryRun) {
+            result.status = 'planned';
+            result.actions.push(makeNotice(direction.wouldKey));
+            results.push(result);
+            continue;
+        }
+        pendingUpdates.push({
+            resultIndex,
+            row: { Id: loginRow.Id, IsFrozen: direction.targetState },
+            actionKey: direction.actionKey,
+        });
+        results.push(result);
+    }
+    if (!dryRun && pendingUpdates.length > 0 && !noPrompt && interactive) {
+        const { confirmed, timedOut } = await confirmWithTimeout(confirm, message('promptContinue'));
+        if (!confirmed) {
+            if (timedOut)
+                warn(message('warningPromptTimeout'));
+            throw new LifecycleError('errorPromptDeclined', message('errorPromptDeclined'));
+        }
+    }
+    if (!dryRun && pendingUpdates.length > 0) {
+        const updateResults = asArray(await conn.sobject('UserLogin').update(pendingUpdates.map((pending) => pending.row), { allOrNone: false }));
+        updateResults.forEach((saveResult, index) => {
+            const pending = pendingUpdates[index];
+            const result = results[pending.resultIndex];
+            if (saveResult.success) {
+                result.status = 'changed';
+                result.actions.push(makeNotice(pending.actionKey));
+            }
+            else {
+                result.status = 'failed';
+                pushErrors(result.errors, saveResult);
+            }
+        });
+    }
+    return { summary: summarizeLifecycle(results), users: results };
+};
+//# sourceMappingURL=freezeState.js.map

package/lib/lifecycle/freezeState.js.map

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

package/lib/lifecycle/messages.d.ts

@@ -0,0 +1 @@
+export declare const lifecycleMessage: (code: string, args?: string[]) => string;

package/lib/lifecycle/messages.js

@@ -0,0 +1,20 @@
+const TEXT = {
+    errorInvalidJson: 'Failed to parse JSON file %s: %s',
+    errorInvalidPersonaDefinition: 'persona-def.json must contain a personas object.',
+    errorPersonasWithoutDefinition: 'User "%s" lists personas but no --personas-def was supplied.',
+    errorInvalidAgainstMatchField: 'Invalid against match field "%s".',
+    errorInvalidUserValue: 'Invalid --user value "%s". Expected field:value.',
+    errorInvalidAgainstValue: 'Invalid --against value "%s". Expected field:value.',
+    errorInvalidUserMatchField: 'Invalid user match field "%s".',
+    errorDuplicateExternalIdMatch: 'Multiple users matched %s="%s".',
+    errorPromptDeclined: 'Operation cancelled.',
+    warningPromptTimeout: 'Warning confirmation timed out after 10 seconds.',
+    warningMissingUserLogin: 'No UserLogin row was found for this user.',
+    promptContinue: 'Continue with this operation?',
+};
+export const lifecycleMessage = (code, args = []) => {
+    const template = TEXT[code] ?? code;
+    let index = 0;
+    return template.replaceAll('%s', () => args[index++] ?? '');
+};
+//# sourceMappingURL=messages.js.map

package/lib/lifecycle/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/lifecycle/messages.ts"],"names":[],"mappings":"AAAA,MAAM,IAAI,GAA2B;IACnC,gBAAgB,EAAE,kCAAkC;IACpD,6BAA6B,EAAE,kDAAkD;IACjF,8BAA8B,EAAE,8DAA8D;IAC9F,6BAA6B,EAAE,mCAAmC;IAClE,qBAAqB,EAAE,kDAAkD;IACzE,wBAAwB,EAAE,qDAAqD;IAC/E,0BAA0B,EAAE,gCAAgC;IAC5D,6BAA6B,EAAE,iCAAiC;IAChE,mBAAmB,EAAE,sBAAsB;IAC3C,oBAAoB,EAAE,kDAAkD;IACxE,uBAAuB,EAAE,2CAA2C;IACpE,cAAc,EAAE,+BAA+B;CAChD,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,OAAiB,EAAE,EAAU,EAAE;IAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IACpC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC,CAAC"}

package/lib/lifecycle/output.d.ts

@@ -0,0 +1,23 @@
+import type { UserLoginRow } from './assignmentState.js';
+import type { LabelBundle, LifecycleNotice, LifecycleResult, LifecycleSummary, LifecycleUserResult, ResolvedTargetUser, TargetError } from './types.js';
+export declare const makeNotice: (key: string, count?: number, items?: LabelBundle[]) => LifecycleNotice;
+/** `planned` counts as changed: a dry run reports what would change. */
+export declare const summarizeLifecycle: (users: LifecycleUserResult[]) => LifecycleSummary;
+export declare const failedResult: (error: TargetError) => LifecycleUserResult;
+export declare const resolvedTargetResult: (target: ResolvedTargetUser, loginRow?: Pick<UserLoginRow, "IsFrozen">) => LifecycleUserResult;
+export type LifecycleCsvRow = {
+    userKey: string;
+    userId: string;
+    userName: string;
+    username: string;
+    status: string;
+    wasFrozen: string;
+    action: string;
+    category: string;
+    name: string;
+    error: string;
+    itemId: string;
+    itemApiName: string;
+};
+export declare const lifecycleToCsvRows: (result: LifecycleResult) => LifecycleCsvRow[];
+export declare const renderLifecycleResult: (result: LifecycleResult, lookup: (key: string, args?: string[]) => string) => string;

package/lib/lifecycle/output.js

@@ -0,0 +1,148 @@
+const sortItems = (items) => [...items].sort((left, right) => (left.apiName ?? left.label ?? left.id).localeCompare(right.apiName ?? right.label ?? right.id));
+export const makeNotice = (key, count, items) => ({
+    key,
+    ...(count === undefined ? {} : { count }),
+    ...(items && items.length > 0 ? { items: sortItems(items) } : {}),
+});
+/** `planned` counts as changed: a dry run reports what would change. */
+export const summarizeLifecycle = (users) => ({
+    total: users.length,
+    changed: users.filter((user) => user.status === 'changed' || user.status === 'planned').length,
+    unchanged: users.filter((user) => user.status === 'unchanged').length,
+    failed: users.filter((user) => user.status === 'failed').length,
+});
+export const failedResult = (error) => ({
+    key: error.key,
+    status: 'failed',
+    actions: [],
+    skipped: [],
+    warnings: [],
+    errors: [error.message],
+});
+export const resolvedTargetResult = (target, loginRow) => ({
+    key: target.key,
+    id: target.Id,
+    name: target.name,
+    username: target.username,
+    isActive: target.IsActive,
+    isFrozen: loginRow?.IsFrozen,
+    status: 'unchanged',
+    actions: [],
+    skipped: [],
+    warnings: [],
+    errors: [],
+});
+const emptyLifecycleCsvRow = (user) => ({
+    userKey: user.key,
+    userId: user.id ?? '',
+    userName: user.name ?? '',
+    username: user.username ?? '',
+    status: user.status,
+    wasFrozen: user.isFrozen === undefined ? '' : String(user.isFrozen),
+    action: '',
+    category: '',
+    name: '',
+    error: '',
+    itemId: '',
+    itemApiName: '',
+});
+const itemName = (item) => item.apiName ?? item.label ?? item.id;
+export const lifecycleToCsvRows = (result) => {
+    const rows = [];
+    for (const user of result.users) {
+        const base = emptyLifecycleCsvRow(user);
+        for (const action of user.actions) {
+            const items = action.items ? sortItems(action.items) : [];
+            if (items.length === 0) {
+                rows.push({ ...base, action: action.key });
+                continue;
+            }
+            for (const item of items) {
+                rows.push({
+                    ...base,
+                    action: action.key,
+                    category: item.type ?? '',
+                    name: itemName(item),
+                    itemId: item.id,
+                    itemApiName: item.apiName ?? '',
+                });
+            }
+        }
+        for (const error of user.errors)
+            rows.push({ ...base, error });
+        if (user.actions.length === 0 && user.errors.length === 0)
+            rows.push(base);
+    }
+    return rows;
+};
+const renderLabelBundle = (item) => {
+    if (item.apiName && item.label && item.apiName !== item.label)
+        return `${item.apiName} (${item.label})`;
+    return item.apiName ?? item.label ?? item.id;
+};
+const renderNoticeLines = (notice, lookup) => [
+    lookup(notice.key, notice.count === undefined ? [] : [String(notice.count)]),
+    ...(notice.items ?? []).map((item) => `    · ${renderLabelBundle(item)}`),
+];
+const renderUserIdentity = (user) => user.name && user.username && user.id ? `${user.name} <${user.username}> · ${user.id}` : undefined;
+const renderMatchProvenance = (user) => {
+    const match = user.key.replace(':', ' = ');
+    const state = user.isFrozen ? 'frozen' : user.isActive === false ? 'inactive' : 'active';
+    return `  matched ${match} · was ${state}`;
+};
+const renderReviewIdentity = (identity, includeId = false) => {
+    const name = identity.name ?? identity.username ?? identity.email ?? '(unknown)';
+    const address = identity.username ?? identity.email;
+    const person = address && identity.name ? `${name} <${address}>` : name;
+    return `${person}${includeId && 'userId' in identity ? `  ${identity.userId}` : ''}`;
+};
+export const renderLifecycleResult = (result, lookup) => {
+    const userSuffix = result.summary.total === 1 ? '' : 's';
+    const lines = [
+        lookup('info.summary', [
+            String(result.summary.total),
+            userSuffix,
+            String(result.summary.changed),
+            String(result.summary.unchanged),
+            String(result.summary.failed),
+        ]),
+    ];
+    for (const user of result.users) {
+        lines.push('');
+        const identity = renderUserIdentity(user);
+        if (identity) {
+            lines.push(identity);
+            lines.push(renderMatchProvenance(user));
+        }
+        else {
+            lines.push(`${user.key}${user.id ? ` (${user.id})` : ''}: ${user.status}`);
+        }
+        if (user.identityReview) {
+            lines.push(`  snapshot: ${renderReviewIdentity(user.identityReview.snapshot)}  (${user.identityReview.match.field} = ${user.identityReview.match.value})`);
+            lines.push(`  org:      ${renderReviewIdentity(user.identityReview.org, true)}`);
+            for (const field of ['profile', 'role']) {
+                const snapshotValue = user.identityReview.snapshot[field];
+                const orgValue = user.identityReview.org[field];
+                if (snapshotValue !== undefined || orgValue !== undefined) {
+                    lines.push(`  ${field}: ${snapshotValue ?? '(missing)'} → ${orgValue ?? '(missing)'}  (reported, not applied)`);
+                }
+            }
+        }
+        for (const warning of user.warnings)
+            lines.push(`  warning: ${warning}`);
+        for (const skipped of user.skipped) {
+            const [summary, ...items] = renderNoticeLines(skipped, lookup);
+            lines.push(`  skipped: ${summary}`);
+            lines.push(...items);
+        }
+        for (const action of user.actions) {
+            const [summary, ...items] = renderNoticeLines(action, lookup);
+            lines.push(`  action: ${summary}`);
+            lines.push(...items);
+        }
+        for (const error of user.errors)
+            lines.push(`  error: ${error}`);
+    }
+    return lines.join('\n');
+};
+//# sourceMappingURL=output.js.map

package/lib/lifecycle/output.js.map

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

package/lib/lifecycle/snapshotState.d.ts

@@ -0,0 +1,12 @@
+import type { Connection } from '@salesforce/core';
+import type { UserSnapshotEntry, UserSnapshotFile } from '../spec/snapshot.js';
+import type { ResolvedTargetUser } from './types.js';
+import type { AssignmentState } from './assignmentState.js';
+export type { UserSnapshotEntry, UserSnapshotFile };
+export declare const buildSnapshotFile: (conn: Connection, targets: ResolvedTargetUser[], state: AssignmentState, org?: string) => Promise<UserSnapshotFile>;
+export declare const snapshotCsvColumns: readonly ["snapshotVersion", "capturedAt", "org", "match", "matchValue", "userId", "userName", "username", "email", "profile", "role", "isActive", "isFrozen", "category", "name"];
+export declare const serializeSnapshotCsv: (snapshot: UserSnapshotFile) => string;
+export declare const deserializeSnapshotCsv: (source: string, path?: string) => UserSnapshotFile;
+export declare const writeSnapshotFile: (path: string, snapshot: UserSnapshotFile) => Promise<void>;
+export declare const readSnapshotFile: (path: string) => Promise<UserSnapshotFile>;
+export declare const assertSnapshotFile: (value: unknown) => UserSnapshotFile;