gemi 0.58.1 → 0.60.0

package/skills/gemi-react-best-practices/rules/service-static-token-and-name.md

@@ -0,0 +1,52 @@
+---
+title: Services and Jobs Need a Static String Identifier
+impact: HIGH
+impactDescription: works in dev, silently breaks in the production build
+tags: service, jobs, minification, production
+---
+
+## Services and Jobs Need a Static String Identifier
+
+A `Service` needs `static token`; a `Job` needs `static name`. Both are string
+literals because **minification renames classes in the production build** — the
+container key and the queue's dispatch name must survive that rename. This is a
+class of bug that cannot reproduce locally: dev is unminified, so everything works
+until it is deployed.
+
+**Incorrect (relies on the class name surviving the build):**
+
+```ts
+export class ProcessVideoJob extends Job {
+  async run(params: Params) { /* … */ }
+}
+```
+
+**Correct:**
+
+```ts
+export class ProcessVideoJob extends Job {
+  static name = "ProcessVideoJob";
+  maxAttempts = 3;
+
+  async run(params: Params) { /* … */ }
+  onFail(error: Error, params: Params) { /* … */ }
+  onDeadletter(error: Error, params: Params) { /* … */ }
+}
+
+export class Billing extends Service {
+  static token = "Billing";
+}
+```
+
+- **Tokens must be unique.** Two jobs claiming one name: the framework refuses the
+  second with a line on stderr rather than silently dropping it — rename one.
+- **`maxAttempts` defaults to 3.** `run` throwing calls `onFail` and requeues;
+  the final failure calls `onDeadletter` and drops the job.
+- **`worker: true`** runs the job in a separate Worker thread, for CPU-bound work.
+- **Dispatch is fire-and-forget** — `Job.dispatch(payload)` returns `void`. Pass only
+  serializable data, never a class instance or a function.
+
+**Register services explicitly on `Kernel.services`, and note that boot order is
+load-bearing** — a service listed first boots before those after it.
+
+<https://nstfkc.github.io/gemi/jobs-and-queues.md>

package/skills/gemi-react-best-practices/rules/structure-discovered-vs-registered.md

@@ -0,0 +1,71 @@
+---
+title: Know Which Directories Are Discovered and Which Need Declaring
+impact: HIGH
+impactDescription: the difference between code that runs and code that silently never does
+tags: structure, discovery, kernel, registration
+---
+
+## Know Which Directories Are Discovered and Which Need Declaring
+
+`app/` has two kinds of directory, and confusing them produces the same symptom
+either way: code that looks correct, imports cleanly, typechecks, and never runs.
+
+**Discovered — writing the file *is* the registration:**
+
+| Directory | Base class | Read at |
+|---|---|---|
+| `app/cron/` | `CronJob` | boot |
+| `app/jobs/` | `Job` | boot |
+| `app/listeners/` | `Listener` | boot |
+| `app/commands/` | `defineCommand` chains | `gemi run` only |
+
+Nothing anywhere names these. Adding a `Job` subclass under `app/jobs/` registers
+it; there is no list to append to, and appending to one you invented does nothing.
+
+`app/listeners/` is the one the scaffold does not create — its absence is not an
+error, it means the app has no listeners yet.
+
+**Declared — the file is not enough:**
+
+- **Models** are declared on the Kernel. A model class under `app/models/` that
+  the Kernel's `models` does not reach is not registered, and `gemi check models`
+  exists to report exactly that gap for policied models.
+- **Routers** are registered explicitly — `app/http/routes/view.ts` and `api.ts`
+  are the roots, and a new router is reached by being mounted from one of them.
+- **Config slices** under `app/config/` are named by the Kernel's `config`.
+- **Service providers** under `app/providers/` are named by the Kernel's
+  `providers`.
+
+**Incorrect (a job that never runs, because a hand-rolled list is not the mechanism):**
+
+```ts
+// app/jobs/index.ts — invented; nothing reads this
+export const jobs = [SendWelcomeEmail, ReindexProducts];
+```
+
+**Correct (the file is the registration):**
+
+```ts
+// app/jobs/SendWelcomeEmail.ts
+export class SendWelcomeEmail extends Job {
+  static token = "SendWelcomeEmail";
+  // …
+}
+```
+
+**Incorrect (a model that typechecks and is never registered):**
+
+```ts
+// app/models/Invoice.ts — written, but not reachable from the Kernel's `models`
+export class Invoice extends Model {}
+```
+
+The four discovered directories have a cost worth knowing: **discovery imports
+every file it walks**, because a class does not exist until its module has run. A
+file in one of them that does work at import time does that work at boot. Keep
+them to declarations — see `service-lazy-not-module-scope`.
+
+The discovered directories can also be declared explicitly in their config slice
+(`schedule`, `queue`, `events`, `command`), which turns the walk off and uses the
+list verbatim. An empty array is a declaration too, and means "this app has none"
+— not "fall back to walking".

package/skills/gemi-react-best-practices/rules/structure-do-not-reinvent-the-framework.md

@@ -0,0 +1,58 @@
+---
+title: Do Not Build Structure the Framework Already Has
+impact: HIGH
+impactDescription: a parallel structure is one the framework's own tooling cannot see
+tags: structure, container, services, conventions
+---
+
+## Do Not Build Structure the Framework Already Has
+
+The reflex when a codebase needs somewhere to put shared code is to add `lib/`,
+`utils/`, or a hand-rolled registry. In a gemi app most of those already exist
+with a name, and the cost of the parallel one is not duplication — it is that the
+framework's own machinery cannot see it.
+
+| The reflex | What gemi already has |
+|---|---|
+| A `lib/` of shared classes with I/O | `app/services/`, classes extending `Service`, resolved from the container |
+| A module-scope singleton client | A `Service` with a `static token`, injected where needed |
+| A hand-rolled service locator or DI map | The container; `app/providers/` binds into it |
+| A custom router, or routing by file path | Router classes under `app/http/routes/` |
+| Ad-hoc `if (!req.body.name)` checks | An `HttpRequest` subclass under `app/http/requests/` |
+| A `constants.ts` of env reads | A config slice under `app/config/` |
+| A `scripts/` folder run with `bun x.ts` | `app/commands/`, run by `gemi run` |
+| A barrel re-exporting a package's modules | Deep imports — see `bundle-deep-imports` |
+
+**Incorrect (a registry the framework cannot see):**
+
+```ts
+// app/lib/services.ts — invented
+export const billing = new Billing(process.env.STRIPE_KEY!);
+```
+
+Constructed at module scope, so it runs whenever anything imports the file —
+including a discovery walk that imports every file in a directory. Nothing can
+rebind it in a test, and nothing resolves it by token.
+
+**Correct:**
+
+```ts
+// app/services/Billing.ts
+export class Billing extends Service {
+  static token = "Billing";
+  // Constructed lazily by the container, rebindable in a test.
+}
+```
+
+Two things follow from this that are easy to get backwards:
+
+- **A view's file path is not its URL.** `app/views/` is organised however you
+  like; routing is declared on router classes. Moving a view does not change a
+  route, and creating one under a path that "looks like" a URL registers nothing.
+  See `routing-routers-are-classes`.
+- **`app/models/generated/` is output.** Editing it is editing a build artifact —
+  the change disappears on the next generate.
+
+When a rule here and an existing pattern in your app disagree, check the app's
+`CLAUDE.md` and git history before "fixing" it: the app may have a reason, and
+ground rule 2 says the app wins.

package/skills/gemi-react-best-practices/rules/testing-assert-behaviour-over-markup.md

