@cometchat/skills-cli 2.4.1 → 3.0.0

package/dist/registry/v6/user-mgmt/nextjs/route.ts.tpl

@@ -1,212 +0,0 @@
-/**
- * /api/cometchat-user — server-side CometChat user management.
- *
- * Handles three operations:
- *   POST   — create a new CometChat user (call when an app user signs up)
- *   PATCH  — update an existing user (call when profile changes)
- *   DELETE — delete a user (call when app user is deleted)
- *
- * All operations use the CometChat REST API with the server-only AUTH_KEY.
- * The auth key NEVER leaves the server.
- *
- * Generated by `cometchat add-user-mgmt`.
- *
- * SECURITY: this template is unauthenticated by design — add your own
- * session check (NextAuth, Clerk, custom JWT) before exposing it publicly.
- * Otherwise anyone with the URL can create/delete users in your app.
- */
-import { NextRequest, NextResponse } from "next/server";
-
-const COMETCHAT_APP_ID = process.env.NEXT_PUBLIC_COMETCHAT_APP_ID!;
-const COMETCHAT_REGION = process.env.NEXT_PUBLIC_COMETCHAT_REGION!;
-const COMETCHAT_AUTH_KEY = process.env.COMETCHAT_AUTH_KEY!;
-
-interface CreateUserBody {
-  uid: string;
-  name: string;
-  avatar?: string;
-  link?: string;
-  role?: string;
-  metadata?: Record<string, unknown>;
-  tags?: string[];
-}
-
-interface UpdateUserBody {
-  uid: string;
-  name?: string;
-  avatar?: string;
-  link?: string;
-  role?: string;
-  metadata?: Record<string, unknown>;
-  tags?: string[];
-}
-
-const COMETCHAT_API_BASE = `https://${COMETCHAT_APP_ID}.api-${COMETCHAT_REGION}.cometchat.io/v3`;
-
-const baseHeaders = {
-  "Content-Type": "application/json",
-  appid: COMETCHAT_APP_ID,
-  apikey: COMETCHAT_AUTH_KEY,
-};
-
-function validateConfig(): NextResponse | null {
-  if (!COMETCHAT_APP_ID || !COMETCHAT_REGION || !COMETCHAT_AUTH_KEY) {
-    return NextResponse.json(
-      { error: "CometChat credentials not configured on the server" },
-      { status: 500 },
-    );
-  }
-  return null;
-}
-
-// CometChat UIDs must be alphanumeric + hyphens + underscores. Validate before
-// passing to the API to give better error messages than the upstream 400.
-function validateUid(uid: unknown): string | null {
-  if (typeof uid !== "string" || uid.length === 0) return "uid is required";
-  if (uid.length > 100) return "uid must be ≤100 characters";
-  if (!/^[a-zA-Z0-9_-]+$/.test(uid)) {
-    return "uid must contain only alphanumeric characters, hyphens, and underscores";
-  }
-  return null;
-}
-
-/** POST — create a new user. Body: { uid, name, ...optional }. */
-export async function POST(request: NextRequest) {
-  const configError = validateConfig();
-  if (configError) return configError;
-
-  let body: CreateUserBody;
-  try {
-    body = await request.json();
-  } catch {
-    return NextResponse.json({ error: "Invalid JSON body" }, { status: 400 });
-  }
-
-  const uidError = validateUid(body.uid);
-  if (uidError) return NextResponse.json({ error: uidError }, { status: 400 });
-  if (!body.name || typeof body.name !== "string") {
-    return NextResponse.json({ error: "name is required" }, { status: 400 });
-  }
-
-  try {
-    const res = await fetch(`${COMETCHAT_API_BASE}/users`, {
-      method: "POST",
-      headers: baseHeaders,
-      body: JSON.stringify({
-        uid: body.uid,
-        name: body.name,
-        ...(body.avatar && { avatar: body.avatar }),
-        ...(body.link && { link: body.link }),
-        ...(body.role && { role: body.role }),
-        ...(body.metadata && { metadata: body.metadata }),
-        ...(body.tags && { tags: body.tags }),
-      }),
-    });
-
-    if (!res.ok) {
-      const detail = await res.text();
-      return NextResponse.json(
-        { error: `CometChat user create failed (${res.status})`, detail },
-        { status: res.status === 409 ? 409 : 502 },
-      );
-    }
-
-    const data = (await res.json()) as { data?: unknown };
-    return NextResponse.json({ user: data.data }, { status: 201 });
-  } catch (err) {
-    return NextResponse.json(
-      { error: "Create failed", detail: err instanceof Error ? err.message : String(err) },
-      { status: 500 },
-    );
-  }
-}
-
-/** PATCH — update an existing user. Body: { uid, ...fields-to-update }. */
-export async function PATCH(request: NextRequest) {
-  const configError = validateConfig();
-  if (configError) return configError;
-
-  let body: UpdateUserBody;
-  try {
-    body = await request.json();
-  } catch {
-    return NextResponse.json({ error: "Invalid JSON body" }, { status: 400 });
-  }
-
-  const uidError = validateUid(body.uid);
-  if (uidError) return NextResponse.json({ error: uidError }, { status: 400 });
-
-  const updates: Record<string, unknown> = {};
-  if (body.name !== undefined) updates.name = body.name;
-  if (body.avatar !== undefined) updates.avatar = body.avatar;
-  if (body.link !== undefined) updates.link = body.link;
-  if (body.role !== undefined) updates.role = body.role;
-  if (body.metadata !== undefined) updates.metadata = body.metadata;
-  if (body.tags !== undefined) updates.tags = body.tags;
-
-  if (Object.keys(updates).length === 0) {
-    return NextResponse.json({ error: "No fields to update" }, { status: 400 });
-  }
-
-  try {
-    const res = await fetch(`${COMETCHAT_API_BASE}/users/${encodeURIComponent(body.uid)}`, {
-      method: "PUT",
-      headers: baseHeaders,
-      body: JSON.stringify(updates),
-    });
-
-    if (!res.ok) {
-      const detail = await res.text();
-      return NextResponse.json(
-        { error: `CometChat user update failed (${res.status})`, detail },
-        { status: 502 },
-      );
-    }
-
-    const data = (await res.json()) as { data?: unknown };
-    return NextResponse.json({ user: data.data });
-  } catch (err) {
-    return NextResponse.json(
-      { error: "Update failed", detail: err instanceof Error ? err.message : String(err) },
-      { status: 500 },
-    );
-  }
-}
-
-/** DELETE — delete a user. Query: ?uid=<uid>. */
-export async function DELETE(request: NextRequest) {
-  const configError = validateConfig();
-  if (configError) return configError;
-
-  const uid = request.nextUrl.searchParams.get("uid");
-  const uidError = validateUid(uid);
-  if (uidError) return NextResponse.json({ error: uidError }, { status: 400 });
-
-  try {
-    const res = await fetch(
-      `${COMETCHAT_API_BASE}/users/${encodeURIComponent(uid as string)}`,
-      {
-        method: "DELETE",
-        headers: baseHeaders,
-        body: JSON.stringify({ permanent: true }),
-      },
-    );
-
-    if (!res.ok) {
-      const detail = await res.text();
-      return NextResponse.json(
-        { error: `CometChat user delete failed (${res.status})`, detail },
-        { status: 502 },
-      );
-    }
-
-    return NextResponse.json({ deleted: uid });
-  } catch (err) {
-    return NextResponse.json(
-      { error: "Delete failed", detail: err instanceof Error ? err.message : String(err) },
-      { status: 500 },
-    );
-  }
-}
-
-export const dynamic = "force-dynamic";

