alepha 0.21.2 → 0.22.0

package/dist/containers/core/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/containers/core/providers/ContainerProvider.ts","../../../src/containers/core/primitives/$container.ts","../../../src/containers/core/providers/MockContainerProvider.ts","../../../src/containers/core/providers/NodeContainerProvider.ts","../../../src/containers/core/index.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport type { ContainerPrimitive } from \"../primitives/$container.ts\";\n\nexport interface ContainerInvokeConfig {\n  body?: unknown;\n  query?: Record<string, unknown>;\n  params?: Record<string, unknown>;\n  headers?: Record<string, string>;\n}\n\n/**\n * Abstract transport for `$container` proxies.\n *\n * Concrete subclasses translate a `(container, action, config)` call\n * into an HTTP request that reaches the running container. The default\n * binding on Node throws — apps must register either a\n * `NodeContainerProvider` (with `url` on each primitive) or the\n * Cloudflare workerd variant.\n */\nexport abstract class ContainerProvider {\n  protected readonly log = $logger();\n\n  /**\n   * Invoke a remote action on the container. Subclasses do the work;\n   * the default implementation rejects to make missing wiring obvious.\n   */\n  public async invoke(\n    container: ContainerPrimitive,\n    action: string,\n    config: ContainerInvokeConfig,\n  ): Promise<unknown> {\n    void config;\n    throw new AlephaError(\n      `No ContainerProvider configured for container '${container.name}' (action '${action}'). ` +\n        `Set up alepha/containers via AlephaContainers and either supply 'url' (Node) or build for target=cloudflare.`,\n    );\n  }\n\n  /**\n   * Helper: build the fetch path/body for an action call. Kept as a\n   * protected method so workerd and Node providers share the wire\n   * shape — `POST /api/<action>` with the JSON body, query params on\n   * the URL, and the request headers merged in.\n   */\n  protected buildRequest(\n    action: string,\n    config: ContainerInvokeConfig,\n  ): { path: string; init: RequestInit } {\n    const params = new URLSearchParams();\n    if (config.query) {\n      for (const [k, v] of Object.entries(config.query)) {\n        if (v !== undefined && v !== null) params.set(k, String(v));\n      }\n    }\n\n    let path = `/api/${action}`;\n    if (config.params) {\n      for (const [k, v] of Object.entries(config.params)) {\n        path = path.replace(`:${k}`, encodeURIComponent(String(v)));\n      }\n    }\n\n    const search = params.toString();\n    if (search) path += `?${search}`;\n\n    const init: RequestInit = {\n      method: \"POST\",\n      headers: {\n        \"content-type\": \"application/json\",\n        ...(config.headers ?? {}),\n      },\n      body: config.body !== undefined ? JSON.stringify(config.body) : undefined,\n    };\n\n    return { path, init };\n  }\n}\n","import { $inject, AlephaError, createPrimitive, KIND, Primitive } from \"alepha\";\nimport type { ContainerPrimitiveOptions } from \"../interfaces/ContainerOptions.ts\";\nimport { ContainerProvider } from \"../providers/ContainerProvider.ts\";\n\n/**\n * `$container` — typed RPC client to a containerized Alepha app.\n *\n * Returns a typed Proxy whose method calls map 1:1 to the target\n * controller's `$action` endpoints. The wire format mirrors what a\n * normal Alepha server exposes (`POST /api/<method>` with a JSON body),\n * so the container is literally a tiny Alepha worker.\n *\n * Transport is owned by the active {@link ContainerProvider}:\n * - `target=cloudflare` → `CloudflareContainerProvider` routes through\n *   the Containers binding (`env.<NAME>.getContainer(...).fetch()`).\n * - Node (with `url` set) → `NodeContainerProvider` uses plain\n *   `fetch()` against the configured URL.\n *\n * Build-time, `BuildCloudflareTask.enhanceContainers` walks\n * `alepha.primitives($container)` to emit the matching `wrangler.jsonc`\n * entries and Durable Object class declarations into\n * `main.cloudflare.js`.\n *\n * @example\n * ```ts\n * import { $container } from \"alepha/containers\";\n * import type { RocketController } from \"@alepha/rocket\";\n *\n * class DeployService {\n *   rocket = $container<RocketController>({\n *     image: \"alepha/rocket:latest\",\n *     port: 3000,\n *     sleepAfter: \"15m\",\n *   });\n *\n *   async deploy() {\n *     return this.rocket.createJob({ body: { op: \"up\" } });\n *   }\n * }\n * ```\n */\nexport const $container = <T extends object = any>(\n  options: ContainerPrimitiveOptions,\n): ContainerProxy<T> => {\n  if (!options.image) {\n    throw new AlephaError(\"$container requires an 'image' option\");\n  }\n  const instance = createPrimitive(ContainerPrimitive, options);\n  return instance.proxy() as ContainerProxy<T>;\n};\n\n/**\n * Typed proxy returned by `$container<T>()`. Each `$action` member of\n * `T` becomes a callable returning the action's response body.\n *\n * The runtime shape is a `Proxy(primitive)` — own-property reads hit the\n * underlying `ContainerPrimitive` (so `alepha.primitives($container)`\n * still finds it via the `instanceof Primitive` check inside\n * `Alepha.new()`), and anything else is treated as an action name and\n * routed through the active `ContainerProvider`.\n */\nexport type ContainerProxy<T extends object> = {\n  [K in keyof T]: T[K] extends (...args: infer A) => infer R\n    ? (...args: A) => Promise<Awaited<R>>\n    : (config?: {\n        body?: unknown;\n        query?: unknown;\n        params?: unknown;\n      }) => Promise<any>;\n};\n\nexport class ContainerPrimitive extends Primitive<ContainerPrimitiveOptions> {\n  protected readonly provider = $inject(ContainerProvider);\n\n  public get name(): string {\n    return this.options.name ?? this.config.propertyKey;\n  }\n\n  /**\n   * Build the typed Proxy. The target is the primitive itself so\n   * `instanceof Primitive` keeps working (required by Alepha's\n   * primitive registration in `Alepha.new`). Property reads that match\n   * an own/inherited member return that member; anything else is\n   * treated as an action name and routed through the provider.\n   */\n  public proxy<T extends object = any>(): ContainerProxy<T> {\n    const primitive = this;\n    return new Proxy(primitive as any, {\n      get(target: any, prop: string | symbol, receiver: any) {\n        if (typeof prop === \"symbol\" || prop in target) {\n          return Reflect.get(target, prop, receiver);\n        }\n        return (config: any = {}) =>\n          primitive.provider.invoke(primitive, prop as string, config);\n      },\n    }) as ContainerProxy<T>;\n  }\n}\n\n$container[KIND] = ContainerPrimitive;\n","import { $inject, Alepha, AlephaError } from \"alepha\";\nimport type { ContainerPrimitive } from \"../primitives/$container.ts\";\nimport {\n  type ContainerInvokeConfig,\n  ContainerProvider,\n} from \"./ContainerProvider.ts\";\n\n/**\n * In-process test provider.\n *\n * Resolves the action name against `LinkProvider`'s registered links in\n * the SAME Alepha instance — effectively calling the \"containerized\"\n * controller as if it were local. Use it in tests: register the\n * controller class on the test container alongside the consumer and\n * substitute `ContainerProvider` with `MockContainerProvider`.\n *\n * @example\n * ```ts\n * const alepha = Alepha.create()\n *   .with(AlephaContainers)\n *   .with(RocketController)\n *   .with(MyApp)\n *   .with({ provide: ContainerProvider, use: MockContainerProvider });\n * ```\n */\nexport class MockContainerProvider extends ContainerProvider {\n  protected readonly alepha = $inject(Alepha);\n\n  public override async invoke(\n    container: ContainerPrimitive,\n    action: string,\n    config: ContainerInvokeConfig,\n  ): Promise<unknown> {\n    void container;\n    // Lazy-resolve LinkProvider so tests that don't load `alepha/server/links`\n    // still get a clear error message.\n    const linkProviderClass = await this.loadLinkProvider();\n    const linkProvider = this.alepha.inject(linkProviderClass) as {\n      follow: (\n        name: string,\n        config?: Record<string, unknown>,\n      ) => Promise<unknown>;\n    };\n    return await linkProvider.follow(action, {\n      body: config.body,\n      query: config.query,\n      params: config.params,\n      headers: config.headers,\n    });\n  }\n\n  protected async loadLinkProvider(): Promise<any> {\n    try {\n      const mod = await import(\"alepha/server/links\");\n      return mod.LinkProvider;\n    } catch {\n      throw new AlephaError(\n        \"MockContainerProvider needs 'alepha/server/links' to be available — add AlephaServerLinks to the test app.\",\n      );\n    }\n  }\n}\n","import { AlephaError } from \"alepha\";\nimport type { ContainerPrimitive } from \"../primitives/$container.ts\";\nimport {\n  type ContainerInvokeConfig,\n  ContainerProvider,\n} from \"./ContainerProvider.ts\";\n\n/**\n * Node (dev / test / non-Cloudflare) container provider.\n *\n * Routes proxy calls through plain `fetch()` against the URL given on\n * the `$container` primitive. If no `url` is supplied, calls throw —\n * v1 deliberately has no Docker spawning. This is the \"temporary, not\n * perfect\" Node path documented in the spec; the longer-term plan is\n * to plug in a `target=docker` adapter once that lands.\n */\nexport class NodeContainerProvider extends ContainerProvider {\n  public override async invoke(\n    container: ContainerPrimitive,\n    action: string,\n    config: ContainerInvokeConfig,\n  ): Promise<unknown> {\n    const url = this.resolveUrl(container);\n    if (!url) {\n      throw new AlephaError(\n        `Container '${container.name}' has no 'url' configured — NodeContainerProvider cannot reach the container.`,\n      );\n    }\n\n    const { path, init } = this.buildRequest(action, config);\n    const response = await fetch(`${url.replace(/\\/$/, \"\")}${path}`, init);\n\n    if (!response.ok) {\n      const text = await response.text().catch(() => \"\");\n      throw new AlephaError(\n        `Container '${container.name}' action '${action}' failed: ${response.status} ${response.statusText}${\n          text ? ` — ${text}` : \"\"\n        }`,\n      );\n    }\n\n    const contentType = response.headers.get(\"content-type\") ?? \"\";\n    if (contentType.includes(\"application/json\")) {\n      return await response.json();\n    }\n    return await response.text();\n  }\n\n  protected resolveUrl(container: ContainerPrimitive): string | undefined {\n    const url = container.options.url;\n    return typeof url === \"function\" ? url() : url;\n  }\n}\n","import { $module } from \"alepha\";\nimport { $container } from \"./primitives/$container.ts\";\nimport { ContainerProvider } from \"./providers/ContainerProvider.ts\";\nimport { MockContainerProvider } from \"./providers/MockContainerProvider.ts\";\nimport { NodeContainerProvider } from \"./providers/NodeContainerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./interfaces/ContainerOptions.ts\";\nexport * from \"./primitives/$container.ts\";\nexport * from \"./providers/ContainerProvider.ts\";\nexport * from \"./providers/MockContainerProvider.ts\";\nexport * from \"./providers/NodeContainerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Type-safe RPC clients for ephemeral containerized Alepha apps.\n *\n * **Features:**\n * - `$container<T>()` directive returns a typed Proxy onto a remote\n *   Alepha controller's `$action` endpoints — the wire format is the\n *   same `POST /api/<method>` shape served by every Alepha server.\n * - Pluggable transport: Node (plain `fetch` against a configured URL),\n *   Mock (in-process call via `LinkProvider.follow` for tests),\n *   Cloudflare workerd (`getContainer().fetch()` through the Containers\n *   binding — see `alepha/containers` workerd entry).\n * - Build-time integration: `BuildCloudflareTask.enhanceContainers`\n *   emits the matching wrangler bindings and Durable Object class\n *   declarations.\n *\n * The Node binding is the \"temporary, not perfect\" path documented in\n * the spec — apps need to provide an explicit `url` per primitive\n * until a `target=docker` adapter ships.\n *\n * @module alepha.containers\n */\nexport const AlephaContainers = $module({\n  name: \"alepha.containers\",\n  primitives: [$container],\n  services: [ContainerProvider],\n  variants: [MockContainerProvider, NodeContainerProvider],\n  register: (alepha) => {\n    alepha.with({\n      optional: true,\n      provide: ContainerProvider,\n      use: alepha.isTest() ? MockContainerProvider : NodeContainerProvider,\n    });\n  },\n});\n"],"mappings":"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"}

