create-disposabl-app 0.1.0 → 0.1.2

package/dist/templates/default/packages/disposabl-kit/client/routes/consent.tsx

@@ -0,0 +1,137 @@
+import { useState } from "react";
+import { createFileRoute, Link } from "@tanstack/react-router";
+import { useAction, useConvexAuth, useQuery } from "convex/react";
+import { api } from "../../../backend/convex/_generated/api";
+import { Button } from "../components/ui/button";
+
+export const Route = createFileRoute("/_providers/consent")({
+  validateSearch: (search: Record<string, unknown>): { request?: string } => ({
+    request:
+      typeof search.request === "string"
+        ? search.request.trim() || undefined
+        : undefined,
+  }),
+  component: ConsentPage,
+});
+
+function ConsentPage() {
+  const { request: requestId } = Route.useSearch();
+  const request = useQuery(
+    api.mcp.getAuthRequest,
+    requestId ? { requestId } : "skip",
+  );
+  const authorize = useAction(api.mcp.authorize);
+  const { isAuthenticated, isLoading } = useConvexAuth();
+  const [pending, setPending] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  const decide = async (approve: boolean) => {
+    if (!requestId || pending) return;
+    setPending(true);
+    setError(null);
+    try {
+      const { redirectUrl } = await authorize({ requestId, approve });
+      window.location.assign(redirectUrl);
+    } catch {
+      setError("Could not save your decision. Please try again.");
+      setPending(false);
+    }
+  };
+
+  let content;
+  if (!requestId) {
+    content = (
+      <p>
+        No connection request was provided. Start the connection from your
+        agent.
+      </p>
+    );
+  } else if (request === undefined || isLoading) {
+    content = <p role="status">Loading connection request…</p>;
+  } else if (request === null) {
+    content = (
+      <p>
+        This request has expired or could not be found. Start again from your
+        agent.
+      </p>
+    );
+  } else if (request.status !== "pending" && !pending) {
+    content = (
+      <p>
+        This request has already been {request.status}. Return to your agent to
+        continue.
+      </p>
+    );
+  } else {
+    content = (
+      <>
+        <p>
+          <strong>{request.clientName || request.clientId}</strong> wants to
+          connect to {request.serverName}.
+        </p>
+        <section className="space-y-2" aria-label="Requested permissions">
+          <h2 className="font-medium">Requested access</h2>
+          {request.scopes.length ? (
+            <ul className="list-disc space-y-2 pl-5">
+              {request.scopes.map((scope) => (
+                <li key={scope.name}>{scope.description || scope.name}</li>
+              ))}
+            </ul>
+          ) : (
+            <p className="text-muted-foreground">
+              No additional scopes requested.
+            </p>
+          )}
+        </section>
+        <div className="space-y-1 text-sm">
+          <p className="font-medium">Return address</p>
+          <p className="break-all text-muted-foreground">
+            {request.redirectUri}
+          </p>
+        </div>
+        {error && (
+          <p role="alert" className="text-destructive">
+            {error}
+          </p>
+        )}
+        {isAuthenticated ? (
+          <div className="flex gap-3">
+            <Button
+              variant="outline"
+              disabled={pending}
+              onClick={() => decide(false)}
+            >
+              Deny
+            </Button>
+            <Button disabled={pending} onClick={() => decide(true)}>
+              Allow
+            </Button>
+            {pending && (
+              <span
+                role="status"
+                className="self-center text-sm text-muted-foreground"
+              >
+                Saving…
+              </span>
+            )}
+          </div>
+        ) : (
+          <Link
+            to="/login"
+            search={{ request: requestId }}
+            className="font-medium underline underline-offset-4"
+          >
+            Log in to review this request
+          </Link>
+        )}
+      </>
+    );
+  }
+
+  return (
+    <main className="mx-auto w-full max-w-lg space-y-6 px-6 py-16">
+      <h1 className="text-2xl font-semibold">Connect your agent</h1>
+      {content}
+    </main>
+  );
+}

package/dist/templates/default/packages/disposabl-kit/client/routes/route.tsx

@@ -0,0 +1,30 @@
+import { useState } from "react";
+import { createFileRoute, Outlet } from "@tanstack/react-router";
+import { ConvexAuthProvider } from "@convex-dev/auth/react";
+import { ConvexReactClient } from "convex/react";
+import { api } from "../../../backend/convex/_generated/api";
+
+export const Route = createFileRoute("/_providers")({
+  component: Providers,
+});
+
+function Providers() {
+  const [client] = useState(() => {
+    const url = import.meta.env.VITE_CONVEX_URL;
+    if (!url)
+      throw new Error("Set VITE_CONVEX_URL to your Convex deployment URL");
+    return new ConvexReactClient(url);
+  });
+
+  return (
+    <ConvexAuthProvider
+      client={client}
+      api={{
+        refreshSession: api.auth.refreshSession,
+        signOut: api.auth.signOut,
+      }}
+    >
+      <Outlet />
+    </ConvexAuthProvider>
+  );
+}

