sf-plugin-permission-sets 0.0.0-dev.7 → 0.0.0-dev.70

package/lib/services/export.d.ts

@@ -0,0 +1,19 @@
+import { AssignmentFilter } from '../core/index.js';
+import { OrgClient } from './adapters/index.js';
+export type ExportResult = {
+    /** The path written, or null when the document was returned for stdout instead of a file. */
+    outputFile: string | null;
+    /** The serialized YAML document, exactly as written to the file. */
+    content: string;
+    users: number;
+    assignments: number;
+    /** Requested users (from the filter) that matched no assignments in scope. */
+    unmatchedUsers: string[];
+};
+/** Read the org's current assignments and serialize them as YAML. */
+export declare class ExportService {
+    private readonly org;
+    constructor(org: OrgClient);
+    run(outputFile: string | undefined, filter?: AssignmentFilter): Promise<ExportResult>;
+}
+//# sourceMappingURL=export.d.ts.map

package/lib/services/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/services/export.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAwB,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,MAAM,YAAY,GAAG;IACvB,6FAA6F;IAC7F,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,cAAc,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC;AAEF,qEAAqE;AACrE,qBAAa,aAAa;IACH,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAErC,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;CAqBrG"}

package/lib/services/export.js

@@ -0,0 +1,29 @@
+import { writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { serializeAssignments } from '../core/index.js';
+/** Read the org's current assignments and serialize them as YAML. */
+export class ExportService {
+    org;
+    constructor(org) {
+        this.org = org;
+    }
+    async run(outputFile, filter) {
+        const assignments = await this.org.listAssignments(filter);
+        const content = serializeAssignments(assignments);
+        if (outputFile) {
+            await mkdir(dirname(outputFile), { recursive: true });
+            await writeFile(outputFile, content, 'utf8');
+        }
+        const assignees = new Set(assignments.map((assignment) => assignment.assignee));
+        const requested = filter?.usernames ?? [];
+        const unmatchedUsers = requested.filter((username) => !assignees.has(username));
+        return {
+            outputFile: outputFile ?? null,
+            content,
+            users: assignees.size,
+            assignments: assignments.length,
+            unmatchedUsers,
+        };
+    }
+}
+//# sourceMappingURL=export.js.map

package/lib/services/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/services/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAoB,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAc1E,qEAAqE;AACrE,MAAM,OAAO,aAAa;IACc;IAApC,YAAoC,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C,KAAK,CAAC,GAAG,CAAC,UAA8B,EAAE,MAAyB;QACtE,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAElD,IAAI,UAAU,EAAE,CAAC;YACb,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,MAAM,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChF,MAAM,SAAS,GAAG,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC;QAC1C,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEhF,OAAO;YACH,UAAU,EAAE,UAAU,IAAI,IAAI;YAC9B,OAAO;YACP,KAAK,EAAE,SAAS,CAAC,IAAI;YACrB,WAAW,EAAE,WAAW,CAAC,MAAM;YAC/B,cAAc;SACjB,CAAC;IACN,CAAC;CACJ"}

package/lib/services/index.d.ts

@@ -0,0 +1,6 @@
+export { ApplyService, ConfirmDeletions, ApplyResult } from './apply.js';
+export { CheckService } from './check.js';
+export { ExportService } from './export.js';
+export { PlanService } from './plan.js';
+export { ValidateService } from './validate.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/lib/services/index.js

@@ -0,0 +1,6 @@
+export { ApplyService } from './apply.js';
+export { CheckService } from './check.js';
+export { ExportService } from './export.js';
+export { PlanService } from './plan.js';
+export { ValidateService } from './validate.js';
+//# sourceMappingURL=index.js.map

package/lib/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAiC,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/lib/services/plan.d.ts

@@ -0,0 +1,29 @@
+import { Diff, Finding } from '../core/index.js';
+import { OrgClient } from './adapters/index.js';
+export type PlanMode = 'additive' | 'destructive' | 'sync';
+/** How a run ended, so the command can report and set the exit code. */
+export type PlanStatus = 'planned' | 'invalid';
+export type PlanResult = {
+    files: string[];
+    findings: Finding[];
+    diff: Diff;
+    /** What the chosen mode would not act on (surfaced as drift). */
+    drift: {
+        adds: number;
+        updates: number;
+        removes: number;
+    };
+    status: PlanStatus;
+};
+/**
+ * Read-only preview: load the files, resolve every reference to an org id, fetch the
+ * current state, and diff. The full diff (adds and would-be removes) is always returned
+ * regardless of mode; drift is whatever the chosen mode would not act on. Never changes
+ * the org. This is the apply pipeline stopping before any DML.
+ */
+export declare class PlanService {
+    private readonly org;
+    constructor(org: OrgClient);
+    run(files: string[], mode: PlanMode): Promise<PlanResult>;
+}
+//# sourceMappingURL=plan.d.ts.map

package/lib/services/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/services/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAAE,OAAO,EAAiB,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,MAAM,CAAC;AAE3D,wEAAwE;AACxE,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAE/C,MAAM,MAAM,UAAU,GAAG;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;IACX,iEAAiE;IACjE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,MAAM,EAAE,UAAU,CAAC;CACtB,CAAC;AAeF;;;;;GAKG;AACH,qBAAa,WAAW;IACD,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAErC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;CA4BzE"}

package/lib/services/plan.js

@@ -0,0 +1,51 @@
+import { loadFiles, diffAssignments, countFindings } from '../core/index.js';
+import { ResolutionService, managedTargets } from './resolution.js';
+const emptyDiff = { toAdd: [], toUpdate: [], toRemove: [], unchanged: [] };
+/** An aborted-before-the-diff result, carrying the findings that explain why. */
+function invalidResult(files, findings) {
+    return {
+        files,
+        findings,
+        diff: emptyDiff,
+        drift: { adds: 0, updates: 0, removes: 0 },
+        status: 'invalid',
+    };
+}
+/**
+ * Read-only preview: load the files, resolve every reference to an org id, fetch the
+ * current state, and diff. The full diff (adds and would-be removes) is always returned
+ * regardless of mode; drift is whatever the chosen mode would not act on. Never changes
+ * the org. This is the apply pipeline stopping before any DML.
+ */
+export class PlanService {
+    org;
+    constructor(org) {
+        this.org = org;
+    }
+    async run(files, mode) {
+        const loaded = await loadFiles(files);
+        const loadCounts = countFindings(loaded.findings);
+        if (loadCounts.errors > 0) {
+            return invalidResult(loaded.files, loaded.findings);
+        }
+        const resolutionService = new ResolutionService(this.org);
+        const resolution = await resolutionService.run(loaded.assignments);
+        const findings = [
+            ...loaded.findings,
+            ...resolution.findings,
+        ];
+        const findingCounts = countFindings(findings);
+        if (findingCounts.errors > 0) {
+            return invalidResult(loaded.files, findings);
+        }
+        const actual = await this.org.listCurrentAssignments(managedTargets(resolution));
+        const diff = diffAssignments(loaded.assignments, actual);
+        const drift = {
+            adds: mode === 'destructive' ? diff.toAdd.length : 0,
+            updates: mode === 'destructive' ? diff.toUpdate.length : 0,
+            removes: mode === 'additive' ? diff.toRemove.length : 0,
+        };
+        return { files: loaded.files, findings, diff, drift, status: 'planned' };
+    }
+}
+//# sourceMappingURL=plan.js.map

package/lib/services/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/services/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAiB,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE5F,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAgBpE,MAAM,SAAS,GAAS,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;AAEjF,iFAAiF;AACjF,SAAS,aAAa,CAAC,KAAe,EAAE,QAAmB;IACvD,OAAO;QACH,KAAK;QACL,QAAQ;QACR,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;QAC1C,MAAM,EAAE,SAAS;KACpB,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,WAAW;IACgB;IAApC,YAAoC,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C,KAAK,CAAC,GAAG,CAAC,KAAe,EAAE,IAAc;QAC5C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1D,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG;YACb,GAAG,MAAM,CAAC,QAAQ;YAClB,GAAG,UAAU,CAAC,QAAQ;SACzB,CAAC;QACF,MAAM,aAAa,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;QACjF,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG;YACV,IAAI,EAAE,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACpD,OAAO,EAAE,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC1D,OAAO,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;SAC1D,CAAC;QAEF,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC7E,CAAC;CACJ"}

package/lib/services/resolution.d.ts

@@ -0,0 +1,18 @@
+import { DesiredAssignment, Kind, OrgTarget, ResolvedAddition, TargetRef, Finding } from '../core/index.js';
+import { OrgClient } from './adapters/index.js';
+export type Resolution = {
+    findings: Finding[];
+    userIds: Map<string, string>;
+    targetIds: Record<Kind, Map<string, string>>;
+};
+export declare function managedTargets(resolution: Resolution): TargetRef[];
+/** Attach the resolved assignee and target ids to each addition, so it can be inserted. */
+export declare function resolveAdditions(additions: DesiredAssignment[], resolution: Resolution): ResolvedAddition[];
+/** Look every declared reference up in the org, returning findings and the resolved id maps. */
+export declare class ResolutionService {
+    private readonly org;
+    constructor(org: OrgClient);
+    run(assignments: DesiredAssignment[]): Promise<Resolution>;
+    findTargetsOfKind(kind: Kind, names: string[]): Promise<OrgTarget[]>;
+}
+//# sourceMappingURL=resolution.d.ts.map

package/lib/services/resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolution.d.ts","sourceRoot":"","sources":["../../src/services/resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EACjB,IAAI,EACJ,SAAS,EAET,gBAAgB,EAChB,SAAS,EACT,OAAO,EAQV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,MAAM,UAAU,GAAG;IACrB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAChD,CAAC;AAEF,wBAAgB,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,EAAE,CAQlE;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,iBAAiB,EAAE,EAAE,UAAU,EAAE,UAAU,GAAG,gBAAgB,EAAE,CAM3G;AAED,gGAAgG;AAChG,qBAAa,iBAAiB;IACP,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAErC,GAAG,CAAC,WAAW,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAuCvE,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAOvE"}

package/lib/services/resolution.js

@@ -0,0 +1,59 @@
+import { kinds, distinctAssignees, distinctTargets, evaluateUsers, evaluateTargets, indexUsersById, indexTargetsById, } from '../core/index.js';
+export function managedTargets(resolution) {
+    const refs = [];
+    for (const kind of kinds) {
+        for (const id of resolution.targetIds[kind].values()) {
+            refs.push({ kind, id });
+        }
+    }
+    return refs;
+}
+/** Attach the resolved assignee and target ids to each addition, so it can be inserted. */
+export function resolveAdditions(additions, resolution) {
+    return additions.map((addition) => ({
+        ...addition,
+        assigneeId: resolution.userIds.get(addition.assignee.toLowerCase()) ?? '',
+        targetId: resolution.targetIds[addition.kind].get(addition.target.toLowerCase()) ?? '',
+    }));
+}
+/** Look every declared reference up in the org, returning findings and the resolved id maps. */
+export class ResolutionService {
+    org;
+    constructor(org) {
+        this.org = org;
+    }
+    async run(assignments) {
+        const usernames = distinctAssignees(assignments);
+        const targetsByKind = kinds.map((kind) => ({ kind, targets: distinctTargets(assignments, kind) }));
+        const usersTask = usernames.length > 0 ? this.org.findUsers(usernames) : Promise.resolve([]);
+        const targetsTask = Promise.all(targetsByKind.map(async ({ kind, targets }) => {
+            if (targets.length === 0)
+                return { kind, targets, found: [] };
+            const found = await this.findTargetsOfKind(kind, targets);
+            return { kind, targets, found };
+        }));
+        const [foundUsers, perKind] = await Promise.all([
+            usersTask,
+            targetsTask,
+        ]);
+        const findings = [...evaluateUsers(usernames, foundUsers)];
+        for (const { kind, targets, found } of perKind) {
+            findings.push(...evaluateTargets(kind, targets, found.map((target) => target.name)));
+        }
+        const targetIds = {};
+        for (const { kind, found } of perKind) {
+            targetIds[kind] = indexTargetsById(found);
+        }
+        return { findings, userIds: indexUsersById(foundUsers), targetIds };
+    }
+    findTargetsOfKind(kind, names) {
+        if (kind === 'permissionSet')
+            return this.org.findPermissionSets(names);
+        if (kind === 'permissionSetGroup')
+            return this.org.findPermissionSetGroups(names);
+        if (kind === 'permissionSetLicense')
+            return this.org.findPermissionSetLicenses(names);
+        throw new Error(`Unsupported kind: ${String(kind)}`);
+    }
+}
+//# sourceMappingURL=resolution.js.map

package/lib/services/resolution.js.map

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

package/lib/services/validate.d.ts

@@ -0,0 +1,22 @@
+import { DesiredAssignment, Finding, Kind, OrgTarget } from '../core/index.js';
+import { OrgClient } from './adapters/index.js';
+export type ValidateResult = {
+    files: string[];
+    assignments: DesiredAssignment[];
+    findings: Finding[];
+    errors: number;
+    warnings: number;
+    failed: boolean;
+};
+/** Load the files, then resolve every reference against the org. */
+export declare class ValidateService {
+    private readonly org;
+    constructor(org: OrgClient);
+    run(files: string[]): Promise<ValidateResult>;
+    /** Look every reference up in the org (in parallel) and evaluate the results. */
+    private resolve;
+    private evaluateUserRefs;
+    private evaluateTargetRefs;
+    findTargetsOfKind(kind: Kind, names: string[]): Promise<OrgTarget[]>;
+}
+//# sourceMappingURL=validate.d.ts.map

package/lib/services/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/services/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAOH,iBAAiB,EACjB,OAAO,EACP,IAAI,EAEJ,SAAS,EACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,MAAM,cAAc,GAAG;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,oEAAoE;AACpE,qBAAa,eAAe;IACL,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAErC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAoB1D,iFAAiF;YACnE,OAAO;YAmBP,gBAAgB;YAKhB,kBAAkB;IAShC,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAOvE"}

package/lib/services/validate.js

@@ -0,0 +1,59 @@
+import { loadFiles, kinds, distinctAssignees, distinctTargets, evaluateUsers, evaluateTargets, countFindings, } from '../core/index.js';
+/** Load the files, then resolve every reference against the org. */
+export class ValidateService {
+    org;
+    constructor(org) {
+        this.org = org;
+    }
+    async run(files) {
+        const loaded = await loadFiles(files);
+        const resolved = await this.resolve(loaded.assignments);
+        const findings = [
+            ...loaded.findings,
+            ...resolved,
+        ];
+        const { errors, warnings } = countFindings(findings);
+        return {
+            files: loaded.files,
+            assignments: loaded.assignments,
+            findings,
+            errors,
+            warnings,
+            failed: errors > 0,
+        };
+    }
+    /** Look every reference up in the org (in parallel) and evaluate the results. */
+    async resolve(assignments) {
+        const tasks = [];
+        const usernames = distinctAssignees(assignments);
+        if (usernames.length > 0) {
+            tasks.push(this.evaluateUserRefs(usernames));
+        }
+        for (const kind of kinds) {
+            const targets = distinctTargets(assignments, kind);
+            if (targets.length > 0) {
+                tasks.push(this.evaluateTargetRefs(kind, targets));
+            }
+        }
+        const results = await Promise.all(tasks);
+        return results.flat();
+    }
+    async evaluateUserRefs(usernames) {
+        const found = await this.org.findUsers(usernames);
+        return evaluateUsers(usernames, found);
+    }
+    async evaluateTargetRefs(kind, targets) {
+        const found = await this.findTargetsOfKind(kind, targets);
+        return evaluateTargets(kind, targets, found.map((target) => target.name));
+    }
+    findTargetsOfKind(kind, names) {
+        if (kind === 'permissionSet')
+            return this.org.findPermissionSets(names);
+        if (kind === 'permissionSetGroup')
+            return this.org.findPermissionSetGroups(names);
+        if (kind === 'permissionSetLicense')
+            return this.org.findPermissionSetLicenses(names);
+        throw new Error(`Unsupported kind: ${String(kind)}`);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/lib/services/validate.js.map

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

package/messages/ps.apply.md

@@ -0,0 +1,85 @@
+# summary
+
+Reconcile a target org to match the permission set assignment files.
+
+# description
+
+Load the files, resolve every user and target against the org, diff the desired state against what the org currently has, then add, update expirations, and/or remove assignments per the mode. Additions, expiration updates, and removals run through the sObject Collections API with partial success, so one bad record does not roll back the rest. Deletions are capped by --max-deletes and confirmed before they run. Run validate and a --dry-run first.
+
+# flags.file.summary
+
+YAML file or glob to apply. Repeatable.
+
+# flags.mode.summary
+
+Which half of the reconcile to run: additive adds missing assignments and updates expirations, destructive removes only, sync does both.
+
+# flags.max-deletes.summary
+
+Abort before any change if the run would remove more than this many assignments.
+
+# flags.dry-run.summary
+
+Resolve and diff, print the plan, and change nothing.
+
+# flags.show-unchanged.summary
+
+List assignments that already match, instead of only counting them.
+
+# flags.no-prompt.summary
+
+Skip the deletion confirmation prompt. Required to delete in JSON or other non-interactive runs.
+
+# confirm.delete
+
+This will remove %s assignment(s) from the org. Continue?
+
+# summary.dryRun
+
+Dry run: %s to add, %s to update, %s to remove. Nothing was changed.
+
+# summary.applied
+
+Applied: %s added, %s updated, %s removed.
+
+# summary.declined
+
+Aborted at the confirmation prompt. Nothing was changed.
+
+# drift.note
+
+%s change(s) the %s mode does not act on were skipped (drift). Run plan to see them.
+
+# failure.line
+
+failed to %s %s on %s: %s
+
+# error.invalid
+
+The files do not resolve cleanly against the org. Fix the errors above, then re-run.
+
+# error.maxDeletes
+
+Refusing to remove %s assignment(s): over the --max-deletes limit of %s. Raise the limit or narrow the change.
+
+# error.promptInJson
+
+Refusing to delete without confirmation in a non-interactive run. Re-run with --no-prompt.
+
+# error.failed
+
+Some changes failed. See the per-record errors above.
+
+# examples
+
+- Preview a full reconcile of the dev org without changing anything:
+
+  <%= config.bin %> <%= command.id %> --file "permissions/*.yml" --target-org dev --mode sync --dry-run
+
+- Grant any missing assignments (additive, the default):
+
+  <%= config.bin %> <%= command.id %> --file "permissions/*.yml" --target-org dev
+
+- Full reconcile of production in CI, without prompts:
+
+  <%= config.bin %> <%= command.id %> --file "permissions/*.yml" --target-org prod --mode sync --no-prompt

package/messages/ps.check.md

@@ -0,0 +1,33 @@
+# summary
+
+Statically check permission set assignment files, with no org connection.
+
+# description
+
+Parse and validate the YAML files, no org needed. Reports invalid YAML, schema violations, duplicate keys, duplicate targets, and empty entries. Run it in a pre-commit hook or in CI before validate, plan, or apply.
+
+# flags.file.summary
+
+YAML file or glob to check. Repeatable.
+
+# flags.strict.summary
+
+Treat warnings as errors.
+
+# summary.counts
+
+%s errors, %s warnings.
+
+# error.failed
+
+Check found problems. See the output above.
+
+# examples
+
+- Check every file under permissions:
+
+  <%= config.bin %> <%= command.id %> --file "permissions/*.yml"
+
+- Check specific files:
+
+  <%= config.bin %> <%= command.id %> --file permissions/sales.yml --file permissions/service.yml

package/messages/ps.export.md

@@ -0,0 +1,45 @@
+# summary
+
+Generate a YAML file from the current org's permission set assignments.
+
+# description
+
+Query the target org for every assignable permission set, group, and license assignment held by active users and write them to a single user-keyed YAML file. The result is valid input for check, validate, plan, and apply, so it is a read-only way to bootstrap adoption from an org's current state. Profile-owned permission sets and inactive users are skipped.
+
+# flags.output-file.summary
+
+Path of the YAML file to write. Created (and its parent directories) if missing, overwritten if present. Omit to write the document to stdout.
+
+# flags.user.summary
+
+Only export these users, matched on exact username. Repeatable; multiple values are a union.
+
+# flags.kind.summary
+
+Only export these scopes: permissionSets, permissionSetGroups, or permissionSetLicenses. Repeatable; combined with --user as an intersection.
+
+# success
+
+Exported %s assignments across %s users to %s.
+
+# warnNoAssignments
+
+No assignments in scope for user %s, it was skipped.
+
+# examples
+
+- Export the dev org's assignments to permissions.yml:
+
+  <%= config.bin %> <%= command.id %> --target-org dev --output-file permissions.yml
+
+- Export a production org into an environment folder:
+
+  <%= config.bin %> <%= command.id %> --target-org prod --output-file permissions/prod.yml
+
+- Write to stdout and diff against a committed snapshot:
+
+  <%= config.bin %> <%= command.id %> --target-org prod | diff - permissions/prod.yml
+
+- Export two users' permission sets and groups only:
+
+  <%= config.bin %> <%= command.id %> --target-org prod --output-file team.yml --user jdoe@acme.com --user asmith@acme.com --kind permissionSets --kind permissionSetGroups

package/messages/ps.plan.md

@@ -0,0 +1,85 @@
+# summary
+
+Preview the changes that would reconcile a target org to the assignment files.
+
+# description
+
+Load the files, resolve every user and target against the org, fetch the org's current assignments, and diff the desired state against them. Read-only: it queries the org but never changes it, so it is the apply pipeline stopping before any DML. The body shows only what the chosen mode would do, so what plan shows is what apply does. Anything the mode would not touch is reported beneath the plan as drift. Run it before apply to preview what would change.
+
+# flags.file.summary
+
+YAML file or glob to plan. Repeatable.
+
+# flags.mode.summary
+
+Which half of the reconcile to preview: additive adds and updates expirations, destructive removes only, sync does both. The plan shows only what the chosen mode would do; anything it skips is reported as drift.
+
+# flags.show-unchanged.summary
+
+List assignments that already match, instead of only counting them.
+
+# header.title
+
+Permission Set Assignments Plan
+
+# header.org
+
+Org: %s (%s)   Mode: %s
+
+# summary.counts.additive
+
+Plan: %s to add, %s to update. %s users affected.
+
+# summary.counts.destructive
+
+Plan: %s to remove. %s users affected.
+
+# summary.counts.sync
+
+Plan: %s to add, %s to update, %s to remove. %s users affected.
+
+# summary.unchanged
+
+Unchanged: %s assignments (--show-unchanged to list).
+
+# summary.unchangedListed
+
+Unchanged: %s assignments.
+
+# summary.next
+
+Next: %s
+
+# drift.additive
+
+Drift: %s undeclared assignment(s) not removed in additive mode. Run --mode sync to remove them.
+
+# drift.destructive
+
+Drift: %s declared assignment(s) not applied in destructive mode. Run --mode additive or sync to apply them.
+
+# empty.noChanges
+
+No changes. %s already matches your files.
+
+# empty.nothingToApply
+
+Nothing to apply in %s mode.
+
+# error.invalid
+
+The files do not resolve cleanly against the org. Fix the errors above, then re-run.
+
+# examples
+
+- Preview a full reconcile of the dev org:
+
+  <%= config.bin %> <%= command.id %> --file "permissions/*.yml" --target-org dev --mode sync
+
+- Preview only the additions the default additive run would make:
+
+  <%= config.bin %> <%= command.id %> --file "permissions/*.yml" --target-org dev
+
+- Preview a full reconcile of production before applying it:
+
+  <%= config.bin %> <%= command.id %> --file "permissions/*.yml" --target-org prod --mode sync

package/messages/ps.validate.md

@@ -0,0 +1,29 @@
+# summary
+
+Validate permission set assignment files against a target org.
+
+# description
+
+Run the same file checks as check, then resolve each referenced user, permission set, group, and license against the org. Reports users that are missing or inactive and targets that are missing or not unique. Read-only: it queries the org but never changes it. Run it before plan or apply.
+
+# flags.file.summary
+
+YAML file or glob to validate. Repeatable.
+
+# summary.counts
+
+%s errors, %s warnings.
+
+# error.failed
+
+Validation found problems. See the output above.
+
+# examples
+
+-   Validate every file under permissions against the dev org:
+
+    <%= config.bin %> <%= command.id %> --file "permissions/*.yml" --target-org dev
+
+-   Validate specific files against a named org:
+
+    <%= config.bin %> <%= command.id %> --file permissions/sales.yml --file permissions/service.yml --target-org prod