create-rudder-app 0.4.0 → 0.6.0

package/dist/templates/demos/mail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail.js","sourceRoot":"","sources":["../../../src/templates/demos/mail.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,mEAAmE;AAEnE,MAAM,UAAU,aAAa;IAC3B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmFR,CAAA;AACD,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO;;;;;;;;;;;;;;;;CAgBR,CAAA;AACD,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO;;;;;;;;;;;;;;;;GAgBN,CAAA;AACH,CAAC"}

package/dist/templates/demos/notifications.d.ts

@@ -0,0 +1,4 @@
+export declare function demosNotificationsView(): string;
+export declare function demoNotification(): string;
+export declare function demosNotificationsApiBlock(): string;
+//# sourceMappingURL=notifications.d.ts.map

package/dist/templates/demos/notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../../src/templates/demos/notifications.ts"],"names":[],"mappings":"AAGA,wBAAgB,sBAAsB,IAAI,MAAM,CAgF/C;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAiCzC;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAcnD"}

package/dist/templates/demos/notifications.js

@@ -0,0 +1,133 @@
+// Notifications demo — multi-channel notification (mail only by default;
+// add 'database' to via() once @rudderjs/notification's Prisma model is in place).
+export function demosNotificationsView() {
+    return `import { useState } from 'react'
+import '@/index.css'
+
+interface NotifyResponse {
+  ok:       boolean
+  to:       string
+  channels: string[]
+}
+
+export default function NotificationsDemo() {
+  const [to,      setTo]      = useState('user@example.com')
+  const [data,    setData]    = useState<NotifyResponse | null>(null)
+  const [loading, setLoading] = useState(false)
+  const [error,   setError]   = useState<string | null>(null)
+
+  async function notify() {
+    setLoading(true); setError(null)
+    try {
+      const res = await fetch('/api/notifications/send', {
+        method:  'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body:    JSON.stringify({ to }),
+      })
+      const body = await res.json() as NotifyResponse | { message: string }
+      if (!res.ok) throw new Error((body as { message: string }).message ?? 'Send failed')
+      setData(body as NotifyResponse)
+    } catch (e) {
+      setError((e as Error).message)
+    } finally {
+      setLoading(false)
+    }
+  }
+
+  return (
+    <div className="page">
+      <nav className="page-nav">
+        <div className="brand">
+          <span className="brand-dot" />
+          RudderJS
+        </div>
+        <div className="nav-right">
+          <a href="/demos" className="nav-link">Demos</a>
+          <a href="/" className="nav-link">Home</a>
+        </div>
+      </nav>
+
+      <section className="hero">
+        <h1 className="hero-title">Notifications</h1>
+        <p className="hero-lead">
+          Dispatches a <code className="inline-code">WelcomeNotification</code> via{' '}
+          <code className="inline-code">notify(notifiable, notification)</code>. The notification's{' '}
+          <code className="inline-code">via()</code> picks the channel(s); the mail channel routes
+          through the log driver, so output lands in the dev terminal.
+        </p>
+      </section>
+
+      <section className="feature-section" style={{ maxWidth: '32rem', margin: '0 auto' }}>
+        <div className="form-card">
+          <div style={{ marginBottom: '1rem' }}>
+            <label className="form-label" htmlFor="notify-to">Email</label>
+            <input id="notify-to" className="form-input" value={to} onChange={e => setTo(e.target.value)} />
+          </div>
+          <button className="form-submit" onClick={notify} disabled={loading}>
+            {loading ? 'Sending…' : 'Send notification'}
+          </button>
+          {error && (
+            <p className="form-error" style={{ marginTop: '1rem' }}>{error}</p>
+          )}
+          {data && (
+            <p className="form-success" style={{ marginTop: '1rem' }}>
+              Sent to <code>{data.to}</code> via <code>{data.channels.join(', ')}</code> — check the terminal.
+            </p>
+          )}
+        </div>
+      </section>
+    </div>
+  )
+}
+`;
+}
+export function demoNotification() {
+    return `import { Notification, type Notifiable } from '@rudderjs/notification'
+import { Mailable } from '@rudderjs/mail'
+
+class WelcomeMail extends Mailable {
+  constructor(private readonly notifiable: Notifiable) { super() }
+
+  build(): this {
+    return this
+      .subject(\`Welcome to RudderJS, \${this.notifiable.name ?? 'friend'}!\`)
+      .text(
+        \`Hi \${this.notifiable.name ?? 'there'},\\n\\n\` +
+        \`Your account is ready. Thanks for joining us.\\n\\n\` +
+        \`— The RudderJS Team\`,
+      )
+  }
+}
+
+/**
+ * Demo notification — single mail channel by default. Add 'database' once
+ * the Notification Prisma model is migrated, or 'broadcast' once @rudderjs/broadcast
+ * is wired up.
+ */
+export class WelcomeNotification extends Notification {
+  via(_notifiable: Notifiable): string[] {
+    return ['mail']
+  }
+
+  toMail(notifiable: Notifiable): WelcomeMail {
+    return new WelcomeMail(notifiable)
+  }
+}
+`;
+}
+export function demosNotificationsApiBlock() {
+    return `// POST /api/notifications/send — dispatches WelcomeNotification to the supplied email.
+// On-demand notifiable: no DB record required.
+router.post('/api/notifications/send', async (req, res) => {
+  const body = (req.body ?? {}) as { to?: string }
+  if (!body.to) return res.status(422).json({ message: 'Body must be { to }' })
+
+  const { notify, Notification }  = await import('@rudderjs/notification')
+  const { WelcomeNotification }   = await import('../app/Notifications/WelcomeNotification.ts')
+
+  const notification = new WelcomeNotification()
+  await notify(Notification.route('mail', body.to), notification)
+  res.json({ ok: true, to: body.to, channels: notification.via({ id: '0', email: body.to }) })
+})`;
+}
+//# sourceMappingURL=notifications.js.map

