create-githat-app 1.8.6 → 1.8.8

package/dist/cli.js

@@ -21,7 +21,7 @@ var DEPS = {
       next: "^16.0.0",
       react: "^19.0.0",
       "react-dom": "^19.0.0",
-      "@githat/nextjs": "^0.13.3",
+      "@githat/nextjs": "^0.13.5",
       "@githat/ui": "^1.0.0"
     },
     devDependencies: {
@@ -36,7 +36,7 @@ var DEPS = {
       react: "^19.0.0",
       "react-dom": "^19.0.0",
       "react-router-dom": "^7.0.0",
-      "@githat/nextjs": "^0.13.3",
+      "@githat/nextjs": "^0.13.5",
       "@githat/ui": "^1.0.0"
     },
     devDependencies: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-githat-app",
-  "version": "1.8.6",
+  "version": "1.8.8",
   "description": "GitHat CLI — scaffold apps and manage the skills marketplace",
   "type": "module",
   "bin": {

package/templates/agent/app/account/files/page.tsx.hbs

@@ -0,0 +1,241 @@
+'use client';
+
+import { useEffect, useState, useRef } from 'react';
+import { useStorage, StorageDropzone } from '@githat/nextjs';
+import type { StorageObject } from '@githat/nextjs';
+
+/**
+ * /account/files — File storage for {{businessName}}.
+ *
+ * Lists uploaded files with download links. Uses <StorageDropzone/>
+ * for browser-direct uploads to S3 via the GitHat storage API.
+ * Works with Next.js static export — no server actions required.
+ */
+export default function FilesPage() {
+  const { list, getUrl, remove } = useStorage();
+  const [files, setFiles] = useState<StorageObject[]>([]);
+  const [nextCursor, setNextCursor] = useState<string | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+  const [deletingId, setDeletingId] = useState<string | null>(null);
+
+  async function load(cursor?: string) {
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await list({ limit: 20, cursor });
+      if (cursor) {
+        setFiles((prev) => [...prev, ...result.items]);
+      } else {
+        setFiles(result.items);
+      }
+      setNextCursor(result.nextCursor);
+    } catch (err: unknown) {
+      setError(err instanceof Error ? err.message : 'Failed to load files');
+    } finally {
+      setLoading(false);
+    }
+  }
+
+  useEffect(() => { load(); }, []);
+
+  async function handleDownload(objectId: string) {
+    try {
+      const obj = await getUrl(objectId);
+      if (obj.downloadUrl) {
+        window.open(obj.downloadUrl, '_blank', 'noopener,noreferrer');
+      }
+    } catch (err: unknown) {
+      setError(err instanceof Error ? err.message : 'Failed to get download URL');
+    }
+  }
+
+  async function handleDelete(objectId: string) {
+    if (!confirm('Delete this file? This cannot be undone.')) return;
+    setDeletingId(objectId);
+    try {
+      await remove(objectId);
+      setFiles((prev) => prev.filter((f) => f.objectId !== objectId));
+    } catch (err: unknown) {
+      setError(err instanceof Error ? err.message : 'Failed to delete file');
+    } finally {
+      setDeletingId(null);
+    }
+  }
+
+  function formatBytes(bytes: number): string {
+    if (bytes < 1024) return `${bytes} B`;
+    if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+  }
+
+  return (
+    <main
+      style=\{{
+        maxWidth: '720px',
+        margin: '0 auto',
+        padding: 'var(--space-8, 2rem) var(--space-4, 1rem)',
+        color: 'var(--fg, #111)',
+      }}
+    >
+      <header style=\{{ marginBottom: '1.5rem' }}>
+        <h1 style=\{{ fontSize: '1.875rem', fontWeight: 700, margin: 0 }}>Files</h1>
+        <p style=\{{ color: 'var(--fg-muted, #666)', marginTop: '0.25rem' }}>
+          Upload and manage files in your {{businessName}} account.
+        </p>
+      </header>
+
+      {/* Upload dropzone */}
+      <StorageDropzone
+        accept="image/*,application/pdf,text/*"
+        onUpload={() => load()}
+        onError={(err) => setError(err.message)}
+        uploadOptions=\{{ isPublic: false }}
+        style=\{{ marginBottom: '1.5rem' }}
+      />
+
+      {error && (
+        <div
+          style=\{{
+            padding: '0.75rem 1rem',
+            background: '#fef2f2',
+            border: '1px solid #fecaca',
+            borderRadius: '6px',
+            color: '#dc2626',
+            marginBottom: '1rem',
+          }}
+        >
+          {error}
+        </div>
+      )}
+
+      {loading && files.length === 0 ? (
+        <p style=\{{ color: 'var(--fg-muted, #666)' }}>Loading files...</p>
+      ) : files.length === 0 ? (
+        <p style=\{{ color: 'var(--fg-muted, #666)', textAlign: 'center', padding: '2rem 0' }}>
+          No files uploaded yet. Drop a file above to get started.
+        </p>
+      ) : (
+        <div style=\{{ display: 'flex', flexDirection: 'column', gap: '0.625rem' }}>
+          {files.map((file) => (
+            <div
+              key={file.objectId}
+              style=\{{
+                display: 'flex',
+                alignItems: 'center',
+                gap: '0.75rem',
+                padding: '0.875rem 1rem',
+                border: '1px solid var(--border, #e5e7eb)',
+                borderRadius: '8px',
+              }}
+            >
+              {/* File icon */}
+              <svg
+                width="20"
+                height="20"
+                viewBox="0 0 24 24"
+                fill="none"
+                stroke="#9ca3af"
+                strokeWidth="1.5"
+                strokeLinecap="round"
+                strokeLinejoin="round"
+                style=\{{ flexShrink: 0 }}
+                aria-hidden
+              >
+                <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z" />
+                <polyline points="14 2 14 8 20 8" />
+              </svg>
+
+              {/* File info */}
+              <div style=\{{ flex: 1, minWidth: 0 }}>
+                <p
+                  style=\{{
+                    margin: 0,
+                    fontWeight: 500,
+                    fontSize: '0.9rem',
+                    overflow: 'hidden',
+                    textOverflow: 'ellipsis',
+                    whiteSpace: 'nowrap',
+                  }}
+                >
+                  {file.objectKey}
+                </p>
+                <p style=\{{ margin: '0.125rem 0 0', fontSize: '0.78rem', color: 'var(--fg-muted, #666)' }}>
+                  {formatBytes(file.size)} · {file.contentType} ·{' '}
+                  {new Date(file.uploadedAt).toLocaleDateString()}
+                  {file.isPublic && (
+                    <span
+                      style=\{{
+                        marginLeft: '0.5rem',
+                        padding: '0.1rem 0.4rem',
+                        background: '#dcfce7',
+                        color: '#16a34a',
+                        borderRadius: '4px',
+                        fontSize: '0.7rem',
+                        fontWeight: 600,
+                      }}
+                    >
+                      Public
+                    </span>
+                  )}
+                </p>
+              </div>
+
+              {/* Actions */}
+              <div style=\{{ display: 'flex', gap: '0.5rem', flexShrink: 0 }}>
+                <button
+                  onClick={() => handleDownload(file.objectId)}
+                  style=\{{
+                    padding: '0.35rem 0.75rem',
+                    fontSize: '0.825rem',
+                    border: '1px solid var(--border, #e5e7eb)',
+                    borderRadius: '6px',
+                    background: 'transparent',
+                    cursor: 'pointer',
+                  }}
+                  aria-label={`Download ${file.objectKey}`}
+                >
+                  Download
+                </button>
+                <button
+                  onClick={() => handleDelete(file.objectId)}
+                  disabled={deletingId === file.objectId}
+                  style=\{{
+                    padding: '0.35rem 0.75rem',
+                    fontSize: '0.825rem',
+                    border: '1px solid #fecaca',
+                    borderRadius: '6px',
+                    background: 'transparent',
+                    color: '#dc2626',
+                    cursor: deletingId === file.objectId ? 'not-allowed' : 'pointer',
+                  }}
+                  aria-label={`Delete ${file.objectKey}`}
+                >
+                  {deletingId === file.objectId ? '...' : 'Delete'}
+                </button>
+              </div>
+            </div>
+          ))}
+
+          {nextCursor && (
+            <button
+              onClick={() => load(nextCursor)}
+              disabled={loading}
+              style=\{{
+                padding: '0.6rem 1.25rem',
+                marginTop: '0.5rem',
+                border: '1px solid var(--border, #e5e7eb)',
+                borderRadius: '6px',
+                background: 'transparent',
+                cursor: loading ? 'not-allowed' : 'pointer',
+                fontSize: '0.875rem',
+              }}
+            >
+              {loading ? 'Loading...' : 'Load more'}
+            </button>
+          )}
+        </div>
+      )}
+    </main>
+  );
+}

package/templates/agent/app/billing/page.tsx.hbs

@@ -0,0 +1,158 @@
+'use client';
+
+import { useEffect, useState, useCallback } from 'react';
+import { useAuth, useAppBilling } from '@githat/nextjs';
+import type { AppBillingStatus } from '@githat/nextjs';
+
+/**
+ * /billing — Subscription management for {{businessName}} end-users.
+ *
+ * Lets your users manage their subscription on your app. Backed by
+ * Stripe Connect — charges go to your connected Stripe account and
+ * GitHat takes a small platform fee.
+ *
+ * Usage:
+ *  1. Complete Stripe Connect onboarding in the GitHat dashboard
+ *     (Apps → your app → Billing → Connect Stripe).
+ *  2. This page shows users a "Manage subscription" button that
+ *     opens the Stripe Customer Portal in their name.
+ *
+ * For new subscriptions, call createCheckout() from useAppBilling()
+ * with the relevant Stripe price IDs for your plans.
+ */
+export default function BillingPage() {
+  const { user, org } = useAuth();
+  const appId = process.env.NEXT_PUBLIC_GITHAT_APP_ID || '';
+  const orgId = org?.id || '';
+
+  const { getStatus, connectOnboarding, openPortal } = useAppBilling(appId, orgId);
+
+  const [status, setStatus] = useState<AppBillingStatus | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+  const [portalLoading, setPortalLoading] = useState(false);
+
+  const load = useCallback(async () => {
+    if (!appId || !orgId) return;
+    setLoading(true);
+    setError(null);
+    try {
+      const data = await getStatus();
+      setStatus(data);
+    } catch (err: unknown) {
+      setError(err instanceof Error ? err.message : 'Failed to load billing info');
+    } finally {
+      setLoading(false);
+    }
+  }, [getStatus, appId, orgId]);
+
+  useEffect(() => {
+    if (user) load();
+  }, [user, load]);
+
+  async function handlePortal() {
+    if (!user) return;
+    setPortalLoading(true);
+    setError(null);
+    try {
+      // In a real app, pass the Stripe customer ID for this user.
+      // You would look this up from your database or pass it as a prop.
+      const customerId = (user as Record<string, unknown>).stripeCustomerId as string | undefined;
+      if (!customerId) {
+        setError('No billing account found. Subscribe to a plan first.');
+        return;
+      }
+      const { url } = await openPortal({ customerId });
+      window.location.href = url;
+    } catch (err: unknown) {
+      setError(err instanceof Error ? err.message : 'Failed to open billing portal');
+    } finally {
+      setPortalLoading(false);
+    }
+  }
+
+  if (!user) {
+    return (
+      <div style={{ padding: '2rem', textAlign: 'center' }}>
+        <p>Sign in to manage your subscription.</p>
+      </div>
+    );
+  }
+
+  return (
+    <div style={{ maxWidth: '640px', margin: '0 auto', padding: '2rem 1rem' }}>
+      <h1 style={{ fontSize: '1.5rem', fontWeight: 700, marginBottom: '0.5rem' }}>
+        Billing
+      </h1>
+      <p style={{ color: '#64748b', marginBottom: '2rem' }}>
+        Manage your {{businessName}} subscription.
+      </p>
+
+      {loading && <p style={{ color: '#64748b' }}>Loading…</p>}
+
+      {error && (
+        <div
+          style={{
+            background: 'rgba(239,68,68,0.1)',
+            border: '1px solid #ef4444',
+            borderRadius: '0.5rem',
+            padding: '0.75rem 1rem',
+            color: '#ef4444',
+            marginBottom: '1rem',
+          }}
+        >
+          {error}
+        </div>
+      )}
+
+      {!loading && status && (
+        <div
+          style={{
+            border: '1px solid #e2e8f0',
+            borderRadius: '0.75rem',
+            padding: '1.5rem',
+            background: '#f8fafc',
+          }}
+        >
+          <div style={{ marginBottom: '1rem' }}>
+            <div style={{ fontSize: '0.75rem', textTransform: 'uppercase', letterSpacing: '0.05em', color: '#64748b', marginBottom: '0.25rem' }}>
+              Connect status
+            </div>
+            <div style={{ fontWeight: 600 }}>
+              {status.connected ? (
+                status.chargesEnabled ? '✅ Active — charges enabled' : '⏳ Onboarding in progress'
+              ) : '❌ Not connected'}
+            </div>
+          </div>
+
+          {status.connected && status.chargesEnabled && (
+            <button
+              onClick={handlePortal}
+              disabled={portalLoading}
+              style={{
+                background: '#7c3aed',
+                color: '#fff',
+                border: 'none',
+                borderRadius: '0.5rem',
+                padding: '0.6rem 1.25rem',
+                fontWeight: 600,
+                cursor: portalLoading ? 'default' : 'pointer',
+                opacity: portalLoading ? 0.7 : 1,
+                fontSize: '0.875rem',
+              }}
+            >
+              {portalLoading ? 'Opening portal…' : 'Manage subscription →'}
+            </button>
+          )}
+
+          {!status.connected && (
+            <p style={{ fontSize: '0.875rem', color: '#64748b', marginTop: '0.5rem' }}>
+              The app owner needs to complete Stripe Connect onboarding before subscriptions
+              can be managed here.
+            </p>
+          )}
+        </div>
+      )}
+    </div>
+  );
+}

package/templates/base/README.md.hbs

@@ -219,3 +219,122 @@ When you're ready to persist products in a backend (Postgres, DynamoDB,
 Sebastn), replace `getAvailableProducts()` in `app/page.tsx` with a
 `fetch()` to your API. The `Product` interface in `src/data/products.ts`
 stays the same so your UI components don't need to change.
