appwrite-utils-cli 1.9.6 → 1.11.0

package/.appwrite/collections/Users.yaml

@@ -1,149 +0,0 @@
-# yaml-language-server: $schema=../.yaml_schemas/collection.schema.json
-# Collection Definition: Users
-name: Users
-id: 01JYDBQTB5W8SCBAYB654CCADQ
-documentSecurity: false
-enabled: true
-permissions:
-  - permission: read
-    target: any
-  - permission: create
-    target: users
-  - permission: update
-    target: users
-  - permission: delete
-    target: users
-
-attributes:
-  # Core Identity
-  - key: name
-    type: string
-    size: 100
-    required: true
-    description: "User's full name"
-
-  - key: email
-    type: email
-    required: true
-    description: "User's email address for authentication"
-
-  - key: username
-    type: string
-    size: 50
-    required: false
-    description: "Unique username handle"
-
-  # Profile Information
-  - key: avatar
-    type: string
-    size: 255
-    required: false
-    description: "User avatar file ID stored in Appwrite storage"
-
-  - key: phone
-    type: string
-    size: 20
-    required: false
-    description: "User's phone number"
-
-  - key: bio
-    type: string
-    size: 500
-    required: false
-    description: "User biography or description"
-
-  - key: dateOfBirth
-    type: datetime
-    required: false
-    description: "User's date of birth"
-
-  - key: location
-    type: string
-    size: 100
-    required: false
-    description: "User's location or city"
-
-  # User Management
-  - key: role
-    type: enum
-    elements: ["admin", "user", "moderator", "editor"]
-    required: true
-    default: "user"
-    description: "User's role in the system"
-
-  - key: isActive
-    type: boolean
-    required: true
-    default: true
-    description: "Whether the user account is active"
-
-  - key: isVerified
-    type: boolean
-    required: true
-    default: false
-    description: "Whether the user's email is verified"
-
-  # Statistics
-  - key: profileViews
-    type: integer
-    required: true
-    default: 0
-    min: 0
-    description: "Number of times user profile has been viewed"
-
-  - key: lastLoginAt
-    type: datetime
-    required: false
-    description: "Timestamp of user's last login"
-
-  # Social Links
-  - key: socialLinks
-    type: string
-    size: 1000
-    required: false
-    description: "JSON string of social media links"
-
-  # Preferences
-  - key: preferences
-    type: string
-    size: 2000
-    required: false
-    description: "JSON string of user preferences and settings"
-
-indexes:
-  # Search indexes
-  - key: name_search
-    type: fulltext
-    attributes:
-      - name
-
-  - key: bio_search
-    type: fulltext
-    attributes:
-      - bio
-
-  # Unique constraints
-  - key: email_unique
-    type: unique
-    attributes:
-      - email
-
-  - key: username_unique
-    type: unique
-    attributes:
-      - username
-
-  # Query optimization
-  - key: role_active
-    type: key
-    attributes:
-      - role
-      - isActive
-
-  - key: verified_active
-    type: key
-    attributes:
-      - isVerified
-      - isActive
-
-importDefs: []

package/.appwrite/config.yaml

@@ -1,109 +0,0 @@
-# yaml-language-server: $schema=./.yaml_schemas/appwrite-config.schema.json
-appwrite:
-  endpoint: https://appwrite.blackleafdigital.com/v1
-  project: 65f31b9f540542961b39
-  key: >-
-    standard_ed867273aaee1398af3598a649500249b0402402106eb426a50b9903c81925ffe25c2d876897021fc9521faad6efad58e849dd79f42f610279d6eaa70a5104ecce97a7a421647ef06407364958e0952978d3b3a7a3c8ae3bb0b7c6872b9e071b2cd0fee077598db19c2fe9678a3c762e18a6c6272c8a37a0b4204184119903d4
-logging:
-  enabled: false
-  level: info
-  console: false
-  logDirectory: ./logs
-backups:
-  enabled: true
-  interval: 3600
-  retention: 30
-  cleanup: true
-data:
-  enableMockData: false
-  documentBucketId: documents
-  usersCollectionName: Users
-  importDirectory: importData
-schemas:
-  outputDirectory: schemas
-  yamlSchemaDirectory: .yaml_schemas
-migrations:
-  enabled: true
-databases:
-  - id: main
-    name: Main Database
-    collections:
-      - Users
-      - Posts
-      - Categories
-buckets:
-  - id: documents
-    name: Documents
-    permissions:
-      - permission: read
-        target: any
-      - permission: create
-        target: users
-      - permission: update
-        target: users
-      - permission: delete
-        target: users
-    fileSecurity: false
-    enabled: true
-    maximumFileSize: 30000000
-    allowedFileExtensions: []
-    compression: gzip
-    encryption: true
-    antivirus: true
-  - id: images
-    name: Images & Media
-    permissions:
-      - permission: read
-        target: any
-      - permission: create
-        target: users
-    fileSecurity: false
-    enabled: true
-    maximumFileSize: 10000000
-    allowedFileExtensions:
-      - jpg
-      - jpeg
-      - png
-      - gif
-      - webp
-      - svg
-    compression: gzip
-    encryption: false
-    antivirus: true
-  - id: avatars
-    name: User Avatars
-    permissions:
-      - permission: read
-        target: any
-      - permission: create
-        target: users
-      - permission: update
-        target: users
-      - permission: delete
-        target: users
-    fileSecurity: false
-    enabled: true
-    maximumFileSize: 5000000
-    allowedFileExtensions:
-      - jpg
-      - jpeg
-      - png
-      - webp
-    compression: gzip
-    encryption: false
-    antivirus: true
-functions:
-  - id: 01JYENQDVSN3TVH1MVCBW0C2Y3
-    name: TestCountDocs
-    runtime: node-21.0
-    execute:
-      - any
-    events: []
-    schedule: ''
-    timeout: 15
-    enabled: true
-    logging: true
-    entrypoint: src/main.ts
-    commands: npm install && npm run build
-    scopes: []
-    specification: s-1vcpu-512mb

