@cometchat/skills-cli 2.4.1 → 3.0.0

package/dist/utils/error-dictionary.js

@@ -29,35 +29,6 @@ const DICTIONARY = {
     suggestion: "Run `cometchat auth login` again to re-authenticate.",
     retryable: false
   },
-  ERR_NO_INTEGRATION: {
-    humanMessage: "CometChat isn't installed in this project yet.",
-    suggestion: "Run `cometchat apply` first (or restart the wizard from the beginning) to create the base integration, then come back to this step.",
-    retryable: false
-  },
-  ERR_UNSUPPORTED_FRAMEWORK: {
-    humanMessage: "This step isn't available for your framework.",
-    suggestion: "Some features (server-side user management, production auth) need a framework with a built-in server (Next.js, Astro, React Router v7). Skip this step or switch frameworks to enable it.",
-    retryable: false
-  },
-  ERR_ALREADY_APPLIED: {
-    humanMessage: "This is already set up in your project.",
-    suggestion: "Delete the existing files first if you want to re-create them, or skip this step.",
-    retryable: false
-  },
-  ERR_APPLY_UNSAFE_OVERWRITE: {
-    humanMessage: "One or more files already have your code in them.",
-    suggestion: "Retry with --force-overwrite to replace them, or edit the files manually first. Use --placement embed:<path> to write the chat entry file somewhere else entirely.",
-    retryable: true,
-    retryArgs: ["--force-overwrite"],
-    retryArgsLabel: "Overwrite and retry"
-  },
-  ERR_APPLY_ALREADY_APPLIED: {
-    humanMessage: "CometChat is already integrated in this project.",
-    suggestion: "If you want to re-apply (e.g., switching experience), retry with --force.",
-    retryable: true,
-    retryArgs: ["--force"],
-    retryArgsLabel: "Re-apply and override"
-  },
   ERR_APP_CREATION_FAILED_MAX_LIMIT: {
     humanMessage: "You've hit the free-tier app limit on this account.",
     suggestion: "Delete an unused app from app.cometchat.com, then retry. Deleted apps count toward the limit for 30 days on some plans.",
@@ -97,46 +68,6 @@ const DICTIONARY = {
     humanMessage: "The CLI returned an unexpected response.",
     suggestion: "This is likely a CLI bug. Re-run the last step; if it repeats, file an issue with the `--verbose` output.",
     retryable: true
-  },
-  ERR_TOO_LARGE_FILE: {
-    humanMessage: "The file you tried to upload is too big.",
-    suggestion: "Reduce the file size or check your app's upload limits in the dashboard.",
-    retryable: true
-  },
-  ERR_MISSING_CUSTOMIZE_KEY: {
-    humanMessage: "No Claude API key found. Set ANTHROPIC_API_KEY to enable the `customize` command. A CometChat-hosted gateway is coming.",
-    suggestion: "Export ANTHROPIC_API_KEY in your shell (or a .env file) with a key from https://console.anthropic.com/, then re-run the command.",
-    retryable: false
-  },
-  ERR_CUSTOMIZE_NETWORK: {
-    humanMessage: "Couldn't reach the LLM endpoint.",
-    suggestion: "Check your connection and API key.",
-    retryable: true
-  },
-  ERR_CUSTOMIZE_API: {
-    humanMessage: "The LLM API returned an error.",
-    suggestion: "Re-check your API key and try again. If the error persists, the upstream provider may be degraded.",
-    retryable: true
-  },
-  ERR_CUSTOMIZE_UNSAFE_PATH: {
-    humanMessage: "The AI tried to modify a file it shouldn't.",
-    suggestion: "This is a safety check. Re-run with a more specific instruction.",
-    retryable: true
-  },
-  ERR_CUSTOMIZE_PATCH_TOO_LARGE: {
-    humanMessage: "The proposed change is too large to apply automatically.",
-    suggestion: "Break the request into smaller pieces.",
-    retryable: true
-  },
-  ERR_CUSTOMIZE_INVALID_ACTION: {
-    humanMessage: "The AI proposed an inconsistent change (e.g., create-over-existing).",
-    suggestion: "Re-run the command; the model may recover on retry.",
-    retryable: true
-  },
-  ERR_CUSTOMIZE_LOW_CONFIDENCE: {
-    humanMessage: "The AI isn't confident about this change.",
-    suggestion: "Review the plan and diff carefully before applying, or rephrase the instruction with more detail.",
-    retryable: true
   }
 };
 function parseErrorCode(raw) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cometchat/skills-cli",
