@getjack/jack 0.1.20 → 0.1.23

package/templates/CLAUDE.md

@@ -119,16 +119,18 @@ Templates can define hooks in `.jack.json` that run at specific lifecycle points
 | `url` | `url` | Prints label + URL |
 | `clipboard` | `text` | Prints text |
 | `pause` | _(none)_ | Skipped |
-| `require` | `source`, `key` | Validates, prints setup if provided |
+| `require` | `source`, `key` | Validates, prints setup if provided. Supports `onMissing: "prompt" \| "generate"` |
 | `shell` | `command` | Runs with stdin ignored |
-| `prompt` | `message` | Skipped (supports `validate: "json" | "accountAssociation"`) |
+| `prompt` | `message` | Skipped. Supports `secret: true` for masked input, `validate`, `writeJson`, `deployAfter` |
 | `writeJson` | `path`, `set` | Runs (safe in CI) |
+| `stripe-setup` | `plans` | Creates Stripe products/prices, saves price IDs to secrets |
 
 ### Hook Lifecycle
 
 ```json
 {
   "hooks": {
+    "preCreate": [...],   // During project creation (secret collection, auto-generation)
     "preDeploy": [...],   // Before wrangler deploy (validation)
     "postDeploy": [...]   // After successful deploy (notifications, testing)
   }
@@ -145,9 +147,10 @@ Templates can define hooks in `.jack.json` that run at specific lifecycle points
 | `clipboard` | Copy text to clipboard | `{"action": "clipboard", "text": "{{url}}", "message": "Copied!"}` |
 | `shell` | Execute shell command | `{"action": "shell", "command": "curl {{url}}/health"}` |
 | `pause` | Wait for Enter key | `{"action": "pause", "message": "Press Enter..."}` |
-| `require` | Verify secret or env | `{"action": "require", "source": "secret", "key": "API_KEY"}` |
-| `prompt` | Prompt for input and update JSON file | `{"action": "prompt", "message": "Paste JSON", "validate": "json", "successMessage": "Saved", "writeJson": {"path": "public/data.json", "set": {"data": {"from": "input"}}}}` |
+| `require` | Verify secret/env, optionally prompt or generate | `{"action": "require", "source": "secret", "key": "API_KEY", "onMissing": "prompt"}` |
+| `prompt` | Prompt for input, optionally masked | `{"action": "prompt", "message": "Secret:", "secret": true, "writeJson": {...}}` |
 | `writeJson` | Update JSON file with template vars | `{"action": "writeJson", "path": "public/data.json", "set": {"siteUrl": "{{url}}"}}` |
+| `stripe-setup` | Create Stripe products/prices | `{"action": "stripe-setup", "plans": [{"name": "Pro", "priceKey": "STRIPE_PRO_PRICE_ID", "amount": 1900, "interval": "month"}]}` |
 
 ### Non-Interactive Mode
 
@@ -169,7 +172,7 @@ These variables are substituted at runtime (different from template placeholders
 |----------|-------|--------------|
 | `{{url}}` | Full deployed URL | postDeploy |
 | `{{domain}}` | Domain without protocol | postDeploy |
-| `{{name}}` | Project name | preDeploy, postDeploy |
+| `{{name}}` | Project name | preCreate, preDeploy, postDeploy |
 
 ### Example: API Template Hooks
 
@@ -205,13 +208,13 @@ These variables are substituted at runtime (different from template placeholders
 }
 ```
 
-### Proposed Hook Extensions
+### Advanced Hook Features
 
-These extensions are planned to support more complex setup wizards (like SaaS templates with Stripe):
+These features support complex setup wizards (like the SaaS template with Stripe):
 
-#### 1. `require` + `onMissing: "prompt"`
+#### 1. `require` + `onMissing: "prompt" | "generate"`
 
-Currently `require` fails if a secret is missing. This extension allows prompting the user instead:
+The `require` action supports automatic secret collection when a secret is missing:
 
 ```json
 {
@@ -225,88 +228,149 @@ Currently `require` fails if a secret is missing. This extension allows promptin
 ```
 
 **Behavior:**
-- If secret exists → continue (no change)
+- If secret exists → continue (shows "Using saved KEY")
 - If secret missing + interactive → prompt user, save to `.secrets.json`
 - If secret missing + non-interactive → fail with setup instructions
 
