rflib-plugin 0.19.5 → 0.19.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/oclif.lock +196 -334
  2. package/oclif.manifest.json +405 -405
  3. package/package.json +2 -2
@@ -128,6 +128,207 @@
128
128
  "get:applicationevents:debug:rflib"
129
129
  ]
130
130
  },
131
+ "rflib:debug:loggersettings:get": {
132
+ "aliases": [],
133
+ "args": {},
134
+ "description": "Retrieves all rflib_Logger_Settings__c hierarchy custom setting records from the target org via the Salesforce REST API.\nReturns settings across org-wide defaults, profile overrides, and user overrides, along with embedded best-practice recommendations.\n\nUse \"sf rflib debug loggersettings update\" to apply changes.\n\nRequires the RFLIB base package to be installed in the target org and the running user to be assigned the rflib_Ops_Center_Access permission set (or have equivalent read access to rflib_Logger_Settings__c).\nFor installation instructions, visit: https://github.com/j-fischer/rflib",
135
+ "examples": [
136
+ "Read all logger settings from the target org:\n$ sf rflib debug loggersettings get --target-org myOrg"
137
+ ],
138
+ "flags": {
139
+ "json": {
140
+ "description": "Format output as json.",
141
+ "helpGroup": "GLOBAL",
142
+ "name": "json",
143
+ "allowNo": false,
144
+ "type": "boolean"
145
+ },
146
+ "flags-dir": {
147
+ "helpGroup": "GLOBAL",
148
+ "name": "flags-dir",
149
+ "summary": "Import flag values from a directory.",
150
+ "hasDynamicHelp": false,
151
+ "multiple": false,
152
+ "type": "option"
153
+ },
154
+ "target-org": {
155
+ "char": "o",
156
+ "description": "The username or alias of the Salesforce org containing the RFLIB base package.",
157
+ "name": "target-org",
158
+ "noCacheDefault": true,
159
+ "required": true,
160
+ "summary": "Username or alias of the target org.",
161
+ "hasDynamicHelp": true,
162
+ "multiple": false,
163
+ "type": "option"
164
+ }
165
+ },
166
+ "hasDynamicHelp": true,
167
+ "hiddenAliases": [],
168
+ "id": "rflib:debug:loggersettings:get",
169
+ "pluginAlias": "rflib-plugin",
170
+ "pluginName": "rflib-plugin",
171
+ "pluginType": "core",
172
+ "strict": true,
173
+ "summary": "Read all RFLIB Logger Settings from a Salesforce org.",
174
+ "enableJsonFlag": true,
175
+ "isESM": true,
176
+ "relativePath": [
177
+ "lib",
178
+ "commands",
179
+ "rflib",
180
+ "debug",
181
+ "loggersettings",
182
+ "get.js"
183
+ ],
184
+ "aliasPermutations": [],
185
+ "permutations": [
186
+ "rflib:debug:loggersettings:get",
187
+ "debug:rflib:loggersettings:get",
188
+ "debug:loggersettings:rflib:get",
189
+ "debug:loggersettings:get:rflib",
190
+ "rflib:loggersettings:debug:get",
191
+ "loggersettings:rflib:debug:get",
192
+ "loggersettings:debug:rflib:get",
193
+ "loggersettings:debug:get:rflib",
194
+ "rflib:loggersettings:get:debug",
195
+ "loggersettings:rflib:get:debug",
196
+ "loggersettings:get:rflib:debug",
197
+ "loggersettings:get:debug:rflib",
198
+ "rflib:debug:get:loggersettings",
199
+ "debug:rflib:get:loggersettings",
200
+ "debug:get:rflib:loggersettings",
201
+ "debug:get:loggersettings:rflib",
202
+ "rflib:get:debug:loggersettings",
203
+ "get:rflib:debug:loggersettings",
204
+ "get:debug:rflib:loggersettings",
205
+ "get:debug:loggersettings:rflib",
206
+ "rflib:get:loggersettings:debug",
207
+ "get:rflib:loggersettings:debug",
208
+ "get:loggersettings:rflib:debug",
209
+ "get:loggersettings:debug:rflib"
210
+ ]
211
+ },
212
+ "rflib:debug:loggersettings:update": {
213
+ "aliases": [],
214
+ "args": {},
215
+ "description": "Creates or updates a single field on an rflib_Logger_Settings__c record in the target org via the Salesforce REST API.\nValidates field values and warns about best-practice violations.\n\nTo update an existing record, provide --record-id. To create a new record, provide --setup-owner-id with an org ID (00D...), profile ID (00E...), or user ID.\n\nRequires the RFLIB base package to be installed in the target org and the running user to be assigned the rflib_Ops_Center_Access permission set (or have equivalent update access to rflib_Logger_Settings__c).\nFor installation instructions, visit: https://github.com/j-fischer/rflib",
216
+ "examples": [
217
+ "Update the Log_Event_Reporting_Level__c field on an existing record:\n$ sf rflib debug loggersettings update --target-org myOrg --record-id a0A000000001234 --field-name Log_Event_Reporting_Level__c --field-value WARN",
218
+ "Create a new org-wide Logger Setting:\n$ sf rflib debug loggersettings update --target-org myOrg --setup-owner-id 00D000000000001 --field-name Log_Event_Reporting_Level__c --field-value WARN"
219
+ ],
220
+ "flags": {
221
+ "json": {
222
+ "description": "Format output as json.",
223
+ "helpGroup": "GLOBAL",
224
+ "name": "json",
225
+ "allowNo": false,
226
+ "type": "boolean"
227
+ },
228
+ "flags-dir": {
229
+ "helpGroup": "GLOBAL",
230
+ "name": "flags-dir",
231
+ "summary": "Import flag values from a directory.",
232
+ "hasDynamicHelp": false,
233
+ "multiple": false,
234
+ "type": "option"
235
+ },
236
+ "target-org": {
237
+ "char": "o",
238
+ "description": "The username or alias of the Salesforce org containing the RFLIB base package.",
239
+ "name": "target-org",
240
+ "noCacheDefault": true,
241
+ "required": true,
242
+ "summary": "Username or alias of the target org.",
243
+ "hasDynamicHelp": true,
244
+ "multiple": false,
245
+ "type": "option"
246
+ },
247
+ "field-name": {
248
+ "char": "f",
249
+ "description": "The API name of the field to create or update, e.g. Log_Event_Reporting_Level__c. For log level fields, valid values are: TRACE, DEBUG, INFO, WARN, ERROR, FATAL, NONE.",
250
+ "name": "field-name",
251
+ "required": true,
252
+ "summary": "API name of the rflib_Logger_Settings__c field to update.",
253
+ "hasDynamicHelp": false,
254
+ "multiple": false,
255
+ "type": "option"
256
+ },
257
+ "field-value": {
258
+ "char": "v",
259
+ "description": "The new value to set on the specified field. For log level fields, valid values are: TRACE, DEBUG, INFO, WARN, ERROR, FATAL, NONE.",
260
+ "name": "field-value",
261
+ "required": true,
262
+ "summary": "New value for the specified field.",
263
+ "hasDynamicHelp": false,
264
+ "multiple": false,
265
+ "type": "option"
266
+ },
267
+ "record-id": {
268
+ "char": "r",
269
+ "description": "The Salesforce record ID of an existing rflib_Logger_Settings__c record to update. Omit this flag to create a new record (requires --setup-owner-id).",
270
+ "name": "record-id",
271
+ "summary": "ID of an existing rflib_Logger_Settings__c record to update.",
272
+ "hasDynamicHelp": false,
273
+ "multiple": false,
274
+ "type": "option"
275
+ },
276
+ "setup-owner-id": {
277
+ "char": "s",
278
+ "description": "Required when creating a new Logger Setting record. Accepts an org ID (00D...), profile ID (00E...), or user ID. Read existing record IDs using \"sf rflib debug loggersettings get\".",
279
+ "name": "setup-owner-id",
280
+ "summary": "Setup owner ID for creating a new Logger Setting record.",
281
+ "hasDynamicHelp": false,
282
+ "multiple": false,
283
+ "type": "option"
284
+ }
285
+ },
286
+ "hasDynamicHelp": true,
287
+ "hiddenAliases": [],
288
+ "id": "rflib:debug:loggersettings:update",
289
+ "pluginAlias": "rflib-plugin",
290
+ "pluginName": "rflib-plugin",
291
+ "pluginType": "core",
292
+ "strict": true,
293
+ "summary": "Create or update an RFLIB Logger Setting in a Salesforce org.",
294
+ "enableJsonFlag": true,
295
+ "isESM": true,
296
+ "relativePath": [
297
+ "lib",
298
+ "commands",
299
+ "rflib",
300
+ "debug",
301
+ "loggersettings",
302
+ "update.js"
303
+ ],
304
+ "aliasPermutations": [],
305
+ "permutations": [
306
+ "rflib:debug:loggersettings:update",
307
+ "debug:rflib:loggersettings:update",
308
+ "debug:loggersettings:rflib:update",
309
+ "debug:loggersettings:update:rflib",
310
+ "rflib:loggersettings:debug:update",
311
+ "loggersettings:rflib:debug:update",
312
+ "loggersettings:debug:rflib:update",
313
+ "loggersettings:debug:update:rflib",
314
+ "rflib:loggersettings:update:debug",
315
+ "loggersettings:rflib:update:debug",
316
+ "loggersettings:update:rflib:debug",
317
+ "loggersettings:update:debug:rflib",
318
+ "rflib:debug:update:loggersettings",
319
+ "debug:rflib:update:loggersettings",
320
+ "debug:update:rflib:loggersettings",
321
+ "debug:update:loggersettings:rflib",
322
+ "rflib:update:debug:loggersettings",
323
+ "update:rflib:debug:loggersettings",
324
+ "update:debug:rflib:loggersettings",
325
+ "update:debug:loggersettings:rflib",
326
+ "rflib:update:loggersettings:debug",
327
+ "update:rflib:loggersettings:debug",
328
+ "update:loggersettings:rflib:debug",
329
+ "update:loggersettings:debug:rflib"
330
+ ]
331
+ },
131
332
  "rflib:debug:logarchives:get": {
132
333
  "aliases": [],
133
334
  "args": {},
@@ -228,6 +429,124 @@
228
429
  "get:logarchives:debug:rflib"
229
430
  ]