package/dist/containers/core/index.workerd.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.workerd.js","names":[],"sources":["../../../src/containers/core/providers/ContainerProvider.ts","../../../src/containers/core/primitives/$container.ts","../../../src/containers/core/providers/CloudflareContainerProvider.ts","../../../src/containers/core/index.workerd.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport type { ContainerPrimitive } from \"../primitives/$container.ts\";\n\nexport interface ContainerInvokeConfig {\n  body?: unknown;\n  query?: Record<string, unknown>;\n  params?: Record<string, unknown>;\n  headers?: Record<string, string>;\n}\n\n/**\n * Abstract transport for `$container` proxies.\n *\n * Concrete subclasses translate a `(container, action, config)` call\n * into an HTTP request that reaches the running container. The default\n * binding on Node throws — apps must register either a\n * `NodeContainerProvider` (with `url` on each primitive) or the\n * Cloudflare workerd variant.\n */\nexport abstract class ContainerProvider {\n  protected readonly log = $logger();\n\n  /**\n   * Invoke a remote action on the container. Subclasses do the work;\n   * the default implementation rejects to make missing wiring obvious.\n   */\n  public async invoke(\n    container: ContainerPrimitive,\n    action: string,\n    config: ContainerInvokeConfig,\n  ): Promise<unknown> {\n    void config;\n    throw new AlephaError(\n      `No ContainerProvider configured for container '${container.name}' (action '${action}'). ` +\n        `Set up alepha/containers via AlephaContainers and either supply 'url' (Node) or build for target=cloudflare.`,\n    );\n  }\n\n  /**\n   * Helper: build the fetch path/body for an action call. Kept as a\n   * protected method so workerd and Node providers share the wire\n   * shape — `POST /api/<action>` with the JSON body, query params on\n   * the URL, and the request headers merged in.\n   */\n  protected buildRequest(\n    action: string,\n    config: ContainerInvokeConfig,\n  ): { path: string; init: RequestInit } {\n    const params = new URLSearchParams();\n    if (config.query) {\n      for (const [k, v] of Object.entries(config.query)) {\n        if (v !== undefined && v !== null) params.set(k, String(v));\n      }\n    }\n\n    let path = `/api/${action}`;\n    if (config.params) {\n      for (const [k, v] of Object.entries(config.params)) {\n        path = path.replace(`:${k}`, encodeURIComponent(String(v)));\n      }\n    }\n\n    const search = params.toString();\n    if (search) path += `?${search}`;\n\n    const init: RequestInit = {\n      method: \"POST\",\n      headers: {\n        \"content-type\": \"application/json\",\n        ...(config.headers ?? {}),\n      },\n      body: config.body !== undefined ? JSON.stringify(config.body) : undefined,\n    };\n\n    return { path, init };\n  }\n}\n","import { $inject, AlephaError, createPrimitive, KIND, Primitive } from \"alepha\";\nimport type { ContainerPrimitiveOptions } from \"../interfaces/ContainerOptions.ts\";\nimport { ContainerProvider } from \"../providers/ContainerProvider.ts\";\n\n/**\n * `$container` — typed RPC client to a containerized Alepha app.\n *\n * Returns a typed Proxy whose method calls map 1:1 to the target\n * controller's `$action` endpoints. The wire format mirrors what a\n * normal Alepha server exposes (`POST /api/<method>` with a JSON body),\n * so the container is literally a tiny Alepha worker.\n *\n * Transport is owned by the active {@link ContainerProvider}:\n * - `target=cloudflare` → `CloudflareContainerProvider` routes through\n *   the Containers binding (`env.<NAME>.getContainer(...).fetch()`).\n * - Node (with `url` set) → `NodeContainerProvider` uses plain\n *   `fetch()` against the configured URL.\n *\n * Build-time, `BuildCloudflareTask.enhanceContainers` walks\n * `alepha.primitives($container)` to emit the matching `wrangler.jsonc`\n * entries and Durable Object class declarations into\n * `main.cloudflare.js`.\n *\n * @example\n * ```ts\n * import { $container } from \"alepha/containers\";\n * import type { RocketController } from \"@alepha/rocket\";\n *\n * class DeployService {\n *   rocket = $container<RocketController>({\n *     image: \"alepha/rocket:latest\",\n *     port: 3000,\n *     sleepAfter: \"15m\",\n *   });\n *\n *   async deploy() {\n *     return this.rocket.createJob({ body: { op: \"up\" } });\n *   }\n * }\n * ```\n */\nexport const $container = <T extends object = any>(\n  options: ContainerPrimitiveOptions,\n): ContainerProxy<T> => {\n  if (!options.image) {\n    throw new AlephaError(\"$container requires an 'image' option\");\n  }\n  const instance = createPrimitive(ContainerPrimitive, options);\n  return instance.proxy() as ContainerProxy<T>;\n};\n\n/**\n * Typed proxy returned by `$container<T>()`. Each `$action` member of\n * `T` becomes a callable returning the action's response body.\n *\n * The runtime shape is a `Proxy(primitive)` — own-property reads hit the\n * underlying `ContainerPrimitive` (so `alepha.primitives($container)`\n * still finds it via the `instanceof Primitive` check inside\n * `Alepha.new()`), and anything else is treated as an action name and\n * routed through the active `ContainerProvider`.\n */\nexport type ContainerProxy<T extends object> = {\n  [K in keyof T]: T[K] extends (...args: infer A) => infer R\n    ? (...args: A) => Promise<Awaited<R>>\n    : (config?: {\n        body?: unknown;\n        query?: unknown;\n        params?: unknown;\n      }) => Promise<any>;\n};\n\nexport class ContainerPrimitive extends Primitive<ContainerPrimitiveOptions> {\n  protected readonly provider = $inject(ContainerProvider);\n\n  public get name(): string {\n    return this.options.name ?? this.config.propertyKey;\n  }\n\n  /**\n   * Build the typed Proxy. The target is the primitive itself so\n   * `instanceof Primitive` keeps working (required by Alepha's\n   * primitive registration in `Alepha.new`). Property reads that match\n   * an own/inherited member return that member; anything else is\n   * treated as an action name and routed through the provider.\n   */\n  public proxy<T extends object = any>(): ContainerProxy<T> {\n    const primitive = this;\n    return new Proxy(primitive as any, {\n      get(target: any, prop: string | symbol, receiver: any) {\n        if (typeof prop === \"symbol\" || prop in target) {\n          return Reflect.get(target, prop, receiver);\n        }\n        return (config: any = {}) =>\n          primitive.provider.invoke(primitive, prop as string, config);\n      },\n    }) as ContainerProxy<T>;\n  }\n}\n\n$container[KIND] = ContainerPrimitive;\n","import { $inject, Alepha, AlephaError } from \"alepha\";\nimport type { ContainerPrimitive } from \"../primitives/$container.ts\";\nimport {\n  type ContainerInvokeConfig,\n  ContainerProvider,\n} from \"./ContainerProvider.ts\";\n\n/**\n * Cloudflare Workers (workerd) container provider.\n *\n * Routes proxy calls through the Cloudflare Containers binding bound on\n * `env.<NAME>`, using a single shared instance per container\n * (`getContainer(env.NAME, \"shared\")`). The binding is generated by\n * `BuildCloudflareTask.enhanceContainers` from the `$container`\n * primitives discovered in the app.\n *\n * The runtime `env` object is pulled from the Alepha store key\n * `cloudflare.env` — the worker entry point publishes it there on every\n * fetch (`__alepha.set(\"cloudflare.env\", env)`).\n */\nexport class CloudflareContainerProvider extends ContainerProvider {\n  protected readonly alepha = $inject(Alepha);\n\n  public override async invoke(\n    container: ContainerPrimitive,\n    action: string,\n    config: ContainerInvokeConfig,\n  ): Promise<unknown> {\n    const env = this.alepha.store.get(\"cloudflare.env\") as\n      | Record<string, unknown>\n      | undefined;\n    if (!env) {\n      throw new AlephaError(\n        `CloudflareContainerProvider could not resolve 'cloudflare.env' from the store — is the app running on workerd?`,\n      );\n    }\n\n    const binding = env[container.name.toUpperCase()] as\n      | {\n          getContainer?: (id: string) => {\n            fetch(req: Request): Promise<Response>;\n          };\n        }\n      | undefined;\n\n    if (!binding?.getContainer) {\n      throw new AlephaError(\n        `Cloudflare Containers binding '${container.name.toUpperCase()}' not found on env — check wrangler.jsonc.`,\n      );\n    }\n\n    const instance = binding.getContainer(\"shared\");\n    const { path, init } = this.buildRequest(action, config);\n    const request = new Request(`http://container${path}`, init);\n    const response = await instance.fetch(request);\n\n    if (!response.ok) {\n      const text = await response.text().catch(() => \"\");\n      throw new AlephaError(\n        `Container '${container.name}' action '${action}' failed: ${response.status} ${response.statusText}${\n          text ? ` — ${text}` : \"\"\n        }`,\n      );\n    }\n\n    const contentType = response.headers.get(\"content-type\") ?? \"\";\n    if (contentType.includes(\"application/json\")) {\n      return await response.json();\n    }\n    return await response.text();\n  }\n}\n","import { $module } from \"alepha\";\nimport { $container } from \"./primitives/$container.ts\";\nimport { CloudflareContainerProvider } from \"./providers/CloudflareContainerProvider.ts\";\nimport { ContainerProvider } from \"./providers/ContainerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./interfaces/ContainerOptions.ts\";\nexport * from \"./primitives/$container.ts\";\nexport * from \"./providers/CloudflareContainerProvider.ts\";\nexport * from \"./providers/ContainerProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Type-safe RPC clients for ephemeral containerized Alepha apps,\n * Cloudflare workerd build.\n *\n * Auto-binds `CloudflareContainerProvider` so `$container()` calls\n * route through `env.<NAME>.getContainer(...).fetch()`. Pair with\n * `BuildCloudflareTask.enhanceContainers` (in `alepha/cli/core`) which\n * emits the wrangler.jsonc bindings and DO class declarations.\n *\n * @module alepha.containers\n */\nexport const AlephaContainers = $module({\n  name: \"alepha.containers\",\n  primitives: [$container],\n  services: [ContainerProvider, CloudflareContainerProvider],\n  register: (alepha) => {\n    alepha.with({\n      optional: true,\n      provide: ContainerProvider,\n      use: CloudflareContainerProvider,\n    });\n  },\n});\n"],"mappings":"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"}

