bkper 4.6.0 → 4.6.3

package/README.md

@@ -1,4 +1,4 @@
-[bkper.yaml reference]: https://raw.githubusercontent.com/bkper/bkper-cli/main/docs/bkper-reference.yaml
+[bkper.yaml reference]: #bkperyaml-reference
 [Developer Docs]: https://bkper.com/docs
 [App Template]: https://github.com/bkper/bkper-app-template
 [Skills Repository]: https://github.com/bkper/skills
@@ -11,18 +11,23 @@ A **command-line interface** for [Bkper](https://bkper.com), a financial account
 
 ### Prerequisites
 
--   [Node.js](https://nodejs.org/) >= 18
+- [Node.js](https://nodejs.org/) >= 18
 
 ### Install (choose one)
 
-```bash
-# bun
+```bash tab="bun"
 bun add -g bkper
+```
 
-# npm
+```bash tab="npm"
 npm i -g bkper
+```
+
+```bash tab="pnpm"
+pnpm add -g bkper
+```
 
-# yarn
+```bash tab="yarn"
 yarn global add bkper
 ```
 
@@ -32,6 +37,19 @@ yarn global add bkper
 bkper auth login
 ```
 
+### Access Token
+
+Use the access token for direct API calls from any tool:
+
+```bash
+# Print the current access token
+TOKEN=$(bkper auth token)
+
+# Use it with curl, httpie, or any HTTP client
+curl -s -H "Authorization: Bearer $TOKEN" \
+  https://api.bkper.app/v5/books | jq '.items[].name'
+```
+
 ### Try It
 
 ```bash
@@ -82,27 +100,27 @@ bkper book update abc123 --lock-date 2024-12-31
 <details>
 <summary>Command reference</summary>
 
--   `book list` - List all books
-    -   `-q, --query <query>` - Search query
--   `book get <bookId>` - Get a book's details
--   `book create` - Create a new book
-    -   `--name <name>` - Book name (required)
-    -   `--fraction-digits <digits>` - Number of decimal places (`0`-`8`)
-    -   `--date-pattern <pattern>` - Date format pattern (`dd/MM/yyyy`, `MM/dd/yyyy`, or `yyyy/MM/dd`)
-    -   `--decimal-separator <separator>` - Decimal separator (`DOT` or `COMMA`)
-    -   `--time-zone <timezone>` - IANA time zone (e.g. `America/New_York`, `UTC`)
-    -   `--period <period>` - Period (`MONTH`, `QUARTER`, or `YEAR`)
-    -   `-p, --property <key=value>` - Set a property (repeatable)
--   `book update <bookId>` - Update a book
-    -   `--name <name>` - Book name
-    -   `--fraction-digits <digits>` - Number of decimal places (`0`-`8`)
-    -   `--date-pattern <pattern>` - Date format pattern (`dd/MM/yyyy`, `MM/dd/yyyy`, or `yyyy/MM/dd`)
-    -   `--decimal-separator <separator>` - Decimal separator (`DOT` or `COMMA`)
-    -   `--time-zone <timezone>` - IANA time zone identifier (e.g. `America/New_York`, `Europe/London`, `UTC`)
-    -   `--lock-date <date>` - Lock date in ISO format (`yyyy-MM-dd`, e.g. `2024-01-31`)
-    -   `--closing-date <date>` - Closing date in ISO format (`yyyy-MM-dd`)
-    -   `--period <period>` - Period (`MONTH`, `QUARTER`, or `YEAR`)
-    -   `-p, --property <key=value>` - Set a property (repeatable, e.g. `-p code=1010 -p branch=NYC`; empty value deletes the property)
+- `book list` - List all books
+    - `-q, --query <query>` - Search query
+- `book get <bookId>` - Get a book's details
+- `book create` - Create a new book
+    - `--name <name>` - Book name (required)
+    - `--fraction-digits <digits>` - Number of decimal places (`0`-`8`)
+    - `--date-pattern <pattern>` - Date format pattern (`dd/MM/yyyy`, `MM/dd/yyyy`, or `yyyy/MM/dd`)
+    - `--decimal-separator <separator>` - Decimal separator (`DOT` or `COMMA`)
+    - `--time-zone <timezone>` - IANA time zone (e.g. `America/New_York`, `UTC`)
+    - `--period <period>` - Period (`MONTH`, `QUARTER`, or `YEAR`)
+    - `-p, --property <key=value>` - Set a property (repeatable)
+- `book update <bookId>` - Update a book
+    - `--name <name>` - Book name
+    - `--fraction-digits <digits>` - Number of decimal places (`0`-`8`)
+    - `--date-pattern <pattern>` - Date format pattern (`dd/MM/yyyy`, `MM/dd/yyyy`, or `yyyy/MM/dd`)
+    - `--decimal-separator <separator>` - Decimal separator (`DOT` or `COMMA`)
+    - `--time-zone <timezone>` - IANA time zone identifier (e.g. `America/New_York`, `Europe/London`, `UTC`)
+    - `--lock-date <date>` - Lock date in ISO format (`yyyy-MM-dd`, e.g. `2024-01-31`)
+    - `--closing-date <date>` - Closing date in ISO format (`yyyy-MM-dd`)
+    - `--period <period>` - Period (`MONTH`, `QUARTER`, or `YEAR`)
+    - `-p, --property <key=value>` - Set a property (repeatable, e.g. `-p code=1010 -p branch=NYC`; empty value deletes the property)
 
 </details>
 
@@ -133,20 +151,20 @@ bkper account delete "Old Account" -b abc123
 <details>
 <summary>Command reference</summary>
 
--   `account list -b <bookId>` - List accounts in a book
--   `account get <nameOrId> -b <bookId>` - Get an account
--   `account create -b <bookId>` - Create a new account
-    -   `--name <name>` - Account name (required)
-    -   `--type <type>` - Account type (`ASSET`, `LIABILITY`, `INCOMING`, `OUTGOING`)
-    -   `--description <description>` - Account description
-    -   `--groups <groups>` - Comma-separated group names
-    -   `-p, --property <key=value>` - Set a property (repeatable)
--   `account update <nameOrId> -b <bookId>` - Update an account
-    -   `--name <name>` - Account name
-    -   `--type <type>` - Account type (`ASSET`, `LIABILITY`, `INCOMING`, `OUTGOING`)
-    -   `--archived <true|false>` - Archive status
-    -   `-p, --property <key=value>` - Set a property (repeatable, merges with existing)
--   `account delete <nameOrId> -b <bookId>` - Delete an account
+- `account list -b <bookId>` - List accounts in a book
+- `account get <nameOrId> -b <bookId>` - Get an account
+- `account create -b <bookId>` - Create a new account
+    - `--name <name>` - Account name (required)
+    - `--type <type>` - Account type (`ASSET`, `LIABILITY`, `INCOMING`, `OUTGOING`)
+    - `--description <description>` - Account description
+    - `--groups <groups>` - Comma-separated group names
+    - `-p, --property <key=value>` - Set a property (repeatable)
+- `account update <nameOrId> -b <bookId>` - Update an account
+    - `--name <name>` - Account name
+    - `--type <type>` - Account type (`ASSET`, `LIABILITY`, `INCOMING`, `OUTGOING`)
+    - `--archived <true|false>` - Archive status
+    - `-p, --property <key=value>` - Set a property (repeatable, merges with existing)
+- `account delete <nameOrId> -b <bookId>` - Delete an account
 
 </details>
 
@@ -174,18 +192,18 @@ bkper group delete "Cash" -b abc123
 <details>
 <summary>Command reference</summary>
 
--   `group list -b <bookId>` - List groups in a book
--   `group get <nameOrId> -b <bookId>` - Get a group
--   `group create -b <bookId>` - Create a new group
-    -   `--name <name>` - Group name (required)
-    -   `--parent <parent>` - Parent group name or ID
-    -   `--hidden` - Hide the group
-    -   `-p, --property <key=value>` - Set a property (repeatable)
--   `group update <nameOrId> -b <bookId>` - Update a group
-    -   `--name <name>` - Group name
-    -   `--hidden <true|false>` - Hide status
-    -   `-p, --property <key=value>` - Set a property (repeatable, merges with existing)
--   `group delete <nameOrId> -b <bookId>` - Delete a group
+- `group list -b <bookId>` - List groups in a book
+- `group get <nameOrId> -b <bookId>` - Get a group
+- `group create -b <bookId>` - Create a new group
+    - `--name <name>` - Group name (required)
+    - `--parent <parent>` - Parent group name or ID
+    - `--hidden` - Hide the group
+    - `-p, --property <key=value>` - Set a property (repeatable)
+- `group update <nameOrId> -b <bookId>` - Update a group
+    - `--name <name>` - Group name
+    - `--hidden <true|false>` - Hide status
+    - `-p, --property <key=value>` - Set a property (repeatable, merges with existing)
+- `group delete <nameOrId> -b <bookId>` - Delete a group
 
 </details>
 
@@ -226,30 +244,30 @@ bkper transaction merge tx_123 tx_456 -b abc123
 <details>
 <summary>Command reference</summary>
 
--   `transaction list -b <bookId> -q <query>` - List transactions matching a query (auto-paginates through all results)
-    -   `-p, --properties` - Include custom properties in the output
--   `transaction create -b <bookId>` - Create a transaction
-    -   `--date <date>` - Transaction date
-    -   `--amount <amount>` - Transaction amount
-    -   `--description <description>` - Transaction description
-    -   `--from <from>` - Credit account (source)
-    -   `--to <to>` - Debit account (destination)
-    -   `--url <url>` - URL (repeatable)
-    -   `--remote-id <remoteId>` - Remote ID (repeatable)
-    -   `-p, --property <key=value>` - Set a property (repeatable, empty value deletes)
--   `transaction update [transactionId] -b <bookId>` - Update a transaction (or batch update via stdin)
-    -   `--date <date>` - Transaction date
-    -   `--amount <amount>` - Transaction amount
-    -   `--description <description>` - Transaction description
-    -   `--from <from>` - Credit account (source)
-    -   `--to <to>` - Debit account (destination)
-    -   `--url <url>` - URL (repeatable, replaces all)
-    -   `--update-checked` - Also update checked transactions
-    -   `-p, --property <key=value>` - Set a property (repeatable, empty value deletes)
--   `transaction post <id> -b <bookId>` - Post a draft transaction
--   `transaction check <id> -b <bookId>` - Check a transaction
--   `transaction trash <id> -b <bookId>` - Trash a transaction
--   `transaction merge <id1> <id2> -b <bookId>` - Merge two transactions
+- `transaction list -b <bookId> -q <query>` - List transactions matching a query (auto-paginates through all results)
+    - `-p, --properties` - Include custom properties in the output
+- `transaction create -b <bookId>` - Create a transaction
+    - `--date <date>` - Transaction date
+    - `--amount <amount>` - Transaction amount
+    - `--description <description>` - Transaction description
+    - `--from <from>` - Credit account (source)
+    - `--to <to>` - Debit account (destination)
+    - `--url <url>` - URL (repeatable)
+    - `--remote-id <remoteId>` - Remote ID (repeatable)
+    - `-p, --property <key=value>` - Set a property (repeatable, empty value deletes)
+- `transaction update [transactionId] -b <bookId>` - Update a transaction (or batch update via stdin)
+    - `--date <date>` - Transaction date
+    - `--amount <amount>` - Transaction amount
+    - `--description <description>` - Transaction description
+    - `--from <from>` - Credit account (source)
+    - `--to <to>` - Debit account (destination)
+    - `--url <url>` - URL (repeatable, replaces all)
+    - `--update-checked` - Also update checked transactions
+    - `-p, --property <key=value>` - Set a property (repeatable, empty value deletes)
+- `transaction post <id> -b <bookId>` - Post a draft transaction
+- `transaction check <id> -b <bookId>` - Check a transaction
+- `transaction trash <id> -b <bookId>` - Trash a transaction
+- `transaction merge <id1> <id2> -b <bookId>` - Merge two transactions
 
 </details>
 
@@ -268,8 +286,8 @@ bkper balance list -b abc123 -q "period:2025-01" --expanded 2
 <details>
 <summary>Command reference</summary>
 
--   `balance list -b <bookId> -q <query>` - List balances
-    -   `--expanded <level>` - Expand groups to specified depth (`0`+)
+- `balance list -b <bookId> -q <query>` - List balances
+    - `--expanded <level>` - Expand groups to specified depth (`0`+)
 
 </details>
 
@@ -297,17 +315,17 @@ bkper collection delete col_789
 <details>
 <summary>Command reference</summary>
 
--   `collection list` - List all collections
--   `collection get <collectionId>` - Get a collection
--   `collection create` - Create a new collection
-    -   `--name <name>` - Collection name (required)
--   `collection update <collectionId>` - Update a collection
-    -   `--name <name>` - Collection name
--   `collection delete <collectionId>` - Delete a collection
--   `collection add-book <collectionId>` - Add books to a collection
-    -   `-b, --book <bookId>` - Book ID (repeatable)
--   `collection remove-book <collectionId>` - Remove books from a collection
-    -   `-b, --book <bookId>` - Book ID (repeatable)
+- `collection list` - List all collections
+- `collection get <collectionId>` - Get a collection
+- `collection create` - Create a new collection
+    - `--name <name>` - Collection name (required)
+- `collection update <collectionId>` - Update a collection
+    - `--name <name>` - Collection name
+- `collection delete <collectionId>` - Delete a collection
+- `collection add-book <collectionId>` - Add books to a collection
+    - `-b, --book <bookId>` - Book ID (repeatable)
+- `collection remove-book <collectionId>` - Remove books from a collection
+    - `-b, --book <bookId>` - Book ID (repeatable)
 
 </details>
 
@@ -334,18 +352,18 @@ bkper account list -b abc123 --format csv
 
 **CSV output details:**
 
--   **RFC 4180 compliant** -- proper quoting, CRLF line endings, no truncation
--   **All metadata included** -- IDs, properties, hidden properties, URLs, and timestamps are enabled
--   **Raw values** -- dates stay in ISO format, numbers are unformatted (no locale formatting)
--   **Single-item commands** (e.g. `account get`, `transaction create`) fall back to JSON since CSV adds no value for non-tabular data
+- **RFC 4180 compliant** -- proper quoting, CRLF line endings, no truncation
+- **All metadata included** -- IDs, properties, hidden properties, URLs, and timestamps are enabled
+- **Raw values** -- dates stay in ISO format, numbers are unformatted (no locale formatting)
+- **Single-item commands** (e.g. `account get`, `transaction create`) fall back to JSON since CSV adds no value for non-tabular data
 
 **AI agent guidance:**
 
 When using the CLI from an AI agent, LLM, or automated script:
 
--   **Use `--format csv` for list commands.** CSV is dramatically more token-efficient than JSON for tabular data -- typically 3-5x fewer tokens for the same information.
--   **Use `--format json` for single-item commands** (`get`, `create`, `update`) where you need structured field access.
--   **Pipe data in via stdin** for batch operations (see below).
+- **Use `--format csv` for list commands.** CSV is dramatically more token-efficient than JSON for tabular data -- typically 3-5x fewer tokens for the same information.
+- **Use `--format json` for single-item commands** (`get`, `create`, `update`) where you need structured field access.
+- **Pipe data in via stdin** for batch operations (see below).
 
 ### Batch Operations & Piping
 
@@ -523,59 +541,278 @@ bkper app secrets delete API_KEY
 
 ### Configuration
 
-Apps are configured via a `bkper.yaml` file in the project root. See the complete reference with all available fields: **[bkper.yaml reference]**.
+Apps are configured via a `bkper.yaml` file in the project root. See the complete **[bkper.yaml reference]** below.
+
+<details>
+<summary>bkper.yaml reference</summary>
+
+```yaml
+# =============================================================================
+# bkper.yaml Reference
+# =============================================================================
+# This file documents all available configuration options for Bkper Apps.
+# Copy the fields you need to your app's bkper.yaml file.
+#
+# For a minimal working template, see:
+# https://github.com/bkper/bkper-app-template
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# APP IDENTITY
+# -----------------------------------------------------------------------------
+# The app id is permanent and cannot be changed after creation.
+# Use lowercase letters, numbers, and hyphens only.
+id: my-app
+
+# Display name shown in the Bkper UI
+name: My App
+
+# Brief description of what the app does
+description: A Bkper app that does something useful
+
+# -----------------------------------------------------------------------------
+# BRANDING
+# -----------------------------------------------------------------------------
+# App logo for light mode (SVG recommended, PNG/JPG supported)
+logoUrl: https://example.com/logo.svg
+
+# App logo for dark mode (required for proper theming)
+logoUrlDark: https://example.com/logo-dark.svg
+
+# App website or documentation URL
+website: https://example.com
+
+# -----------------------------------------------------------------------------
+# OWNERSHIP
+# -----------------------------------------------------------------------------
+# Developer/company name
+ownerName: Your Name
+
+# Owner's logo/avatar URL
+ownerLogoUrl: https://example.com/owner-logo.png
+
+# Owner's website
+ownerWebsite: https://yoursite.com
+
+# Source code repository URL
+repoUrl: https://github.com/you/my-app
+
+# Whether the repository is private
+repoPrivate: true
+
+# Mark as deprecated (hides from app listings, existing installs continue working)
+deprecated: false
+
+# -----------------------------------------------------------------------------
+# ACCESS CONTROL
+# -----------------------------------------------------------------------------
+# Who can update the app configuration and deploy new versions.
+# Comma-separated list of Bkper usernames (not emails).
+# Supports domain wildcards for registered custom domains: *@yourdomain.com
+developers: victor, aldo, *@bkper.com
+
+# Who can install and use the app.
+# Same format as developers. Leave empty for public apps.
+users: maria, *@acme.com
+
+# -----------------------------------------------------------------------------
+# MENU INTEGRATION (optional)
+# -----------------------------------------------------------------------------
+# When configured, adds a menu item to Bkper's "More" menu.
+# Clicking opens a popup with the specified URL.
+
+# Production menu URL (supports variable substitution)
+menuUrl: https://${id}.bkper.app?bookId=${book.id}
+
+# Development menu URL (used when developer runs the app)
+menuUrlDev: http://localhost:8787?bookId=${book.id}
+
+# Custom menu text (defaults to app name if not specified)
+menuText: Open My App
+
+# Popup dimensions in pixels
+menuPopupWidth: 500
+menuPopupHeight: 300
+
+# -----------------------------------------------------------------------------
+# Menu URL Variables
+# -----------------------------------------------------------------------------
+# The following variables can be used in menuUrl and menuUrlDev:
+#
+# ${book.id}                - Current book ID
+# ${book.properties.xxx}    - Book property value (replace xxx with property key)
+# ${account.id}             - Selected account ID (in account context)
+# ${account.properties.xxx} - Account property value
+# ${group.id}               - Selected group ID (in group context)
+# ${group.properties.xxx}   - Group property value
+# ${transactions.ids}       - Comma-separated selected transaction IDs
+# ${transactions.query}     - Current search query
+# -----------------------------------------------------------------------------
+
+# -----------------------------------------------------------------------------
+# EVENT HANDLING (optional)
+# -----------------------------------------------------------------------------
+# When configured, Bkper calls your webhook URL when subscribed events occur.
+
+# Production webhook URL
+webhookUrl: https://${id}.bkper.app/events
+
+# Development webhook URL (auto-updated by bkper app dev)
+webhookUrlDev: https://<random>.trycloudflare.com/events
+
+# API version for event payloads
+apiVersion: v5
+
+# Events to subscribe to (remove events you don't need)
+events:
+    # Transaction
+    - TRANSACTION_CREATED
+    - TRANSACTION_POSTED
+    - TRANSACTION_CHECKED
+    - TRANSACTION_UNCHECKED
+    - TRANSACTION_UPDATED
+    - TRANSACTION_DELETED
+    - TRANSACTION_RESTORED
+    # Account
+    - ACCOUNT_CREATED
+    - ACCOUNT_UPDATED
+    - ACCOUNT_DELETED
+    # Group
+    - GROUP_CREATED
+    - GROUP_UPDATED
+    - GROUP_DELETED
+    # File
+    - FILE_CREATED
+    - FILE_UPDATED
+    # Query
+    - QUERY_CREATED
+    - QUERY_UPDATED
+    - QUERY_DELETED
+    # Comment
+    - COMMENT_CREATED
+    - COMMENT_DELETED
+    # Collaborator
+    - COLLABORATOR_ADDED
+    - COLLABORATOR_UPDATED
+    - COLLABORATOR_REMOVED
+    # Integration
+    - INTEGRATION_CREATED
+    - INTEGRATION_UPDATED
+    - INTEGRATION_DELETED
+    # Book
+    - BOOK_CREATED
+    - BOOK_UPDATED
+    - BOOK_DELETED
+    - BOOK_AUDITED
+
+# -----------------------------------------------------------------------------
+# FILE PATTERNS (optional)
+# -----------------------------------------------------------------------------
+# For file processing apps. When a file matching these patterns is uploaded,
+# a FILE_CREATED event is triggered with the file content.
+filePatterns:
+    - '*.ofx'
+    - '*.csv'
+
+# -----------------------------------------------------------------------------
+# PROPERTIES SCHEMA (optional)
+# -----------------------------------------------------------------------------
+# Defines autocomplete suggestions for custom properties in the Bkper UI.
+# Helps users discover and use the correct property keys/values for your app.
+propertiesSchema:
+    book:
+        keys:
+            - my_app_enabled
+            - my_app_config
+        values:
+            - 'true'
+            - 'false'
+    group:
+        keys:
+            - my_app_category
+        values:
+            - category_a
+            - category_b
+    account:
+        keys:
+            - my_app_sync_id
+    transaction:
+        keys:
+            - my_app_reference
+
+# -----------------------------------------------------------------------------
+# DEPLOYMENT CONFIGURATION (optional)
+# -----------------------------------------------------------------------------
+# For apps deployed to Bkper's Workers for Platforms infrastructure.
+deployment:
+    # Web handler (serves UI and API)
+    web:
+        bundle: packages/web/server/dist
+        # assets: packages/web/client/dist  # Static assets (when supported)
+
+    # Events handler (processes webhooks)
+    events:
+        bundle: packages/events/dist
+
+    # Platform services available to your app (one per type, auto-provisioned)
+    # See: https://developers.cloudflare.com/kv/
+    services:
+        - KV # Key-value storage
+```
+
+</details>
 
 **Environment variables:**
 
--   `BKPER_API_KEY` -- Optional. If not set, uses the Bkper API proxy with a managed API key. Set it for direct API access with your own quotas. Follow [these steps](https://bkper.com/docs/#rest-api-enabling) to enable.
+- `BKPER_API_KEY` -- Optional. If not set, uses the Bkper API proxy with a managed API key. Set it for direct API access with your own quotas. Follow [these steps](https://bkper.com/docs/#rest-api-enabling) to enable.
 
 <details>
 <summary>Command reference</summary>
 
 #### Authentication
 
--   `auth login` - Authenticate with Bkper, storing credentials locally
--   `auth logout` - Remove stored credentials
--   `auth token` - Print the current OAuth access token to stdout
+- `auth login` - Authenticate with Bkper, storing credentials locally
+- `auth logout` - Remove stored credentials
+- `auth token` - Print the current OAuth access token to stdout
 
 #### App Lifecycle
 
--   `app init <name>` - Scaffold a new app from the template
--   `app list` - List all apps you have access to
--   `app sync` - Sync [bkper.yaml reference] configuration (URLs, description) to Bkper API
--   `app build` - Build app artifacts
--   `app deploy` - Deploy built artifacts to Cloudflare Workers for Platforms
-    -   `-p, --preview` - Deploy to preview environment
-    -   `--events` - Deploy events handler instead of web handler
--   `app status` - Show deployment status
--   `app undeploy` - Remove app from platform
-    -   `-p, --preview` - Remove from preview environment
-    -   `--events` - Remove events handler instead of web handler
-    -   `--delete-data` - Permanently delete all associated data (requires confirmation)
-    -   `--force` - Skip confirmation prompts (use with `--delete-data` for automation)
--   `app dev` - Run local development servers
-    -   `--cp, --client-port <port>` - Client dev server port (default: `5173`)
-    -   `--sp, --server-port <port>` - Server simulation port (default: `8787`)
-    -   `--ep, --events-port <port>` - Events handler port (default: `8791`)
-    -   `-w, --web` - Run only the web handler
-    -   `-e, --events` - Run only the events handler
-    -   `--no-open` - Do not open browser on startup
+- `app init <name>` - Scaffold a new app from the template
+- `app list` - List all apps you have access to
+- `app sync` - Sync [bkper.yaml][bkper.yaml reference] configuration (URLs, description) to Bkper API
+- `app build` - Build app artifacts
+- `app deploy` - Deploy built artifacts to Cloudflare Workers for Platforms
+    - `-p, --preview` - Deploy to preview environment
+    - `--events` - Deploy events handler instead of web handler
+- `app status` - Show deployment status
+- `app undeploy` - Remove app from platform
+    - `-p, --preview` - Remove from preview environment
+    - `--events` - Remove events handler instead of web handler
+    - `--delete-data` - Permanently delete all associated data (requires confirmation)
+    - `--force` - Skip confirmation prompts (use with `--delete-data` for automation)
+- `app dev` - Run local development servers
+    - `--cp, --client-port <port>` - Client dev server port (default: `5173`)
+    - `--sp, --server-port <port>` - Server simulation port (default: `8787`)
+    - `--ep, --events-port <port>` - Events handler port (default: `8791`)
+    - `-w, --web` - Run only the web handler
+    - `-e, --events` - Run only the events handler
+    - `--no-open` - Do not open browser on startup
 
 > **Note:** `sync` and `deploy` are independent operations. Use `sync` to update your app's URLs in Bkper (required for webhooks and menu integration). Use `deploy` to push code to Cloudflare. For a typical deployment workflow, run both: `bkper app sync && bkper app deploy`
 
 #### App Installation
 
--   `app install <appId> -b <bookId>` - Install an app on a book
--   `app uninstall <appId> -b <bookId>` - Uninstall an app from a book
+- `app install <appId> -b <bookId>` - Install an app on a book
+- `app uninstall <appId> -b <bookId>` - Uninstall an app from a book
 
 #### Secrets Management
 
--   `app secrets put <name>` - Store a secret
-    -   `-p, --preview` - Set in preview environment
--   `app secrets list` - List all secrets
-    -   `-p, --preview` - List from preview environment
--   `app secrets delete <name>` - Delete a secret
-    -   `-p, --preview` - Delete from preview environment
+- `app secrets put <name>` - Store a secret
+    - `-p, --preview` - Set in preview environment
+- `app secrets list` - List all secrets
+    - `-p, --preview` - List from preview environment
+- `app secrets delete <name>` - Delete a secret
+    - `-p, --preview` - Delete from preview environment
 
 </details>
 
@@ -596,6 +833,6 @@ Bkper.setConfig({
 
 ## Documentation
 
--   [Developer Docs]
--   [App Template]
--   [Skills Repository]
+- [Developer Docs]
+- [App Template]
+- [Skills Repository]

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "bkper",
-    "version": "4.6.0",
+    "version": "4.6.3",
     "description": "Command line client for Bkper",
     "bin": {
         "bkper": "./lib/cli.js"
@@ -45,7 +45,7 @@
         "postversion": "git push --tags && yarn publish --new-version $npm_package_version && git push && echo \"Successfully released version $npm_package_version!\""
     },
     "dependencies": {
-        "bkper-js": "^2.29.2",
+        "bkper-js": "^2.29.4",
         "chokidar": "^5.0.0",
         "commander": "^13.1.0",
         "dotenv": "^8.2.0",