@obh/forge 0.2.0

package/dist/generators/api.js

@@ -0,0 +1,375 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addApiApp = addApiApp;
+/**
+ * Generates the API app. Two framework flavours (Hono, Express) share the same
+ * framework-agnostic core: a pg pool with a `withTx` helper, a transaction-aware
+ * domain event bus (subscribers auto-loaded from src/bus.d/*), and — unless
+ * disabled — a real `notes` domain (CRUD over Postgres that emits domain facts
+ * inside its transaction). Routes auto-mount from src/routes/*.
+ */
+function addApiApp(plan, opts) {
+    const dir = "apps/api";
+    const hono = opts.framework === "hono";
+    plan.create(`${dir}/package.json`, packageJson(opts.scope, opts.framework), "API app package.json");
+    plan.create(`${dir}/tsconfig.json`, tsconfig(), "API tsconfig");
+    // Framework-agnostic core.
+    plan.create(`${dir}/src/config.ts`, CONFIG, "API config loader");
+    plan.create(`${dir}/src/db.ts`, DB, "API Postgres pool + withTx");
+    plan.create(`${dir}/src/bus.ts`, BUS, "in-app domain event bus (auto-loads src/bus.d/*)");
+    plan.create(`${dir}/src/bus.d/.gitkeep`, "", "bus subscribers directory");
+    // Framework-specific server + health route.
+    plan.create(`${dir}/src/server.ts`, hono ? SERVER_HONO : SERVER_EXPRESS, "API server (auto-mounts src/routes/*)");
+    plan.create(`${dir}/src/routes/health.ts`, hono ? HEALTH_HONO : HEALTH_EXPRESS, "health route");
+    // Example domain.
+    if (opts.example === "notes") {
+        plan.create(`${dir}/src/domain/notes.ts`, NOTES_DOMAIN, "notes domain (real CRUD + emits facts in-tx)");
+        plan.create(`${dir}/src/routes/notes.ts`, hono ? NOTES_HONO : NOTES_EXPRESS, "notes CRUD route");
+        plan.create("migrations/0002_notes.sql", NOTES_SQL, "notes table migration");
+    }
+    plan.create(`${dir}/Dockerfile`, DOCKERFILE, "API Dockerfile");
+}
+function packageJson(scope, framework) {
+    const deps = framework === "hono"
+        ? { "@hono/node-server": "^1.12.0", hono: "^4.5.0", pg: "^8.12.0" }
+        : { cors: "^2.8.5", express: "^4.19.2", pg: "^8.12.0" };
+    const devDeps = framework === "hono"
+        ? { "@types/node": "^20.14.0", "@types/pg": "^8.11.6", tsx: "^4.16.0", typescript: "^5.5.4", vitest: "^2.0.5" }
+        : {
+            "@types/cors": "^2.8.17",
+            "@types/express": "^4.17.21",
+            "@types/node": "^20.14.0",
+            "@types/pg": "^8.11.6",
+            tsx: "^4.16.0",
+            typescript: "^5.5.4",
+            vitest: "^2.0.5",
+        };
+    return (JSON.stringify({
+        name: `${scope}/api`,
+        version: "0.1.0",
+        private: true,
+        scripts: {
+            dev: "tsx watch src/server.ts",
+            build: "tsc -p tsconfig.json",
+            typecheck: "tsc -p tsconfig.json --noEmit",
+            start: "node dist/server.js",
+            test: "vitest run --passWithNoTests",
+        },
+        dependencies: deps,
+        devDependencies: devDeps,
+    }, null, 2) + "\n");
+}
+function tsconfig() {
+    return (JSON.stringify({
+        extends: "../../tsconfig.base.json",
+        compilerOptions: { rootDir: "src", outDir: "dist" },
+        include: ["src"],
+        exclude: ["dist", "node_modules", "src/**/*.test.ts"],
+    }, null, 2) + "\n");
+}
+const CONFIG = `export interface Config {
+  port: number
+  databaseUrl: string
+  corsOrigins: string[]
+}
+
+export function loadConfig(): Config {
+  const databaseUrl = process.env.DATABASE_URL
+  if (!databaseUrl) throw new Error("DATABASE_URL is not set")
+  return {
+    port: Number(process.env.PORT) || 8080,
+    databaseUrl,
+    // Comma-separated allowlist; defaults to open in dev only.
+    corsOrigins: (process.env.CORS_ORIGINS ?? "*").split(",").map((s) => s.trim()),
+  }
+}
+`;
+const DB = `import { Pool, type PoolClient } from "pg"
+import { loadConfig } from "./config"
+
+export const pool = new Pool({ connectionString: loadConfig().databaseUrl })
+
+export type Tx = PoolClient
+
+/** Run work inside a transaction, committing on success and rolling back on error. */
+export async function withTx<T>(fn: (tx: Tx) => Promise<T>): Promise<T> {
+  const client = await pool.connect()
+  try {
+    await client.query("begin")
+    const result = await fn(client)
+    await client.query("commit")
+    return result
+  } catch (err) {
+    await client.query("rollback")
+    throw err
+  } finally {
+    client.release()
+  }
+}
+`;
+const BUS = `import { readdirSync } from "node:fs"
+import path from "node:path"
+import type { Tx } from "./db"
+
+/**
+ * Domain event bus. Domain code emits facts inside its transaction; subscribers
+ * (dropped into src/bus.d/* by \`forge add events\`, etc.) receive them on the
+ * SAME transaction, so durability follows the write. With no subscribers, emit
+ * is a real no-op — not a stub.
+ */
+export type DomainEmitter = (tx: Tx, name: string, payload: unknown) => Promise<void>
+
+const emitters: DomainEmitter[] = []
+
+export function onEmit(fn: DomainEmitter): void {
+  emitters.push(fn)
+}
+
+export async function emit(tx: Tx, name: string, payload: unknown): Promise<void> {
+  for (const fn of emitters) await fn(tx, name, payload)
+}
+
+// Auto-load subscribers. Each module in bus.d calls onEmit() at import time.
+const dir = path.join(__dirname, "bus.d")
+try {
+  for (const file of readdirSync(dir).sort()) {
+    if (!/\\.(ts|js)$/.test(file) || file.endsWith(".d.ts")) continue
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    require(path.join(dir, file))
+  }
+} catch {
+  // no bus.d yet
+}
+`;
+const NOTES_DOMAIN = `import { randomUUID } from "node:crypto"
+import { emit } from "../bus"
+import { pool, withTx } from "../db"
+
+export interface Note {
+  id: string
+  title: string
+  body: string
+  createdAt: string
+  updatedAt: string
+}
+
+interface Row {
+  id: string
+  title: string
+  body: string
+  created_at: Date
+  updated_at: Date
+}
+
+const toNote = (r: Row): Note => ({
+  id: r.id,
+  title: r.title,
+  body: r.body,
+  createdAt: r.created_at.toISOString(),
+  updatedAt: r.updated_at.toISOString(),
+})
+
+export async function listNotes(): Promise<Note[]> {
+  const { rows } = await pool.query<Row>("select * from notes order by created_at desc")
+  return rows.map(toNote)
+}
+
+export async function getNote(id: string): Promise<Note | null> {
+  const { rows } = await pool.query<Row>("select * from notes where id = $1", [id])
+  return rows[0] ? toNote(rows[0]) : null
+}
+
+export async function createNote(input: { title: string; body?: string }): Promise<Note> {
+  return withTx(async (tx) => {
+    const { rows } = await tx.query<Row>(
+      "insert into notes (id, title, body) values ($1, $2, $3) returning *",
+      [randomUUID(), input.title, input.body ?? ""],
+    )
+    const note = toNote(rows[0])
+    await emit(tx, "note.created", note)
+    return note
+  })
+}
+
+export async function updateNote(id: string, input: { title?: string; body?: string }): Promise<Note | null> {
+  return withTx(async (tx) => {
+    const { rows } = await tx.query<Row>(
+      "update notes set title = coalesce($2, title), body = coalesce($3, body), updated_at = now() where id = $1 returning *",
+      [id, input.title ?? null, input.body ?? null],
+    )
+    if (!rows[0]) return null
+    const note = toNote(rows[0])
+    await emit(tx, "note.updated", note)
+    return note
+  })
+}
+
+export async function removeNote(id: string): Promise<boolean> {
+  return withTx(async (tx) => {
+    const { rows } = await tx.query<Row>("delete from notes where id = $1 returning *", [id])
+    if (!rows[0]) return false
+    await emit(tx, "note.deleted", toNote(rows[0]))
+    return true
+  })
+}
+`;
+const NOTES_SQL = `-- 0002_notes.sql — example domain table.
+create table if not exists notes (
+  id uuid primary key,
+  title text not null,
+  body text not null default '',
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now()
+);
+`;
+const SERVER_HONO = `import { serve } from "@hono/node-server"
+import { Hono } from "hono"
+import { readdirSync } from "node:fs"
+import path from "node:path"
+import { loadConfig } from "./config"
+
+const app = new Hono()
+
+// Auto-mount every route module in ./routes. Each exports register(app).
+const routesDir = path.join(__dirname, "routes")
+for (const file of readdirSync(routesDir).sort()) {
+  if (!/\\.(ts|js)$/.test(file) || file.endsWith(".d.ts")) continue
+  // eslint-disable-next-line @typescript-eslint/no-var-requires
+  const mod = require(path.join(routesDir, file))
+  if (typeof mod.register === "function") mod.register(app)
+}
+
+const cfg = loadConfig()
+serve({ fetch: app.fetch, port: cfg.port })
+console.log("api listening on :" + cfg.port)
+`;
+const SERVER_EXPRESS = `import cors from "cors"
+import express from "express"
+import { readdirSync } from "node:fs"
+import path from "node:path"
+import { loadConfig } from "./config"
+
+const cfg = loadConfig()
+const app = express()
+app.use(cors({ origin: cfg.corsOrigins.includes("*") ? true : cfg.corsOrigins }))
+app.use(express.json())
+
+// Auto-mount every route module in ./routes. Each exports register(app).
+const routesDir = path.join(__dirname, "routes")
+for (const file of readdirSync(routesDir).sort()) {
+  if (!/\\.(ts|js)$/.test(file) || file.endsWith(".d.ts")) continue
+  // eslint-disable-next-line @typescript-eslint/no-var-requires
+  const mod = require(path.join(routesDir, file))
+  if (typeof mod.register === "function") mod.register(app)
+}
+
+app.listen(cfg.port, () => console.log("api listening on :" + cfg.port))
+`;
+const HEALTH_HONO = `import type { Hono } from "hono"
+import { pool } from "../db"
+
+export function register(app: Hono): void {
+  app.get("/health", async (c) => {
+    try {
+      await pool.query("select 1")
+      return c.json({ status: "ok" })
+    } catch {
+      return c.json({ status: "degraded" }, 503)
+    }
+  })
+}
+`;
+const HEALTH_EXPRESS = `import type { Express, Request, Response } from "express"
+import { pool } from "../db"
+
+export function register(app: Express): void {
+  app.get("/health", async (_req: Request, res: Response) => {
+    try {
+      await pool.query("select 1")
+      res.json({ status: "ok" })
+    } catch {
+      res.status(503).json({ status: "degraded" })
+    }
+  })
+}
+`;
+const NOTES_HONO = `import type { Hono } from "hono"
+import * as notes from "../domain/notes"
+
+export function register(app: Hono): void {
+  app.get("/notes", async (c) => c.json(await notes.listNotes()))
+
+  app.get("/notes/:id", async (c) => {
+    const note = await notes.getNote(c.req.param("id"))
+    return note ? c.json(note) : c.json({ error: "not found" }, 404)
+  })
+
+  app.post("/notes", async (c) => {
+    const body = await c.req.json<{ title?: string; body?: string }>()
+    if (!body.title) return c.json({ error: "title is required" }, 400)
+    return c.json(await notes.createNote({ title: body.title, body: body.body }), 201)
+  })
+
+  app.put("/notes/:id", async (c) => {
+    const body = await c.req.json<{ title?: string; body?: string }>()
+    const note = await notes.updateNote(c.req.param("id"), body)
+    return note ? c.json(note) : c.json({ error: "not found" }, 404)
+  })
+
+  app.delete("/notes/:id", async (c) => {
+    const ok = await notes.removeNote(c.req.param("id"))
+    return ok ? c.body(null, 204) : c.json({ error: "not found" }, 404)
+  })
+}
+`;
+const NOTES_EXPRESS = `import type { Express, Request, Response } from "express"
+import * as notes from "../domain/notes"
+
+export function register(app: Express): void {
+  app.get("/notes", async (_req: Request, res: Response) => {
+    res.json(await notes.listNotes())
+  })
+
+  app.get("/notes/:id", async (req: Request, res: Response) => {
+    const note = await notes.getNote(req.params.id)
+    if (!note) return res.status(404).json({ error: "not found" })
+    res.json(note)
+  })
+
+  app.post("/notes", async (req: Request, res: Response) => {
+    if (!req.body.title) return res.status(400).json({ error: "title is required" })
+    res.status(201).json(await notes.createNote({ title: req.body.title, body: req.body.body }))
+  })
+
+  app.put("/notes/:id", async (req: Request, res: Response) => {
+    const note = await notes.updateNote(req.params.id, req.body)
+    if (!note) return res.status(404).json({ error: "not found" })
+    res.json(note)
+  })
+
+  app.delete("/notes/:id", async (req: Request, res: Response) => {
+    const ok = await notes.removeNote(req.params.id)
+    if (!ok) return res.status(404).json({ error: "not found" })
+    res.status(204).end()
+  })
+}
+`;
+const DOCKERFILE = `# Built by lwd from apps/api (git.path = "apps/api").
+FROM node:20-alpine AS builder
+WORKDIR /app
+RUN npm install -g pnpm@9
+COPY package.json ./
+RUN pnpm install --no-frozen-lockfile
+COPY . .
+RUN pnpm build
+
+FROM node:20-alpine
+WORKDIR /app
+RUN npm install -g pnpm@9
+COPY package.json ./
+RUN pnpm install --prod --no-frozen-lockfile
+COPY --from=builder /app/dist ./dist
+EXPOSE 8080
+CMD ["node", "dist/server.js"]
+`;
+//# sourceMappingURL=api.js.map

