@palbase/backend 2.0.2 → 3.0.0

package/docs/llms.txt

@@ -1,6 +1,6 @@
 # Palbase Backend SDK (`@palbase/backend`)
 
-> File-based TypeScript backend SDK. Endpoints use `req` (PBRequest) + imported service singletons (`Database`, `Cache`, …). Workers/jobs/hooks/webhooks use a `ctx` object. Not Express, not Supabase Edge Functions.
+> File-based TypeScript backend SDK. All handler types import service singletons (`Database`, `Cache`, …). Trigger arg differs by type: endpoints use `req`, workers `(payload, meta)`, jobs `(meta)`, hooks/webhooks `(event, meta)`. Middleware is the one exception (`ctx`). Not Express, not Supabase Edge Functions.
 
 ## Docs
 
@@ -10,7 +10,9 @@
 - [endpoints](./endpoints.md)
 - [database](./database.md)
 - [schema](./schema.md)
+- [migrations](./migrations.md)
 - [services](./services.md)
+- [resources](./resources.md)
 - [errors](./errors.md)
 - [background](./background.md)
 - [events](./events.md)

package/docs/migrations.md

@@ -0,0 +1,98 @@
+# Migrations
+
+`db/schema.ts` is the single source of truth for your Postgres schema. On every
+deploy, Palbase diffs your declared schema against the live branch database and
+reconciles it — but *how* it reconciles depends on whether the change is safe to
+apply automatically.
+
+## Two kinds of change
+
+### 1. Additive — auto-applied, no migration file
+
+A new table, or a new **nullable** or **defaulted** column, is additive: the
+deploy applies it automatically (`CREATE TABLE` / `ADD COLUMN`) with no manual
+step and no backfill risk. Just edit `db/schema.ts` and deploy.
+
+```ts
+// before
+todos: {
+  id: uuid().primaryKey().defaultRandom(),
+  title: text().notNull(),
+}
+
+// after — additive: `notes` (nullable) + `priority` (defaulted) auto-apply on deploy
+todos: {
+  id: uuid().primaryKey().defaultRandom(),
+  title: text().notNull(),
+  notes: text().nullable(),
+  priority: text().nullable().default("normal"),
+}
+```
+
+> A new **NOT NULL column without a default** is NOT additive-safe on a table
+> that already has rows (there is nothing to put in the existing rows). Make it
+> `.nullable()`, give it a `.default(...)`, or apply it as an explicit migration
+> (add nullable → backfill → set NOT NULL).
+
+### 2. Destructive / type-changing — needs an explicit migration
+
+Renaming or dropping a column, changing a column's type, or adding a NOT NULL
+constraint can lose or corrupt existing data — so the deploy's **drift-gate
+blocks them** and the deploy fails until you provide an explicit migration.
+Write the SQL yourself in `db/migrations/`:
+
+```
+db/migrations/
+  001_user_id_to_text.up.sql
+  001_user_id_to_text.down.sql
+```
+
+```sql
+-- 001_user_id_to_text.up.sql
+ALTER TABLE todos ALTER COLUMN user_id TYPE text USING user_id::text;
+```
+
+```sql
+-- 001_user_id_to_text.down.sql
+ALTER TABLE todos ALTER COLUMN user_id TYPE uuid USING user_id::uuid;
+```
+
+Migrations are golang-migrate style: numbered `NNN_name.up.sql` / `.down.sql`
+pairs, applied in order and tracked so each runs exactly once (idempotent).
+`db/schema.ts` always describes the **end state**; the migration describes **how
+existing data gets there**. Keep the two in sync — after the migration lands,
+`schema.ts` should already reflect the new column type.
+
+## The drift-gate
+
+On deploy, Palbase compares `db/schema.ts` to the live database:
+
+- **Additive** diffs → auto-applied.
+- **Type-changing / destructive** diffs **with** a matching migration → the
+  migration runs.
+- **Type-changing / destructive** diffs **without** a migration → the deploy
+  **aborts** and your currently-running version keeps serving.
+
+This is deliberate: it stops an accidental column-type change from silently
+dropping production data. A blocked deploy is a prompt to write the migration,
+not a failure to work around.
+
+## Local dev: `palbase serve` uses the deployed database
+
+`palbase serve` runs your controllers locally but proxies `Database` and
+`ctx.*` to the **deployed** branch — it does **not** spin up a local Postgres or
+apply migrations locally. So when your local `db/schema.ts` or `db/migrations/`
+is ahead of what's deployed, serve prints a note: new tables/columns won't exist
+until you push. Deploy to apply them.
+
+## Workflow
+
+1. Edit `db/schema.ts`.
+2. **Additive** change? → `git push`. It auto-migrates on deploy.
+3. **Type change / rename / drop?** → add `db/migrations/NNN_*.up.sql` (+
+   `.down.sql`), then `git push`. The runner applies it; without it the
+   drift-gate blocks the deploy.
+4. `palbase serve` warns locally until the change is deployed.
+
+See [schema.md](./schema.md) for the column builders and typed
+`Database.tables.*` access.

package/docs/resources.md

@@ -0,0 +1,94 @@
+# Resources
+
+A `Resource` models one external connection — a pooled datastore, a stateless
+API client, or a per-user factory. You put it in `resources/`, export an
+instance, and **do not register it**: the framework discovers it, sets it up
+once at boot, and drains it on shutdown. On top of that lifecycle you expose
+your own clean facade.
+
+```ts
+import { Resource } from "@palbase/backend";
+```
+
+## Lifecycle (boot scope — not per request)
+
+A resource is created once at process boot — NOT per request. The framework:
+
+1. calls `init(env)` **once**, with only the secrets the resource declared;
+2. (optionally) calls `shutdown()` on SIGTERM, in reverse boot order.
+
+The instance lives for the whole process; your facade methods are called
+per-request. This makes "reconnect on every request" structurally impossible.
+
+## Pooled datastore — `init` + `shutdown`
+
+```ts
+import { Resource } from "@palbase/backend";
+import neo4j, { type Driver, type Session } from "neo4j-driver";
+
+export class Neo4jResource extends Resource {
+  static secrets = ["NEO4J_URL", "NEO4J_USER", "NEO4J_PASSWORD"] as const;
+  private driver!: Driver;
+  async init(env: { NEO4J_URL: string; NEO4J_USER: string; NEO4J_PASSWORD: string }) {
+    this.driver = neo4j.driver(env.NEO4J_URL, neo4j.auth.basic(env.NEO4J_USER, env.NEO4J_PASSWORD));
+  }
+  async shutdown() {
+    await this.driver.close();
+  }
+  session(): Session {
+    return this.driver.session();
+  }
+}
+
+export const graph = new Neo4jResource();
+```
+
+## Stateless API client — `init` only
+
+```ts
+import { Resource } from "@palbase/backend";
+import { Client } from "@googlemaps/google-maps-services-js";
+
+export class GoogleResource extends Resource {
+  static secrets = ["GOOGLE_MAPS_KEY"] as const;
+  private client = new Client();
+  private key = "";
+  init(env: { GOOGLE_MAPS_KEY: string }) {
+    this.key = env.GOOGLE_MAPS_KEY;
+  }
+  nearby(lat: number, lng: number) {
+    return this.client.placesNearby({ params: { location: { lat, lng }, radius: 1500, key: this.key } });
+  }
+}
+
+export const google = new GoogleResource();
+```
+
+A per-user (OAuth) resource adds a factory method on the base, e.g.
+`github.forUser(token)` — the same single model covers pooled, stateless, and
+per-user.
+
+## Secrets
+
+`static secrets` is the contract:
+
+- It **types** the `env` passed to `init` — only the declared names are
+  present, each a `string`. An undeclared key is a compile error.
+- A declared secret that is **missing at boot fails the deploy**, naming the
+  secret. Secrets are branch-scoped; set them with `palbase secret set NAME ...`
+  or in Studio. A resource is initialised once at boot, so rotating a secret
+  needs a redeploy/restart.
+
+`secrets` is optional — a resource that needs none simply omits it and gets an
+empty `env`.
+
+## Using a resource
+
+Import the singleton and call your facade — services and handlers reach
+resources the same way they reach `Database`:
+
+```ts
+import { google } from "../resources/google.js";
+
+const results = (await google.nearby(41.0, 29.0)).data.results;
+```

