@rglabs/butterfly 1.0.4 → 1.2.0

package/POC-Generator/examples/tables/example_group/table_examples/example.json

@@ -0,0 +1,394 @@
+{
+  "table_name": "examples",
+  "group": "sample_data",
+  "group_display_name": "Sample Data",
+  "title": "Example Table",
+  "description": "Comprehensive example table demonstrating all supported data types and constraints",
+  "fields": [
+    {
+      "column_name": "id",
+      "name": "ID",
+      "type": "int",
+      "length": 8,
+      "primary_key": true,
+      "auto_increment": true,
+      "description": "Unique identifier"
+    },
+    {
+      "column_name": "uuid",
+      "name": "UUID",
+      "type": "uuid",
+      "nullable": false,
+      "unique": true,
+      "description": "Universally unique identifier"
+    },
+    {
+      "column_name": "name",
+      "name": "Name",
+      "type": "varchar",
+      "length": 255,
+      "nullable": false,
+      "description": "Short text field with max length"
+    },
+    {
+      "column_name": "description",
+      "name": "Description",
+      "type": "text",
+      "nullable": true,
+      "description": "Long text field without length limit"
+    },
+    {
+      "column_name": "email",
+      "name": "Email Address",
+      "type": "varchar",
+      "length": 255,
+      "nullable": false,
+      "unique": true,
+      "description": "Email with unique constraint"
+    },
+    {
+      "column_name": "price",
+      "name": "Price",
+      "type": "decimal",
+      "precision": 15,
+      "scale": 2,
+      "nullable": false,
+      "default": 0,
+      "description": "Decimal with precision and scale"
+    },
+    {
+      "column_name": "quantity",
+      "name": "Quantity",
+      "type": "int",
+      "length": 11,
+      "nullable": false,
+      "default": 0,
+      "description": "Integer with default value"
+    },
+    {
+      "column_name": "rating",
+      "name": "Rating",
+      "type": "float",
+      "nullable": true,
+      "description": "Floating point number"
+    },
+    {
+      "column_name": "is_active",
+      "name": "Is Active",
+      "type": "boolean",
+      "nullable": false,
+      "default": true,
+      "description": "Boolean field"
+    },
+    {
+      "column_name": "is_deleted",
+      "name": "Is Deleted",
+      "type": "tinyint",
+      "length": 1,
+      "nullable": false,
+      "default": 0,
+      "description": "Soft delete flag (tinyint as boolean)"
+    },
+    {
+      "column_name": "status",
+      "name": "Status",
+      "type": "enum",
+      "enum_values": ["draft", "pending", "approved", "rejected", "cancelled"],
+      "nullable": false,
+      "default": "draft",
+      "description": "Enum field with predefined values"
+    },
+    {
+      "column_name": "priority",
+      "name": "Priority Level",
+      "type": "enum",
+      "enum_values": ["low", "medium", "high", "critical"],
+      "nullable": false,
+      "default": "medium",
+      "description": "Priority level enum"
+    },
+    {
+      "column_name": "birth_date",
+      "name": "Birth Date",
+      "type": "date",
+      "nullable": true,
+      "description": "Date only (YYYY-MM-DD)"
+    },
+    {
+      "column_name": "start_time",
+      "name": "Start Time",
+      "type": "time",
+      "nullable": true,
+      "description": "Time only (HH:MM:SS)"
+    },
+    {
+      "column_name": "event_datetime",
+      "name": "Event Date & Time",
+      "type": "datetime",
+      "nullable": true,
+      "description": "Date and time combined"
+    },
+    {
+      "column_name": "metadata",
+      "name": "Metadata",
+      "type": "json",
+      "nullable": true,
+      "description": "JSON object for flexible data storage"
+    },
+    {
+      "column_name": "tags",
+      "name": "Tags",
+      "type": "json",
+      "nullable": true,
+      "default": "[]",
+      "description": "JSON array for storing multiple values"
+    },
+    {
+      "column_name": "settings",
+      "name": "Settings",
+      "type": "jsonb",
+      "nullable": true,
+      "description": "Binary JSON for PostgreSQL (indexed)"
+    },
+    {
+      "column_name": "category_id",
+      "name": "Category",
+      "type": "int",
+      "length": 8,
+      "nullable": false,
+      "foreign_key": {
+        "table": "categories",
+        "column": "id",
+        "on_delete": "CASCADE",
+        "on_update": "CASCADE"
+      },
+      "description": "Foreign key with CASCADE delete"
+    },
+    {
+      "column_name": "parent_id",
+      "name": "Parent Example",
+      "type": "int",
+      "length": 8,
+      "nullable": true,
+      "foreign_key": {
+        "table": "examples",
+        "column": "id",
+        "on_delete": "SET NULL",
+        "on_update": "CASCADE"
+      },
+      "description": "Self-referencing foreign key (nullable)"
+    },
+    {
+      "column_name": "assigned_user_id",
+      "name": "Assigned User",
+      "type": "int",
+      "length": 8,
+      "nullable": true,
+      "foreign_key": {
+        "table": "users",
+        "column": "id",
+        "on_delete": "SET NULL",
+        "on_update": "CASCADE"
+      },
+      "description": "Optional foreign key reference"
+    },
+    {
+      "column_name": "department_code",
+      "name": "Department",
+      "type": "varchar",
+      "length": 10,
+      "nullable": true,
+      "foreign_key": {
+        "table": "departments",
+        "column": "code",
+        "on_delete": "RESTRICT",
+        "on_update": "CASCADE"
+      },
+      "description": "Foreign key to non-id column"
+    },
+    {
+      "column_name": "file_path",
+      "name": "File Path",
+      "type": "varchar",
+      "length": 500,
+      "nullable": true,
+      "description": "File path or URL storage"
+    },
+    {
+      "column_name": "file_size",
+      "name": "File Size",
+      "type": "bigint",
+      "nullable": true,
+      "description": "Large integer for file sizes"
+    },
+    {
+      "column_name": "ip_address",
+      "name": "IP Address",
+      "type": "varchar",
+      "length": 45,
+      "nullable": true,
+      "description": "IPv4 or IPv6 address"
+    },
+    {
+      "column_name": "latitude",
+      "name": "Latitude",
+      "type": "decimal",
+      "precision": 10,
+      "scale": 8,
+      "nullable": true,
+      "description": "Geographic latitude"
+    },
+    {
+      "column_name": "longitude",
+      "name": "Longitude",
+      "type": "decimal",
+      "precision": 11,
+      "scale": 8,
+      "nullable": true,
+      "description": "Geographic longitude"
+    },
+    {
+      "column_name": "sort_order",
+      "name": "Sort Order",
+      "type": "int",
+      "length": 4,
+      "nullable": false,
+      "default": 0,
+      "description": "Display order field"
+    },
+    {
+      "column_name": "version",
+      "name": "Version",
+      "type": "int",
+      "length": 4,
+      "nullable": false,
+      "default": 1,
+      "description": "Optimistic locking version"
+    },
+    {
+      "column_name": "created_by_user_id",
+      "name": "Created By",
+      "type": "int",
+      "length": 8,
+      "nullable": false,
+      "foreign_key": {
+        "table": "users",
+        "column": "id",
+        "on_delete": "RESTRICT",
+        "on_update": "CASCADE"
+      },
+      "description": "Audit: created by user"
+    },
+    {
+      "column_name": "created_at",
+      "name": "Created At",
+      "type": "timestamp",
+      "nullable": false,
+      "default": "CURRENT_TIMESTAMP",
+      "description": "Audit: creation timestamp"
+    },
+    {
+      "column_name": "updated_by_user_id",
+      "name": "Updated By",
+      "type": "int",
+      "length": 8,
+      "nullable": true,
+      "foreign_key": {
+        "table": "users",
+        "column": "id",
+        "on_delete": "SET NULL",
+        "on_update": "CASCADE"
+      },
+      "description": "Audit: last updated by user"
+    },
+    {
+      "column_name": "updated_at",
+      "name": "Updated At",
+      "type": "timestamp",
+      "nullable": true,
+      "on_update": "CURRENT_TIMESTAMP",
+      "description": "Audit: last update timestamp"
+    },
+    {
+      "column_name": "deleted_at",
+      "name": "Deleted At",
+      "type": "timestamp",
+      "nullable": true,
+      "description": "Soft delete timestamp"
+    }
+  ],
+  "indexes": [
+    {
+      "name": "idx_status",
+      "columns": ["status"],
+      "type": "btree"
+    },
+    {
+      "name": "idx_category_status",
+      "columns": ["category_id", "status"],
+      "type": "btree",
+      "description": "Composite index"
+    },
+    {
+      "name": "idx_created_at",
+      "columns": ["created_at"],
+      "type": "btree"
+    },
+    {
+      "name": "idx_name_fulltext",
+      "columns": ["name", "description"],
+      "type": "fulltext",
+      "description": "Full-text search index"
+    },
+    {
+      "name": "idx_location",
+      "columns": ["latitude", "longitude"],
+      "type": "spatial",
+      "description": "Spatial index for geo queries"
+    }
+  ],
+  "unique_constraints": [
+    {
+      "name": "uq_email",
+      "columns": ["email"]
+    },
+    {
+      "name": "uq_category_name",
+      "columns": ["category_id", "name"],
+      "description": "Composite unique constraint"
+    }
+  ],
+  "relationships": [
+    {
+      "type": "many_to_one",
+      "target_table": "categories",
+      "foreign_key": "category_id",
+      "inverse_name": "examples"
+    },
+    {
+      "type": "many_to_one",
+      "target_table": "users",
+      "foreign_key": "assigned_user_id",
+      "inverse_name": "assigned_examples"
+    },
+    {
+      "type": "one_to_many",
+      "target_table": "example_items",
+      "foreign_key": "example_id",
+      "inverse_name": "example"
+    },
+    {
+      "type": "many_to_many",
+      "target_table": "tags",
+      "pivot_table": "example_tags",
+      "foreign_key": "example_id",
+      "related_key": "tag_id"
+    },
+    {
+      "type": "self_referencing",
+      "target_table": "examples",
+      "foreign_key": "parent_id",
+      "description": "Parent-child hierarchy"
+    }
+  ]
+}