-  "version": "2.4.1",
-  "description": "CLI for the CometChat skills v3 architecture — auth, provision, detect, apply, verify CometChat integrations in React/Next.js/React-Router/Astro/Expo/React-Native/Angular/Android/iOS/Flutter projects.",
+  "version": "3.0.0",
+  "description": "CLI for CometChat dashboard authentication, app-credential provisioning, and dashboard feature management (extensions + AI).",
   "type": "module",
   "license": "MIT",
   "bin": {
@@ -23,7 +23,7 @@
     "dev": "tsx src/index.ts",
     "test": "node --test --import tsx test/*.test.ts",
     "test:watch": "node --test --watch --import tsx test/*.test.ts",
-    "build": "rm -rf dist && esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js --packages=external && esbuild src/utils/onboarding-options.ts --platform=node --format=esm --outfile=dist/utils/onboarding-options.js && esbuild src/utils/error-dictionary.ts --platform=node --format=esm --outfile=dist/utils/error-dictionary.js && node -e \"require('node:fs').cpSync(require('node:path').resolve('../registry/v6'),require('node:path').resolve('dist/registry/v6'),{recursive:true});require('node:fs').cpSync(require('node:path').resolve('../registry/schemas'),require('node:path').resolve('dist/registry/schemas'),{recursive:true});console.log('  bundled registry → dist/registry/');\"",
+    "build": "rm -rf dist && esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js --packages=external && esbuild src/utils/onboarding-options.ts --platform=node --format=esm --outfile=dist/utils/onboarding-options.js && esbuild src/utils/error-dictionary.ts --platform=node --format=esm --outfile=dist/utils/error-dictionary.js",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm run typecheck && npm test && npm run build"
   },
@@ -42,19 +42,17 @@
   "keywords": [
     "cometchat",
     "chat",
-    "react",
-    "nextjs",
-    "vite",
-    "astro",
-    "react-router",
-    "ai",
-    "agent",
-    "skills",
+    "dashboard",
+    "auth",
+    "provision",
+    "credentials",
+    "features",
+    "extensions",
     "cli"
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/cometchat-team/cometchat-skills.git",
+    "url": "git+https://github.com/cometchat/cometchat-skills.git",
     "directory": "packages/cli"
   }
 }

package/dist/registry/schemas/config.schema.json