package/docs/routing.md

@@ -1,34 +1,67 @@
-# File-based routing
+# Routing
 
-The path of a file under `endpoints/` plus its filename determine the route.
-The filename is the HTTP method.
+Routes are declared in code. A **handler** is one endpoint unit (schema + thin
+logic) with NO route on it; a **controller** is a route map (method+path →
+handler). Putting a controller file under `controllers/` mounts it — there is no
+central router and no manual registration.
 
-| File | Route |
-|------|-------|
-| `endpoints/hello/get.ts` | `GET /hello` |
-| `endpoints/items/post.ts` | `POST /items` |
-| `endpoints/posts/[id]/get.ts` | `GET /posts/:id` |
-| `endpoints/posts/[id]/patch.ts` | `PATCH /posts/:id` |
-| `endpoints/rooms/[id]/sessions/post.ts` | `POST /rooms/:id/sessions` |
+```ts
+import { defineController, route } from "@palbase/backend";
+```
 
-Rules:
+## Handlers — one endpoint per file, no route
+
+A handler declares everything that types `req` (`auth`/`input`/`output`/
+`errors`) and the logic; it has no method or path.
+
+```ts
+// handlers/places/import-nearby.ts
+import { defineHandler, z } from "@palbase/backend";
+import { placeService } from "../../services/place.service.js";
+
+export default defineHandler({
+  auth:   { required: true },
+  input:  z.object({ lat: z.number(), lng: z.number() }),
+  output: z.object({ imported: z.number() }),
+  errors: { quotaExceeded: { status: 429, code: "quota_exceeded" } },
+  handler: (req) => placeService.importNearby(req.input.lat, req.input.lng),
+});
+```
+
+## Controllers — the route map
 
-- The method file name is one of `get`, `post`, `put`, `patch`, `delete` (`.ts`).
-- A `[segment]` directory becomes a `:segment` path param, read via `req.params.segment`.
-- Each method file `export default defineEndpoint({...})` — one endpoint per file.
-- There is no central router file and no manual registration. Adding a file adds a route.
+A controller maps method+path to handlers with `route.get|post|put|patch|delete`.
+The route-map KEY is authoring sugar only (it is NOT the operationId).
 
 ```ts
-// endpoints/posts/[id]/get.ts  → GET /posts/:id
-import { defineEndpoint, z, Database, HttpError } from "@palbase/backend";
-
-export default defineEndpoint({
-  method: "GET",
-  output: z.object({ id: z.string(), title: z.string() }),
-  handler: async (req) => {
-    const post = await Database.findById("posts", req.params.id!);
-    if (!post) throw new HttpError(404, "post_not_found", "No such post");
-    return { id: post.id as string, title: post.title as string };
-  },
+// controllers/places.controller.ts
+import { defineController, route } from "@palbase/backend";
+import importNearby  from "../handlers/places/import-nearby.js";
+import addFavorite   from "../handlers/places/add-favorite.js";
+import listFavorites from "../handlers/places/list-favorites.js";
+
+export default defineController("/places", {
+  importNearby:  route.post("/import",    importNearby),
+  addFavorite:   route.post("/favorites", addFavorite),
+  listFavorites: route.get ("/favorites", listFavorites),
 });
 ```
+
+| Map key (sugar) | Method | Full path | operationId (flat) |
+|---|---|---|---|
+| `importNearby`  | POST | `/places/import`    | `postPlacesImport` |
+| `addFavorite`   | POST | `/places/favorites` | `postPlacesFavorites` |
+| `listFavorites` | GET  | `/places/favorites` | `getPlacesFavorites` |
+
+Rules:
+
+- The full path of a route is `basePath + subpath` (`"/places" + "/import"`).
+- A `{segment}` in a path becomes a route param, read via `req.params.segment`.
+- Each route value MUST be a `route.*(...)` result — a bare handler is a
+  compile error, which keeps logic out of controllers.
+- The operationId is derived FLAT from method + full path (`postPlacesImport`),
+  not from the map key. Change a verb with `route.post` → `route.put` — no file
+  rename.
+
+See [endpoints.md](./endpoints.md) for the full `defineHandler` config (`req`,
+auth, input/output, errors, middleware) reference.

package/docs/schema.md

@@ -1,36 +1,43 @@
 # Schema & typed database access
 
 Declare your tables in `db/schema.ts` with `defineSchema`. This drives
-migrations and, via `typedDatabase`, a fully-typed `.tables.*` API.
+[migrations](./migrations.md) (additive changes auto-apply on deploy; type
+changes need an explicit migration) and makes `Database.tables.*` typed
+everywhere — by default, with no import and no generic.
 
 ## Defining a schema
 