package/dist/registry/v6/user-mgmt/nextjs.template.json

@@ -1,57 +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": [],
-  "env_vars": [
-    {
-      "name": "COMETCHAT_AUTH_KEY",
-      "required": true,
-      "secret": true,
-      "description": "Server-side only Auth Key (no NEXT_PUBLIC_ prefix). Used by both /api/cometchat-token AND /api/cometchat-user."
-    },
-    {
-      "name": "NEXT_PUBLIC_COMETCHAT_APP_ID",
-      "required": true
-    },
-    {
-      "name": "NEXT_PUBLIC_COMETCHAT_REGION",
-      "required": true
-    }
-  ],
-  "files": [
-    {
-      "path": "src/app/api/cometchat-user/route.ts",
-      "action": "create",
-      "template_ref": "route.ts.tpl",
-      "owned": true
-    }
-  ],
-  "verify_rules": [],
-  "next_steps": [
-    "1. The endpoint at /api/cometchat-user supports POST (create), PATCH (update), and DELETE.",
-    "2. Wire it into your sign-up flow. When a new user signs up, call POST /api/cometchat-user with { uid, name, avatar?, metadata? } to create their CometChat counterpart.",
-    "",
-    "   Example with NextAuth (in your sign-up callback):",
-    "     const res = await fetch('/api/cometchat-user', {",
-    "       method: 'POST',",
-    "       headers: { 'Content-Type': 'application/json' },",
-    "       body: JSON.stringify({ uid: session.user.id, name: session.user.name }),",
-    "     });",
-    "",
-    "   Example with Clerk (in a Clerk webhook handler):",
-    "     export async function POST(req: Request) {",
-    "       const event = await req.json();",
-    "       if (event.type === 'user.created') {",
-    "         await fetch(`${process.env.NEXTAUTH_URL}/api/cometchat-user`, { ... });",
-    "       }",
-    "     }",
-    "",
-    "3. The endpoint validates uid is alphanumeric + hyphens only (CometChat constraint).",
-    "4. Errors are returned as { error, detail } with HTTP status codes.",
-    "5. SECURITY: in production, this endpoint should be authenticated. The template uses no auth — add session checks before deploying."
-  ]
-}

