@wspc/cli 0.0.8 → 0.0.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wspc/cli",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "description": "Official TypeScript SDK and CLI for wspc (https://wspc.ai)",
   "type": "module",
   "bin": {

package/spec/openapi.json

@@ -323,10 +323,8 @@
             "description": "Opaque pagination cursor. Pass the `next_cursor` returned by the previous page to fetch the next slice. Omit on the first call."
           },
           "limit": {
-            "type": "integer",
-            "minimum": 1,
-            "maximum": 100,
-            "description": "Maximum number of members to return in this page (1–100). Defaults to 50. Larger values trade fewer round-trips for more bytes per response."
+            "type": "string",
+            "description": "Maximum members to return. Clamped to [1, 100]. Defaults to 50."
           }
         }
       },
@@ -1245,7 +1243,7 @@
           "email": {
             "type": "string",
             "format": "email",
-            "description": "Full alias address under @wspc.app, for example alice-shop@wspc.app."
+            "description": "Full alias address under the platform email domain or a fully verified organization custom domain, for example alice-shop@wspc.app or alice-shop@example.com."
           }
         },
         "required": [
@@ -2598,9 +2596,118 @@
                 }
               }
             ]
+          },
+          "include": {
+            "type": "string"
           }
         }
       },
+      "TodoWithRelations": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "user_id": {
+            "type": "string"
+          },
+          "project_id": {
+            "type": "string",
+            "description": "Project id this todo belongs to. Use /todo/projects/{id} to inspect the project."
+          },
+          "title": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "open",
+              "in_progress",
+              "done",
+              "cancelled"
+            ]
+          },
+          "parent_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "child_count": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "version": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "created_at": {
+            "type": "number"
+          },
+          "updated_at": {
+            "type": "number"
+          },
+          "deleted_at": {
+            "type": "number"
+          },
+          "due_at": {
+            "type": "string"
+          },
+          "type_id": {
+            "type": "string"
+          },
+          "custom_fields": {
+            "type": "object",
+            "additionalProperties": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ]
+            }
+          },
+          "children": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Todo"
+            }
+          },
+          "comments": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Comment"
+            }
+          },
+          "children_next_cursor": {
+            "type": "string"
+          },
+          "comments_next_cursor": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "user_id",
+          "project_id",
+          "title",
+          "status",
+          "parent_id",
+          "child_count",
+          "version",
+          "created_at",
+          "updated_at",
+          "type_id"
+        ]
+      },
       "ListRecurrenceRulesQuery": {
         "type": "object",
         "properties": {
@@ -2639,6 +2746,10 @@
             "items": {
               "$ref": "#/components/schemas/Todo"
             }
+          },
+          "next_cursor": {
+            "type": "string",
+            "description": "Opaque cursor for the next page. Absent on the last page."
           }
         },
         "required": [
@@ -7050,13 +7161,11 @@
           },
           {
             "schema": {
-              "type": "integer",
-              "minimum": 1,
-              "maximum": 100,
-              "description": "Maximum number of members to return in this page (1–100). Defaults to 50. Larger values trade fewer round-trips for more bytes per response."
+              "type": "string",
+              "description": "Maximum members to return. Clamped to [1, 100]. Defaults to 50."
             },
             "required": false,
-            "description": "Maximum number of members to return in this page (1–100). Defaults to 50. Larger values trade fewer round-trips for more bytes per response.",
+            "description": "Maximum members to return. Clamped to [1, 100]. Defaults to 50.",
             "name": "limit",
             "in": "query"
           }
@@ -14634,7 +14743,7 @@
           "EmailAliases"
         ],
         "summary": "Create a receiving alias",