+
+## File storage
+
+`/account/files` lets users upload files directly to per-app S3 buckets
+via the GitHat storage API. Files never route through the GitHat server —
+the SDK gets a presigned POST URL, uploads directly to S3, then calls
+`/storage/finalize` to record the object.
+
+```tsx
+import { useStorage, StorageDropzone } from '@githat/nextjs';
+
+const { upload, list, getUrl, remove, update } = useStorage();
+
+// Drag-drop upload UI with progress bar (no extra dependencies)
+<StorageDropzone
+  accept="image/*,application/pdf"
+  onUpload={(obj) => console.log('uploaded:', obj.objectId)}
+/>
+
+// Programmatic upload
+const obj = await upload(file, { isPublic: false, metadata: { tag: 'avatar' } });
+
+// List user's files (paginated)
+const { items, nextCursor } = await list({ prefix: 'avatars/', limit: 20 });
+
+// Get a 5-minute presigned download URL (or permanent URL for public objects)
+const { downloadUrl } = await getUrl(obj.objectId);
+```
+
+Key properties:
+- **Per-app S3 buckets** — each app gets its own bucket (`githat-storage-<hash>`)
+  with CORS configured for the app's verified domain.
+- **Static-export-friendly** — no server actions. All storage calls are
+  client-side fetches against the GitHat API.
+- **Private by default** — set `isPublic: true` for public CDN URLs.
+
+## Billing
+
+GitHat provides two billing primitives depending on who is paying whom.
+
+### Your org's GitHat plan (useBilling)
+
+Manage the org's GitHat subscription (Free → Starter $29/mo → Pro $99/mo → Enterprise).
+The `useBilling()` hook wraps `/billing/org/*`:
+
+```tsx
+import { useBilling, PricingTable } from '@githat/nextjs';
+
+const { getCurrentPlan, openCheckout, openPortal, cancel } = useBilling(org.id);
+
+// Render a full pricing table with upgrade CTAs
+<PricingTable orgId={org.id} currentPlan={plan.plan} />
+
+// Open Stripe Checkout for a plan upgrade
+const { url } = await openCheckout('pro');
+window.location.href = url;
+
+// Open the Stripe Customer Portal (card / cancellation management)
+const { url } = await openPortal();
+window.location.href = url;
+```
+
+The GitHat dashboard's `/billing` page shows the current plan, usage bars
+(apps, seats, API calls, emails vs. limits), and inline upgrade cards.
+
+### Charging your own users (useAppBilling — Stripe Connect)
+
+Customer apps can charge their own end-users through GitHat's Stripe Connect
+layer. GitHat takes a 1% platform fee; the rest goes to your connected account.
+
+```tsx
+import { useAppBilling } from '@githat/nextjs';
+
+const { getStatus, connectOnboarding, createCheckout, openPortal } =
+  useAppBilling(appId, orgId);
+
+// Start or refresh Connect onboarding
+const { url } = await connectOnboarding();
+window.location.href = url;   // user completes Stripe onboarding
+
+// Create a checkout session for an end-user
+const { url } = await createCheckout({
+  lineItems: [{ price: 'price_xxx', quantity: 1 }],
+  successUrl: 'https://yourapp.com/success',
+  cancelUrl: 'https://yourapp.com/cancel',
+});
+window.location.href = url;
+
+// Open the billing portal for an end-user
+const { url } = await openPortal({ customerId: 'cus_xxx' });
+window.location.href = url;
+```
+
+The scaffolded `/billing` route (available in most templates) renders a
+"Manage subscription" button + billing portal link for your end-users.
+
+### Usage metering
+
+Track metered events (API calls, AI tokens, storage bytes, etc.) for billing
+and analytics. Events are stored with a 90-day retention window and aggregated
+by day/month:
+
+```ts
+// Fire-and-forget from your API route or Server Action
+await fetch('https://api.githat.io/usage/track', {
+  method: 'POST',
+  headers: {
+    'X-GitHat-App-Key': process.env.GITHAT_PUBLISHABLE_KEY,
+    'Content-Type': 'application/json',
+  },
+  body: JSON.stringify({ meter: 'api.call', quantity: 1 }),
+});
+
+// Query aggregates from the dashboard or a chart component
+const data = await fetch('/api/usage?meter=api.call&granularity=day&since=2026-05-01');
+```
+
+When a Stripe Meter ID is configured for a meter in the GitHat dashboard,
+events are automatically forwarded to Stripe for usage-based pricing.