package/dist/templates/demos/notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../../../src/templates/demos/notifications.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,mFAAmF;AAEnF,MAAM,UAAU,sBAAsB;IACpC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8ER,CAAA;AACD,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BR,CAAA;AACD,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO;;;;;;;;;;;;GAYN,CAAA;AACH,CAAC"}

package/dist/templates/demos/pennant.d.ts

@@ -0,0 +1,8 @@
+export declare function demosPennantView(): string;
+export declare function demosPennantBetaView(): string;
+/**
+ * Lines added to AppServiceProvider's boot() when the pennant demo is selected.
+ * Defines the four feature shapes shown in the demo (boolean, value, scoped, lottery).
+ */
+export declare function pennantFeatureDefinitions(): string;
+//# sourceMappingURL=pennant.d.ts.map

package/dist/templates/demos/pennant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pennant.d.ts","sourceRoot":"","sources":["../../../src/templates/demos/pennant.ts"],"names":[],"mappings":"AAIA,wBAAgB,gBAAgB,IAAI,MAAM,CAqGzC;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAqB7C;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAKlD"}

package/dist/templates/demos/pennant.js

@@ -0,0 +1,138 @@
+// Pennant demo — feature flags resolved against the current user. Two routes:
+// /demos/pennant (renders the four card shapes) and /demos/pennant/beta
+// (guarded by FeatureMiddleware to demonstrate the 403 path).
+export function demosPennantView() {
+    return `import '@/index.css'
+
+interface PennantProps {
+  user:   { id: string; name: string; email: string } | null
+  values: Record<string, unknown>
+}
+
+interface FeatureCardSpec {
+  name:        string
+  shape:       string
+  resolver:    string
+  expected:    string
+}
+
+const features: FeatureCardSpec[] = [
+  { name: 'dark-mode',      shape: 'boolean', resolver: '() => true',                       expected: 'Always true.' },
+  { name: 'max-uploads',    shape: 'value',   resolver: '() => 10',                         expected: 'Returns the literal value, not a boolean.' },
+  { name: 'beta-dashboard', shape: 'scoped',  resolver: '(scope) => scope !== null',        expected: 'True for any signed-in user; false for anon.' },
+  { name: 'new-checkout',   shape: 'lottery', resolver: '() => Lottery.odds(1, 4)',         expected: '~25% chance per scope. Stable on subsequent checks.' },
+]
+
+export default function PennantDemo({ user, values }: PennantProps) {
+  return (
+    <div className="page">
+      <nav className="page-nav">
+        <div className="brand">
+          <span className="brand-dot" />
+          RudderJS
+        </div>
+        <div className="nav-right">
+          <a href="/demos" className="nav-link">Demos</a>
+          <a href="/" className="nav-link">Home</a>
+        </div>
+      </nav>
+
+      <section className="hero">
+        <h1 className="hero-title">Feature flags</h1>
+        <p className="hero-lead">
+          Resolved against the current scope ({user
+            ? <><strong>{user.name}</strong> · {user.email}</>
+            : <em>guest</em>}). Definitions live in{' '}
+          <code className="inline-code">app/Providers/AppServiceProvider.ts</code>{' '}
+          and resolution happens here via{' '}
+          <code className="inline-code">Feature.values([...], scope)</code>.
+        </p>
+        {!user && (
+          <p className="hero-meta">
+            Sign in to see <code className="inline-code">beta-dashboard</code> flip to true.
+          </p>
+        )}
+      </section>
+
+      <section className="feature-section">
+        <div className="demo-card-grid">
+          {features.map(f => {
+            const resolved = values[f.name]
+            const display  = JSON.stringify(resolved)
+            return (
+              <div key={f.name} className="demo-card">
+                <div className="demo-card-header">
+                  <h2 className="flag-name">{f.name}</h2>
+                  <p className="flag-shape">{f.shape}</p>
+                </div>
+                <div className="demo-card-body">
+                  <div className="flag-section">
+                    <div className="flag-section-label">resolver</div>
+                    <code className="code-inline-block">{f.resolver}</code>
+                  </div>
+                  <div className="flag-section">
+                    <div className="flag-section-label">expected</div>
+                    <p className="demo-card-desc">{f.expected}</p>
+                  </div>
+                  <div className="flag-resolved">
+                    <div className="flag-section-label">resolved value</div>
+                    <code className="flag-resolved-value">{display}</code>
+                  </div>
+                </div>
+              </div>
+            )
+          })}
+        </div>
+
+        <div className="demo-card" style={{ marginTop: '1.5rem' }}>
+          <div className="demo-card-header">
+            <h2 className="demo-card-title">FeatureMiddleware</h2>
+            <p className="demo-card-desc">
+              <code className="inline-code">/demos/pennant/beta</code> is wrapped in{' '}
+              <code className="inline-code">FeatureMiddleware('beta-dashboard')</code>. The middleware reads{' '}
+              <code className="inline-code">req.user</code> as the scope; non-matching scopes get a 403.
+            </p>
+          </div>
+          <a href="/demos/pennant/beta" className="button-primary" style={{ display: 'inline-block', textDecoration: 'none' }}>
+            Open /demos/pennant/beta →
+          </a>
+        </div>
+      </section>
+    </div>
+  )
+}
+`;
+}
+export function demosPennantBetaView() {
+    return `import '@/index.css'
+
+// Override the id-derived URL ('/demos/pennant-beta') so SPA nav matches the
+// controller route, which is '/demos/pennant/beta' (a sub-path under pennant).
+export const route = '/demos/pennant/beta'
+
+export default function PennantBeta() {
+  return (
+    <div className="error-wrap">
+      <h1 className="heading-lg">Beta dashboard</h1>
+      <p className="muted" style={{ maxWidth: '32rem', textAlign: 'center' }}>
+        You only see this page if <code className="inline-code">beta-dashboard</code> is active for your scope.
+        The route is wrapped in <code className="inline-code">FeatureMiddleware('beta-dashboard')</code>;
+        unauthorized scopes get a 403 before this view ever renders.
+      </p>
+      <a href="/demos/pennant" className="error-link">← Back to /demos/pennant</a>
+    </div>
+  )
+}
+`;
+}
+/**
+ * Lines added to AppServiceProvider's boot() when the pennant demo is selected.
+ * Defines the four feature shapes shown in the demo (boolean, value, scoped, lottery).
+ */
+export function pennantFeatureDefinitions() {
+    return `Feature.define('dark-mode',      () => true)
+    Feature.define('max-uploads',    () => 10)
+    Feature.define('beta-dashboard', (scope) => typeof scope === 'object' && scope !== null)
+    Feature.define('new-checkout',   () => Lottery.odds(1, 4))`;
+}
+//# sourceMappingURL=pennant.js.map

