@getjack/jack 0.1.12 → 0.1.14

package/src/lib/project-resolver.ts

@@ -373,6 +373,18 @@ export async function listAllProjects(): Promise<ResolvedProject[]> {
 					projectMap.set(managed.id, resolved);
 				}
 			}
+
+			// Mark orphaned local managed projects (not found on control plane) as errors
+			for (const [, project] of projectMap) {
+				if (
+					project.deployMode === "managed" &&
+					project.status === "syncing" &&
+					!project.sources.controlPlane
+				) {
+					project.status = "error";
+					project.errorMessage = "Project not found in jack cloud. Run: jack unlink && jack ship";
+				}
+			}
 		} catch {
 			// Control plane unavailable, use local-only data
 		}

package/src/lib/telemetry.ts

@@ -12,6 +12,7 @@ const SESSION_ID = crypto.randomUUID();
 // EVENT REGISTRY
 // ============================================
 export const Events = {
+	AUTH_GATE_RESOLVED: "auth_gate_resolved",
 	COMMAND_INVOKED: "command_invoked",
 	COMMAND_COMPLETED: "command_completed",
 	COMMAND_FAILED: "command_failed",

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

@@ -1,17 +1,17 @@
 {
-  "accountAssociation": {
-    "header": "",
-    "payload": "",
-    "signature": ""
-  },
-  "miniapp": {
-    "version": "1",
-    "name": "jack-template",
-    "iconUrl": "https://example.com/icon.png",
-    "homeUrl": "https://example.com",
-    "imageUrl": "https://example.com/og.png",
-    "buttonTitle": "Open App",
-    "splashImageUrl": "https://example.com/icon.png",
-    "splashBackgroundColor": "#0a0a0a"
-  }
+	"accountAssociation": {
+		"header": "",
+		"payload": "",
+		"signature": ""
+	},
+	"frame": {
+		"version": "1",
+		"name": "jack-template",
+		"iconUrl": "https://example.com/icon.png",
+		"homeUrl": "https://example.com",
+		"imageUrl": "https://example.com/og.png",
+		"buttonTitle": "Open App",
+		"splashImageUrl": "https://example.com/icon.png",
+		"splashBackgroundColor": "#0a0a0a"
+	}
 }

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";
@@ -53,11 +54,7 @@ function getBaseUrl(
 		}
 
 		// Reject localhost or IPs - embeds won't work in local dev or IP domains
-		if (
-			hostname === "localhost" ||
-			hostname === "127.0.0.1" ||
-			isIpAddress(hostname)
-		) {
+		if (hostname === "localhost" || hostname === "127.0.0.1" || isIpAddress(hostname)) {
 			return null; // Signal that we can't generate valid embed URLs
 		}
 
@@ -628,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));