lua-cli 2.5.1 → 2.5.3

package/CHANGELOG.md

@@ -5,6 +5,35 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.5.2] - 2025-10-07
+
+### ✨ New Features
+- **Direct Property Access for All Instance Classes**: Extended Proxy pattern to all instance types
+  - `ProductInstance` now supports `product.name` instead of `product.data.name`
+  - `DataEntryInstance` now supports `entry.fieldName` instead of `entry.data.fieldName`
+  - `BasketInstance` now supports `basket.items` (checks instance → data → common)
+  - `OrderInstance` now supports `order.shippingAddress` (checks instance → data → common)
+  
+- **Array-Like Methods for Product Collections**: Direct iteration support
+  - `ProductSearchInstance` now supports `.map()`, `.filter()`, `.forEach()`, etc.
+  - `ProductPaginationInstance` now supports all array methods
+  - Both support `for...of` loops and spread operators
+  - Direct `.length` property access
+
+### 🔧 Improvements
+- **Consistent API**: All instance classes now follow the same intuitive access patterns
+- **Enhanced Iteration**: Product collections can be treated as arrays
+- **Better TypeScript Support**: Index signatures on all instance classes
+
+### 📖 Documentation
+- **Comprehensive Instance Types Documentation**: Added complete guide for all instance types
+
+### Technical Details
+- Added Proxy implementations to ProductInstance, DataEntryInstance, BasketInstance, OrderInstance
+- Added array method delegation to ProductSearchInstance and ProductPaginationInstance
+- Added Symbol.iterator support for proper iteration
+- Type-safe implementations with proper generics
+
 ## [2.5.1] - 2025-10-07
 
 ### 🐛 Bug Fixes

package/CLI_REFERENCE.md

@@ -501,6 +501,96 @@ Press `Ctrl+C` to stop the file watcher and server.
 
 ---
 
+### `lua admin`
+
+Opens the Lua Admin Dashboard in your default browser.
+
+**Usage:**
+```bash
+lua admin
+```
+
+**What it does:**
+1. Loads your API key from secure storage
+2. Reads your skill configuration (agentId and orgId)
+3. Constructs authenticated admin dashboard URL
+4. Opens the dashboard in your default browser
+
+**Requirements:**
+- Must be authenticated (`lua auth configure`)
+- Must be in a skill directory (has `lua.skill.yaml`)
+- Config must contain `agent.agentId` and `agent.orgId`
+
+**What You Can Do:**
+- **📊 Usage Analytics** - View API calls, skill usage, performance
+- **⚙️ Agent Configuration** - Manage settings, persona, metadata
+- **💳 Billing & Subscriptions** - View plans, payment, billing history
+- **👥 Team Management** - Add/remove members, permissions
+- **🔑 API Key Management** - View, generate, revoke keys
+
+**Example:**
+```bash
+$ lua admin
+✓ Lua Admin Dashboard opened in your browser
+
+  Dashboard URL: https://admin.heylua.ai
+  Agent ID: agent-abc123
+  Organization ID: org-xyz789
+```
+
+**Errors:**
+```bash
+# No API key
+❌ Error during admin: No API key found. Please run "lua configure" first.
+
+# Not in skill directory
+❌ Error during admin: Could not read lua.skill.yaml. Please ensure you are in a Lua skill directory.
+
+# Missing configuration
+❌ Error during admin: No agentId found in lua.skill.yaml. Please ensure your configuration is valid.
+```
+
+---
+
+### `lua docs`
+
+Opens the Lua documentation website in your default browser.
+
+**Usage:**
+```bash
+lua docs
+```
+
+**What it does:**
+Opens https://docs.heylua.ai in your default browser for quick access to:
+- Platform overview and concepts
+- CLI command reference
+- API documentation and guides
+- Tool examples (30+ examples)
+- Integration tutorials
+- Best practices and tips
+
+**Requirements:**
+None - works from anywhere
+
+**Example:**
+```bash
+$ lua docs
+✓ Lua Documentation opened in your browser
+
+  Documentation: https://docs.heylua.ai
+```
+
+**Documentation Sections:**
+- **Overview** - Platform introduction and key concepts
+- **CLI** - Complete command reference
+- **API Reference** - Platform APIs (Products, Baskets, Orders, Data)
+- **Tool Examples** - E-commerce, integrations, custom logic
+- **Demos** - Full example implementations
+- **Best Practices** - Tips for building effective agents
+
+---
+
 ## Command Reference
 
 ### Global Flags