@@ -1,119 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://cometchat.com/schemas/config.json",
-  "title": "CometChat Project Config",
-  "description": "Persistent project-level configuration for CometChat integrations. Written by the wizard/CLI, read by skills and commands.",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["version"],
-  "properties": {
-    "$schema": {
-      "type": "string",
-      "description": "JSON Schema URI for editor autocomplete."
-    },
-    "version": {
-      "type": "number",
-      "const": 1,
-      "description": "Schema version. Always 1."
-    },
-    "appId": {
-      "type": "string",
-      "description": "CometChat App ID. Not a secret — safe to commit."
-    },
-    "region": {
-      "type": "string",
-      "enum": ["us", "eu", "in"],
-      "description": "CometChat data region."
-    },
-    "framework": {
-      "type": "string",
-      "enum": ["reactjs", "nextjs", "react-router", "astro"],
-      "description": "Detected or user-overridden framework."
-    },
-    "router": {
-      "type": "string",
-      "enum": ["app", "pages"],
-      "description": "Next.js router variant. Only applicable when framework is nextjs."
-    },
-    "envPrefix": {
-      "type": "string",
-      "enum": ["VITE_", "NEXT_PUBLIC_", "PUBLIC_"],
-      "description": "Environment variable prefix for client-side env vars."
-    },
-    "typescript": {
-      "type": "boolean",
-      "description": "Whether the project uses TypeScript."
-    },
-    "intent": {
-      "type": "string",
-      "enum": ["marketplace", "saas", "social", "messaging", "support", "exploring"],
-      "description": "What the user is building — drives the recommended integration shape."
-    },
-    "experience": {
-      "type": "number",
-      "enum": [1, 2, 3],
-      "description": "CometChat experience level (1 = multi-conversation, 2 = single-thread, 3 = full-messenger)."
-    },
-    "placement": {
-      "type": "string",
-      "enum": ["route", "modal", "drawer", "widget", "embed", "demo"],
-      "description": "Where the chat UI is placed in the app."
-    },
-    "placementPath": {
-      "type": "string",
-      "description": "Route path for the chat page (e.g. \"/messages\")."
-    },
-    "authMode": {
-      "type": "string",
-      "enum": ["authKey", "tokenEndpoint"],
-      "description": "Authentication mode — dev (authKey) or production (tokenEndpoint)."
-    },
-    "tokenEndpointPath": {
-      "type": "string",
-      "description": "Path to the server-side token endpoint (e.g. \"app/api/cometchat-token/route.ts\")."
-    },
-    "theme": {
-      "type": "string",
-      "description": "Theme preset name (slack, whatsapp, discord, etc.) or \"custom\"."
-    },
-    "darkMode": {
-      "type": "boolean",
-      "description": "Whether dark mode is enabled."
-    },
-    "paths": {
-      "type": "object",
-      "description": "Paths to CometChat files in this project.",
-      "additionalProperties": false,
-      "properties": {
-        "provider": {
-          "type": "string",
-          "description": "Path to the CometChat provider component (e.g. \"src/providers/CometChatProvider.tsx\")."
-        },
-        "chatPage": {
-          "type": "string",
-          "description": "Path to the main chat page (e.g. \"app/messages/page.tsx\")."
-        },
-        "chatDrawer": {
-          "type": "string",
-          "description": "Path to the chat drawer component."
-        },
-        "chatModal": {
-          "type": "string",
-          "description": "Path to the chat modal component."
-        },
-        "cssImport": {
-          "type": "string",
-          "description": "Path where css-variables.css was imported."
-        }
-      }
-    },
-    "features": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      },
-      "uniqueItems": true,
-      "description": "Features applied on top of the base integration (e.g. [\"instant-messaging\", \"media-sharing\"])."
-    }
-  }
-}

package/dist/registry/schemas/template.schema.json