package/POC-Generator/mocks/.gitkeep

@@ -0,0 +1,7 @@
+# This file keeps the mocks directory in git
+# Add your source documents here:
+# - Excel files (.xlsx)
+# - Word documents (.docx)
+# - PDF files (.pdf)
+# - MD files (.md)
+# - TXT files (.txt)

package/README.md

@@ -62,6 +62,7 @@ butterfly download -t pages
 butterfly download -t bfy_cronjobs
 butterfly download -t cms_email_templates
 butterfly download -t cms_email_layouts
+butterfly download -t webservices
 
 # Download specific resource by name
 butterfly download -t objects -n users
@@ -167,6 +168,146 @@ butterfly workflow-info --nodes Database
 butterfly workflow-info --details RESTAPI --group Connector
 ```
 
+---
+
+### `butterfly diff`
+
+Compare local resources with remote server and apply changes interactively.
+
+```bash
+# Compare all objects
+butterfly diff -t objects
+
+# Compare specific object
+butterfly diff -t objects -n users
+
+# Compare reports
+butterfly diff -t reports -n my_report
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `-t, --type <type>` | Resource type to compare (objects, reports) |
+| `-n, --name <name>` | Specific resource name to compare |
+| `-o, --output <path>` | Base path (default: `./butterfly-resources`) |
+
+---
+
+### `butterfly record`
+
+Perform CRUD operations on any Butterfly table.
+
+```bash
+# Get a record by ID
+butterfly record get users --id 123
+
+# Get records by column filter
+butterfly record get users --column email --value "john@example.com"
+
+# Wildcard search
+butterfly record get users --column name --value "john*"
+
+# Add a new record
+butterfly record add users --data '{"name": "John", "email": "john@example.com"}'
+
+# Edit a record
+butterfly record edit users --id 123 --data '{"name": "Jane"}'
+
+# Delete a record (with confirmation)
+butterfly record delete users --id 123
+
+# Skip preview and auto-confirm
+butterfly record edit users --id 123 --data '{"status": "active"}' --no-preview -y
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--id <id>` | Record ID |
+| `--column <column>` | Filter column(s) for get |
+| `--value <value>` | Filter value (use `*` for wildcard) |
+| `--columns <cols>` | Select specific columns to return |
+| `--data <json>` | JSON data for the operation |
+| `--file <path>` | Path to JSON file with data |
+| `--db-alias <alias>` | Database alias (default: `default`) |
+| `--no-preview` | Skip preview |
+| `-y, --yes` | Auto-confirm without prompting |
+
+---
+
+### `butterfly code`
+
+Execute Twig code on the server.
+
+```bash
+# Execute inline code
+butterfly code -c "{{ db().table('users').count() }}"
+
+# Execute from file
+butterfly code -f query.bfy
+
+# Get only variables
+butterfly code -c "{% set users = db().table('users').get() %}" --vars
+
+# Get raw output
+butterfly code -c "{{ 'Hello World' }}" --output-only --raw
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `-c, --code <code>` | Twig code to execute (inline) |
+| `-f, --file <path>` | Path to file containing Twig code |
+| `-o, --output <path>` | Save output to file |
+| `--vars` | Output only the vars object |
+| `--output-only` | Output only the output field |
+| `--raw` | Output raw string (no JSON formatting) |
+
+---
+
+### `butterfly layout`
+
+Update object page layout (tab and field ordering).
+
+```bash
+# Update layout from file
+butterfly layout -f layout.json
+
+# Update layout inline
+butterfly layout -d '{"object_id": 123, "tabs": [...]}'
+```
+
+---
+
+### `butterfly translate`
+
+Manage translations for multi-language support.
+
+```bash
+# List languages with translation stats
+butterfly translate languages
+
+# Get untranslated texts for a language
+butterfly translate get-untranslated --lang tr
+
+# Add a single translation
+butterfly translate add --lang tr --source "Welcome" --text "Hoş geldiniz"
+
+# Bulk import from CSV file (tab-delimited)
+butterfly translate bulk --lang tr --file translations.csv
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `--lang <iso_code>` | Language ISO code (e.g., tr, de, en) |
+| `--source <text>` | Source text to translate |
+| `--text <translation>` | Translated text |
+| `-f, --file <path>` | CSV file for bulk operations |
+| `--format <format>` | Output format: json or table |
+| `--limit <count>` | Limit number of results |
+
 ## Directory Structure
 
 After downloading, resources are organized as follows:
@@ -200,7 +341,11 @@ butterfly-resources/
 ├── pages/
 ├── bfy_cronjobs/
 ├── cms_email_templates/
-└── cms_email_layouts/
+├── cms_email_layouts/
+└── webservices/
+    └── [custom_seo]/
+        ├── webservice.json
+        └── queries/
 ```
 
 ## Field Type Code Files

package/butterfly-resources/bfy_ai_tasks/bfy-translations/output_format.json

@@ -0,0 +1 @@
+{"1":"Translated Text"}

package/butterfly-resources/bfy_ai_tasks/bfy-translations/prompt.bfy

@@ -0,0 +1,4 @@
+Translate following texts to {{ params.language }}
+{% for text in params.texts %}
+{{ text.id }}: {{ text.source }}
+{% endfor %}

package/butterfly-resources/bfy_ai_tasks/bfy-translations/task.json

@@ -0,0 +1,21 @@
+{
+  "id": 1,
+  "order_no": 1,
+  "name": "Bfy Translations",
+  "bfy_ai_model_id": 1,
+  "response_type": "json",
+  "system_name": "bfy-translations",
+  "parent_bfy_ai_task_id": 0,
+  "multiple_sub_tasks": null,
+  "is_bfy": 1,
+  "code_language": null,
+  "system_message": null,
+  "has_action": null,
+  "action_preview_code": null,
+  "action_code": null,
+  "include_chat_history": null,
+  "initial_code": null,
+  "task_folder_name": null,
+  "bfy_ai_log_id": null,
+  "bfy_workspace_id": 1
+}

package/butterfly-resources/bfy_ai_tasks/butterfly-business-developer/action_preview_code.bfy

@@ -0,0 +1,74 @@
+{{ tailwind()|raw }}
+{% set tasks = db()
+    .from('bfy_ai_tasks')
+    .keyToValue('system_name')
+%}
+<div class="task-list-container bg-gradient-to-br from-blue-100 via-indigo-50 to-purple-100 rounded-2xl shadow-xl p-8 w-full max-w-4xl mx-auto my-8 border border-indigo-100">
+    <div class="flex items-center justify-between mb-8">
+        <div class="flex items-center">
+            <div class="bg-gradient-to-r from-blue-600 to-indigo-600 p-3 rounded-xl shadow-md mr-4 transform rotate-3">
+                <svg xmlns="http://www.w3.org/2000/svg" class="h-7 w-7 text-white" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2" />
+                </svg>
+            </div>
+            <div>
+                <h2 class="text-2xl font-bold bg-gradient-to-r from-blue-700 to-indigo-700 bg-clip-text text-transparent">Application Ideas</h2>
+                <p class="text-gray-500 text-sm">Select an idea to start building your internal application</p>
+            </div>
+        </div>
+        <div class="hidden sm:block">
+            <span class="inline-flex items-center px-3 py-1 rounded-full text-sm font-medium bg-indigo-100 text-indigo-800">
+                <svg xmlns="http://www.w3.org/2000/svg" class="h-4 w-4 mr-1" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 10V3L4 14h7v7l9-11h-7z" />
+                </svg>
+                Butterfly Builder
+            </span>
+        </div>
+    </div>
+
+    <div class="task-list space-y-5">
+        {% if response.message.suggestions is defined and response.message.suggestions|length > 0 %}
+            {% for suggestion in response.message.suggestions %}
+                <div class="task-item bg-white rounded-xl overflow-hidden shadow-md hover:shadow-xl transition-all duration-300 border-l-4 border-indigo-500 transform hover:-translate-y-1 flex flex-col">
+                    <div class="p-5">
+                        <div class="task-name text-xl font-bold text-gray-800 mb-3 flex items-center">
+                            <span class="w-2 h-2 bg-indigo-500 rounded-full mr-2"></span>
+                            {{ suggestion.title }}
+                        </div>
+                        <div class="task-description text-gray-600 mb-5 line-clamp-2 pl-4 border-l-2 border-gray-100">
+                            {{ suggestion.prompt }}
+                        </div>
+                        <div class="flex justify-between items-center">
+                            <span class="px-3 py-1 bg-gradient-to-r from-indigo-500 to-purple-500 text-white rounded-full text-xs font-medium shadow-sm">
+                                AI Recommended
+                            </span>
+                            <a class="inline-flex items-center px-5 py-2 bg-gradient-to-r from-blue-600 to-indigo-600 text-white rounded-lg hover:from-blue-700 hover:to-indigo-700 transition-colors text-sm font-medium shadow-sm hover:shadow-md focus:ring-2 focus:ring-blue-500 focus:ring-opacity-50 transform hover:scale-105"
+                               href="/admin/bfy_ai_task/trigger?alias=butterfly-developer&description={{ suggestion.prompt }}">
+                                <svg xmlns="http://www.w3.org/2000/svg" class="h-4 w-4 mr-2" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 10V3L4 14h7v7l9-11h-7z" />
+                                </svg>
+                                Build This App
+                            </a>
+                        </div>
+                    </div>
+                </div>
+            {% endfor %}
+        {% else %}
+            <div class="flex flex-col items-center justify-center bg-white rounded-xl p-10 text-gray-500 border border-dashed border-gray-300">
+                <div class="relative w-20 h-20 mb-6">
+                    <div class="absolute inset-0 bg-indigo-100 rounded-full animate-ping opacity-50"></div>
+                    <div class="relative flex items-center justify-center w-full h-full bg-white rounded-full shadow-md">
+                        <svg xmlns="http://www.w3.org/2000/svg" class="h-10 w-10 text-indigo-400" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 6v6m0 0v6m0-6h6m-6 0H6" />
+                        </svg>
+                    </div>
+                </div>
+                <p class="text-xl font-bold text-gray-700 mb-2">No suggestions yet</p>
+                <p class="text-gray-500 text-center max-w-md">Describe your business needs or provide a URL to get personalized application ideas for your company</p>
+                <button class="mt-6 px-6 py-3 bg-gradient-to-r from-indigo-500 to-purple-500 text-white rounded-lg hover:from-indigo-600 hover:to-purple-600 transition-colors text-sm font-medium shadow-md hover:shadow-lg focus:ring-2 focus:outline-none focus:ring-indigo-500 focus:ring-opacity-50 transform hover:scale-105">
+                    Start New Request
+                </button>
+            </div>
+        {% endif %}
+    </div>
+</div>