+The table NAME comes from the object key under `tables` — there is one
+canonical form.
+
 ```ts
 import {
-  defineSchema, table,
+  defineSchema,
   uuid, text, integer, boolean, timestamp, jsonb, enumType,
 } from "@palbase/backend";
 
 export default defineSchema({
-  rooms: table("rooms", {
-    id: uuid().primaryKey().defaultRandom(),
-    name: text().notNull(),
-    capacity: integer().nullable(),
-    is_active: boolean().default(true),
-    created_at: timestamp().defaultNow(),
-  }),
-  sessions: table("sessions", {
-    id: uuid().primaryKey().defaultRandom(),
-    room_id: uuid().notNull().references("rooms", "id").onDelete("cascade"),
-    user_id: uuid().notNull(),
-    data: jsonb().nullable(),
-    started_at: timestamp().defaultNow(),
-  }),
-  orders: table("orders", {
-    id: uuid().primaryKey().defaultRandom(),
-    status: enumType("order_status", ["pending", "paid", "shipped", "cancelled"]),
-    amount: integer().notNull(),
-  }),
+  tables: {
+    rooms: {
+      id: uuid().primaryKey().defaultRandom(),
+      name: text().notNull(),
+      capacity: integer().nullable(),
+      is_active: boolean().default(true),
+      created_at: timestamp().defaultNow(),
+    },
+    sessions: {
+      id: uuid().primaryKey().defaultRandom(),
+      room_id: uuid().notNull().references("rooms", "id").onDelete("cascade"),
+      user_id: uuid().notNull(),
+      data: jsonb().nullable(),
+      started_at: timestamp().defaultNow(),
+    },
+    orders: {
+      id: uuid().primaryKey().defaultRandom(),
+      status: enumType("order_status", ["pending", "paid", "shipped", "cancelled"]),
+      amount: integer().notNull(),
+    },
+  },
 });
 ```
 
@@ -51,32 +58,35 @@ Chainable modifiers: `.primaryKey()`, `.notNull()` (default), `.nullable()`,
 `.defaultNow()` (timestamp → `now()`), `.references(table, column)`,
 `.onDelete("cascade" | "set null" | "restrict" | "no action")`.
 
-## Typed DB access
+## Typed DB access — by default
 
-`typedDatabase(schema)` returns a typed facade. `insert` demands the right
-columns; rows come back typed; nullable columns are `T | null`.
+You do **not** wire anything per endpoint. Saving `db/schema.ts` regenerates
+`palbase-env.d.ts`, which types `Database.tables.<name>` everywhere — no import
+of the schema, no generic, no cast:
 
 ```ts
-import { defineEndpoint, z, typedDatabase } from "@palbase/backend";
-import schema from "../../db/schema.js";
-
-const Db = typedDatabase(schema);
+import { defineHandler, z, Database } from "@palbase/backend";
 
-export default defineEndpoint({
-  method: "POST",
+export default defineHandler({
   input: z.object({ name: z.string() }),
   output: z.object({ id: z.string(), name: z.string() }),
   handler: async (req) => {
-    const room = await Db.tables.rooms.insert({ name: req.input.name });
-    return { id: room.id, name: room.name };
+    const room = await Database.tables.rooms.insert({ name: req.input.name });
+    return { id: room.id, name: room.name }; // room.id: string ✓
+    // room.nope ← compile error
   },
 });
 ```
 
-Note the `.js` extension on `../../db/schema.js` even though the file is
-`db/schema.ts` — this is standard ESM module resolution; you still author the
-file as `.ts`.
+`Database.tables.<name>` exposes `insert`, `update(id, data)`, `delete(id)`,
+`findById(id)`, `findMany(query?)`, and `Database.transaction(fn)` yields a `tx`
+with the same typed tables. The raw string-keyed ops
+(`Database.insert("rooms", …)`, `Database.query(…)`) are still available for
+dynamic table names and read-only SQL.
 
-`Db.tables.<name>` exposes `insert`, `update(id, data)`, `delete(id)`,
-`findById(id)`, `findMany(query?)`, and `Db.transaction(fn)` mirrors the
-untyped transaction with typed tables.
+If you want a row type explicitly, import it from the generated env module:
+
+```ts
+import type { Tables } from "@palbase/backend/env";
+type Room = Tables["rooms"]["row"];
+```

package/docs/services.md

@@ -1,8 +1,8 @@
 # Services
 
-In **endpoints**, import service singletons from `@palbase/backend`. In
-**workers/jobs/hooks/webhooks**, the equivalents live on `ctx` (`ctx.cache`,
-`ctx.queue`, `ctx.log`, `ctx.db`).
+Import service singletons from `@palbase/backend` in every handler type —
+endpoints, workers, jobs, hooks, and webhooks all use the same imports. Only
+**middleware** uses a `ctx` argument (`ctx.db`, `ctx.log`, etc.).
 
 Available singletons: `Database`, `Documents`, `Storage`, `Cache`, `Queue`,
 `Log`, `Notifications`, `Flags`.