@@ -1,142 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://cometchat.com/skills/schemas/template.schema.json",
-  "title": "CometChat Skills Template",
-  "description": "Schema for an experience-template manifest. One file per (framework × experience) combo.",
-  "type": "object",
-  "required": [
-    "version",
-    "experience_id",
-    "framework",
-    "sdk_compatibility",
-    "deps",
-    "env_vars",
-    "files"
-  ],
-  "additionalProperties": false,
-  "properties": {
-    "version": {
-      "type": "string",
-      "description": "Template version. Bumped whenever the template content changes. Used by drift detection.",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$"
-    },
-    "experience_id": {
-      "type": "integer",
-      "enum": [1, 2, 3],
-      "description": "Which experience this template implements."
-    },
-    "framework": {
-      "type": "string",
-      "enum": ["reactjs", "nextjs", "react-router", "astro"],
-      "description": "Which framework this template targets."
-    },
-    "sdk_compatibility": {
-      "type": "string",
-      "description": "Semver range of @cometchat/chat-uikit-react this template is compatible with.",
-      "examples": [">=6.0.0 <7.0.0"]
-    },
-    "default_placement": {
-      "type": "string",
-      "enum": ["dedicated-route", "embed", "spa-root"],
-      "description": "Where the chat UI lands by default. spa-root means it replaces the App.tsx for SPA frameworks."
-    },
-    "deps": {
-      "type": "array",
-      "description": "npm packages to install.",
-      "items": {
-        "type": "object",
-        "required": ["name", "version"],
-        "additionalProperties": false,
-        "properties": {
-          "name": { "type": "string" },
-          "version": { "type": "string" },
-          "dev": { "type": "boolean", "default": false }
-        }
-      }
-    },
-    "env_vars": {
-      "type": "array",
-      "description": "Environment variables that need to be set in .env*. The {{ENV_PREFIX}} placeholder is substituted at apply time based on detected framework.",
-      "items": {
-        "type": "object",
-        "required": ["name", "required"],
-        "additionalProperties": false,
-        "properties": {
-          "name": { "type": "string" },
-          "required": { "type": "boolean" },
-          "secret": { "type": "boolean", "default": false },
-          "description": { "type": "string" }
-        }
-      }
-    },
-    "files": {
-      "type": "array",
-      "description": "Files to create or patch. Order matters — patches apply in array order.",
-      "items": {
-        "oneOf": [
-          {
-            "type": "object",
-            "required": ["path", "action", "template_ref"],
-            "additionalProperties": false,
-            "properties": {
-              "path": {
-                "type": "string",
-                "description": "Destination path relative to project root. May contain {{VAR}} placeholders."
-              },
-              "action": { "const": "create" },
-              "template_ref": {
-                "type": "string",
-                "description": "Path to the template file inside this template's directory."
-              },
-              "owned": {
-                "type": "boolean",
-                "default": true,
-                "description": "Whether this file is owned by CometChat. Owned files can be cleanly removed by uninstall."
-              }
-            }
-          },
-          {
-            "type": "object",
-            "required": ["path", "action"],
-            "additionalProperties": false,
-            "properties": {
-              "path": { "type": "string" },
-              "action": { "const": "patch" },
-              "patch_mode": {
-                "type": "string",
-                "enum": ["prepend", "append", "insert-after", "insert-before", "replace-section"],
-                "default": "prepend"
-              },
-              "patch_content": {
-                "type": "string",
-                "description": "Inline patch content (for small patches)."
-              },
-              "patch_ref": {
-                "type": "string",
-                "description": "Path to a patch file (for larger patches)."
-              },
-              "anchor": {
-                "type": "string",
-                "description": "For insert-after / replace-section: the anchor string to find in the target file."
-              },
-              "skip_if_exists": {
-                "type": "string",
-                "description": "If this string is already in the file, skip the patch (idempotency)."
-              }
-            }
-          }
-        ]
-      }
-    },
-    "verify_rules": {
-      "type": "array",
-      "description": "Names of AST verification rules that must pass after this template is applied.",
-      "items": { "type": "string" }
-    },
-    "next_steps": {
-      "type": "array",
-      "description": "Human-readable instructions to show the user after a successful apply.",
-      "items": { "type": "string" }
-    }
-  }
-}

package/dist/registry/v6/experiences/1-conversation-list/astro.template.json