package/dist/registry/v6/user-mgmt/react-router/api.cometchat-user.ts.tpl

@@ -1,176 +0,0 @@
-/**
- * /api/cometchat-user — server-side CometChat user management.
- *
- * React Router v7 framework mode action+loader pattern.
- *   POST  via action  → create user
- *   PUT   via action  → update user
- *   DELETE via action → delete user
- *
- * The Auth Key NEVER leaves the server.
- *
- * Generated by `cometchat add-user-mgmt`.
- *
- * SECURITY: this template is unauthenticated by design — add your own
- * session check before exposing it publicly.
- */
-import type { ActionFunctionArgs } from "react-router";
-
-const COMETCHAT_APP_ID = process.env.VITE_COMETCHAT_APP_ID!;
-const COMETCHAT_REGION = process.env.VITE_COMETCHAT_REGION!;
-const COMETCHAT_AUTH_KEY = process.env.COMETCHAT_AUTH_KEY!;
-
-const COMETCHAT_API_BASE = `https://${COMETCHAT_APP_ID}.api-${COMETCHAT_REGION}.cometchat.io/v3`;
-
-const baseHeaders = {
-  "Content-Type": "application/json",
-  appid: COMETCHAT_APP_ID,
-  apikey: COMETCHAT_AUTH_KEY,
-};
-
-function jsonResponse(data: unknown, status = 200) {
-  return new Response(JSON.stringify(data), {
-    status,
-    headers: { "Content-Type": "application/json" },
-  });
-}
-
-function validateUid(uid: unknown): string | null {
-  if (typeof uid !== "string" || uid.length === 0) return "uid is required";
-  if (uid.length > 100) return "uid must be ≤100 characters";
-  if (!/^[a-zA-Z0-9_-]+$/.test(uid)) {
-    return "uid must contain only alphanumeric characters, hyphens, and underscores";
-  }
-  return null;
-}
-
-function validateConfig() {
-  if (!COMETCHAT_APP_ID || !COMETCHAT_REGION || !COMETCHAT_AUTH_KEY) {
-    return jsonResponse({ error: "CometChat credentials not configured on the server" }, 500);
-  }
-  return null;
-}
-
-export async function action({ request }: ActionFunctionArgs) {
-  const configError = validateConfig();
-  if (configError) return configError;
-
-  const method = request.method.toUpperCase();
-
-  if (method === "POST") {
-    let body;
-    try {
-      body = await request.json();
-    } catch {
-      return jsonResponse({ error: "Invalid JSON body" }, 400);
-    }
-    const uidError = validateUid(body.uid);
-    if (uidError) return jsonResponse({ error: uidError }, 400);
-    if (!body.name) return jsonResponse({ error: "name is required" }, 400);
-
-    try {
-      const res = await fetch(`${COMETCHAT_API_BASE}/users`, {
-        method: "POST",
-        headers: baseHeaders,
-        body: JSON.stringify({
-          uid: body.uid,
-          name: body.name,
-          ...(body.avatar && { avatar: body.avatar }),
-          ...(body.metadata && { metadata: body.metadata }),
-          ...(body.tags && { tags: body.tags }),
-        }),
-      });
-      if (!res.ok) {
-        const detail = await res.text();
-        return jsonResponse(
-          { error: `CometChat user create failed (${res.status})`, detail },
-          res.status === 409 ? 409 : 502,
-        );
-      }
-      const data = await res.json();
-      return jsonResponse({ user: data.data }, 201);
-    } catch (err) {
-      return jsonResponse(
-        { error: "Create failed", detail: err instanceof Error ? err.message : String(err) },
-        500,
-      );
-    }
-  }
-
-  if (method === "PUT" || method === "PATCH") {
-    let body;
-    try {
-      body = await request.json();
-    } catch {
-      return jsonResponse({ error: "Invalid JSON body" }, 400);
-    }
-    const uidError = validateUid(body.uid);
-    if (uidError) return jsonResponse({ error: uidError }, 400);
-
-    const updates: Record<string, unknown> = {};
-    if (body.name !== undefined) updates.name = body.name;
-    if (body.avatar !== undefined) updates.avatar = body.avatar;
-    if (body.metadata !== undefined) updates.metadata = body.metadata;
-    if (body.tags !== undefined) updates.tags = body.tags;
-    if (Object.keys(updates).length === 0) {
-      return jsonResponse({ error: "No fields to update" }, 400);
-    }
-
-    try {
-      const res = await fetch(
-        `${COMETCHAT_API_BASE}/users/${encodeURIComponent(body.uid)}`,
-        {
-          method: "PUT",
-          headers: baseHeaders,
-          body: JSON.stringify(updates),
-        },
-      );
-      if (!res.ok) {
-        const detail = await res.text();
-        return jsonResponse(
-          { error: `CometChat user update failed (${res.status})`, detail },
-          502,
-        );
-      }
-      const data = await res.json();
-      return jsonResponse({ user: data.data });
-    } catch (err) {
-      return jsonResponse(
-        { error: "Update failed", detail: err instanceof Error ? err.message : String(err) },
-        500,
-      );
-    }
-  }
-
-  if (method === "DELETE") {
-    const url = new URL(request.url);
-    const uid = url.searchParams.get("uid");
-    const uidError = validateUid(uid);
-    if (uidError) return jsonResponse({ error: uidError }, 400);
-
-    try {
-      const res = await fetch(
-        `${COMETCHAT_API_BASE}/users/${encodeURIComponent(uid as string)}`,
-        {
-          method: "DELETE",
-          headers: baseHeaders,
-          body: JSON.stringify({ permanent: true }),
-        },
-      );
-      if (!res.ok) {
-        const detail = await res.text();
-        return jsonResponse(
-          { error: `CometChat user delete failed (${res.status})`, detail },
-          502,
-        );
-      }
-      return jsonResponse({ deleted: uid });
-    } catch (err) {
-      return jsonResponse(
-        { error: "Delete failed", detail: err instanceof Error ? err.message : String(err) },
-        500,
-      );
-    }
-  }
-
-  return jsonResponse({ error: `Method ${method} not allowed` }, 405);
-}

