library.dr-conversion 0.3.0 → 0.3.2

package/README.md

@@ -5,7 +5,7 @@
 [![npm version](https://badge.fury.io/js/library.dr-conversion.svg)](https://www.npmjs.com/package/library.dr-conversion)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-**Library.DR-Conversion** (v0.2.9) is a TypeScript library that provides a unified, platform-agnostic interface for building chat bots that work across multiple platforms like Discord, Root, and potentially others. Write your bot logic once, and deploy it anywhere!
+**Library.DR-Conversion** (v0.3.2) is a TypeScript library that provides a unified, platform-agnostic interface for building chat bots that work across multiple platforms like Discord, Root, and potentially others. Write your bot logic once, and deploy it anywhere!
 
 ## ✨ Features
 

package/cli.js

@@ -49,6 +49,53 @@ function detectPlatform() {
   }
 }
 
+// Validate a root manifest object against minimal Root requirements
+function validateManifestObject(manifest) {
+  const errors = [];
+  if (!manifest || typeof manifest !== 'object') {
+    errors.push('Manifest must be a JSON object');
+    return { valid: false, errors };
+  }
+
+  if (!manifest.id || typeof manifest.id !== 'string') {
+    errors.push('Missing or invalid "id" (string)');
+  }
+
+  if (!manifest.version || typeof manifest.version !== 'string') {
+    errors.push('Missing or invalid "version" (string)');
+  }
+
+  if (!manifest.package || typeof manifest.package !== 'object') {
+    errors.push('Missing "package" object');
+  } else {
+    if (manifest.package.server) {
+      const server = manifest.package.server;
+      if (!server.launch || typeof server.launch !== 'string') {
+        errors.push('package.server.launch is required and must be a string');
+      }
+      if (!Array.isArray(server.deploy) || server.deploy.length === 0) {
+        errors.push('package.server.deploy must be a non-empty array');
+      }
+      if (!Array.isArray(server.node_modules) || server.node_modules.length === 0) {
+        errors.push('package.server.node_modules must be a non-empty array');
+      }
+    }
+
+    if (manifest.package.client) {
+      const client = manifest.package.client;
+      // accept either entry or deploy
+      if (!client.entry && (!Array.isArray(client.deploy) || client.deploy.length === 0)) {
+        errors.push('package.client.entry or package.client.deploy is required');
+      }
+      if (client.assets && !Array.isArray(client.assets)) {
+        errors.push('package.client.assets must be an array if provided');
+      }
+    }
+  }
+
+  return { valid: errors.length === 0, errors };
+}
+
 program
   .name('library.dr-conversion')
   .description('CLI tools for Library.DR-Conversion v0.2.9')
@@ -279,6 +326,62 @@ npx @rootsdk/cli publish
       fs.writeFileSync(path.join(projectDir, 'MANIFEST.md'), manifestReadme);
     }
     
+    // Create root-app-manifest.json for Root Apps (client-side)
+    if (options.platform === 'root-app') {
+      const appManifest = {
+        id: generateUUID(),
+        version: '1.0.0',
+        name: options.name,
+        description: `${options.name} - Root App`,
+        author: '',
+        homepage: '',
+        package: {
+          client: {
+            entry: 'dist/index.html',
+            assets: ['dist'],
+            node_modules: ['node_modules']
+          }
+        },
+        settings: {
+          ui: []
+        },
+        permissions: {
+          channel: {
+            CreateMessage: true,
+            ReadMessage: true
+          }
+        }
+      };
+
+      fs.writeFileSync(
+        path.join(projectDir, 'root-manifest.json'),
+        JSON.stringify(appManifest, null, 2)
+      );
+
+      const appManifestReadme = `# Root App Manifest
+
+This project includes a generated root-manifest.json to help document your app.
+
+This manifest follows the Root App manifest overview and provides the basic fields used by the Root platform:
+- 'id': Unique UUID for the app
+- 'version': Semver version
+- 'package.client.entry': The client entry HTML for the app
+- 'package.client.assets': Client assets to include in the upload
+- 'permissions': Channel-level permissions used by the app
+
+Notes:
+- Update 'version' following semantic versioning when you make changes.
+- Review permissions and remove any that aren't needed.
+- Configure UI settings in the 'settings.ui' array (see Root docs for details):
+  https://docs.rootapp.com/docs/app-docs/configure/manifest-overview/
+
+Deployment:
+Build your app and follow the Root platform instructions to upload or register it.
+`;
+
+      fs.writeFileSync(path.join(projectDir, 'MANIFEST.md'), appManifestReadme);
+    }
+    
     console.log(`✅ Created ${options.name}`);
     console.log(`\n📝 Next steps:`);
     console.log(`  cd ${options.name}`);
@@ -324,6 +427,43 @@ program
     console.log('✅ Configuration is valid');
   });
 