package/dist/templates/default/packages/disposabl-kit/client/styles/globals.css

@@ -0,0 +1,60 @@
+@import "tailwindcss";
+@import "tw-animate-css";
+@import "shadcn/tailwind.css";
+@import "@fontsource-variable/inter";
+
+@custom-variant dark (&:is(.dark *));
+@source "../../../../apps/**/*.{ts,tsx}";
+@source "../**/*.{ts,tsx}";
+
+@theme inline {
+    --font-heading: var(--font-sans);
+    --color-sidebar-ring: var(--sidebar-ring);
+    --color-sidebar-border: var(--sidebar-border);
+    --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+    --color-sidebar-accent: var(--sidebar-accent);
+    --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+    --color-sidebar-primary: var(--sidebar-primary);
+    --color-sidebar-foreground: var(--sidebar-foreground);
+    --color-sidebar: var(--sidebar);
+    --color-chart-5: var(--chart-5);
+    --color-chart-4: var(--chart-4);
+    --color-chart-3: var(--chart-3);
+    --color-chart-2: var(--chart-2);
+    --color-chart-1: var(--chart-1);
+    --color-ring: var(--ring);
+    --color-input: var(--input);
+    --color-border: var(--border);
+    --color-destructive: var(--destructive);
+    --color-accent-foreground: var(--accent-foreground);
+    --color-accent: var(--accent);
+    --color-muted-foreground: var(--muted-foreground);
+    --color-muted: var(--muted);
+    --color-secondary-foreground: var(--secondary-foreground);
+    --color-secondary: var(--secondary);
+    --color-primary-foreground: var(--primary-foreground);
+    --color-primary: var(--primary);
+    --color-popover-foreground: var(--popover-foreground);
+    --color-popover: var(--popover);
+    --color-card-foreground: var(--card-foreground);
+    --color-card: var(--card);
+    --color-foreground: var(--foreground);
+    --color-background: var(--background);
+    --radius-sm: calc(var(--radius) * 0.6);
+    --radius-md: calc(var(--radius) * 0.8);
+    --radius-lg: var(--radius);
+    --radius-xl: calc(var(--radius) * 1.4);
+    --radius-2xl: calc(var(--radius) * 1.8);
+    --radius-3xl: calc(var(--radius) * 2.2);
+    --radius-4xl: calc(var(--radius) * 2.6);
+    --font-sans: 'Inter Variable', sans-serif;
+}
+
+@layer base {
+  * {
+    @apply border-border outline-ring/50;
+    }
+  body {
+    @apply bg-background text-foreground;
+    }
+}

package/dist/templates/default/packages/disposabl-kit/client/vite.config.ts

@@ -0,0 +1,32 @@
+import { relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import {
+  layout,
+  physical,
+  rootRoute,
+  route,
+} from "@tanstack/virtual-file-routes";
+
+const kitRoute = (file: string) =>
+  relative(
+    resolve("src/router"),
+    fileURLToPath(new URL(`./routes/${file}`, import.meta.url)),
+  );
+
+// Both Vite and `tsr generate` use this route tree.
+export const routes = rootRoute("__root.tsx", [
+  layout("_providers", kitRoute("route.tsx"), [
+    physical("."),
+    route("/login", kitRoute("_auth-pages/login.tsx")),
+    route("/signup", kitRoute("_auth-pages/signUp.tsx")),
+    route("/consent", kitRoute("consent.tsx")),
+    layout("_authenticated", kitRoute("_authenticated/route.tsx"), []),
+  ]),
+]);
+
+export default {
+  routesDirectory: "router",
+  // The root is registered above, outside the physical subtree.
+  routeFileIgnorePattern: "__root\\.tsx$",
+  virtualRouteConfig: routes,
+};

package/dist/templates/default/packages/disposabl-kit/components.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "base-vega",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "client/styles/globals.css",
+    "baseColor": "neutral",
+    "cssVariables": true
+  },
+  "iconLibrary": "lucide",
+  "aliases": {
+    "components": "@disposabl/disposabl-kit/client/components/ui",
+    "utils": "@disposabl/disposabl-kit/client/lib/utils",
+    "hooks": "@disposabl/disposabl-kit/client/hooks",
+    "lib": "@disposabl/disposabl-kit/client/lib",
+    "ui": "@disposabl/disposabl-kit/client/components/ui"
+  },
+  "rtl": false,
+  "menuColor": "default",
+  "menuAccent": "subtle"
+}

