uniweb 0.12.26 → 0.12.28

package/src/commands/handoff.js

@@ -1,254 +1,17 @@
 /**
- * Handoff Command
+ * handoff — RESERVED (not available on the new backend yet).
  *
- * Creates a site record on Unicloud and transfers ownership to a client.
- * The developer builds content locally and hands off a licensed, registered site.
- *
- * Usage:
- *   uniweb handoff <email>                    # Register site + transfer to client
- *   uniweb handoff <email> --site <id>        # Specify site ID (default: auto-generated)
- *   uniweb handoff <email> --web              # Show web-based handoff instructions
- */
-
-import { existsSync } from 'node:fs'
-import { readFile } from 'node:fs/promises'
-import { resolve, join } from 'node:path'
-import { execSync } from 'node:child_process'
-import { randomUUID } from 'node:crypto'
-
-import { RemoteRegistry } from '../utils/registry.js'
-import { ensureAuth } from '../utils/auth.js'
-import { findWorkspaceRoot, findFoundations, classifyPackage, promptSelect } from '../utils/workspace.js'
-import { isNonInteractive, getCliPrefix } from '../utils/interactive.js'
-
-const colors = {
-  reset: '\x1b[0m',
-  bright: '\x1b[1m',
-  dim: '\x1b[2m',
-  cyan: '\x1b[36m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  red: '\x1b[31m',
-}
-
-function success(message) {
-  console.log(`${colors.green}✓${colors.reset} ${message}`)
-}
-
-function error(message) {
-  console.error(`${colors.red}✗${colors.reset} ${message}`)
-}
-
-function info(message) {
-  console.log(`${colors.cyan}→${colors.reset} ${message}`)
-}
-
-/**
- * Parse a flag value from args.
- * @param {string[]} args
- * @param {string} flag - e.g. '--site'
- * @returns {string|null}
+ * The "create a site and hand it off to a client" flow ran against the legacy
+ * platform (the PHP backend + Cloudflare Worker) the CLI no longer talks to. A
+ * new-backend CLI equivalent isn't built; the command name is kept reserved so a
+ * future rebuild can claim it without a breaking change.
  */
-function parseFlag(args, flag) {
-  const idx = args.indexOf(flag)
-  if (idx === -1 || !args[idx + 1]) return null
-  return args[idx + 1]
-}
-
-/**
- * Resolve the foundation directory (same logic as invite.js).
- */
-async function resolveFoundationDir(args) {
-  const cwd = process.cwd()
-  const prefix = getCliPrefix()
-
-  const type = await classifyPackage(cwd)
-  if (type === 'foundation') return cwd
-
-  const workspaceRoot = findWorkspaceRoot(cwd)
-  if (workspaceRoot) {
-    const foundations = await findFoundations(workspaceRoot)
-
-    if (foundations.length === 1) {
-      return resolve(workspaceRoot, foundations[0])
-    }
 
-    if (foundations.length > 1) {
-      if (isNonInteractive(args)) {
-        error('Multiple foundations found. Specify which one.')
-        console.log('')
-        for (const f of foundations) {
-          console.log(`  ${colors.cyan}cd ${f} && ${prefix} handoff ...${colors.reset}`)
-        }
-        process.exit(1)
-      }
-
-      const choice = await promptSelect('Which foundation?', foundations)
-      if (!choice) {
-        console.log('\nCancelled.')
-        process.exit(0)
-      }
-      return resolve(workspaceRoot, choice)
-    }
-  }
-
-  error('No foundation found in this workspace.')
-  console.log('')
-  console.log(`  ${colors.dim}\`handoff\` creates a site record for your foundation and transfers${colors.reset}`)
-  console.log(`  ${colors.dim}ownership to a client — they get a licensed, ready-to-use project.${colors.reset}`)
-  console.log('')
-  console.log(`  ${colors.dim}Run this command from a foundation directory or workspace root.${colors.reset}`)
+export async function handoff() {
+  console.error("\x1b[31m✗\x1b[0m `uniweb handoff` isn't available on the new backend yet.")
+  console.error('  The legacy site-handoff flow was retired with the PHP backend.')
+  console.error('  Manage client sites from the Uniweb app for now.')
   process.exit(1)
 }
 
-/**
- * Read foundation name and version from dist/meta/schema.json, auto-building if needed.
- */
-async function readSchema(foundationDir) {
-  const distDir = join(foundationDir, 'dist')
-  const foundationJs = join(distDir, 'foundation.js')
-  const schemaJson = join(distDir, 'meta', 'schema.json')
-
-  if (!existsSync(foundationJs) || !existsSync(schemaJson)) {
-    console.log(`${colors.yellow}⚠${colors.reset} No build found. Building foundation...`)
-    console.log('')
-    execSync('npx uniweb build --target foundation', {
-      cwd: foundationDir,
-      stdio: 'inherit',
-    })
-    console.log('')
-
-    if (!existsSync(foundationJs) || !existsSync(schemaJson)) {
-      error('Build did not produce dist/foundation.js and dist/meta/schema.json')
-      process.exit(1)
-    }
-  }
-
-  try {
-    const schema = JSON.parse(await readFile(schemaJson, 'utf8'))
-    const name = schema._self?.name
-    const version = schema._self?.version
-
-    if (!name || !version) {
-      error('dist/meta/schema.json missing _self.name or _self.version')
-      process.exit(1)
-    }
-
-    return { name, version }
-  } catch (err) {
-    error(`Failed to read dist/meta/schema.json: ${err.message}`)
-    process.exit(1)
-  }
-}
-
-/**
- * Create a RemoteRegistry instance with auth.
- */
-async function createRegistry(args) {
-  const token = await ensureAuth({ command: 'Handing off', args })
-
-  const registryUrl = parseFlag(args, '--registry')
-  const url = registryUrl || process.env.UNIWEB_REGISTRY_URL || 'http://localhost:4001'
-
-  return new RemoteRegistry(url, token)
-}
-
-/**
- * Handle --web flag: show web-based handoff guidance.
- */
-function showWebHandoff(email, name) {
-  console.log('')
-  info(`Web-based handoff`)
-  console.log('')
-  console.log(`  1. Create a site on ${colors.cyan}uniweb.app${colors.reset} using ${colors.bright}${name}${colors.reset}`)
-  console.log(`  2. Add pages and content`)
-  console.log(`  3. Transfer ownership to ${colors.bright}${email}${colors.reset}:`)
-  console.log(`     ${colors.dim}Settings → Transfer site${colors.reset}`)
-  console.log('')
-  console.log(`  ${colors.dim}The license stays with the site — the client can edit${colors.reset}`)
-  console.log(`  ${colors.dim}and publish immediately.${colors.reset}`)
-}
-
-/**
- * Main handoff command handler.
- */
-export async function handoff(args = []) {
-  const prefix = getCliPrefix()
-
-  // Extract email (first positional arg with @)
-  const email = args.find(a => !a.startsWith('--') && a.includes('@'))
-  if (!email) {
-    error('Email is required.')
-    console.log('')
-    console.log(`  ${colors.dim}Usage: ${prefix} handoff <email> [--site <id>] [--web]${colors.reset}`)
-    console.log('')
-    console.log(`  ${colors.dim}Creates a site record for your foundation and transfers ownership${colors.reset}`)
-    console.log(`  ${colors.dim}to the client. They get a licensed project, ready to use.${colors.reset}`)
-    process.exit(1)
-  }
-
-  const foundationDir = await resolveFoundationDir(args)
-  const { name, version } = await readSchema(foundationDir)
-
-  // --web: guidance-only, no API call
-  if (args.includes('--web')) {
-    showWebHandoff(email, name)
-    return
-  }
-
-  const registry = await createRegistry(args)
-
-  // Derive site ID
-  const siteIdFlag = parseFlag(args, '--site')
-  const siteId = siteIdFlag || `${name}-${randomUUID().slice(0, 6)}`
-
-  info(`Creating site ${colors.bright}${siteId}${colors.reset} with ${name} v${version}...`)
-
-  // 1. Create site record
-  let siteResult
-  try {
-    siteResult = await registry.createSite(siteId, { foundation: { name } })
-  } catch (err) {
-    if (err.statusCode === 409) {
-      error(`Site "${siteId}" already exists.`)
-      console.log(`  ${colors.dim}Use --site <id> to specify a different site identifier.${colors.reset}`)
-      process.exit(1)
-    }
-    if (err.statusCode === 404) {
-      error(err.message)
-      console.log(`  ${colors.dim}Make sure your foundation is published: ${prefix} publish${colors.reset}`)
-      process.exit(1)
-    }
-    error(err.message)
-    process.exit(1)
-  }
-
-  // 2. Transfer ownership to client
-  info(`Transferring to ${colors.bright}${email}${colors.reset}...`)
-
-  try {
-    await registry.transferSiteOwnership(siteId, email)
-  } catch (err) {
-    error(`Site created but transfer failed: ${err.message}`)
-    console.log(`  ${colors.dim}Site "${siteId}" is registered. Transfer manually:${colors.reset}`)
-    console.log(`  ${colors.dim}  PATCH /api/sites/${siteId}/owner  { "newOwner": "${email}" }${colors.reset}`)
-    process.exit(1)
-  }
-
-  // 3. Show result
-  console.log('')
-  success(`Site created and transferred`)
-  console.log('')
-  console.log(`  ${colors.dim}Site:${colors.reset}        ${colors.bright}${siteId}${colors.reset}`)
-  console.log(`  ${colors.dim}Foundation:${colors.reset}  ${name} v${version.split('.')[0]}`)
-  console.log(`  ${colors.dim}Owner:${colors.reset}       ${email}`)
-  console.log(`  ${colors.dim}License:${colors.reset}     ${siteResult.license ? `${colors.green}✓${colors.reset} granted` : `${colors.yellow}⚠${colors.reset} not granted`}`)
-  console.log('')
-  console.log(`  ${colors.bright}Next steps:${colors.reset}`)
-  console.log(`    1. Add ${colors.cyan}id: ${siteId}${colors.reset} to your site.yml`)
-  console.log(`    2. Share the site files with ${colors.bright}${email}${colors.reset}`)
-  console.log(`       ${colors.dim}(git repo, zip, shared drive — any method works)${colors.reset}`)
-  console.log(`    3. Client opens the project in Uniweb Studio`)
-}
-
 export default handoff

package/src/commands/invite.js

@@ -1,326 +1,18 @@
 /**
- * Invite Command
+ * invite — RESERVED (not available on the new backend yet).
  *
- * Creates, lists, revokes, and resends foundation invites.
- *
- * Usage:
- *   uniweb invite <email>                     # Create invite (1 use, 30 days)
- *   uniweb invite <email> --uses 5            # Multi-use invite
- *   uniweb invite <email> --expires 60        # 60-day expiry
- *   uniweb invite --list                      # List invites for your foundation
- *   uniweb invite --revoke <inviteId>         # Revoke an invite
- *   uniweb invite --resend <inviteId>         # Resend an invite
- */
-
-import { existsSync } from 'node:fs'
-import { readFile } from 'node:fs/promises'
-import { resolve, join } from 'node:path'
-import { execSync } from 'node:child_process'
-
-import { RemoteRegistry } from '../utils/registry.js'
-import { ensureAuth } from '../utils/auth.js'
-import { findWorkspaceRoot, findFoundations, classifyPackage, promptSelect } from '../utils/workspace.js'
-import { isNonInteractive, getCliPrefix } from '../utils/interactive.js'
-
-const colors = {
-  reset: '\x1b[0m',
-  bright: '\x1b[1m',
-  dim: '\x1b[2m',
-  cyan: '\x1b[36m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  red: '\x1b[31m',
-}
-
-function success(message) {
-  console.log(`${colors.green}✓${colors.reset} ${message}`)
-}
-
-function error(message) {
-  console.error(`${colors.red}✗${colors.reset} ${message}`)
-}
-
-function info(message) {
-  console.log(`${colors.cyan}→${colors.reset} ${message}`)
-}
-
-/**
- * Parse a flag value from args.
- * @param {string[]} args
- * @param {string} flag - e.g. '--uses'
- * @returns {string|null}
- */
-function parseFlag(args, flag) {
-  const idx = args.indexOf(flag)
-  if (idx === -1 || !args[idx + 1]) return null
-  return args[idx + 1]
-}
-
-/**
- * Resolve the foundation directory (same logic as publish.js).
+ * The foundation client-invite flow ran against the legacy platform (the PHP
+ * backend + Cloudflare Worker) the CLI no longer talks to. Client onboarding is
+ * handled in the Uniweb app for now; a new-backend CLI equivalent isn't built.
+ * The command name is kept reserved so a future rebuild can claim it without a
+ * breaking change.
  */
-async function resolveFoundationDir(args) {
-  const cwd = process.cwd()
-  const prefix = getCliPrefix()
-
-  const type = await classifyPackage(cwd)
-  if (type === 'foundation') return cwd
-
-  const workspaceRoot = findWorkspaceRoot(cwd)
-  if (workspaceRoot) {
-    const foundations = await findFoundations(workspaceRoot)
 
-    if (foundations.length === 1) {
-      return resolve(workspaceRoot, foundations[0])
-    }
-
-    if (foundations.length > 1) {
-      if (isNonInteractive(args)) {
-        error('Multiple foundations found. Specify which one.')
-        console.log('')
-        for (const f of foundations) {
-          console.log(`  ${colors.cyan}cd ${f} && ${prefix} invite ...${colors.reset}`)
-        }
-        process.exit(1)
-      }
-
-      const choice = await promptSelect('Which foundation?', foundations)
-      if (!choice) {
-        console.log('\nCancelled.')
-        process.exit(0)
-      }
-      return resolve(workspaceRoot, choice)
-    }
-  }
-
-  error('No foundation found in this workspace.')
-  console.log('')
-  console.log(`  ${colors.dim}\`invite\` lets you authorize a client to create sites with your${colors.reset}`)
-  console.log(`  ${colors.dim}foundation — they get their own site, set up automatically.${colors.reset}`)
-  console.log('')
-  console.log(`  ${colors.dim}Run this command from a foundation directory or workspace root.${colors.reset}`)
+export async function invite() {
+  console.error("\x1b[31m✗\x1b[0m `uniweb invite` isn't available on the new backend yet.")
+  console.error('  The legacy client-invite flow was retired with the PHP backend.')
+  console.error('  Invite clients to your foundation from the Uniweb app for now.')
   process.exit(1)
 }
 
-/**
- * Read foundation name and version from dist/meta/schema.json, auto-building if needed.
- */
-async function readSchema(foundationDir) {
-  const distDir = join(foundationDir, 'dist')
-  const foundationJs = join(distDir, 'foundation.js')
-  const schemaJson = join(distDir, 'meta', 'schema.json')
-
-  if (!existsSync(foundationJs) || !existsSync(schemaJson)) {
-    console.log(`${colors.yellow}⚠${colors.reset} No build found. Building foundation...`)
-    console.log('')
-    execSync('npx uniweb build --target foundation', {
-      cwd: foundationDir,
-      stdio: 'inherit',
-    })
-    console.log('')
-
-    if (!existsSync(foundationJs) || !existsSync(schemaJson)) {
-      error('Build did not produce dist/foundation.js and dist/meta/schema.json')
-      process.exit(1)
-    }
-  }
-
-  try {
-    const schema = JSON.parse(await readFile(schemaJson, 'utf8'))
-    const name = schema._self?.name
-    const version = schema._self?.version
-
-    if (!name || !version) {
-      error('dist/meta/schema.json missing _self.name or _self.version')
-      process.exit(1)
-    }
-
-    return { name, version, role: schema._self?.role }
-  } catch (err) {
-    error(`Failed to read dist/meta/schema.json: ${err.message}`)
-    process.exit(1)
-  }
-}
-
-/**
- * Create a RemoteRegistry instance with auth.
- */
-async function createRegistry(args) {
-  const token = await ensureAuth({ command: 'Creating invite', args })
-
-  const registryUrl = parseFlag(args, '--registry')
-  const url = registryUrl || process.env.UNIWEB_REGISTRY_URL || 'http://localhost:4001'
-
-  return new RemoteRegistry(url, token)
-}
-
-/**
- * Handle --list flag.
- */
-async function handleList(args) {
-  const foundationDir = await resolveFoundationDir(args)
-  const { name } = await readSchema(foundationDir)
-  const registry = await createRegistry(args)
-
-  info(`Listing invites for ${colors.bright}${name}${colors.reset}...`)
-
-  try {
-    const invites = await registry.listInvites(name)
-
-    if (invites.length === 0) {
-      console.log(`\n  No invites found for ${name}.`)
-      return
-    }
-
-    console.log('')
-    for (const inv of invites) {
-      const statusColor = inv.status === 'active' ? colors.green
-        : inv.status === 'revoked' ? colors.red
-        : colors.yellow
-      console.log(`  ${statusColor}${inv.status}${colors.reset}  ${inv.email}  v${inv.majorVersion}  ${inv.usedCount}/${inv.maxUses} uses  ${colors.dim}${inv.inviteId}${colors.reset}`)
-    }
-    console.log('')
-  } catch (err) {
-    error(err.message)
-    process.exit(1)
-  }
-}
-
-/**
- * Handle --revoke flag.
- */
-async function handleRevoke(args, inviteId) {
-  const foundationDir = await resolveFoundationDir(args)
-  const { name } = await readSchema(foundationDir)
-  const registry = await createRegistry(args)
-
-  info(`Revoking invite ${colors.dim}${inviteId}${colors.reset}...`)
-
-  try {
-    const result = await registry.revokeInvite(name, inviteId)
-    console.log('')
-    success(`Revoked invite for ${colors.bright}${result.email}${colors.reset}`)
-  } catch (err) {
-    error(err.message)
-    process.exit(1)
-  }
-}
-
-/**
- * Handle --resend flag.
- */
-async function handleResend(args, inviteId) {
-  const foundationDir = await resolveFoundationDir(args)
-  const { name } = await readSchema(foundationDir)
-  const registry = await createRegistry(args)
-
-  info(`Resending invite ${colors.dim}${inviteId}${colors.reset}...`)
-
-  try {
-    const result = await registry.resendInvite(name, inviteId)
-    console.log('')
-    success(`Resent invite to ${colors.bright}${result.email}${colors.reset}`)
-  } catch (err) {
-    error(err.message)
-    process.exit(1)
-  }
-}
-
-/**
- * Handle create invite (default action).
- */
-async function handleCreate(args, email) {
-  const foundationDir = await resolveFoundationDir(args)
-  const { name, version, role } = await readSchema(foundationDir)
-  const registry = await createRegistry(args)
-
-  // Parse options
-  const versionFlag = parseFlag(args, '--version')
-  const majorVersion = versionFlag
-    ? parseInt(versionFlag, 10)
-    : parseInt(version.split('.')[0], 10)
-
-  const usesFlag = parseFlag(args, '--uses')
-  const maxUses = usesFlag ? parseInt(usesFlag, 10) : 1
-
-  const expiresFlag = parseFlag(args, '--expires')
-  const expiresInDays = expiresFlag ? parseInt(expiresFlag, 10) : 30
-
-  if (isNaN(majorVersion)) {
-    error('Could not determine major version. Use --version to specify.')
-    process.exit(1)
-  }
-
-  info(`Creating invite for ${colors.bright}${email}${colors.reset} → ${name} v${majorVersion}...`)
-
-  try {
-    const invite = await registry.createInvite(name, {
-      email,
-      majorVersion,
-      maxUses,
-      expiresInDays,
-    })
-
-    const isExtension = role === 'extension'
-
-    console.log('')
-    success(`Invite created`)
-    console.log('')
-    console.log(`  ${colors.dim}ID:${colors.reset}       ${invite.inviteId}`)
-    console.log(`  ${colors.dim}To:${colors.reset}       ${invite.email}`)
-    console.log(`  ${colors.dim}For:${colors.reset}      ${name} v${invite.majorVersion}${isExtension ? '  (extension)' : ''}`)
-    console.log(`  ${colors.dim}Uses:${colors.reset}     ${invite.maxUses}`)
-    console.log(`  ${colors.dim}Expires:${colors.reset}  ${new Date(invite.expiresAt).toLocaleDateString()}`)
-    console.log(`  ${colors.dim}Link:${colors.reset}     ${colors.cyan}${registry.apiUrl}/invite/${invite.inviteId}${colors.reset}`)
-    console.log('')
-    if (isExtension) {
-      console.log(`  ${colors.dim}When ${invite.email} adds ${name} to their site${colors.reset}`)
-      console.log(`  ${colors.dim}on uniweb.app or Studio, it will be authorized automatically.${colors.reset}`)
-    } else {
-      console.log(`  ${colors.dim}When ${invite.email} creates a site with ${name}${colors.reset}`)
-      console.log(`  ${colors.dim}on uniweb.app or Studio, it will be authorized automatically.${colors.reset}`)
-    }
-  } catch (err) {
-    error(err.message)
-    process.exit(1)
-  }
-}
-
-/**
- * Main invite command handler.
- */
-export async function invite(args = []) {
-  // Dispatch based on flags
-  if (args.includes('--list')) {
-    await handleList(args)
-    return
-  }
-
-  const revokeId = parseFlag(args, '--revoke')
-  if (revokeId) {
-    await handleRevoke(args, revokeId)
-    return
-  }
-
-  const resendId = parseFlag(args, '--resend')
-  if (resendId) {
-    await handleResend(args, resendId)
-    return
-  }
-
-  // Default: create invite — first positional arg is the email
-  const email = args.find(a => !a.startsWith('--') && a.includes('@'))
-  if (!email) {
-    error('Email is required.')
-    console.log('')
-    console.log(`  ${colors.dim}Usage: ${getCliPrefix()} invite <email> [--uses N] [--expires N]${colors.reset}`)
-    console.log(`  ${colors.dim}       ${getCliPrefix()} invite --list${colors.reset}`)
-    console.log(`  ${colors.dim}       ${getCliPrefix()} invite --revoke <id>${colors.reset}`)
-    console.log(`  ${colors.dim}       ${getCliPrefix()} invite --resend <id>${colors.reset}`)
-    process.exit(1)
-  }
-
-  await handleCreate(args, email)
-}
-
 export default invite

package/src/commands/org.js

@@ -8,9 +8,8 @@
  * the legacy platform (publish/deploy); this talks to the registry backend.
  */
 
-import { getRegistryApiBaseUrl } from '../utils/config.js'
-import { ensureRegistryAuth } from '../utils/registry-auth.js'
-import { listOrgs, createOrg, validateHandle, bareHandle } from '../utils/registry-orgs.js'
+import { BackendClient } from '../backend/client.js'
+import { validateHandle, bareHandle } from '../utils/registry-orgs.js'
 
 const colors = { reset: '\x1b[0m', bright: '\x1b[1m', dim: '\x1b[2m', red: '\x1b[31m', green: '\x1b[32m' }
 const error = (m) => console.error(`${colors.red}✗${colors.reset} ${m}`)
@@ -18,11 +17,10 @@ const success = (m) => console.log(`${colors.green}✓${colors.reset} ${m}`)
 
 export async function org(args = []) {
   const sub = args[0]
-  const apiBase = getRegistryApiBaseUrl()
 
   if (sub === 'list') {
-    const token = await ensureRegistryAuth({ apiBase, command: 'Listing orgs', args })
-    const orgs = await listOrgs({ apiBase, token })
+    const client = new BackendClient({ args, command: 'Listing orgs' })
+    const { orgs } = await client.fetchOrgs()
     if (!orgs.length) {
       console.log('You have no orgs yet. Create one: uniweb org create <handle>')
       return { exitCode: 0 }
@@ -45,9 +43,9 @@ export async function org(args = []) {
       error(invalid)
       return { exitCode: 2 }
     }
-    const token = await ensureRegistryAuth({ apiBase, command: 'Creating an org', args })
+    const client = new BackendClient({ args, command: 'Creating an org' })
     try {
-      const org = await createOrg({ apiBase, token, handle })
+      const org = await client.createOrg(handle)
       success(`Created ${colors.bright}@${org.handle}${colors.reset} — you're a member${org.is_primary ? ' (primary)' : ''}.`)
       console.log(`${colors.dim}Publish under it: uniweb register --scope @${org.handle}${colors.reset}`)
       return { exitCode: 0 }