package/dist/templates/demos/pennant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pennant.js","sourceRoot":"","sources":["../../../src/templates/demos/pennant.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wEAAwE;AACxE,8DAA8D;AAE9D,MAAM,UAAU,gBAAgB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmGR,CAAA;AACD,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO;;;;;;;;;;;;;;;;;;;CAmBR,CAAA;AACD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO;;;+DAGsD,CAAA;AAC/D,CAAC"}

package/dist/templates/demos/queue.d.ts

@@ -0,0 +1,4 @@
+export declare function demosQueueView(): string;
+export declare function exampleJob(): string;
+export declare function demosQueueApiBlock(): string;
+//# sourceMappingURL=queue.d.ts.map

package/dist/templates/demos/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/templates/demos/queue.ts"],"names":[],"mappings":"AAGA,wBAAgB,cAAc,IAAI,MAAM,CAqEvC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAyBnC;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAO3C"}

package/dist/templates/demos/queue.js

@@ -0,0 +1,107 @@
+// Queue dispatch demo — Job class in app/Jobs/ + dispatch endpoint that
+// enqueues it. Default driver is in-memory; the worker drains during dev.
+export function demosQueueView() {
+    return `import { useState } from 'react'
+import '@/index.css'
+
+interface QueueResponse {
+  ok:           boolean
+  queue:        string
+  dispatchedAt: string
+}
+
+export default function QueueDemo() {
+  const [results, setResults] = useState<QueueResponse[]>([])
+  const [loading, setLoading] = useState(false)
+
+  async function dispatch() {
+    setLoading(true)
+    try {
+      const res  = await fetch('/api/queue/dispatch', { method: 'POST' })
+      const data = await res.json() as QueueResponse
+      setResults(prev => [data, ...prev].slice(0, 10))
+    } finally {
+      setLoading(false)
+    }
+  }
+
+  return (
+    <div className="page">
+      <nav className="page-nav">
+        <div className="brand">
+          <span className="brand-dot" />
+          RudderJS
+        </div>
+        <div className="nav-right">
+          <a href="/demos" className="nav-link">Demos</a>
+          <a href="/" className="nav-link">Home</a>
+        </div>
+      </nav>
+
+      <section className="hero">
+        <h1 className="hero-title">Queue dispatch</h1>
+        <p className="hero-lead">
+          Click to dispatch <code className="inline-code">ExampleJob</code> via{' '}
+          <code className="inline-code">@rudderjs/queue</code>. The handler logs to the
+          server terminal — install <code className="inline-code">@rudderjs/horizon</code> to see
+          dispatched jobs in a UI.
+        </p>
+      </section>
+
+      <section className="feature-section" style={{ maxWidth: '32rem', margin: '0 auto' }}>
+        <div className="form-card">
+          <button className="form-submit" onClick={dispatch} disabled={loading} style={{ marginBottom: '1rem' }}>
+            {loading ? 'Dispatching…' : 'Dispatch ExampleJob'}
+          </button>
+          {results.length === 0 && (
+            <p className="feature-desc" style={{ fontSize: '0.75rem', textAlign: 'center' }}>
+              No dispatches yet.
+            </p>
+          )}
+          {results.map((r, i) => (
+            <p key={i} className="feature-desc" style={{ fontSize: '0.75rem', fontFamily: 'monospace', marginBottom: '0.25rem' }}>
+              · {r.dispatchedAt} · queue={r.queue}
+            </p>
+          ))}
+        </div>
+      </section>
+    </div>
+  )
+}
+`;
+}
+export function exampleJob() {
+    return `import { Job } from '@rudderjs/queue'
+
+/**
+ * Example job for the queue demo. Logs to the server terminal when run
+ * by the worker. Replace with whatever async work the queue should handle
+ * (sending mail, generating reports, syncing third-party data, …).
+ */
+export class ExampleJob extends Job {
+  static override queue   = 'default'
+  static override retries = 3
+
+  constructor(private readonly payload: string = 'hello') {
+    super()
+  }
+
+  async handle(): Promise<void> {
+    console.log(\`[ExampleJob] handling: \${this.payload}\`)
+  }
+
+  failed(error: unknown): void {
+    console.error('[ExampleJob] failed after all retries:', error)
+  }
+}
+`;
+}
+export function demosQueueApiBlock() {
+    return `// POST /api/queue/dispatch — enqueue ExampleJob. Worker drains it during dev.
+router.post('/api/queue/dispatch', async (_req, res) => {
+  const { ExampleJob } = await import('../app/Jobs/ExampleJob.ts')
+  await ExampleJob.dispatch('hello from /api/queue/dispatch').send()
+  res.json({ ok: true, queue: 'default', dispatchedAt: new Date().toISOString() })
+})`;
+}
+//# sourceMappingURL=queue.js.map

