gemi 0.124.0 → 0.125.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/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-zq5375wd.js";import"../chunk-dxyxd7b3.js";import"../chunk-hff9w6rt.js";import{Aa as J}from"../chunk-5fh4pvyt.js";import"../chunk-xe2pm36q.js";import"../chunk-hxn0s3zh.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.125.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>