@brightbase/blocks 0.1.0

package/README.md

@@ -0,0 +1,51 @@
+# @brightbase/blocks
+
+CLI for installing blocks from the bbai-blocks registry into a consumer bbai project.
+
+## Install (once)
+
+The package is **private** on npm. You need:
+1. An npm Pro/Teams account on the `@brightbase` org
+2. To be logged in: `npm login`
+
+Then in your consumer project, blocks install with:
+
+```bash
+BBAI_BLOCKS_TOKEN=<your-token> npx @brightbase/blocks add <slug>
+```
+
+The token also gates the catalog UI at https://bbai-blocks.vercel.app — same value for both.
+
+Tip: put `BBAI_BLOCKS_TOKEN` in your shell rc or `.env.local` and source it so you don't have to type it every install.
+
+## What it does
+
+```
+npx @brightbase/blocks add bbase-hero47
+```
+
+1. Fetches metadata + source from `bbai-blocks.vercel.app/r/<slug>` (with auth)
+2. Runs `npx shadcn@latest add` to write the component file and any `_shared/` deps
+3. Appends a lazy loader to `src/components/preview/preview-registry.ts`
+4. Upserts the slug into the `custom` category of `design/block-manifest.json`
+
+After install, the block appears under "Custom" in the Studio block library.
+
+## Publish (maintainers only)
+
+```bash
+cd cli
+npm login                  # if not already
+npm publish                # publishes as restricted (requires npm Pro)
+```
+
+To cut a new version, bump `version` in `package.json` and re-publish.
+
+## Options
+
+```
+npx @brightbase/blocks add <slug>
+npx @brightbase/blocks add <slug> --registry <url>   # use a different registry origin
+npx @brightbase/blocks --help
+npx @brightbase/blocks --version
+```