package/dist/templates/demos/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../../src/templates/demos/queue.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,0EAA0E;AAE1E,MAAM,UAAU,cAAc;IAC5B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmER,CAAA;AACD,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO;;;;;;;;;;;;;;;;;;;;;;;CAuBR,CAAA;AACD,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;GAKN,CAAA;AACH,CAAC"}

package/dist/templates/demos/registry.d.ts

@@ -1,13 +1,26 @@
 import type { TemplateContext } from '../../templates.js';
 export interface DemoSpec {
+    /** Stable id used in URLs, file names, and the prompt multiselect. */
     value: string;
+    /** Short label shown in the @clack/prompts multiselect. */
     label: string;
+    /** Single-line hint shown next to the label in the prompt. */
     hint?: string;
+    /** Card title shown on /demos. Falls back to `label` when omitted. */
+    title?: string;
+    /** Long description shown on the /demos card in the scaffolded app + playground. */
+    description: string;
+    /** Packages this demo exercises — rendered under each /demos card. */
+    packages: ReadonlyArray<string>;
     /** Package keys that must all be selected for this demo to scaffold. */
     requires?: ReadonlyArray<keyof TemplateContext['packages']>;
     /** True if this demo requires a database/ORM. */
     requiresOrm?: boolean;
 }
+/** Card title used on /demos — falls back to `label` when not overridden. */
+export declare function demoTitle(spec: DemoSpec): string;
 export declare const DEMOS: ReadonlyArray<DemoSpec>;
 export declare function availableDemos(orm: TemplateContext['orm'], packages: TemplateContext['packages']): DemoSpec[];
