@getjack/jack 0.1.13 → 0.1.15

package/src/mcp/tools/index.ts

@@ -4,6 +4,8 @@ import { z } from "zod";
 import { JackError, JackErrorCode } from "../../lib/errors.ts";
 import { createProject, deployProject, getProjectStatus } from "../../lib/project-operations.ts";
 import { listAllProjects } from "../../lib/project-resolver.ts";
+import { createDatabase } from "../../lib/services/db-create.ts";
+import { listDatabases } from "../../lib/services/db-list.ts";
 import { Events, track, withTelemetry } from "../../lib/telemetry.ts";
 import type { DebugLogger, McpServerOptions } from "../types.ts";
 import { formatErrorResponse, formatSuccessResponse } from "../utils.ts";
@@ -36,6 +38,21 @@ const ListProjectsSchema = z.object({
 		.describe("Filter projects by status (defaults to 'all')"),
 });
 
+const CreateDatabaseSchema = z.object({
+	name: z.string().optional().describe("Database name (auto-generated if not provided)"),
+	project_path: z
+		.string()
+		.optional()
+		.describe("Path to project directory (defaults to current directory)"),
+});
+
+const ListDatabasesSchema = z.object({
+	project_path: z
+		.string()
+		.optional()
+		.describe("Path to project directory (defaults to current directory)"),
+});
+
 export function registerTools(server: McpServer, _options: McpServerOptions, debug: DebugLogger) {
 	// Register tool list handler
 	server.setRequestHandler(ListToolsRequestSchema, async () => {
@@ -107,6 +124,37 @@ export function registerTools(server: McpServer, _options: McpServerOptions, deb
 						},
 					},
 				},
+				{
+					name: "create_database",
+					description:
+						"Create a D1 database for a project. Returns deploy_required=true since binding needs deploy to activate.",
+					inputSchema: {
+						type: "object",
+						properties: {
+							name: {
+								type: "string",
+								description: "Database name (auto-generated if not provided)",
+							},
+							project_path: {
+								type: "string",
+								description: "Path to project directory (defaults to current directory)",
+							},
+						},
+					},
+				},
+				{
+					name: "list_databases",
+					description: "List all D1 databases for a project.",
+					inputSchema: {
+						type: "object",
+						properties: {
+							project_path: {
+								type: "string",
+								description: "Path to project directory (defaults to current directory)",
+							},
+						},
+					},
+				},
 			],
 		};
 	});
@@ -195,7 +243,15 @@ export function registerTools(server: McpServer, _options: McpServerOptions, deb
 					const wrappedGetProjectStatus = withTelemetry(
 						"get_project_status",
 						async (name?: string, projectPath?: string) => {
-							return await getProjectStatus(name, projectPath);
+							const status = await getProjectStatus(name, projectPath);
+							if (status === null) {
+								return null;
+							}
+							// Add available_services to tell agents what services can be created
+							return {
+								...status,
+								available_services: ["d1", "kv", "r2"],
+							};
 						},
 						{ platform: "mcp" },
 					);
@@ -259,6 +315,80 @@ export function registerTools(server: McpServer, _options: McpServerOptions, deb
 					};
 				}
 
+				case "create_database": {
+					const args = CreateDatabaseSchema.parse(request.params.arguments ?? {});
+					const projectPath = args.project_path ?? process.cwd();
+
+					const wrappedCreateDatabase = withTelemetry(
+						"create_database",
+						async (projectDir: string, name?: string) => {
+							const result = await createDatabase(projectDir, {
+								name,
+								interactive: false,
+							});
+
+							// Track business event
+							track(Events.SERVICE_CREATED, {
+								service_type: "d1",
+								platform: "mcp",
+							});
+
+							return {
+								database_name: result.databaseName,
+								database_id: result.databaseId,
+								binding_name: result.bindingName,
+								created: result.created,
+								deploy_required: true,
+							};
+						},
+						{ platform: "mcp" },
+					);
+
+					const result = await wrappedCreateDatabase(projectPath, args.name);
+
+					return {
+						content: [
+							{
+								type: "text",
+								text: JSON.stringify(formatSuccessResponse(result, startTime), null, 2),
+							},
+						],
+					};
+				}
+
+				case "list_databases": {
+					const args = ListDatabasesSchema.parse(request.params.arguments ?? {});
+					const projectPath = args.project_path ?? process.cwd();
+
+					const wrappedListDatabases = withTelemetry(
+						"list_databases",
+						async (projectDir: string) => {
+							const databases = await listDatabases(projectDir);
+							return {
+								databases: databases.map((db) => ({
+									name: db.name,
+									binding: db.binding,
+									id: db.id,
+									size_bytes: db.sizeBytes,
+									num_tables: db.numTables,
+								})),
+							};
+						},
+						{ platform: "mcp" },
+					);
+
+					const result = await wrappedListDatabases(projectPath);
+
+					return {
+						content: [
+							{
+								type: "text",
+								text: JSON.stringify(formatSuccessResponse(result, startTime), null, 2),
+							},
+						],
+					};
+				}
+
 				default:
 					throw new Error(`Unknown tool: ${toolName}`);
 			}