@@ -0,0 +1,54 @@
+---
+title: Mount and Query the DOM — Do Not Scrape Rendered Markup
+impact: MEDIUM-HIGH
+impactDescription: catches real regressions instead of string drift
+tags: testing, testing-library, house-style
+---
+
+## Mount and Query the DOM — Do Not Scrape Rendered Markup
+
+Asserting on `renderToStaticMarkup` / `renderToString` output — substring matches,
+regex scrapes for `href=`, index arithmetic to prove ordering — tests the markup
+rather than the component. It passes when the component is broken and fails when a
+class name changes.
+
+**Incorrect:**
+
+```tsx
+const html = renderToStaticMarkup(<ProductList products={products} />);
+expect(html).toContain("Chair");
+expect(html.indexOf("Chair")).toBeLessThan(html.indexOf("Desk"));
+expect(html).toMatch(/href="\/app\/abc\/products\/1"/);
+```
+
+**Correct:**
+
+```tsx
+render(<Page {...}><ProductList /></Page>);
+
+expect(screen.getByRole("link", { name: "Chair" })).toHaveAttribute(
+  "href", "/app/abc/products/1",
+);
+expect(
+  screen.getByText("Chair").compareDocumentPosition(screen.getByText("Desk")),
+).toBe(Node.DOCUMENT_POSITION_FOLLOWING);
+```
+
+Use `getByRole` / `getByLabelText`, `compareDocumentPosition` for order, and
+`label[for]` for input association. **The one exception is a test whose SUBJECT is
+the server payload** — e.g. guarding that a virtualised grid does not ship an empty
+shell. Say so in the file when you take it.
+
+**Assert what goes over the wire, not how a query was configured.** Checking that
+`lazy` or `refreshInterval` was passed tests the arguments; it cannot tell a working
+pager from one that never fetched. A non-lazy query is proved by a request arriving
+on mount, a lazy one by no request arriving until something asks.
+
+**Mock HTTP with MSW, not by replacing `globalThis.fetch`.** `setupServer` +
+`server.listen({ onUnhandledRequest: "error" })` makes an undeclared request fail
+instead of silently resolving, and lets a case assert against the real `Request` —
+resolved URL, method, headers, parsed body.
+
+**Make a stub load-bearing.** A test that removes `crypto.randomUUID` to reach a
+fallback, then asserts a shape both branches satisfy, passes either way. Assert the
+exact value.

package/skills/gemi-react-best-practices/rules/testing-match-the-suite.md

@@ -0,0 +1,57 @@
+---
+title: Match the Suite You Are In
+impact: MEDIUM
+impactDescription: a test the runner never selects is a test that does not exist
+tags: testing, runner, conventions
+---
+
+## Match the Suite You Are In
+
+Before adding a test, read the neighbours and the runner config. Copy the runner, the
+import source, and the file-naming convention already in use in that directory. A
+test written for the wrong runner does not fail loudly — the runner simply never
+selects the file, and it sits green forever without executing.
+
+**This is the whole rule for the common case.** Everything below is the gemi-specific
+part: the two things that trip up a component test in a gemi app regardless of which
+runner you picked.
+
+**A component test needs a DOM.** gemi renders on the server, so a suite configured
+as a plain Node project has no `window`. Mounting a view there fails on the first
+DOM call, not with a useful message. Either point that suite at a DOM environment
+(`jsdom`, `happy-dom`) or put component tests in the half of the suite that has one.
+
+**A test of the server dictionary readers must drop `window` first.**
+`Dictionary.render` and `Dictionary.reference` throw in a browser-shaped environment,
+so a DOM-providing preload breaks them for the whole run. Reach for the server
+globals helper at module scope — a dictionary is often read while the test module
+evaluates, before any `beforeEach` has run.
+
+**Incorrect (a component test in the Node-only half of the suite):**
+
+```ts
+// runs, finds no document, fails on render
+import { render } from "@testing-library/react";
+import { describe, it } from "vitest";
+```
+
+**Correct (the same test where a DOM exists):**
+
+```ts
+import { render } from "@testing-library/react";
+import { describe, it } from "vitest"; // or "bun:test" — whichever this suite uses
+
+// vitest.config.ts: environment: "jsdom"
+```
+
+Two notes if your repo runs more than one runner:
+
+- **The file name is usually the selection mechanism.** `bun test` has no
+  include-pattern config, so a repo running both typically selects the bun half by a
+  path fragment (`<name>.bun.test.ts`) and excludes that same fragment from the other
+  runner's config. Renaming a file is what moves it between halves.
+- **`vi.hoisted` / `vi.mock` do not port.** They rely on Vitest's AST hoisting, which
+  `bun:test` has no equivalent for. A file using only `describe`/`it`/`expect` is an
+  import swap; a file using those needs rewriting.
+
+See also `testing-page-seeds-real-inputs` for how to mount a gemi view under test.

package/skills/gemi-react-best-practices/rules/testing-page-seeds-real-inputs.md

@@ -0,0 +1,65 @@
+---
+title: Mount With Page From gemi/testing, Never Mock gemi/client
+impact: HIGH
+impactDescription: tests the component instead of the mock
+tags: testing, gemi-testing, house-style
+---
+
+## Mount With Page From gemi/testing, Never Mock gemi/client
+
+`<Page>` supplies the inputs the framework normally provides — route params, search,
+locale, user, and the query cache — so a view mounts for real. **Mocking
+`gemi/client` is prohibited, and the rule is not scoped to component tests**: it
+binds hook and model tests the same way, and spreading the real module through
+(`...(await import("gemi/client"))`) is still mocking it.
+
+**Incorrect (asserts the mock, not the component):**
+
+```tsx
+mock.module("gemi/client", () => ({
+  useQuery: () => ({ data: [{ id: 1, name: "Chair" }] }),
+  useParams: () => ({ orgId: "abc" }),
+}));
+```
+
+**Correct (real hooks, seeded inputs):**
+
+```tsx
+import { Page } from "gemi/testing";
+
+render(
+  <Page
+    pathname="/app/:orgId/products"
+    params={{ orgId: "abc" }}
+    searchParams="?tab=recent"
+    locale="en-US"
+    user={{ id: 1 }}
+    queryData={{ "/app/:orgId/products": [{ id: 1, name: "Chair" }] }}
+    fallback={<Skeleton />}
+    errorFallback={<Failed />}
+    onNavigate={onNavigate}
+  >
+    <ProductsRoute />
+  </Page>,
+);
+```
+
+- **`queryData` keys are the path as `useQuery` writes it**, minus `/api`, with
+  `:params` resolved against the page's `params`. A seeded query renders on the first
+  pass and issues no request.
+- **Navigation is reported, not performed** — `onNavigate` receives
+  `(resolvedHref, "push" | "replace")`. To test the destination, mount a second
+  `<Page>`.
+- **Seed `fallback` and `errorFallback` and assert those** for a non-lazy query:
+  it suspends while in flight and throws on failure, so `loading`/`error` are not
+  what that path returns.
+
+**If an assertion can only be made by mocking `gemi/client`** — `prefetch` leaves no
+DOM trace, a synchronous `useMutate` throw — **drop the assertion, not the rule**, and
+say in the file why it went.
+
+**Do not mock anything else either** unless it is genuinely impossible otherwise. A
+Radix dropdown rendering nothing until it opens is an argument for opening it with
+`userEvent`, not for stubbing it.
+
+Reference: <https://nstfkc.github.io/gemi/testing.md>

package/dist/chunk-01e3gk86.js