+/** Default href for a demo card — `/demos/<value>`. */
+export declare function demoHref(spec: Pick<DemoSpec, 'value'>): string;
 //# sourceMappingURL=registry.d.ts.map

package/dist/templates/demos/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/templates/demos/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAS,MAAM,CAAA;IACpB,KAAK,EAAS,MAAM,CAAA;IACpB,IAAI,CAAC,EAAS,MAAM,CAAA;IACpB,wEAAwE;IACxE,QAAQ,CAAC,EAAK,aAAa,CAAC,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC,CAAA;IAC9D,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,eAAO,MAAM,KAAK,EAAE,aAAa,CAAC,QAAQ,CAIzC,CAAA;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,eAAe,CAAC,KAAK,CAAC,EAC3B,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,GACpC,QAAQ,EAAE,CAMZ"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/templates/demos/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD,MAAM,WAAW,QAAQ;IACvB,sEAAsE;IACtE,KAAK,EAAS,MAAM,CAAA;IACpB,2DAA2D;IAC3D,KAAK,EAAS,MAAM,CAAA;IACpB,8DAA8D;IAC9D,IAAI,CAAC,EAAS,MAAM,CAAA;IACpB,sEAAsE;IACtE,KAAK,CAAC,EAAQ,MAAM,CAAA;IACpB,oFAAoF;IACpF,WAAW,EAAG,MAAM,CAAA;IACpB,sEAAsE;IACtE,QAAQ,EAAM,aAAa,CAAC,MAAM,CAAC,CAAA;IACnC,wEAAwE;IACxE,QAAQ,CAAC,EAAK,aAAa,CAAC,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC,CAAA;IAC9D,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEhD;AAED,eAAO,MAAM,KAAK,EAAE,aAAa,CAAC,QAAQ,CAiHzC,CAAA;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,eAAe,CAAC,KAAK,CAAC,EAC3B,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,GACpC,QAAQ,EAAE,CAMZ;AAED,uDAAuD;AACvD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,MAAM,CAE9D"}