230
431
  },
432
+ "rflib:debug:userpermissions:get": {
433
+ "aliases": [],
434
+ "args": {},
435
+ "description": "Retrieves FLS (Field-Level Security), OLS (Object-Level Security), and Apex class/page permissions for a specific user\nvia the Salesforce REST API. Permissions are aggregated across the user's profile, permission sets, and permission set groups.\n\nUse --sobject-type to narrow FLS or OLS results to a specific SObject.\n\nRequires the RFLIB base package to be installed in the target org and the running user to be assigned the rflib_Ops_Center_Access permission set (or have equivalent read access to the relevant permission objects).\nFor installation instructions, visit: https://github.com/j-fischer/rflib",
436
+ "examples": [
437
+ "Check all permissions for a user:\n$ sf rflib debug userpermissions get --target-org myOrg --user-id 0057000000XXXXXX --permission-type ALL",
438
+ "Check FLS for a specific object:\n$ sf rflib debug userpermissions get --target-org myOrg --user-id 0057000000XXXXXX --permission-type FLS --sobject-type Account",
439
+ "Check Apex access:\n$ sf rflib debug userpermissions get --target-org myOrg --user-id 0057000000XXXXXX --permission-type APEX"
440
+ ],
441
+ "flags": {
442
+ "json": {
443
+ "description": "Format output as json.",
444
+ "helpGroup": "GLOBAL",
445
+ "name": "json",
446
+ "allowNo": false,
447
+ "type": "boolean"
448
+ },
449
+ "flags-dir": {
450
+ "helpGroup": "GLOBAL",
451
+ "name": "flags-dir",
452
+ "summary": "Import flag values from a directory.",
453
+ "hasDynamicHelp": false,
454
+ "multiple": false,
455
+ "type": "option"
456
+ },
457
+ "target-org": {
458
+ "char": "o",
459
+ "description": "The username or alias of the Salesforce org containing the RFLIB base package.",
460
+ "name": "target-org",
461
+ "noCacheDefault": true,
462
+ "required": true,
463
+ "summary": "Username or alias of the target org.",
464
+ "hasDynamicHelp": true,
465
+ "multiple": false,
466
+ "type": "option"
467
+ },
468
+ "user-id": {
469
+ "char": "u",
470
+ "description": "The Salesforce User ID (15 or 18 characters) of the user whose permissions should be retrieved.",
471
+ "name": "user-id",
472
+ "required": true,
473
+ "summary": "Salesforce User ID (15 or 18 character) to check permissions for.",
474
+ "hasDynamicHelp": false,
475
+ "multiple": false,
476
+ "type": "option"
477
+ },
478
+ "permission-type": {
479
+ "char": "t",
480
+ "description": "Controls which permission types are returned:\n - FLS: Field-Level Security only\n - OLS: Object-Level Security only\n - APEX: Apex class and page access only\n - ALL: All three permission types",
481
+ "name": "permission-type",
482
+ "required": true,
483
+ "summary": "Type of permissions to retrieve: FLS, OLS, APEX, or ALL.",
484
+ "hasDynamicHelp": false,
485
+ "multiple": false,
486
+ "options": [
487
+ "FLS",
488
+ "OLS",
489
+ "APEX",
490
+ "ALL"
491
+ ],
492
+ "type": "option"
493
+ },
494
+ "sobject-type": {
495
+ "char": "b",
496
+ "description": "Filters Field-Level Security or Object-Level Security results to a specific SObject type, e.g. Account, Contact, Opportunity.",
497
+ "name": "sobject-type",
498
+ "summary": "Optional SObject API name to filter FLS or OLS results.",
499
+ "hasDynamicHelp": false,
500
+ "multiple": false,
501
+ "type": "option"
502
+ }
503
+ },
504
+ "hasDynamicHelp": true,
505
+ "hiddenAliases": [],
506
+ "id": "rflib:debug:userpermissions:get",
507
+ "pluginAlias": "rflib-plugin",
508
+ "pluginName": "rflib-plugin",
509
+ "pluginType": "core",
510
+ "strict": true,
511
+ "summary": "Check Salesforce permissions for a user in the target org.",
512
+ "enableJsonFlag": true,
513
+ "isESM": true,
514
+ "relativePath": [
515
+ "lib",
516
+ "commands",
517
+ "rflib",
518
+ "debug",
519
+ "userpermissions",
520
+ "get.js"
521
+ ],
522
+ "aliasPermutations": [],
523
+ "permutations": [
524
+ "rflib:debug:userpermissions:get",
525
+ "debug:rflib:userpermissions:get",
526
+ "debug:userpermissions:rflib:get",
527
+ "debug:userpermissions:get:rflib",
528
+ "rflib:userpermissions:debug:get",
529
+ "userpermissions:rflib:debug:get",
530
+ "userpermissions:debug:rflib:get",
531
+ "userpermissions:debug:get:rflib",
532
+ "rflib:userpermissions:get:debug",
533
+ "userpermissions:rflib:get:debug",
534
+ "userpermissions:get:rflib:debug",
535
+ "userpermissions:get:debug:rflib",
536
+ "rflib:debug:get:userpermissions",
537
+ "debug:rflib:get:userpermissions",
538
+ "debug:get:rflib:userpermissions",
539
+ "debug:get:userpermissions:rflib",
540
+ "rflib:get:debug:userpermissions",
541
+ "get:rflib:debug:userpermissions",
542
+ "get:debug:rflib:userpermissions",
543
+ "get:debug:userpermissions:rflib",
544
+ "rflib:get:userpermissions:debug",
545
+ "get:rflib:userpermissions:debug",
546
+ "get:userpermissions:rflib:debug",
547
+ "get:userpermissions:debug:rflib"
548
+ ]
549
+ },
231
550
  "rflib:logging:apex:instrument": {
232
551
  "aliases": [],
233
552
  "args": {},
@@ -389,325 +708,124 @@
389
708
  },