-#### 2. `shell` + `captureAs`
-
-Run a command and save its output as a secret or variable:
+**Auto-generate secrets with `onMissing: "generate"`:**
 
 ```json
 {
-  "action": "shell",
-  "command": "stripe listen --print-secret",
-  "captureAs": "secret:STRIPE_WEBHOOK_SECRET",
-  "message": "Starting Stripe webhook listener..."
+  "action": "require",
+  "source": "secret",
+  "key": "BETTER_AUTH_SECRET",
+  "message": "Generating authentication secret...",
+  "onMissing": "generate",
+  "generateCommand": "openssl rand -base64 32"
 }
 ```
 
-**Use cases:**
-- Capture Stripe CLI webhook signing secret
-- Capture generated API keys or tokens
-- Capture any CLI output needed for configuration
+This runs the command, captures stdout, and saves it as the secret automatically.
+
+#### 2. `stripe-setup` Action
+
+Automatically creates Stripe products and prices, saving the price IDs as secrets:
+
+```json
+{
+  "action": "stripe-setup",
+  "message": "Setting up Stripe subscription plans...",
+  "plans": [
+    {
+      "name": "Pro",
+      "priceKey": "STRIPE_PRO_PRICE_ID",
+      "amount": 1900,
+      "interval": "month",
+      "description": "Pro monthly subscription"
+    },
+    {
+      "name": "Enterprise",
+      "priceKey": "STRIPE_ENTERPRISE_PRICE_ID",
+      "amount": 9900,
+      "interval": "month"
+    }
+  ]
+}
+```
 
-**`captureAs` syntax:**
-- `secret:KEY_NAME` → saves to `.secrets.json`
-- `var:NAME` → saves to hook variables for later hooks
+**Behavior:**
+- Requires `STRIPE_SECRET_KEY` to be set first
+- Checks for existing prices by lookup key (`jack_pro_month`)
+- Creates product + price if not found
+- Saves price IDs to secrets
 
-#### 3. `prompt` + `saveAs`
+#### 3. `prompt` with `secret` Flag
 
-Currently `prompt` only writes to JSON files via `writeJson`. This extension allows saving input as a secret:
+Mask sensitive input (like API keys):
 
 ```json
 {
   "action": "prompt",
-  "message": "Enter your Stripe Webhook Secret (whsec_...):",
-  "saveAs": "secret:STRIPE_WEBHOOK_SECRET",
-  "validate": "startsWith:whsec_",
-  "successMessage": "Webhook secret saved"
+  "message": "Paste your webhook signing secret (whsec_...):",
+  "secret": true,
+  "writeJson": {
+    "path": ".secrets.json",
+    "set": { "STRIPE_WEBHOOK_SECRET": { "from": "input" } }
+  }
 }
 ```
 
-**Difference from `require+onMissing`:**
-- `require+onMissing` checks first, prompts only if missing
-- `prompt+saveAs` always prompts (for update flows or explicit input)
+#### 4. `prompt` with `deployAfter`
 
-### Design Principles for Hook Extensions
+Automatically redeploy after user provides input:
+
+```json
+{
+  "action": "prompt",
+  "message": "Paste webhook signing secret:",
+  "secret": true,
+  "deployAfter": true,
+  "deployMessage": "Deploying with webhook support...",
+  "writeJson": {
+    "path": ".secrets.json",
+    "set": { "STRIPE_WEBHOOK_SECRET": { "from": "input" } }
+  }
+}
+```
+
+### Design Principles
 
 When extending the hook system:
 
 1. **Extend existing actions** - prefer `require+onMissing` over a new `requireOrPrompt` action
-2. **Reusable primitives** - `captureAs` works on any action that produces output
-3. **Consistent syntax** - `secret:KEY` pattern for writing to `.secrets.json`
-4. **Non-interactive fallback** - every interactive feature must degrade gracefully in CI/MCP
+2. **Non-interactive fallback** - every interactive feature must degrade gracefully in CI/MCP
+3. **Secrets via `.secrets.json`** - use `writeJson` with `.secrets.json` for secret storage
 
-### Example: Complex Setup Wizard
+### Example: SaaS Template Setup Wizard
 