package/src/cli/core/templates/componentsJsonTs.ts

@@ -1,39 +0,0 @@
-/**
- * `components.json` is the shadcn CLI's project config — it tells
- * `shadcn add` where to drop primitives, which tailwind tokens to use,
- * which icon library to wire up, and which custom registries to resolve.
- *
- * Aliases follow shadcn's defaults (`@/components`, `@/lib/utils`) so the
- * CLI honors them across `init` + `add` calls. Alepha app code lives at
- * `src/web/` (Home, AppRouter, …) and the shadcn primitives live at
- * `src/components/` — kept separate to make the registry components
- * trivially upgradable via `shadcn add --overwrite`.
- *
- * The `registries` block pre-wires the public Alepha registry — consumers
- * can immediately run e.g. `shadcn add @alepha/auth-login`.
- */
-export const componentsJsonTs = () =>
-  `{
-  "$schema": "https://ui.shadcn.com/schema.json",
-  "style": "new-york",
-  "rsc": false,
-  "tsx": true,
-  "tailwind": {
-    "config": "",
-    "css": "src/main.css",
-    "baseColor": "neutral",
-    "cssVariables": true
-  },
-  "aliases": {
-    "components": "@/components",
-    "utils": "@/lib/utils",
-    "ui": "@/components/ui",
-    "lib": "@/lib",
-    "hooks": "@/hooks"
-  },
-  "iconLibrary": "lucide",
-  "registries": {
-    "@alepha": "https://alepha.dev/r/{name}.json"
-  }
-}
-`;