+program
+  .command('validate-manifest')
+  .description('Validate root-manifest.json in the current folder')
+  .option('-f, --file <path>', 'Manifest file path', 'root-manifest.json')
+  .action((options) => {
+    const file = options.file || 'root-manifest.json';
+    if (!fs.existsSync(file)) {
+      console.error(`❌ Manifest not found: ${file}`);
+      process.exit(1);
+    }
+
+    let raw;
+    try {
+      raw = fs.readFileSync(file, 'utf8');
+    } catch (err) {
+      console.error('❌ Failed to read manifest:', err.message);
+      process.exit(1);
+    }
+
+    let manifest;
+    try {
+      manifest = JSON.parse(raw);
+    } catch (err) {
+      console.error('❌ Manifest is not valid JSON:', err.message);
+      process.exit(1);
+    }
+
+    const result = validateManifestObject(manifest);
+    if (!result.valid) {
+      console.error('❌ Manifest validation failed:');
+      for (const e of result.errors) console.error(' -', e);
+      process.exit(1);
+    }
+
+    console.log('✅ Manifest is valid');
+  });
+
 program
   .command('generate-manifest')
   .description('Generate a manifest file for Root Bots or Root Apps (auto-detects platform)')
@@ -341,16 +481,15 @@ program
     }
     
     const isRootBot = platform === 'root';
-    const manifestFile = isRootBot ? 'root-manifest.json' : 'root-app-manifest.json';
+    const manifestFile = 'root-manifest.json';
     
     console.log(`\n🔍 Detected platform: ${isRootBot ? 'Root Bot (server-side)' : 'Root App (client-side)'}`);
     
     // Check if manifest already exists
     if (fs.existsSync(manifestFile)) {
-      console.log(`⚠️  ${manifestFile} already exists in this directory.`);
-      if (!options.interactive) {
-        console.log('Use --interactive to configure a new one anyway.');
-        return;
+      console.log(`⚠️  ${manifestFile} already exists — it will be overwritten.`);
+      if (options.interactive) {
+        console.log('Interactive mode will update fields and overwrite the manifest.');
       }
     }
     
@@ -385,6 +524,16 @@ program
         description: '',
         author: '',
         homepage: '',
+        package: {
+          client: {
+            entry: 'dist/index.html',
+            assets: ['dist'],
+            node_modules: ['node_modules']
+          }
+        },
+        settings: {
+          ui: []
+        },
         permissions: {
           channel: {}
         }
@@ -483,13 +632,21 @@ program
       rl.close();
     }
     
-    // Write manifest file
+    // Write manifest file (overwrite if exists)
     fs.writeFileSync(
       manifestFile,
       JSON.stringify(manifest, null, 2)
     );
-    
-    console.log(`\n✅ Generated ${manifestFile} successfully!\n`);
+
+    // Validate generated manifest
+    const validation = validateManifestObject(manifest);
+    if (!validation.valid) {
+      console.error('\n❌ Generated manifest failed validation:');
+      for (const e of validation.errors) console.error(' -', e);
+      process.exit(1);
+    }
+
+    console.log(`\n✅ Generated and validated ${manifestFile} successfully!\n`);
     console.log('📋 Manifest Details:');
     console.log(`   Platform: ${isRootBot ? 'Root Bot (server-side)' : 'Root App (client-side)'}`);
     console.log(`   ID: ${manifest.id}`);
@@ -519,6 +676,45 @@ program
     console.log('');
   });
 
+program
+  .command('publish')
+  .description('Validate and publish the current root-manifest.json using @rootsdk/cli')
+  .option('-f, --file <path>', 'Manifest file to publish', 'root-manifest.json')
+  .option('--no-validate', 'Skip manifest validation step')
+  .action((options) => {
+    const file = options.file || 'root-manifest.json';
+    if (!fs.existsSync(file)) {
+      console.error(`❌ Manifest not found: ${file}`);
+      process.exit(1);
+    }
+
+    if (options.validate !== false) {
+      let manifest;
+      try {
+        manifest = JSON.parse(fs.readFileSync(file, 'utf8'));
+      } catch (err) {
+        console.error('❌ Failed to parse manifest:', err.message);
+        process.exit(1);
+      }
+
+      const result = validateManifestObject(manifest);
+      if (!result.valid) {
+        console.error('❌ Manifest validation failed:');
+        for (const e of result.errors) console.error(' -', e);
+        process.exit(1);
+      }
+      console.log('✅ Manifest validation passed');
+    }
+
+    try {
+      console.log('🔁 Running publish via @rootsdk/cli...');
+      execSync('npx @rootsdk/cli publish', { stdio: 'inherit' });
+    } catch (err) {
+      console.error('❌ Publish failed:', err.message);
+      process.exit(1);
+    }
+  });
+
 program
   .command('setup')
   .description('Interactive setup wizard to install only the dependencies you need')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "library.dr-conversion",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Unified interface for building multi-platform chat bots (Discord, Root, and more)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",