@@ -1,55 +0,0 @@
-// @bun
-import{$ as D,Z as x}from"./chunk-4sz6pwtn.js";import{ia as y,ja as I}from"./chunk-v7y8zm61.js";import"./chunk-5ad8era8.js";import"./chunk-ejrcyzx8.js";import"./chunk-tkdxv6cq.js";import"./chunk-xnytbrda.js";import"./chunk-jhkjz9jr.js";import{IncomingMessage as T,ServerResponse as g}from"http";import{Socket as w}from"net";import{join as E}from"path";import{createServer as k}from"vite";function N(H){return H.replace(/\x1b\[[0-9;]*m/g,"").replace(/\[[0-9;]*m/g,"").replace(/\n\s*\n/g,`
-`).split(`
-`).map((J)=>J.trim()).filter((J)=>J.length>0).join(`
-`).trim()}function R(H){return`
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta
-      name="viewport"
-      content="width=device-width, initial-scale=1.0"
-    />
-
-    <title>Error</title>
-    <style>
-      body {
-        font-family: Arial, sans-serif;
-        padding: 20px;
-      }
-      h1 {
-        color: red;
-      }
-    </style>
-  </head>
-  <body>
-  <div id="overlay"></div>
-    <script type="module" src="/refresh.js"></script>
-    <script type="module" src="/@vite/client"></script>
-    <script>
-      ${N.toString()}
-      const err = ${JSON.stringify(H,Object.getOwnPropertyNames(H),2)}
-
-      window.addEventListener('load', () => {
-        const container = document.getElementById('overlay')
-        const ErrorOverlay = customElements.get('vite-error-overlay')
-        if (ErrorOverlay) {
-      const overlay = new ErrorOverlay({ ...err, message: cleanupTerminalText(err.message) });
-          container.appendChild(overlay)
-        }
-      })
-    </script>
-  </body>
-</html>
-`}function q(H,J){let j=new URL(J.url),K=new T(new w);K.url=j.pathname+j.search,K.method=J.method,K.headers=Object.fromEntries(J.headers);let O=new g(K),Q=[];return new Promise((Y)=>{O.write=(Z)=>{if(Z)Q.push(Buffer.from(Z));return!0},O.end=(Z)=>{if(Z&&typeof Z!=="function")Q.push(Buffer.from(Z));let z=new Headers;for(let[_,$]of Object.entries(O.getHeaders())){if($==null)continue;for(let U of Array.isArray($)?$:[$])z.append(_,String(U))}return Y(new Response(Q.length?Buffer.concat(Q):null,{status:O.statusCode,headers:z})),O},H.middlewares(K,O,()=>Y(null))})}var L=process.cwd(),b=E(L,"app");function d(H,J,j){let K=String(J),O=" ".repeat(K.length),Q=" ".repeat(Math.max(0,j-1))+"^";return`${K} |  ${H}
-${O} |  ${Q}
-`}function S(H){if(H&&typeof H==="object"){let J=H.position;if(J&&typeof J==="object"&&typeof J.file==="string")return{message:typeof H.message==="string"?H.message:String(H),stack:"",frame:typeof J.lineText==="string"?d(J.lineText,J.line,J.column):void 0,loc:{file:J.file,line:J.line,column:J.column}};return{message:typeof H.message==="string"?H.message:String(H),stack:typeof H.stack==="string"?H.stack:""}}return{message:String(H),stack:""}}function X(H){let J=globalThis.__gemiVite;if(!J)return;J.ws.send({type:"error",err:S(H)}),globalThis.__gemiErrorActive=!0}if(!globalThis.__gemiErrorHooked)globalThis.__gemiErrorHooked=!0,process.on("unhandledRejection",(H)=>{console.error(H),X(H)}),process.on("uncaughtException",(H)=>{console.error(H),X(H)});async function n(H,J){let j=Boolean(globalThis.__gemiVite),K=globalThis.__gemiVite??=await k({configFile:!1,plugins:[I()],server:{middlewareMode:!0,watch:{ignored:(Q)=>{let Y=Q.split(/[/\\]/).pop()??"";return Y===".env"||Y.startsWith(".env.")}}},appType:"custom",resolve:{dedupe:["react","react-dom"]},optimizeDeps:{include:["react","react-dom","react-dom/client"]},ssr:{external:[...y]}});process.env.ROOT_DIR=L,process.env.APP_DIR=b;let O=Bun.serve({port:process.env.PORT||5173,fetch:async(Q)=>{let{pathname:Y,host:Z,protocol:z}=new URL(Q.url);if(Y.startsWith("/render-error.js"))return new Response("window.render_error = true",{headers:{"Content-Type":"application/javascript"}});if(Y.startsWith("/refresh.js"))return new Response(`
-          import RefreshRuntime from "${z}//${Z}/@react-refresh";
-          RefreshRuntime.injectIntoGlobalHook(window);
-          window.$RefreshReg$ = () => {};
-          window.$RefreshSig$ = () => (type) => type;
-          window.__vite_plugin_react_preamble_installed__ = true;
-        `,{headers:{"Content-Type":"application/javascript"}});return await J(Q,async($)=>{try{let U=H.fetch.bind(H),A=await q(K,$)??await U($);if(A instanceof Response)return A;let F={},V={},C={},f=(W,B)=>`"${W}": () => import("${B}")`,P=[];for(let W of["404",...H.getFlatComponentTree.call(H)]){if(Bun.env.NODE_ENV==="test")break;let B=`${process.env.APP_DIR}`,G=await K.ssrLoadModule(`${B}/views/${W}.tsx`,{fixStacktrace:!0});F[W]=G.default,V[W]=G?.OpenGraph,C[W]=G,P.push(f(W,`/app/views/${W}.tsx`))}let M=`{${P.join(",")}}`;return await A({getStyles:async(W)=>await x(b,K,W),bootstrapModules:["/refresh.js","/app/client.tsx","/@vite/client"],viewImportMap:F,viewModules:C,ogMap:V,loaders:M,cssManifest:{}})}catch(U){if(console.error(U),K.ssrFixStacktrace?.(U),X(U),Y.startsWith("/api"))return new Response(JSON.stringify({error:U?.message??String(U)}),{status:500,headers:{"Content-Type":"application/json"}});return globalThis.__gemiErrorPageServed=!0,new Response(R(S(U)),{status:500,headers:{"Content-Type":"text/html"}})}})}});if(j)if(globalThis.__gemiErrorActive&&globalThis.__gemiErrorPageServed)globalThis.__gemiErrorActive=!1,globalThis.__gemiErrorPageServed=!1,K.ws.send({type:"full-reload"});else globalThis.__gemiErrorActive=!1,K.ws.send({type:"custom",event:"http-reload"});else D({port:O.port,rootDir:L});return O}export{S as viteErrorPayload,n as httpDev};
-
-//# debugId=E1B84E5668A31A3E64756E2164756E21

package/dist/chunk-01e3gk86.js.map

@@ -1,11 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../server/httpDev.ts", "../server/renderErrorPage.ts"],
-  "sourcesContent": [
-    "import { IncomingMessage, ServerResponse } from \"node:http\";\nimport { Socket } from \"node:net\";\nimport { join } from \"node:path\";\n\nimport { createServer, type ViteDevServer } from \"vite\";\n\nimport { App } from \"../app\";\nimport gemiVite from \"../vite\";\nimport { createDevStyles } from \"./styles\";\nimport { renderErrorPage } from \"./renderErrorPage\";\nimport { Instrumentation } from \"./types\";\nimport { printStartupBanner } from \"./banner\";\nimport { GEMI_EXTERNAL_SPECIFIERS } from \"../internal/gemiExternals\";\n\n// Run a Web `Request` through Vite's Connect middleware.\n// Resolves to a `Response` when Vite handles the request (module transforms,\n// assets, the HMR client, ...), or `null` when it calls `next()` — which, with\n// `appType: \"custom\"`, it does for everything it doesn't own.\nfunction viteMiddleware(vite: ViteDevServer, request: Request): Promise<Response | null> {\n  const url = new URL(request.url);\n\n  const req = new IncomingMessage(new Socket());\n  req.url = url.pathname + url.search;\n  req.method = request.method;\n  req.headers = Object.fromEntries(request.headers);\n\n  const res = new ServerResponse(req);\n  const chunks: Buffer[] = [];\n\n  return new Promise((resolve) => {\n    res.write = ((chunk: any) => {\n      if (chunk) chunks.push(Buffer.from(chunk));\n      return true;\n    }) as typeof res.write;\n\n    res.end = ((chunk?: any) => {\n      if (chunk && typeof chunk !== \"function\") chunks.push(Buffer.from(chunk));\n\n      const headers = new Headers();\n      for (const [key, value] of Object.entries(res.getHeaders())) {\n        if (value == null) continue;\n        for (const v of Array.isArray(value) ? value : [value]) {\n          headers.append(key, String(v));\n        }\n      }\n\n      resolve(\n        new Response(chunks.length ? Buffer.concat(chunks) : null, {\n          status: res.statusCode,\n          headers,\n        }),\n      );\n      return res;\n    }) as typeof res.end;\n\n    vite.middlewares(req, res, () => resolve(null));\n  });\n}\n\nconst rootDir = process.cwd();\nconst appDir = join(rootDir, \"app\");\n\ndeclare global {\n  // Created once and reused across `bun --hot` reloads (see below).\n  var __gemiVite: ViteDevServer | undefined;\n  // Guards one-time registration of the process error hooks across reloads.\n  var __gemiErrorHooked: boolean | undefined;\n  // An error overlay is currently showing on the client (clear it on recovery).\n  var __gemiErrorActive: boolean | undefined;\n  // We served a standalone error *page* (not just a pushed overlay), so the\n  // visible document has no live app — recovery needs a full page reload.\n  var __gemiErrorPageServed: boolean | undefined;\n}\n\n// Build the `>  1 | ...\\n     |     ^` codeframe Vite's overlay renders — must\n// match its `codeframeRE` (a `<line> | <text>` line followed by a `| ^` line,\n// each ending in a newline).\nfunction codeFrame(lineText: string, line: number, column: number) {\n  const gutter = String(line);\n  const pad = \" \".repeat(gutter.length);\n  const caret = \" \".repeat(Math.max(0, column - 1)) + \"^\";\n  return `${gutter} |  ${lineText}\\n${pad} |  ${caret}\\n`;\n}\n\n// Normalize whatever Bun/JS throws into the { message, stack, frame, loc }\n// shape Vite's error overlay consumes. Two cases matter:\n//   - a real `Error` (runtime top-level throw) carries a proper `.stack`;\n//   - a Bun `BuildMessage` (syntax error) has NO `.stack`, only a `.position`\n//     ({ file, line, column, lineText }) — so synthesize a codeframe + loc from\n//     it, otherwise the overlay shows a bare message with no location.\n// (An `Error` instance also JSON-stringifies to `{}`, so fields are copied by\n// hand either way.)\nexport function viteErrorPayload(err: any) {\n  if (err && typeof err === \"object\") {\n    const pos = err.position;\n    if (pos && typeof pos === \"object\" && typeof pos.file === \"string\") {\n      return {\n        message: typeof err.message === \"string\" ? err.message : String(err),\n        stack: \"\",\n        frame:\n          typeof pos.lineText === \"string\"\n            ? codeFrame(pos.lineText, pos.line, pos.column)\n            : undefined,\n        loc: { file: pos.file, line: pos.line, column: pos.column },\n      };\n    }\n    return {\n      message: typeof err.message === \"string\" ? err.message : String(err),\n      stack: typeof err.stack === \"string\" ? err.stack : \"\",\n    };\n  }\n  return { message: String(err), stack: \"\" };\n}\n\n// Push an error into the browser via Vite's HMR socket. `__gemiVite` persists\n// across `bun --hot` reloads, so this works even when the reload that produced\n// the error never got far enough to (re)run `httpDev`.\nfunction sendErrorToClient(err: any) {\n  const vite = globalThis.__gemiVite;\n  if (!vite) return;\n  vite.ws.send({ type: \"error\", err: viteErrorPayload(err) as any });\n  globalThis.__gemiErrorActive = true;\n}\n\n// `bun --hot` re-evaluates the module graph on every server-code change. A\n// syntax error or top-level throw in app code therefore fails during *module\n// load* — outside any request, and before `httpDev` re-runs — so Bun only\n// prints it to the console. Bun surfaces these as `unhandledRejection` (the\n// reload re-imports the entry and the failing dynamic import rejects), so hook\n// that here and forward it to the client. Registered once; process listeners\n// persist across reloads.\nif (!globalThis.__gemiErrorHooked) {\n  globalThis.__gemiErrorHooked = true;\n  process.on(\"unhandledRejection\", (reason) => {\n    console.error(reason);\n    sendErrorToClient(reason);\n  });\n  process.on(\"uncaughtException\", (err) => {\n    console.error(err);\n    sendErrorToClient(err);\n  });\n}\n\nexport async function httpDev(app: App, instrumentation: Instrumentation) {\n  // `bun --hot` re-runs this module on every server-code change, so keep a\n  // single Vite server on `globalThis` instead of spawning a new one (and a new\n  // HMR socket) on each reload.\n  const isReload = Boolean(globalThis.__gemiVite);\n  const vite = (globalThis.__gemiVite ??= await createServer({\n    // gemi owns the Vite setup — the app has no `vite.config.mjs` to discover.\n    // Register the gemi plugin explicitly instead; it loads `gemi.config.ts` and\n    // appends the app's Vite plugins (e.g. `@vitejs/plugin-react`, which serves\n    // `/@react-refresh` and the HMR preamble referenced below).\n    configFile: false,\n    plugins: [gemiVite()],\n    server: {\n      middlewareMode: true,\n      // gemi reloads `.env` into process.env itself (see `watchEnv`). Stop Vite\n      // from *also* watching env files: Vite's env-change handler restarts the\n      // dev server, which closes the SSR module runner — but gemi keeps a single\n      // Vite instance across `bun --hot` reloads, so an in-flight `ssrLoadModule`\n      // hits the closed runner (\"Vite module runner has been closed\"). Ignoring\n      // env files here only disables the restart; env *loading* at startup (and\n      // `import.meta.env`) is unaffected.\n      watch: {\n        ignored: (file: string) => {\n          const base = file.split(/[/\\\\]/).pop() ?? \"\";\n          return base === \".env\" || base.startsWith(\".env.\");\n        },\n      },\n    },\n    appType: \"custom\",\n    // Views are loaded through this SSR graph while the renderer\n    // (react-dom/server in ViewRouteDispatcher) is imported by Bun.\n    // Dedupe so Vite can never resolve a second React copy — a mismatch makes\n    // the SSR dispatcher null (\"Invalid hook call\") after an HMR reload.\n    resolve: { dedupe: [\"react\", \"react-dom\"] },\n    // Pre-bundle the whole React surface the client uses in one pass. The client\n    // imports `react-dom/client` (`init.tsx`) and `react-dom` (`createPortal` in\n    // `HttpReload.tsx`); if only the first is discovered at startup, the first\n    // request to a module using the second triggers a *second* optimize pass,\n    // and the already-served page ends up importing a now-stale dep — surfacing\n    // as \"does not provide an export named 't'\". Listing them up front bundles\n    // them together so no re-optimization (and no version skew) happens.\n    optimizeDeps: { include: [\"react\", \"react-dom\", \"react-dom/client\"] },\n    // `gemi` is a linked package, so Vite would otherwise compile its own copy\n    // into this graph — giving views a *different* `RouteStateContext` (and\n    // other module-level singletons) than the Bun-loaded renderer's `Root`\n    // provider, so `useRouteData()` reads the empty default (`i18n` undefined).\n    // Externalizing makes view imports of `gemi/*` resolve to the one Bun\n    // instance. Vite's `ssr.external` matches exact specifiers (subpaths are NOT\n    // covered by the bare name, and regexes are ignored here), so every subpath\n    // a view might import must be listed — see `internal/gemiExternals`, the\n    // shared source of truth this and the SSR build (`vite/index.ts`) both use.\n    ssr: {\n      external: [...GEMI_EXTERNAL_SPECIFIERS],\n    },\n  }));\n\n  process.env.ROOT_DIR = rootDir;\n  process.env.APP_DIR = appDir;\n\n  const server = Bun.serve({\n    // Same override the prod server honors (`httpProd.ts`).\n    port: process.env.PORT || 5173,\n    fetch: async (req) => {\n      const { pathname, host, protocol } = new URL(req.url);\n      if (pathname.startsWith(\"/render-error.js\")) {\n        return new Response(\"window.render_error = true\", {\n          headers: {\n            \"Content-Type\": \"application/javascript\",\n          },\n        });\n      }\n      if (pathname.startsWith(\"/refresh.js\")) {\n        return new Response(\n          `\n          import RefreshRuntime from \"${protocol}//${host}/@react-refresh\";\n          RefreshRuntime.injectIntoGlobalHook(window);\n          window.$RefreshReg$ = () => {};\n          window.$RefreshSig$ = () => (type) => type;\n          window.__vite_plugin_react_preamble_installed__ = true;\n        `,\n          {\n            headers: {\n              \"Content-Type\": \"application/javascript\",\n            },\n          },\n        );\n      }\n      const requestHandler = async (req: Request): Promise<Response> => {\n        try {\n          const handler = app.fetch.bind(app);\n          const result = (await viteMiddleware(vite, req)) ?? (await handler(req));\n          if (result instanceof Response) {\n            return result;\n          }\n\n          const viewImportMap = {};\n          const ogMap = {};\n          const viewModules = {};\n          const template = (viewName: string, path: string) =>\n            `\"${viewName}\": () => import(\"${path}\")`;\n          const templates = [];\n\n          for (const fileName of [\"404\", ...app.getFlatComponentTree.call(app)]) {\n            if (process.env.NODE_ENV === \"test\") {\n              break;\n            }\n            const appDir = `${process.env.APP_DIR}`;\n            const mod = await vite.ssrLoadModule(`${appDir}/views/${fileName}.tsx`, {\n              fixStacktrace: true,\n            });\n\n            viewImportMap[fileName] = mod.default;\n            ogMap[fileName] = mod?.OpenGraph;\n            // The whole module, so a streaming render can put the view's\n            // `Loading`/`Error` exports into the shell it sends.\n            viewModules[fileName] = mod;\n            // Emit a root-relative URL (`/app/views/Foo.tsx`), NOT the absolute\n            // filesystem path used for `ssrLoadModule` above. The browser's\n            // `window.loaders` preload and `client.tsx`'s `import.meta.glob` map\n            // must import the exact same URL — otherwise Vite serves the module\n            // under two URLs (`/app/views/Foo.tsx` vs `/Users/.../app/views/Foo.tsx`)\n            // and loads/instantiates the view twice.\n            templates.push(template(fileName, `/app/views/${fileName}.tsx`));\n          }\n\n          const loaders = `{${templates.join(\",\")}}`;\n\n          return await result({\n            getStyles: async (currentViews: string[]) =>\n              await createDevStyles(appDir, vite, currentViews),\n            bootstrapModules: [\"/refresh.js\", \"/app/client.tsx\", \"/@vite/client\"],\n            viewImportMap,\n            viewModules,\n            ogMap,\n            loaders,\n            cssManifest: {},\n          });\n        } catch (err: any) {\n          // Errors thrown *while handling a request* (a controller throwing, a\n          // failing `ssrLoadModule`, ...) never hit the module-load hooks above,\n          // so surface them here: forward to the overlay for any already-open\n          // page, and render an error page for this response so a fresh load\n          // (which has no live HMR socket yet) still shows the failure.\n          console.error(err);\n          vite.ssrFixStacktrace?.(err);\n          sendErrorToClient(err);\n\n          if (pathname.startsWith(\"/api\")) {\n            return new Response(JSON.stringify({ error: err?.message ?? String(err) }), {\n              status: 500,\n              headers: { \"Content-Type\": \"application/json\" },\n            });\n          }\n\n          // This document has no live app (so no HttpReload listener to clear the\n          // overlay) — remember that, so recovery forces a full page reload.\n          globalThis.__gemiErrorPageServed = true;\n          return new Response(renderErrorPage(viteErrorPayload(err)), {\n            status: 500,\n            headers: { \"Content-Type\": \"text/html\" },\n          });\n        }\n      };\n\n      return await instrumentation(req, requestHandler);\n    },\n  });\n\n  // On a reload `app` has already been rebuilt with the new code and Bun.serve\n  // above has swapped in the new fetch handler, so the updated controllers are\n  // live *now*. Tell the client to re-run its queries only at this point —\n  // firing it from Vite's file watcher instead races Bun's reload and leaves\n  // the UI one change behind.\n  if (isReload) {\n    // We got here, so the reload succeeded. Recover from any error that was\n    // showing: a standalone error page must be fully reloaded to get the app\n    // back, whereas an overlay pushed onto a live page is cleared by the\n    // client's `http-reload` handler (no jarring full-page reload). A normal\n    // reload just re-runs client queries against the now-live controllers.\n    if (globalThis.__gemiErrorActive && globalThis.__gemiErrorPageServed) {\n      globalThis.__gemiErrorActive = false;\n      globalThis.__gemiErrorPageServed = false;\n      vite.ws.send({ type: \"full-reload\" });\n    } else {\n      globalThis.__gemiErrorActive = false;\n      vite.ws.send({ type: \"custom\", event: \"http-reload\" });\n    }\n  } else {\n    // First start (not a `bun --hot` reload) — print the startup banner once.\n    printStartupBanner({ port: server.port, rootDir });\n  }\n\n  return server;\n}\n",
-    "function cleanupTerminalText(text) {\n  return (\n    text\n      // Remove ANSI escape sequences (colors, formatting)\n      .replace(/\\x1b\\[[0-9;]*m/g, \"\")\n      // Remove ANSI escape sequences with different format\n      .replace(/\\[[0-9;]*m/g, \"\")\n      // Remove excessive whitespace and normalize line breaks\n      .replace(/\\n\\s*\\n/g, \"\\n\")\n      // Trim each line\n      .split(\"\\n\")\n      .map((line) => line.trim())\n      .filter((line) => line.length > 0)\n      .join(\"\\n\")\n      .trim()\n  );\n}\n\nexport function renderErrorPage(err: any) {\n  return `\n<!DOCTYPE html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"UTF-8\" />\n    <meta\n      name=\"viewport\"\n      content=\"width=device-width, initial-scale=1.0\"\n    />\n\n    <title>Error</title>\n    <style>\n      body {\n        font-family: Arial, sans-serif;\n        padding: 20px;\n      }\n      h1 {\n        color: red;\n      }\n    </style>\n  </head>\n  <body>\n  <div id=\"overlay\"></div>\n    <script type=\"module\" src=\"/refresh.js\"></script>\n    <script type=\"module\" src=\"/@vite/client\"></script>\n    <script>\n      ${cleanupTerminalText.toString()}\n      const err = ${JSON.stringify(err, Object.getOwnPropertyNames(err), 2)}\n\n      window.addEventListener('load', () => {\n        const container = document.getElementById('overlay')\n        const ErrorOverlay = customElements.get('vite-error-overlay')\n        if (ErrorOverlay) {\n      const overlay = new ErrorOverlay({ ...err, message: cleanupTerminalText(err.message) });\n          container.appendChild(overlay)\n        }\n      })\n    </script>\n  </body>\n</html>\n`;\n}\n"
-  ],
-  "mappings": "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",
-  "debugId": "E1B84E5668A31A3E64756E2164756E21",
-  "names": []
-}

package/dist/chunk-4sz6pwtn.js

@@ -1,6 +0,0 @@
-// @bun
-import{pa as h}from"./chunk-tkdxv6cq.js";import{createElement as x}from"react";function j(i,n){let s=Object.keys(n).sort((u,b)=>b.length-u.length).map((u)=>u.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")),r=new RegExp(s.join("|"),"g");return i.replace(r,(u)=>n[u])}async function J(i,n,s=[]){let r=[...s.map((t)=>`${i}/views/${t}.tsx`),`${i}/views/RootLayout.tsx`],u=new Set;for(let t of r){let e=n.moduleGraph.getModulesByFile(t);if(e)for(let d of e)u.add(d)}let b=[],p=[],c={};for(let t of u)if(t)for(let e of t.importedModules){if(e.file.includes("module.css"))c[e.file]=e.ssrTransformResult.map.sourcesContent.join("");if(e.file.includes(".css"))p.push(e.file)}for(let t of p){let e=await n.transformRequest(t+"?direct"),d=t.includes("module.css"),o="";if(d)o=j(c[t],e.default);b.push({isDev:!0,id:t,content:d?o:e.code})}return b.map((t,e)=>{return x("style",{key:e,type:"text/css","data-vite-dev-id":t.id,dangerouslySetInnerHTML:{__html:t.content}})})}async function L(i=[]){return i.map((n,s)=>{return x("style",{key:s,id:n?.id,type:"text/css",dangerouslySetInnerHTML:{__html:n.content}})})}import{existsSync as f}from"fs";import{basename as v}from"path";import{networkInterfaces as k}from"os";var y={name:"gemi",version:"0.58.1",private:!1,license:"MIT",author:"Enes Tufekci <enes@gemijs.dev>",repository:{type:"git",url:"git+https://github.com/nstfkc/gemi.git",directory:"packages/gemi"},bin:{gemi:"./dist/bin/gemi.js","gemi-orm-generator":"./dist/bin/orm-generator.js"},files:["dist/**/*","ide/typescript-plugin/package.json"],module:!0,exports:{"./http":"./http/index.ts","./client":"./client/index.ts","./testing":"./testing/index.ts","./app":"./app/index.ts","./facades":"./facades/index.ts","./email":"./email/index.ts","./vite":"./dist/vite/index.mjs","./kernel":"./kernel/index.ts","./services":"./services/index.ts","./broadcasting":"./broadcasting/index.ts","./i18n":"./i18n/index.ts","./dictionary":"./i18n/dictionaryRuntime.ts","./server":"./server/index.ts","./config":"./config/index.ts","./container":"./container/index.ts","./foundation":"./foundation/index.ts","./database":"./database/index.ts","./orm":"./orm/index.ts","./support":"./support/index.ts","./console/run":"./console/run.ts","./ide/typescript-plugin":"./ide/typescript-plugin/index.ts","./bun/preload":"./bun/preload.ts","./bun/plugin":"./bun/plugin.ts"},scripts:{lint:"oxlint",typecheck:"tsc --noEmit -p tsconfig.json && tsc --noEmit -p ide/typescript-plugin/tsconfig.json",build:"NODE_ENV=production bun run build:core && bun run build:bin && bun run build:types && bun run build:client && bun run build:plugin && bun run build:ts-plugin && bun run build:client-types && bun run build:augmentation","build:core":"bun ./scripts/build.ts","build:bin":"bun build --outdir=./dist/bin --target=bun --external=vite --external=react-dom --external=react/jsx-runtime --external=bun --external=sharp --external=@azure/storage-blob --sourcemap ./bin/gemi.ts ./bin/orm-generator.ts && bun ./scripts/prepare-bin.ts","build:client":"rm -rf dist/client dist/testing dist/chunks && vite build -c vite.client.config.mts","build:plugin":"vite build -c vite.plugin.config.mts","build:ts-plugin":"bun ./scripts/build-ts-plugin.ts","build:types":"tsc","build:client-types":"tsc -p tsconfig.browser.json",test:"bun --bun vitest","test:types":"vitest run --typecheck.only","test:packaging":"bun --bun vitest run --config vitest.packaging.config.ts","build:publish":"bun scripts/build-publish.ts",prepublishOnly:"echo 'Do not publish from this directory \u2014 its exports point at TS source. Run: bun run build:publish, then publish from .publish/' && exit 1","build:augmentation":"bun ./scripts/wire-augmentation.ts"},dependencies:{"@aws-sdk/client-s3":"^3.629.0","@aws-sdk/s3-request-presigner":"^3.629.0","ast-types":"^0.14.2",commander:"^12.1.0",history:"^5.3.0","jsx-email":"2.0.0-rc2.1","magic-string":"^0.30.17",open:"^10.1.0","react-error-boundary":"^6.0.0",recast:"^0.23.9",resend:"^6.12.3",satori:"^0.12.2","temporal-polyfill":"^0.2.5","twitter-api-v2":"^1.20.2","urlpattern-polyfill":"^10.0.0",uuid:"^9.0.1"},devDependencies:{"@babel/parser":"^7.25.4","@prisma/generator-helper":"^6.5.0","@repo/typescript-config":"*","@testing-library/react":"^16.3.2","@types/bun":"^1.3.14","@types/eslint":"^8.56.5","@types/node":"^20.11.24","@types/react":"^19.0.2","@types/react-dom":"^19.0.2",eslint:"^8.57.0",jsdom:"^30.0.1",oxlint:"^1.39.0",react:"19.2.3","react-dom":"19.2.3",typescript:"^5.7.3",vitest:"^4.0.0"},peerDependencies:{"@azure/storage-blob":"^12.28.0",react:">=19","react-dom":">=19",sharp:"^0.34.2",vite:"^8.0.0"},peerDependenciesMeta:{"@azure/storage-blob":{optional:!0}}};var z=[" \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2588\u2557\u2588\u2588\u2557","\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551","\u2588\u2588\u2551  \u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2554\u2588\u2588\u2588\u2588\u2554\u2588\u2588\u2551\u2588\u2588\u2551","\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551\u255A\u2588\u2588\u2554\u255D\u2588\u2588\u2551\u2588\u2588\u2551","\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551 \u255A\u2550\u255D \u2588\u2588\u2551\u2588\u2588\u2551"," \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D     \u255A\u2550\u255D\u255A\u2550\u255D"],O=Boolean(process.stdout.isTTY)&&!process.env.NO_COLOR,g=(i,n)=>O?`\x1B[${i}m${n}\x1B[0m`:n,T=(i)=>g("1",i),l=(i)=>g("2",i),a=(i)=>g("36",i),q=(i)=>g("32",i),E=(i)=>g("35",i);function R(){return y.version??"?"}function _(i){for(let n of Object.values(k()))for(let s of n??[])if((s.family==="IPv4"||s.family===4)&&!s.internal)return`http://${s.address}:${i}`;return null}function G(i){return h(i).filter((n)=>f(n)).map((n)=>v(n))}function A(i){let{port:n,rootDir:s}=i,r=`http://localhost:${n}`,u=_(n),b=G(s),p=(t,e)=>`  ${q("\u279C")}  ${T(t.padEnd(9))}${e}`,c=["",...z.map((t)=>E(t)),"",`  ${l("gemi")} ${a(`v${R()}`)}`,"",p("Local:",a(r)),p("Network:",u?a(u):l("unavailable")),p("Env:",b.length?b.join(", "):l("none")),""];console.log(c.join(`
-`))}
-export{J as Z,L as _,A as $};
-
-//# debugId=3C46E83CE32D242D64756E2164756E21

package/dist/chunk-87qab82w.js

@@ -1,5 +0,0 @@
-// @bun
-import{Ab as a,Bb as O,Jb as M,Lb as Q,Nb as l,Ob as t,Pb as w,Rb as s}from"./chunk-pmhd6zfc.js";import{Yb as X}from"./chunk-4yt5x8s2.js";import{Cc as E,Ec as q,Fc as L,Kc as g,_b as f,gc as S,mc as D,nc as J,oc as k,tc as U,uc as j}from"./chunk-hwa5sqw5.js";import{Vc as i}from"./chunk-86jebsm4.js";import{De as T,He as v,ye as r}from"./chunk-hxf1re93.js";import{Se as c,Te as h}from"./chunk-qb5mv6pj.js";import{qf as Z}from"./chunk-sy7jbdeb.js";import{vf as N}from"./chunk-w62m5f0n.js";import{Af as W,xf as b}from"./chunk-d125j8t0.js";async function Hx(x){try{if(!await x.shouldRun.call(x))return}catch(B){console.error(`Error evaluating shouldRun for cron job ${x.name}:`,B);return}try{await x.onTick.call(x)}catch(B){console.error(`Error executing cron job ${x.name}:`,B)}try{await x.callback.call(x)}catch(B){console.error(`Error in cron job ${x.name}:`,B)}try{await x.onComplete.call(x)}catch(B){console.error(`Error completing cron job ${x.name}:`,B)}}class I{static token="scheduler";handles=[];resolved;constructor(x){this.resolved=x.jobs}get jobs(){return[...this.resolved]}useJobs(x){this.resolved=x}start(x=(B)=>B()){if(this.resolved.length===0)return;let B=globalThis.__gemiCronJobs??=new Map,C=new Map;for(let G of this.resolved){let H=new G;if(!H.name){console.error(`Cron job must have a name \u2014 ${G.name||"an anonymous class"} has none, so it is not scheduled. If this is a base class that other jobs extend, move it out of the discovered directory: \`abstract\` does not survive to runtime, so a class under app/cron is indistinguishable from a job.`);continue}if(!H.cron){console.error(`Cron job must have an expression. Job: ${H.name}`);continue}let Y=C.get(H.name);if(Y!==void 0){console.error(`Two cron jobs claim the name "${H.name}" \u2014 ${Y} is scheduled and ${G.name||"an anonymous class"} is not. A name is the scheduler's key, so only one job can hold it. Rename one.`);continue}C.set(H.name,G.name||"an anonymous class"),B.get(H.name)?.stop();let _=Bun.cron(H.cron,()=>x(()=>Hx(H)));B.set(H.name,_),this.handles.push(_)}}stop(){for(let x of this.handles)x.stop();this.handles=[]}}class Xx extends X{register(){this.app.singleton(T,()=>new T(this.app.config.get("auth",{})))}}class Yx extends X{register(){this.app.singleton(I,()=>new I(Z(M(),this.app.config.get("schedule",{}))))}async boot(){let x=this.app.make(I),B=this.app.config.get("schedule",{});if(B.jobs===void 0){let{jobsDir:G}=Z(M(),B);x.useJobs(await w(G))}if(process.env.GEMI_NO_SCHEDULE==="1")return;let C=this.app;x.start((G)=>b.run(C,G))}}class R{}class F extends Error{modelName;kind="FeatureModelMissing";constructor(x){super(`No "${x}" model is registered, so every feature stays off. Add the model to prisma/schema.prisma and export it from app/models \u2014 see docs/feature-flags.md.`);this.modelName=x}}class A extends R{modelName;constructor(x="FeatureFlag"){super();this.modelName=x}get available(){return c(this.modelName)}async load(){if(!this.available)throw new F(this.modelName);let x=h(this.modelName);return await x.asSystem(()=>x.findMany())}}function cx(x){return x}function u(){return{features:void 0,enabled:!0,source:new A,model:"FeatureFlag",ttl:30,context:void 0,onEvaluate:void 0,maxClientFlags:200}}class Zx extends X{register(){this.app.singleton(E,()=>{let x=this.app.config.get("features",{}),B=Z(u(),x);if(x?.model!==void 0&&x?.source===void 0)B.source=new A(x.model);else if(x?.model!==void 0&&x.source instanceof A&&x.source.modelName!==x.model)U.warning(`app/config/features.ts sets \`model: "${x.model}"\` and a source reading "${x.source.modelName}". The source wins; drop \`model\` to silence this.`);return new E(B,(C)=>U.warning(C))})}async boot(){let x=this.app.make(E);if(!x.config.enabled)return;try{await x.refresh()}catch(B){U.error(`Could not warm the feature flag cache at boot. ${B instanceof Error?B.message:String(B)}`)}}}class _x extends X{register(){this.app.singleton(N,()=>new N(this.app.config.get("mail",{})))}}function $x(x){return`listener:${x}`}function d(x,B){Px(x);let{maxAttempts:C,worker:G}=B,H=x.event.name,Y=class extends l{maxAttempts=C;worker=G;async run(..._){let[$,P]=Ox(_),z=W(V).rehydrate($,P);await new x().handle(z)}onFail(_){console.error(`The listener ${x.name} threw while handling ${H} off the queue. The queue will retry it up to ${C} times in total; nothing the dispatcher did is waiting on it.`,_)}onDeadletter(_){console.error(`The listener ${x.name} failed every one of its ${C} attempts at ${H} and has been dead-lettered, so this side effect did not happen and will not be retried.`,_)}};return Object.defineProperty(Y,"name",{value:$x(x.name),writable:!0}),Y}function Px(x){if(Object.getOwnPropertyDescriptor(x,"name")?.writable)return;throw Error(`The listener ${x.name} sets \`queued = true\` but does not declare \`static name\`, so it would be registered with the queue `+"under its class name \u2014 which a production build renames while the "+`payload that names it does not. Add: static name = "${x.name}";`)}function Ox(x){return typeof x[0]==="string"?x:x[0]}class V{static token="events";listeners={};events={};warnedFor=new Set;warnedAboutWaiting=new Set;config;constructor(x={}){this.config=Z(Q(),x),this.useListeners(this.config.listeners)}useListeners(x){this.config.listeners=x,this.listeners={},this.events={};let B=new Set;for(let C of x){if(!C.event){console.error(`Listener ${C.name} does not declare \`static event\`, so there is no event name to register it under and its handle will never run. Add: static event = SomeEvent;`);continue}if(B.has(C.name)){console.error(`Two event listeners are named "${C.name}" \u2014 the first is `+"registered and this one is not. A listener's name identifies it across the framework, so only one class can hold it. Rename one.");continue}B.add(C.name);let G=C.event.name,H=new C;this.events[G]??=C.event,(this.listeners[G]??=[]).push({listener:C,job:H.queued?d(C,H):null})}}get queuedListenerJobs(){return Object.values(this.listeners).flat().flatMap(({job:x})=>x?[x]:[])}get registeredListeners(){return[...this.config.listeners]}dispatch(x,B){if(this.deferToCommit(x,B,!1))return;this.runListeners(x,B)}async dispatchAndWait(x,B){if(this.deferToCommit(x,B,!0))return;return this.runListeners(x,B)}deferToCommit(x,B,C){let{name:G,afterCommit:H}=x.constructor;if(!H)return!1;let Y=i(()=>this.runListeners(x,B));if(Y&&C)this.warnNothingIsWaitedFor(G);return Y}async runListeners(x,B){let C=x.constructor.name,G=this.listeners[C];if(!G?.length){this.warnNothingIsListening(C);return}for(let{listener:H,job:Y}of G){if(Y){this.enqueue(Y,H,C,B);continue}try{await new H().handle(x)}catch(_){console.error(`The listener ${H.name} threw while handling ${C}. The `+"listeners after it still ran \u2014 a listener's failure is its own.",_)}}}rehydrate(x,B=[]){let C=this.events[x];if(!C)throw Error(`Cannot rebuild the event "${x}" that came off the queue: no registered listener binds to an event of that name, so there is no class to construct. A queued listener runs in an application that `+"discovered its own listeners \u2014 check that this process sees the "+`same app/listeners as the one that dispatched, and that the event declares \`static name = "${x}"\`.`);return new C(...B)}enqueue(x,B,C,G){if(G===void 0){console.error(`The listener ${B.name} is queued, but ${C} reached the dispatcher without its constructor arguments, so there is nothing for the queue to rebuild it from and the listener was skipped. Dispatch through ${C}.dispatch(...) or ${C}.dispatchAndWait(...), which carry them.`);return}try{W(O).push(x,JSON.stringify([C,G]))}catch(H){console.error(`The listener ${B.name} could not be queued for ${C}, so it did not run and will not be retried. The listeners after it still ran.`,H)}}warnNothingIsWaitedFor(x){if(Bun.env.NODE_ENV==="production")return;if(this.warnedAboutWaiting.has(x))return;this.warnedAboutWaiting.add(x),console.warn(`[gemi] ${x}.dispatchAndWait() was called inside a transaction and ${x} declares \`static afterCommit = true\`, so it resolved `+"immediately with no listener having run \u2014 they run when the "+"transaction commits. Await the transaction instead, or drop afterCommit if the caller needs the side effects first. Development only.")}warnNothingIsListening(x){if(Bun.env.NODE_ENV==="production")return;if(this.warnedFor.has(x))return;this.warnedFor.add(x),console.warn(`[gemi] ${x} was dispatched and nothing is listening for it. A listener registers under the name its event declares, so check that app/listeners holds a Listener with \`static event = ${x}\` and that ${x} declares \`static name = "${x}"\`. Development only.`)}}class zx extends X{register(){this.app.singleton(V,()=>new V(this.app.config.get("events",{})))}async boot(){let x=this.app.make(V),B=this.app.config.get("events",{});if(B.listeners===void 0){let{listenersDir:H}=Z(Q(),B);x.useListeners(await s(H))}let C=x.queuedListenerJobs;if(C.length===0)return;let G=this.app.make(O);for(let H of C)G.registerJob(H)}}class Kx extends X{register(){this.app.singleton(S,()=>new S(this.app.config.get("filesystem",{})))}}class Vx extends X{register(){this.app.singleton(D,()=>new D(this.app.config.get("image",{})))}}class Ax extends X{register(){this.app.instance(j,new j)}}function FB(x){return x}function o(){return{maxFileSize:10485760,onLogFileClosed:()=>{},onLogCreated:()=>{}}}class Ix extends X{register(){this.app.singleton(J,()=>new J(Z(o(),this.app.config.get("log",{}))))}async boot(){await this.app.make(J).boot()}}class Ux extends X{register(){this.app.singleton(k,()=>new k(Z(r(),this.app.config.get("middleware",{}))))}}function bB(x){return x}function n(){return{channels:{}}}class Ex extends X{register(){this.app.singleton(f,()=>new f(Z(n(),this.app.config.get("broadcast",{}))))}}class Wx extends X{register(){this.app.singleton(O,()=>new O(this.app.config.get("queue",{})))}async boot(){let x=this.app.config.get("queue",{});if(x.jobs!==void 0)return;let{jobsDir:B}=Z(a(),x);this.app.make(O).useJobs(await t(B))}}class y{}function e(x,B){return Math.floor(x/B)*B}function Qx(x,B){if(B<=0)return 0;return Math.min(1,Math.max(0,(B-x)/B))}function p(x,B,C,G){return B*Qx(C,G)+x}function Jx(x){let{current:B,previous:C,elapsed:G,window:H,limit:Y,cost:_}=x,$=Y-_;if($<0)return H;let P=Math.max(0,H-G);if(C>0){let K=H*(1-($-B)/C);if(K<=H)return Math.max(0,Math.ceil(K-G))}if(B<=$)return P;if(B<=0)return P;let z=H*(1-$/B);return P+Math.max(0,Math.ceil(z))}function xx(x){let{allowed:B,current:C,previous:G,now:H,elapsed:Y,window:_,limit:$,cost:P}=x;if(B){let K=p(C,G,Y,_);return{allowed:!0,limit:$,remaining:Math.max(0,Math.floor($-K)),resetAt:H-Y+_,retryAfter:0}}let z=Jx({current:C,previous:G,elapsed:Y,window:_,limit:$,cost:P});return{allowed:!1,limit:$,remaining:0,resetAt:H+z,retryAfter:z}}class m extends y{buckets=new Map;maxKeys;constructor(x={}){super();this.maxKeys=Math.max(1,x.maxKeys??1e5)}consume(x){let{key:B,limit:C,window:G}=x,H=x.cost??1,Y=Date.now(),_=e(Y,G),$=Y-_,P=this.roll(B,G,_),K=p(P.current,P.previous,$,G)+H<=C;if(K)P.current+=H;if(this.buckets.delete(B),this.buckets.set(B,P),this.buckets.size>this.maxKeys)this.evict(Y);return xx({allowed:K,current:P.current,previous:P.previous,now:Y,elapsed:$,window:G,limit:C,cost:H})}clear(){this.buckets.clear()}get size(){return this.buckets.size}roll(x,B,C){let G=this.buckets.get(x);if(!G||G.window!==B)return{window:B,windowStart:C,current:0,previous:0};if(G.windowStart===C)return G;if(G.windowStart+B===C)return G.previous=G.current,G.current=0,G.windowStart=C,G;return G.previous=0,G.current=0,G.windowStart=C,G}evict(x){for(let[B,C]of this.buckets)if(x-C.windowStart>=C.window*2)this.buckets.delete(B);for(let B of this.buckets.keys()){if(this.buckets.size<=this.maxKeys)break;this.buckets.delete(B)}}}function HC(x){return x}function Bx(){return{driver:new m,limit:1000,window:60}}class qx extends X{register(){this.app.singleton(v,()=>new v(Z(Bx(),this.app.config.get("ratelimiter",{}))))}}function OC(x){return x}function Cx(){return{url:process.env.REDIS_URL,options:void 0}}class Lx extends X{register(){this.app.singleton(g,()=>new g(Z(Cx(),this.app.config.get("redis",{}))))}}function Gx(x,B){let C=x.get(B);if(!C)throw Error(`Missing "${B}" configuration. Route dispatching needs a root router \u2014 declare it in "app/config/route.ts".`);return C}class Tx extends X{register(){this.app.singleton(L,()=>new L(Gx(this.app.config,"route.api"))),this.app.singleton(q,()=>new q(Gx(this.app.config,"route.view")))}boot(){this.app.make(L),this.app.make(q)}}
-export{I as Ta,Xx as Ua,Yx as Va,R as Wa,F as Xa,A as Ya,cx as Za,u as _a,Zx as $a,_x as ab,V as bb,zx as cb,Kx as db,Vx as eb,Ax as fb,FB as gb,o as hb,Ix as ib,Ux as jb,bB as kb,n as lb,Ex as mb,Wx as nb,e as ob,xx as pb,y as qb,m as rb,HC as sb,Bx as tb,qx as ub,OC as vb,Cx as wb,Lx as xb,Tx as yb};
-
-//# debugId=5D03A6748D65150C64756E2164756E21

package/dist/chunk-b35e128b.js

@@ -1,5 +0,0 @@
-// @bun
-import{Xb as o}from"./chunk-437085pe.js";import{Yb as i}from"./chunk-4yt5x8s2.js";import{qf as t}from"./chunk-sy7jbdeb.js";import{wf as r}from"./chunk-cyaz97p5.js";class n extends i{register(){this.app.singleton(r,()=>new r(t(o(),this.app.config.get("translation",{}))))}}
-export{n as Qa};
-
-//# debugId=367CF69A359EB0A064756E2164756E21