@nickchristensen/ppls 1.1.0 → 1.2.0

package/README.md

@@ -75,7 +75,7 @@ $ ppls config get hostname
 * [`ppls document-types update ID`](#ppls-document-types-update-id)
 * [`ppls documents add [PATH]`](#ppls-documents-add-path)
 * [`ppls documents delete ID`](#ppls-documents-delete-id)
-* [`ppls documents download ID`](#ppls-documents-download-id)
+* [`ppls documents download [ID]`](#ppls-documents-download-id)
 * [`ppls documents list`](#ppls-documents-list)
 * [`ppls documents show ID`](#ppls-documents-show-id)
 * [`ppls documents update ID`](#ppls-documents-update-id)
@@ -108,7 +108,7 @@ EXAMPLES
   $ ppls config get hostname
 ```
 
-_See code: [src/commands/config/get.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/config/get.ts)_
+_See code: [src/commands/config/get.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/config/get.ts)_
 
 ## `ppls config init`
 
@@ -131,7 +131,7 @@ EXAMPLES
   $ ppls config init
 ```
 
-_See code: [src/commands/config/init.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/config/init.ts)_
+_See code: [src/commands/config/init.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/config/init.ts)_
 
 ## `ppls config list`
 
@@ -155,7 +155,7 @@ EXAMPLES
   $ ppls config list
 ```
 
-_See code: [src/commands/config/list.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/config/list.ts)_
+_See code: [src/commands/config/list.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/config/list.ts)_
 
 ## `ppls config remove KEY`
 
@@ -178,7 +178,7 @@ EXAMPLES
   $ ppls config remove token
 ```
 
-_See code: [src/commands/config/remove.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/config/remove.ts)_
+_See code: [src/commands/config/remove.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/config/remove.ts)_
 
 ## `ppls config set KEY VALUE`
 
@@ -204,7 +204,7 @@ EXAMPLES
   $ ppls config set headers '{"X-Api-Key":"token"}'
 ```
 
-_See code: [src/commands/config/set.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/config/set.ts)_
+_See code: [src/commands/config/set.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/config/set.ts)_
 
 ## `ppls correspondents add NAME`
 
@@ -236,7 +236,7 @@ EXAMPLES
   $ ppls correspondents add "Acme Corp"
 ```
 
-_See code: [src/commands/correspondents/add.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/correspondents/add.ts)_
+_See code: [src/commands/correspondents/add.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/correspondents/add.ts)_
 
 ## `ppls correspondents delete ID`
 
@@ -271,7 +271,7 @@ EXAMPLES
   $ ppls correspondents delete 123
 ```
 
-_See code: [src/commands/correspondents/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/correspondents/delete.ts)_
+_See code: [src/commands/correspondents/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/correspondents/delete.ts)_
 
 ## `ppls correspondents list`
 
@@ -280,15 +280,13 @@ List correspondents
 ```
 USAGE
   $ ppls correspondents list [--date-format <value>] [--header <value>...] [--hostname <value>] [--plain | --json |
-    --table] [--token <value>] [--id-in <value> | --name-contains <value>] [--page <value> --page-size <value>] [--sort
-    <value>]
+    --table] [--token <value>] [--id-in <value>... | --name-contains <value>] [--page <value> --page-size <value>]
+    [--sort <value>]
 
 FLAGS
-  --id-in=<value>          Filter by id list (comma-separated)
-  --name-contains=<value>  Filter by name substring
-  --page=<value>           Page number to fetch
-  --page-size=<value>      [default: disable pagination, all results] Number of results per page
-  --sort=<value>           Sort results by the provided field
+  --page=<value>       Page number to fetch
+  --page-size=<value>  [default: disable pagination, all results] Number of results per page
+  --sort=<value>       Sort results by the provided field
 
 GLOBAL FLAGS
   --date-format=<value>  [default: yyyy-MM-dd, env: PPLS_DATE_FORMAT] Format output dates using a template.
@@ -301,6 +299,10 @@ ENVIRONMENT FLAGS
   --hostname=<value>   [env: PPLS_HOSTNAME] Paperless-ngx base URL
   --token=<value>      [env: PPLS_TOKEN] Paperless-ngx API token
 
+FILTER FLAGS
+  --id-in=<value>...       Filter by id list (repeatable or comma-separated)
+  --name-contains=<value>  Filter by name substring
+
 DESCRIPTION
   List correspondents
 
@@ -308,7 +310,7 @@ EXAMPLES
   $ ppls correspondents list
 ```
 
-_See code: [src/commands/correspondents/list.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/correspondents/list.ts)_
+_See code: [src/commands/correspondents/list.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/correspondents/list.ts)_
 
 ## `ppls correspondents show ID`
 
@@ -340,7 +342,7 @@ EXAMPLES
   $ ppls correspondents show 123
 ```
 
-_See code: [src/commands/correspondents/show.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/correspondents/show.ts)_
+_See code: [src/commands/correspondents/show.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/correspondents/show.ts)_
 
 ## `ppls correspondents update ID`
 
@@ -375,7 +377,7 @@ EXAMPLES
   $ ppls correspondents update 123 --name "Acme Corp"
 ```
 
-_See code: [src/commands/correspondents/update.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/correspondents/update.ts)_
+_See code: [src/commands/correspondents/update.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/correspondents/update.ts)_
 
 ## `ppls custom-fields add NAME`
 
@@ -413,7 +415,7 @@ EXAMPLES
   $ ppls custom-fields add "Due Date" --data-type date
 ```
 
-_See code: [src/commands/custom-fields/add.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/custom-fields/add.ts)_
+_See code: [src/commands/custom-fields/add.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/custom-fields/add.ts)_
 
 ## `ppls custom-fields delete ID`
 
@@ -448,7 +450,7 @@ EXAMPLES
   $ ppls custom-fields delete 123
 ```
 
-_See code: [src/commands/custom-fields/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/custom-fields/delete.ts)_
+_See code: [src/commands/custom-fields/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/custom-fields/delete.ts)_
 
 ## `ppls custom-fields list`
 
@@ -457,15 +459,13 @@ List custom fields
 ```
 USAGE
   $ ppls custom-fields list [--date-format <value>] [--header <value>...] [--hostname <value>] [--plain | --json |
-    --table] [--token <value>] [--id-in <value> | --name-contains <value>] [--page <value> --page-size <value>] [--sort
-    <value>]
+    --table] [--token <value>] [--id-in <value>... | --name-contains <value>] [--page <value> --page-size <value>]
+    [--sort <value>]
 
 FLAGS
-  --id-in=<value>          Filter by id list (comma-separated)
-  --name-contains=<value>  Filter by name substring
-  --page=<value>           Page number to fetch
-  --page-size=<value>      [default: disable pagination, all results] Number of results per page
-  --sort=<value>           Sort results by the provided field
+  --page=<value>       Page number to fetch
+  --page-size=<value>  [default: disable pagination, all results] Number of results per page
+  --sort=<value>       Sort results by the provided field
 
 GLOBAL FLAGS
   --date-format=<value>  [default: yyyy-MM-dd, env: PPLS_DATE_FORMAT] Format output dates using a template.
@@ -478,6 +478,10 @@ ENVIRONMENT FLAGS
   --hostname=<value>   [env: PPLS_HOSTNAME] Paperless-ngx base URL
   --token=<value>      [env: PPLS_TOKEN] Paperless-ngx API token
 
+FILTER FLAGS
+  --id-in=<value>...       Filter by id list (repeatable or comma-separated)
+  --name-contains=<value>  Filter by name substring
+
 DESCRIPTION
   List custom fields
 
@@ -485,7 +489,7 @@ EXAMPLES
   $ ppls custom-fields list
 ```
 
-_See code: [src/commands/custom-fields/list.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/custom-fields/list.ts)_
+_See code: [src/commands/custom-fields/list.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/custom-fields/list.ts)_
 
 ## `ppls custom-fields show ID`
 
@@ -517,7 +521,7 @@ EXAMPLES
   $ ppls custom-fields show 123
 ```
 
-_See code: [src/commands/custom-fields/show.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/custom-fields/show.ts)_
+_See code: [src/commands/custom-fields/show.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/custom-fields/show.ts)_
 
 ## `ppls custom-fields update ID`
 
@@ -556,7 +560,7 @@ EXAMPLES
   $ ppls custom-fields update 123 --name "Due Date"
 ```
 
-_See code: [src/commands/custom-fields/update.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/custom-fields/update.ts)_
+_See code: [src/commands/custom-fields/update.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/custom-fields/update.ts)_
 
 ## `ppls document-types add NAME`
 
@@ -588,7 +592,7 @@ EXAMPLES
   $ ppls document-types add "Invoice"
 ```
 
-_See code: [src/commands/document-types/add.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/document-types/add.ts)_
+_See code: [src/commands/document-types/add.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/document-types/add.ts)_
 
 ## `ppls document-types delete ID`
 
@@ -623,7 +627,7 @@ EXAMPLES
   $ ppls document-types delete 123
 ```
 
-_See code: [src/commands/document-types/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/document-types/delete.ts)_
+_See code: [src/commands/document-types/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/document-types/delete.ts)_
 
 ## `ppls document-types list`
 
@@ -632,15 +636,13 @@ List document types
 ```
 USAGE
   $ ppls document-types list [--date-format <value>] [--header <value>...] [--hostname <value>] [--plain | --json |
-    --table] [--token <value>] [--id-in <value> | --name-contains <value>] [--page <value> --page-size <value>] [--sort
-    <value>]
+    --table] [--token <value>] [--id-in <value>... | --name-contains <value>] [--page <value> --page-size <value>]
+    [--sort <value>]
 
 FLAGS
-  --id-in=<value>          Filter by id list (comma-separated)
-  --name-contains=<value>  Filter by name substring
-  --page=<value>           Page number to fetch
-  --page-size=<value>      [default: disable pagination, all results] Number of results per page
-  --sort=<value>           Sort results by the provided field
+  --page=<value>       Page number to fetch
+  --page-size=<value>  [default: disable pagination, all results] Number of results per page
+  --sort=<value>       Sort results by the provided field
 
 GLOBAL FLAGS
   --date-format=<value>  [default: yyyy-MM-dd, env: PPLS_DATE_FORMAT] Format output dates using a template.
@@ -653,6 +655,10 @@ ENVIRONMENT FLAGS
   --hostname=<value>   [env: PPLS_HOSTNAME] Paperless-ngx base URL
   --token=<value>      [env: PPLS_TOKEN] Paperless-ngx API token
 
+FILTER FLAGS
+  --id-in=<value>...       Filter by id list (repeatable or comma-separated)
+  --name-contains=<value>  Filter by name substring
+
 DESCRIPTION
   List document types
 
@@ -660,7 +666,7 @@ EXAMPLES
   $ ppls document-types list
 ```
 
-_See code: [src/commands/document-types/list.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/document-types/list.ts)_
+_See code: [src/commands/document-types/list.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/document-types/list.ts)_
 
 ## `ppls document-types show ID`
 
@@ -692,7 +698,7 @@ EXAMPLES
   $ ppls document-types show 123
 ```
 
-_See code: [src/commands/document-types/show.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/document-types/show.ts)_
+_See code: [src/commands/document-types/show.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/document-types/show.ts)_
 
 ## `ppls document-types update ID`
 
@@ -727,7 +733,7 @@ EXAMPLES
   $ ppls document-types update 123 --name "Invoice"
 ```
 
-_See code: [src/commands/document-types/update.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/document-types/update.ts)_
+_See code: [src/commands/document-types/update.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/document-types/update.ts)_
 
 ## `ppls documents add [PATH]`
 
@@ -769,7 +775,7 @@ EXAMPLES
   $ ppls documents add ./receipt.pdf --title "Receipt"
 ```
 
-_See code: [src/commands/documents/add.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/documents/add.ts)_
+_See code: [src/commands/documents/add.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/documents/add.ts)_
 
 ## `ppls documents delete ID`
 
@@ -804,19 +810,19 @@ EXAMPLES
   $ ppls documents delete 123
 ```
 
-_See code: [src/commands/documents/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/documents/delete.ts)_
+_See code: [src/commands/documents/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/documents/delete.ts)_
 
-## `ppls documents download ID`
+## `ppls documents download [ID]`
 
 Download one or more documents
 
 ```
 USAGE
-  $ ppls documents download ID [--date-format <value>] [--header <value>...] [--hostname <value>] [--plain | --json |
-    --table] [--token <value>] [--original] [-o <value> | --output-dir <value>]
+  $ ppls documents download [ID...] [--date-format <value>] [--header <value>...] [--hostname <value>] [--plain | --json
+    | --table] [--token <value>] [--original] [-o <value> | --output-dir <value>]
 
 ARGUMENTS
-  ID  Document id or comma-separated list of ids
+  [ID...]  Document id (repeatable or comma-separated)
 
 FLAGS
   -o, --output=<value>      Output file path (single document)
@@ -838,12 +844,14 @@ DESCRIPTION
   Download one or more documents
 
 EXAMPLES
-  $ ppls documents download 123 --output document.pdf
+  $ ppls documents download --output document.pdf 123
 
-  $ ppls documents download 123,124 --output-dir ./downloads
+  $ ppls documents download --output-dir ./downloads 123 456
+
+  $ ppls documents download --output-dir ./downloads 123,456
 ```
 
-_See code: [src/commands/documents/download.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/documents/download.ts)_
+_See code: [src/commands/documents/download.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/documents/download.ts)_
 
 ## `ppls documents list`
 
@@ -852,15 +860,37 @@ List documents
 ```
 USAGE
   $ ppls documents list [--date-format <value>] [--header <value>...] [--hostname <value>] [--plain | --json |
-    --table] [--token <value>] [--id-in <value> | --name-contains <value>] [--page <value> --page-size <value>] [--sort
-    <value>]
+    --table] [--token <value>] [--page <value> --page-size <value>] [--sort <value>] [--added-after YYYY-MM-DD|ISO-8601
+    | [--id-in <value>... | --name-contains <value>]] [--added-before YYYY-MM-DD|ISO-8601 | ] [--created-after
+    YYYY-MM-DD|ISO-8601 | ] [--created-before YYYY-MM-DD|ISO-8601 | ] [--modified-after YYYY-MM-DD|ISO-8601 | ]
+    [--modified-before YYYY-MM-DD|ISO-8601 | ] [--no-correspondent | [--correspondent <value>... | ] |
+    [--correspondent-not <value>... | ] | ] [--no-document-type | [--document-type <value>... | ] | [--document-type-not
+    <value>... | ] | ] [--no-tag | --tag <value>... | --tag-all <value>... | --tag-not <value>... | ]
 
 FLAGS
-  --id-in=<value>          Filter by id list (comma-separated)
-  --name-contains=<value>  Filter by name substring
-  --page=<value>           Page number to fetch
-  --page-size=<value>      [default: disable pagination, all results] Number of results per page
-  --sort=<value>           Sort results by the provided field
+  --page=<value>       Page number to fetch
+  --page-size=<value>  [default: disable pagination, all results] Number of results per page
+  --sort=<value>       Sort results by the provided field
+
+FILTER FLAGS
+  --added-after=YYYY-MM-DD|ISO-8601      Filter by added date (YYYY-MM-DD) or datetime (ISO 8601) >= value
+  --added-before=YYYY-MM-DD|ISO-8601     Filter by added date (YYYY-MM-DD) or datetime (ISO 8601) <= value
+  --correspondent=<value>...             Filter by correspondent ids (repeatable or comma-separated)
+  --correspondent-not=<value>...         Exclude correspondent ids (repeatable or comma-separated)
+  --created-after=YYYY-MM-DD|ISO-8601    Filter by created date (YYYY-MM-DD) or datetime (ISO 8601) >= value
+  --created-before=YYYY-MM-DD|ISO-8601   Filter by created date (YYYY-MM-DD) or datetime (ISO 8601) <= value
+  --document-type=<value>...             Filter by document type ids (repeatable or comma-separated)
+  --document-type-not=<value>...         Exclude document type ids (repeatable or comma-separated)
+  --id-in=<value>...                     Filter by id list (repeatable or comma-separated)
+  --modified-after=YYYY-MM-DD|ISO-8601   Filter by modified date (YYYY-MM-DD) or datetime (ISO 8601) >= value
+  --modified-before=YYYY-MM-DD|ISO-8601  Filter by modified date (YYYY-MM-DD) or datetime (ISO 8601) <= value
+  --name-contains=<value>                Filter by name substring
+  --no-correspondent                     Filter documents with no correspondent
+  --no-document-type                     Filter documents with no document type
+  --no-tag                               Filter documents with no tags
+  --tag=<value>...                       Filter by tag ids (repeatable or comma-separated, OR)
+  --tag-all=<value>...                   Filter by tag ids (repeatable or comma-separated, AND)
+  --tag-not=<value>...                   Exclude tag ids (repeatable or comma-separated)
 
 GLOBAL FLAGS
   --date-format=<value>  [default: yyyy-MM-dd, env: PPLS_DATE_FORMAT] Format output dates using a template.
@@ -880,7 +910,7 @@ EXAMPLES
   $ ppls documents list
 ```
 
-_See code: [src/commands/documents/list.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/documents/list.ts)_
+_See code: [src/commands/documents/list.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/documents/list.ts)_
 
 ## `ppls documents show ID`
 
@@ -912,7 +942,7 @@ EXAMPLES
   $ ppls documents show 123
 ```
 
-_See code: [src/commands/documents/show.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/documents/show.ts)_
+_See code: [src/commands/documents/show.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/documents/show.ts)_
 
 ## `ppls documents update ID`
 
@@ -955,7 +985,7 @@ EXAMPLES
   $ ppls documents update 123 --title "Receipt"
 ```
 
-_See code: [src/commands/documents/update.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/documents/update.ts)_
+_See code: [src/commands/documents/update.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/documents/update.ts)_
 
 ## `ppls help [COMMAND]`
 
@@ -1007,7 +1037,7 @@ EXAMPLES
   $ ppls profile
 ```
 
-_See code: [src/commands/profile.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/profile.ts)_
+_See code: [src/commands/profile.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/profile.ts)_
 
 ## `ppls tags add NAME`
 
@@ -1044,7 +1074,7 @@ EXAMPLES
   $ ppls tags add Inbox
 ```
 
-_See code: [src/commands/tags/add.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/tags/add.ts)_
+_See code: [src/commands/tags/add.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/tags/add.ts)_
 
 ## `ppls tags delete ID`
 
@@ -1079,7 +1109,7 @@ EXAMPLES
   $ ppls tags delete 123
 ```
 
-_See code: [src/commands/tags/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/tags/delete.ts)_
+_See code: [src/commands/tags/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/tags/delete.ts)_
 
 ## `ppls tags list`
 
@@ -1088,15 +1118,13 @@ List tags
 ```
 USAGE
   $ ppls tags list [--date-format <value>] [--header <value>...] [--hostname <value>] [--plain | --json |
-    --table] [--token <value>] [--id-in <value> | --name-contains <value>] [--page <value> --page-size <value>] [--sort
-    <value>]
+    --table] [--token <value>] [--id-in <value>... | --name-contains <value>] [--page <value> --page-size <value>]
+    [--sort <value>]
 
 FLAGS
-  --id-in=<value>          Filter by id list (comma-separated)
-  --name-contains=<value>  Filter by name substring
-  --page=<value>           Page number to fetch
-  --page-size=<value>      [default: disable pagination, all results] Number of results per page
-  --sort=<value>           Sort results by the provided field
+  --page=<value>       Page number to fetch
+  --page-size=<value>  [default: disable pagination, all results] Number of results per page
+  --sort=<value>       Sort results by the provided field
 
 GLOBAL FLAGS
   --date-format=<value>  [default: yyyy-MM-dd, env: PPLS_DATE_FORMAT] Format output dates using a template.
@@ -1109,6 +1137,10 @@ ENVIRONMENT FLAGS
   --hostname=<value>   [env: PPLS_HOSTNAME] Paperless-ngx base URL
   --token=<value>      [env: PPLS_TOKEN] Paperless-ngx API token
 
+FILTER FLAGS
+  --id-in=<value>...       Filter by id list (repeatable or comma-separated)
+  --name-contains=<value>  Filter by name substring
+
 DESCRIPTION
   List tags
 
@@ -1116,7 +1148,7 @@ EXAMPLES
   $ ppls tags list
 ```
 
-_See code: [src/commands/tags/list.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/tags/list.ts)_
+_See code: [src/commands/tags/list.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/tags/list.ts)_
 
 ## `ppls tags show ID`
 
@@ -1148,7 +1180,7 @@ EXAMPLES
   $ ppls tags show 123
 ```
 
-_See code: [src/commands/tags/show.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/tags/show.ts)_
+_See code: [src/commands/tags/show.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/tags/show.ts)_
 
 ## `ppls tags update ID`
 
@@ -1186,5 +1218,5 @@ EXAMPLES
   $ ppls tags update 123 --name Inbox
 ```
 
-_See code: [src/commands/tags/update.ts](https://github.com/nickchristensen/ppls/blob/v1.1.0/src/commands/tags/update.ts)_
+_See code: [src/commands/tags/update.ts](https://github.com/nickchristensen/ppls/blob/v1.2.0/src/commands/tags/update.ts)_
 <!-- commandsstop -->

package/dist/base-command.d.ts

@@ -6,6 +6,7 @@ export type ApiFlags = {
     hostname: string;
     token: string;
 };
+type QueryParams = Record<string, number | number[] | string | string[] | undefined>;
 type ResolvedGlobalFlags = ApiFlags & {
     dateFormat: string;
 };
@@ -29,14 +30,14 @@ export declare abstract class BaseCommand extends Command {
     };
     static enableJsonFlag: boolean;
     private userConfigPromise?;
-    protected buildApiUrl(hostnameValue: string, path: string, params?: Record<string, number | string | undefined>): URL;
-    protected buildApiUrlFromFlags(flags: ApiFlags, path: string, params?: Record<string, number | string | undefined>): URL;
+    protected buildApiUrl(hostnameValue: string, path: string, params?: QueryParams): URL;
+    protected buildApiUrlFromFlags(flags: ApiFlags, path: string, params?: QueryParams): URL;
     protected deleteApiJson<T>(flags: ApiFlags, path: string): Promise<null | T>;
-    protected fetchApiBinary(flags: ApiFlags, path: string, params?: Record<string, number | string | undefined>): Promise<{
+    protected fetchApiBinary(flags: ApiFlags, path: string, params?: QueryParams): Promise<{
         data: Uint8Array;
         headers: Headers;
     }>;
-    protected fetchApiJson<T>(flags: ApiFlags, path: string, params?: Record<string, number | string | undefined>): Promise<T>;
+    protected fetchApiJson<T>(flags: ApiFlags, path: string, params?: QueryParams): Promise<T>;
     protected fetchJson<T>(url: URL, tokenValue: string, headers?: Record<string, string>): Promise<T>;
     protected formatErrorMessage(response: Response): Promise<string>;
     protected loadUserConfig(): Promise<UserConfig>;

package/dist/commands/documents/download.d.ts

@@ -31,7 +31,7 @@ type DownloadDocumentsOptions = {
 };
 export default class DocumentsDownload extends BaseCommand {
     static args: {
-        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static description: string;
     static examples: string[];
@@ -40,9 +40,9 @@ export default class DocumentsDownload extends BaseCommand {
         output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'output-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
+    static strict: boolean;
     protected downloadDocument(options: DownloadDocumentOptions): Promise<DownloadResult>;
     protected downloadDocuments(options: DownloadDocumentsOptions): Promise<DownloadResult[]>;
-    protected parseIds(raw: string): number[];
     run(): Promise<DownloadResult | DownloadResult[]>;
 }
 export {};

package/dist/commands/documents/download.js

@@ -40,14 +40,26 @@ const resolveOutputPath = async (output, filename) => {
     }
     return resolved;
 };
+const splitDelimitedValues = (input, delimiter) => {
+    const splitRegex = new RegExp(`(?<!\\\\)${delimiter}`);
+    return input
+        .split(splitRegex)
+        .map((value) => value.trim())
+        .map((value) => value
+        .replaceAll(new RegExp(`\\\\${delimiter}`, 'g'), delimiter)
+        .replace(/^"(.*)"$/, '$1')
+        .replace(/^'(.*)'$/, '$1'))
+        .filter((value) => value.length > 0);
+};
 export default class DocumentsDownload extends BaseCommand {
     static args = {
-        id: Args.string({ description: 'Document id or comma-separated list of ids', required: true }),
+        id: Args.string({ description: 'Document id (repeatable or comma-separated)' }),
     };
     static description = 'Download one or more documents';
     static examples = [
-        '<%= config.bin %> <%= command.id %> 123 --output document.pdf',
-        '<%= config.bin %> <%= command.id %> 123,124 --output-dir ./downloads',
+        '<%= config.bin %> <%= command.id %> --output document.pdf 123',
+        '<%= config.bin %> <%= command.id %> --output-dir ./downloads 123 456',
+        '<%= config.bin %> <%= command.id %> --output-dir ./downloads 123,456',
     ];
     static flags = {
         original: Flags.boolean({ description: 'Download original file' }),
@@ -62,6 +74,7 @@ export default class DocumentsDownload extends BaseCommand {
             exists: true,
         }),
     };
+    static strict = false;
     async downloadDocument(options) {
         const { apiFlags, id, original, output, outputDir } = options;
         const { data, headers: responseHeaders } = await this.fetchApiBinary(apiFlags, `/api/documents/${id}/download/`, {
@@ -103,28 +116,22 @@ export default class DocumentsDownload extends BaseCommand {
         }
         return results;
     }
-    parseIds(raw) {
-        const values = raw
-            .split(',')
-            .map((value) => value.trim())
-            .filter((value) => value.length > 0);
+    async run() {
+        const { flags, metadata, raw } = await this.parse();
+        const { headers: apiHeaders, hostname, token } = await this.resolveGlobalFlags(flags, metadata);
+        const apiFlags = { headers: apiHeaders, hostname, token };
+        const typedFlags = flags;
+        const rawArgs = raw.filter((token) => token.type === 'arg').map((token) => token.input);
+        const values = rawArgs.flatMap((value) => splitDelimitedValues(value, ','));
         if (values.length === 0) {
             this.error('Provide at least one document id.');
         }
-        return values.map((value) => {
+        const ids = values.map((value) => {
             if (!/^-?\d+$/.test(value)) {
                 this.error(`Invalid document id: ${value}`);
             }
             return Number.parseInt(value, 10);
         });
-    }
-    async run() {
-        const { args, flags, metadata } = await this.parse();
-        const { headers: apiHeaders, hostname, token } = await this.resolveGlobalFlags(flags, metadata);
-        const apiFlags = { headers: apiHeaders, hostname, token };
-        const typedArgs = args;
-        const typedFlags = flags;
-        const ids = this.parseIds(typedArgs.id);
         let outputDir = typedFlags['output-dir'];
         if (ids.length > 1) {
             if (typedFlags.output) {

package/dist/commands/documents/list.d.ts

@@ -3,8 +3,38 @@ import { ListCommand } from '../../list-command.js';
 export default class DocumentsList extends ListCommand<Document> {
     static description: string;
     static examples: string[];
+    static flags: {
+        'added-after': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'added-before': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        correspondent: import("@oclif/core/interfaces").OptionFlag<number[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'correspondent-not': import("@oclif/core/interfaces").OptionFlag<number[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'created-after': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'created-before': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'document-type': import("@oclif/core/interfaces").OptionFlag<number[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'document-type-not': import("@oclif/core/interfaces").OptionFlag<number[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'modified-after': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'modified-before': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'no-correspondent': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'no-document-type': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'no-tag': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        tag: import("@oclif/core/interfaces").OptionFlag<number[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'tag-all': import("@oclif/core/interfaces").OptionFlag<number[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'tag-not': import("@oclif/core/interfaces").OptionFlag<number[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'id-in': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'name-contains': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        page: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'page-size': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        sort: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'date-format': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        header: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        hostname: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        plain: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        table: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
     protected listPath: string;
     protected tableAttrs: string[];
-    protected listParams(flags: Parameters<ListCommand['listParams']>[0]): Record<string, number | string | undefined>;
+    protected extraListFlags(flags: Record<string, unknown>): Record<string, unknown>;
+    protected listParams(flags: Parameters<ListCommand['listParams']>[0]): Record<string, number | number[] | string | string[] | undefined>;
     protected plainTemplate(document: Document): string | undefined;
 }

package/dist/commands/documents/list.js

@@ -1,14 +1,178 @@
+import { Flags } from '@oclif/core';
+import { dateLike } from '../../flags/date-like.js';
+import { isDateOnly } from '../../helpers/date-utils.js';
 import { ListCommand } from '../../list-command.js';
+const DATE_RANGE_FLAGS = {
+    added: {
+        after: 'added-after',
+        before: 'added-before',
+    },
+    created: {
+        after: 'created-after',
+        before: 'created-before',
+    },
+    modified: {
+        after: 'modified-after',
+        before: 'modified-before',
+    },
+};
+const addDateRangeParams = (params, field, flags) => {
+    const { after, before } = DATE_RANGE_FLAGS[field];
+    const typedFlags = flags;
+    const afterValue = typedFlags[after];
+    const beforeValue = typedFlags[before];
+    if (afterValue) {
+        const key = isDateOnly(afterValue) ? `${field}__date__gte` : `${field}__gte`;
+        params[key] = afterValue;
+    }
+    if (beforeValue) {
+        const key = isDateOnly(beforeValue) ? `${field}__date__lte` : `${field}__lte`;
+        params[key] = beforeValue;
+    }
+};
 export default class DocumentsList extends ListCommand {
     static description = 'List documents';
     static examples = ['<%= config.bin %> <%= command.id %>'];
+    static flags = {
+        ...ListCommand.baseFlags,
+        'added-after': dateLike({
+            description: 'Filter by added date (YYYY-MM-DD) or datetime (ISO 8601) >= value',
+            exclusive: ['id-in'],
+            helpGroup: 'FILTER',
+        }),
+        'added-before': dateLike({
+            description: 'Filter by added date (YYYY-MM-DD) or datetime (ISO 8601) <= value',
+            exclusive: ['id-in'],
+            helpGroup: 'FILTER',
+        }),
+        correspondent: Flags.integer({
+            delimiter: ',',
+            description: 'Filter by correspondent ids (repeatable or comma-separated)',
+            exclusive: ['id-in'],
+            helpGroup: 'FILTER',
+            multiple: true,
+        }),
+        'correspondent-not': Flags.integer({
+            delimiter: ',',
+            description: 'Exclude correspondent ids (repeatable or comma-separated)',
+            exclusive: ['id-in'],
+            helpGroup: 'FILTER',
+            multiple: true,
+        }),
+        'created-after': dateLike({
+            description: 'Filter by created date (YYYY-MM-DD) or datetime (ISO 8601) >= value',
+            exclusive: ['id-in'],
+            helpGroup: 'FILTER',
+        }),
+        'created-before': dateLike({
+            description: 'Filter by created date (YYYY-MM-DD) or datetime (ISO 8601) <= value',
+            exclusive: ['id-in'],
+            helpGroup: 'FILTER',
+        }),
+        'document-type': Flags.integer({
+            delimiter: ',',
+            description: 'Filter by document type ids (repeatable or comma-separated)',
+            exclusive: ['id-in'],
+            helpGroup: 'FILTER',
+            multiple: true,
+        }),
+        'document-type-not': Flags.integer({
+            delimiter: ',',
+            description: 'Exclude document type ids (repeatable or comma-separated)',
+            exclusive: ['id-in'],
+            helpGroup: 'FILTER',
+            multiple: true,
+        }),
+        'modified-after': dateLike({
+            description: 'Filter by modified date (YYYY-MM-DD) or datetime (ISO 8601) >= value',
+            exclusive: ['id-in'],
+            helpGroup: 'FILTER',
+        }),
+        'modified-before': dateLike({
+            description: 'Filter by modified date (YYYY-MM-DD) or datetime (ISO 8601) <= value',
+            exclusive: ['id-in'],
+            helpGroup: 'FILTER',
+        }),
+        'no-correspondent': Flags.boolean({
+            description: 'Filter documents with no correspondent',
+            exclusive: ['correspondent', 'correspondent-not', 'id-in'],
+            helpGroup: 'FILTER',
+        }),
+        'no-document-type': Flags.boolean({
+            description: 'Filter documents with no document type',
+            exclusive: ['document-type', 'document-type-not', 'id-in'],
+            helpGroup: 'FILTER',
+        }),
+        'no-tag': Flags.boolean({
+            description: 'Filter documents with no tags',
+            exclusive: ['tag', 'tag-all', 'tag-not', 'id-in'],
+            helpGroup: 'FILTER',
+        }),
+        tag: Flags.integer({
+            delimiter: ',',
+            description: 'Filter by tag ids (repeatable or comma-separated, OR)',
+            exclusive: ['id-in'],
+            helpGroup: 'FILTER',
+            multiple: true,
+        }),
+        'tag-all': Flags.integer({
+            delimiter: ',',
+            description: 'Filter by tag ids (repeatable or comma-separated, AND)',
+            exclusive: ['id-in'],
+            helpGroup: 'FILTER',
+            multiple: true,
+        }),
+        'tag-not': Flags.integer({
+            delimiter: ',',
+            description: 'Exclude tag ids (repeatable or comma-separated)',
+            exclusive: ['id-in'],
+            helpGroup: 'FILTER',
+            multiple: true,
+        }),
+    };
     listPath = '/api/documents/';
     tableAttrs = ['id', 'title', 'created', 'added', 'correspondent', 'document_type', 'tags'];
+    extraListFlags(flags) {
+        const typedFlags = flags;
+        return {
+            'added-after': typedFlags['added-after'],
+            'added-before': typedFlags['added-before'],
+            correspondent: typedFlags.correspondent,
+            'correspondent-not': typedFlags['correspondent-not'],
+            'created-after': typedFlags['created-after'],
+            'created-before': typedFlags['created-before'],
+            'document-type': typedFlags['document-type'],
+            'document-type-not': typedFlags['document-type-not'],
+            'modified-after': typedFlags['modified-after'],
+            'modified-before': typedFlags['modified-before'],
+            'no-correspondent': typedFlags['no-correspondent'],
+            'no-document-type': typedFlags['no-document-type'],
+            'no-tag': typedFlags['no-tag'],
+            tag: typedFlags.tag,
+            'tag-all': typedFlags['tag-all'],
+            'tag-not': typedFlags['tag-not'],
+        };
+    }
     listParams(flags) {
+        const typedFlags = flags;
         const params = super.listParams(flags);
         delete params.name__icontains;
-        // eslint-disable-next-line camelcase -- API uses double-underscore field names.
+        /* eslint-disable camelcase -- API uses double-underscore field names. */
         params.title__icontains = flags['name-contains'];
+        params.tags__id__in = typedFlags.tag;
+        params.tags__id__all = typedFlags['tag-all'];
+        params.tags__id__none = typedFlags['tag-not'];
+        params.is_tagged = typedFlags['no-tag'] ? 'false' : undefined;
+        params.correspondent__id__in = typedFlags.correspondent;
+        params.correspondent__id__none = typedFlags['correspondent-not'];
+        params.correspondent__isnull = typedFlags['no-correspondent'] ? 'true' : undefined;
+        params.document_type__id__in = typedFlags['document-type'];
+        params.document_type__id__none = typedFlags['document-type-not'];
+        params.document_type__isnull = typedFlags['no-document-type'] ? 'true' : undefined;
+        /* eslint-enable camelcase */
+        addDateRangeParams(params, 'added', typedFlags);
+        addDateRangeParams(params, 'created', typedFlags);
+        addDateRangeParams(params, 'modified', typedFlags);
         return params;
     }
     plainTemplate(document) {

package/dist/flags/date-like.d.ts

@@ -0,0 +1,4 @@
+export declare const dateLike: import("@oclif/core/interfaces").FlagDefinition<string, import("@oclif/core/interfaces").CustomOptions, {
+    multiple: false;
+    requiredOrDefaulted: false;
+}>;

package/dist/flags/date-like.js

@@ -0,0 +1,11 @@
+import { Flags } from '@oclif/core';
+import { isDateOnly, isDateTime } from '../helpers/date-utils.js';
+export const dateLike = Flags.custom({
+    helpValue: 'YYYY-MM-DD|ISO-8601',
+    async parse(input) {
+        if (isDateOnly(input) || isDateTime(input)) {
+            return input;
+        }
+        throw new Error('Use YYYY-MM-DD or an ISO 8601 datetime.');
+    },
+});

package/dist/list-command.d.ts

@@ -2,7 +2,7 @@ import type { ApiFlags } from './base-command.js';
 import { BaseCommand } from './base-command.js';
 import { type TableColumn, type TableRow } from './helpers/table.js';
 type ListCommandFlags = ApiFlags & {
-    'id-in'?: string;
+    'id-in'?: string[];
     'name-contains'?: string;
     page?: number;
     'page-size': number;
@@ -16,7 +16,7 @@ type ListOutputFlags = ListCommandFlags & {
 type TableColumnInput = string | TableColumn;
 export declare abstract class ListCommand<TRaw extends TableRow = TableRow, TOutput extends TableRow = TRaw> extends BaseCommand {
     static baseFlags: {
-        'id-in': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'id-in': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'name-contains': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         page: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'page-size': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
@@ -30,12 +30,13 @@ export declare abstract class ListCommand<TRaw extends TableRow = TableRow, TOut
     };
     protected abstract listPath: string;
     protected abstract tableAttrs: TableColumnInput[];
+    protected extraListFlags(_flags: Record<string, unknown>): Record<string, unknown>;
     protected fetchListResults<T>(options: {
         flags: ListCommandFlags;
-        params?: Record<string, number | string | undefined>;
+        params?: Record<string, number | number[] | string | string[] | undefined>;
         path: string;
     }): Promise<T[]>;
-    protected listParams(flags: ListCommandFlags): Record<string, number | string | undefined>;
+    protected listParams(flags: ListCommandFlags): Record<string, number | number[] | string | string[] | undefined>;
     protected abstract plainTemplate(item: TOutput): null | string | undefined;
     protected renderListOutput(options: {
         flags: ListOutputFlags;

package/dist/list-command.js

@@ -5,12 +5,16 @@ export class ListCommand extends BaseCommand {
     static baseFlags = {
         ...BaseCommand.baseFlags,
         'id-in': Flags.string({
-            description: 'Filter by id list (comma-separated)',
+            delimiter: ',',
+            description: 'Filter by id list (repeatable or comma-separated)',
             exclusive: ['name-contains'],
+            helpGroup: 'FILTER',
+            multiple: true,
         }),
         'name-contains': Flags.string({
             description: 'Filter by name substring',
             exclusive: ['id-in'],
+            helpGroup: 'FILTER',
         }),
         page: Flags.integer({
             dependsOn: ['page-size'],
@@ -25,6 +29,9 @@ export class ListCommand extends BaseCommand {
         }),
         sort: Flags.string({ description: 'Sort results by the provided field' }),
     };
+    extraListFlags(_flags) {
+        return {};
+    }
     async fetchListResults(options) {
         const { flags, params = {}, path } = options;
         const url = this.buildListUrl({
@@ -81,6 +88,7 @@ export class ListCommand extends BaseCommand {
             'page-size': flags['page-size'],
             sort: flags.sort,
             token: apiFlags.token,
+            ...this.extraListFlags(flags),
         };
         const outputFlags = {
             ...listFlags,

package/oclif.manifest.json

@@ -576,13 +576,15 @@
           "type": "option"
         },
         "id-in": {
-          "description": "Filter by id list (comma-separated)",
+          "description": "Filter by id list (repeatable or comma-separated)",
           "exclusive": [
             "name-contains"
           ],
+          "helpGroup": "FILTER",
           "name": "id-in",
+          "delimiter": ",",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "name-contains": {
@@ -590,6 +592,7 @@
           "exclusive": [
             "id-in"
           ],
+          "helpGroup": "FILTER",
           "name": "name-contains",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1157,13 +1160,15 @@
           "type": "option"
         },
         "id-in": {
-          "description": "Filter by id list (comma-separated)",
+          "description": "Filter by id list (repeatable or comma-separated)",
           "exclusive": [
             "name-contains"
           ],
+          "helpGroup": "FILTER",
           "name": "id-in",
+          "delimiter": ",",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "name-contains": {
@@ -1171,6 +1176,7 @@
           "exclusive": [
             "id-in"
           ],
+          "helpGroup": "FILTER",
           "name": "name-contains",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1737,13 +1743,15 @@
           "type": "option"
         },
         "id-in": {
-          "description": "Filter by id list (comma-separated)",
+          "description": "Filter by id list (repeatable or comma-separated)",
           "exclusive": [
             "name-contains"
           ],
+          "helpGroup": "FILTER",
           "name": "id-in",
+          "delimiter": ",",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "name-contains": {
@@ -1751,6 +1759,7 @@
           "exclusive": [
             "id-in"
           ],
+          "helpGroup": "FILTER",
           "name": "name-contains",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2249,15 +2258,15 @@
       "aliases": [],
       "args": {
         "id": {
-          "description": "Document id or comma-separated list of ids",
-          "name": "id",
-          "required": true
+          "description": "Document id (repeatable or comma-separated)",
+          "name": "id"
         }
       },
       "description": "Download one or more documents",
       "examples": [
-        "<%= config.bin %> <%= command.id %> 123 --output document.pdf",
-        "<%= config.bin %> <%= command.id %> 123,124 --output-dir ./downloads"
+        "<%= config.bin %> <%= command.id %> --output document.pdf 123",
+        "<%= config.bin %> <%= command.id %> --output-dir ./downloads 123 456",
+        "<%= config.bin %> <%= command.id %> --output-dir ./downloads 123,456"
       ],
       "flags": {
         "json": {
@@ -2360,7 +2369,7 @@
       "pluginAlias": "@nickchristensen/ppls",
       "pluginName": "@nickchristensen/ppls",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -2445,13 +2454,15 @@
           "type": "option"
         },
         "id-in": {
-          "description": "Filter by id list (comma-separated)",
+          "description": "Filter by id list (repeatable or comma-separated)",
           "exclusive": [
             "name-contains"
           ],
+          "helpGroup": "FILTER",
           "name": "id-in",
+          "delimiter": ",",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "name-contains": {
@@ -2459,6 +2470,7 @@
           "exclusive": [
             "id-in"
           ],
+          "helpGroup": "FILTER",
           "name": "name-contains",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2488,6 +2500,199 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "added-after": {
+          "description": "Filter by added date (YYYY-MM-DD) or datetime (ISO 8601) >= value",
+          "exclusive": [
+            "id-in"
+          ],
+          "helpGroup": "FILTER",
+          "name": "added-after",
+          "hasDynamicHelp": false,
+          "helpValue": "YYYY-MM-DD|ISO-8601",
+          "multiple": false,
+          "type": "option"
+        },
+        "added-before": {
+          "description": "Filter by added date (YYYY-MM-DD) or datetime (ISO 8601) <= value",
+          "exclusive": [
+            "id-in"
+          ],
+          "helpGroup": "FILTER",
+          "name": "added-before",
+          "hasDynamicHelp": false,
+          "helpValue": "YYYY-MM-DD|ISO-8601",
+          "multiple": false,
+          "type": "option"
+        },
+        "correspondent": {
+          "description": "Filter by correspondent ids (repeatable or comma-separated)",
+          "exclusive": [
+            "id-in"
+          ],
+          "helpGroup": "FILTER",
+          "name": "correspondent",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "correspondent-not": {
+          "description": "Exclude correspondent ids (repeatable or comma-separated)",
+          "exclusive": [
+            "id-in"
+          ],
+          "helpGroup": "FILTER",
+          "name": "correspondent-not",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "created-after": {
+          "description": "Filter by created date (YYYY-MM-DD) or datetime (ISO 8601) >= value",
+          "exclusive": [
+            "id-in"
+          ],
+          "helpGroup": "FILTER",
+          "name": "created-after",
+          "hasDynamicHelp": false,
+          "helpValue": "YYYY-MM-DD|ISO-8601",
+          "multiple": false,
+          "type": "option"
+        },
+        "created-before": {
+          "description": "Filter by created date (YYYY-MM-DD) or datetime (ISO 8601) <= value",
+          "exclusive": [
+            "id-in"
+          ],
+          "helpGroup": "FILTER",
+          "name": "created-before",
+          "hasDynamicHelp": false,
+          "helpValue": "YYYY-MM-DD|ISO-8601",
+          "multiple": false,
+          "type": "option"
+        },
+        "document-type": {
+          "description": "Filter by document type ids (repeatable or comma-separated)",
+          "exclusive": [
+            "id-in"
+          ],
+          "helpGroup": "FILTER",
+          "name": "document-type",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "document-type-not": {
+          "description": "Exclude document type ids (repeatable or comma-separated)",
+          "exclusive": [
+            "id-in"
+          ],
+          "helpGroup": "FILTER",
+          "name": "document-type-not",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "modified-after": {
+          "description": "Filter by modified date (YYYY-MM-DD) or datetime (ISO 8601) >= value",
+          "exclusive": [
+            "id-in"
+          ],
+          "helpGroup": "FILTER",
+          "name": "modified-after",
+          "hasDynamicHelp": false,
+          "helpValue": "YYYY-MM-DD|ISO-8601",
+          "multiple": false,
+          "type": "option"
+        },
+        "modified-before": {
+          "description": "Filter by modified date (YYYY-MM-DD) or datetime (ISO 8601) <= value",
+          "exclusive": [
+            "id-in"
+          ],
+          "helpGroup": "FILTER",
+          "name": "modified-before",
+          "hasDynamicHelp": false,
+          "helpValue": "YYYY-MM-DD|ISO-8601",
+          "multiple": false,
+          "type": "option"
+        },
+        "no-correspondent": {
+          "description": "Filter documents with no correspondent",
+          "exclusive": [
+            "correspondent",
+            "correspondent-not",
+            "id-in"
+          ],
+          "helpGroup": "FILTER",
+          "name": "no-correspondent",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-document-type": {
+          "description": "Filter documents with no document type",
+          "exclusive": [
+            "document-type",
+            "document-type-not",
+            "id-in"
+          ],
+          "helpGroup": "FILTER",
+          "name": "no-document-type",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-tag": {
+          "description": "Filter documents with no tags",
+          "exclusive": [
+            "tag",
+            "tag-all",
+            "tag-not",
+            "id-in"
+          ],
+          "helpGroup": "FILTER",
+          "name": "no-tag",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "tag": {
+          "description": "Filter by tag ids (repeatable or comma-separated, OR)",
+          "exclusive": [
+            "id-in"
+          ],
+          "helpGroup": "FILTER",
+          "name": "tag",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "tag-all": {
+          "description": "Filter by tag ids (repeatable or comma-separated, AND)",
+          "exclusive": [
+            "id-in"
+          ],
+          "helpGroup": "FILTER",
+          "name": "tag-all",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "tag-not": {
+          "description": "Exclude tag ids (repeatable or comma-separated)",
+          "exclusive": [
+            "id-in"
+          ],
+          "helpGroup": "FILTER",
+          "name": "tag-not",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": true,
@@ -3048,13 +3253,15 @@
           "type": "option"
         },
         "id-in": {
-          "description": "Filter by id list (comma-separated)",
+          "description": "Filter by id list (repeatable or comma-separated)",
           "exclusive": [
             "name-contains"
           ],
+          "helpGroup": "FILTER",
           "name": "id-in",
+          "delimiter": ",",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "name-contains": {
@@ -3062,6 +3269,7 @@
           "exclusive": [
             "id-in"
           ],
+          "helpGroup": "FILTER",
           "name": "name-contains",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -3329,5 +3537,5 @@
       ]
     }
   },
-  "version": "1.1.0"
+  "version": "1.2.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nickchristensen/ppls",
   "description": "A node-based paperless-ngx cli",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "author": "Nick Christensen",
   "bin": {
     "ppls": "bin/run.js"
@@ -25,6 +25,7 @@
     "eslint": "^9",
     "eslint-config-oclif": "^6",
     "eslint-config-prettier": "^10",
+    "husky": "^9.1.7",
     "mocha": "^10",
     "oclif": "^4",
     "shx": "^0.3.3",
@@ -80,6 +81,7 @@
     "lint": "eslint",
     "postpack": "shx rm -f oclif.manifest.json",
     "posttest": "npm run lint",
+    "prepare": "husky install",
     "prepack": "npm run build",
     "postbuild": "oclif manifest && oclif readme --no-aliases",
     "test": "mocha --forbid-only \"test/**/*.test.ts\"",