@simplysf/simply-permissions 1.2.30 → 1.3.0

package/README.md

@@ -65,6 +65,121 @@ FLAG DESCRIPTIONS
     The path to write the generated HTML report to.
 ```
 
+_See code: [lib/commands/simply/permissions/analyze.js](https://github.com/SimplySF/simply-node/blob/@simplysf/simply-permissions@1.2.31/packages/simply-permissions/lib/commands/simply/permissions/analyze.js)_
+
+## `sf simply permissions build`
+
+Generate a permission set from Salesforce source metadata.
+
+```
+USAGE
+  $ sf simply permissions build --type read-only|view-all|modify-all -n <value> -d <value> --output <value> [--json]
+    [--flags-dir <value>] [-c <value>] [--include-record-types] [--label <value>] [--description <value>]
+
+FLAGS
+  -c, --config=<value>        Path to a permission set configuration file
+  -d, --directory=<value>     (required) Path to the Salesforce project directory
+  -n, --name=<value>          (required) API name for the permission set
+      --description=<value>   Description for the permission set
+      --include-record-types  Include record type visibilities
+      --label=<value>         Label for the permission set
+      --output=<value>        (required) Output directory
+      --type=<option>         (required) Baseline permission type
+                              <options: read-only|view-all|modify-all>
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Generate a permission set from Salesforce source metadata.
+
+  Scans a Salesforce project directory for custom objects, fields, tabs, and (optionally) record types, then generates a
+  permission set XML file with a baseline of permissions determined by --type. An optional JSON --config file can
+  override individual object, field, tab, record type, and user permission settings, as well as whether the permission
+  set requires activation.
+
+EXAMPLES
+  $ sf simply permissions build --type read-only --name My_Read_Only_Access --directory force-app --output force-app/main/default/permissionsets
+
+  $ sf simply permissions build --type modify-all --name My_Admin_Access --directory force-app --config config/permission-overrides.json --output force-app/main/default/permissionsets --include-record-types
+
+FLAG DESCRIPTIONS
+  -c, --config=<value>  Path to a permission set configuration file
+
+    The path to a JSON file that overrides individual object, field, tab, record type, and user permission settings, as
+    well as whether the permission set requires activation, on top of the --type baseline.
+
+  -d, --directory=<value>  Path to the Salesforce project directory
+
+    The path to the Salesforce source directory to scan for custom objects, fields, tabs, and record types.
+
+  -n, --name=<value>  API name for the permission set
+
+    The API name for the generated permission set; also used to derive the output filename.
+
+  --include-record-types  Include record type visibilities
+
+    Automatically include record type visibilities discovered from the source metadata, marked as visible by default.
+
+  --output=<value>  Output directory
+
+    The directory to write the generated permission set XML file to.
+
+  --type=read-only|view-all|modify-all  Baseline permission type
+
+    The baseline permission level to generate: 'read-only' grants read access to all discovered objects and fields,
+    'view-all' additionally grants view-all-records, and 'modify-all' grants full CRUD and modify-all-records access.
+```
+
+_See code: [lib/commands/simply/permissions/build.js](https://github.com/SimplySF/simply-node/blob/@simplysf/simply-permissions@1.2.31/packages/simply-permissions/lib/commands/simply/permissions/build.js)_
+<!-- commandsstop -->
+
+- [`sf simply permissions analyze`](#sf-simply-permissions-analyze)
+- [`sf simply permissions build`](#sf-simply-permissions-build)
+
+## `sf simply permissions analyze`
+
+Analyze permission sets and permission set groups in an org.
+
+```
+USAGE
+  $ sf simply permissions analyze -o <value> [--json] [--flags-dir <value>] [--api-version <value>] [-f <value>...] [--output
+    <value>]
+
+FLAGS
+  -f, --filter=<value>...    Permission set or group names to include
+  -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
+                             configuration variable is already set.
+      --api-version=<value>  Override the api version used for api requests made by this command
+      --output=<value>       [default: permissions_report.html] Output HTML file path
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Analyze permission sets and permission set groups in an org.
+
+  Generates an HTML report of every permission set and permission set group in the target org, grouped by installed
+  package, including their object and field permissions.
+
+EXAMPLES
+  $ sf simply permissions analyze --target-org myOrg
+
+  $ sf simply permissions analyze --target-org myOrg --output reports/permissions.html --filter My_Permission_Set --filter Another_Set
+
+FLAG DESCRIPTIONS
+  -f, --filter=<value>...  Permission set or group names to include
+
+    One or more PermissionSet (Name) or PermissionSetGroup (DeveloperName) API names to restrict the report to. If
+    omitted, all permission sets and groups are included.
+
+  --output=<value>  Output HTML file path
+
+    The path to write the generated HTML report to.
+```
+
 _See code: [lib/commands/simply/permissions/analyze.js](https://github.com/SimplySF/simply-node/blob/@simplysf/simply-permissions@1.2.13/packages/simply-permissions/lib/commands/simply/permissions/analyze.js)_
 
 ## `sf simply permissions build`

package/lib/commands/simply/permissions/assignment/delete.d.ts

@@ -0,0 +1,29 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type PermissionAssignmentDeleteFailure = {
+    id: string;
+    message: string;
+};
+export type PermissionAssignmentDeleteResult = {
+    deleted: string[];
+    failures: PermissionAssignmentDeleteFailure[];
+};
+/**
+ * Deletes every `PermissionSetAssignment` against the named `PermissionSet`s/`PermissionSetGroup`s
+ * — the pre-step a destructive metadata deploy of the permission set/group itself needs, so it
+ * doesn't fail or orphan assignments.
+ */
+export default class PermissionsAssignmentDelete extends SfCommand<PermissionAssignmentDeleteResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'permission-set-name': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'permission-set-group-name': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined>;
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org>;
+        'flags-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    /** @returns The deleted assignment Ids and any per-chunk failures. Sets `process.exitCode = 1` if any failure occurred. */
+    run(): Promise<PermissionAssignmentDeleteResult>;
+}

package/lib/commands/simply/permissions/assignment/delete.js

@@ -0,0 +1,116 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import fs from 'node:fs/promises';
+import { Messages } from '@salesforce/core';
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { chunk, chunkedInQuery, readPackageManifestMembers } from '@simplysf/simply-core';
+import { requireConnection, targetOrgFlags } from '@simplysf/simply-plugin-kit';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@simplysf/simply-permissions', 'simply.permissions.assignment.delete');
+/** How many names to put in each `IN (...)` clause, and how many Ids per DML delete chunk. */
+const CHUNK_SIZE = 200;
+const FAILURE_TABLE_COLUMNS = [
+    { key: 'id', name: 'ASSIGNMENT ID' },
+    { key: 'message', name: 'MESSAGE' },
+];
+/**
+ * Deletes every `PermissionSetAssignment` against the named `PermissionSet`s/`PermissionSetGroup`s
+ * — the pre-step a destructive metadata deploy of the permission set/group itself needs, so it
+ * doesn't fail or orphan assignments.
+ */
+export default class PermissionsAssignmentDelete extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        ...SfCommand.baseFlags,
+        ...targetOrgFlags,
+        file: Flags.string({ summary: messages.getMessage('flags.file.summary'), char: 'f' }),
+        'permission-set-name': Flags.string({
+            summary: messages.getMessage('flags.permission-set-name.summary'),
+            multiple: true,
+        }),
+        'permission-set-group-name': Flags.string({
+            summary: messages.getMessage('flags.permission-set-group-name.summary'),
+            multiple: true,
+        }),
+    };
+    /** @returns The deleted assignment Ids and any per-chunk failures. Sets `process.exitCode = 1` if any failure occurred. */
+    async run() {
+        const { flags } = await this.parse(PermissionsAssignmentDelete);
+        const hasExplicitNames = Boolean(flags['permission-set-name']?.length ?? flags['permission-set-group-name']?.length);
+        if ((flags.file && hasExplicitNames) || (!flags.file && !hasExplicitNames)) {
+            throw messages.createError('error.fileOrNameFlagsRequired');
+        }
+        let permissionSetNames;
+        let permissionSetGroupNames;
+        if (flags.file) {
+            const xmlContent = await fs.readFile(flags.file, 'utf-8');
+            permissionSetNames = readPackageManifestMembers(xmlContent, 'PermissionSet');
+            permissionSetGroupNames = readPackageManifestMembers(xmlContent, 'PermissionSetGroup');
+        }
+        else {
+            permissionSetNames = flags['permission-set-name'] ?? [];
+            permissionSetGroupNames = flags['permission-set-group-name'] ?? [];
+        }
+        if (permissionSetNames.length === 0 && permissionSetGroupNames.length === 0) {
+            this.info(messages.getMessage('info.nothingToDelete'));
+            return { deleted: [], failures: [] };
+        }
+        const connection = requireConnection(flags);
+        this.spinner.start(messages.getMessage('info.queryingAssignments'));
+        const [byPermissionSet, byPermissionSetGroup] = await Promise.all([
+            permissionSetNames.length > 0
+                ? chunkedInQuery(connection, permissionSetNames, (inClause) => `SELECT Id FROM PermissionSetAssignment WHERE PermissionSet.Name IN (${inClause})`, { chunkSize: CHUNK_SIZE })
+                : [],
+            permissionSetGroupNames.length > 0
+                ? chunkedInQuery(connection, permissionSetGroupNames, (inClause) => `SELECT Id FROM PermissionSetAssignment WHERE PermissionSetGroup.DeveloperName IN (${inClause})`, { chunkSize: CHUNK_SIZE })
+                : [],
+        ]);
+        this.spinner.stop();
+        const assignmentIds = [...new Set([...byPermissionSet, ...byPermissionSetGroup].map((r) => r.Id))];
+        if (assignmentIds.length === 0) {
+            this.info(messages.getMessage('info.nothingToDelete'));
+            return { deleted: [], failures: [] };
+        }
+        this.spinner.start(messages.getMessage('info.deleting'));
+        const deleted = [];
+        const failures = [];
+        for (const idChunk of chunk(assignmentIds, CHUNK_SIZE)) {
+            // eslint-disable-next-line no-await-in-loop -- each chunk's DML delete must complete before the next chunk is sent
+            const results = await connection.sobject('PermissionSetAssignment').delete(idChunk);
+            // A failed SaveResult carries `id: undefined`, not the id that failed — the response array is
+            // positional against the request array, so the input chunk is the only reliable source of it.
+            results.forEach((result, index) => {
+                const id = idChunk[index];
+                if (result.success) {
+                    deleted.push(id);
+                }
+                else {
+                    failures.push({ id, message: result.errors.map((e) => e.message).join(', ') });
+                }
+            });
+        }
+        this.spinner.stop();
+        if (failures.length > 0) {
+            this.table({ data: failures, columns: FAILURE_TABLE_COLUMNS });
+            process.exitCode = 1;
+        }
+        this.info(messages.getMessage('info.summary', [deleted.length, failures.length]));
+        return { deleted, failures };
+    }
+}
+//# sourceMappingURL=delete.js.map

package/lib/commands/simply/permissions/assignment/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../../../src/commands/simply/permissions/assignment/delete.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAEhF,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,8BAA8B,EAAE,sCAAsC,CAAC,CAAC;AAE/G,8FAA8F;AAC9F,MAAM,UAAU,GAAG,GAAG,CAAC;AAWvB,MAAM,qBAAqB,GAAG;IAC5B,EAAE,GAAG,EAAE,IAAa,EAAE,IAAI,EAAE,eAAe,EAAE;IAC7C,EAAE,GAAG,EAAE,SAAkB,EAAE,IAAI,EAAE,SAAS,EAAE;CAC7C,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,2BAA4B,SAAQ,SAA2C;IAC3F,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,CAAU,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,CAAU,KAAK,GAAG;QAC7B,GAAG,SAAS,CAAC,SAAS;QACtB,GAAG,cAAc;QACjB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QACrF,qBAAqB,EAAE,KAAK,CAAC,MAAM,CAAC;YAClC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,mCAAmC,CAAC;YACjE,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,2BAA2B,EAAE,KAAK,CAAC,MAAM,CAAC;YACxC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,yCAAyC,CAAC;YACvE,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAC;IAEF,2HAA2H;IACpH,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAEhE,MAAM,gBAAgB,GAAG,OAAO,CAC9B,KAAK,CAAC,qBAAqB,CAAC,EAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,EAAE,MAAM,CACnF,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC3E,MAAM,QAAQ,CAAC,WAAW,CAAC,+BAA+B,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,kBAA4B,CAAC;QACjC,IAAI,uBAAiC,CAAC;QACtC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC1D,kBAAkB,GAAG,0BAA0B,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;YAC7E,uBAAuB,GAAG,0BAA0B,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;QACzF,CAAC;aAAM,CAAC;YACN,kBAAkB,GAAG,KAAK,CAAC,qBAAqB,CAAC,IAAI,EAAE,CAAC;YACxD,uBAAuB,GAAG,KAAK,CAAC,2BAA2B,CAAC,IAAI,EAAE,CAAC;QACrE,CAAC;QAED,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,IAAI,uBAAuB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5E,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC;YACvD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QACvC,CAAC;QAED,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAE5C,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,0BAA0B,CAAC,CAAC,CAAC;QACpE,MAAM,CAAC,eAAe,EAAE,oBAAoB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAChE,kBAAkB,CAAC,MAAM,GAAG,CAAC;gBAC3B,CAAC,CAAC,cAAc,CACZ,UAAU,EACV,kBAAkB,EAClB,CAAC,QAAQ,EAAE,EAAE,CAAC,uEAAuE,QAAQ,GAAG,EAChG,EAAE,SAAS,EAAE,UAAU,EAAE,CAC1B;gBACH,CAAC,CAAC,EAAE;YACN,uBAAuB,CAAC,MAAM,GAAG,CAAC;gBAChC,CAAC,CAAC,cAAc,CACZ,UAAU,EACV,uBAAuB,EACvB,CAAC,QAAQ,EAAE,EAAE,CACX,qFAAqF,QAAQ,GAAG,EAClG,EAAE,SAAS,EAAE,UAAU,EAAE,CAC1B;gBACH,CAAC,CAAC,EAAE;SACP,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAEpB,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,eAAe,EAAE,GAAG,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAEnG,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC;YACvD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QACvC,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC;QACzD,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAwC,EAAE,CAAC;QAEzD,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,aAAa,EAAE,UAAU,CAAC,EAAE,CAAC;YACvD,mHAAmH;YACnH,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACpF,8FAA8F;YAC9F,8FAA8F;YAC9F,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;gBAChC,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC1B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACnB,CAAC;qBAAM,CAAC;oBACN,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACjF,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAEpB,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAC;YAC/D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAElF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC/B,CAAC"}

package/messages/simply.permissions.assignment.delete.md

@@ -0,0 +1,49 @@
+# summary
+
+Delete PermissionSetAssignments for one or more PermissionSets/PermissionSetGroups.
+
+# description
+
+Deletes every `PermissionSetAssignment` against the named `PermissionSet`s and/or `PermissionSetGroup`s — the pre-step a destructive metadata deploy of the permission set/group itself needs, so it doesn't fail or leave orphaned assignments behind.
+
+Targets can be named either via `--file`, pointing at a `destructiveChanges.xml`/`package.xml`-shaped file whose `PermissionSet`/`PermissionSetGroup` type members are the targets, or via `--permission-set-name`/`--permission-set-group-name` flags (which may be combined with each other) for scripted or one-off use. `--file` is mutually exclusive with the two explicit-name flags.
+
+# flags.file.summary
+
+Path to a destructiveChanges.xml/package.xml-shaped file
+
+# flags.permission-set-name.summary
+
+PermissionSet Name(s) to delete assignments for
+
+# flags.permission-set-group-name.summary
+
+PermissionSetGroup DeveloperName(s) to delete assignments for
+
+# examples
+
+- <%= config.bin %> <%= command.id %> --file destructive/pre/destructiveChanges.xml --target-org myOrg
+
+- <%= config.bin %> <%= command.id %> --permission-set-name My_Permission_Set --target-org myOrg
+
+- <%= config.bin %> <%= command.id %> --permission-set-group-name My_Permission_Set_Group --target-org myOrg
+
+# error.fileOrNameFlagsRequired
+
+You must specify either --file, or --permission-set-name/--permission-set-group-name, but not both.
+
+# info.nothingToDelete
+
+No matching PermissionSetAssignments found; nothing to delete.
+
+# info.queryingAssignments
+
+Querying PermissionSetAssignments...
+
+# info.deleting
+
+Deleting PermissionSetAssignments...
+
+# info.summary
+
+Deleted %s assignment(s), %s failure(s).

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@simplysf/simply-permissions",
   "description": "Utilities for working with permissions",
-  "version": "1.2.30",
+  "version": "1.3.0",
   "author": "@ClayChipps",
   "homepage": "https://github.com/SimplySF/simply-node",
   "bugs": "https://github.com/SimplySF/simply-node/issues",
@@ -61,7 +61,7 @@
     "@salesforce/kit": "^3.2.6",
     "@salesforce/sf-plugins-core": "^12.2.16",
     "@salesforce/source-deploy-retrieve": "^12.37.2",
-    "@simplysf/simply-core": "^1.3.0",
+    "@simplysf/simply-core": "^1.5.0",
     "@simplysf/simply-plugin-kit": "^1.0.4",
     "@simplysf/simply-report": "^1.0.3",
     "handlebars": "^4.7.9",
@@ -212,5 +212,5 @@
       "output": []
     }
   },
-  "gitHead": "c3eece6a9447aa996f4515f53a6697e78e318b31"
+  "gitHead": "7027cc7497e4b5852f51abb3713757f9eae85cd7"
 }