@nickchristensen/ppls 1.0.5 → 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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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>] [--page <value>] [--page-size <value>] [--id-in <value> | --name-contains <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>      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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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>] [--page <value>] [--page-size <value>] [--id-in <value> | --name-contains <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>      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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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>] [--page <value>] [--page-size <value>] [--id-in <value> | --name-contains <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>      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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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 --output-dir ./downloads 123 456
 
-  $ ppls documents download 123,124 --output-dir ./downloads
+  $ ppls documents download --output-dir ./downloads 123,456
 ```
 
-_See code: [src/commands/documents/download.ts](https://github.com/nickchristensen/ppls/blob/v1.0.5/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>] [--page <value>] [--page-size <value>] [--id-in <value> | --name-contains <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>      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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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.0.5/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>] [--page <value>] [--page-size <value>] [--id-in <value> | --name-contains <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>      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.0.5/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.0.5/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.0.5/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;
 }