@nickchristensen/ppls 1.0.1 → 1.0.2

package/README.md

@@ -108,7 +108,7 @@ EXAMPLES
   $ ppls config get hostname
 ```
 
-_See code: [src/commands/config/get.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/config/get.ts)_
+_See code: [src/commands/config/get.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/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.1/src/commands/config/init.ts)_
+_See code: [src/commands/config/init.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/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.1/src/commands/config/list.ts)_
+_See code: [src/commands/config/list.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/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.1/src/commands/config/remove.ts)_
+_See code: [src/commands/config/remove.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/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.1/src/commands/config/set.ts)_
+_See code: [src/commands/config/set.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/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.1/src/commands/correspondents/add.ts)_
+_See code: [src/commands/correspondents/add.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/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.1/src/commands/correspondents/delete.ts)_
+_See code: [src/commands/correspondents/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/correspondents/delete.ts)_
 
 ## `ppls correspondents list`
 
@@ -308,7 +308,7 @@ EXAMPLES
   $ ppls correspondents list
 ```
 
-_See code: [src/commands/correspondents/list.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/correspondents/list.ts)_
+_See code: [src/commands/correspondents/list.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/correspondents/list.ts)_
 
 ## `ppls correspondents show ID`
 
@@ -340,7 +340,7 @@ EXAMPLES
   $ ppls correspondents show 123
 ```
 
-_See code: [src/commands/correspondents/show.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/correspondents/show.ts)_
+_See code: [src/commands/correspondents/show.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/correspondents/show.ts)_
 
 ## `ppls correspondents update ID`
 
@@ -375,7 +375,7 @@ EXAMPLES
   $ ppls correspondents update 123 --name "Acme Corp"
 ```
 
-_See code: [src/commands/correspondents/update.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/correspondents/update.ts)_
+_See code: [src/commands/correspondents/update.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/correspondents/update.ts)_
 
 ## `ppls custom-fields add NAME`
 
@@ -413,7 +413,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.1/src/commands/custom-fields/add.ts)_
+_See code: [src/commands/custom-fields/add.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/custom-fields/add.ts)_
 
 ## `ppls custom-fields delete ID`
 
@@ -448,7 +448,7 @@ EXAMPLES
   $ ppls custom-fields delete 123
 ```
 
-_See code: [src/commands/custom-fields/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/custom-fields/delete.ts)_
+_See code: [src/commands/custom-fields/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/custom-fields/delete.ts)_
 
 ## `ppls custom-fields list`
 
@@ -485,7 +485,7 @@ EXAMPLES
   $ ppls custom-fields list
 ```
 
-_See code: [src/commands/custom-fields/list.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/custom-fields/list.ts)_
+_See code: [src/commands/custom-fields/list.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/custom-fields/list.ts)_
 
 ## `ppls custom-fields show ID`
 
@@ -517,7 +517,7 @@ EXAMPLES
   $ ppls custom-fields show 123
 ```
 
-_See code: [src/commands/custom-fields/show.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/custom-fields/show.ts)_
+_See code: [src/commands/custom-fields/show.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/custom-fields/show.ts)_
 
 ## `ppls custom-fields update ID`
 
@@ -556,7 +556,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.1/src/commands/custom-fields/update.ts)_
+_See code: [src/commands/custom-fields/update.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/custom-fields/update.ts)_
 
 ## `ppls document-types add NAME`
 
@@ -588,7 +588,7 @@ EXAMPLES
   $ ppls document-types add "Invoice"
 ```
 
-_See code: [src/commands/document-types/add.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/document-types/add.ts)_
+_See code: [src/commands/document-types/add.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/document-types/add.ts)_
 
 ## `ppls document-types delete ID`
 
@@ -623,7 +623,7 @@ EXAMPLES
   $ ppls document-types delete 123
 ```
 
-_See code: [src/commands/document-types/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/document-types/delete.ts)_
+_See code: [src/commands/document-types/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/document-types/delete.ts)_
 
 ## `ppls document-types list`
 
@@ -660,7 +660,7 @@ EXAMPLES
   $ ppls document-types list
 ```
 