package/dist/templates/default/packages/disposabl-kit/eslint.config.js

@@ -0,0 +1,21 @@
+//  @ts-check
+
+import { tanstackConfig } from "@tanstack/eslint-config"
+
+export default [
+  ...tanstackConfig,
+  {
+    rules: {
+      "import/no-cycle": "off",
+      "import/order": "off",
+      "import/consistent-type-specifier-style": "off",
+      "sort-imports": "off",
+      "@typescript-eslint/array-type": "off",
+      "@typescript-eslint/require-await": "off",
+      "pnpm/json-enforce-catalog": "off",
+    },
+  },
+  {
+    ignores: ["eslint.config.js", ".prettierrc"],
+  },
+]

package/dist/templates/default/packages/disposabl-kit/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@disposabl/disposabl-kit",
+  "version": "0.0.0",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "lint": "eslint",
+    "format": "prettier --write \"**/*.{ts,tsx}\"",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@base-ui/react": "^1.9.0",
+    "@fontsource-variable/inter": "^5.3.0",
+    "@shadcn/react": "^0.3.1",
+    "class-variance-authority": "^0.7.1",
+    "cmdk": "^1.1.1",
+    "cn": "^0.5.0",
+    "date-fns": "^4.4.0",
+    "embla-carousel-react": "^8.6.0",
+    "input-otp": "^1.5.0",
+    "lucide-react": "catalog:",
+    "react": "catalog:",
+    "react-day-picker": "^10.0.2",
+    "react-dom": "catalog:",
+    "react-resizable-panels": "^4.15.0",
+    "recharts": "3.8.0",
+    "shadcn": "^4.22.1",
+    "shiki": "^4.5.0",
+    "tw-animate-css": "^1.4.0",
+    "zod": "^4.6.7",
+    "convex": "catalog:",
+    "@convex-dev/auth": "catalog:",
+    "@convex-dev/mcp": "catalog:",
+    "@convex-dev/static-hosting": "catalog:",
+    "@tanstack/react-router": "latest"
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "^4",
+    "@tanstack/eslint-config": "latest",
+    "@turbo/gen": "^2.11.10",
+    "@types/node": "^22",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^10",
+    "tailwindcss": "^4",
+    "typescript": "^6.0.2",
+    "@tanstack/virtual-file-routes": "^1.162.0",
+    "vite": "^8"
+  },
+  "exports": {
+    "./client/styles/globals.css": "./client/styles/globals.css",
+    "./client/lib/*": "./client/lib/*.ts",
+    "./client/components/ui/*": "./client/components/ui/*.tsx",
+    "./client/hooks/*": "./client/hooks/*.ts",
+    "./server/http": "./server/http.ts",
+    "./server/lib/functions": "./server/lib/functions.ts",
+    "./client/vite.config": "./client/vite.config.ts"
+  }
+}

package/dist/templates/default/packages/disposabl-kit/server/http.ts

@@ -0,0 +1,42 @@
+import { getAuthUserId } from "@convex-dev/auth/server";
+import { McpServer } from "@convex-dev/mcp";
+import { registerStaticRoutes } from "@convex-dev/static-hosting";
+import { httpRouter } from "convex/server";
+import { components } from "../../backend/convex/_generated/api";
+import { env } from "../../backend/convex/_generated/server";
+import { createMcpTools } from "./lib/mcp-tools";
+import { getPlatforms } from "./lib/platforms";
+
+export { tool } from "@convex-dev/mcp";
+export type { McpServerOptions, McpUser, ToolCtx } from "@convex-dev/mcp";
+
+const mcp = getPlatforms().isMcpEnabled
+  ? new McpServer(components.mcp, {
+      name: "disposabl",
+      title: "Disposabl",
+      version: "1.0.0",
+      siteUrl: env.CONVEX_SITE_URL,
+      consentUrl: `${env.CONVEX_SITE_URL}/consent`,
+      scopes: {},
+      // Discovery is disabled; platform flags do not register tools yet.
+      tools: createMcpTools({}),
+    })
+  : undefined;
+
+// Keep the enabled API types for consumers; disabled exports are absent at runtime.
+export const {
+  getAuthRequest,
+  authorize,
+  listConnections,
+  revokeConnection,
+  createApiKey,
+} =
+  mcp?.api({ getUserId: getAuthUserId }) ??
+  ({} as ReturnType<McpServer["api"]>);
+
+export default function createHttpRouter() {
+  const http = httpRouter();
+  mcp?.registerRoutes(http);
+  registerStaticRoutes(http, components.staticHosting);
+  return http;
+}

package/dist/templates/default/packages/disposabl-kit/server/lib/functions.ts