package/.appwrite/import/README.md

@@ -1,148 +0,0 @@
-# Import Configurations
-
-This directory contains YAML-based import configurations that demonstrate the powerful import capabilities of Appwrite Utils CLI 1.0.0.
-
-## Available Import Configurations
-
-### 1. Users Import (`users-import.yaml`)
-- **Purpose**: Import user data with avatar file downloads
-- **Features**:
-  - Downloads avatar images from picsum.photos URLs
-  - Creates user accounts in Appwrite Auth
-  - Validates email addresses and phone numbers
-  - Handles user deduplication based on email
-  - Converts social links and preferences JSON
-- **Data Source**: `importData/users.json` (12 sample users)
-
-### 2. Categories Import (`categories-import.yaml`)
-- **Purpose**: Import hierarchical category structure
-- **Features**:
-  - Downloads cover images from URLs
-  - Handles parent-child relationships
-  - Supports category hierarchy up to 5 levels
-  - SEO metadata handling
-- **Data Source**: `importData/categories.json` (10 categories with hierarchy)
-
-### 3. Posts Import (`posts-import.yaml`)
-- **Purpose**: Import blog posts with relationships and media
-- **Features**:
-  - Downloads featured images and gallery images
-  - Links posts to authors (Users collection)
-  - Links posts to categories (Categories collection)
-  - Handles arrays (tags, gallery)
-  - Rich content with HTML support
-  - SEO metadata and social sharing images
-- **Data Source**: `importData/posts.json` (10 blog posts)
-
-## File Handling Features
-
-All import configurations demonstrate advanced file handling:
-
-- **URL Downloads**: Automatically downloads images from picsum.photos
-- **File Naming**: Uses template patterns like `{user_id}_avatar`
-- **Multiple Files**: Supports gallery arrays with multiple images
-- **File Validation**: Handles missing or invalid URLs gracefully
-- **Storage Integration**: Uploads to appropriate Appwrite storage buckets
-
-## Usage
-
-### Run Individual Imports
-```bash
-# Import users with avatars
-npx appwrite-utils-cli appwrite-migrate --import --collectionIds Users
-
-# Import categories with hierarchy
-npx appwrite-utils-cli appwrite-migrate --import --collectionIds Categories
-
-# Import posts with relationships
-npx appwrite-utils-cli appwrite-migrate --import --collectionIds Posts
-```
-
-### Run All Imports
-```bash
-# Import all collections in order
-npx appwrite-utils-cli appwrite-migrate --import --dbIds main
-```
-
-## Import Order
-
-For best results, import in this order due to relationships:
-
-1. **Users** (no dependencies)
-2. **Categories** (self-referential relationships)
-3. **Posts** (depends on Users and Categories)
-
-## Configuration Highlights
-
-### Rate Limiting
-- **Users**: 25 items per batch (avatar downloads)
-- **Categories**: 50 items per batch (cover images)
-- **Posts**: 20 items per batch (multiple images per post)
-
-### Validation
-- Email validation for users
-- URL validation for file downloads
-- Required field validation
-- Length constraints for text fields
-
-### Relationships
-- **Posts → Users**: Author relationship via userId
-- **Posts → Categories**: Category relationship via categoryId
-- **Categories → Categories**: Parent-child hierarchy
-
-### File Downloads
-- **User avatars**: 500x500 images from picsum.photos
-- **Category covers**: 800x400 images from picsum.photos
-- **Post images**: Various sizes (1200x600, 800x400, etc.)
-- **Social images**: 1200x630 for social media sharing
-
-## Testing
-
-### Dry Run
-Test configurations without actual import:
-```bash
-npx appwrite-utils-cli appwrite-migrate --import --dryRun
-```
-
-### Validation Only
-Validate data without importing:
-```bash
-npx appwrite-utils-cli appwrite-migrate --writeData
-```
-
-## Customization
-
-These configurations serve as examples. You can:
-
-1. **Modify data sources**: Update file paths in YAML configs
-2. **Add/remove fields**: Modify attribute mappings
-3. **Change validation rules**: Add or remove validation constraints
-4. **Adjust batch sizes**: Optimize for your server capacity
-5. **Add custom converters**: Extend data transformation logic
-
-## File Structure
-
-```
-.appwrite/
-├── collections/           # YAML collection definitions
-│   ├── Users.yaml
-│   ├── Posts.yaml
-│   └── Categories.yaml
-├── importData/           # Source data files
-│   ├── users.json
-│   ├── posts.json
-│   └── categories.json
-├── import/               # Import configurations
-│   ├── users-import.yaml
-│   ├── posts-import.yaml
-│   └── categories-import.yaml
-└── config.yaml          # Main project configuration
-```
-
-## Support
-
-For questions about the import system:
-- Check the main README.md for CLI usage
-- Review YAML schema files in `.yaml_schemas/`
-- See example configurations in this directory
-- Test with `--dryRun` flag before actual import