package/dist/registry/v6/user-mgmt/react-router.template.json

@@ -1,40 +0,0 @@
-{
-  "$schema": "../../schemas/template.schema.json",
-  "version": "1.0.0",
-  "experience_id": 1,
-  "framework": "react-router",
-  "sdk_compatibility": ">=6.0.0 <7.0.0",
-  "default_placement": "dedicated-route",
-  "deps": [],
-  "env_vars": [
-    {
-      "name": "COMETCHAT_AUTH_KEY",
-      "required": true,
-      "secret": true,
-      "description": "Server-side only Auth Key (no VITE_ prefix). Used by the user management endpoints."
-    }
-  ],
-  "files": [
-    {
-      "path": "app/routes/api.cometchat-user.ts",
-      "action": "create",
-      "template_ref": "api.cometchat-user.ts.tpl",
-      "owned": true
-    },
-    {
-      "path": "app/routes.ts",
-      "action": "patch",
-      "patch_mode": "insert-before",
-      "anchor": "] satisfies RouteConfig",
-      "patch_content": "  route(\"api/cometchat-user\", \"routes/api.cometchat-user.ts\"),\n",
-      "skip_if_exists": "routes/api.cometchat-user.ts"
-    }
-  ],
-  "verify_rules": [],
-  "next_steps": [
-    "1. Endpoint at /api/cometchat-user supports POST (create), PATCH (update), DELETE.",
-    "2. Add COMETCHAT_AUTH_KEY (no VITE_ prefix) to .env. The auth key stays server-only.",
-    "3. Wire it into your sign-up flow — when an app user is created, call POST /api/cometchat-user with { uid, name, ... }.",
-    "4. SECURITY: this template is unauthenticated. Add session checks before deploying."
-  ]
-}