package/templates/miniapp/.jack.json

@@ -50,11 +50,11 @@
 				"path": "public/.well-known/farcaster.json",
 				"successMessage": "Updated manifest URLs to {{url}}",
 				"set": {
-					"miniapp.name": "{{name}}",
-					"miniapp.homeUrl": "{{url}}",
-					"miniapp.iconUrl": "{{url}}/icon.png",
-					"miniapp.imageUrl": "{{url}}/og.png",
-					"miniapp.splashImageUrl": "{{url}}/icon.png"
+					"frame.name": "{{name}}",
+					"frame.homeUrl": "{{url}}",
+					"frame.iconUrl": "{{url}}/icon.png",
+					"frame.imageUrl": "{{url}}/og.png",
+					"frame.splashImageUrl": "{{url}}/icon.png"
 				}
 			},
 			{

package/templates/miniapp/public/.well-known/farcaster.json

@@ -4,7 +4,7 @@
 		"payload": "",
 		"signature": ""
 	},
-	"miniapp": {
+	"frame": {
 		"version": "1",
 		"name": "jack-template",
 		"iconUrl": "https://example.com/icon.png",

package/templates/miniapp/src/lib/api.ts

@@ -1,6 +1,74 @@
 import { hc } from "hono/client";
 import type { AppType } from "../worker";
 
-// Type-safe API client powered by Hono RPC
-type ApiClient = ReturnType<typeof hc<AppType>>;
-export const api: ApiClient = hc<AppType>("/");
+// Create Hono RPC client
+// Note: Type inference may show 'unknown' in IDE but works at runtime
+// The explicit response types below ensure type safety for API consumers
+const client = hc<AppType>("/");
+
+// Export typed client - if AppType inference fails, these explicit types provide safety
+export const api = client as {
+	api: {
+		guestbook: {
+			$get: () => Promise<
+				Response & {
+					json: () => Promise<{
+						entries: Array<{
+							id: number;
+							fid: number;
+							username: string;
+							display_name: string | null;
+							pfp_url: string | null;
+							message: string;
+							created_at: string;
+						}>;
+					}>;
+				}
+			>;
+			$post: (options: {
+				json: {
+					fid: number;
+					username: string;
+					displayName?: string;
+					pfpUrl?: string;
+					message: string;
+				};
+			}) => Promise<
+				Response & {
+					json: () => Promise<{
+						entry?: {
+							id: number;
+							fid: number;
+							username: string;
+							display_name: string | null;
+							pfp_url: string | null;
+							message: string;
+							created_at: string;
+						};
+						error?: string;
+					}>;
+				}
+			>;
+		};
+		ai: {
+			generate: {
+				$post: (options: {
+					json: { prompt: string; schema?: object };
+				}) => Promise<
+					Response & {
+						json: () => Promise<{
+							result?: string;
+							provider?: "openai" | "workers-ai";
+							error?: string;
+						}>;
+					}
+				>;
+			};
+		};
+		notifications: {
+			$get: (options?: {
+				query: { fid: string };
+			}) => Promise<Response & { json: () => Promise<unknown> }>;
+		};
+	};
+};

package/templates/miniapp/src/worker.ts

@@ -1,4 +1,5 @@
 // Server-side Worker - handles API routes, keeps secrets secure
+/// <reference types="@cloudflare/workers-types" />
 
 import { Hono } from "hono";
 import { cors } from "hono/cors";
@@ -624,6 +625,49 @@ app.get("/share", (c) => {
 	});
 });
 
+// GET / - Inject fc:miniapp meta tags for Farcaster embeds on the main page
+// Without this, sharing the app URL in a cast won't render an embed card
+app.get("/", async (c) => {
+	// Fetch the static index.html from Vite build
+	const response = await c.env.ASSETS.fetch(c.req.raw);
+	const html = await response.text();
+
+	const baseUrl = getBaseUrl(c.env, c);
+
+	// Local dev - serve without meta tags (they require https URLs)
+	if (!baseUrl) {
+		return c.html(html);
+	}
+
+	// Build embed JSON (same structure as /share route)
+	const embedJson = JSON.stringify({
+		version: "1",
+		imageUrl: `${baseUrl}/og.png`,
+		button: {
+			title: "Open App",
+			action: {
+				type: "launch_miniapp",
+				name: "jack-template",
+				url: baseUrl,
+				splashImageUrl: `${baseUrl}/icon.png`,
+				splashBackgroundColor: "#0a0a0a",
+			},
+		},
+	});
+
+	// Meta tags to inject
+	const metaTags = `
+    <meta property="og:title" content="jack-template" />
+    <meta property="og:image" content="${baseUrl}/og.png" />
+    <meta name="fc:miniapp" content='${embedJson}' />
+    <meta name="fc:frame" content='${embedJson}' />
+  `;
+
+	// Inject before </head>
+	const injectedHtml = html.replace("</head>", `${metaTags}</head>`);
+	return c.html(injectedHtml);
+});
+
 // Serve React app for all other routes
 app.get("*", (c) => c.env.ASSETS.fetch(c.req.raw));