@@ -1,89 +0,0 @@
-{
-  "$schema": "../../../schemas/template.schema.json",
-  "version": "1.0.0",
-  "experience_id": 1,
-  "framework": "astro",
-  "sdk_compatibility": ">=6.0.0 <7.0.0",
-  "default_placement": "dedicated-route",
-  "deps": [
-    {
-      "name": "@cometchat/chat-uikit-react",
-      "version": "^6"
-    },
-    {
-      "name": "@cometchat/chat-sdk-javascript",
-      "version": "^4"
-    },
-    {
-      "name": "@astrojs/react",
-      "version": "^4"
-    },
-    {
-      "name": "react",
-      "version": "^18"
-    },
-    {
-      "name": "react-dom",
-      "version": "^18"
-    }
-  ],
-  "env_vars": [
-    {
-      "name": "{{ENV_PREFIX}}COMETCHAT_APP_ID",
-      "required": true,
-      "description": "CometChat App ID from your dashboard"
-    },
-    {
-      "name": "{{ENV_PREFIX}}COMETCHAT_REGION",
-      "required": true,
-      "description": "CometChat region (us, eu, in, etc.)"
-    },
-    {
-      "name": "{{ENV_PREFIX}}COMETCHAT_AUTH_KEY",
-      "required": true,
-      "secret": true,
-      "description": "CometChat Auth Key (development only)"
-    }
-  ],
-  "files": [
-    {
-      "path": "src/cometchat/ChatApp.tsx",
-      "action": "create",
-      "template_ref": "ChatApp.tsx.tpl",
-      "owned": true
-    },
-    {
-      "path": "src/cometchat/ChatApp.css",
-      "action": "create",
-      "template_ref": "ChatApp.css.tpl",
-      "owned": true
-    },
-    {
-      "path": "src/cometchat/CometChatSelector.tsx",
-      "action": "create",
-      "template_ref": "CometChatSelector.tsx.tpl",
-      "owned": true
-    },
-    {
-      "path": "src/pages/chat.astro",
-      "action": "create",
-      "template_ref": "chat.astro.tpl",
-      "owned": true,
-      "is_entry": true
-    }
-  ],
-  "verify_rules": [
-    "init_before_login",
-    "no_user_and_group_same_component",
-    "no_auth_key_in_source",
-    "render_gated_on_login_resolve",
-    "error_ui_visible_on_failure"
-  ],
-  "next_steps": [
-    "If `@astrojs/react` isn't installed yet, run: `npx astro add react`",
-    "Run `npm run dev` to start the dev server",
-    "Visit http://localhost:4321/chat",
-    "Note: css-variables.css is imported inside ChatApp.tsx (not in any global stylesheet) — this is required for Astro client:only islands",
-    "When ready for production, run `cometchat apply --production` to set up server-side auth tokens"
-  ]
-}

package/dist/registry/v6/experiences/1-conversation-list/nextjs-pages.template.json

@@ -1,83 +0,0 @@
-{
-  "$schema": "../../../schemas/template.schema.json",
-  "version": "1.0.0",
-  "experience_id": 1,
-  "framework": "nextjs-pages",
-  "sdk_compatibility": ">=6.0.0 <7.0.0",
-  "default_placement": "dedicated-route",
-  "deps": [
-    {
-      "name": "@cometchat/chat-uikit-react",
-      "version": "^6"
-    },
-    {
-      "name": "@cometchat/chat-sdk-javascript",
-      "version": "^4"
-    }
-  ],
-  "env_vars": [
-    {
-      "name": "{{ENV_PREFIX}}COMETCHAT_APP_ID",
-      "required": true,
-      "description": "CometChat App ID from your dashboard"
-    },
-    {
-      "name": "{{ENV_PREFIX}}COMETCHAT_REGION",
-      "required": true,
-      "description": "CometChat region (us, eu, in, etc.)"
-    },
-    {
-      "name": "{{ENV_PREFIX}}COMETCHAT_AUTH_KEY",
-      "required": true,
-      "secret": true,
-      "description": "CometChat Auth Key (development only)"
-    }
-  ],
-  "files": [
-    {
-      "path": "src/cometchat/CometChatNoSSR.tsx",
-      "action": "create",
-      "template_ref": "CometChatNoSSR.tsx.tpl",
-      "owned": true
-    },
-    {
-      "path": "src/cometchat/CometChatNoSSR.css",
-      "action": "create",
-      "template_ref": "CometChatNoSSR.css.tpl",
-      "owned": true
-    },
-    {
-      "path": "src/cometchat/CometChatSelector.tsx",
-      "action": "create",
-      "template_ref": "CometChatSelector.tsx.tpl",
-      "owned": true
-    },
-    {
-      "path": "src/pages/chat.tsx",
-      "action": "create",
-      "template_ref": "chat-page.tsx.tpl",
-      "owned": true,
-      "is_entry": true
-    },
-    {
-      "path": "src/styles/globals.css",
-      "action": "patch",
-      "patch_mode": "prepend",
-      "patch_content": "@import url(\"@cometchat/chat-uikit-react/css-variables.css\");\n",
-      "skip_if_exists": "@cometchat/chat-uikit-react/css-variables.css"
-    }
-  ],
-  "verify_rules": [
-    "css_variables_imported_once",
-    "init_before_login",
-    "no_user_and_group_same_component",
-    "no_auth_key_in_source",
-    "render_gated_on_login_resolve",
-    "error_ui_visible_on_failure"
-  ],
-  "next_steps": [
-    "Run `npm run dev` to start the dev server",
-    "Visit http://localhost:3000/chat",
-    "When ready for production, run `cometchat apply --production` to set up server-side auth tokens"
-  ]
-}