@@ -0,0 +1,46 @@
+import {
+  v,
+  type GenericValidator,
+  type PropertyValidators,
+} from "convex/values";
+import {
+  internalAction as nativeAction,
+  internalMutation as nativeMutation,
+  internalQuery as nativeQuery,
+} from "../../../backend/convex/_generated/server";
+import type { Platforms } from "./platforms";
+
+// Trusted server entrypoints must supply the user ID after authentication.
+export const identityFields = {
+  userId: v.string(),
+};
+
+const withPlatforms = <TDefinition, TResult extends object>(
+  builder: (definition: TDefinition) => TResult,
+) => {
+  return (
+    definition: TDefinition & {
+      args: PropertyValidators;
+      returns: GenericValidator;
+      platforms?: Platforms;
+      mcp?: boolean;
+    },
+  ): TResult => {
+    const mcpEnabled =
+      definition.platforms === undefined
+        ? definition.mcp === true
+        : definition.platforms === true ||
+          (typeof definition.platforms === "object" &&
+            definition.platforms.mcp === true);
+    return Object.assign(builder(definition), {
+      platforms: definition.platforms,
+      mcp: mcpEnabled ? (definition.mcp ?? true) : false,
+      args: definition.args,
+      returns: definition.returns,
+    });
+  };
+};
+
+export const internalQuery = withPlatforms(nativeQuery);
+export const internalMutation = withPlatforms(nativeMutation);
+export const internalAction = withPlatforms(nativeAction);

package/dist/templates/default/packages/disposabl-kit/server/lib/mcp-tools.ts

@@ -0,0 +1,47 @@
+import { tool, type ToolDefinition } from "@convex-dev/mcp";
+import { makeFunctionReference as reference } from "convex/server";
+import type { GenericValidator, PropertyValidators } from "convex/values";
+
+type PlatformFunction = {
+  isInternal?: boolean;
+  isQuery?: boolean;
+  isMutation?: boolean;
+  mcp?: boolean;
+  args: PropertyValidators;
+  returns: GenericValidator;
+};
+
+/** Adapt opted-in internal functions without duplicating their validators. */
+export function createMcpTools(
+  modules: Record<string, Record<string, unknown>>,
+) {
+  const tools: Record<string, ToolDefinition> = Object.create(null);
+  for (const [path, exports] of Object.entries(modules)) {
+    for (const [exportName, value] of Object.entries(exports)) {
+      const fn = value as PlatformFunction | null;
+      if (!fn?.isInternal || !fn.mcp) continue;
+      const id = `${path}:${exportName}`;
+      const name = id.replace(/[^A-Za-z0-9_.-]/g, "_");
+      if (Object.hasOwn(tools, name))
+        throw new Error(`Duplicate MCP tool name: ${name}`);
+      const { userId, ...args } = fn.args;
+      tools[name] = tool({
+        description: `Call ${id}.`,
+        ...(fn.isQuery ? { annotations: { readOnlyHint: true } } : {}),
+        args,
+        returns: fn.returns,
+        handler: async (ctx, input, user) => {
+          const params = {
+            ...input,
+            ...(userId ? { userId: user.userId } : {}),
+          };
+          if (fn.isQuery) return ctx.runQuery(reference<"query">(id), params);
+          if (fn.isMutation)
+            return ctx.runMutation(reference<"mutation">(id), params);
+          return ctx.runAction(reference<"action">(id), params);
+        },
+      });
+    }
+  }
+  return tools;
+}

package/dist/templates/default/packages/disposabl-kit/server/lib/platforms.ts

@@ -0,0 +1,20 @@
+import config from "../../../../disposabl.json";
+
+export type Platforms = boolean | { api?: boolean; mcp?: boolean };
+
+/** The generated app config is the source of truth for enabled transports. */
+export function getPlatforms() {
+  const enabled = new Set(config.platforms);
+  return {
+    isApiEnabled:
+      enabled.has("api") ||
+      enabled.has("cli") ||
+      enabled.has("python-sdk") ||
+      enabled.has("typescript-sdk"),
+    isCliEnabled: enabled.has("cli"),
+    isMcpEnabled: enabled.has("mcp"),
+    isSdkEnabled: enabled.has("python-sdk") || enabled.has("typescript-sdk"),
+    isOpenaiPluginEnabled: enabled.has("openai-plugin"),
+    isClaudePluginEnabled: enabled.has("claude-code-plugin"),
+  };
+}

package/dist/templates/default/packages/disposabl-kit/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "resolveJsonModule": true,
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "skipLibCheck": true,
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "noEmit": true,
+    "types": ["node", "vite/client"]
+  },
+  "include": [".", "../../apps/web/src/routeTree.gen.ts"],
+  "exclude": ["node_modules", "dist"]
+}