package/src/cli/core/templates/saasAdminLayoutTsx.ts

@@ -1,77 +0,0 @@
-/**
- * SaaS admin layout — full AppShell on /admin with a sidebar, breadcrumbs,
- * a Sonner toaster, and a confirm provider. The page list grows with
- * whatever `admin-*` registry components the user adds.
- *
- * All UI primitives come from `src/components/*` where `shadcn add` drops
- * them; alepha app code lives in `src/web/*` and references them via the
- * `@/components/*` alias.
- */
-export const saasAdminLayoutTsx = () =>
-  `import { AppShell } from "@/components/app-shell/app-shell";
-import { Toaster } from "@/components/ui/sonner";
-import { TooltipProvider } from "@/components/ui/tooltip";
-import { DialogProvider } from "@/components/use-dialog/use-dialog";
-import { NestedView, useRouterState } from "alepha/react/router";
-import { ShieldCheck, Users } from "lucide-react";
-
-const NAV = [
-  {
-    label: "Identity",
-    items: [
-      { href: "/admin/users", label: "Users", icon: Users },
-      { href: "/admin/sessions", label: "Sessions", icon: ShieldCheck },
-    ],
-  },
-] as const;
-
-const findCrumbs = (pathname: string): { label: string; href?: string }[] => {
-  for (const group of NAV) {
-    const match = group.items.find((it) => it.href === pathname);
-    if (match) return [{ label: group.label }, { label: match.label }];
-  }
-  return [];
-};
-
-const AdminLayout = () => {
-  const state = useRouterState();
-  const crumbs = findCrumbs(state.url.pathname);
-
-  return (
-    <TooltipProvider>
-      <DialogProvider>
-        <AppShell
-          brand={
-            <a
-              href="/admin"
-              className="flex items-center gap-2 px-2 py-2 font-semibold group-data-[collapsible=icon]:justify-center group-data-[collapsible=icon]:px-0"
-            >
-              <span className="bg-primary text-primary-foreground flex size-7 shrink-0 items-center justify-center rounded">
-                α
-              </span>
-              <span className="truncate group-data-[collapsible=icon]:hidden">
-                Admin
-              </span>
-            </a>
-          }
-          nav={NAV.map((group) => ({
-            label: group.label,
-            items: group.items.map((it) => ({
-              href: it.href,
-              label: it.label,
-              icon: it.icon,
-              active: it.href === state.url.pathname,
-            })),
-          }))}
-          breadcrumbs={crumbs.length ? crumbs : undefined}
-        >
-          <NestedView />
-        </AppShell>
-        <Toaster />
-      </DialogProvider>
-    </TooltipProvider>
-  );
-};
-
-export default AdminLayout;
-`;

