gemi 0.124.0 → 0.126.0

package/dist/testing/index.js

@@ -1,4 +1,4 @@
-import { D as I18nProvider, F as createMemoryHistory, I as RealtimeContext, K as QueryManagerContext, L as channelKey, N as ProgressManager, O as ServerDataContext, P as Action, U as toVariantKey, W as applyParams, i as RouteTransitionProvider, o as ClientRouterContext, q as QueryManagerProvider, r as m, t as ThemeProvider, tt as Subject } from "../chunks/ThemeProvider-CbOx8IRl.js";
+import { D as I18nProvider, F as createMemoryHistory, I as RealtimeContext, K as QueryManagerContext, L as channelKey, N as ProgressManager, O as ServerDataContext, P as Action, U as toVariantKey, W as applyParams, i as RouteTransitionProvider, o as ClientRouterContext, q as QueryManagerProvider, r as m, t as ThemeProvider, tt as Subject } from "../chunks/ThemeProvider-CS2a1snV.js";
 import { r as RouteStateProvider } from "../chunks/useParams-BN3XXfmG.js";
 import { Suspense, createElement, useContext, useMemo, useRef, useState } from "react";
 import { jsx } from "react/jsx-runtime";

package/dist/utils/appOrigin.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The app's public origin as configured: `HOST_NAME`, else `APP_URL`, trimmed
+ * and without a trailing `/`. `undefined` when neither is set.
+ *
+ * `HOST_NAME` comes first because it is the variable gemi has always read, so
+ * an app that sets it gets the same value it always did. Read on every call,
+ * never cached, so a test that stubs the environment sees its value at once.
+ *
+ * No validation here: gemi's own call sites keep their behaviour when the value
+ * is unset or odd. `Url.origin()` is the checked accessor.
+ */
+export declare function configuredAppOrigin(): string | undefined;
+/**
+ * `configuredAppOrigin()`, required to be an absolute http(s) URL. Falls back
+ * to `fallback` when nothing is configured; throws when there is no fallback
+ * either, or when the configured value is not such a URL.
+ */
+export declare function appOrigin(fallback?: string): string;
+//# sourceMappingURL=appOrigin.d.ts.map

package/dist/utils/appOrigin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appOrigin.d.ts","sourceRoot":"","sources":["../../utils/appOrigin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAQxD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBnD"}

package/dist/vitest/index.js

@@ -1,4 +1,4 @@
 // @bun
-import{fa as B,ga as D}from"../chunk-fvrmptd0.js";import"../chunk-fw7ds23a.js";import"../chunk-cfdwsvtx.js";import{Aa as J}from"../chunk-bnt8kx6x.js";import"../chunk-75ewjc4a.js";import"../chunk-17dndh5z.js";function N(){return{name:"gemi-custom-request",enforce:"pre",async transform(G,H){let j=H.split("?",1)[0];if(j.includes("/node_modules/")||!B.test(j))return null;return{code:await D(G),map:null}}}}export{N as gemiRequestPlugin,J as gemiIslandPlugin};
+import{fa as B,ga as D}from"../chunk-ewv1m1sv.js";import"../chunk-gv59djt3.js";import"../chunk-094m8mj3.js";import{Aa as J}from"../chunk-c65rh4k8.js";import"../chunk-s2y2b8tz.js";import"../chunk-89swy5aq.js";function N(){return{name:"gemi-custom-request",enforce:"pre",async transform(G,H){let j=H.split("?",1)[0];if(j.includes("/node_modules/")||!B.test(j))return null;return{code:await D(G),map:null}}}}export{N as gemiRequestPlugin,J as gemiIslandPlugin};
 
 //# debugId=C11E8611E15123D864756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gemi",
-  "version": "0.124.0",
+  "version": "0.126.0",
   "private": false,
   "license": "MIT",
   "author": "Enes Tufekci <enes@gemijs.dev>",

package/skills/gemi-react-best-practices/SKILL.md

@@ -141,7 +141,7 @@ carried for free.
 - `query-lazy-vs-mount-gate` - A lazy query does not refetch when its variant changes
 - `query-share-cache-key` - Identical path + params + search dedupes across components for free
 - `query-keep-previous-data` - Keep the previous page rendered while the next variant loads
-- `query-mutate-over-refetch` - Write the cache with `mutate` / `useMutate` instead of refetching
+- `query-mutate-over-refetch` - Write the cache with `mutate` / `useMutate` / `updates` instead of refetching
 - `query-debounce-search-variant` - Debounce a value before it becomes a query variant
 - `query-revalidate-on-focus` - Opt in only for cross-tab-mutable data; let `staleTime` gate it
 - `query-live-over-polling` - Prefer `live` / `useChannelInvalidate` over a bare `refetchUntil` poll

package/skills/gemi-react-best-practices/rules/query-mutate-over-refetch.md

@@ -44,6 +44,20 @@ mutate(
 );
 ```
 
+**When the mutation answers with the data, write the answer.** If the response
+is (or contains) what another query holds, pass `updates` to the mutation hook:
+the answer is written into that query before `onSuccess`, with no refetch at
+all. `useSetQueryData()` does the same by hand.
+
+```tsx
+const move = usePost("/pages/:pageId/assets/move", { params: { pageId } }, {
+  updates: [{ path: "/pages/:pageId/assets", params: { pageId } }],
+});
+const create = usePost("/todos", {}, {
+  updates: [{ path: "/todos", data: (created, todos) => [...todos, created] }],
+});
+```
+
 **Refetch, don't guess, when the server derives the value.** If a write changes
 counts, totals, credit balances or anything else computed server-side, call
 `mutate()` with no callback — it refetches without an optimistic write, which is

package/skills/gemi-react-best-practices/rules/routing-middleware-dsl.md

@@ -59,7 +59,8 @@ a route cannot cancel it with `-name`.
 **Rate-limit buckets are per client IP *and* route path**, so `/api/search` and
 `/api/upload` hold separate budgets — a shared limit needs a configured `key`
 function, and a budget outside a route uses the `RateLimiter` facade
-(`RateLimiter.consume(key, { limit, window })`).
+(`RateLimiter.consume(key, { limit, window })`, or `RateLimiter.enforce(key,
+{ limit, window }, message)` to throw the middleware's 429 over budget).
 
 Reference: `app/config/middleware.ts`, `app/http/routes/view.ts`
 <https://nstfkc.github.io/gemi/middleware.md>