@@ -90,10 +90,9 @@ await Notifications.sms.send({ /* PalbaseSmsSendParams */ });
 ## Flags
 
 ```ts
-import { defineEndpoint, z, Flags } from "@palbase/backend";
+import { defineHandler, z, Flags } from "@palbase/backend";
 
-export default defineEndpoint({
-  method: "GET",
+export default defineHandler({
   auth: { required: true },           // req.user is non-null here
   output: z.object({ enabled: z.boolean() }),
   handler: async (req) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@palbase/backend",
-  "version": "2.0.2",
+  "version": "3.0.0",
   "description": "Palbase Backend SDK — defineEndpoint, context types, schema DSL",
   "license": "MIT",
   "repository": {
@@ -42,6 +42,16 @@
         "types": "./dist/db/index.d.cts",
         "default": "./dist/db/index.cjs"
       }
+    },
+    "./env": {
+      "import": {
+        "types": "./dist/db/env.d.ts",
+        "default": "./dist/db/env.js"
+      },
+      "require": {
+        "types": "./dist/db/env.d.cts",
+        "default": "./dist/db/env.cjs"
+      }
     }
   },
   "files": [

package/dist/chunk-4J3F32SH.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/db/schema.ts","../src/db/columns.ts"],"sourcesContent":["import type { ColumnBuilder } from \"./columns.js\";\n\n/**\n * A table definition with its columns.\n *\n * The `C` type parameter preserves the precise per-column phantom types so\n * that downstream mapped types (InsertShape, RowShape) can discriminate on\n * them. The default `Record<string, ColumnBuilder>` keeps all existing call\n * sites that use `TableDef` without a type argument (generator.ts, etc.)\n * compiling unchanged.\n */\nexport interface TableDef<\n  C extends Record<string, ColumnBuilder> = Record<string, ColumnBuilder>,\n> {\n  name: string;\n  columns: C;\n}\n\n/**\n * A schema definition containing multiple tables.\n *\n * The `T` type parameter preserves the exact `TableDef<...>` type for each\n * table so that `SchemaDef[\"tables\"][\"rooms\"]` resolves to the precise\n * `TableDef<{ id: ColumnBuilder<'uuid', false, true, never>; ... }>`.\n */\nexport interface SchemaDef<\n  T extends Record<string, TableDef> = Record<string, TableDef>,\n> {\n  tables: T;\n}\n\n/**\n * Define a table with a name and columns.\n *\n * The generic parameter `C` preserves each column's phantom type params so\n * that `InsertShape<T>` and `RowShape<T>` can derive precise TypeScript types\n * from the column builders. The runtime return shape is identical to before —\n * only the static type is widened.\n */\nexport function table<C extends Record<string, ColumnBuilder>>(\n  name: string,\n  columns: C,\n): TableDef<C> {\n  return { name, columns };\n}\n\n/** Define a schema containing multiple tables. */\nexport function defineSchema<T extends Record<string, TableDef>>(\n  tables: T,\n): SchemaDef<T> {\n  return { tables };\n}\n","/** On delete action for foreign key references. */\nexport type OnDeleteAction = 'cascade' | 'set null' | 'restrict' | 'no action';\n\n/** Column type identifiers. */\nexport type ColumnType = 'uuid' | 'text' | 'integer' | 'boolean' | 'timestamp' | 'jsonb' | 'enum';\n\n/** Base column definition shared by all column types. */\nexport interface ColumnDef {\n  type: ColumnType;\n  nullable: boolean;\n  primaryKey: boolean;\n  defaultValue?: unknown;\n  defaultRandom?: boolean;\n  defaultNow?: boolean;\n  references?: { table: string; column: string };\n  onDeleteAction?: OnDeleteAction;\n  enumName?: string;\n  enumValues?: string[];\n}\n\n// Phantom brand symbols — never have runtime values; exist only to force\n// TypeScript's structural type system to distinguish ColumnBuilder instances\n// with different type-param combinations. Without these, TS sees all\n// ColumnBuilder<K,...> as structurally identical and the first branch of\n// ColValue matches everything.\ndeclare const __colKind: unique symbol;\ndeclare const __colNullable: unique symbol;\ndeclare const __colHasDefault: unique symbol;\ndeclare const __colEnumValues: unique symbol;\n\n/**\n * Fluent column builder with phantom type params:\n *  K — ColumnType literal (e.g. \"text\", \"integer\")\n *  N — boolean: true when nullable() has been called last (false = NOT NULL)\n *  D — boolean: true when a default has been set\n *  E — enum value union (never for non-enum columns)\n *\n * All four params have defaults so bare `ColumnBuilder` (no args) still\n * satisfies `Record<string, ColumnBuilder>` in schema.ts without modification.\n *\n * The four `declare readonly` brand fields carry the phantom types into the\n * structural shape so that conditional types like ColValue<C> can discriminate\n * on K without requiring runtime values on those fields.\n */\nexport class ColumnBuilder<\n  K extends ColumnType = ColumnType,\n  N extends boolean = boolean,\n  D extends boolean = boolean,\n  E = unknown,\n> {\n  // These fields exist only in the type layer (declared, never initialised at\n  // runtime — TypeScript allows declared class members without an initializer\n  // in strict mode as long as they're never read at runtime).\n  declare readonly [__colKind]: K;\n  declare readonly [__colNullable]: N;\n  declare readonly [__colHasDefault]: D;\n  declare readonly [__colEnumValues]: E;\n\n  readonly _def: ColumnDef;\n\n  constructor(type: K, existingDef?: ColumnDef) {\n    this._def = existingDef ?? {\n      type,\n      nullable: false,\n      primaryKey: false,\n    };\n  }\n\n  /** Mark this column as the primary key. */\n  primaryKey(): ColumnBuilder<K, N, D, E> {\n    this._def.primaryKey = true;\n    return new ColumnBuilder<K, N, D, E>(this._def.type as K, this._def);\n  }\n\n  /** Mark this column as NOT NULL (default). */\n  notNull(): ColumnBuilder<K, false, D, E> {\n    this._def.nullable = false;\n    return new ColumnBuilder<K, false, D, E>(this._def.type as K, this._def);\n  }\n\n  /** Allow NULL values. */\n  nullable(): ColumnBuilder<K, true, D, E> {\n    this._def.nullable = true;\n    return new ColumnBuilder<K, true, D, E>(this._def.type as K, this._def);\n  }\n\n  /** Set a default value. */\n  default(value: unknown): ColumnBuilder<K, N, true, E> {\n    this._def.defaultValue = value;\n    return new ColumnBuilder<K, N, true, E>(this._def.type as K, this._def);\n  }\n\n  /** UUID: generate a random default (gen_random_uuid()). */\n  defaultRandom(): ColumnBuilder<K, N, true, E> {\n    this._def.defaultRandom = true;\n    return new ColumnBuilder<K, N, true, E>(this._def.type as K, this._def);\n  }\n\n  /** Timestamp: default to now(). */\n  defaultNow(): ColumnBuilder<K, N, true, E> {\n    this._def.defaultNow = true;\n    return new ColumnBuilder<K, N, true, E>(this._def.type as K, this._def);\n  }\n\n  /** Add a foreign key reference. */\n  references(table: string, column: string): ColumnBuilder<K, N, D, E> {\n    this._def.references = { table, column };\n    return new ColumnBuilder<K, N, D, E>(this._def.type as K, this._def);\n  }\n\n  /** Set the ON DELETE action for a foreign key reference. */\n  onDelete(action: OnDeleteAction): ColumnBuilder<K, N, D, E> {\n    this._def.onDeleteAction = action;\n    return new ColumnBuilder<K, N, D, E>(this._def.type as K, this._def);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Type extractors — imported by Task 2 to derive insert/row shapes.\n// ---------------------------------------------------------------------------\n\n/**\n * Extracts the TypeScript value type for a column, respecting nullability.\n * - \"uuid\" | \"text\" | \"timestamp\" → string (or string | null when N = true)\n * - \"integer\" → number\n * - \"boolean\" → boolean\n * - \"jsonb\" → unknown (opaque JSON)\n * - \"enum\" → E (the union of literal values)\n */\nexport type ColValue<C> =\n  C extends ColumnBuilder<'uuid' | 'text' | 'timestamp', infer N, infer _D, infer _E>\n    ? N extends true\n      ? string | null\n      : string\n    : C extends ColumnBuilder<'integer', infer N, infer _D, infer _E>\n      ? N extends true\n        ? number | null\n        : number\n      : C extends ColumnBuilder<'boolean', infer N, infer _D, infer _E>\n        ? N extends true\n          ? boolean | null\n          : boolean\n        : C extends ColumnBuilder<'jsonb', infer _N, infer _D, infer _E>\n          ? unknown\n          : C extends ColumnBuilder<'enum', infer N, infer _D, infer E>\n            ? N extends true\n              ? E | null\n              : E\n            : never;\n\n/**\n * True when a column is optional on INSERT:\n *  - nullable columns (N = true) — the DB allows NULL so the field may be omitted\n *  - columns with a default (D = true) — the DB fills in the value when absent\n */\nexport type ColIsOptionalOnInsert<C> =\n  C extends ColumnBuilder<infer _K, true, infer _D, infer _E>\n    ? true\n    : C extends ColumnBuilder<infer _K, infer _N, true, infer _E>\n      ? true\n      : false;\n\n// ---------------------------------------------------------------------------\n// Factory functions\n// ---------------------------------------------------------------------------\n\n/** Create a UUID column. */\nexport function uuid(): ColumnBuilder<'uuid', false, false, never> {\n  return new ColumnBuilder('uuid');\n}\n\n/** Create a TEXT column. */\nexport function text(): ColumnBuilder<'text', false, false, never> {\n  return new ColumnBuilder('text');\n}\n\n/** Create an INTEGER column. */\nexport function integer(): ColumnBuilder<'integer', false, false, never> {\n  return new ColumnBuilder('integer');\n}\n\n/** Create a BOOLEAN column. */\nexport function boolean(): ColumnBuilder<'boolean', false, false, never> {\n  return new ColumnBuilder('boolean');\n}\n\n/** Create a TIMESTAMP column. */\nexport function timestamp(): ColumnBuilder<'timestamp', false, false, never> {\n  return new ColumnBuilder('timestamp');\n}\n\n/** Create a JSONB column. */\nexport function jsonb(): ColumnBuilder<'jsonb', false, false, never> {\n  return new ColumnBuilder('jsonb');\n}\n\n/**\n * Create an ENUM column.\n * @param name   The PostgreSQL enum type name (used in DDL).\n * @param values A readonly tuple of valid string values — kept `const` so the\n *               union `V[number]` is as narrow as possible.\n */\nexport function enumType<const V extends readonly string[]>(\n  name: string,\n  values: V,\n): ColumnBuilder<'enum', false, false, V[number]> {\n  const builder = new ColumnBuilder<'enum', false, false, V[number]>('enum');\n  builder._def.enumName = name;\n  builder._def.enumValues = [...values];\n  return builder;\n}\n"],"mappings":";AAuCO,SAAS,MACd,MACA,SACa;AACb,SAAO,EAAE,MAAM,QAAQ;AACzB;AAGO,SAAS,aACd,QACc;AACd,SAAO,EAAE,OAAO;AAClB;;;ACPO,IAAM,gBAAN,MAAM,eAKX;AAAA,EASS;AAAA,EAET,YAAY,MAAS,aAAyB;AAC5C,SAAK,OAAO,eAAe;AAAA,MACzB;AAAA,MACA,UAAU;AAAA,MACV,YAAY;AAAA,IACd;AAAA,EACF;AAAA;AAAA,EAGA,aAAwC;AACtC,SAAK,KAAK,aAAa;AACvB,WAAO,IAAI,eAA0B,KAAK,KAAK,MAAW,KAAK,IAAI;AAAA,EACrE;AAAA;AAAA,EAGA,UAAyC;AACvC,SAAK,KAAK,WAAW;AACrB,WAAO,IAAI,eAA8B,KAAK,KAAK,MAAW,KAAK,IAAI;AAAA,EACzE;AAAA;AAAA,EAGA,WAAyC;AACvC,SAAK,KAAK,WAAW;AACrB,WAAO,IAAI,eAA6B,KAAK,KAAK,MAAW,KAAK,IAAI;AAAA,EACxE;AAAA;AAAA,EAGA,QAAQ,OAA8C;AACpD,SAAK,KAAK,eAAe;AACzB,WAAO,IAAI,eAA6B,KAAK,KAAK,MAAW,KAAK,IAAI;AAAA,EACxE;AAAA;AAAA,EAGA,gBAA8C;AAC5C,SAAK,KAAK,gBAAgB;AAC1B,WAAO,IAAI,eAA6B,KAAK,KAAK,MAAW,KAAK,IAAI;AAAA,EACxE;AAAA;AAAA,EAGA,aAA2C;AACzC,SAAK,KAAK,aAAa;AACvB,WAAO,IAAI,eAA6B,KAAK,KAAK,MAAW,KAAK,IAAI;AAAA,EACxE;AAAA;AAAA,EAGA,WAAWA,QAAe,QAA2C;AACnE,SAAK,KAAK,aAAa,EAAE,OAAAA,QAAO,OAAO;AACvC,WAAO,IAAI,eAA0B,KAAK,KAAK,MAAW,KAAK,IAAI;AAAA,EACrE;AAAA;AAAA,EAGA,SAAS,QAAmD;AAC1D,SAAK,KAAK,iBAAiB;AAC3B,WAAO,IAAI,eAA0B,KAAK,KAAK,MAAW,KAAK,IAAI;AAAA,EACrE;AACF;AAoDO,SAAS,OAAmD;AACjE,SAAO,IAAI,cAAc,MAAM;AACjC;AAGO,SAAS,OAAmD;AACjE,SAAO,IAAI,cAAc,MAAM;AACjC;AAGO,SAAS,UAAyD;AACvE,SAAO,IAAI,cAAc,SAAS;AACpC;AAGO,SAAS,UAAyD;AACvE,SAAO,IAAI,cAAc,SAAS;AACpC;AAGO,SAAS,YAA6D;AAC3E,SAAO,IAAI,cAAc,WAAW;AACtC;AAGO,SAAS,QAAqD;AACnE,SAAO,IAAI,cAAc,OAAO;AAClC;AAQO,SAAS,SACd,MACA,QACgD;AAChD,QAAM,UAAU,IAAI,cAA+C,MAAM;AACzE,UAAQ,KAAK,WAAW;AACxB,UAAQ,KAAK,aAAa,CAAC,GAAG,MAAM;AACpC,SAAO;AACT;","names":["table"]}