-        "description": "### Overview\nReserves and provisions a new passwordless/disposable receiving email alias address under the configured WSPC domain. All inbound emails received on this alias will be forwarded into the caller's inbox.\n\n### When to Use\n- Use this endpoint to spin up a fresh, dedicated email address (e.g., `alice-shop@wspc.app`) for specific websites, newsletters, or contexts to prevent spam or categorize incoming mail.\n\n### Constraints\n- Requires a valid Bearer token in the `Authorization` header.\n- **Alias Formatting**: The local part must be between 5 and 32 characters, start with an alphanumeric character, and only contain letters, numbers, dots, underscores, and hyphens.\n- **Limit Check**: Each user is allowed a maximum of 10 active email aliases. Soft-deleted aliases do not count against this quota limit.\n\n### Troubleshooting\n- **401 Unauthorized**: Bearer token is missing, invalid, or expired.\n- **400 Bad Request / INVALID_CHARSET / RESERVED**: The alias local part contains invalid characters, is too short/long, or matches a reserved keyword.\n- **409 Conflict / ALIAS_CONFLICT**: An alias with the exact requested email address already exists globally (whether active or soft-deleted by any user).\n- **429 Too Many Requests / ALIAS_LIMIT_EXCEEDED**: The user has reached the active alias cap limit of 10. A previously deleted alias must be cleaned up or wait for quota availability.",
+        "description": "### Overview\nReserves and provisions a new passwordless/disposable receiving email alias address under the configured WSPC domain or a fully verified organization custom domain. All inbound emails received on this alias will be forwarded into the caller's inbox.\n\n### When to Use\n- Use this endpoint to spin up a fresh, dedicated email address (e.g., `alice-shop@wspc.app`) for specific websites, newsletters, or contexts to prevent spam or categorize incoming mail.\n\n### Constraints\n- Requires a valid Bearer token in the `Authorization` header.\n- **Alias Formatting**: The local part must be between 5 and 32 characters, start with an alphanumeric character, and only contain letters, numbers, dots, underscores, and hyphens.\n- **Custom Domains**: If the address uses a non-platform host, that domain must be registered to the caller's organization and have `status = verified`, `sending_status = verified`, and `receiving_status = verified`.\n- **Limit Check**: Each user is allowed a maximum of 10 active email aliases. Soft-deleted aliases do not count against this quota limit.\n\n### Troubleshooting\n- **401 Unauthorized**: Bearer token is missing, invalid, or expired.\n- **400 Bad Request / INVALID_CHARSET / RESERVED**: The alias local part contains invalid characters, is too short/long, or matches a reserved keyword.\n- **400 Bad Request / DOMAIN_NOT_FOUND**: The custom domain is not registered to the caller's organization.\n- **400 Bad Request / UNVERIFIED_DOMAIN**: The custom domain exists but is not verified yet.\n- **400 Bad Request / CUSTOM_DOMAIN_NOT_READY**: The custom domain exists but has not completed sending or receiving verification.\n- **409 Conflict / ALIAS_CONFLICT**: An alias with the exact requested email address already exists globally (whether active or soft-deleted by any user).\n- **429 Too Many Requests / ALIAS_LIMIT_EXCEEDED**: The user has reached the active alias cap limit of 10. A previously deleted alias must be cleaned up or wait for quota availability.",
         "security": [
           {
             "bearerAuth": []
@@ -14686,6 +14795,12 @@
                   "value": {
                     "email": "alice-bills@wspc.app"
                   }
+                },
+                "customDomain": {
+                  "summary": "Fully verified custom domain alias",
+                  "value": {
+                    "email": "alice-shop@example.com"
+                  }
                 }
               }
             }