package/dist/generators/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/generators/api.ts"],"names":[],"mappings":"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"}

package/dist/generators/lwd.d.ts

@@ -0,0 +1,12 @@
+import type { ForgeManifest } from "../types";
+import type { Plan } from "../project/plan";
+/** Compute the ordered, de-duplicated list of lwd secret names for an app. */
+export declare function computeSecrets(manifest: ForgeManifest, includeAuth: boolean): string[];
+/**
+ * Generate lwd deployment manifests for the project's current shape. Emits
+ * secret NAMES only (values set via `lwd secret set`). Encodes the two hard lwd
+ * constraints: a scalable API can't carry a `[[services]]` db, and a separate
+ * worker app can't reach another app's isolated backing network.
+ */
+export declare function addLwdManifests(plan: Plan, manifest: ForgeManifest): void;
+//# sourceMappingURL=lwd.d.ts.map

package/dist/generators/lwd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lwd.d.ts","sourceRoot":"","sources":["../../src/generators/lwd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,aAAa,EAAY,MAAM,UAAU,CAAA;AACvE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAU3C,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,GAAG,MAAM,EAAE,CAQtF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CA2BzE"}

package/dist/generators/lwd.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeSecrets = computeSecrets;
+exports.addLwdManifests = addLwdManifests;
+/** Base secret names every project needs, plus per-capability additions. */
+const CAPABILITY_SECRETS = {
+    "api-keys": ["API_KEYS_PEPPER"],
+    webhooks: ["WEBHOOK_SECRET_ENCRYPTION_KEY"],
+    files: ["S3_ACCESS_KEY_ID", "S3_SECRET_ACCESS_KEY"],
+    notifications: ["SMTP_URL"],
+};
+/** Compute the ordered, de-duplicated list of lwd secret names for an app. */
+function computeSecrets(manifest, includeAuth) {
+    const secrets = new Set(["DATABASE_URL"]);
+    if (includeAuth)
+        secrets.add("JWT_SECRET");
+    for (const [cap, enabled] of Object.entries(manifest.platform)) {
+        if (!enabled)
+            continue;
+        for (const s of CAPABILITY_SECRETS[cap] ?? [])
+            secrets.add(s);
+    }
+    return [...secrets];
+}
+/**
+ * Generate lwd deployment manifests for the project's current shape. Emits
+ * secret NAMES only (values set via `lwd secret set`). Encodes the two hard lwd
+ * constraints: a scalable API can't carry a `[[services]]` db, and a separate
+ * worker app can't reach another app's isolated backing network.
+ */
+function addLwdManifests(plan, manifest) {
+    const name = manifest.name;
+    const topology = manifest.deploy.topology;
+    const hasApi = manifest.apps.api !== undefined || Object.values(manifest.apps).some((a) => a.role === "api");
+    const hasAdmin = Object.values(manifest.apps).some((a) => a.role === "web");
+    const hasWorker = Object.values(manifest.apps).some((a) => a.role === "worker");
+    const includeAuth = true;
+    const secrets = computeSecrets(manifest, includeAuth);
+    const gitUrl = repoUrl(manifest.deploy.repo, name);
+    if (hasApi) {
+        plan.create(`deploy/api.lwd.toml`, apiManifest(name, topology, secrets, gitUrl), "lwd manifest: API surface");
+    }
+    if (hasAdmin) {
+        plan.create(`deploy/admin.lwd.toml`, adminManifest(name, gitUrl), "lwd manifest: admin frontend");
+    }
+    if (hasWorker) {
+        plan.create(`deploy/worker.lwd.toml`, workerManifest(name, secrets.filter((s) => s === "DATABASE_URL"), gitUrl), "lwd manifest: worker surface");
+    }
+    if (topology === "split") {
+        plan.create(`deploy/db.lwd.toml`, dbManifest(name), "lwd manifest: dedicated Postgres");
+    }
+    if (!manifest.deploy.repo) {
+        plan.nextStep(`No git repo known — set the [git].url in deploy/*.lwd.toml before deploying.`);
+    }
+    plan.nextStep(`Set secret values: lwd secret set ${name}-api ${secrets.join(" ")}`);
+}
+/** Resolve a repo slug/url (or none) into a git URL for the manifests. */
+function repoUrl(repo, name) {
+    if (!repo)
+        return `https://github.com/${name}/${name}`;
+    if (repo.startsWith("http") || repo.startsWith("git@"))
+        return repo.replace(/\.git$/, "");
+    return `https://github.com/${repo}`;
+}
+function tomlList(items) {
+    return "[" + items.map((s) => `"${s}"`).join(", ") + "]";
+}
+function apiManifest(name, topology, secrets, gitUrl) {
+    // In split topology the API scales (replicas) and the DB is a separate app.
+    // In small topology the API co-locates a Postgres backing service.
+    const scalable = topology === "split";
+    const lines = [
+        `name    = "${name}-api"`,
+        `domain  = "api.${name}.example.com"`,
+        `port    = 8080`,
+        `env     = { NODE_ENV = "production", LOG_LEVEL = "info" }`,
+        `secrets = ${tomlList(secrets)}`,
+    ];
+    if (scalable)
+        lines.push(`replicas = 2`);
+    lines.push(``, `[git]`, `url  = "${gitUrl}"`, `ref  = "main"`, `path = "apps/api"`, ``, `[build]`, `dockerfile = "Dockerfile"`, ``, `[health]`, `path    = "/health"`, `timeout = "30s"`);
+    if (!scalable) {
+        lines.push(``, `# Small topology: Postgres co-located as a backing service.`, `# NOTE: a co-located backing service means this app cannot use replicas > 1.`, `[[services]]`, `name    = "db"`, `image   = "postgres:16"`, `env     = { POSTGRES_USER = "${name}", POSTGRES_DB = "${name}" }`, `secrets = ["POSTGRES_PASSWORD"]`, `volume  = "db-data:/var/lib/postgresql/data"`);
+    }
+    return lines.join("\n") + "\n";
+}
+function adminManifest(name, gitUrl) {
+    // Root-context build: the admin imports the workspace SDK, so the build needs
+    // the whole repo. git.path = "." and the Dockerfile lives under apps/admin.
+    return [
+        `name   = "${name}-admin"`,
+        `domain = "app.${name}.example.com"`,
+        `port   = 80`,
+        ``,
+        `[git]`,
+        `url  = "${gitUrl}"`,
+        `ref  = "main"`,
+        `path = "."`,
+        ``,
+        `[build]`,
+        `context    = "."`,
+        `dockerfile = "apps/admin/Dockerfile"`,
+        ``,
+        `[health]`,
+        `path    = "/"`,
+        `timeout = "30s"`,
+        ``,
+    ].join("\n");
+}
+function workerManifest(name, secrets, gitUrl) {
+    return [
+        `name    = "${name}-worker"`,
+        `# lwd has no worker type: a worker is a normal surface app and still needs a`,
+        `# domain + health port. In split topology point DATABASE_URL at ${name}-db.`,
+        `domain  = "worker.internal.${name}.example.com"`,
+        `port    = 8080`,
+        `env     = { NODE_ENV = "production", ROLE = "worker" }`,
+        `secrets = ${tomlList(secrets.length ? secrets : ["DATABASE_URL"])}`,
+        ``,
+        `[git]`,
+        `url  = "${gitUrl}"`,
+        `ref  = "main"`,
+        `path = "apps/worker"`,
+        ``,
+        `[build]`,
+        `dockerfile = "Dockerfile"`,
+        ``,
+        `[health]`,
+        `path = "/health"`,
+        ``,
+    ].join("\n");
+}
+function dbManifest(name) {
+    return [
+        `name    = "${name}-db"`,
+        `image   = "postgres:16"`,
+        `port    = 5432`,
+        `env     = { POSTGRES_DB = "${name}", POSTGRES_USER = "${name}" }`,
+        `secrets = ["POSTGRES_PASSWORD"]`,
+        ``,
+    ].join("\n");
+}
+//# sourceMappingURL=lwd.js.map

package/dist/generators/lwd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lwd.js","sourceRoot":"","sources":["../../src/generators/lwd.ts"],"names":[],"mappings":"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"}

package/dist/generators/mobile.d.ts

@@ -0,0 +1,16 @@
+import type { ExampleDomain } from "../types";
+import type { Plan } from "../project/plan";
+export interface MobileOptions {
+    scope: string;
+    /** App directory name, e.g. "mobile" or "driver". */
+    name: string;
+    example: ExampleDomain;
+}
+/**
+ * Generates an Expo (React Native) app that drives the API through the shared
+ * SDK. Ships to app stores via EAS, so it gets no lwd manifest or Dockerfile.
+ * No build/typecheck scripts, so the workspace CI (pnpm -r build/typecheck)
+ * skips it — Expo builds happen through EAS, not CI.
+ */
+export declare function addMobileApp(plan: Plan, opts: MobileOptions): void;
+//# sourceMappingURL=mobile.d.ts.map

package/dist/generators/mobile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile.d.ts","sourceRoot":"","sources":["../../src/generators/mobile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAE3C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,aAAa,CAAA;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAoDlE"}