package/dist/registry/v6/widget/astro/CometChatWidget.css.tpl

@@ -1,105 +0,0 @@
-/**
- * CometChatWidget styles — floating button + drawer.
- *
- * Edit the .cometchat-widget-button selector to change the button position
- * (default: bottom-right). Edit the .cometchat-widget-drawer selector to
- * change the drawer size + position.
- */
-
-.cometchat-widget-button {
-  position: fixed;
-  bottom: 24px;
-  right: 24px;
-  width: 56px;
-  height: 56px;
-  border-radius: 50%;
-  border: none;
-  background: var(--cometchat-primary-color, #6852D6);
-  color: white;
-  font-size: 24px;
-  cursor: pointer;
-  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
-  z-index: 9999;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  transition: transform 0.2s ease, box-shadow 0.2s ease;
-}
-
-.cometchat-widget-button:hover {
-  transform: scale(1.05);
-  box-shadow: 0 6px 16px rgba(0, 0, 0, 0.2);
-}
-
-.cometchat-widget-button:active {
-  transform: scale(0.98);
-}
-
-.cometchat-widget-drawer {
-  position: fixed;
-  bottom: 96px;
-  right: 24px;
-  width: 720px;
-  max-width: calc(100vw - 48px);
-  height: 600px;
-  max-height: calc(100vh - 120px);
-  background: white;
-  border-radius: 12px;
-  box-shadow: 0 12px 32px rgba(0, 0, 0, 0.2);
-  z-index: 9998;
-  display: flex;
-  overflow: hidden;
-  border: 1px solid var(--cometchat-border-color-default, #e8e8e8);
-}
-
-.cometchat-widget-conversations {
-  width: 280px;
-  border-right: 1px solid var(--cometchat-border-color-default, #e8e8e8);
-  overflow: hidden;
-  display: flex;
-  flex-direction: column;
-}
-
-.cometchat-widget-conversations > .cometchat {
-  overflow: hidden;
-}
-
-.cometchat-widget-messages {
-  flex: 1;
-  display: flex;
-  flex-direction: column;
-  overflow: hidden;
-}
-
-.cometchat-widget-empty {
-  flex: 1;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  background: var(--cometchat-background-color-03, #f5f5f5);
-  color: var(--cometchat-text-color-secondary, #727272);
-  font: var(--cometchat-font-body-regular, 400 14px Roboto);
-  padding: 16px;
-  text-align: center;
-}
-
-@media (max-width: 600px) {
-  .cometchat-widget-drawer {
-    bottom: 16px;
-    right: 16px;
-    left: 16px;
-    width: auto;
-    height: calc(100vh - 100px);
-    flex-direction: column;
-  }
-  .cometchat-widget-conversations {
-    width: 100%;
-    height: 200px;
-    border-right: none;
-    border-bottom: 1px solid var(--cometchat-border-color-default, #e8e8e8);
-  }
-  .cometchat-widget-button {
-    bottom: 16px;
-    right: 16px;
-  }
-}

package/dist/registry/v6/widget/astro/CometChatWidget.tsx.tpl

@@ -1,88 +0,0 @@
-/**
- * CometChatWidget — floating chat overlay (Astro React island).
- *
- * Render this from any .astro file with `client:only="react"` so Astro
- * skips SSR entirely:
- *   import CometChatWidget from "../cometchat/CometChatWidget";
- *   <CometChatWidget client:only="react" />
- *
- * Assumes CometChatUIKit.init() and CometChatUIKit.login() have already
- * been called by your existing ChatApp island. The widget does NOT
- * initialize CometChat — it just renders the existing logged-in user's
- * chat. Mount the widget on a page that also mounts the ChatApp island,
- * OR move init/login into a shared location.
- */
-import { useEffect, useState } from "react";
-import {
-  CometChatMessageComposer,
-  CometChatMessageHeader,
-  CometChatMessageList,
-} from "@cometchat/chat-uikit-react";
-import { CometChat } from "@cometchat/chat-sdk-javascript";
-import { CometChatSelector } from "./CometChatSelector";
-import "./CometChatWidget.css";
-
-export default function CometChatWidget() {
-  const [open, setOpen] = useState(false);
-  const [selectedUser, setSelectedUser] = useState<CometChat.User | undefined>();
-  const [selectedGroup, setSelectedGroup] = useState<CometChat.Group | undefined>();
-
-  // Close on Escape key
-  useEffect(() => {
-    if (!open) return;
-    const handler = (e: KeyboardEvent) => {
-      if (e.key === "Escape") setOpen(false);
-    };
-    window.addEventListener("keydown", handler);
-    return () => window.removeEventListener("keydown", handler);
-  }, [open]);
-
-  return (
-    <>
-      <button
-        type="button"
-        className="cometchat-widget-button"
-        onClick={() => setOpen((v) => !v)}
-        aria-label={open ? "Close chat" : "Open chat"}
-      >
-        {open ? "✕" : "💬"}
-      </button>
-
-      {open && (
-        <div className="cometchat-widget-drawer" role="dialog" aria-label="Chat">
-          <div className="cometchat-widget-conversations">
-            <CometChatSelector
-              onSelectorItemClicked={(activeItem) => {
-                const item =
-                  activeItem instanceof CometChat.Conversation
-                    ? activeItem.getConversationWith()
-                    : activeItem;
-                if (item instanceof CometChat.User) {
-                  setSelectedUser(item);
-                  setSelectedGroup(undefined);
-                } else if (item instanceof CometChat.Group) {
-                  setSelectedUser(undefined);
-                  setSelectedGroup(item);
-                }
-              }}
-            />
-          </div>
-          {selectedUser || selectedGroup ? (
-            <div className="cometchat-widget-messages">
-              {selectedUser && <CometChatMessageHeader user={selectedUser} />}
-              {selectedGroup && <CometChatMessageHeader group={selectedGroup} />}
-              {selectedUser && <CometChatMessageList user={selectedUser} />}
-              {selectedGroup && <CometChatMessageList group={selectedGroup} />}
-              {selectedUser && <CometChatMessageComposer user={selectedUser} />}
-              {selectedGroup && <CometChatMessageComposer group={selectedGroup} />}
-            </div>
-          ) : (
-            <div className="cometchat-widget-empty">
-              Select a conversation to start chatting
-            </div>
-          )}
-        </div>
-      )}
-    </>
-  );
-}