package/dist/templates/demos/registry.js

@@ -1,7 +1,120 @@
+/** Card title used on /demos — falls back to `label` when not overridden. */
+export function demoTitle(spec) {
+    return spec.title ?? spec.label;
+}
 export const DEMOS = [
-    { value: 'contact', label: 'Contact form', hint: 'CSRF + Zod validation' },
-    { value: 'ws', label: 'WebSocket chat', hint: 'requires WebSocket / Broadcast', requires: ['broadcast'] },
-    { value: 'live', label: 'Yjs collaboration', hint: 'requires Sync', requires: ['sync'] },
+    {
+        value: 'contact',
+        label: 'Contact form',
+        hint: 'CSRF + Zod validation',
+        description: 'CSRF-protected form with Zod validation. Demonstrates getCsrfToken() and FormRequest-style error handling.',
+        packages: ['@rudderjs/middleware', '@rudderjs/core'],
+    },
+    {
+        value: 'cache',
+        label: 'Cache counter',
+        hint: 'Cache.get + Cache.set round-trip',
+        description: 'Click "Bump" to read the current value via Cache.get, increment it, and write it back via Cache.set. Default driver is in-memory.',
+        packages: ['@rudderjs/cache'],
+    },
+    {
+        value: 'todos',
+        label: 'Todos CRUD',
+        title: 'Todos',
+        hint: 'requires ORM',
+        description: 'ORM + interactive UI. Controller loads initial data, the view hydrates and POSTs to /api/todos/* for live updates.',
+        packages: ['@rudderjs/orm', '@rudderjs/router'],
+        requiresOrm: true,
+    },
+    {
+        value: 'queue',
+        label: 'Queue dispatch',
+        hint: 'requires Queue',
+        description: 'Dispatch ExampleJob via @rudderjs/queue. The handler logs to the server terminal — install @rudderjs/horizon for a UI.',
+        packages: ['@rudderjs/queue'],
+        requires: ['queue'],
+    },
+    {
+        value: 'mail',
+        label: 'Mail send',
+        hint: 'requires Mail',
+        description: 'Send a DemoMail via @rudderjs/mail. Default driver is log — output lands in the dev server terminal.',
+        packages: ['@rudderjs/mail'],
+        requires: ['mail'],
+    },
+    {
+        value: 'notifications',
+        label: 'Notifications',
+        hint: 'requires Notifications + Mail',
+        description: "Dispatch a WelcomeNotification via notify(). The notification's via() picks the channel(s); mail routes through the log driver.",
+        packages: ['@rudderjs/notification', '@rudderjs/mail'],
+        requires: ['notifications', 'mail'],
+    },
+    {
+        value: 'localization',
+        label: 'Localization',
+        hint: 'requires Localization',
+        description: 'Locale switcher resolves the same keys server-side via trans(). Strings live in lang/<locale>/messages.json.',
+        packages: ['@rudderjs/localization'],
+        requires: ['localization'],
+    },
+    {
+        value: 'http',
+        label: 'HTTP client',
+        hint: 'requires HTTP',
+        description: 'Server-side Http.retry(3, 200).timeout(5000).get(url) against a public API. The 500 endpoint exercises the retry path.',
+        packages: ['@rudderjs/http'],
+        requires: ['http'],
+    },
+    {
+        value: 'avatar',
+        label: 'Avatar resize',
+        hint: 'requires Storage + Image',
+        description: 'Upload an image — server resizes it to 256×256 WebP via @rudderjs/image and saves to public storage. Side-by-side compare.',
+        packages: ['@rudderjs/image', '@rudderjs/storage'],
+        requires: ['storage', 'image'],
+    },
+    {
+        value: 'fibonacci',
+        label: 'Worker threads',
+        hint: 'requires Concurrency',
+        description: 'Compute fib(n) sequentially on the main thread vs across @rudderjs/concurrency worker pool. Watch the parallel cost stay flat as you crank N.',
+        packages: ['@rudderjs/concurrency'],
+        requires: ['concurrency'],
+    },
+    {
+        value: 'system-info',
+        label: 'System info',
+        hint: 'requires Process',
+        description: 'Three shell commands (git, node, uptime) executed via @rudderjs/process. Compares sequential vs parallel cost using Process.pool().',
+        packages: ['@rudderjs/process'],
+        requires: ['process'],
+    },
+    {
+        value: 'pennant',
+        label: 'Feature flags',
+        hint: 'requires Pennant + Auth',
+        description: 'Boolean, value, scoped, and Lottery features resolved against the current user. Sub-route guarded by FeatureMiddleware to demonstrate 403 blocking.',
+        packages: ['@rudderjs/pennant'],
+        requires: ['pennant', 'auth'],
+    },
+    {
+        value: 'ws',
+        label: 'WebSocket chat',
+        hint: 'requires WebSocket / Broadcast',
+        description: 'Real-time chat + presence using @rudderjs/broadcast — multi-channel pub/sub over a single WebSocket connection.',
+        packages: ['@rudderjs/broadcast'],
+        requires: ['broadcast'],
+    },
+    {
+        value: 'sync',
+        label: 'Yjs collaboration',
+        title: 'Collaborative editor',
+        hint: 'requires Sync',
+        description: 'Yjs CRDT live document with awareness cursors. Open in two tabs to see real-time sync over @rudderjs/sync.',
+        packages: ['@rudderjs/sync'],
+        requires: ['sync'],
+    },
 ];
 export function availableDemos(orm, packages) {
     return DEMOS.filter(d => {
@@ -12,4 +125,8 @@ export function availableDemos(orm, packages) {
         return true;
     });
 }
+/** Default href for a demo card — `/demos/<value>`. */
+export function demoHref(spec) {
+    return `/demos/${spec.value}`;
+}
 //# sourceMappingURL=registry.js.map

package/dist/templates/demos/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/templates/demos/registry.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,KAAK,GAA4B;IAC5C,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAO,IAAI,EAAE,uBAAuB,EAAE;IAC/E,EAAE,KAAK,EAAE,IAAI,EAAO,KAAK,EAAE,gBAAgB,EAAK,IAAI,EAAE,gCAAgC,EAAE,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE;IACjH,EAAE,KAAK,EAAE,MAAM,EAAK,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,eAAe,EAAmB,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;CAC7G,CAAA;AAED,MAAM,UAAU,cAAc,CAC5B,GAA2B,EAC3B,QAAqC;IAErC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QACtB,IAAI,CAAC,CAAC,WAAW,IAAI,GAAG,KAAK,KAAK;YAAE,OAAO,KAAK,CAAA;QAChD,IAAI,CAAC,CAAC,QAAQ;YAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;QACzD,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/templates/demos/registry.ts"],"names":[],"mappings":"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"}

package/dist/templates/demos/rudder-socket.d.ts

@@ -0,0 +1,2 @@
+export declare function rudderSocketSource(): string;
+//# sourceMappingURL=rudder-socket.d.ts.map

package/dist/templates/demos/rudder-socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rudder-socket.d.ts","sourceRoot":"","sources":["../../../src/templates/demos/rudder-socket.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,IAAI,MAAM,CA6F3C"}