package/.appwrite/import/categories-import.yaml

@@ -1,129 +0,0 @@
-# yaml-language-server: $schema=../.yaml_schemas/import-config.schema.json
-# Categories Import Configuration with Hierarchy Support
-
-source:
-  file: "importData/categories.json"
-  basePath: "RECORDS"
-  type: "json"
-
-target:
-  collection: "Categories"
-  type: "create"
-  primaryKey: "category_id"
-  createUsers: false
-
-mapping:
-  attributes:
-    # Core Fields
-    - oldKey: "category_id"
-      targetKey: "categoryId"
-      converters: ["anyToString"]
-      validation:
-        - rule: "required"
-          params: ["{categoryId}"]
-
-    - oldKey: "name"
-      targetKey: "name"
-      converters: ["anyToString", "stringTrim"]
-      validation:
-        - rule: "required"
-          params: ["{name}"]
-        - rule: "minLength"
-          params: ["{name}", "2"]
-
-    - oldKey: "slug"
-      targetKey: "slug"
-      converters: ["anyToString", "stringToLowerCase", "stringTrim"]
-
-    - oldKey: "description"
-      targetKey: "description"
-      converters: ["anyToString", "stringTrim"]
-      validation:
-        - rule: "maxLength"
-          params: ["{description}", "500"]
-
-    # Hierarchy
-    - oldKey: "parent_id"
-      targetKey: "parentId"
-      converters: ["anyToString"]
-
-    - oldKey: "level"
-      targetKey: "level"
-      converters: ["anyToNumber"]
-      validation:
-        - rule: "numeric"
-          params: ["{level}"]
-        - rule: "positive"
-          params: ["{level}"]
-
-    - oldKey: "sort_order"
-      targetKey: "sortOrder"
-      converters: ["anyToNumber"]
-
-    # Visual & Branding
-    - oldKey: "color_code"
-      targetKey: "colorCode"
-      converters: ["anyToString"]
-
-    - oldKey: "icon"
-      targetKey: "icon"
-      converters: ["anyToString"]
-
-    # Cover Image with URL Download
-    - oldKey: "cover_image_url"
-      targetKey: "coverImage"
-      fileData:
-        path: "{cover_image_url}"
-        name: "{category_id}_cover"
-      afterImport:
-        - action: "createFileAndUpdateField"
-          params: ["{dbId}", "{collId}", "{docId}", "coverImage", "{bucketId}", "{filePath}", "{fileName}"]
-
-    # Status
-    - oldKey: "is_active"
-      targetKey: "isActive"
-      converters: ["anyToBoolean"]
-
-    - oldKey: "is_featured"
-      targetKey: "isFeatured"
-      converters: ["anyToBoolean"]
-
-    # Statistics
-    - oldKey: "post_count"
-      targetKey: "postCount"
-      converters: ["anyToNumber"]
-
-    - oldKey: "total_post_count"
-      targetKey: "totalPostCount"
-      converters: ["anyToNumber"]
-
-    # SEO
-    - oldKey: "meta_title"
-      targetKey: "metaTitle"
-      converters: ["anyToString", "stringTrim"]
-      validation:
-        - rule: "maxLength"
-          params: ["{metaTitle}", "60"]
-
-    - oldKey: "meta_description"
-      targetKey: "metaDescription"
-      converters: ["anyToString", "stringTrim"]
-      validation:
-        - rule: "maxLength"
-          params: ["{metaDescription}", "160"]
-
-    - oldKey: "guidelines"
-      targetKey: "guidelines"
-      converters: ["anyToString", "stringTrim"]
-
-  relationships:
-    # Parent-Child Relationship Resolution
-    - sourceField: "parent_id"
-      targetField: "parentId"
-      targetCollection: "Categories"
-
-options:
-  batchSize: 50
-  skipValidation: false
-  dryRun: false
-  continueOnError: true