package/dist/chunk-L36JLUPO.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/db/typed-db.ts","../src/runtime.ts"],"sourcesContent":["/**\n * typed-db.ts — Task 2: TypedDB schema-derived insert/row shapes.\n *\n * Derives INSERT and full-row TypeScript types from a `defineSchema()` result\n * and wraps the untyped runtime `DBClient` with a typed facade.\n *\n * No value-any. No `as unknown as X`. The two narrow `as` casts in\n * `makeTypedTable` are safe because:\n *  - `data as Record<string, unknown>`: InsertShape<T> maps string keys to\n *    typed values; all value types are subsets of `unknown`, so the cast is\n *    structurally sound.\n *  - `result as RowShape<T>`: The runtime DBClient returns `Record<string,\n *    unknown>` which is the erased form of the typed row; we're narrowing back\n *    to the precise shape that the schema declared.\n * Both casts are narrowing only (not widening) and correctness is guaranteed\n * by the schema the caller provides.\n */\n\nimport type { ColValue, ColIsOptionalOnInsert, ColumnBuilder } from \"./columns.js\";\nimport type { TableDef, SchemaDef } from \"./schema.js\";\nimport type { DBClient, TxClient } from \"../endpoint.js\";\n\n// ---------------------------------------------------------------------------\n// Key discriminators — split a column map into required vs optional keys.\n// ---------------------------------------------------------------------------\n\n/** Keys of C whose columns are required on INSERT (not nullable, no default). */\ntype RequiredKeys<C> = {\n  [K in keyof C]: ColIsOptionalOnInsert<C[K]> extends true ? never : K;\n}[keyof C];\n\n/** Keys of C whose columns are optional on INSERT (nullable or has a default). */\ntype OptionalKeys<C> = {\n  [K in keyof C]: ColIsOptionalOnInsert<C[K]> extends true ? K : never;\n}[keyof C];\n\n// ---------------------------------------------------------------------------\n// Public shape types — exported so callers can reference them directly.\n// ---------------------------------------------------------------------------\n\n/**\n * The TypeScript type for an INSERT payload for table `T`.\n * - Required: columns that are NOT NULL and have no DB-level default.\n * - Optional: columns that are nullable or carry a default.\n *\n * When all columns are optional, `RequiredKeys<C>` resolves to `never` and\n * the first part becomes `{}`, which is a neutral element for `&`.\n */\nexport type InsertShape<T extends TableDef> = {\n  [K in RequiredKeys<T[\"columns\"]>]: ColValue<T[\"columns\"][K]>;\n} & {\n  [K in OptionalKeys<T[\"columns\"]>]?: ColValue<T[\"columns\"][K]>;\n};\n\n/**\n * The TypeScript type for a full row returned by the DB for table `T`.\n * Every column is present; nullable columns resolve to `T | null`.\n */\nexport type RowShape<T extends TableDef> = {\n  [K in keyof T[\"columns\"]]: ColValue<T[\"columns\"][K]>;\n};\n\n// ---------------------------------------------------------------------------\n// TypedTable + TypedDB interfaces.\n// ---------------------------------------------------------------------------\n\n/** A typed table accessor that mirrors the runtime DBClient surface. */\nexport interface TypedTable<T extends TableDef> {\n  insert(data: InsertShape<T>): Promise<RowShape<T>>;\n  update(id: string, data: Partial<InsertShape<T>>): Promise<RowShape<T>>;\n  delete(id: string): Promise<void>;\n  findById(id: string): Promise<RowShape<T> | null>;\n  findMany(query?: Partial<RowShape<T>>): Promise<RowShape<T>[]>;\n}\n\n/** A typed DB facade covering all tables declared in schema `S`. */\nexport interface TypedDB<S extends SchemaDef> {\n  tables: {\n    [K in keyof S[\"tables\"]]: TypedTable<S[\"tables\"][K]>;\n  };\n  transaction<T>(fn: (tx: TypedTx<S>) => Promise<T>): Promise<T>;\n}\n\n/** Transaction-scoped typed facade: same typed tables, no nested transaction. */\nexport interface TypedTx<S extends SchemaDef> {\n  tables: {\n    [K in keyof S[\"tables\"]]: TypedTable<S[\"tables\"][K]>;\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Runtime factory.\n// ---------------------------------------------------------------------------\n\n/**\n * Builds a typed table accessor that delegates every call to `raw` using the\n * runtime table name string. Two narrow `as` casts bridge the mapped-type\n * shapes to/from `Record<string, unknown>` — see module-level doc comment.\n *\n * The `raw` param is typed `TxClient` (the op surface shared by `DBClient` and\n * the transaction-scoped client) because this only ever calls the five\n * insert/update/delete/findById/findMany ops — never `transaction`. This lets\n * the same factory wrap both the top-level db and a tx without any cast.\n */\nfunction makeTypedTable<T extends TableDef<Record<string, ColumnBuilder>>>(\n  name: string,\n  raw: TxClient,\n): TypedTable<T> {\n  return {\n    insert: (data: InsertShape<T>) =>\n      raw.insert(name, data as Record<string, unknown>) as Promise<RowShape<T>>,\n\n    update: (id: string, data: Partial<InsertShape<T>>) =>\n      raw.update(name, id, data as Record<string, unknown>) as Promise<RowShape<T>>,\n\n    delete: (id: string) => raw.delete(name, id),\n\n    findById: (id: string) =>\n      raw.findById(name, id) as Promise<RowShape<T> | null>,\n\n    findMany: (query?: Partial<RowShape<T>>) =>\n      raw.findMany(name, query as Record<string, unknown> | undefined) as Promise<RowShape<T>[]>,\n  };\n}\n\n/**\n * Wraps a raw `DBClient` with the type-safe `TypedDB<S>` facade derived from\n * the provided schema. No behavior change — all calls delegate to `raw` with\n * the table name as a plain string.\n *\n * `buildTables` is the reusable factory that wraps any op-bearing client\n * (`TxClient` — the surface shared by `DBClient` and the transaction-scoped\n * client) into the typed tables map. It is used both for the top-level db\n * (wrapping `raw`) and inside `transaction`, where it wraps the raw `TxClient`\n * the runtime yields so the callback sees the same typed `.tables` API.\n *\n * `transaction` delegates straight to `raw.transaction`; the two narrow\n * `as TypedTx<S>` / `as TypedDB<S>` casts are single structural narrowings\n * from the dynamically-built tables object to the precise mapped type (TS\n * cannot infer through `Object.keys` iteration) — see module-level doc comment.\n */\nexport function makeTypedDB<S extends SchemaDef>(\n  schema: S,\n  raw: DBClient,\n): TypedDB<S> {\n  function buildTables(client: TxClient): Record<string, TypedTable<TableDef>> {\n    const tables = {} as Record<string, TypedTable<TableDef>>;\n    for (const key of Object.keys(schema.tables)) {\n      const tableDef = schema.tables[key];\n      if (tableDef !== undefined) {\n        tables[key] = makeTypedTable(tableDef.name, client);\n      }\n    }\n    return tables;\n  }\n\n  const result = {\n    tables: buildTables(raw),\n    transaction: <T>(fn: (tx: TypedTx<S>) => Promise<T>): Promise<T> =>\n      raw.transaction((rawTx) => fn({ tables: buildTables(rawTx) } as TypedTx<S>)),\n  };\n\n  // Narrow cast: `result.tables` is structurally identical to\n  // TypedDB<S>[\"tables\"] — each key maps to a TypedTable for the matching\n  // TableDef. TS cannot infer the mapped-type result through Object.keys\n  // iteration, so a single `as` bridges the gap.\n  return result as TypedDB<S>;\n}\n","/**\n * runtime.ts — request-scoped service singletons.\n *\n * The backend SDK no longer threads a `ctx` god-object through every handler.\n * Instead, endpoint authors import PascalCase service singletons directly:\n *\n *   import { Database, Documents, Cache } from \"@palbase/backend\";\n *\n *   export default defineEndpoint({\n *     method: \"POST\",\n *     handler: async (req) => {\n *       const row = await Database.insert(\"todos\", { title: req.input.title });\n *       return row;\n *     },\n *   });\n *\n * The singletons are thin Proxies. Every property access forwards to the live\n * client for the CURRENT request scope, resolved through {@link __getRuntime}.\n *\n * # Request-scope resolution (persistent app-server)\n *\n * The runtime is a long-running Node process that serves many concurrent\n * requests on one event loop (NOT a fresh subprocess per request). A single\n * module-global slot would let one in-flight request's services bleed into\n * another's. So the services are carried in an {@link AsyncLocalStorage} store\n * ({@link __requestALS}) that the runtime sets per request with\n * {@link __runWithRuntime}; every async continuation of that request reads its\n * own store. `__getRuntime` reads the ALS store first; the module-global slot\n * (set by {@link __setRuntime}) is only a fallback for callers that run OUTSIDE\n * an ALS scope (dev-server, unit tests, the legacy single-shot path). Because\n * each `br-<ref>` pod is single-tenant, there is no cross-tenant leakage; the\n * ALS store is what prevents cross-REQUEST leakage within the shared process.\n *\n * The seam that makes `import { Database } from \"@palbase/backend\"` resolve to\n * the runtime-injected client: `@palbase/backend` is marked esbuild-EXTERNAL\n * when the tenant bundle is built, and the package is installed globally in the\n * pod (NODE_PATH=/usr/local/lib/node_modules). So worker.js's\n * `require('@palbase/backend')` and the bundle's `import` resolve to ONE shared\n * module instance — the ALS store and `__setRuntime` slot on that instance are\n * visible to the singletons the bundle imported.\n */\n\nimport { AsyncLocalStorage } from \"node:async_hooks\";\n\nimport type {\n  DBClient,\n  CacheClient,\n  QueueClient,\n  Logger,\n  PalbaseDocsClient,\n} from \"./endpoint.js\";\nimport type {\n  PalbaseStorageClient,\n  PalbaseNotificationsClient,\n  PalbaseFlagsClient,\n} from \"./clients.js\";\nimport type { SchemaDef } from \"./db/schema.js\";\nimport type { TypedDB } from \"./db/typed-db.js\";\nimport { makeTypedDB } from \"./db/typed-db.js\";\n\n/** The set of live clients the runtime injects per request scope.\n *\n * EXCLUDED on purpose: Realtime, Functions, CMS, Links, Analytics, Auth. They\n * are not exposed as backend handler singletons (auth lives on the client SDK;\n * the rest are out of scope for backend endpoints). */\nexport interface RuntimeServices {\n  Database: DBClient;\n  Documents: PalbaseDocsClient;\n  Storage: PalbaseStorageClient;\n  Cache: CacheClient;\n  Queue: QueueClient;\n  Log: Logger;\n  Notifications: PalbaseNotificationsClient;\n  Flags: PalbaseFlagsClient;\n}\n\n/**\n * Per-request store. The persistent runtime runs each request inside\n * {@link __runWithRuntime}, so every async continuation of that request reads\n * its OWN `runtime` (and any other request-scoped fields the runtime adds).\n *\n * Exported with a `__` prefix so the runtime (worker.js) shares the SAME ALS\n * instance across the one module instance — two ALS instances would silently\n * not see each other's stores. NOT part of the public author-facing API.\n */\nexport const __requestALS = new AsyncLocalStorage<{ runtime: RuntimeServices }>();\n\n/** Process-global fallback slot. Used only OUTSIDE an ALS scope (dev-server,\n * unit tests, legacy single-shot worker). Inside the persistent server every\n * request runs in {@link __requestALS}, which takes precedence. */\nlet runtime: RuntimeServices | null = null;\n\n/** Install the live clients in the process-global fallback slot.\n *\n * Persistent-server requests should use {@link __runWithRuntime} instead; this\n * remains for dev-server / tests / the legacy single-shot path that run without\n * an ALS scope. NOT part of the public author-facing API. */\nexport function __setRuntime(services: RuntimeServices): void {\n  runtime = services;\n}\n\n/** Run `fn` with `services` bound as the request-scoped runtime.\n *\n * The persistent worker calls this once per request so concurrent requests\n * never share a services slot. NOT part of the public author-facing API. */\nexport function __runWithRuntime<T>(services: RuntimeServices, fn: () => T): T {\n  return __requestALS.run({ runtime: services }, fn);\n}\n\n/** Read the live clients, throwing if accessed outside a request scope.\n *\n * Resolves the ALS store first (persistent server, per-request), then the\n * process-global fallback (dev-server / tests). NOT part of the public\n * author-facing API — used by the runtime and the singleton Proxies. */\nexport function __getRuntime(): RuntimeServices {\n  const scoped = __requestALS.getStore();\n  if (scoped) return scoped.runtime;\n  if (runtime === null) {\n    throw new Error(\n      \"Palbase services accessed outside a request scope. The Database/Documents/… \" +\n        \"singletons are only available inside an endpoint handler (or after the \" +\n        \"runtime has called __runWithRuntime / __setRuntime).\",\n    );\n  }\n  return runtime;\n}\n\n/**\n * Build a Proxy singleton that forwards every property access to the live\n * client named `key` on the current runtime.\n *\n * The single `as RuntimeServices[K]` is the only contained cast in the surface:\n * `Reflect.get` on a typed object returns `unknown` for a `string | symbol`\n * key, but `prop` is constrained to keys of the client interface at the call\n * sites (the exported singletons are typed below), so the forward is sound.\n */\nfunction makeServiceProxy<K extends keyof RuntimeServices>(key: K): RuntimeServices[K] {\n  const handler: ProxyHandler<RuntimeServices[K]> = {\n    get(_target, prop, receiver) {\n      const client = __getRuntime()[key];\n      const value = Reflect.get(client as object, prop, receiver) as unknown;\n      // Bind methods to their owning client so `this` stays correct when the\n      // author destructures or calls `Database.query(...)`.\n      return typeof value === \"function\" ? value.bind(client) : value;\n    },\n  };\n  // The Proxy target is irrelevant (all access goes through `get`); the cast\n  // names the surface type the singleton presents to authors.\n  return new Proxy({} as RuntimeServices[K], handler);\n}\n\n/** The project's own Postgres (pgx, schema `env_<envId>`). Typed CRUD +\n * `query`/`transaction`. For a typed `.tables.<name>` API, wrap with\n * {@link typedDatabase}. */\nexport const Database: DBClient = makeServiceProxy(\"Database\");\n\n/** Firestore-like document client (PalDocs). */\nexport const Documents: PalbaseDocsClient = makeServiceProxy(\"Documents\");\n\n/** Object storage client (buckets, signed URLs). */\nexport const Storage: PalbaseStorageClient = makeServiceProxy(\"Storage\");\n\n/** JSON-typed cache (get/set/incr/getOrSet). */\nexport const Cache: CacheClient = makeServiceProxy(\"Cache\");\n\n/** Background job queue. */\nexport const Queue: QueueClient = makeServiceProxy(\"Queue\");\n\n/** Structured logger. */\nexport const Log: Logger = makeServiceProxy(\"Log\");\n\n/** Push / email / SMS / in-app notifications. */\nexport const Notifications: PalbaseNotificationsClient = makeServiceProxy(\"Notifications\");\n\n/** Feature flags. */\nexport const Flags: PalbaseFlagsClient = makeServiceProxy(\"Flags\");\n\n/**\n * Type the `Database` singleton against a `defineSchema()` result, returning a\n * facade with a typed `.tables.<name>.insert(...)` API alongside the raw\n * `query`/`transaction` ops.\n *\n *   const Db = typedDatabase(schema);\n *   const todo = await Db.tables.todos.insert({ title: \"x\" });\n *\n * This is per-endpoint (not global module augmentation), so one endpoint's\n * tables never leak into another's `Database` type.\n */\nexport function typedDatabase<TSchema extends SchemaDef>(\n  schema: TSchema,\n): TypedDB<TSchema> & DBClient {\n  // makeTypedDB wraps the raw DBClient with the typed `.tables` facade (and a\n  // typed `transaction`). The full `& DBClient` surface also needs the raw ops\n  // (query/insert/update/delete/findById/findMany), which we delegate straight\n  // to the `Database` singleton — every call goes through its runtime Proxy.\n  const typed = makeTypedDB(schema, Database);\n  const rawOps: DBClient = {\n    query: (sql, params) => Database.query(sql, params),\n    insert: (table, data) => Database.insert(table, data),\n    update: (table, id, data) => Database.update(table, id, data),\n    delete: (table, id) => Database.delete(table, id),\n    findById: (table, id) => Database.findById(table, id),\n    findMany: (table, q) => Database.findMany(table, q),\n    transaction: (fn) => Database.transaction(fn),\n  };\n  // typed.transaction (typed-tx) intentionally overrides rawOps.transaction so\n  // the callback sees the typed `.tables` API.\n  return Object.assign(rawOps, typed);\n}\n"],"mappings":";AAwGA,SAAS,eACP,MACA,KACe;AACf,SAAO;AAAA,IACL,QAAQ,CAAC,SACP,IAAI,OAAO,MAAM,IAA+B;AAAA,IAElD,QAAQ,CAAC,IAAY,SACnB,IAAI,OAAO,MAAM,IAAI,IAA+B;AAAA,IAEtD,QAAQ,CAAC,OAAe,IAAI,OAAO,MAAM,EAAE;AAAA,IAE3C,UAAU,CAAC,OACT,IAAI,SAAS,MAAM,EAAE;AAAA,IAEvB,UAAU,CAAC,UACT,IAAI,SAAS,MAAM,KAA4C;AAAA,EACnE;AACF;AAkBO,SAAS,YACd,QACA,KACY;AACZ,WAAS,YAAY,QAAwD;AAC3E,UAAM,SAAS,CAAC;AAChB,eAAW,OAAO,OAAO,KAAK,OAAO,MAAM,GAAG;AAC5C,YAAM,WAAW,OAAO,OAAO,GAAG;AAClC,UAAI,aAAa,QAAW;AAC1B,eAAO,GAAG,IAAI,eAAe,SAAS,MAAM,MAAM;AAAA,MACpD;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAEA,QAAM,SAAS;AAAA,IACb,QAAQ,YAAY,GAAG;AAAA,IACvB,aAAa,CAAI,OACf,IAAI,YAAY,CAAC,UAAU,GAAG,EAAE,QAAQ,YAAY,KAAK,EAAE,CAAe,CAAC;AAAA,EAC/E;AAMA,SAAO;AACT;;;AC7HA,SAAS,yBAAyB;AA2C3B,IAAM,eAAe,IAAI,kBAAgD;AAKhF,IAAI,UAAkC;AAO/B,SAAS,aAAa,UAAiC;AAC5D,YAAU;AACZ;AAMO,SAAS,iBAAoB,UAA2B,IAAgB;AAC7E,SAAO,aAAa,IAAI,EAAE,SAAS,SAAS,GAAG,EAAE;AACnD;AAOO,SAAS,eAAgC;AAC9C,QAAM,SAAS,aAAa,SAAS;AACrC,MAAI,OAAQ,QAAO,OAAO;AAC1B,MAAI,YAAY,MAAM;AACpB,UAAM,IAAI;AAAA,MACR;AAAA,IAGF;AAAA,EACF;AACA,SAAO;AACT;AAWA,SAAS,iBAAkD,KAA4B;AACrF,QAAM,UAA4C;AAAA,IAChD,IAAI,SAAS,MAAM,UAAU;AAC3B,YAAM,SAAS,aAAa,EAAE,GAAG;AACjC,YAAM,QAAQ,QAAQ,IAAI,QAAkB,MAAM,QAAQ;AAG1D,aAAO,OAAO,UAAU,aAAa,MAAM,KAAK,MAAM,IAAI;AAAA,IAC5D;AAAA,EACF;AAGA,SAAO,IAAI,MAAM,CAAC,GAAyB,OAAO;AACpD;AAKO,IAAM,WAAqB,iBAAiB,UAAU;AAGtD,IAAM,YAA+B,iBAAiB,WAAW;AAGjE,IAAM,UAAgC,iBAAiB,SAAS;AAGhE,IAAM,QAAqB,iBAAiB,OAAO;AAGnD,IAAM,QAAqB,iBAAiB,OAAO;AAGnD,IAAM,MAAc,iBAAiB,KAAK;AAG1C,IAAM,gBAA4C,iBAAiB,eAAe;AAGlF,IAAM,QAA4B,iBAAiB,OAAO;AAa1D,SAAS,cACd,QAC6B;AAK7B,QAAM,QAAQ,YAAY,QAAQ,QAAQ;AAC1C,QAAM,SAAmB;AAAA,IACvB,OAAO,CAAC,KAAK,WAAW,SAAS,MAAM,KAAK,MAAM;AAAA,IAClD,QAAQ,CAAC,OAAO,SAAS,SAAS,OAAO,OAAO,IAAI;AAAA,IACpD,QAAQ,CAAC,OAAO,IAAI,SAAS,SAAS,OAAO,OAAO,IAAI,IAAI;AAAA,IAC5D,QAAQ,CAAC,OAAO,OAAO,SAAS,OAAO,OAAO,EAAE;AAAA,IAChD,UAAU,CAAC,OAAO,OAAO,SAAS,SAAS,OAAO,EAAE;AAAA,IACpD,UAAU,CAAC,OAAO,MAAM,SAAS,SAAS,OAAO,CAAC;AAAA,IAClD,aAAa,CAAC,OAAO,SAAS,YAAY,EAAE;AAAA,EAC9C;AAGA,SAAO,OAAO,OAAO,QAAQ,KAAK;AACpC;","names":[]}