hasyxv0.2.0-alpha.49

😈 Hasyx

🧪 Diagnostics
🛠️ Config
🟡 PWA Diagnostics
🟢 Constructor
🟠 A-Frame
🟢 Cyto
🟡 Payments
🟢 Telegram
🟠 Roadmap
🔍 Validation
📁 Files
💬 Messaging
👥 Groups
🃏 Hover Card Demo
💢 Shock Demo
🟦 Columns

📚 Documentation

- Core Components
- 1. Dialog Class
- Usage
- Dialog Events (`DialogEvent`)
- 2. AIProvider Interface
- 3. Tooler and Tool Classes
- Tool Execution Flow
- useCreateApolloClient
- Purpose
- Arguments
- Return Value
- Key Features
- How `roleLink` Works
- Quick Start
- Non-Interactive Mode (`-e`)
- Provider and Model Selection
- Interactive Mode
- How It Works
- Features
- 🎨 Beautiful Terminal Output
- Formatted Output Features
- Example Formatted Output
- 🎯 Real-time Progress Indicators
- Progress Indicators
- Example Output with Syntax Highlighting
- Automatic Code Execution
- Multi-iteration Processing
- Installation & Setup
- 1. Install Hasyx
- 2. Get OpenRouter API Key
- 3. Configure via Hasyx Config (do not edit `.env` manually)
- Usage
- Direct Question Mode
- Interactive Chat Mode
- Examples
- Coding Questions
- Math and Calculations
- General Knowledge
- Interactive Session Example with Real-time Streaming
- Available Models
- List Available Models
- Provider Support
- Example Output
- Using Specific Models
- Programmatic Access
- Model Information
- Configuration
- Default Settings
- Model Information
- Error Handling
- Missing API Key
- API Errors
- Interactive Mode Issues
- Integration with Hasyx Projects
- npm Scripts
- Environment Loading
- CLI Integration
- Advanced Usage
- Coding Assistance Workflow
- Learning and Documentation
- Problem Solving
- Tips and Best Practices
- Effective Question Asking
- Interactive Mode Tips
- Performance Tips
- Troubleshooting
- Common Issues
- Debug Mode
- Related Documentation
- API Reference
- Command Syntax
- Options
- Exit Codes
- Environment Variables
- Examples Repository
- Contributing
- Command Options
- Architecture
- Class Hierarchy
- Key Files
- AskOptions Configuration
- Example Usage in Child Projects
- Execution Engine Control
- Purpose
- Usage
- `WsClientsManager` (WebSocket Authentication)
- `getTokenFromRequest` (HTTP/WebSocket Token Retrieval)
- Test Authentication Helper
- `testAuthorize` (Development & Testing Only)
- JWT Auth: Local Storage Without Session
- How It Works
- Configuration
- Automatic JWT Auth for Client Builds
- JWT_FORCE: Guaranteed JWT Availability for Serverless
- Client Implementation
- Using Hasyx JWT Method
- API Endpoints
- Local Storage Keys
- Use Cases
- Dependencies
- Telegram Login Authentication
- Purpose
- Core Features
- DNS Record Management
- SSL Integration Support
- API Integration
- Idempotent Operations
- Prerequisites and Configuration
- Configuration via hasyx.config.json (recommended)
- Manual Environment Configuration (not recommended)
- Getting CloudFlare Credentials
- Environment Variables Usage
- Usage
- Basic Usage
- Environment-Based Configuration
- Advanced Usage
- Configuration Options
- CloudflareConfig Interface
- SubdomainDnsConfig Interface
- Environment Variables
- Core Methods
- DNS Record Information
- DNS Record Operations
- Idempotent Operations
- SSL Integration Methods
- DNS Record Structure
- DnsRecord Interface
- Integration with Other Modules
- With SSL Management
- With Nginx Configuration
- Complete Subdomain Setup
- Error Handling
- Common Error Scenarios
- Configuration Validation
- Best Practices
- 1. Use Define/Undefine for Idempotency
- 2. Configure TTL Appropriately
- 3. Use Proxied Records Wisely
- 4. Environment-Based Configuration
- Security Considerations
- API Token Security
- DNS Security
- Domain Management
- Troubleshooting
- Common Issues
- 🚀 Quick Start
- 🧩 Component Architecture
- Core Components
- Integration Examples
- 🔍 Interface Overview
- Left Panel: Query Builder
- Right Panel: Multi-View Tabs
- Modal Dialog Interface
- 📖 Core Features
- Smart Primary Key Detection
- Primary Key Visual Indicators
- Auto-populated Physical Fields
- Pagination Controls
- Multi-field Sorting
- Nested Relations
- 🎛️ Query Builder Sections
- Table Selection
- Where Conditions
- Pagination Section
- Order By Section
- Returning Fields
- 📊 Result Tabs
- `exp` Tab
- `gql` Tab
- `query` Tab
- `subscription` Tab
- 🔧 Complete State Interface
- 🎯 Field Type Support
- String Fields
- Numeric Fields (Int, Float, BigInt)
- Boolean Fields
- DateTime Fields
- UUID Fields
- JSONB Fields
- 🚀 Schema Integration
- Automatic Schema Loading
- Field Detection Logic
- Primary Key Detection
- Smart Query Optimization
- ⚡ Performance Features
- Efficient Field Sorting
- Smart Auto-population
- Optimized Queries
- 🎨 UI/UX Design
- Minimal Inline Design
- Visual Organization
- Accessibility
- Development Setup
- Debug Information
- Database Debug Logging
- Running Tests
- Test Environment Guidelines
- Code Style
- ⚠️ CRITICAL: Table Naming in Hasyx
- ✅ CORRECT - Use underscores:
- ❌ INCORRECT - Do NOT use dots:
- Schema to Table Name Mapping:
- Commit Messages
- Pull Requests
- Debugging Data Issues
- Testing Aggregation Features
- Quick Aggregation Tests
- Aggregation Testing Guidelines
- Writing Database Migrations
- Migration File Structure
- Running Migrations with Filters
- Core Migration Principles
- Project Structure Philosophy
- ⚠️ CRITICAL: API Architecture Principle
- Why This Matters
- Example Implementation
- Benefits of This Approach
- Specific Guidance for `app/payments/tbank/options.ts`
- `generateReceipt` Function Stub
- DNS and SSL Management
- Quick Setup
- Testing Philosophy
- Testing
- Adding Tests for New Features (e.g., Database Operators)
- Overview
- Core Components
- 1. `<Cyto />`
- 2. `<CytoNode />`
- 3. `<CytoEdge />`
- 4. `<CytoStyle />`
- 5. `useGraph()`
- Comprehensive Usage Example
- Automated Graph Rendering with `hasyx/lib/renderer`
- Key Aspects and Benefits
- 🚀 Quick Start
- Prerequisites
- Basic Commands
- 🐳 How It Works
- Ports
- Environment Variables
- Automatic Updates
- Container Naming
- 📋 Project Setup
- 1. package.json
- 2. .env file (auto-generated)
- 3. Dockerfile
- 🔧 CI/CD with GitHub Actions
- Architecture Support
- Security & Environment Variables
- Setup GitHub Secrets
- Automatic Publishing
- Troubleshooting Build Issues
- 🛠️ Usage Examples
- Local Development
- Production Deployment
- Monitoring
- 🔍 Troubleshooting
- Docker Not Installed
- Image Not Found
- Container Won't Start
- Port Already in Use
- 🎯 Configuration via hasyx.config.json
- 🔄 Workflow Integration
- GitHub Actions Workflow
- Container Features
- Overview
- Supported Trigger Types
- Event Triggers (Data Triggers)
- Cron Triggers (Scheduled Tasks)
- Architecture Flow
- Trigger Definitions
- Directory Structure
- Event Trigger Configuration Format
- Configuration Options
- CLI Commands
- API Route Handlers
- Default Handler and Dynamic Routing
- Trigger-to-Route Mapping
- Custom Handlers
- Payload Structure
- Security
- HASURA_EVENT_SECRET
- Request Verification
- Environment Variables
- Required Variables
- Optional Variables
- Workflow Examples
- 1. Adding a New Event Trigger
- 2. Adding a New Cron Trigger
- 3. Handling User Registration Events
- 4. Debugging Events
- Cron Schedule Format
- Common Cron Examples
- Cron Expression Tools
- Troubleshooting
- Common Issues
- Debug Commands
- Advanced Usage
- Manual Event Triggers
- Custom Retry Configuration
- Multiple Environment Support
- Advanced Cron Trigger Features
- Integration with Other Systems
- Email Notifications
- Analytics Tracking
- External API Synchronization
- Best Practices
- General Practices
- Event Trigger Specific
- Cron Trigger Specific
- Related Documentation
- Features
- Persistent State Management
- Using results[uuid] for Persistent State
- TypeScript Browser Automation Example
- Database Connection with Types
- Benefits for TypeScript Development
- Installation
- Usage
- Basic Usage
- With Context
- Factory Function
- Configuration
- Compiler Options
- Strict Mode
- TypeScript Features Supported
- Type Annotations
- Interfaces
- Type Aliases
- Generics
- Enums
- Type Assertions
- API Reference
- Class: ExecTs
- Interface: ExecTsOptions
- Configuration Loading
- TypeScript Detection
- Error Handling
- Integration with CLI
- Best Practices
- Examples
- Working with Hasyx Client
- Complex Type Operations
- Troubleshooting
- Common Issues
- Debug Mode
- See Also
- Purpose
- Core Features
- Environment Detection
- Execution Context Management
- Usage
- Basic Usage
- Factory Function
- Advanced Context Management
- Execution with Context Extension
- Configuration Options
- ExecOptions Interface
- Example with Options
- Dynamic Module Loading with use-m
- Basic use-m Usage
- Package Version Specification
- How use-m Works
- use-m Features
- Error Handling with use-m
- Performance Considerations
- Async/Await Support
- Built-in Objects and Functions
- Available Globals
- Environment-Specific Globals
- Error Handling
- Syntax Errors
- Runtime Errors
- Timeout Handling
- Advanced Examples
- Complex Data Processing
- Async Data Processing
- Function Definitions and Execution
- Environment Detection
- Static Methods
- Usage in Code
- Security Considerations
- Context Isolation
- Timeout Protection
- Environment Safety
- Testing
- Integration Examples
- CLI Tool Integration
- Dynamic Code Evaluation
- Dynamic Package Loading with use-m
- Microservice with Dynamic Dependencies
- Best Practices
- Overview
- Quick Start
- Prerequisites
- Installation
- Basic Usage
- Configuration
- Environment Variables
- Keystore Setup
- Available Lanes
- GitHub Actions Integration
- Android Build Workflow
- Manual Trigger
- Environment Variables in CI
- Advanced Configuration
- Custom Fastfile
- Plugin Integration
- Multi-Environment Support
- Troubleshooting
- Common Issues
- Debug Mode
- Best Practices
- 1. Secure Credential Management
- 2. Build Optimization
- 3. CI/CD Integration
- 4. Testing
- Examples
- Complete Release Workflow
- Automated Build Script
- Related Documentation
- Support
- Overview
- Quick Start
- 1. Configure File Storage
- 2. Apply Migrations
- 3. Generate Types
- Configuration
- Local Storage (MinIO)
- Cloud Storage
- Environment Variables
- Database Schema
- files
- Permissions
- User Permissions
- Admin Permissions
- API Endpoints
- Upload File
- Download File
- Delete File
- Usage Examples
- Upload File
- Download File
- Delete File
- Get File Info
- List Files
- Update File
- Using REST API
- Upload File via API
- Download File (public or authorized)
- Delete File (authorized)
- Authentication
- JWT Token Authentication
- NextAuth Session Authentication
- Anonymous Access
- Hasura Integration
- GraphQL Queries
- GraphQL Mutations
- Security
- File Validation
- Access Control
- API Security
- Performance
- Caching
- Optimization
- Monitoring
- Health Checks
- Logs
- Troubleshooting
- Common Issues
- Debug Mode
- Migrations
- Apply Migrations
- Rollback Migrations
- Custom Migrations
- Backup and Recovery
- Database Backup
- File Backup
- Restore
- Development
- Local Development
- Testing
- Production Deployment
- Environment Variables
- Security
- Monitoring
- Purpose
- Usage
- Accessing the Schema
- Options (`GenerateOptions` Interface)
- Examples
- JSONB Operations
- 1. Advanced Nested Query (Appending to Defaults)
- 2. Basic Query with `where`
- 3. Query with Pagination and Sorting
- 4. Query by Primary Key
- 5. Nested Query with Parameters and Alias
- 6. Aggregate Query
- 7. Insert Mutation (Single Object)
- 8. Insert Mutation (Bulk)
- 9. Update Mutation by Primary Key
- 10. Update Mutation by `where` Condition
- 11. Delete Mutation by Primary Key
- 12. Delete Mutation by `where` Condition
- 13. Subscription
- 14. Query with `distinct_on`
- 15. Advanced Nested Query with `where` Conditions
- 16. Deeply Nested Relations (Multiple Levels)
- 17. Complex `where` Clauses with Logical Operators
- 18. Using Field Aliases with Parameters
- 19. Mixed Array and Object Notation for Relations
- 20. Multiple Nested Relationships with Different Parameters
- 21. Nested Aggregate Query (Relations with Aggregation)
- 22. Combined Aggregate with Regular Data
- 23. Aggregate Functions with Column Specifications
- 24. Top-level Aggregate Query with Nodes
- 25. Upsert (Insert with `on_conflict`)
- Advanced Aggregation Patterns
- Real-world Tournament Example
- What’s Included
- Quick Start
- Using Hasyx Client (GraphQL)
- Select rows
- Select by primary key
- Update non-geometry fields
- Delete
- Geometry Writes via SQL
- Spatial Queries
- Nearby
- Within BBox
- Permissions Model
- Trigger Logic (Derived Columns)
- Under the Hood
- Testing Notes
- Migration Commands
- Overview
- Current Configuration
- Prerequisites
- Setup Steps
- 1. Verify Webhook Secret
- 2. Configure GitHub Webhook
- 3. Webhook Events Handled
- 4. Testing Webhooks
- 5. Security Considerations
- 6. Troubleshooting
- 7. Monitoring
- 8. Environment Variables
- 9. API Endpoints
- Integration with Events System
- 🎯 Purpose
- 🤔 Why is it needed?
- ⚙️ How it Works
- 1. GET Requests
- 2. POST Requests (Queries / Mutations)
- 3. WebSocket Connections (Subscriptions) - via `SOCKET`
- 🔧 Configuration
- 🔗 Client Integration
- ✅ Summary
- Overview
- Database Schema
- groups
- memberships
- invitations
- Triggers & Functions
- Permission Model
- Allow-list tokens
- groups
- memberships
- invitations
- Typical Flows
- Testing
- UI Pages
- 🎯 Что такое Hasyx
- 👥 Для кого и зачем
- Целевая аудитория
- Ключевые случаи использования
- Hasyx vs разработка с нуля
- 🏗️ Архитектура
- Основные компоненты
- Ключевые технические решения
- 🚀 Быстрый старт
- Предварительные требования
- 1. Установка
- 2. Инициализация
- 3. Конфигурация
- 4. Запуск
- ⚙️ Система конфигурации
- Концепция
- Структура hasyx.config.json
- Основные CLI команды
- Автоматическая генерация
- 🔐 Система аутентификации и авторизации
- Поддерживаемые провайдеры
- Базовая настройка аутентификации
- Применить все миграции
- Применить конкретные миграции
- Откатить миграции
- Сгенерировать TypeScript типы из схемы Hasura
- Интерактивная настройка хранилища
- Выберите Storage → Local MinIO / AWS S3 / другой провайдер
- Синхронизация всех event triggers с Hasura
- Создание шаблонов событий
- Очистка security headers (для миграции)
- Docker
- Поддомены с SSL
- Результат: https://api.yourdomain.com
- Логи
- Тесты
- Debug в production
- Overview
- One-off Scheduled Events
- Hasyx client convenience helper
- Constructor
- Options
- Core Methods
- Schema Operations
- Table Operations
- Column Operations
- Function Operations
- Trigger Operations
- Foreign Key Operations
- View Operations
- Relationship Operations
- Core Components
- Key Features (Both Class & Hooks)
- User Management
- User Properties
- Automatic Session Sync
- Session Hook
- Diagnostics
- `Hasyx` Class Usage
- `Hasyx` Class Methods
- `Hasyx` Class Properties
- `HasyxClient` Class (Client-Side)
- Key Features
- Usage with `useClient()` Hook
- `HasyxClient` Methods
- React Hooks Usage
- Overview
- Format
- Components:
- Segment Rules:
- `lib/hid.ts` Utility
- Initialization
- `HidInstance` Methods
- Environment Variable: `NEXT_PUBLIC_HID_NAMESPACE`
- Use Cases
- Hasyx View and Automated HID Generation
- Computed Columns for Relationships
- `public.hasyx` View Structure
- Automated Relationships
- Overview
- Database Schema
- invites
- invited
- Relationships
- Permissions (Hasura)
- API Route
- Client Integration
- Business Logic (`lib/invite.ts`)
- JWT Behavior
- UI
- Testing
- Migrations and Schema
- Troubleshooting
- Overview
- Architecture
- Database Schema
- Configuration
- hasyx.config.json (authoritative)
- CLI Commands
- Apply Configuration
- Testing
- Diffs System
- Features
- Workflow
- Implementation
- States System
- Features
- Workflow
- Implementation
- Event Triggers
- Diffs Event Trigger
- Workflow Example
- Security & Permissions
- Database Protections
- Trigger Protection
- Testing
- Test Coverage
- Test Strategy
- Dependencies
- Migration
- Migration File Structure
- Apply Migration
- Production Considerations
- Performance
- Monitoring
- Security
- Scalability
- Integration
- CLI Integration
- Features
- Installation
- Basic Usage
- Simple Formatting
- Code Blocks
- Lists and Tables
- Advanced Usage
- Custom Themes
- Utility Functions
- Supported Markdown Elements
- Headers
- Text Formatting
- Code Blocks
- Lists
- Links and Images
- Blockquotes
- Tables
- Horizontal Rules
- Configuration Options
- FormatMarkdownCustom Options
- Integration Examples
- With Ask Command
- With Custom CLI Tools
- With Documentation Generators
- API Reference
- Functions
- Examples
- Complete Example
- Testing Example
- Best Practices
- 1. Use Appropriate Functions
- 2. Handle Long Content
- 3. Choose Appropriate Themes
- 4. Error Handling
- Troubleshooting
- Common Issues
- Debug Mode
- Dependencies
- Related Documentation
- Overview
- Database Schema
- rooms
- messages
- replies
- message_reads
- Permission Model
- Allow-list tokens
- Rooms
- Messages
- Replies
- message_reads
- Typical Flows
- Create a room (authenticated user)
- Post a message and link it to a room
- Update a message (requires author AND all linked rooms allow change)
- Delete a reply (author or allowed by room)
- Real-time Streaming
- Migrations
- Testing
- Tips
- Purpose
- Core Features
- Path Auto-Detection
- Site Management
- Safety Features
- Prerequisites
- Usage
- Basic Usage
- Custom Path Configuration
- SSL Configuration
- Configuration Options
- NginxConfig Interface
- SiteConfig Interface
- Core Methods
- Site Information
- Site Operations
- Idempotent Operations
- Enable/Disable Operations
- Configuration Examples
- Basic HTTP Reverse Proxy
- HTTPS with SSL Certificates
- Custom Configuration with Multiple Locations
- Integration with Other Modules
- With SSL Management
- With CloudFlare DNS
- Generated Configuration
- HTTP Only Configuration
- HTTPS with Redirect Configuration
- Path Detection Logic
- Supported Distributions
- Error Handling
- Common Error Scenarios
- Configuration Validation
- Best Practices
- 1. Use Define/Undefine for Idempotency
- 2. Always Use SSL in Production
- 3. Configure Proper Proxy Headers
- 4. Use Custom Configuration for Complex Setups
- Security Considerations
- SSL Configuration
- Proxy Security
- File Permissions
- Troubleshooting
- Common Issues
- Prerequisites
- Install plugins
- Firebase config
- AndroidManifest
- Code changes (done)
- Build and run
- Testing plan (use app/hasyx/diagnostics)
- Notes
- How It Works: End-to-End Flow
- Prerequisites & Setup
- Customizing Notifications
- Advanced FCM Options
- Client-Side Service Worker (`firebase-messaging-sw.js`)
- Prerequisites
- Install plugins
- Xcode capabilities
- Firebase config
- AppDelegate updates (done)
- Request permission + get token (runtime)
- Build and run
- APNs key in Firebase
- Testing plan (use app/hasyx/diagnostics)
- Notes
- How It Works: End-to-End Flow
- Prerequisites & Setup
- Customizing Notifications
- Advanced FCM Options
- Client-Side Service Worker (`firebase-messaging-sw.js`)
- Telegram Bot Integration in Hasyx
- Features
- Setup
- How it Works
- Customization
- Core Concepts
- Workflow Overview
- Platform Support Status
- 1. Installation and Setup
- Install Ollama
- Download Models
- Manage Models
- 2. Usage with Hasyx `ask` CLI
- Non-Interactive Mode
- Interactive Mode
- 1. Setup
- 2. Usage with Hasyx `ask` CLI
- Non-Interactive Mode
- Interactive Mode
- Overview
- Migration
- Running the Migration
- Environment Support
- Local Development (Docker Compose)
- Hasura Cloud
- Usage
- Creating plv8 Functions
- Creating plv8 Triggers
- JSON Processing with plv8
- Array Operations with plv8
- Testing
- Running Tests
- Limitations
- Hasura Cloud
- Local Development
- Best Practices
- Migration Commands
- Troubleshooting
- plv8 Not Available
- Function Creation Fails
- Trigger Issues
- Features
- Quick Start
- 1. Generate PWA Assets
- 2. Enable PWA in Your App
- 3. Use PWA Components
- 4. Use PWA Hooks
- Configuration
- Environment Variables
- Customizing the Web App Manifest
- Customizing App Icons
- Service Worker Caching Strategies
- Network First (API Calls)
- Cache First (Static Assets)
- Stale While Revalidate (Pages)
- Offline Support
- GraphQL Offline Handling
- Custom Offline Pages
- Platform-Specific Features
- iOS Safari
- Android Chrome
- Desktop Browsers
- Testing PWA Features
- 1. Chrome DevTools
- 2. PWA Checklist
- 3. Testing Installation
- 4. Testing Offline
- Deployment Considerations
- HTTPS Requirement
- Service Worker Scope
- CDN and Caching
- Integration with Existing Features
- Firebase Notifications
- GraphQL Subscriptions
- Authentication
- Troubleshooting
- Service Worker Not Registering
- Install Prompt Not Showing
- Offline Functionality Not Working
- Notifications Not Working
- Best Practices
- 1. Progressive Enhancement
- 2. User Communication
- 3. Graceful Degradation
- 4. Performance Optimization
- Advanced Usage
- Custom Service Worker
- Background Sync
- Push Notification Customization
- API Reference
- `usePWA()` Hook
- PWA Utility Functions
- Development Mode
- Development vs Production Behavior
- Enabling PWA in Development
- Development Utilities
- Development Cache Management
- Service Worker Development Behavior
- Troubleshooting Development Issues
- Configuration
- Best Practices for Development
- Migration from Previous Versions
- Learn More
- Development Mode
- Development vs Production Behavior
- Enabling PWA in Development
- Development Utilities
- Development Cache Management
- Service Worker Development Behavior
- Troubleshooting Development Issues
- Configuration
- Best Practices for Development
- Migration from Previous Versions
- Technologies Used
- Detailed Documentation
- 🚀 Quick Start
- ⚙️ CLI Commands
- 🔧 CLI Extensibility in Child Projects
- `subdomain` 🌐
- `ask` 🤖
- Overview
- Core Components
- 1. `<QueriesManager />`
- 2. `<QueriesRenderer />`
- 3. `<CytoNodeRenderer />`
- 4. `<CytoEdgeRenderer />`
- 5. `RowParser()`
- Comprehensive Usage Example
- Summary
- Overview
- DB Scheduler Plan (One‑off Events Integration)
- Architecture
- Database Schema
- System Components
- Getting Started
- 1. Database Setup
- 2. Event Triggers Configuration
- 3. Sync Event Triggers
- Usage
- Creating a Schedule
- Querying Schedules and Events
- Updating and Deleting Schedules
- Cron Expression Guide
- Basic Patterns
- Cron Format
- Advanced Examples
- Event Lifecycle
- Event States
- Event Flow
- Custom Event Handlers
- Creating Custom Event Processors
- Using Custom Handlers in Cron Processor
- Real-time Subscriptions
- Subscribe to Schedule Changes
- Subscribe to Event Updates
- Error Handling and Debugging
- Common Issues and Solutions
- Debug Mode
- Monitoring Schedules
- Best Practices
- 1. Schedule Design
- 2. Event Processing
- 3. Database Management
- 4. Testing
- API Reference
- Schedule Functions
- Performance Considerations
- Scaling Schedules
- Memory Management
- Security Considerations
- Access Control
- Data Protection
- Migration Guide
- From Manual Scheduling
- Database Migration
- Related Documentation
- Support
- Purpose
- Core Features
- Certificate Management
- Wildcard SSL Support
- DNS Integration
- Idempotent Operations
- Prerequisites and Configuration
- System Requirements
- Configuration via hasyx.config.json (recommended)
- Manual Environment Configuration (not recommended)
- Environment Variables Usage
- Usage
- Basic Individual Certificate Usage
- Wildcard Certificate Usage
- Environment-Based Configuration
- Advanced Usage with DNS Waiting
- Configuration Options
- SSLConfig Interface
- WildcardCertificateInfo Interface
- Environment Variables
- Core Methods
- Certificate Information
- Certificate Operations
- Idempotent Operations
- DNS and Renewal Operations
- Helper Methods
- Integration with Other Modules
- With CloudFlare DNS
- With Nginx
- Certificate Information Structure
- CertificateInfo Interface
- DNSPropagationResult Interface
- Error Handling
- Common Error Scenarios
- Validation Checks
- Best Practices
- 1. Use Define/Undefine for Idempotency
- 2. Always Wait for DNS Propagation
- 3. Monitor Certificate Expiration
- 4. Environment Configuration
- Security Considerations
- Certificate Storage
- Email Security
- DNS Security
- Troubleshooting
- Common Issues
- Purpose
- CLI Command 🌐
- CLI Subcommands
- CLI Environment Requirements
- Core Features
- Integrated Workflow
- Wildcard SSL Optimization
- Compatibility & Migration
- Safety and Reliability
- Error Handling
- Prerequisites and Configuration
- Configuration via hasyx.config.json
- Manual Environment Configuration
- Environment Variables Usage
- Usage
- Basic Usage
- Environment-Based Configuration
- Advanced Usage - Wildcard SSL Benefits
- Configuration Options
- SubdomainConfig Interface
- SubdomainManagerConfig Interface
- Environment Variables
- Core Methods
- Subdomain Operations
- Workflow Details
- Complete Subdomain Creation Process
- Error Handling and Cleanup
- Integration Examples
- With Express.js Application
- Multi-Service Deployment
- SubdomainStatus Structure
- Error Handling
- Common Error Scenarios
- Configuration Validation
- Best Practices
- 1. Use Environment Configuration
- 2. Always Use Define/Undefine
- 3. Check Status Before Operations
- 4. Monitor SSL Expiration
- Troubleshooting
- Common Issues
- Конфигурация
- Хранение конфигурации
- Реализованные методы адаптера
- 1. `initiatePayment`
- 2. `handleWebhook`
- 3. `getPaymentStatus`
- 4. `createSubscription`
- 5. `cancelSubscription`
- 6. `addPaymentMethod`
- Вспомогательные/внутренние методы
- Структуры данных TBank (используемые адаптером)
- Полный список методов для поддержки сценариев
- 📊 Текущий Статус Реализации
- ✅ Что Полностью Реализовано
- 🔄 Что Работает в Автоматическом Режиме
- 🎯 Готово к Тестированию
- 📋 План Тестирования
- 🚀 Готовность к Продакшену
- 📈 Метрики для Мониторинга
- 🎉 Заключение
- 🔒 Безопасность API Эндпоинтов
- ✅ Completed Features
- 1. Database Schema
- 2. Automatic Billing System
- 3. API Endpoints
- 4. UI Components
- 🔄 Architecture Change: Computed vs Stored Dates
- Previous Approach (Stored Dates)
- **NEW Approach (Computed Fields)**
- Benefits of Computed Approach
- PostgreSQL Functions Created
- 🧪 Testing Status
- Manual Testing Required
- Test Commands Updated
- 📋 Implementation Checklist
- 🚀 Ready for Production
- Next Steps
- 🎯 Полная Система Готова к Тестированию
- 📋 Пошаговый План Тестирования
- Этап 1: Подготовка Окружения
- Этап 2: Настройка Провайдера
- Этап 3: Создание Тестового Плана
- Этап 4: Добавление Метода Оплаты
- Этап 5: Создание Подписки
- Этап 6: Мониторинг Автоматических Списаний
- Этап 7: Тестирование Обработки Ошибок
- 🔍 Команды для Диагностики
- Общий Статус Системы
- Debug Логи по Категориям
- Детальная Информация о Подписке
- 📊 Ожидаемые Результаты
- После Создания Подписки
- После Первого Автоматического Списания
- При Ошибке Списания
- После Исчерпания Retry
- 🚨 Возможные Проблемы и Решения
- Cron Событие Не Срабатывает
- Методы Оплаты Не Становятся Recurrent Ready
- Автоматические Списания Не Работают
- ✅ Критерии Успешного Тестирования
- Features
- Architecture
- Основные компоненты
- Схема работы
- Quick Start
- 1. Environment Setup (via configurator)
- 2. Basic Integration in route.ts
- 3. Testing
- API Reference
- Instance Management
- Advanced Usage
- Custom Ask Options
- Manual AskHasyx Creation with Custom Handlers
- Error Handling
- Automatic Error Handling
- Custom Error Handling
- Performance & Optimization
- Instance Lifecycle
- Message Buffering
- Rate Limiting
- Monitoring & Debugging
- Statistics
- Debug Logging
- Health Check
- Examples
- Simple Math Bot
- Code Generation Bot
- Features
- Setup
- Implementation Details
- Core Components
- Notification System Integration
- Usage Examples
- Simple Echo Bot
- Command Handler
- Future Enhancements
- Implementation Roadmap
- Resources
- Архитектура
- OAuth провайдеры:
- Credentials провайдеры:
- Telegram WebApp Integration
- Компоненты
- Настройка
- Безопасность
- Функционал WebApp
- Тестирование
- Развертывание
- Отладка
- SDK Dependencies
- Заключение
- Overview
- Features
- Automatic Webhook Setup
- Security Features
- Usage
- CLI Commands
- Configuration via hasyx.config.json
- Environment Variables
- Webhook Endpoint
- Technical Implementation
- URL Processing
- API Call
- Error Handling
- Testing
- Integration
- Security Notes
- Troubleshooting
- Common Issues
- Debug Information
- 🎯 Overview
- 🏗️ Architecture
- Components:
- 🔧 Setup Instructions
- 1. Enable in Your Project
- 2. Configure Environment Variables
- 3. GitHub Repository Secrets
- 4. Telegram Bot Setup
- 📋 Configuration Options
- GITHUB_TELEGRAM_BOT Modes:
- Target Workflows:
- 🔄 How It Works
- Workflow Sequence:
- Message Content:
- 🧪 Testing
- Test Mode:
- Local Testing:
- 📊 API Integrations
- GitHub API:
- OpenRouter AI API:
- Telegram Bot API:
- 🛠️ Customization
- Message Templates:
- Workflow Configuration:
- 🔍 Troubleshooting
- Common Issues:
- 🔗 Related Documentation
- 🤝 Contributing
- Table of Contents
- Installation
- Basic Usage
- Configuration
- Default Configuration
- API Reference
- Constructor
- Lifecycle Methods
- Command Execution
- Input Methods
- Terminal Control
- State Methods
- Information Methods
- Factory Functions
- Shell Terminals
- Interactive Environments
- System Terminals
- Remote Terminals
- Event Handling
- Event Emitter Interface
- Event Handler Options
- Session Management
- Command History
- Session Information
- Output Management
- Error Handling
- Common Error Scenarios
- Global Cleanup
- Best Practices
- Resource Management
- Error Handling
- Performance
- Examples
- Basic Command Execution
- Interactive Shell Session
- Development Environment Setup
- File Operations
- Process Management
- Testing
- Test Categories
- Test Design Principles
- Dependencies
- Platform Support
- Security Considerations
- Contributing
- License
- Base URL
- Available Endpoints
- Init
- GetState
- Confirm
- Cancel
- AddCard
- GetCardList
- RemoveCard
- Charge
- Authentication and Security
- Token Generation
- Response Format
- Resources
- Note
- Тестирование
- 1. Промаркировать тесты, требующие запущенного приложения
- 2. Применить jest-skip во всех тестах проекта
- 3. Ручное тестирование VTB интеграции
- 4. Тестирование API endpoints
- 5. Реализация системы бенчмаркинга и мониторинга
- Инвайты / JWT
- Features
- Installation
- Basic Usage
- 1. Create Individual Query Hooks
- 2. Create Multiple Queries at Once
- 3. Utility Hooks for Common Types
- API Reference
- Utility Hooks
- Setter Functions
- Direct Value Setting
- Functional Updates
- URL Behavior
- Parameter Serialization
- URL Examples
- Empty Values
- Real-World Example
- Best Practices
- 1. Choose Meaningful Parameter Names
- 2. Provide Sensible Defaults
- 3. Use TypeScript for Complex Objects
- 4. Keep URLs Clean
- 5. Group Related Queries
- Integration with Next.js
- Performance Considerations
- Troubleshooting
- Common Issues
- Debug Tips
- Migration from Other State Management
- From useState
- From Zustand
- From Redux
- Хранение конфигурации
- Реализованные методы
- Статусы
- URL
- Безопасность
- Подготовка
- Разовый платёж
- Привязка карты
- Подписка
- Рекуррент
- Диагностика
- ⚠️ КРИТИЧЕСКИ ВАЖНО: Системные требования
- Обязательная установка wstunnel binary
- Обзор
- Архитектура
- Компоненты
- 1. API Endpoint
- 2. Основная логика
- 3. Утилиты
- Переменные окружения
- Использование
- Программный API
- HTTP API
- Тестовый клиент
- Безопасность
- Admin-only Access
- Vercel Protection
- Изоляция процессов
- Тестирование
- Запуск тестов
- Структура тестов
- Условное выполнение
- Требования системы
- Обязательные зависимости
- Проверка зависимостей
- Примеры интеграции
- Express.js приложение
- Next.js API Route
- Troubleshooting
- Частые проблемы
- Логирование
- Производительность
- Лимиты
- Мониторинг
- Changelog
- v1.0.0 (2025-01-XX)
i18n checklist for browser TSX components
- Требования к ресурсу продавца
- Доступные интерфейсы
- Интерфейс REST
- Введение
- Аутентификация продавца
- Запросы
- Особенности тестирования запросов REST в браузере
- Интерфейс WSDL (SOAP)
- Введение
- Координаты подключения
- платёжного шлюза
- для мерчанта
- Содержание
- История изменений
- 01.09.
- 23.09.
- 20.12.
- 26 .01.
- История изменений
- 10.03.
- 20.06.
- 04.07.
- 15 .03.
- 29.03.202 4
- 2. Введение
- 3. Определения и термины
- 4.1 Общие принципы работы API
- 4.2 Требования к Интернет-сайту мерчанта
- 4. Описание API
- 4.3 Подключение к API
- 4.4 Безопасность использования API
- 4.5 Доступные валюты для операций
- 4.6 Типы операций
- 4.7 Типы оплат
- 4.8 Статусы ордера
- —
- —
- —
- 4.9 Статусы транзакций для типа оплаты SBP
- 4.10 Статусы транзакций для типа оплаты CARD (Одностадийный платёж)
- —
- —
- 4.11 Статусы транзакций для типа оплаты CARD (Двухстадийный платёж)
- —
- 4.12 Операции с ордерами
- 4.12.1 POST v 1 /orders
- 4.12.3 POST v 1 /orders/preauth
- 4.12.4 POST v 1 /orders/complete/{orderId}
- 4.12.5 POST /orders/{orderId}/cancel
- 4.12.6 Создание ордера (заказа) с CoF
- 4.13 Операции с возвратами
- 4.13.1 POST v 1 /refunds
- 4.13.2 GET v 1 /refunds/{refundId}
- 4.14 Уведомления (callback) от Платежного шлюза
- 4.15 Типы отправляемых уведомлений (callback) от Платежного шлюза
- 4.15.1 PaymentResponse Содержание
- 4.16 Интеграция с тестовой средой Платежного шлюза
- 4.16.1 Настройки для подключения к тестовой среде (Песочница)
- 4.16.2 Отправка запросов к API Платежного шлюза (Песочница)
- 4.17 Тестирование API
- 4.17.1 Тестовые кейсы
- GET /
- 4.18 Интеграция с PRODUCTION средой Платежного шлюза
- 4.18.1 Настройки для подключения к PRODUCTION среде Платежного шлюза
- 4.17.2 Реквизиты тестовой банковской карты
- 4.18.2 Отправка запросов к API Платежного шлюза (PRODUCTION)
- 5.1 Общее описание функциональности фискализация в соответствии с 54-ФЗ
- 5.2 Создание ордера с товарной корзиной
- 5 Фискализация в соответствии с 54-ФЗ
- 5. 3 Создание возврата с товарной корзиной
- 5.4 Операции с фискальными чеками
- 5.4.1 GET /receipts/{orderId}/status
- Приложение 1. Описание объекта ошибки Платежного шлюза, возвращаемого
- Платежного шлюза, возвращаемого через API
- Приложение 2. Расшифровка кодов ответов по ошибкам от Платежного шлюза
- 10100001 500 INCORRECT_JEXL_PARAMETERS_
- EXCEPTION

hasyx

Telegram WebApp Integration

Secure authentication and native Telegram WebApp features

Loading Telegram WebApp...

Detecting Telegram environment...

Environment Info

In Telegram:No

Theme:light

Auth Status:loading

How to Use

For Development:

• Open this app in a regular browser to see the "Not in Telegram" state
• The app automatically detects the Telegram WebApp environment
• Mock data is used for testing outside of Telegram

For Production:

• Create a Telegram bot using @BotFather
• Set the Web App URL to your deployed application
• Configure TELEGRAM_LOGIN_BOT_TOKEN in environment variables
• Users can access the app through the bot's menu button

Authentication Flow:

• User opens the WebApp from Telegram
• initData is automatically validated on the server
• User account is created/linked in the database
• NextAuth session is established with Hasura claims