-_See code: [src/commands/document-types/list.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/document-types/list.ts)_
+_See code: [src/commands/document-types/list.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/document-types/list.ts)_
 
 ## `ppls document-types show ID`
 
@@ -692,7 +692,7 @@ EXAMPLES
   $ ppls document-types show 123
 ```
 
-_See code: [src/commands/document-types/show.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/document-types/show.ts)_
+_See code: [src/commands/document-types/show.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/document-types/show.ts)_
 
 ## `ppls document-types update ID`
 
@@ -727,7 +727,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.1/src/commands/document-types/update.ts)_
+_See code: [src/commands/document-types/update.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/document-types/update.ts)_
 
 ## `ppls documents add [PATH]`
 
@@ -769,7 +769,7 @@ EXAMPLES
   $ ppls documents add ./receipt.pdf --title "Receipt"
 ```
 
-_See code: [src/commands/documents/add.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/documents/add.ts)_
+_See code: [src/commands/documents/add.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/documents/add.ts)_
 
 ## `ppls documents delete ID`
 
@@ -804,7 +804,7 @@ EXAMPLES
   $ ppls documents delete 123
 ```
 
-_See code: [src/commands/documents/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/documents/delete.ts)_
+_See code: [src/commands/documents/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/documents/delete.ts)_
 
 ## `ppls documents download ID`
 
@@ -843,7 +843,7 @@ EXAMPLES
   $ ppls documents download 123,124 --output-dir ./downloads
 ```
 
-_See code: [src/commands/documents/download.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/documents/download.ts)_
+_See code: [src/commands/documents/download.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/documents/download.ts)_
 
 ## `ppls documents list`
 
@@ -880,7 +880,7 @@ EXAMPLES
   $ ppls documents list
 ```
 
-_See code: [src/commands/documents/list.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/documents/list.ts)_
+_See code: [src/commands/documents/list.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/documents/list.ts)_
 
 ## `ppls documents show ID`
 
@@ -912,7 +912,7 @@ EXAMPLES
   $ ppls documents show 123
 ```
 
-_See code: [src/commands/documents/show.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/documents/show.ts)_
+_See code: [src/commands/documents/show.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/documents/show.ts)_
 
 ## `ppls documents update ID`
 
@@ -955,7 +955,7 @@ EXAMPLES
   $ ppls documents update 123 --title "Receipt"
 ```
 
-_See code: [src/commands/documents/update.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/documents/update.ts)_
+_See code: [src/commands/documents/update.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/documents/update.ts)_
 
 ## `ppls help [COMMAND]`
 
@@ -1007,7 +1007,7 @@ EXAMPLES
   $ ppls profile
 ```
 
-_See code: [src/commands/profile.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/profile.ts)_
+_See code: [src/commands/profile.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/profile.ts)_
 
 ## `ppls tags add NAME`
 
@@ -1044,7 +1044,7 @@ EXAMPLES
   $ ppls tags add Inbox
 ```
 
-_See code: [src/commands/tags/add.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/tags/add.ts)_
+_See code: [src/commands/tags/add.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/tags/add.ts)_
 
 ## `ppls tags delete ID`
 
@@ -1079,7 +1079,7 @@ EXAMPLES
   $ ppls tags delete 123
 ```
 
-_See code: [src/commands/tags/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/tags/delete.ts)_
+_See code: [src/commands/tags/delete.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/tags/delete.ts)_
 
 ## `ppls tags list`
 
@@ -1116,7 +1116,7 @@ EXAMPLES
   $ ppls tags list
 ```
 
-_See code: [src/commands/tags/list.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/tags/list.ts)_
+_See code: [src/commands/tags/list.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/tags/list.ts)_
 
 ## `ppls tags show ID`
 
@@ -1148,7 +1148,7 @@ EXAMPLES
   $ ppls tags show 123
 ```
 
-_See code: [src/commands/tags/show.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/tags/show.ts)_
+_See code: [src/commands/tags/show.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/tags/show.ts)_
 
 ## `ppls tags update ID`
 