-A SaaS template with Stripe might use these extensions:
+The `saas` template uses `preCreate` hooks for a complete setup wizard:
 
 ```json
 {
   "hooks": {
-    "preDeploy": [
-      {"action": "require", "source": "secret", "key": "BETTER_AUTH_SECRET", "onMissing": "prompt", "promptMessage": "Enter a random secret (32+ chars):"},
-      {"action": "require", "source": "secret", "key": "STRIPE_SECRET_KEY", "onMissing": "prompt", "promptMessage": "Enter Stripe Secret Key:", "setupUrl": "https://dashboard.stripe.com/apikeys"}
+    "preCreate": [
+      {
+        "action": "require",
+        "source": "secret",
+        "key": "STRIPE_SECRET_KEY",
+        "message": "Stripe API key required for payments",
+        "setupUrl": "https://dashboard.stripe.com/apikeys",
+        "onMissing": "prompt",
+        "promptMessage": "Enter your Stripe Secret Key (sk_test_... or sk_live_...):"
+      },
+      {
+        "action": "require",
+        "source": "secret",
+        "key": "BETTER_AUTH_SECRET",
+        "message": "Generating authentication secret...",
+        "onMissing": "generate",
+        "generateCommand": "openssl rand -base64 32"
+      },
+      {
+        "action": "stripe-setup",
+        "message": "Setting up Stripe subscription plans...",
+        "plans": [
+          {"name": "Pro", "priceKey": "STRIPE_PRO_PRICE_ID", "amount": 1900, "interval": "month"},
+          {"name": "Enterprise", "priceKey": "STRIPE_ENTERPRISE_PRICE_ID", "amount": 9900, "interval": "month"}
+        ]
+      }
     ],
     "postDeploy": [
-      {"action": "box", "title": "Stripe Webhook Setup", "lines": ["1. Go to Stripe Dashboard → Webhooks", "2. Add endpoint: {{url}}/api/auth/stripe/webhook", "3. Select events: checkout.session.completed, customer.subscription.*"]},
-      {"action": "url", "url": "https://dashboard.stripe.com/webhooks/create?endpoint_url={{url}}/api/auth/stripe/webhook", "label": "Create webhook"},
-      {"action": "prompt", "message": "Paste webhook signing secret (whsec_...):", "saveAs": "secret:STRIPE_WEBHOOK_SECRET", "validate": "startsWith:whsec_"},
-      {"action": "message", "text": "Re-deploying with webhook secret..."},
-      {"action": "shell", "command": "jack ship --quiet"}
+      {"action": "box", "title": "Your SaaS is live!", "lines": ["{{url}}"]},
+      {"action": "clipboard", "text": "{{url}}/api/auth/stripe/webhook", "message": "Webhook URL copied"},
+      {"action": "prompt", "message": "Paste your webhook signing secret (whsec_...):", "secret": true, "deployAfter": true, "writeJson": {"path": ".secrets.json", "set": {"STRIPE_WEBHOOK_SECRET": {"from": "input"}}}}
     ]
   }
 }
 ```
 
 This creates a guided wizard that:
-1. Ensures auth secret exists (prompts if missing)
-2. Ensures Stripe key exists (prompts if missing, with setup link)
-3. Deploys the app
-4. Guides user through webhook setup with direct link
-5. Captures webhook secret
-6. Re-deploys with complete configuration
+1. Prompts for Stripe key (with setup URL)
+2. Auto-generates auth secret
+3. Creates Stripe products/prices automatically
+4. Deploys the app
+5. Guides through webhook setup
+6. Re-deploys with webhook secret
 
 ## Farcaster Miniapp Embeds
 

package/templates/ai-chat/.jack.json

@@ -0,0 +1,29 @@
+{
+	"name": "ai-chat",
+	"description": "AI chat with streaming UI (free Cloudflare AI)",
+	"secrets": [],
+	"capabilities": ["ai"],
+	"intent": {
+		"keywords": ["ai", "chat", "llm", "mistral", "completion", "chatbot"],
+		"examples": ["AI chatbot", "chat interface", "LLM chat app"]
+	},
+	"hooks": {
+		"postDeploy": [
+			{
+				"action": "clipboard",
+				"text": "{{url}}",
+				"message": "URL copied to clipboard"
+			},
+			{
+				"action": "box",
+				"title": "AI Chat: {{name}}",
+				"lines": [
+					"{{url}}",
+					"",
+					"Open in browser to start chatting!",
+					"Rate limit: 10 requests/minute"
+				]
+			}
+		]
+	}
+}

package/templates/ai-chat/bun.lock