package/src/cli/core/templates/saasAdminPagesTsx.ts

@@ -1,26 +0,0 @@
-/**
- * Admin pages — each is a thin wrapper around the matching `admin-*`
- * registry component (placed at `src/components/admin/*`). The starter
- * ships with Users + Sessions; add more by `shadcn add @alepha/admin-…`
- * and a matching `$page(...)` in AppRouter.
- */
-
-export const saasAdminUsersTsx = () =>
-  `import { AdminUsers } from "@/components/admin/admin-users";
-
-const AdminUsersPage = () => {
-  return <AdminUsers />;
-};
-
-export default AdminUsersPage;
-`;
-
-export const saasAdminSessionsTsx = () =>
-  `import { AdminSessions } from "@/components/admin/admin-sessions";
-
-const AdminSessionsPage = () => {
-  return <AdminSessions />;
-};
-
-export default AdminSessionsPage;
-`;

package/src/cli/core/templates/saasAuthLayoutTsx.ts

@@ -1,22 +0,0 @@
-/**
- * SaaS auth layout — route parent for every /auth/* page (login, register,
- * reset-password, verify-email), mounted as children so they share it.
- *
- * The auth-* blocks from the registry are self-contained full-page layouts
- * (they own their own min-height, centering and padding), so this layout is
- * just a passthrough — wrapping them in another centered, padded, full-height
- * box would overflow the viewport and add a scrollbar.
- */
-export const saasAuthLayoutTsx = () =>
-  `import { NestedView } from "alepha/react/router";
-
-const AuthLayout = () => {
-  return (
-    <div className="bg-background">
-      <NestedView />
-    </div>
-  );
-};
-
-export default AuthLayout;
-`;