package/dist/registry/v6/experiences/1-conversation-list/nextjs.template.json

@@ -1,83 +0,0 @@
-{
-  "$schema": "../../../schemas/template.schema.json",
-  "version": "1.0.0",
-  "experience_id": 1,
-  "framework": "nextjs",
-  "sdk_compatibility": ">=6.0.0 <7.0.0",
-  "default_placement": "dedicated-route",
-  "deps": [
-    {
-      "name": "@cometchat/chat-uikit-react",
-      "version": "^6"
-    },
-    {
-      "name": "@cometchat/chat-sdk-javascript",
-      "version": "^4"
-    }
-  ],
-  "env_vars": [
-    {
-      "name": "{{ENV_PREFIX}}COMETCHAT_APP_ID",
-      "required": true,
-      "description": "CometChat App ID from your dashboard"
-    },
-    {
-      "name": "{{ENV_PREFIX}}COMETCHAT_REGION",
-      "required": true,
-      "description": "CometChat region (us, eu, in, etc.)"
-    },
-    {
-      "name": "{{ENV_PREFIX}}COMETCHAT_AUTH_KEY",
-      "required": true,
-      "secret": true,
-      "description": "CometChat Auth Key (development only)"
-    }
-  ],
-  "files": [
-    {
-      "path": "src/app/cometchat/CometChatNoSSR.tsx",
-      "action": "create",
-      "template_ref": "CometChatNoSSR.tsx.tpl",
-      "owned": true
-    },
-    {
-      "path": "src/app/cometchat/CometChatNoSSR.css",
-      "action": "create",
-      "template_ref": "CometChatNoSSR.css.tpl",
-      "owned": true
-    },
-    {
-      "path": "src/app/cometchat/CometChatSelector.tsx",
-      "action": "create",
-      "template_ref": "CometChatSelector.tsx.tpl",
-      "owned": true
-    },
-    {
-      "path": "src/app/chat/page.tsx",
-      "action": "create",
-      "template_ref": "chat-page.tsx.tpl",
-      "owned": true,
-      "is_entry": true
-    },
-    {
-      "path": "src/app/globals.css",
-      "action": "patch",
-      "patch_mode": "prepend",
-      "patch_content": "@import url(\"@cometchat/chat-uikit-react/css-variables.css\");\n",
-      "skip_if_exists": "@cometchat/chat-uikit-react/css-variables.css"
-    }
-  ],
-  "verify_rules": [
-    "css_variables_imported_once",
-    "init_before_login",
-    "no_user_and_group_same_component",
-    "no_auth_key_in_source",
-    "render_gated_on_login_resolve",
-    "error_ui_visible_on_failure"
-  ],
-  "next_steps": [
-    "Run `npm run dev` to start the dev server",
-    "Visit http://localhost:3000/chat",
-    "When ready for production, run `cometchat apply --production` to set up server-side auth tokens"
-  ]
-}