@@ -14714,7 +14829,7 @@
             }
           },
           "400": {
-            "description": "Invalid alias email address, local part, or reserved local part.",
+            "description": "Invalid alias email address, local part, reserved local part, missing custom domain, unverified custom domain, or custom domain that is not ready for both sending and receiving.",
             "content": {
               "application/json": {
                 "schema": {
@@ -19545,7 +19660,6 @@
               "id": "id-short",
               "todo_id": "id-short",
               "user_id": "id-short",
-              "content": "truncate",
               "created_at": "relative-time",
               "updated_at": "relative-time",
               "deleted_at": "relative-time"
@@ -19977,7 +20091,7 @@
           }
         },
         "summary": "List comments on a todo",
-        "description": "### 🎯 Overview & Purpose\nList the comments attached to a todo, oldest-first by default.\n\n### 💡 Key Features & Constraints\n* **Ordering**: Defaults to chronological (`asc`). Pass `order=desc` for newest-first.\n* **Soft-deleted**: Hidden by default; pass `include_deleted=true` to include them.\n\n### ⚠️ Common Errors & Troubleshooting\n* **`NOT_FOUND` (HTTP 404)**: Thrown if the target todo does not exist or is soft-deleted.",
+        "description": "### 🎯 Overview & Purpose\nList the comments attached to a todo, oldest-first by default.\n\n### 💡 Key Features & Constraints\n* **Ordering**: Defaults to chronological (`asc`). Pass `order=desc` for newest-first.\n* **Soft-deleted**: Hidden by default; pass `include_deleted=true` to include them.\n* **Pagination**: Use `limit` (max 200, default 50) and `cursor` (the `next_cursor` from a previous response) to page through results. When `next_cursor` is absent in the response, you are on the last page. Returns `{ comments, next_cursor? }`. Changing `order` invalidates a cursor.\n\n### ⚠️ Common Errors & Troubleshooting\n* **`NOT_FOUND` (HTTP 404)**: Thrown if the target todo does not exist or is soft-deleted.\n* **`VALIDATION_ERROR`**: Thrown if a cursor was produced with a different `order` than the current request.",
         "security": [
           {
             "bearerAuth": []
@@ -20026,6 +20140,26 @@
             "required": false,
             "name": "include_deleted",
             "in": "query"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "description": "Max comments to return. Clamped to [1, 200]. Default 50 server-side."
+            },
+            "required": false,
+            "description": "Max comments to return. Clamped to [1, 200]. Default 50 server-side.",
+            "name": "limit",
+            "in": "query"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "description": "Opaque pagination cursor returned in `next_cursor` of a previous response."
+            },
+            "required": false,
+            "description": "Opaque pagination cursor returned in `next_cursor` of a previous response.",
+            "name": "cursor",
+            "in": "query"
           }
         ],
         "responses": {
@@ -20041,6 +20175,10 @@
                       "items": {
                         "$ref": "#/components/schemas/Comment"
                       }
+                    },
+                    "next_cursor": {
+                      "type": "string",
+                      "description": "Opaque cursor for the next page. Absent on the last page."
                     }
                   },
                   "required": [
@@ -22135,8 +22273,6 @@
               "project_id": "id-short",
               "parent_id": "id-short",
               "type_id": "id-short",
-              "title": "truncate",
-              "description": "truncate",
               "status": "status-badge",
               "due_at": "relative-time",
               "created_at": "relative-time",
@@ -22743,6 +22879,26 @@
             "required": false,
             "name": "include_orphan_fields",
             "in": "query"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "description": "Max todos to return. Clamped to [1, 200]. Default 50 server-side."
+            },
+            "required": false,
+            "description": "Max todos to return. Clamped to [1, 200]. Default 50 server-side.",
+            "name": "limit",
+            "in": "query"
+          },
+          {
+            "schema": {
+              "type": "string",
+              "description": "Opaque pagination cursor returned in `next_cursor` of a previous response."
+            },
+            "required": false,
+            "description": "Opaque pagination cursor returned in `next_cursor` of a previous response.",
+            "name": "cursor",
+            "in": "query"
           }
         ],
         "responses": {
@@ -23937,7 +24093,6 @@
               "id": "id-short",
               "todo_id": "id-short",
               "user_id": "id-short",
-              "content": "truncate",
               "created_at": "relative-time",
               "updated_at": "relative-time",
               "deleted_at": "relative-time"
@@ -24347,7 +24502,6 @@
               "id": "id-short",
               "todo_id": "id-short",
               "user_id": "id-short",
-              "content": "truncate",
               "created_at": "relative-time",
               "updated_at": "relative-time",
               "deleted_at": "relative-time"
@@ -27211,8 +27365,6 @@
               "project_id": "id-short",
               "parent_id": "id-short",
               "type_id": "id-short",
-              "title": "truncate",
-              "description": "truncate",
               "status": "status-badge",
               "due_at": "relative-time",
               "created_at": "relative-time",
@@ -27645,14 +27797,15 @@
               "project_id": "id-short",
               "parent_id": "id-short",
               "type_id": "id-short",
-              "title": "truncate",
-              "description": "truncate",
               "status": "status-badge",
               "due_at": "relative-time",
               "created_at": "relative-time",
               "updated_at": "relative-time",
               "deleted_at": "relative-time"
             }