package/src/cli/core/templates/saasAuthPagesTsx.ts

@@ -1,62 +0,0 @@
-/**
- * Per-page wrapper around the registry components. The registry component
- * receives the realm config from the page loader; the page itself stays a
- * thin shell so apps can layer their branding around it.
- *
- * Registry components land at `src/components/auth/*` (shadcn defaults).
- */
-
-export const saasAuthLoginTsx = () =>
-  `import { AuthLogin } from "@/components/auth/auth-login";
-import type { RealmConfig } from "alepha/api/users";
-
-export interface AuthLoginPageProps {
-  realmConfig: RealmConfig;
-}
-
-const AuthLoginPage = (props: AuthLoginPageProps) => {
-  return <AuthLogin realmConfig={props.realmConfig} />;
-};
-
-export default AuthLoginPage;
-`;
-
-export const saasAuthRegisterTsx = () =>
-  `import { AuthRegister } from "@/components/auth/auth-register";
-import type { RealmConfig } from "alepha/api/users";
-
-export interface AuthRegisterPageProps {
-  realmConfig: RealmConfig;
-}
-
-const AuthRegisterPage = (props: AuthRegisterPageProps) => {
-  return <AuthRegister realmConfig={props.realmConfig} />;
-};
-
-export default AuthRegisterPage;
-`;
-
-export const saasAuthResetPasswordTsx = () =>
-  `import { AuthResetPassword } from "@/components/auth/auth-reset-password";
-import type { RealmConfig } from "alepha/api/users";
-
-export interface AuthResetPasswordPageProps {
-  realmConfig: RealmConfig;
-}
-
-const AuthResetPasswordPage = (props: AuthResetPasswordPageProps) => {
-  return <AuthResetPassword realmConfig={props.realmConfig} />;
-};
-
-export default AuthResetPasswordPage;
-`;
-
-export const saasAuthVerifyEmailTsx = () =>
-  `import { AuthVerifyEmail } from "@/components/auth/auth-verify-email";
-
-const AuthVerifyEmailPage = () => {
-  return <AuthVerifyEmail />;
-};
-
-export default AuthVerifyEmailPage;
-`;