package/index.mjs

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+/**
+ * bbai-blocks — install blocks from the bbai-blocks registry.
+ *
+ * Wraps `npx shadcn@latest add` with post-install wiring:
+ *   1. Fetches metadata from the registry
+ *   2. Runs shadcn to write component + _shared deps
+ *   3. Appends lazy loader to preview-registry.ts
+ *   4. Upserts slug into the 'custom' category of block-manifest.json
+ *
+ * Usage:
+ *   npx bbai-blocks add <slug>
+ *   npx bbai-blocks add <slug> --registry <url>
+ */
+
+import { readFile, writeFile } from 'fs/promises'
+import { execSync } from 'child_process'
+import { join } from 'path'
+
+const REGISTRY_DEFAULT = 'https://bbai-blocks.vercel.app'
+const PREVIEW_REGISTRY_PATH = 'src/components/preview/preview-registry.ts'
+const MANIFEST_PATH = 'design/block-manifest.json'
+
+const VERSION = '0.1.0'
+
+// ── Arg parsing ──────────────────────────────────────────────────────────────
+
+const argv = process.argv.slice(2)
+
+if (argv.length === 0 || argv.includes('--help') || argv.includes('-h')) {
+  printHelp()
+  process.exit(0)
+}
+
+if (argv.includes('--version') || argv.includes('-v')) {
+  console.log(VERSION)
+  process.exit(0)
+}
+
+const command = argv[0]
+const rest = argv.slice(1)
+
+if (command !== 'add') {
+  console.error(`Unknown command: ${command}`)
+  printHelp()
+  process.exit(1)
+}
+
+const slug = rest.find((a) => !a.startsWith('--'))
+const registryFlag = rest.indexOf('--registry')
+const registryBase = registryFlag !== -1 ? rest[registryFlag + 1] : REGISTRY_DEFAULT
+// --auth=<token> overrides BBAI_BLOCKS_TOKEN env var
+const authArg = rest.find((a) => a.startsWith('--auth='))
+const authToken = authArg ? authArg.slice('--auth='.length) : undefined
+
+if (!slug) {
+  console.error('Missing slug. Usage: bbai-blocks add <slug>')
+  process.exit(1)
+}
+
+if (!/^[a-z0-9-]+$/.test(slug)) {
+  console.error(`Invalid slug: ${slug}`)
+  process.exit(1)
+}
+
+await runAdd(slug, registryBase, authToken)
+
+// ── Commands ─────────────────────────────────────────────────────────────────
+
+async function runAdd(slug, registryBase, authToken) {
+  // --auth flag wins; falls back to BBAI_BLOCKS_TOKEN env var
+  const token = authToken || process.env.BBAI_BLOCKS_TOKEN
+  const baseUrl = `${registryBase}/r/${slug}`
+  // Token in query param so shadcn's plain fetch can authenticate
+  const registryUrl = token ? `${baseUrl}?token=${encodeURIComponent(token)}` : baseUrl
+
+  console.log(`\nFetching ${baseUrl}${token ? ' (with token)' : ''}…`)
+  let meta
+  try {
+    const res = await fetch(baseUrl, {
+      headers: token ? { Authorization: `Bearer ${token}` } : {},
+    })
+    if (res.status === 401) {
+      console.error('Unauthorized. Pass --auth=<token> or set BBAI_BLOCKS_TOKEN.')
+      process.exit(1)
+    }
+    if (!res.ok) throw new Error(`${res.status} ${res.statusText}`)
+    meta = await res.json()
+  } catch (err) {
+    console.error(`Failed to fetch ${baseUrl}: ${err.message}`)
+    process.exit(1)
+  }
+
+  const label = meta.title ?? slug
+  const mainFile = meta.files?.[0]
+  const exportName = mainFile?.content ? parseExportName(mainFile.content, slug) : toExportName(slug)
+  console.log(`  label:      ${label}`)
+  console.log(`  exportName: ${exportName}`)
+
+  console.log(`\nInstalling via shadcn…`)
+  try {
+    execSync(`npx shadcn@latest add "${registryUrl}" --overwrite`, { stdio: 'inherit' })
+  } catch {
+    // shadcn exits non-zero on some prompts even when successful — continue
+  }
+
+  await wirePreviewRegistry(slug, exportName, mainFile?.path)
+  await wireBlockManifest(slug, label)
+
+  console.log(`\nDone. ${slug} is installed and wired.\n`)
+}
+
+async function wirePreviewRegistry(slug, exportName, installPath) {
+  console.log(`\nUpdating ${PREVIEW_REGISTRY_PATH}…`)
+  const path = join(process.cwd(), PREVIEW_REGISTRY_PATH)
+  let source = await readFile(path, 'utf-8')
+
+  if (source.includes(`'${slug}'`)) {
+    console.log(`  already present — skipping`)
+    return
+  }
+
+  const filePath = installPath ?? `src/components/_preview/_bbase/${slug}.tsx`
+  const importPath = filePath
+    .replace(/^src\/components\//, '../')
+    .replace(/\.tsx$/, '')
+
+  const entry = `  '${slug}': () => import('${importPath}').then(m => m.${exportName}),\n`
+
+  const closingBrace = source.lastIndexOf('}')
+  if (closingBrace === -1) {
+    console.error('  Could not find closing brace — add entry manually')
+    return
+  }
+
+  source = source.slice(0, closingBrace) + entry + source.slice(closingBrace)
+  await writeFile(path, source, 'utf-8')
+  console.log(`  added: ${entry.trim()}`)
+}
+
+async function wireBlockManifest(slug, label) {
+  console.log(`\nUpdating ${MANIFEST_PATH}…`)
+  const path = join(process.cwd(), MANIFEST_PATH)
+  const manifest = JSON.parse(await readFile(path, 'utf-8'))
+
+  let customCat = manifest.categories?.find((c) => c.name === 'custom')
+  if (!customCat) {
+    customCat = { name: 'custom', label: 'Custom', description: 'Project-specific blocks', blocks: [] }
+    manifest.categories = manifest.categories ?? []
+    manifest.categories.push(customCat)
+  }
+
+  if (customCat.blocks.some((b) => b.slug === slug)) {
+    console.log(`  already present in custom category — skipping`)
+    return
+  }
+
+  customCat.blocks.push({ slug, label, free: true, source: 'bbase' })
+  await writeFile(path, JSON.stringify(manifest, null, 2) + '\n', 'utf-8')
+  console.log(`  added ${slug} to custom category`)
+}
+
+// ── Helpers ──────────────────────────────────────────────────────────────────
+
+function toExportName(s) {
+  return s.split('-').map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join('')
+}
+
+function parseExportName(source, slug) {
+  const m = source.match(/export\s+(?:default\s+)?function\s+([A-Z][A-Za-z0-9]+)/)
+  return m ? m[1] : toExportName(slug)
+}
+
+function printHelp() {
+  console.log(`bbai-blocks v${VERSION}
+
+Install blocks from the bbai-blocks registry.
+
+Usage:
+  npx bbai-blocks add <slug>
+  npx bbai-blocks add <slug> --registry <url>
+
+Options:
+  --auth=<token>     Auth token. Overrides BBAI_BLOCKS_TOKEN env var.
+                     Common shell-expansion form: --auth=$BBAI_BLOCKS_TOKEN
+  --registry <url>   Override the registry origin (default: ${REGISTRY_DEFAULT})
+  --version, -v      Print version
+  --help, -h         Print this help
+
+Env vars:
+  BBAI_BLOCKS_TOKEN  Used when --auth is not passed. Sent as Authorization:
+                     Bearer header (direct fetch) and ?token= query param
+                     (shadcn's fetch).
+`)
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@brightbase/blocks",
+  "version": "0.1.0",
+  "description": "CLI for installing blocks from the bbai-blocks registry into a bbai project",
+  "type": "module",
+  "bin": {
+    "bbai-blocks": "./index.mjs"
+  },
+  "files": [
+    "index.mjs",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "bbai",
+    "shadcn",
+    "blocks",
+    "registry"
+  ],
+  "license": "UNLICENSED",
+  "private": false,
+  "publishConfig": {
+    "access": "restricted"
+  }
+}