@@ -0,0 +1,18 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "jack-template",
+      "devDependencies": {
+        "@cloudflare/workers-types": "^4.20241205.0",
+        "typescript": "^5.0.0",
+      },
+    },
+  },
+  "packages": {
+    "@cloudflare/workers-types": ["@cloudflare/workers-types@4.20260120.0", "", {}, "sha512-B8pueG+a5S+mdK3z8oKu1ShcxloZ7qWb68IEyLLaepvdryIbNC7JVPcY0bWsjS56UQVKc5fnyRge3yZIwc9bxw=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+  }
+}

package/templates/ai-chat/package.json

@@ -0,0 +1,14 @@
+{
+	"name": "jack-template",
+	"version": "0.0.1",
+	"private": true,
+	"type": "module",
+	"scripts": {
+		"dev": "wrangler dev",
+		"deploy": "wrangler deploy"
+	},
+	"devDependencies": {
+		"@cloudflare/workers-types": "^4.20241205.0",
+		"typescript": "^5.0.0"
+	}
+}

package/templates/ai-chat/public/chat.js

@@ -0,0 +1,149 @@
+const messagesEl = document.getElementById('messages');
+const inputEl = document.getElementById('input');
+const sendBtn = document.getElementById('send');
+
+let history = [];
+let isLoading = false;
+
+function setLoading(loading) {
+  isLoading = loading;
+  inputEl.disabled = loading;
+  sendBtn.disabled = loading;
+  sendBtn.textContent = loading ? '...' : 'Send';
+}
+
+function clearEmptyState() {
+  const emptyState = messagesEl.querySelector('.empty-state');
+  if (emptyState) {
+    emptyState.remove();
+  }
+}
+
+function appendMessage(role, content, className = '') {
+  clearEmptyState();
+  const el = document.createElement('div');
+  el.className = `message ${role} ${className}`.trim();
+  el.textContent = content;
+  messagesEl.appendChild(el);
+  messagesEl.scrollTop = messagesEl.scrollHeight;
+  return el;
+}
+
+async function sendMessage() {
+  const content = inputEl.value.trim();
+  if (!content || isLoading) return;
+
+  // Add user message to history and display
+  history.push({ role: 'user', content });
+  appendMessage('user', content);
+  inputEl.value = '';
+
+  // Create assistant message placeholder
+  const assistantEl = appendMessage('assistant', '', 'typing');
+  setLoading(true);
+
+  try {
+    const response = await fetch('/api/chat', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ messages: history }),
+    });
+
+    if (!response.ok) {
+      let errorMessage = 'Something went wrong. Please try again.';
+      try {
+        const err = await response.json();
+        if (err.error) {
+          errorMessage = err.error;
+        }
+      } catch {
+        // Use default error message
+      }
+      assistantEl.textContent = errorMessage;
+      assistantEl.className = 'message assistant error';
+      setLoading(false);
+      return;
+    }
+
+    // Stream response
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let assistantContent = '';
+    let buffer = '';
+
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+
+      buffer += decoder.decode(value, { stream: true });
+
+      // Process complete SSE messages
+      const lines = buffer.split('\n');
+      // Keep the last potentially incomplete line in the buffer
+      buffer = lines.pop() || '';
+
+      for (const line of lines) {
+        if (line.startsWith('data: ')) {
+          const data = line.slice(6).trim();
+          if (data === '[DONE]') continue;
+
+          try {
+            const parsed = JSON.parse(data);
+            if (parsed.response) {
+              assistantContent += parsed.response;
+              assistantEl.textContent = assistantContent;
+              assistantEl.className = 'message assistant';
+              messagesEl.scrollTop = messagesEl.scrollHeight;
+            }
+          } catch {
+            // Skip malformed JSON chunks
+          }
+        }
+      }
+    }
+
+    // Process any remaining buffer content
+    if (buffer.startsWith('data: ')) {
+      const data = buffer.slice(6).trim();
+      if (data && data !== '[DONE]') {
+        try {
+          const parsed = JSON.parse(data);
+          if (parsed.response) {
+            assistantContent += parsed.response;
+            assistantEl.textContent = assistantContent;
+            assistantEl.className = 'message assistant';
+          }
+        } catch {
+          // Skip malformed JSON
+        }
+      }
+    }
+
+    // Save to history if we got content
+    if (assistantContent) {
+      history.push({ role: 'assistant', content: assistantContent });
+    } else {
+      assistantEl.textContent = 'No response received. Please try again.';
+      assistantEl.className = 'message assistant error';
+    }
+  } catch (err) {
+    console.error('Chat error:', err);
+    assistantEl.textContent = 'Connection error. Please check your network and try again.';
+    assistantEl.className = 'message assistant error';
+  }
+
+  setLoading(false);
+  inputEl.focus();
+}
+
+// Event listeners
+sendBtn.addEventListener('click', sendMessage);
+inputEl.addEventListener('keypress', (e) => {
+  if (e.key === 'Enter' && !e.shiftKey) {
+    e.preventDefault();
+    sendMessage();
+  }
+});
+
+// Focus input on load
+inputEl.focus();

