@symbo.ls/fetch 3.7.0 → 3.7.3

package/README.md

@@ -682,6 +682,66 @@ const db = createAdapter({
 })
 ```
 
+## Language / i18n
+
+Fetch automatically injects the current language into every request — both as a `lang` query parameter and as an `Accept-Language` header.
+
+### Setting the language
+
+Set the language in root state:
+
+```js
+state: { root: { lang: 'ka' } }
+```
+
+Or use the polyglot plugin which manages `state.root.lang` automatically.
+
+### Per-request override
+
+Override the language for a specific fetch by including `lang` in params:
+
+```js
+{
+  fetch: {
+    from: 'articles',
+    params: { lang: 'de' }  // overrides global language for this request
+  }
+}
+```
+
+### How it works
+
+1. `lang` is added to `params` (sent as query parameter / RPC argument)
+2. `Accept-Language` header is set on the request
+3. If `params.lang` is already set explicitly, it is not overwritten
+
+This follows the same pattern as XMA's `t()` function where `state.root.lang` is the source of truth for the current language.
+
+## Disabling fetch
+
+Fetch is included by default in smbls. To disable it:
+
+```js
+import { createDefine } from '@symbo.ls/smbls'
+
+// Disable fetch, keep everything else
+const options = {
+  define: createDefine({ fetch: false })
+}
+```
+
+## domql plugin
+
+Fetch can also be used as a domql plugin:
+
+```js
+import { fetchPlugin } from '@symbo.ls/fetch'
+
+context.plugins = [fetchPlugin]
+```
+
+When used as a plugin, fetch hooks into the `create` lifecycle to auto-execute fetch configs defined on elements.
+
 ## All `fetch` options
 
 | Option | Type | Default | Description |
@@ -722,3 +782,4 @@ const db = createAdapter({
 | `order` | string/object/array | — | Sort order |
 | `headers` | object | — | Per-request headers (REST) |
 | `baseUrl` | string | — | Per-request base URL (REST) |
+| `lang` | string | auto from context/state | Language override (via params) |

package/index.js

@@ -257,13 +257,24 @@ const resolveParamsSync = (params) => {
   return params
 }
 
-const resolveParams = (params, element) => {
-  if (!params) return undefined
-  if (isFunction(params)) return params(element, element.state)
-  const resolved = {}
-  for (const key in params) {
-    const val = params[key]
-    resolved[key] = isFunction(val) ? val(element, element.state) : val
+const resolveLanguage = (element, context) => {
+  const root = element?.state?.root || context?.state?.root
+  if (root?.lang) return root.lang
+  return undefined
+}
+
+const resolveParams = (params, element, context) => {
+  let resolved
+  if (!params) {
+    resolved = undefined
+  } else if (isFunction(params)) {
+    resolved = params(element, element.state)
+  } else {
+    resolved = {}
+    for (const key in params) {
+      const val = params[key]
+      resolved[key] = isFunction(val) ? val(element, element.state) : val
+    }
   }
   return resolved
 }
@@ -304,7 +315,7 @@ const resolveAdapter = async (db, context) => {
   db.__resolving = resolveDb(db)
   const resolved = await db.__resolving
   db.__resolved = resolved
-  context.db = resolved
+  context.fetch = resolved
   delete db.__resolving
 
   // Auto-init auth when adapter supports it and db.auth is enabled
@@ -368,7 +379,7 @@ const setFetchStatus = (element, status) => {
 // --- Core fetch runner ---
 
 const runFetch = async (config, element, context, opts = {}) => {
-  const db = context?.db
+  const db = context?.fetch
   if (!db) return
 
   // enabled check
@@ -396,7 +407,7 @@ const runFetch = async (config, element, context, opts = {}) => {
     if (q) select = q.select || (q.length && q.join(',')) || undefined
   }
 
-  const params = resolveParams(rawParams, element)
+  const params = resolveParams(rawParams, element, context)
   const cacheConfig = parseCacheConfig(cacheRaw)
   const retryConfig = resolveRetryConfig(config)
 
@@ -484,6 +495,12 @@ const runFetch = async (config, element, context, opts = {}) => {
 
     const request = { from, select, params, single, limit, offset, order, headers, baseUrl }
 
+    // Inject language into request headers
+    const lang = resolveLanguage(element, context)
+    if (lang) {
+      request.headers = { ...request.headers, 'Accept-Language': lang }
+    }
+
     // Pagination support
     if (page !== undefined) {
       if (isObject(page)) {
@@ -722,7 +739,7 @@ const rollbackOptimistic = (element, config) => {
 // --- Mutation runner (insert/update/delete with optimistic + invalidation) ---
 
 const runMutation = async (config, element, context) => {
-  const db = context?.db
+  const db = context?.fetch
   if (!db) return
 
   const adapter = await resolveAdapter(db, context)
@@ -772,7 +789,13 @@ const runMutation = async (config, element, context) => {
     if (!isFunction(fn)) return
 
     const request = { from, data: mutationData, headers, baseUrl }
-    if (config.params) request.params = resolveParams(config.params, element)
+    if (config.params) request.params = resolveParams(config.params, element, context)
+
+    // Inject language into mutation request headers
+    const lang = resolveLanguage(element, context)
+    if (lang) {
+      request.headers = { ...request.headers, 'Accept-Language': lang }
+    }
 
     const retryConfig = resolveRetryConfig(config)
     const result = await withRetry(() => fn(request), retryConfig)
@@ -828,7 +851,7 @@ const runMutation = async (config, element, context) => {
 
 export const executeFetch = (param, element, state, context) => {
   if (!param) return
-  const db = context?.db
+  const db = context?.fetch
   if (!db) return
 
   const fetchProp = exec(param, element)
@@ -933,7 +956,7 @@ export const queryClient = {
   },
 
   prefetchQuery: async (config, context) => {
-    const db = context?.db
+    const db = context?.fetch
     if (!db) return
 
     const adapter = await resolveAdapter(db, context)
@@ -964,5 +987,31 @@ export const queryClient = {
   clear: () => removeCache()
 }
 
+// --- Plugin interface ---
+
+/**
+ * domql plugin for declarative data fetching.
+ *
+ * Usage:
+ *   context.plugins = [fetchPlugin]
+ *
+ * Or with language:
+ *   context.plugins = [fetchPlugin]
+ *   context.language = 'en'
+ *
+ * When used as a plugin, add `fetch` to `context.define` or
+ * it is automatically registered via `defaultDefine.fetch`.
+ */
+export const fetchPlugin = {
+  name: 'fetch',
+
+  // Hook into element creation to auto-execute fetch configs
+  create (element) {
+    const fetchProp = element.fetch || element.props?.fetch
+    if (!fetchProp) return
+    executeFetch(fetchProp, element, element.state, element.context)
+  }
+}
+
 export { parseDuration }
 export default executeFetch

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbo.ls/fetch",
-  "version": "3.7.0",
+  "version": "3.7.3",
   "license": "CC-BY-NC-4.0",
   "type": "module",
   "module": "./index.js",
@@ -25,7 +25,7 @@
     "adapters"
   ],
   "dependencies": {
-    "@domql/utils": "^3.7.0"
+    "@domql/utils": "^3.7.3"
   },
   "peerDependencies": {
     "@supabase/supabase-js": "^2.0.0"