+          },
+          "fixedQuery": {
+            "include": "children,comments"
           }
         },
         "summary": "Get a todo by id",
@@ -27718,19 +27871,27 @@
             "required": false,
             "name": "include_orphan_fields",
             "in": "query"
+          },
+          {
+            "schema": {
+              "type": "string"
+            },
+            "required": false,
+            "name": "include",
+            "in": "query"
           }
         ],
         "responses": {
           "200": {
-            "description": "The requested todo. Includes `deleted_at` only when fetched with `include_deleted=true` on a soft-deleted row.",
+            "description": "The requested todo. Includes `children` (first-level) when `include=children`, `comments` when `include=comments`, and `deleted_at` only when fetched with `include_deleted=true` on a soft-deleted row.",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/Todo"
+                  "$ref": "#/components/schemas/TodoWithRelations"
                 },
                 "examples": {
                   "happyPath": {
-                    "summary": "Active todo with a due date",
+                    "summary": "Todo with first-level children and comments expanded",
                     "value": {
                       "id": "tod_01HW3K4N9V5G6Z8C2Q7B1Y0M3F",
                       "user_id": "usr_01HW3K4N9V5G6Z8C2Q7B1Y0M3F",
@@ -27739,11 +27900,38 @@
                       "description": "Use refundable rate",
                       "status": "open",
                       "parent_id": null,
-                      "child_count": 0,
+                      "child_count": 1,
                       "version": 1,
                       "created_at": 1748736000000,
                       "updated_at": 1748736000000,
-                      "due_at": "2026-06-01"
+                      "due_at": "2026-06-01",
+                      "children": [
+                        {
+                          "id": "tod_child",
+                          "user_id": "usr_01HW3K4N9V5G6Z8C2Q7B1Y0M3F",
+                          "project_id": "prj_01HW3K4N9V5G6Z8C2Q7B1Y0M3F",
+                          "title": "Buy milk",
+                          "description": "Use refundable rate",
+                          "status": "open",
+                          "parent_id": "tod_01HW3K4N9V5G6Z8C2Q7B1Y0M3F",
+                          "child_count": 0,
+                          "version": 1,
+                          "created_at": 1748736000000,
+                          "updated_at": 1748736000000,
+                          "due_at": "2026-06-01"
+                        }
+                      ],
+                      "comments": [
+                        {
+                          "id": "tdc_01HW3K4N9V5G6Z8C2Q7B1Y0M3F",
+                          "todo_id": "tod_01HW3K4N9V5G6Z8C2Q7B1Y0M3F",
+                          "user_id": "usr_01HW3K4N9V5G6Z8C2Q7B1Y0M3F",
+                          "org_id": "org_01HW3K4N9V5G6Z8C2Q7B1Y0M3F",
+                          "content": "Looks good",
+                          "created_at": 1748736000000,
+                          "updated_at": 1748736000000
+                        }
+                      ]
                     }
                   }
                 }
@@ -28097,8 +28285,6 @@
               "project_id": "id-short",
               "parent_id": "id-short",
               "type_id": "id-short",
-              "title": "truncate",
-              "description": "truncate",
               "status": "status-badge",
               "due_at": "relative-time",
               "created_at": "relative-time",