package/templates/ai-chat/public/index.html

@@ -0,0 +1,209 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>AI Chat</title>
+  <style>
+    * {
+      box-sizing: border-box;
+      margin: 0;
+      padding: 0;
+    }
+
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, sans-serif;
+      background: #f5f5f5;
+      min-height: 100vh;
+      display: flex;
+      justify-content: center;
+      padding: 1rem;
+    }
+
+    .chat-container {
+      width: 100%;
+      max-width: 700px;
+      display: flex;
+      flex-direction: column;
+      height: calc(100vh - 2rem);
+    }
+
+    header {
+      text-align: center;
+      padding: 1rem;
+    }
+
+    header h1 {
+      font-size: 1.5rem;
+      color: #333;
+      margin-bottom: 0.25rem;
+    }
+
+    header p {
+      font-size: 0.875rem;
+      color: #666;
+    }
+
+    .messages {
+      flex: 1;
+      overflow-y: auto;
+      padding: 1rem;
+      background: white;
+      border-radius: 12px;
+      margin-bottom: 1rem;
+      box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+    }
+
+    .message {
+      padding: 0.75rem 1rem;
+      margin-bottom: 0.75rem;
+      border-radius: 12px;
+      max-width: 85%;
+      line-height: 1.5;
+      word-wrap: break-word;
+    }
+
+    .message.user {
+      background: #007bff;
+      color: white;
+      margin-left: auto;
+      border-bottom-right-radius: 4px;
+    }
+
+    .message.assistant {
+      background: #e9ecef;
+      color: #333;
+      margin-right: auto;
+      border-bottom-left-radius: 4px;
+    }
+
+    .message.error {
+      background: #fee;
+      color: #c00;
+      border: 1px solid #fcc;
+    }
+
+    .message.typing {
+      color: #666;
+      font-style: italic;
+    }
+
+    .input-area {
+      display: flex;
+      gap: 0.5rem;
+      background: white;
+      padding: 1rem;
+      border-radius: 12px;
+      box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+    }
+
+    .input-area input {
+      flex: 1;
+      padding: 0.75rem 1rem;
+      border: 1px solid #ddd;
+      border-radius: 8px;
+      font-size: 1rem;
+      outline: none;
+      transition: border-color 0.2s;
+    }
+
+    .input-area input:focus {
+      border-color: #007bff;
+    }
+
+    .input-area input:disabled {
+      background: #f5f5f5;
+      cursor: not-allowed;
+    }
+
+    .input-area button {
+      padding: 0.75rem 1.5rem;
+      background: #007bff;
+      color: white;
+      border: none;
+      border-radius: 8px;
+      font-size: 1rem;
+      cursor: pointer;
+      transition: background 0.2s;
+    }
+
+    .input-area button:hover:not(:disabled) {
+      background: #0056b3;
+    }
+
+    .input-area button:disabled {
+      background: #ccc;
+      cursor: not-allowed;
+    }
+
+    .empty-state {
+      text-align: center;
+      color: #999;
+      padding: 3rem 1rem;
+    }
+
+    .empty-state p {
+      font-size: 1.1rem;
+      margin-bottom: 0.5rem;
+    }
+
+    .empty-state small {
+      font-size: 0.875rem;
+    }
+
+    @media (max-width: 480px) {
+      body {
+        padding: 0.5rem;
+      }
+
+      .chat-container {
+        height: calc(100vh - 1rem);
+      }
+
+      header h1 {
+        font-size: 1.25rem;
+      }
+
+      .message {
+        max-width: 90%;
+        padding: 0.625rem 0.875rem;
+      }
+
+      .input-area {
+        padding: 0.75rem;
+      }
+
+      .input-area button {
+        padding: 0.75rem 1rem;
+      }
+    }
+  </style>
+</head>
+<body>
+  <div class="chat-container">
+    <header>
+      <h1>AI Chat</h1>
+      <p>Powered by Cloudflare AI (Mistral 7B)</p>
+    </header>
+
+    <div id="messages" class="messages">
+      <div class="empty-state">
+        <p>Start a conversation</p>
+        <small>Type a message below to begin</small>
+      </div>
+    </div>
+
+    <div class="input-area">
+      <input
+        type="text"
+        id="input"
+        placeholder="Type your message..."
+        autocomplete="off"
+      />
+      <button id="send">Send</button>
+    </div>
+  </div>
+
+  <script src="/chat.js"></script>
+</body>
+</html>