@usehyper/cli 0.1.0

package/src/registry/types.ts

@@ -0,0 +1,62 @@
+/**
+ * Wire-format types for the Hyper registry. Mirrors `tools/registry-types.ts`
+ * one-to-one — kept here so the CLI has zero workspace deps on `tools/`.
+ *
+ * Anyone can host their own registry by serving JSON in this shape at:
+ *   GET <registryUrl>/r/index.json
+ *   GET <registryUrl>/r/<name>.json
+ *   GET <registryUrl>/r/<name>@<version>.json
+ */
+
+export interface RegistryFile {
+  readonly path: string
+  readonly contents: string
+  readonly sha256: string
+  /**
+   * Optional override for where this file lands in the user's project.
+   * Placeholders: `@base/...`, `@root/...`, `@cursor/...`, `~/...`.
+   * See `tools/registry-types.ts` for full semantics.
+   */
+  readonly target?: string
+}
+
+export interface RegistryComponent {
+  /** JSON Schema URL emitted by the registry — present in HTTP responses. */
+  readonly $schema?: string
+  readonly name: string
+  readonly version: string
+  readonly title?: string
+  readonly description: string
+  readonly readme: string
+  readonly registryDeps: readonly string[]
+  readonly peerDeps: Readonly<Record<string, string>>
+  readonly optionalPeerDeps: Readonly<Record<string, string>>
+  readonly files: readonly RegistryFile[]
+  readonly subpaths: Readonly<Record<string, string>>
+  /**
+   * Env vars the component needs at runtime. The CLI appends them to
+   * `.env.local` (existing keys preserved). `${random:hex:N}` and
+   * `${random:base64:N}` are resolved locally with `crypto.randomBytes`.
+   */
+  readonly envVars?: Readonly<Record<string, string>>
+  /** Markdown blurb printed after `hyper add`. */
+  readonly docs?: string
+}
+
+export interface RegistryIndexEntry {
+  readonly name: string
+  readonly version: string
+  readonly title?: string
+  readonly description: string
+  readonly registryDeps: readonly string[]
+  readonly fileCount: number
+}
+
+export interface RegistryIndex {
+  /** JSON Schema URL emitted by the registry — present in HTTP responses. */
+  readonly $schema?: string
+  readonly schema: 1
+  readonly generatedAt: string
+  readonly source: string
+  readonly components: readonly RegistryIndexEntry[]
+}

package/src/templates.ts

@@ -0,0 +1,141 @@
+/**
+ * Built-in scaffolding templates.
+ *
+ * After `hyper init`, the CLI runs `hyper add core` to copy the framework
+ * source into `<baseDir>/core/`. Templates therefore have NO `@usehyper/*`
+ * runtime deps — imports use `@hyper/core` and resolve via tsconfig paths.
+ */
+
+export interface Template {
+  readonly name: string
+  /** Files emitted by `hyper init`. Paths are relative to the project root. */
+  readonly files: Readonly<Record<string, string>>
+  /** Components installed via `hyper add` after the files are written. */
+  readonly components: readonly string[]
+  /**
+   * Peer deps that should land in `package.json` immediately. The CLI prints
+   * a one-liner suggesting `bun add` for these.
+   */
+  readonly extraPeerDeps?: Readonly<Record<string, string>>
+}
+
+const MINIMAL_APP = `import { Hyper, ok } from "@hyper/core"
+
+export default new Hyper()
+  .get("/health", () => ok({ ok: true }))
+  .get("/hello/:name", ({ params }) => ok({ hello: params.name }))
+  .listen(Number(process.env.PORT ?? 3000))
+`
+
+const MINIMAL_TSCONFIG = `{
+  "compilerOptions": {
+    "target": "ES2024",
+    "lib": ["ES2024"],
+    "module": "preserve",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "verbatimModuleSyntax": true,
+    "allowImportingTsExtensions": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "types": ["@types/bun"],
+    "paths": {
+      "@hyper/*": ["./src/hyper/*", "./src/hyper/*/index.ts"]
+    }
+  },
+  "include": ["src/**/*.ts", "test/**/*.ts"]
+}
+`
+
+const MINIMAL_PKG = `{
+  "name": "my-hyper-app",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "dev": "bun --hot src/app.ts",
+    "start": "bun src/app.ts",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.6.0"
+  }
+}
+`
+
+const API_APP = `import { Hyper, ok, route } from "@hyper/core"
+import { hyperLog } from "@hyper/log"
+
+const health = route.get("/health").handle(() => ok({ ok: true }))
+const listUsers = route.get("/users").handle(() => ok([{ id: "u1", name: "Ada" }]))
+const getUser = route
+  .get("/users/:id")
+  .handle(({ params }) => ok({ id: params.id, name: "Ada" }))
+
+export default new Hyper()
+  .use(hyperLog({ service: "my-hyper-app" }))
+  .use([health, listUsers, getUser])
+  .listen(Number(process.env.PORT ?? 3000))
+`
+
+const HEALTH_TEST = `import { describe, expect, test } from "bun:test"
+import app from "../src/app.ts"
+
+describe("app", () => {
+  test("GET /health returns ok", async () => {
+    const res = await app.fetch(new Request("http://localhost/health"))
+    expect(res.status).toBe(200)
+    expect(await res.json()).toEqual({ ok: true })
+  })
+})
+`
+
+const README = `# my-hyper-app
+
+A Hyper app. The framework source lives under \`src/hyper/<component>/\` —
+managed by the \`hyper\` CLI.
+
+## Develop
+
+\`\`\`bash
+bun install
+bun run dev
+\`\`\`
+
+## Manage components
+
+\`\`\`bash
+hyper list                 # browse the registry
+hyper add cors             # add a component
+hyper diff log             # inspect drift on an installed component
+hyper update               # pull the latest registry versions
+\`\`\`
+`
+
+export const TEMPLATES: Record<string, Template> = {
+  minimal: {
+    name: "minimal",
+    files: {
+      "src/app.ts": MINIMAL_APP,
+      "tsconfig.json": MINIMAL_TSCONFIG,
+      "package.json": MINIMAL_PKG,
+      "test/app.test.ts": HEALTH_TEST,
+      "README.md": README,
+    },
+    components: ["core"],
+  },
+  api: {
+    name: "api",
+    files: {
+      "src/app.ts": API_APP,
+      "tsconfig.json": MINIMAL_TSCONFIG,
+      "package.json": MINIMAL_PKG,
+      "test/app.test.ts": HEALTH_TEST,
+      "README.md": README,
+    },
+    components: ["core", "log"],
+  },
+}