390
709
  "flags-dir": {
391
710
  "helpGroup": "GLOBAL",
392
- "name": "flags-dir",
393
- "summary": "Import flag values from a directory.",
394
- "hasDynamicHelp": false,
395
- "multiple": false,
396
- "type": "option"
397
- },
398
- "sourcepath": {
399
- "char": "s",
400
- "description": "Path to the source directory containing Aura components that should be instrumented with RFLIB logging statements. The command will:\n- Scan for 'aura' directories recursively\n- Process all Aura components found\n- Add <c:rflibLoggerCmp> to component files\n- Add logging statements to JavaScript files\n- Initialize logger in methods using component.find()",
401
- "name": "sourcepath",
402
- "required": true,
403
- "summary": "Directory containing Aura components to instrument with logging.",
404
- "hasDynamicHelp": false,
405
- "multiple": false,
406
- "type": "option"
407
- },
408
- "dryrun": {
409
- "char": "d",
410
- "description": "When enabled, shows which files would be modified without making actual changes. Useful for reviewing the impact before applying changes. Shows:\n- Files that would be modified\n- Number of processed files\n- Number of modified files\n- Number of formatted files",
411
- "name": "dryrun",
412
- "summary": "Preview changes without modifying files.",
413
- "allowNo": false,
414
- "type": "boolean"
415
- },
416
- "prettier": {
417
- "char": "p",
418
- "description": "When enabled, formats the modified JavaScript files using Prettier after adding logging statements. Maintains consistent code style with:\n- 120 character line width\n- 4 space indentation\n- Single quotes for strings\n- No tabs\n- No trailing commas",
419
- "name": "prettier",
420
- "summary": "Format modified files using Prettier.",
421
- "allowNo": false,
422
- "type": "boolean"
423
- },
424
- "no-if": {
425
- "description": "When provided, the command will not add log statements inside of `if` and `else` blocks.",
426
- "name": "no-if",
427
- "summary": "Exclude the instrumentation of if-else statements.",
428
- "allowNo": false,
429
- "type": "boolean"
430
- },
431
- "skip-instrumented": {
432
- "description": "When provided, the command will not add log statements to any Aura component that contains the `` component.",
433
- "name": "skip-instrumented",
434
- "summary": "Skips any files where a logger is already present.",
435
- "allowNo": false,
436
- "type": "boolean"
437
- },
438
- "verbose": {
439
- "char": "v",
440
- "description": "When provided with --dryrun, prints the paths of the files that would be modified.",
441
- "name": "verbose",
442
- "summary": "Enable verbose output.",
443
- "allowNo": false,
444
- "type": "boolean"
445
- },
446
- "exclude": {
447
- "char": "e",
448
- "description": "Exclude specific files or directories that match the provided glob pattern. For example, use --exclude \"**/Generated_*.cmp\" to skip auto-generated components.",
449
- "name": "exclude",
450
- "summary": "Exclude files or directories from instrumentation based on a glob pattern.",
451
- "hasDynamicHelp": false,
452
- "multiple": false,
453
- "type": "option"
454
- },
455
- "concurrency": {
456
- "char": "c",
457
- "description": "Controls the maximum number of files to process at the same time. This is useful in very large codebases to prevent excessive memory usage or file descriptor exhaustion. Defaults to 10.",
458
- "name": "concurrency",
459
- "summary": "Limits the number of files processed concurrently.",
460
- "default": 10,
461
- "hasDynamicHelp": false,
462
- "multiple": false,
463
- "type": "option"
464
- }
465
- },
466
- "hasDynamicHelp": false,
467
- "hiddenAliases": [],
468
- "id": "rflib:logging:aura:instrument",
469
- "pluginAlias": "rflib-plugin",
470
- "pluginName": "rflib-plugin",
471
- "pluginType": "core",
472
- "strict": true,
473
- "summary": "Instrument Aura Components with RFLIB logging statements automatically.",
474
- "enableJsonFlag": true,
475
- "isESM": true,
476
- "relativePath": [
477
- "lib",
478
- "commands",
479
- "rflib",
480
- "logging",
481
- "aura",
482
- "instrument.js"
483
- ],
484
- "aliasPermutations": [],
485
- "permutations": [
486
- "rflib:logging:aura:instrument",
487
- "logging:rflib:aura:instrument",
488
- "logging:aura:rflib:instrument",
489
- "logging:aura:instrument:rflib",
490
- "rflib:aura:logging:instrument",
491
- "aura:rflib:logging:instrument",
492
- "aura:logging:rflib:instrument",
493
- "aura:logging:instrument:rflib",
494
- "rflib:aura:instrument:logging",
495
- "aura:rflib:instrument:logging",
496
- "aura:instrument:rflib:logging",
497
- "aura:instrument:logging:rflib",
498
- "rflib:logging:instrument:aura",
499
- "logging:rflib:instrument:aura",
500
- "logging:instrument:rflib:aura",
501
- "logging:instrument:aura:rflib",
502
- "rflib:instrument:logging:aura",
503
- "instrument:rflib:logging:aura",
504
- "instrument:logging:rflib:aura",
505
- "instrument:logging:aura:rflib",
506
- "rflib:instrument:aura:logging",
507
- "instrument:rflib:aura:logging",
508
- "instrument:aura:rflib:logging",
509
- "instrument:aura:logging:rflib"
510
- ]
511
- },
512
- "rflib:debug:loggersettings:get": {
513
- "aliases": [],
514
- "args": {},
515
- "description": "Retrieves all rflib_Logger_Settings__c hierarchy custom setting records from the target org via the Salesforce REST API.\nReturns settings across org-wide defaults, profile overrides, and user overrides, along with embedded best-practice recommendations.\n\nUse \"sf rflib debug loggersettings update\" to apply changes.\n\nRequires the RFLIB base package to be installed in the target org and the running user to be assigned the rflib_Ops_Center_Access permission set (or have equivalent read access to rflib_Logger_Settings__c).\nFor installation instructions, visit: https://github.com/j-fischer/rflib",
516
- "examples": [
517
- "Read all logger settings from the target org:\n$ sf rflib debug loggersettings get --target-org myOrg"
518
- ],
519
- "flags": {
520
- "json": {
521
- "description": "Format output as json.",
522
- "helpGroup": "GLOBAL",
523
- "name": "json",
524
- "allowNo": false,
525
- "type": "boolean"
526
- },
527
- "flags-dir": {
528
- "helpGroup": "GLOBAL",
529
- "name": "flags-dir",
530
- "summary": "Import flag values from a directory.",
531
- "hasDynamicHelp": false,
532
- "multiple": false,
533
- "type": "option"
534
- },
535
- "target-org": {
536
- "char": "o",
537
- "description": "The username or alias of the Salesforce org containing the RFLIB base package.",
538
- "name": "target-org",
539
- "noCacheDefault": true,
540
- "required": true,
541
- "summary": "Username or alias of the target org.",
542
- "hasDynamicHelp": true,
543
- "multiple": false,
544
- "type": "option"
545
- }
546
- },
547
- "hasDynamicHelp": true,
548
- "hiddenAliases": [],
549
- "id": "rflib:debug:loggersettings:get",
550
- "pluginAlias": "rflib-plugin",
551
- "pluginName": "rflib-plugin",
552
- "pluginType": "core",
553
- "strict": true,
554
- "summary": "Read all RFLIB Logger Settings from a Salesforce org.",
555
- "enableJsonFlag": true,
556
- "isESM": true,
557
- "relativePath": [
558
- "lib",
559
- "commands",
560
- "rflib",
561
- "debug",
562
- "loggersettings",
563
- "get.js"
564
- ],
565
- "aliasPermutations": [],
566
- "permutations": [
567
- "rflib:debug:loggersettings:get",
568
- "debug:rflib:loggersettings:get",
569
- "debug:loggersettings:rflib:get",
570
- "debug:loggersettings:get:rflib",
571
- "rflib:loggersettings:debug:get",
572
- "loggersettings:rflib:debug:get",
573
- "loggersettings:debug:rflib:get",
574
- "loggersettings:debug:get:rflib",
575
- "rflib:loggersettings:get:debug",
576
- "loggersettings:rflib:get:debug",
577
- "loggersettings:get:rflib:debug",
578
- "loggersettings:get:debug:rflib",
579
- "rflib:debug:get:loggersettings",
580
- "debug:rflib:get:loggersettings",
581
- "debug:get:rflib:loggersettings",
582
- "debug:get:loggersettings:rflib",
583
- "rflib:get:debug:loggersettings",
584
- "get:rflib:debug:loggersettings",
585
- "get:debug:rflib:loggersettings",
586
- "get:debug:loggersettings:rflib",
587
- "rflib:get:loggersettings:debug",
588
- "get:rflib:loggersettings:debug",
589
- "get:loggersettings:rflib:debug",
590
- "get:loggersettings:debug:rflib"
591
- ]
592
- },
593
- "rflib:debug:loggersettings:update": {
594
- "aliases": [],
595
- "args": {},
596
- "description": "Creates or updates a single field on an rflib_Logger_Settings__c record in the target org via the Salesforce REST API.\nValidates field values and warns about best-practice violations.\n\nTo update an existing record, provide --record-id. To create a new record, provide --setup-owner-id with an org ID (00D...), profile ID (00E...), or user ID.\n\nRequires the RFLIB base package to be installed in the target org and the running user to be assigned the rflib_Ops_Center_Access permission set (or have equivalent update access to rflib_Logger_Settings__c).\nFor installation instructions, visit: https://github.com/j-fischer/rflib",
597
- "examples": [
598
- "Update the Log_Event_Reporting_Level__c field on an existing record:\n$ sf rflib debug loggersettings update --target-org myOrg --record-id a0A000000001234 --field-name Log_Event_Reporting_Level__c --field-value WARN",
599
- "Create a new org-wide Logger Setting:\n$ sf rflib debug loggersettings update --target-org myOrg --setup-owner-id 00D000000000001 --field-name Log_Event_Reporting_Level__c --field-value WARN"
600
- ],
601
- "flags": {
602
- "json": {
603
- "description": "Format output as json.",
604
- "helpGroup": "GLOBAL",
605
- "name": "json",
606
- "allowNo": false,
607
- "type": "boolean"
608
- },
609
- "flags-dir": {
610
- "helpGroup": "GLOBAL",
611
- "name": "flags-dir",
612
- "summary": "Import flag values from a directory.",
613
- "hasDynamicHelp": false,
614
- "multiple": false,
615
- "type": "option"
616
- },
617
- "target-org": {
618
- "char": "o",
619
- "description": "The username or alias of the Salesforce org containing the RFLIB base package.",
620
- "name": "target-org",
621
- "noCacheDefault": true,
622
- "required": true,
623
- "summary": "Username or alias of the target org.",
624
- "hasDynamicHelp": true,
711
+ "name": "flags-dir",
712
+ "summary": "Import flag values from a directory.",
713
+ "hasDynamicHelp": false,
625
714
  "multiple": false,
626
715
  "type": "option"
627
716
  },
628
- "field-name": {
629
- "char": "f",
630
- "description": "The API name of the field to create or update, e.g. Log_Event_Reporting_Level__c. For log level fields, valid values are: TRACE, DEBUG, INFO, WARN, ERROR, FATAL, NONE.",
631
- "name": "field-name",
717
+ "sourcepath": {
718
+ "char": "s",
719
+ "description": "Path to the source directory containing Aura components that should be instrumented with RFLIB logging statements. The command will:\n- Scan for 'aura' directories recursively\n- Process all Aura components found\n- Add <c:rflibLoggerCmp> to component files\n- Add logging statements to JavaScript files\n- Initialize logger in methods using component.find()",
720
+ "name": "sourcepath",
632
721
  "required": true,
633
- "summary": "API name of the rflib_Logger_Settings__c field to update.",
722
+ "summary": "Directory containing Aura components to instrument with logging.",
634
723
  "hasDynamicHelp": false,
635
724
  "multiple": false,
636
725
  "type": "option"
637
726
  },
638
- "field-value": {
727
+ "dryrun": {
728
+ "char": "d",
729
+ "description": "When enabled, shows which files would be modified without making actual changes. Useful for reviewing the impact before applying changes. Shows:\n- Files that would be modified\n- Number of processed files\n- Number of modified files\n- Number of formatted files",
730
+ "name": "dryrun",
731
+ "summary": "Preview changes without modifying files.",
732
+ "allowNo": false,
733
+ "type": "boolean"
734
+ },
735
+ "prettier": {
736
+ "char": "p",
737
+ "description": "When enabled, formats the modified JavaScript files using Prettier after adding logging statements. Maintains consistent code style with:\n- 120 character line width\n- 4 space indentation\n- Single quotes for strings\n- No tabs\n- No trailing commas",
738
+ "name": "prettier",
739
+ "summary": "Format modified files using Prettier.",
740
+ "allowNo": false,
741
+ "type": "boolean"
742
+ },
743
+ "no-if": {
744
+ "description": "When provided, the command will not add log statements inside of `if` and `else` blocks.",
745
+ "name": "no-if",
746
+ "summary": "Exclude the instrumentation of if-else statements.",
747
+ "allowNo": false,
748
+ "type": "boolean"
749
+ },
750
+ "skip-instrumented": {
751
+ "description": "When provided, the command will not add log statements to any Aura component that contains the `` component.",
752
+ "name": "skip-instrumented",
753
+ "summary": "Skips any files where a logger is already present.",
754
+ "allowNo": false,
755
+ "type": "boolean"
756
+ },
757
+ "verbose": {
639
758
  "char": "v",
640
- "description": "The new value to set on the specified field. For log level fields, valid values are: TRACE, DEBUG, INFO, WARN, ERROR, FATAL, NONE.",
641
- "name": "field-value",
642
- "required": true,
643
- "summary": "New value for the specified field.",
644
- "hasDynamicHelp": false,
645
- "multiple": false,
646
- "type": "option"
759
+ "description": "When provided with --dryrun, prints the paths of the files that would be modified.",
760
+ "name": "verbose",
761
+ "summary": "Enable verbose output.",
762
+ "allowNo": false,
763
+ "type": "boolean"
647
764
  },
648
- "record-id": {
649
- "char": "r",
650
- "description": "The Salesforce record ID of an existing rflib_Logger_Settings__c record to update. Omit this flag to create a new record (requires --setup-owner-id).",
651
- "name": "record-id",
652
- "summary": "ID of an existing rflib_Logger_Settings__c record to update.",
765
+ "exclude": {
766
+ "char": "e",
767
+ "description": "Exclude specific files or directories that match the provided glob pattern. For example, use --exclude \"**/Generated_*.cmp\" to skip auto-generated components.",
768
+ "name": "exclude",
769
+ "summary": "Exclude files or directories from instrumentation based on a glob pattern.",
653
770
  "hasDynamicHelp": false,
654
771
  "multiple": false,
655
772
  "type": "option"
656
773
  },
657
- "setup-owner-id": {
658
- "char": "s",
659
- "description": "Required when creating a new Logger Setting record. Accepts an org ID (00D...), profile ID (00E...), or user ID. Read existing record IDs using \"sf rflib debug loggersettings get\".",
660
- "name": "setup-owner-id",
661
- "summary": "Setup owner ID for creating a new Logger Setting record.",
774
+ "concurrency": {
775
+ "char": "c",
776
+ "description": "Controls the maximum number of files to process at the same time. This is useful in very large codebases to prevent excessive memory usage or file descriptor exhaustion. Defaults to 10.",
777
+ "name": "concurrency",
778
+ "summary": "Limits the number of files processed concurrently.",
779
+ "default": 10,
662
780
  "hasDynamicHelp": false,
663
781
  "multiple": false,
664
782
  "type": "option"
665
783
  }
666
784
  },
667
- "hasDynamicHelp": true,
785
+ "hasDynamicHelp": false,
668
786
  "hiddenAliases": [],
669
- "id": "rflib:debug:loggersettings:update",
787
+ "id": "rflib:logging:aura:instrument",
670
788
  "pluginAlias": "rflib-plugin",
671
789
  "pluginName": "rflib-plugin",
672
790
  "pluginType": "core",
673
791
  "strict": true,
674
- "summary": "Create or update an RFLIB Logger Setting in a Salesforce org.",
792
+ "summary": "Instrument Aura Components with RFLIB logging statements automatically.",
675
793
  "enableJsonFlag": true,
676
794
  "isESM": true,
677
795
  "relativePath": [
678
796
  "lib",
679
797
  "commands",
680
798
  "rflib",
681
- "debug",
682
- "loggersettings",
683
- "update.js"
799
+ "logging",
800
+ "aura",
801
+ "instrument.js"
684
802
  ],
685
803
  "aliasPermutations": [],
686
804
  "permutations": [
687
- "rflib:debug:loggersettings:update",
688
- "debug:rflib:loggersettings:update",
689
- "debug:loggersettings:rflib:update",
690
- "debug:loggersettings:update:rflib",
691
- "rflib:loggersettings:debug:update",
692
- "loggersettings:rflib:debug:update",
693
- "loggersettings:debug:rflib:update",
694
- "loggersettings:debug:update:rflib",
695
- "rflib:loggersettings:update:debug",
696
- "loggersettings:rflib:update:debug",
697
- "loggersettings:update:rflib:debug",
698
- "loggersettings:update:debug:rflib",
699
- "rflib:debug:update:loggersettings",
700
- "debug:rflib:update:loggersettings",
701
- "debug:update:rflib:loggersettings",
702
- "debug:update:loggersettings:rflib",
703
- "rflib:update:debug:loggersettings",
704
- "update:rflib:debug:loggersettings",
705
- "update:debug:rflib:loggersettings",
706
- "update:debug:loggersettings:rflib",
707
- "rflib:update:loggersettings:debug",
708
- "update:rflib:loggersettings:debug",
709
- "update:loggersettings:rflib:debug",
710
- "update:loggersettings:debug:rflib"
805
+ "rflib:logging:aura:instrument",
806
+ "logging:rflib:aura:instrument",
807
+ "logging:aura:rflib:instrument",
808
+ "logging:aura:instrument:rflib",
809
+ "rflib:aura:logging:instrument",
810
+ "aura:rflib:logging:instrument",
811
+ "aura:logging:rflib:instrument",
812
+ "aura:logging:instrument:rflib",
813
+ "rflib:aura:instrument:logging",
814
+ "aura:rflib:instrument:logging",
815
+ "aura:instrument:rflib:logging",
816
+ "aura:instrument:logging:rflib",
817
+ "rflib:logging:instrument:aura",
818
+ "logging:rflib:instrument:aura",
819
+ "logging:instrument:rflib:aura",
820
+ "logging:instrument:aura:rflib",
821
+ "rflib:instrument:logging:aura",
822
+ "instrument:rflib:logging:aura",
823
+ "instrument:logging:rflib:aura",
824
+ "instrument:logging:aura:rflib",
825
+ "rflib:instrument:aura:logging",
826
+ "instrument:rflib:aura:logging",
827
+ "instrument:aura:rflib:logging",
828
+ "instrument:aura:logging:rflib"
711
829
  ]
712
830
  },
713
831
  "rflib:logging:flow:instrument": {
@@ -970,125 +1088,7 @@
970
1088
  "instrument:lwc:rflib:logging",
971
1089
  "instrument:lwc:logging:rflib"
972
1090
  ]
973
- },
974
- "rflib:debug:userpermissions:get": {
975
- "aliases": [],
976
- "args": {},
977
- "description": "Retrieves FLS (Field-Level Security), OLS (Object-Level Security), and Apex class/page permissions for a specific user\nvia the Salesforce REST API. Permissions are aggregated across the user's profile, permission sets, and permission set groups.\n\nUse --sobject-type to narrow FLS or OLS results to a specific SObject.\n\nRequires the RFLIB base package to be installed in the target org and the running user to be assigned the rflib_Ops_Center_Access permission set (or have equivalent read access to the relevant permission objects).\nFor installation instructions, visit: https://github.com/j-fischer/rflib",
978
- "examples": [
979
- "Check all permissions for a user:\n$ sf rflib debug userpermissions get --target-org myOrg --user-id 0057000000XXXXXX --permission-type ALL",
980
- "Check FLS for a specific object:\n$ sf rflib debug userpermissions get --target-org myOrg --user-id 0057000000XXXXXX --permission-type FLS --sobject-type Account",
981
- "Check Apex access:\n$ sf rflib debug userpermissions get --target-org myOrg --user-id 0057000000XXXXXX --permission-type APEX"
982
- ],
983
- "flags": {
984
- "json": {
985
- "description": "Format output as json.",
986
- "helpGroup": "GLOBAL",
987
- "name": "json",
988
- "allowNo": false,
989
- "type": "boolean"
990
- },
991
- "flags-dir": {
992
- "helpGroup": "GLOBAL",
993
- "name": "flags-dir",
994
- "summary": "Import flag values from a directory.",
995
- "hasDynamicHelp": false,
996
- "multiple": false,
997
- "type": "option"
998
- },
999
- "target-org": {
1000
- "char": "o",
1001
- "description": "The username or alias of the Salesforce org containing the RFLIB base package.",
1002
- "name": "target-org",
1003
- "noCacheDefault": true,
1004
- "required": true,
1005
- "summary": "Username or alias of the target org.",
1006
- "hasDynamicHelp": true,
1007
- "multiple": false,
1008
- "type": "option"
1009
- },
1010
- "user-id": {
1011
- "char": "u",
1012
- "description": "The Salesforce User ID (15 or 18 characters) of the user whose permissions should be retrieved.",
1013
- "name": "user-id",
1014
- "required": true,
1015
- "summary": "Salesforce User ID (15 or 18 character) to check permissions for.",
1016
- "hasDynamicHelp": false,
1017
- "multiple": false,
1018
- "type": "option"
1019
- },
1020
- "permission-type": {
1021
- "char": "t",
1022
- "description": "Controls which permission types are returned:\n - FLS: Field-Level Security only\n - OLS: Object-Level Security only\n - APEX: Apex class and page access only\n - ALL: All three permission types",
1023
- "name": "permission-type",
1024
- "required": true,
1025
- "summary": "Type of permissions to retrieve: FLS, OLS, APEX, or ALL.",
1026
- "hasDynamicHelp": false,
1027
- "multiple": false,
1028
- "options": [
1029
- "FLS",
1030
- "OLS",
1031
- "APEX",
1032
- "ALL"
1033
- ],
1034
- "type": "option"
1035
- },
1036
- "sobject-type": {
1037
- "char": "b",
1038
- "description": "Filters Field-Level Security or Object-Level Security results to a specific SObject type, e.g. Account, Contact, Opportunity.",
1039
- "name": "sobject-type",
1040
- "summary": "Optional SObject API name to filter FLS or OLS results.",
1041
- "hasDynamicHelp": false,
1042
- "multiple": false,
1043
- "type": "option"
1044
- }
1045
- },
1046
- "hasDynamicHelp": true,
1047
- "hiddenAliases": [],
1048
- "id": "rflib:debug:userpermissions:get",
1049
- "pluginAlias": "rflib-plugin",
1050
- "pluginName": "rflib-plugin",
1051
- "pluginType": "core",
1052
- "strict": true,
1053
- "summary": "Check Salesforce permissions for a user in the target org.",
1054
- "enableJsonFlag": true,
1055
- "isESM": true,
1056
- "relativePath": [
1057
- "lib",
1058
- "commands",
1059
- "rflib",
1060
- "debug",
1061
- "userpermissions",
1062
- "get.js"
1063
- ],
1064
- "aliasPermutations": [],
1065
- "permutations": [
1066
- "rflib:debug:userpermissions:get",
1067
- "debug:rflib:userpermissions:get",
1068
- "debug:userpermissions:rflib:get",
1069
- "debug:userpermissions:get:rflib",
1070
- "rflib:userpermissions:debug:get",
1071
- "userpermissions:rflib:debug:get",
1072
- "userpermissions:debug:rflib:get",
1073
- "userpermissions:debug:get:rflib",
1074
- "rflib:userpermissions:get:debug",
1075
- "userpermissions:rflib:get:debug",
1076
- "userpermissions:get:rflib:debug",
1077
- "userpermissions:get:debug:rflib",
1078
- "rflib:debug:get:userpermissions",
1079
- "debug:rflib:get:userpermissions",
1080
- "debug:get:rflib:userpermissions",
1081
- "debug:get:userpermissions:rflib",
1082
- "rflib:get:debug:userpermissions",
1083
- "get:rflib:debug:userpermissions",
1084
- "get:debug:rflib:userpermissions",
1085
- "get:debug:userpermissions:rflib",
1086
- "rflib:get:userpermissions:debug",
1087
- "get:rflib:userpermissions:debug",
1088
- "get:userpermissions:rflib:debug",
1089
- "get:userpermissions:debug:rflib"
1090
- ]
1091
1091
  }
1092
1092
  },
1093
- "version": "0.19.5"
1093
+ "version": "0.19.6"
1094
1094
  }