package/src/cli/core/templates/saasRealmProviderTs.ts

@@ -1,52 +0,0 @@
-/**
- * Realm provider scaffolded by `alepha init --saas`.
- *
- * Minimal hello-world setup: credentials login with email, admins seeded
- * from the `ADMIN_EMAILS` env var, and an `admin:ui` permission used by the
- * AppRouter to gate `/admin/*`. The default `admin` role grants `*` (so it
- * inherits `admin:ui`); the default `user` role excludes `admin:*` (so
- * non-admins get a 403 before the shell renders).
- *
- * Admin emails are read from the environment, never hard-coded — they are
- * deployment config (different per environment, and personal data) and
- * belong in `.env`, not in committed source.
- */
-export const saasRealmProviderTs = () => {
-  return `import { $env, t } from "alepha";
-import { $realm } from "alepha/api/users";
-import { $permission } from "alepha/security";
-
-export class RealmProvider {
-  /**
-   * Permission required to open the admin UI. Wired into AppRouter.adminLayout
-   * via \`$secure({ permissions: ["admin:ui"] })\`.
-   */
-  adminUi = $permission({
-    group: "admin",
-    name: "ui",
-    description: "Access to the admin UI shell",
-  });
-
-  /**
-   * Admin emails — set \`ADMIN_EMAILS\` in \`.env\` (comma-separated for
-   * several). Keep emails out of source: they are config, not code.
-   */
-  protected readonly env = $env(
-    t.object({
-      ADMIN_EMAILS: t.text({ default: "" }),
-    }),
-  );
-
-  realm = $realm({
-    settings: {
-      adminEmails: this.env.ADMIN_EMAILS.split(",")
-        .map((email) => email.trim())
-        .filter(Boolean),
-    },
-    identities: {
-      credentials: true,
-    },
-  });
-}
-`;
-};