@@ -1186,5 +1186,5 @@ EXAMPLES
   $ ppls tags update 123 --name Inbox
 ```
 
-_See code: [src/commands/tags/update.ts](https://github.com/nickchristensen/ppls/blob/v1.0.1/src/commands/tags/update.ts)_
+_See code: [src/commands/tags/update.ts](https://github.com/nickchristensen/ppls/blob/v1.0.2/src/commands/tags/update.ts)_
 <!-- commandsstop -->

package/dist/base-command.d.ts

@@ -40,6 +40,7 @@ export declare abstract class BaseCommand extends Command {
     protected fetchJson<T>(url: URL, tokenValue: string, headers?: Record<string, string>): Promise<T>;
     protected formatErrorMessage(response: Response): Promise<string>;
     protected loadUserConfig(): Promise<UserConfig>;
+    protected logRequestHeaders(label: string, headers: Record<string, string>): void;
     protected logTable(headers: TableColumn[], rows: TableRow[], options?: TableOptions): void;
     protected parseHeaderEntries(entries: string[], source: string): Record<string, string>;
     protected parseHeadersConfig(input: unknown, source: string): Record<string, string>;
@@ -47,6 +48,7 @@ export declare abstract class BaseCommand extends Command {
     protected patchApiJson<T>(flags: ApiFlags, path: string, body: unknown): Promise<T>;
     protected postApiFormData<T>(flags: ApiFlags, path: string, body: FormData): Promise<T>;
     protected postApiJson<T>(flags: ApiFlags, path: string, body: unknown): Promise<T>;
+    protected redactHeaderValue(key: string, value: string): string;
     protected requestJson<T>(options: {
         body?: unknown;
         headers: Record<string, string>;
@@ -57,6 +59,7 @@ export declare abstract class BaseCommand extends Command {
     protected resolveDateFormat(flags: Record<string, unknown>, metadata: CommandMetadata | undefined, userConfig: UserConfig): string;
     protected resolveGlobalFlags(flags: Record<string, unknown>, metadata?: CommandMetadata): Promise<ResolvedGlobalFlags>;
     protected resolveHeaders(flags: Record<string, unknown>, userConfig: UserConfig): Record<string, string>;
+    protected shouldLogHeaders(): boolean;
     protected shouldShowSpinner(): boolean;
     protected startSpinner(text: string): null | ReturnType<typeof yoctoSpinner>;
 }

package/dist/base-command.js

@@ -64,6 +64,7 @@ export class BaseCommand extends Command {
             Authorization: `Token ${flags.token}`,
             ...flags.headers,
         };
+        this.logRequestHeaders(`DELETE ${url.toString()}`, requestHeaders);
         const response = await fetch(url, {
             headers: requestHeaders,
             method: 'DELETE',
@@ -88,6 +89,7 @@ export class BaseCommand extends Command {
             Authorization: `Token ${flags.token}`,
             ...flags.headers,
         };
+        this.logRequestHeaders(`GET ${url.toString()}`, requestHeaders);
         const response = await fetch(url, {
             headers: requestHeaders,
         });
@@ -144,6 +146,13 @@ export class BaseCommand extends Command {
         })();
         return this.userConfigPromise;
     }
+    logRequestHeaders(label, headers) {
+        if (!this.shouldLogHeaders()) {
+            return;
+        }
+        const maskedHeaders = Object.fromEntries(Object.entries(headers).map(([key, value]) => [key, this.redactHeaderValue(key, value)]));
+        this.logToStderr(`${label} headers: ${JSON.stringify(maskedHeaders)}`);
+    }
     logTable(headers, rows, options) {
         this.log(renderTable(headers, rows, options));
     }
@@ -221,6 +230,7 @@ export class BaseCommand extends Command {
             Authorization: `Token ${flags.token}`,
             ...flags.headers,
         };
+        this.logRequestHeaders(`POST ${url.toString()}`, requestHeaders);
         const response = await fetch(url, {
             body,
             headers: requestHeaders,
@@ -245,6 +255,17 @@ export class BaseCommand extends Command {
             url,
         });
     }
+    redactHeaderValue(key, value) {
+        const normalized = key.toLowerCase();
+        if (normalized === 'authorization') {
+            const [scheme] = value.split(' ');
+            return scheme ? `${scheme} [REDACTED]` : '[REDACTED]';
+        }
+        if (normalized.includes('token') || normalized.includes('secret') || normalized.includes('api-key')) {
+            return '[REDACTED]';
+        }
+        return value;
+    }
     async requestJson(options) {
         const { body, headers, method, token, url } = options;
         const requestHeaders = {
@@ -253,6 +274,7 @@ export class BaseCommand extends Command {
             ...(body === undefined ? {} : { 'Content-Type': 'application/json' }),
             ...headers,
         };
+        this.logRequestHeaders(`${method} ${url.toString()}`, requestHeaders);
         const response = await fetch(url, {
             body: body === undefined ? undefined : JSON.stringify(body),
             headers: requestHeaders,
@@ -297,6 +319,10 @@ export class BaseCommand extends Command {
             ...flagHeaders,
         };
     }
+    shouldLogHeaders() {
+        const value = process.env.PPLS_DEBUG_HEADERS?.toLowerCase();
+        return value === '1' || value === 'true' || value === 'yes';
+    }
     shouldShowSpinner() {
         return Boolean(process.stderr.isTTY);
     }

package/dist/paginated-command.d.ts

@@ -44,5 +44,6 @@ export declare abstract class PaginatedCommand extends BaseCommand {
         url: URL;
     }): Promise<T[]>;
     protected paginate<T>(url: URL, tokenValue: string, headers: Record<string, string>, autoPaginate: boolean): AsyncGenerator<T>;
+    protected normalizeNextUrl(nextUrl: URL, currentUrl: URL): URL;
 }
 export {};

package/dist/paginated-command.js

@@ -37,14 +37,16 @@ export class PaginatedCommand extends BaseCommand {
         try {
             let nextUrl = url;
             while (nextUrl) {
+                const currentUrl = nextUrl;
                 // eslint-disable-next-line no-await-in-loop -- pagination is sequential and depends on the next page URL.
-                const payload = await this.fetchJson(nextUrl, token, headers);
+                const payload = await this.fetchJson(currentUrl, token, headers);
                 results.push(...(payload.results ?? []));
                 if (!autoPaginate || !payload.next) {
                     break;
                 }
                 try {
-                    nextUrl = new URL(payload.next, nextUrl);
+                    const parsedNext = new URL(payload.next, currentUrl);
+                    nextUrl = this.normalizeNextUrl(parsedNext, currentUrl);
                 }
                 catch {
                     this.error('API returned an invalid next URL for pagination.');
@@ -69,8 +71,9 @@ export class PaginatedCommand extends BaseCommand {
     async *paginate(url, tokenValue, headers, autoPaginate) {
         let nextUrl = url;
         while (nextUrl) {
+            const currentUrl = nextUrl;
             // eslint-disable-next-line no-await-in-loop -- pagination is sequential and depends on the next page URL.
-            const payload = await this.fetchJson(nextUrl, tokenValue, headers);
+            const payload = await this.fetchJson(currentUrl, tokenValue, headers);
             const results = payload.results ?? [];
             for (const result of results) {
                 yield result;
@@ -79,11 +82,21 @@ export class PaginatedCommand extends BaseCommand {
                 break;
             }
             try {
-                nextUrl = new URL(payload.next, nextUrl);
+                const parsedNext = new URL(payload.next, currentUrl);
+                nextUrl = this.normalizeNextUrl(parsedNext, currentUrl);
             }
             catch {
                 this.error('API returned an invalid next URL for pagination.');
             }
         }
     }
+    normalizeNextUrl(nextUrl, currentUrl) {
+        if (currentUrl.protocol === 'https:' && nextUrl.protocol === 'http:' && nextUrl.hostname === currentUrl.hostname) {
+            nextUrl.protocol = currentUrl.protocol;
+            if (currentUrl.port) {
+                nextUrl.port = currentUrl.port;
+            }
+        }
+        return nextUrl;
+    }
 }

package/oclif.manifest.json

@@ -1455,17 +1455,18 @@
         "update.js"
       ]
     },
-    "documents:add": {
+    "document-types:add": {
       "aliases": [],
       "args": {
-        "path": {
-          "description": "Document file path(s)",
-          "name": "path"
+        "name": {
+          "description": "Document type name",
+          "name": "name",
+          "required": true
         }
       },
-      "description": "Upload one or more documents. Supports multiple arguments or a glob.",
+      "description": "Create a document type",
       "examples": [
-        "<%= config.bin %> <%= command.id %> ./receipt.pdf --title \"Receipt\""
+        "<%= config.bin %> <%= command.id %> \"Invoice\""
       ],
       "flags": {
         "json": {
@@ -1533,83 +1534,33 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "archive-serial-number": {
-          "description": "Archive serial number",
-          "name": "archive-serial-number",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "correspondent": {
-          "description": "Correspondent id",
-          "name": "correspondent",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "created": {
-          "description": "Document created date-time",
-          "name": "created",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "document-type": {
-          "description": "Document type id",
-          "name": "document-type",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "storage-path": {
-          "description": "Storage path id",
-          "name": "storage-path",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "tag": {
-          "description": "Tag id (repeatable)",
-          "name": "tag",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "title": {
-          "description": "Document title",
-          "name": "title",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "documents:add",
+      "id": "document-types:add",
       "pluginAlias": "@nickchristensen/ppls",
       "pluginName": "@nickchristensen/ppls",
       "pluginType": "core",
-      "strict": false,
-      "enableJsonFlag": true,
+      "strict": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "documents",
+        "document-types",
         "add.js"
       ]
     },
-    "documents:delete": {
+    "document-types:delete": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Document id",
+          "description": "Document type id",
           "name": "id",
           "required": true
         }
       },
-      "description": "Delete a document",
+      "description": "Delete a document type",
       "examples": [
         "<%= config.bin %> <%= command.id %> 123"
       ],
@@ -1690,7 +1641,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "documents:delete",
+      "id": "document-types:delete",
       "pluginAlias": "@nickchristensen/ppls",
       "pluginName": "@nickchristensen/ppls",
       "pluginType": "core",
@@ -1699,23 +1650,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "documents",
+        "document-types",
         "delete.js"
       ]
     },
-    "documents:download": {
+    "document-types:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Document id or comma-separated list of ids",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Download one or more documents",
+      "args": {},
+      "description": "List document types",
       "examples": [
-        "<%= config.bin %> <%= command.id %> 123 --output document.pdf",
-        "<%= config.bin %> <%= command.id %> 123,124 --output-dir ./downloads"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
         "json": {
@@ -1784,29 +1728,43 @@
           "multiple": false,
           "type": "option"
         },
-        "original": {
-          "description": "Download original file",
-          "name": "original",
-          "allowNo": false,
-          "type": "boolean"
+        "page": {
+          "description": "Page number to fetch",
+          "name": "page",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "output": {
-          "char": "o",
-          "description": "Output file path (single document)",
+        "page-size": {
+          "description": "Number of results per page",
+          "name": "page-size",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "id-in": {
+          "description": "Filter by id list (comma-separated)",
           "exclusive": [
-            "output-dir"
+            "name-contains"
           ],
-          "name": "output",
+          "name": "id-in",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "output-dir": {
-          "description": "Output directory (multiple documents)",
+        "name-contains": {
+          "description": "Filter by name substring",
           "exclusive": [
-            "output"
+            "id-in"
           ],
-          "name": "output-dir",
+          "name": "name-contains",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sort": {
+          "description": "Sort results by the provided field",
+          "name": "sort",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1814,7 +1772,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "documents:download",
+      "id": "document-types:list",
       "pluginAlias": "@nickchristensen/ppls",
       "pluginName": "@nickchristensen/ppls",
       "pluginType": "core",
@@ -1824,16 +1782,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "documents",
-        "download.js"
+        "document-types",
+        "list.js"
       ]
     },
-    "documents:list": {
+    "document-types:show": {
       "aliases": [],
-      "args": {},
-      "description": "List documents",
+      "args": {
+        "id": {
+          "description": "Document type id",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Show document type details",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %> 123"
       ],
       "flags": {
         "json": {
@@ -1901,77 +1865,35 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "page": {
-          "description": "Page number to fetch",
-          "name": "page",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page-size": {
-          "description": "Number of results per page",
-          "name": "page-size",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "id-in": {
-          "description": "Filter by id list (comma-separated)",
-          "exclusive": [
-            "name-contains"
-          ],
-          "name": "id-in",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name-contains": {
-          "description": "Filter by name substring",
-          "exclusive": [
-            "id-in"
-          ],
-          "name": "name-contains",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sort": {
-          "description": "Sort results by the provided field",
-          "name": "sort",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "documents:list",
+      "id": "document-types:show",
       "pluginAlias": "@nickchristensen/ppls",
       "pluginName": "@nickchristensen/ppls",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "documents",
-        "list.js"
+        "document-types",
+        "show.js"
       ]
     },
-    "documents:show": {
+    "document-types:update": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Document id",
+          "description": "Document type id",
           "name": "id",
           "required": true
         }
       },
-      "description": "Show document details",
+      "description": "Update a document type",
       "examples": [
-        "<%= config.bin %> <%= command.id %> 123"
+        "<%= config.bin %> <%= command.id %> 123 --name \"Invoice\""
       ],
       "flags": {
         "json": {
@@ -2039,11 +1961,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "name": {
+          "description": "Document type name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "documents:show",
+      "id": "document-types:update",
       "pluginAlias": "@nickchristensen/ppls",
       "pluginName": "@nickchristensen/ppls",
       "pluginType": "core",
@@ -2052,22 +1981,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "documents",
-        "show.js"
+        "document-types",
+        "update.js"
       ]
     },
-    "documents:update": {
+    "documents:add": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Document id",
-          "name": "id",
-          "required": true
+        "path": {
+          "description": "Document file path(s)",
+          "name": "path"
         }
       },
-      "description": "Update a document",
+      "description": "Upload one or more documents. Supports multiple arguments or a glob.",
       "examples": [
-        "<%= config.bin %> <%= command.id %> 123 --title \"Receipt\""
+        "<%= config.bin %> <%= command.id %> ./receipt.pdf --title \"Receipt\""
       ],
       "flags": {
         "json": {
@@ -2143,13 +2071,6 @@
           "multiple": false,
           "type": "option"
         },
-        "content": {
-          "description": "Document content",
-          "name": "content",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "correspondent": {
           "description": "Correspondent id",
           "name": "correspondent",
@@ -2158,7 +2079,7 @@
           "type": "option"
         },
         "created": {
-          "description": "Document created date",
+          "description": "Document created date-time",
           "name": "created",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2195,31 +2116,32 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "documents:update",
+      "id": "documents:add",
       "pluginAlias": "@nickchristensen/ppls",
       "pluginName": "@nickchristensen/ppls",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "documents",
-        "update.js"
+        "add.js"
       ]
     },
-    "document-types:add": {
+    "documents:delete": {
       "aliases": [],
       "args": {
-        "name": {
-          "description": "Document type name",
-          "name": "name",
+        "id": {
+          "description": "Document id",
+          "name": "id",
           "required": true
         }
       },
-      "description": "Create a document type",
+      "description": "Delete a document",
       "examples": [
-        "<%= config.bin %> <%= command.id %> \"Invoice\""
+        "<%= config.bin %> <%= command.id %> 123"
       ],
       "flags": {
         "json": {
@@ -2287,11 +2209,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmation prompt",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "document-types:add",
+      "id": "documents:delete",
       "pluginAlias": "@nickchristensen/ppls",
       "pluginName": "@nickchristensen/ppls",
       "pluginType": "core",
@@ -2300,22 +2229,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "document-types",
-        "add.js"
+        "documents",
+        "delete.js"
       ]
     },
-    "document-types:delete": {
+    "documents:download": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Document type id",
+          "description": "Document id or comma-separated list of ids",
           "name": "id",
           "required": true
         }
       },
-      "description": "Delete a document type",
+      "description": "Download one or more documents",
       "examples": [
-        "<%= config.bin %> <%= command.id %> 123"
+        "<%= config.bin %> <%= command.id %> 123 --output document.pdf",
+        "<%= config.bin %> <%= command.id %> 123,124 --output-dir ./downloads"
       ],
       "flags": {
         "json": {
@@ -2384,33 +2314,54 @@
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "char": "y",
-          "description": "Skip confirmation prompt",
-          "name": "yes",
+        "original": {
+          "description": "Download original file",
+          "name": "original",
           "allowNo": false,
           "type": "boolean"
+        },
+        "output": {
+          "char": "o",
+          "description": "Output file path (single document)",
+          "exclusive": [
+            "output-dir"
+          ],
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output-dir": {
+          "description": "Output directory (multiple documents)",
+          "exclusive": [
+            "output"
+          ],
+          "name": "output-dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "document-types:delete",
+      "id": "documents:download",
       "pluginAlias": "@nickchristensen/ppls",
       "pluginName": "@nickchristensen/ppls",
       "pluginType": "core",
       "strict": true,
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "document-types",
-        "delete.js"
+        "documents",
+        "download.js"
       ]
     },
-    "document-types:list": {
+    "documents:list": {
       "aliases": [],
       "args": {},
-      "description": "List document types",
+      "description": "List documents",
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
@@ -2525,7 +2476,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "document-types:list",
+      "id": "documents:list",
       "pluginAlias": "@nickchristensen/ppls",
       "pluginName": "@nickchristensen/ppls",
       "pluginType": "core",
@@ -2535,20 +2486,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "document-types",
+        "documents",
         "list.js"
       ]
     },
-    "document-types:show": {
+    "documents:show": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Document type id",
+          "description": "Document id",
           "name": "id",
           "required": true
         }
       },
-      "description": "Show document type details",
+      "description": "Show document details",
       "examples": [
         "<%= config.bin %> <%= command.id %> 123"
       ],
@@ -2622,7 +2573,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "document-types:show",
+      "id": "documents:show",
       "pluginAlias": "@nickchristensen/ppls",
       "pluginName": "@nickchristensen/ppls",
       "pluginType": "core",
@@ -2631,22 +2582,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "document-types",
+        "documents",
         "show.js"
       ]
     },
-    "document-types:update": {
+    "documents:update": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Document type id",
+          "description": "Document id",
           "name": "id",
           "required": true
         }
       },
-      "description": "Update a document type",
+      "description": "Update a document",
       "examples": [
-        "<%= config.bin %> <%= command.id %> 123 --name \"Invoice\""
+        "<%= config.bin %> <%= command.id %> 123 --title \"Receipt\""
       ],
       "flags": {
         "json": {
@@ -2715,9 +2666,58 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "Document type name",
-          "name": "name",
+        "archive-serial-number": {
+          "description": "Archive serial number",
+          "name": "archive-serial-number",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "content": {
+          "description": "Document content",
+          "name": "content",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "correspondent": {
+          "description": "Correspondent id",
+          "name": "correspondent",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "created": {
+          "description": "Document created date",
+          "name": "created",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "document-type": {
+          "description": "Document type id",
+          "name": "document-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "storage-path": {
+          "description": "Storage path id",
+          "name": "storage-path",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tag": {
+          "description": "Tag id (repeatable)",
+          "name": "tag",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "title": {
+          "description": "Document title",
+          "name": "title",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2725,7 +2725,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "document-types:update",
+      "id": "documents:update",
       "pluginAlias": "@nickchristensen/ppls",
       "pluginName": "@nickchristensen/ppls",
       "pluginType": "core",
@@ -2734,7 +2734,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "document-types",
+        "documents",
         "update.js"
       ]
     },
@@ -3309,5 +3309,5 @@
       ]
     }
   },
-  "version": "1.0.1"
+  "version": "1.0.2"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nickchristensen/ppls",
   "description": "A node-based paperless-ngx cli",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "author": "Nick Christensen",
   "bin": {
     "ppls": "./bin/run.js"