appwrite-utils-cli 1.11.0 → 1.12.0

package/dist/utils/setupFiles.js

@@ -0,0 +1,1190 @@
+import { mkdirSync, writeFileSync, existsSync } from "node:fs";
+import path from "node:path";
+import { findAppwriteConfig } from "./loadConfigs.js";
+import { loadYamlConfig, findYamlConfig, generateYamlConfigTemplate } from "appwrite-utils-helpers";
+import { fetchServerVersion, isVersionAtLeast } from 'appwrite-utils-helpers';
+import { ID } from "node-appwrite";
+import { ulid } from "ulidx";
+import { loadAppwriteProjectConfig, findAppwriteProjectConfig, getProjectDirectoryName, isTablesDBProject } from 'appwrite-utils-helpers';
+import { hasSessionAuth, getSessionAuth } from 'appwrite-utils-helpers';
+import { MessageFormatter } from "appwrite-utils-helpers";
+// Example base configuration using types from appwrite-utils
+const baseConfig = {
+    appwriteEndpoint: "https://cloud.appwrite.io/v1",
+    appwriteProject: "YOUR_PROJECT_ID",
+    appwriteKey: "YOUR_API_KEY",
+    appwriteClient: null,
+    apiMode: "auto", // Enable dual API support - auto-detect TablesDB vs legacy
+    authMethod: "auto", // Default to auto-detect authentication method
+    logging: {
+        enabled: false,
+        level: "info",
+        console: false,
+    },
+    enableBackups: true,
+    backupInterval: 3600,
+    backupRetention: 30,
+    enableBackupCleanup: true,
+    enableMockData: false,
+    documentBucketId: "documents",
+    usersCollectionName: "Members",
+    databases: [
+        {
+            $id: "main",
+            name: "Main",
+            bucket: {
+                $id: "main_bucket",
+                name: "Main Bucket",
+                enabled: true,
+                maximumFileSize: 30000000,
+                allowedFileExtensions: [],
+                encryption: true,
+                antivirus: true,
+            },
+        },
+        {
+            $id: "staging",
+            name: "Staging",
+            bucket: {
+                $id: "staging_bucket",
+                name: "Staging Bucket",
+                enabled: true,
+                maximumFileSize: 30000000,
+                allowedFileExtensions: [],
+                encryption: true,
+                antivirus: true,
+            },
+        },
+        {
+            $id: "dev",
+            name: "Development",
+            bucket: {
+                $id: "dev_bucket",
+                name: "Development Bucket",
+                enabled: true,
+                maximumFileSize: 30000000,
+                allowedFileExtensions: [],
+                encryption: true,
+                antivirus: true,
+            },
+        },
+    ],
+    buckets: [
+        {
+            $id: "global_bucket",
+            name: "Global Bucket",
+            enabled: true,
+            maximumFileSize: 30000000,
+            allowedFileExtensions: [],
+            encryption: true,
+            antivirus: true,
+        },
+    ],
+};
+const collectionsConfig = [
+    {
+        name: "ExampleCollection",
+        content: `import type { CollectionCreate } from "appwrite-utils";
+    
+const ExampleCollection: Partial<CollectionCreate> = {
+  name: 'ExampleCollection',
+  $id: '${ulid()}',
+  documentSecurity: false,
+  enabled: true,
+  $permissions: [
+    { permission: 'read', target: 'any' },
+    { permission: 'create', target: 'users' },
+    { permission: 'update', target: 'users' },
+    { permission: 'delete', target: 'users' }
+  ],
+  attributes: [
+    { key: 'alterEgoName', type: 'string', size: 255, required: false },
+    // Add more attributes here
+  ],
+  indexes: [
+    { key: 'alterEgoName_search', type: 'fulltext', attributes: ['alterEgoName'] }
+  ],
+  importDefs: [
+    // Define import definitions here
+  ]
+};
+
+export default ExampleCollection;`,
+    },
+    // Add more collections here
+];
+// Define our YAML files
+// Define our YAML files
+const configFileExample = `d`;
+export const customDefinitionsFile = `import type { ConverterFunctions, ValidationRules, AfterImportActions } from "appwrite-utils";
+
+export const customConverterFunctions: ConverterFunctions = {
+  // Add your custom converter functions here
+}
+export const customValidationRules: ValidationRules = {
+  // Add your custom validation rules here
+}
+export const customAfterImportActions: AfterImportActions = {
+  // Add your custom after import actions here
+}`;
+export const createEmptyCollection = (collectionName) => {
+    const currentDir = process.cwd();
+    // Check for YAML config first (preferred)
+    const yamlConfigPath = findYamlConfig(currentDir);
+    const tsConfigPath = findAppwriteConfig(currentDir);
+    let configDir;
+    let isYamlProject = false;
+    if (yamlConfigPath) {
+        configDir = path.dirname(yamlConfigPath);
+        isYamlProject = true;
+    }
+    else if (tsConfigPath) {
+        configDir = path.dirname(tsConfigPath);
+        isYamlProject = false;
+    }
+    else {
+        // No config found - assume .appwrite directory and use YAML as default
+        configDir = path.join(currentDir, ".appwrite");
+        isYamlProject = true;
+        // Create .appwrite directory if it doesn't exist
+        if (!existsSync(configDir)) {
+            mkdirSync(configDir, { recursive: true });
+        }
+    }
+    const collectionsFolder = path.join(configDir, "collections");
+    if (!existsSync(collectionsFolder)) {
+        mkdirSync(collectionsFolder, { recursive: true });
+    }
+    if (isYamlProject) {
+        // Create YAML collection
+        const yamlCollection = `# yaml-language-server: $schema=../.yaml_schemas/collection.schema.json
+# Collection Definition: ${collectionName}
+name: ${collectionName}
+id: ${ulid()}
+documentSecurity: false
+enabled: true
+permissions:
+  - permission: read
+    target: any
+  - permission: create
+    target: users
+  - permission: update
+    target: users
+  - permission: delete
+    target: users
+attributes:
+  # Add your attributes here
+  # Example:
+  # - key: title
+  #   type: string
+  #   size: 255
+  #   required: true
+  #   description: "The title of the item"
+indexes:
+  # Add your indexes here
+  # Example:
+  # - key: title_search
+  #   type: fulltext
+  #   attributes:
+  #     - title
+importDefs: []
+`;
+        const collectionFilePath = path.join(collectionsFolder, `${collectionName}.yaml`);
+        writeFileSync(collectionFilePath, yamlCollection);
+        MessageFormatter.success(`Created YAML collection: ${collectionFilePath}`, { prefix: "Setup" });
+    }
+    else {
+        // Create TypeScript collection
+        const emptyCollection = `import type { CollectionCreate } from "appwrite-utils";
+
+const ${collectionName}: Partial<CollectionCreate> = {
+  $id: '${ulid()}',
+  documentSecurity: false,
+  enabled: true,
+  name: '${collectionName}',
+  $permissions: [
+    { permission: 'read', target: 'any' },
+    { permission: 'create', target: 'users' },
+    { permission: 'update', target: 'users' },
+    { permission: 'delete', target: 'users' }
+  ],
+  attributes: [
+    // Add more attributes here
+  ],
+  indexes: [
+    // Add more indexes here
+  ],
+};
+
+export default ${collectionName};`;
+        const collectionFilePath = path.join(collectionsFolder, `${collectionName}.ts`);
+        writeFileSync(collectionFilePath, emptyCollection);
+        MessageFormatter.success(`Created TypeScript collection: ${collectionFilePath}`, { prefix: "Setup" });
+    }
+};
+export const generateYamlConfig = (currentDir, useAppwriteDir = true) => {
+    const basePath = currentDir || process.cwd();
+    const configDir = useAppwriteDir ? path.join(basePath, ".appwrite") : basePath;
+    if (!existsSync(configDir)) {
+        mkdirSync(configDir, { recursive: true });
+    }
+    const configPath = path.join(configDir, "config.yaml");
+    generateYamlConfigTemplate(configPath);
+    MessageFormatter.success(`Generated YAML config template at: ${configPath}`, { prefix: "Setup" });
+    MessageFormatter.info("Please update the configuration with your Appwrite project details.", { prefix: "Setup" });
+    return configPath;
+};
+export const setupDirsFiles = async (example = false, currentDir, useYaml = true) => {
+    const basePath = currentDir || process.cwd();
+    // Create .appwrite folder directly in project root
+    const appwriteFolder = path.join(basePath, ".appwrite");
+    const appwriteConfigFile = path.join(appwriteFolder, "appwriteConfig.ts");
+    const appwriteCustomDefsFile = path.join(appwriteFolder, "customDefinitions.ts");
+    const appwriteSchemaFolder = path.join(appwriteFolder, "schemas");
+    const appwriteYamlSchemaFolder = path.join(appwriteFolder, ".yaml_schemas");
+    const appwriteDataFolder = path.join(appwriteFolder, "importData");
+    // Enhanced version detection with multiple sources
+    let useTables = false;
+    let detectionSource = "default";
+    try {
+        // Priority 1: Check for existing appwrite.json project config
+        const projectConfigPath = findAppwriteProjectConfig(basePath);
+        if (projectConfigPath) {
+            const projectConfig = loadAppwriteProjectConfig(projectConfigPath);
+            if (projectConfig) {
+                useTables = isTablesDBProject(projectConfig);
+                detectionSource = "appwrite.json";
+                MessageFormatter.info(`Detected ${useTables ? 'TablesDB' : 'Collections'} project from ${projectConfigPath}`, { prefix: "Setup" });
+            }
+        }
+        // Priority 2: Try reading existing YAML config for version detection
+        if (!useTables && detectionSource === "default") {
+            const yamlPath = findYamlConfig(basePath);
+            if (yamlPath) {
+                const cfg = await loadYamlConfig(yamlPath);
+                if (cfg) {
+                    // Try session auth first, then API key for version detection
+                    let endpoint = cfg.appwriteEndpoint;
+                    let projectId = cfg.appwriteProject;
+                    if (hasSessionAuth(endpoint, projectId)) {
+                        MessageFormatter.info("Using session authentication for version detection", { prefix: "Setup" });
+                    }
+                    const ver = await fetchServerVersion(endpoint);
+                    if (isVersionAtLeast(ver || undefined, '1.8.0')) {
+                        useTables = true;
+                        detectionSource = "server-version";
+                        MessageFormatter.info(`Detected TablesDB support (Appwrite ${ver})`, { prefix: "Setup" });
+                    }
+                    else {
+                        MessageFormatter.info(`Using Collections API (Appwrite ${ver || 'unknown'})`, { prefix: "Setup" });
+                    }
+                }
+            }
+        }
+    }
+    catch (error) {
+        MessageFormatter.warning(`Version detection failed, defaulting to Collections API: ${error instanceof Error ? error.message : String(error)}`, { prefix: "Setup" });
+    }
+    const targetFolderName = useTables ? "tables" : "collections";
+    const collectionsFolder = path.join(appwriteFolder, targetFolderName);
+    // Create directory structure
+    if (!existsSync(appwriteFolder)) {
+        mkdirSync(appwriteFolder, { recursive: true });
+    }
+    if (!existsSync(collectionsFolder)) {
+        mkdirSync(collectionsFolder, { recursive: true });
+    }
+    // Handle configuration file creation - YAML is now default
+    if (useYaml) {
+        // Generate YAML config in .appwrite directory
+        const configPath = path.join(appwriteFolder, "config.yaml");
+        generateYamlConfigTemplate(configPath);
+    }
+    else if (!existsSync(appwriteConfigFile)) {
+        if (example) {
+            writeFileSync(appwriteConfigFile, configFileExample);
+        }
+        else {
+            const baseConfigContent = `import { type AppwriteConfig } from "appwrite-utils";
+
+const appwriteConfig: AppwriteConfig = ${JSON.stringify(baseConfig, null, 2)};
+
+export default appwriteConfig;
+`;
+            writeFileSync(appwriteConfigFile, baseConfigContent);
+        }
+    }
+    // Create TypeScript files for each collection only if not using YAML
+    if (!useYaml) {
+        collectionsConfig.forEach((collection) => {
+            const collectionFilePath = path.join(collectionsFolder, `${collection.name}.ts`);
+            writeFileSync(collectionFilePath, collection.content);
+        });
+    }
+    // Create YAML collection/table example if using YAML config
+    if (useYaml) {
+        const terminology = useTables
+            ? {
+                container: "table",
+                fields: "columns",
+                security: "rowSecurity",
+                schemaRef: "table.schema.json",
+                containerName: "Table",
+                fieldName: "Column"
+            }
+            : {
+                container: "collection",
+                fields: "attributes",
+                security: "documentSecurity",
+                schemaRef: "collection.schema.json",
+                containerName: "Collection",
+                fieldName: "Attribute"
+            };
+        const yamlExample = `# yaml-language-server: $schema=../.yaml_schemas/${terminology.schemaRef}
+# Example ${terminology.containerName} Definition
+name: Example${terminology.containerName}
+id: example_${terminology.container}_${Date.now()}
+${terminology.security}: false
+enabled: true
+permissions:
+  - permission: read
+    target: any
+  - permission: create
+    target: users
+  - permission: update
+    target: users
+  - permission: delete
+    target: users
+${terminology.fields}:
+  - key: title
+    type: string
+    size: 255
+    required: true
+    description: "The title of the item"
+  - key: description
+    type: string
+    size: 1000
+    required: false
+    description: "A longer description"
+  - key: isActive
+    type: boolean
+    required: false
+    default: true${useTables ? `
+  - key: uniqueCode
+    type: string
+    size: 50
+    required: false
+    unique: true
+    description: "Unique identifier code (TablesDB feature)"` : ''}
+indexes:
+  - key: title_search
+    type: fulltext
+    attributes:
+      - title
+importDefs: []
+`;
+        const yamlExamplePath = path.join(collectionsFolder, `Example${terminology.containerName}.yaml`);
+        writeFileSync(yamlExamplePath, yamlExample);
+        MessageFormatter.info(`Created example ${terminology.container} definition with ${terminology.fields} terminology`, { prefix: "Setup" });
+        // Create JSON schema for collection/table definitions
+        const containerJsonSchema = useTables ? {
+            "$schema": "https://json-schema.org/draft/2020-12/schema",
+            "$id": "https://appwrite-utils.dev/schemas/table.schema.json",
+            "title": "Appwrite Table Definition",
+            "description": "Schema for defining Appwrite tables in YAML (TablesDB API)",
+            "type": "object",
+            "properties": {
+                "name": {
+                    "type": "string",
+                    "description": "The name of the table"
+                },
+                "id": {
+                    "type": "string",
+                    "description": "The ID of the table (optional, auto-generated if not provided)",
+                    "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,35}$"
+                },
+                "rowSecurity": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "Enable row-level permissions"
+                },
+                "enabled": {
+                    "type": "boolean",
+                    "default": true,
+                    "description": "Whether the table is enabled"
+                },
+                "permissions": {
+                    "type": "array",
+                    "description": "Table-level permissions",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "permission": {
+                                "type": "string",
+                                "enum": ["read", "create", "update", "delete"],
+                                "description": "The permission type"
+                            },
+                            "target": {
+                                "type": "string",
+                                "description": "Permission target (e.g., 'any', 'users', 'users/verified', 'label:admin')"
+                            }
+                        },
+                        "required": ["permission", "target"],
+                        "additionalProperties": false
+                    }
+                },
+                "columns": {
+                    "type": "array",
+                    "description": "Table columns (fields)",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "key": {
+                                "type": "string",
+                                "description": "Column name",
+                                "pattern": "^[a-zA-Z][a-zA-Z0-9]*$"
+                            },
+                            "type": {
+                                "type": "string",
+                                "enum": ["string", "integer", "double", "boolean", "datetime", "email", "ip", "url", "enum", "relationship"],
+                                "description": "Column data type"
+                            },
+                            "size": {
+                                "type": "number",
+                                "description": "Maximum size for string columns",
+                                "minimum": 1,
+                                "maximum": 1073741824
+                            },
+                            "required": {
+                                "type": "boolean",
+                                "default": false,
+                                "description": "Whether the column is required"
+                            },
+                            "array": {
+                                "type": "boolean",
+                                "default": false,
+                                "description": "Whether the column is an array"
+                            },
+                            "unique": {
+                                "type": "boolean",
+                                "default": false,
+                                "description": "Whether the column values must be unique (TablesDB feature)"
+                            },
+                            "default": {
+                                "description": "Default value for the column"
+                            },
+                            "description": {
+                                "type": "string",
+                                "description": "Column description"
+                            },
+                            "encrypt": {
+                                "type": "boolean",
+                                "description": "Whether the column should be encrypted"
+                            },
+                            "format": {
+                                "type": "string",
+                                "description": "Format for string columns"
+                            },
+                            "min": {
+                                "type": "number",
+                                "description": "Minimum value for numeric columns"
+                            },
+                            "max": {
+                                "type": "number",
+                                "description": "Maximum value for numeric columns"
+                            },
+                            "elements": {
+                                "type": "array",
+                                "items": {
+                                    "type": "string"
+                                },
+                                "description": "Allowed values for enum columns"
+                            },
+                            "relatedCollection": {
+                                "type": "string",
+                                "description": "Related table name for relationship columns"
+                            },
+                            "relationType": {
+                                "type": "string",
+                                "enum": ["oneToOne", "oneToMany", "manyToOne", "manyToMany"],
+                                "description": "Type of relationship"
+                            },
+                            "twoWay": {
+                                "type": "boolean",
+                                "description": "Whether the relationship is bidirectional"
+                            },
+                            "twoWayKey": {
+                                "type": "string",
+                                "description": "Key name for the reverse relationship"
+                            },
+                            "onDelete": {
+                                "type": "string",
+                                "enum": ["cascade", "restrict", "setNull"],
+                                "description": "Action to take when related row is deleted"
+                            },
+                            "side": {
+                                "type": "string",
+                                "enum": ["parent", "child"],
+                                "description": "Side of the relationship"
+                            }
+                        },
+                        "required": ["key", "type"],
+                        "additionalProperties": false,
+                        "allOf": [
+                            {
+                                "if": {
+                                    "properties": { "type": { "const": "enum" } }
+                                },
+                                "then": {
+                                    "required": ["elements"]
+                                }
+                            },
+                            {
+                                "if": {
+                                    "properties": { "type": { "const": "relationship" } }
+                                },
+                                "then": {
+                                    "required": ["relatedCollection", "relationType"]
+                                }
+                            }
+                        ]
+                    }
+                },
+                "indexes": {
+                    "type": "array",
+                    "description": "Database indexes for the table",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "key": {
+                                "type": "string",
+                                "description": "Index name"
+                            },
+                            "type": {
+                                "type": "string",
+                                "enum": ["key", "fulltext", "unique"],
+                                "description": "Index type"
+                            },
+                            "attributes": {
+                                "type": "array",
+                                "items": {
+                                    "type": "string"
+                                },
+                                "description": "Columns to index",
+                                "minItems": 1
+                            },
+                            "orders": {
+                                "type": "array",
+                                "items": {
+                                    "type": "string",
+                                    "enum": ["ASC", "DESC"]
+                                },
+                                "description": "Sort order for each column"
+                            }
+                        },
+                        "required": ["key", "type", "attributes"],
+                        "additionalProperties": false
+                    }
+                },
+                "importDefs": {
+                    "type": "array",
+                    "description": "Import definitions for data migration",
+                    "default": []
+                }
+            },
+            "required": ["name"],
+            "additionalProperties": false
+        } : {
+            "$schema": "https://json-schema.org/draft/2020-12/schema",
+            "$id": "https://appwrite-utils.dev/schemas/collection.schema.json",
+            "title": "Appwrite Collection Definition",
+            "description": "Schema for defining Appwrite collections in YAML",
+            "type": "object",
+            "properties": {
+                "name": {
+                    "type": "string",
+                    "description": "The name of the collection"
+                },
+                "id": {
+                    "type": "string",
+                    "description": "The ID of the collection (optional, auto-generated if not provided)",
+                    "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,35}$"
+                },
+                "documentSecurity": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "Enable document-level permissions"
+                },
+                "enabled": {
+                    "type": "boolean",
+                    "default": true,
+                    "description": "Whether the collection is enabled"
+                },
+                "permissions": {
+                    "type": "array",
+                    "description": "Collection-level permissions",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "permission": {
+                                "type": "string",
+                                "enum": ["read", "create", "update", "delete"],
+                                "description": "The permission type"
+                            },
+                            "target": {
+                                "type": "string",
+                                "description": "Permission target (e.g., 'any', 'users', 'users/verified', 'label:admin')"
+                            }
+                        },
+                        "required": ["permission", "target"],
+                        "additionalProperties": false
+                    }
+                },
+                "attributes": {
+                    "type": "array",
+                    "description": "Collection attributes (fields)",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "key": {
+                                "type": "string",
+                                "description": "Attribute name",
+                                "pattern": "^[a-zA-Z][a-zA-Z0-9]*$"
+                            },
+                            "type": {
+                                "type": "string",
+                                "enum": ["string", "integer", "double", "boolean", "datetime", "email", "ip", "url", "enum", "relationship"],
+                                "description": "Attribute data type"
+                            },
+                            "size": {
+                                "type": "number",
+                                "description": "Maximum size for string attributes",
+                                "minimum": 1,
+                                "maximum": 1073741824
+                            },
+                            "required": {
+                                "type": "boolean",
+                                "default": false,
+                                "description": "Whether the attribute is required"
+                            },
+                            "array": {
+                                "type": "boolean",
+                                "default": false,
+                                "description": "Whether the attribute is an array"
+                            },
+                            "default": {
+                                "description": "Default value for the attribute"
+                            },
+                            "description": {
+                                "type": "string",
+                                "description": "Attribute description"
+                            },
+                            "encrypt": {
+                                "type": "boolean",
+                                "description": "Whether the attribute should be encrypted"
+                            },
+                            "format": {
+                                "type": "string",
+                                "description": "Format for string attributes"
+                            },
+                            "min": {
+                                "type": "number",
+                                "description": "Minimum value for numeric attributes"
+                            },
+                            "max": {
+                                "type": "number",
+                                "description": "Maximum value for numeric attributes"
+                            },
+                            "elements": {
+                                "type": "array",
+                                "items": {
+                                    "type": "string"
+                                },
+                                "description": "Allowed values for enum attributes"
+                            },
+                            "relatedCollection": {
+                                "type": "string",
+                                "description": "Related collection name for relationship attributes"
+                            },
+                            "relationType": {
+                                "type": "string",
+                                "enum": ["oneToOne", "oneToMany", "manyToOne", "manyToMany"],
+                                "description": "Type of relationship"
+                            },
+                            "twoWay": {
+                                "type": "boolean",
+                                "description": "Whether the relationship is bidirectional"
+                            },
+                            "twoWayKey": {
+                                "type": "string",
+                                "description": "Key name for the reverse relationship"
+                            },
+                            "onDelete": {
+                                "type": "string",
+                                "enum": ["cascade", "restrict", "setNull"],
+                                "description": "Action to take when related document is deleted"
+                            },
+                            "side": {
+                                "type": "string",
+                                "enum": ["parent", "child"],
+                                "description": "Side of the relationship"
+                            }
+                        },
+                        "required": ["key", "type"],
+                        "additionalProperties": false,
+                        "allOf": [
+                            {
+                                "if": {
+                                    "properties": { "type": { "const": "enum" } }
+                                },
+                                "then": {
+                                    "required": ["elements"]
+                                }
+                            },
+                            {
+                                "if": {
+                                    "properties": { "type": { "const": "relationship" } }
+                                },
+                                "then": {
+                                    "required": ["relatedCollection", "relationType"]
+                                }
+                            }
+                        ]
+                    }
+                },
+                "indexes": {
+                    "type": "array",
+                    "description": "Database indexes for the collection",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "key": {
+                                "type": "string",
+                                "description": "Index name"
+                            },
+                            "type": {
+                                "type": "string",
+                                "enum": ["key", "fulltext", "unique"],
+                                "description": "Index type"
+                            },
+                            "attributes": {
+                                "type": "array",
+                                "items": {
+                                    "type": "string"
+                                },
+                                "description": "Attributes to index",
+                                "minItems": 1
+                            },
+                            "orders": {
+                                "type": "array",
+                                "items": {
+                                    "type": "string",
+                                    "enum": ["ASC", "DESC"]
+                                },
+                                "description": "Sort order for each attribute"
+                            }
+                        },
+                        "required": ["key", "type", "attributes"],
+                        "additionalProperties": false
+                    }
+                },
+                "importDefs": {
+                    "type": "array",
+                    "description": "Import definitions for data migration",
+                    "default": []
+                }
+            },
+            "required": ["name"],
+            "additionalProperties": false
+        };
+        // Ensure YAML schemas directory exists before writing schema
+        if (!existsSync(appwriteYamlSchemaFolder)) {
+            mkdirSync(appwriteYamlSchemaFolder, { recursive: true });
+        }
+        const schemaFileName = useTables ? "table.schema.json" : "collection.schema.json";
+        const containerSchemaPath = path.join(appwriteYamlSchemaFolder, schemaFileName);
+        writeFileSync(containerSchemaPath, JSON.stringify(containerJsonSchema, null, 2));
+        // Create JSON schema for appwriteConfig.yaml
+        const configJsonSchema = {
+            "$schema": "https://json-schema.org/draft/2020-12/schema",
+            "$id": "https://appwrite-utils.dev/schemas/appwrite-config.schema.json",
+            "title": "Appwrite Configuration",
+            "description": "Schema for Appwrite project configuration in YAML",
+            "type": "object",
+            "properties": {
+                "appwrite": {
+                    "type": "object",
+                    "description": "Appwrite connection settings",
+                    "properties": {
+                        "endpoint": {
+                            "type": "string",
+                            "default": "https://cloud.appwrite.io/v1",
+                            "description": "Appwrite server endpoint URL"
+                        },
+                        "project": {
+                            "type": "string",
+                            "description": "Appwrite project ID"
+                        },
+                        "key": {
+                            "type": "string",
+                            "description": "Appwrite API key with appropriate permissions"
+                        }
+                    },
+                    "required": ["project", "key"],
+                    "additionalProperties": false
+                },
+                "logging": {
+                    "type": "object",
+                    "description": "Logging configuration",
+                    "properties": {
+                        "enabled": {
+                            "type": "boolean",
+                            "default": false,
+                            "description": "Enable file logging"
+                        },
+                        "level": {
+                            "type": "string",
+                            "enum": ["error", "warn", "info", "debug"],
+                            "default": "info",
+                            "description": "Logging level"
+                        },
+                        "directory": {
+                            "type": "string",
+                            "description": "Custom log directory path (optional)"
+                        },
+                        "console": {
+                            "type": "boolean",
+                            "default": false,
+                            "description": "Enable console logging"
+                        }
+                    },
+                    "additionalProperties": false
+                },
+                "backups": {
+                    "type": "object",
+                    "description": "Backup configuration",
+                    "properties": {
+                        "enabled": {
+                            "type": "boolean",
+                            "default": true,
+                            "description": "Enable automatic backups"
+                        },
+                        "interval": {
+                            "type": "number",
+                            "default": 3600,
+                            "description": "Backup interval in seconds"
+                        },
+                        "retention": {
+                            "type": "number",
+                            "default": 30,
+                            "description": "Backup retention in days"
+                        },
+                        "cleanup": {
+                            "type": "boolean",
+                            "default": true,
+                            "description": "Enable automatic backup cleanup"
+                        }
+                    },
+                    "additionalProperties": false
+                },
+                "data": {
+                    "type": "object",
+                    "description": "Data management settings",
+                    "properties": {
+                        "enableMockData": {
+                            "type": "boolean",
+                            "default": false,
+                            "description": "Enable mock data generation"
+                        },
+                        "documentBucketId": {
+                            "type": "string",
+                            "default": "documents",
+                            "description": "Default bucket ID for document attachments"
+                        },
+                        "usersCollectionName": {
+                            "type": "string",
+                            "default": "Members",
+                            "description": "Name of the users/members collection"
+                        },
+                        "importDirectory": {
+                            "type": "string",
+                            "default": "importData",
+                            "description": "Directory containing import data files"
+                        }
+                    },
+                    "additionalProperties": false
+                },
+                "schemas": {
+                    "type": "object",
+                    "description": "Schema generation settings",
+                    "properties": {
+                        "outputDirectory": {
+                            "type": "string",
+                            "default": "schemas",
+                            "description": "Directory where generated schemas are saved"
+                        },
+                        "yamlSchemaDirectory": {
+                            "type": "string",
+                            "default": ".yaml_schemas",
+                            "description": "Directory containing YAML validation schemas"
+                        }
+                    },
+                    "additionalProperties": false
+                },
+                "migrations": {
+                    "type": "object",
+                    "description": "Migration settings",
+                    "properties": {
+                        "enabled": {
+                            "type": "boolean",
+                            "default": true,
+                            "description": "Enable migration tracking database"
+                        }
+                    },
+                    "additionalProperties": false
+                },
+                "databases": {
+                    "type": "array",
+                    "description": "Database configurations",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "id": {
+                                "type": "string",
+                                "description": "Database ID",
+                                "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,35}$"
+                            },
+                            "name": {
+                                "type": "string",
+                                "description": "Database display name"
+                            },
+                            "bucket": {
+                                "type": "object",
+                                "description": "Associated storage bucket",
+                                "properties": {
+                                    "id": {
+                                        "type": "string",
+                                        "description": "Bucket ID"
+                                    },
+                                    "name": {
+                                        "type": "string",
+                                        "description": "Bucket display name"
+                                    },
+                                    "permissions": {
+                                        "type": "array",
+                                        "items": {
+                                            "type": "string"
+                                        },
+                                        "description": "Bucket permissions"
+                                    },
+                                    "fileSecurity": {
+                                        "type": "boolean",
+                                        "description": "Enable file-level security"
+                                    },
+                                    "enabled": {
+                                        "type": "boolean",
+                                        "default": true,
+                                        "description": "Enable the bucket"
+                                    },
+                                    "maximumFileSize": {
+                                        "type": "number",
+                                        "default": 30000000,
+                                        "description": "Maximum file size in bytes"
+                                    },
+                                    "allowedFileExtensions": {
+                                        "type": "array",
+                                        "items": {
+                                            "type": "string"
+                                        },
+                                        "description": "Allowed file extensions (empty = all allowed)"
+                                    },
+                                    "compression": {
+                                        "type": "string",
+                                        "enum": ["none", "gzip", "zstd"],
+                                        "default": "none",
+                                        "description": "Compression algorithm"
+                                    },
+                                    "encryption": {
+                                        "type": "boolean",
+                                        "default": false,
+                                        "description": "Enable file encryption"
+                                    },
+                                    "antivirus": {
+                                        "type": "boolean",
+                                        "default": false,
+                                        "description": "Enable antivirus scanning"
+                                    }
+                                },
+                                "required": ["id", "name"],
+                                "additionalProperties": false
+                            }
+                        },
+                        "required": ["id", "name"],
+                        "additionalProperties": false
+                    }
+                },
+                "buckets": {
+                    "type": "array",
+                    "description": "Global storage buckets",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "id": {
+                                "type": "string",
+                                "description": "Bucket ID"
+                            },
+                            "name": {
+                                "type": "string",
+                                "description": "Bucket display name"
+                            },
+                            "permissions": {
+                                "type": "array",
+                                "items": {
+                                    "type": "string"
+                                },
+                                "description": "Bucket permissions"
+                            },
+                            "fileSecurity": {
+                                "type": "boolean",
+                                "description": "Enable file-level security"
+                            },
+                            "enabled": {
+                                "type": "boolean",
+                                "default": true,
+                                "description": "Enable the bucket"
+                            },
+                            "maximumFileSize": {
+                                "type": "number",
+                                "default": 30000000,
+                                "description": "Maximum file size in bytes"
+                            },
+                            "allowedFileExtensions": {
+                                "type": "array",
+                                "items": {
+                                    "type": "string"
+                                },
+                                "description": "Allowed file extensions (empty = all allowed)"
+                            },
+                            "compression": {
+                                "type": "string",
+                                "enum": ["none", "gzip", "zstd"],
+                                "default": "none",
+                                "description": "Compression algorithm"
+                            },
+                            "encryption": {
+                                "type": "boolean",
+                                "default": false,
+                                "description": "Enable file encryption"
+                            },
+                            "antivirus": {
+                                "type": "boolean",
+                                "default": false,
+                                "description": "Enable antivirus scanning"
+                            }
+                        },
+                        "required": ["id", "name"],
+                        "additionalProperties": false
+                    }
+                },
+                "functions": {
+                    "type": "array",
+                    "description": "Appwrite Functions",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "id": {
+                                "type": "string",
+                                "description": "Function ID"
+                            },
+                            "name": {
+                                "type": "string",
+                                "description": "Function name"
+                            },
+                            "runtime": {
+                                "type": "string",
+                                "description": "Runtime environment"
+                            },
+                            "execute": {
+                                "type": "array",
+                                "items": {
+                                    "type": "string"
+                                },
+                                "description": "Execution permissions"
+                            },
+                            "events": {
+                                "type": "array",
+                                "items": {
+                                    "type": "string"
+                                },
+                                "description": "Event triggers"
+                            },
+                            "schedule": {
+                                "type": "string",
+                                "description": "Cron schedule"
+                            },
+                            "timeout": {
+                                "type": "number",
+                                "default": 15,
+                                "description": "Execution timeout in seconds"
+                            },
+                            "enabled": {
+                                "type": "boolean",
+                                "default": true,
+                                "description": "Enable the function"
+                            },
+                            "logging": {
+                                "type": "boolean",
+                                "default": true,
+                                "description": "Enable function logging"
+                            },
+                            "entrypoint": {
+                                "type": "string",
+                                "description": "Function entrypoint file"
+                            },
+                            "commands": {
+                                "type": "string",
+                                "description": "Build commands"
+                            }
+                        },
+                        "required": ["id", "name", "runtime"],
+                        "additionalProperties": false
+                    }
+                }
+            },
+            "required": ["appwrite"],
+            "additionalProperties": false
+        };
+        const configSchemaPath = path.join(appwriteYamlSchemaFolder, "appwrite-config.schema.json");
+        writeFileSync(configSchemaPath, JSON.stringify(configJsonSchema, null, 2));
+    }
+    if (!existsSync(appwriteSchemaFolder)) {
+        mkdirSync(appwriteSchemaFolder, { recursive: true });
+    }
+    if (!existsSync(appwriteDataFolder)) {
+        mkdirSync(appwriteDataFolder, { recursive: true });
+    }
+    // Remove the nested .appwrite folder creation since we're using .appwrite as the main folder
+    const configType = useYaml ? "YAML" : "TypeScript";
+    const terminology = useTables ? "tables" : "collections";
+    const containerType = useTables ? "TablesDB" : "Collections";
+    MessageFormatter.success(`Created ${configType} config and setup files/directories in .appwrite/ folder.`, { prefix: "Setup" });
+    MessageFormatter.info(`Project configured for ${containerType} API (${detectionSource} detection)`, { prefix: "Setup" });
+    if (useYaml) {
+        MessageFormatter.info("You can now configure your project in .appwrite/config.yaml", { prefix: "Setup" });
+        MessageFormatter.info(`${useTables ? 'Tables' : 'Collections'} can be defined in .appwrite/${terminology}/ as .ts or .yaml files`, { prefix: "Setup" });
+        MessageFormatter.info("Schemas will be generated in .appwrite/schemas/", { prefix: "Setup" });
+        MessageFormatter.info("Import data can be placed in .appwrite/importData/", { prefix: "Setup" });
+        if (useTables) {
+            MessageFormatter.info("TablesDB features: unique constraints, enhanced performance, row-level security", { prefix: "Setup" });
+        }
+    }
+    else {
+        MessageFormatter.info("You can now configure logging in your .appwrite/appwriteConfig.ts file:", { prefix: "Setup" });
+        MessageFormatter.info("   logging: {", { prefix: "Setup" });
+        MessageFormatter.info("     enabled: true,", { prefix: "Setup" });
+        MessageFormatter.info("     level: 'info',", { prefix: "Setup" });
+        MessageFormatter.info("     console: true,", { prefix: "Setup" });
+        MessageFormatter.info("     logDirectory: './logs'  // optional custom directory", { prefix: "Setup" });
+        MessageFormatter.info("   }", { prefix: "Setup" });
+    }
+};