package/src/cli/platform/services/NamingService.ts

@@ -1,54 +0,0 @@
-/**
- * Generates deterministic resource names for cloud deployments.
- *
- * Pattern: `<project>-<env>`.
- *
- * All segments are slugified (lowercase, alphanumeric + dashes, max 63
- * chars). One app per workspace — see `alepha platform`.
- */
-export class NamingService {
-  public forContext(project: string, env: string): NamingContext {
-    const prefix = `${this.slugify(project)}-${this.slugify(env)}`;
-    return new NamingContext(prefix);
-  }
-
-  public slugify(name: string): string {
-    return name
-      .toLowerCase()
-      .replace(/[^a-z0-9]+/g, "-")
-      .replace(/^-+|-+$/g, "")
-      .slice(0, 63);
-  }
-}
-
-export class NamingContext {
-  protected readonly prefix: string;
-
-  constructor(prefix: string) {
-    this.prefix = prefix;
-  }
-
-  public worker(): string {
-    return this.prefix;
-  }
-
-  public d1(): string {
-    return this.prefix;
-  }
-
-  public hyperdrive(): string {
-    return this.prefix;
-  }
-
-  public r2(): string {
-    return this.prefix;
-  }
-
-  public kv(): string {
-    return this.prefix;
-  }
-
-  public queue(): string {
-    return this.prefix;
-  }
-}