katanakit-js 5.2.0 → 6.0.4

package/README.md

@@ -18,7 +18,7 @@ In the browser, use jsDelivr **`/+esm`** so named exports and dependencies resol
 
 ```html
 <script type="module">
-	import { useLogger, useGetApi, useInitApis } from "https://cdn.jsdelivr.net/npm/katanakit-js/+esm";
+	import { useLogger, useGetApi, defineApiConfig } from "https://cdn.jsdelivr.net/npm/katanakit-js/+esm";
 	useLogger("ready");
 </script>
 ```
@@ -29,17 +29,18 @@ In the browser, use jsDelivr **`/+esm`** so named exports and dependencies resol
 | **esm.sh**                         | `https://esm.sh/katanakit-js`                                                           |
 | **Raw ESM file**                   | `https://cdn.jsdelivr.net/npm/katanakit-js/dist/index.js` (needs bundler or import map) |
 
-Pin a version in production (e.g. `@2.14.2/+esm`). There is no IIFE/UMD build.
+Pin a version in production (e.g. `@6.0.4/+esm`). There is no IIFE/UMD build.
 
 ## Quick Start
 
 ```ts
-import { useInitApis, useGetApi, useLogger } from "katanakit-js";
+import { defineApiConfig, useGetApi, useLogger } from "katanakit-js";
 
 useLogger("boot");
 
-// Register your APIs once
-useInitApis({
+// Register your APIs once — returns the config, so you can also
+// `export default defineApiConfig({ … })` from a config file.
+defineApiConfig({
 	pokeapi: {
 		baseUri: "https://pokeapi.co/api/v2",
 		endpoints: { pokemonById: "/pokemon/:id/" },
@@ -58,6 +59,39 @@ if (result.ok) {
 }
 ```
 
+## Configuration files
+
+Every service that takes config exposes a **`define*Config`** entry point. One call
+registers it and hands it back, so a whole file can be just this:
+
+```ts
+// katanakit.config.ts
+export default defineApiConfig({
+  pokeapi: { baseUri: "https://pokeapi.co/api/v2", endpoints: { byId: "/pokemon/:id/" } },
+  debug: true, // boolean flags stay off the registry, on `config`
+  getPokemon: async function () {
+    //            ^^^^^^^^ `function`, never an arrow
+    if (this.config.debug) console.log("fetching…");
+    return useFetch("pokeapi", "byId", { params: { id: 25 } });
+  },
+});
+```
+
+```ts
+import api from "./katanakit.config.js";
+
+api.config.pokeapi; // your props and flags
+await api.getPokemon(); // your methods
+```
+
+Only `{ baseUri, endpoints }` objects reach the API registry. **Declare methods
+with `function`** — arrows have no `this`, so `this.config` inside one is
+`undefined` and TypeScript reports it.
+
+The old `useInit*` calls still work; they are deprecated and map one-for-one onto
+`define*Config`. Full table of which services accept methods in
+[Getting Started](https://docs.senseikatana.com/guides/getting-started).
+
 ## HTTP Client — API Manager
 
 The core of KatanaKit is a **typed, registry-based HTTP client**. You register
@@ -67,9 +101,9 @@ and returns a **Safe Result** (`{ ok, data, error }`) that never throws on HTTP
 ### 1. Register your APIs
 
 ```ts
-import { useInitApis } from "katanakit-js";
+import { defineApiConfig } from "katanakit-js";
 
-useInitApis({
+defineApiConfig({
 	// A public REST API
 	jsonplaceholder: {
 		baseUri: "https://jsonplaceholder.typicode.com",
@@ -329,8 +363,9 @@ const stop = useKatanaWatch(newProduct, () => checkValidations(), { deep: true }
 - **Hexagonal architecture** — pure core, infrastructure adapters, framework adapters
 - **Tree-shakeable** — destructured re-exports from Singleton facades
 - **SSR-safe** — all infrastructure adapters guard or fall back gracefully in server environments
-- **Filesystem (Node/Bun)** — `useReadFile`, `useWriteFile`, `useReadJsonFile`, `useReadModuleJson` and friends return Safe Results with native errno codes, loaded lazily through dynamic `import()` and guarded by `useIsNode()`
+- **Filesystem (Node/Bun)** — `useReadFile`, `useWriteFile`, `useReadJsonFile`, `useReadModuleJson`, `useHashFile` and friends return Safe Results with native errno codes, loaded lazily through dynamic `import()` and guarded by `useIsNode()`
 - **Fake data (optional)** — `useFakeVehicle`, `useFakeEmail`, `useFakeList`, … via an optional, lazy-loaded `@faker-js/faker` peer
+- **Katana UI** — framework-agnostic component foundations (`useButton`, `useInput`, `useCard`, `useBadge`, `useAlert`) live in the private `@katanakit/ui` workspace, styled with `katanakit-css` (see [UI Kit](https://docs.senseikatana.com/ui-kit/))
 
 ## Filesystem (Node/Bun)
 
@@ -372,6 +407,7 @@ const files = await useReadDir("data/cache", { recursive: true });
 | Read | `useReadFile`, `useReadFileBuffer`, `useReadJsonFile`, `useReadModuleFile`, `useReadModuleJson` |
 | Write | `useWriteFile`, `useAppendFile`, `useWriteJsonFile`, `useEnsureDir` |
 | Inspect | `useFileExists`, `useGetFileStats`, `useReadDir` |
+| Checksums | `useHashFile`, `useVerifyFileHash` — streaming `md5`/`sha1`/`sha256`/`sha512` digests (`sha256` by default) and case-insensitive verification |
 | Move / delete | `useCopyFile`, `useMoveFile`, `useRemoveFile`, `useRemoveDir` |
 | Paths | `useGetDirname`, `useResolvePath`, `useJoinPath`, `useGetRelativePath`, `useGetBasename`, `useGetFileExtension`, `useGetCwd`, `useIsNode` |
 
@@ -650,9 +686,9 @@ app.use(
 Long polling does not need a public URL. Session ids are `telegram:<chatId>`.
 
 ```ts
-import { useInitTelegram, useStartTelegramPolling } from "katanakit-js/adapters/telegram";
+import { defineTelegramConfig, useStartTelegramPolling } from "katanakit-js/adapters/telegram";
 
-useInitTelegram({ token: process.env.TELEGRAM_BOT_TOKEN });
+defineTelegramConfig({ token: process.env.TELEGRAM_BOT_TOKEN });
 await useStartTelegramPolling();
 ```
 
@@ -668,9 +704,9 @@ await useStartTelegramPolling();
 Webhook: `GET` / `POST` `/whatsapp/webhook`. Session ids are `wa:<phone>`.
 
 ```ts
-import { useInitWhatsApp, useStartWhatsApp } from "katanakit-js/adapters/whatsapp";
+import { defineWhatsAppConfig, useStartWhatsApp } from "katanakit-js/adapters/whatsapp";
 
-useInitWhatsApp({
+defineWhatsAppConfig({
 	token: process.env.WHATSAPP_TOKEN,
 	phoneNumberId: process.env.WHATSAPP_PHONE_NUMBER_ID,
 	verifyToken: process.env.WHATSAPP_VERIFY_TOKEN,
@@ -727,15 +763,15 @@ product FAQ, CRM, or ticket system. Keep the `{ name, description, parameters, e
 
 ## Framework usage
 
-All common `use*` helpers (`useLogger`, `useInitApis`, `useGetApi`, formatter, dates, utils, theme, …) are on the **main barrel** `katanakit-js`.
+All common `use*` helpers (`useLogger`, `useGetApi`, formatter, dates, utils, theme, …) plus the `define*Config` entry points (`defineApiConfig`, …) are on the **main barrel** `katanakit-js`.
 
 ### Astro (npm)
 
 ```astro
 ---
 // Frontmatter = server
-import { useLogger, useGetApi, useInitApis } from "katanakit-js";
-useInitApis({ /* ... */ });
+import { useLogger, useGetApi, defineApiConfig } from "katanakit-js";
+defineApiConfig({ /* ... */ });
 const result = await useGetApi("pokeapi", "pokemonById", { params: { id: 25 } });
 ---
 <script>
@@ -757,7 +793,7 @@ const result = await useGetApi("pokeapi", "pokemonById", { params: { id: 25 } })
 ### Vue / Nuxt / vanilla
 
 ```ts
-import { useLogger, useInitApis, useGetApi } from "katanakit-js";
+import { useLogger, defineApiConfig, useGetApi } from "katanakit-js";
 import { useRequest } from "katanakit-js/adapters/vue"; // Vue only
 import { useUnwrap } from "katanakit-js/adapters/nuxt"; // Nuxt only
 ```
@@ -780,8 +816,8 @@ See [Getting Started](https://docs.senseikatana.com/guides/getting-started) for
 | **Vue**       | `katanakit-js/adapters/vue`                     | `useRequest` composable with reactivity                      |
 | **Astro**     | `katanakit-js` or `katanakit-js/adapters/astro` | `AstroService`, `RssService`                                 |
 | **Assistant** | `katanakit-js/adapters/assistant`               | REST digital assistant (`useStartAssistant`)                 |
-| **Telegram**  | `katanakit-js/adapters/telegram`                | BotFather bot (`useInitTelegram`, `useStartTelegramPolling`) |
-| **WhatsApp**  | `katanakit-js/adapters/whatsapp`                | Meta Cloud API (`useInitWhatsApp`, `useStartWhatsApp`)       |
+| **Telegram**  | `katanakit-js/adapters/telegram`                | BotFather bot (`defineTelegramConfig`, `useStartTelegramPolling`) |
+| **WhatsApp**  | `katanakit-js/adapters/whatsapp`                | Meta Cloud API (`defineWhatsAppConfig`, `useStartWhatsApp`)  |
 
 ## REST API Adapters
 
@@ -806,10 +842,10 @@ full TypeScript types, cursor-based auto-pagination, and Safe Results.
 #### Setup
 
 ```ts
-import { useInitNotion } from "katanakit-js/adapters/notion";
+import { defineNotionConfig } from "katanakit-js/adapters/notion";
 
 // Token starts with "ntn_" or "secret_" — get one at https://www.notion.so/my-integrations
-useInitNotion({ token: process.env.NOTION_TOKEN });
+defineNotionConfig({ token: process.env.NOTION_TOKEN });
 ```
 
 #### Pages — read, create, update, archive
@@ -1015,22 +1051,22 @@ and batch operations. All functions return `FetchResult<T>`.
 #### Setup
 
 ```ts
-import { useInitWordPress } from "katanakit-js/adapters/wordpress";
+import { defineWordPressConfig } from "katanakit-js/adapters/wordpress";
 
 // Application Passwords (recommended) — WP Admin → Users → Your Profile → Application Passwords
-useInitWordPress({
+defineWordPressConfig({
 	baseUrl: "https://mysite.com",
 	auth: { type: "application-passwords", username: "admin", password: "xxxx xxxx xxxx" },
 });
 
 // JWT tokens
-useInitWordPress({
+defineWordPressConfig({
 	baseUrl: "https://mysite.com",
 	auth: { type: "jwt", token: "eyJhbGci..." },
 });
 
 // Nonce-based (for WP themes)
-useInitWordPress({
+defineWordPressConfig({
 	baseUrl: "https://mysite.com",
 	auth: { type: "nonce", nonce: "abc123" },
 });
@@ -1370,10 +1406,10 @@ Safe Result contract, validates every input, and refuses mass writes (update/del
 require non-empty filters).
 
 ```ts
-import { useInitInsforge, useIfSelect, useIfInsert } from "katanakit-js/adapters/insforge";
+import { defineInsforgeConfig, useIfSelect, useIfInsert } from "katanakit-js/adapters/insforge";
 
 // Server-only admin client (apiKey), or browser-safe client (anonKey)
-useInitInsforge({ baseUrl: process.env.INSFORGE_URL!, apiKey: process.env.INSFORGE_API_KEY! });
+defineInsforgeConfig({ baseUrl: process.env.INSFORGE_URL!, apiKey: process.env.INSFORGE_API_KEY! });
 
 const posts = await useIfSelect<{ id: number; title: string }>({
 	table: "posts",

package/dist/adapters/angular/fetch.js

@@ -43,7 +43,7 @@ export function useRequest(apiName, endpointName, options) {
         error.set(null);
         const result = await useFetch(apiName, endpointName, {
             method: "GET",
-            urlOptions: options,
+            ...options,
             signal: next.signal,
         });
         if (disposed || current !== version)

package/dist/adapters/angular/fetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../../src/adapters/angular/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAe,MAAM,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAW/D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,UAAU,CACzB,OAAe,EACf,YAAoB,EACpB,OAAoB;IAEpB,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAEtC,MAAM,IAAI,GAAG,MAAM,CAAW,IAAI,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,MAAM,CAAkB,IAAI,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAE7B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,UAAU,GAA2B,IAAI,CAAC;IAC9C,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACzC,MAAM,OAAO,GAAG,EAAE,OAAO,CAAC;QAC1B,UAAU,EAAE,KAAK,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;QACnC,UAAU,GAAG,IAAI,CAAC;QAElB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEhB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAI,OAAO,EAAE,YAAY,EAAE;YACvD,MAAM,EAAE,KAAK;YACb,UAAU,EAAE,OAAO;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;SACnB,CAAC,CAAC;QAEH,IAAI,QAAQ,IAAI,OAAO,KAAK,OAAO;YAAE,OAAO;QAE5C,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACtB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;aAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACjC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC,CAAC;IAEF,UAAU,CAAC,SAAS,CAAC,GAAG,EAAE;QACzB,QAAQ,GAAG,IAAI,CAAC;QAChB,UAAU,EAAE,KAAK,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,KAAK,OAAO,EAAE,CAAC;IAEf,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../../src/adapters/angular/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAe,MAAM,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAW/D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,UAAU,CACzB,OAAe,EACf,YAAoB,EACpB,OAAoB;IAEpB,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAEtC,MAAM,IAAI,GAAG,MAAM,CAAW,IAAI,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,MAAM,CAAkB,IAAI,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAE7B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,UAAU,GAA2B,IAAI,CAAC;IAC9C,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACzC,MAAM,OAAO,GAAG,EAAE,OAAO,CAAC;QAC1B,UAAU,EAAE,KAAK,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;QACnC,UAAU,GAAG,IAAI,CAAC;QAElB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEhB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAI,OAAO,EAAE,YAAY,EAAE;YACvD,MAAM,EAAE,KAAK;YACb,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,CAAC,MAAM;SACnB,CAAC,CAAC;QAEH,IAAI,QAAQ,IAAI,OAAO,KAAK,OAAO;YAAE,OAAO;QAE5C,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACtB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;aAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACjC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC,CAAC;IAEF,UAAU,CAAC,SAAS,CAAC,GAAG,EAAE;QACzB,QAAQ,GAAG,IAAI,CAAC;QAChB,UAAU,EAAE,KAAK,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,KAAK,OAAO,EAAE,CAAC;IAEf,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC"}

package/dist/adapters/bun/dummyjson.service.d.ts

@@ -1,17 +1,40 @@
 /** Base URL of the public dummyjson.com REST API. */
 export declare const DUMMYJSON_BASE_URL = "https://dummyjson.com";
 /**
- * Registers the dummyjson.com API in the HTTP manager under the `dummyjson`
- * key. Call once before any {@link useDummyJsonProducts}-style handler.
+ * The dummyjson.com API definition — plain data, so importing this module runs
+ * nothing and hits no network.
+ *
+ * Register it once with `defineApiConfig` before any {@link useDummyJsonProducts}-style
+ * handler; there is no separate init call to remember.
  *
  * @example
  * ```ts
- * import { useInitDummyJson } from "katanakit-js/adapters/bun";
+ * import { defineApiConfig } from "katanakit-js";
+ * import { dummyJsonApiConfig, useDummyJsonProducts } from "katanakit-js/adapters/bun";
+ *
+ * defineApiConfig(dummyJsonApiConfig);
  *
- * useInitDummyJson();
+ * const response = await useDummyJsonProducts();
  * ```
  */
-export declare function useInitDummyJson(): void;
+export declare const dummyJsonApiConfig: {
+    dummyjson: {
+        baseUri: string;
+        endpoints: {
+            products: string;
+            productById: string;
+            productSearch: string;
+            productCategories: string;
+            productByCategory: string;
+            users: string;
+            userById: string;
+            posts: string;
+            postById: string;
+            quotes: string;
+            quoteRandom: string;
+        };
+    };
+};
 /** Serializes `data` into a JSON {@link Response}. */
 export declare function jsonResponse(data: unknown, status?: number): Response;
 /**

package/dist/adapters/bun/dummyjson.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dummyjson.service.d.ts","sourceRoot":"","sources":["../../../src/adapters/bun/dummyjson.service.ts"],"names":[],"mappings":"AAGA,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,0BAA0B,CAAC;AAiB1D;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAOvC;AAkBD,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,SAAM,GAAG,QAAQ,CAKlE;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAE9D;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAE3E;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAIhF;AAED;;;;GAIG;AACH,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,QAAQ,CAAC,CAEvE;AAED;;;;;GAKG;AACH,wBAAsB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAIxF;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAE3D;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAExE;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAE3D;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAExE;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAE5D;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAEjE"}
+{"version":3,"file":"dummyjson.service.d.ts","sourceRoot":"","sources":["../../../src/adapters/bun/dummyjson.service.ts"],"names":[],"mappings":"AAGA,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,0BAA0B,CAAC;AAiB1D;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;CAK9B,CAAC;AAkBF,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,SAAM,GAAG,QAAQ,CAKlE;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAE9D;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAE3E;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEhF;AAED;;;;GAIG;AACH,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,QAAQ,CAAC,CAEvE;AAED;;;;;GAKG;AACH,wBAAsB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAExF;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAE3D;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAExE;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAE3D;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAExE;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAE5D;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAEjE"}

package/dist/adapters/bun/dummyjson.service.js

@@ -1,4 +1,4 @@
-import { useFetch, useInitApis } from "../../core/services/http.service.js";
+import { useFetch } from "../../core/services/http.service.js";
 /** Base URL of the public dummyjson.com REST API. */
 export const DUMMYJSON_BASE_URL = "https://dummyjson.com";
 /** Endpoints of the dummyjson.com REST API (relative to {@link DUMMYJSON_BASE_URL}). */
@@ -16,24 +16,28 @@ const DUMMYJSON_ENDPOINTS = {
     quoteRandom: "/quotes/random",
 };
 /**
- * Registers the dummyjson.com API in the HTTP manager under the `dummyjson`
- * key. Call once before any {@link useDummyJsonProducts}-style handler.
+ * The dummyjson.com API definition — plain data, so importing this module runs
+ * nothing and hits no network.
+ *
+ * Register it once with `defineApiConfig` before any {@link useDummyJsonProducts}-style
+ * handler; there is no separate init call to remember.
  *
  * @example
  * ```ts
- * import { useInitDummyJson } from "katanakit-js/adapters/bun";
+ * import { defineApiConfig } from "katanakit-js";
+ * import { dummyJsonApiConfig, useDummyJsonProducts } from "katanakit-js/adapters/bun";
+ *
+ * defineApiConfig(dummyJsonApiConfig);
  *
- * useInitDummyJson();
+ * const response = await useDummyJsonProducts();
  * ```
  */
-export function useInitDummyJson() {
-    useInitApis({
-        dummyjson: {
-            baseUri: DUMMYJSON_BASE_URL,
-            endpoints: DUMMYJSON_ENDPOINTS,
-        },
-    });
-}
+export const dummyJsonApiConfig = {
+    dummyjson: {
+        baseUri: DUMMYJSON_BASE_URL,
+        endpoints: DUMMYJSON_ENDPOINTS,
+    },
+};
 /**
  * Converts a Safe Result into a JSON {@link Response}.
  *
@@ -68,7 +72,7 @@ export async function useDummyJsonProducts() {
  * @returns A JSON `Response` wrapping the product.
  */
 export async function useDummyJsonProductById(id) {
-    return toResponse(await useFetch("dummyjson", "productById", { urlOptions: { params: { id } } }));
+    return toResponse(await useFetch("dummyjson", "productById", { params: { id } }));
 }
 /**
  * Searches products by a free-text query.
@@ -77,7 +81,7 @@ export async function useDummyJsonProductById(id) {
  * @returns A JSON `Response` wrapping the search results.
  */
 export async function useDummyJsonProductSearch(query) {
-    return toResponse(await useFetch("dummyjson", "productSearch", { urlOptions: { query: { q: query } } }));
+    return toResponse(await useFetch("dummyjson", "productSearch", { query: { q: query } }));
 }
 /**
  * Lists all product categories.
@@ -94,7 +98,7 @@ export async function useDummyJsonProductCategories() {
  * @returns A JSON `Response` wrapping the products.
  */
 export async function useDummyJsonProductsByCategory(category) {
-    return toResponse(await useFetch("dummyjson", "productByCategory", { urlOptions: { params: { category } } }));
+    return toResponse(await useFetch("dummyjson", "productByCategory", { params: { category } }));
 }
 /**
  * Lists users from dummyjson.com.
@@ -111,7 +115,7 @@ export async function useDummyJsonUsers() {
  * @returns A JSON `Response` wrapping the user.
  */
 export async function useDummyJsonUserById(id) {
-    return toResponse(await useFetch("dummyjson", "userById", { urlOptions: { params: { id } } }));
+    return toResponse(await useFetch("dummyjson", "userById", { params: { id } }));
 }
 /**
  * Lists posts from dummyjson.com.
@@ -128,7 +132,7 @@ export async function useDummyJsonPosts() {
  * @returns A JSON `Response` wrapping the post.
  */
 export async function useDummyJsonPostById(id) {
-    return toResponse(await useFetch("dummyjson", "postById", { urlOptions: { params: { id } } }));
+    return toResponse(await useFetch("dummyjson", "postById", { params: { id } }));
 }
 /**
  * Lists quotes from dummyjson.com.

package/dist/adapters/bun/dummyjson.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"dummyjson.service.js","sourceRoot":"","sources":["../../../src/adapters/bun/dummyjson.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dummyjson.service.js","sourceRoot":"","sources":["../../../src/adapters/bun/dummyjson.service.ts"],"names":[],"mappings":"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"}

package/dist/adapters/bun/main.js

@@ -1,6 +1,7 @@
-import { useInitDummyJson } from "./dummyjson.service.js";
+import { defineApiConfig } from "../../core/services/http.service.js";
+import { dummyJsonApiConfig } from "./dummyjson.service.js";
 import { useBunStart } from "./server.js";
-useInitDummyJson();
+defineApiConfig(dummyJsonApiConfig);
 const server = useBunStart(Number(process.env.PORT ?? 3000), process.env.HOST ?? "localhost");
 console.log(`Server running at ${server.url}`);
 //# sourceMappingURL=main.js.map

package/dist/adapters/bun/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/adapters/bun/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,gBAAgB,EAAE,CAAC;AAEnB,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,WAAW,CAAC,CAAC;AAC9F,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/adapters/bun/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,eAAe,CAAC,kBAAkB,CAAC,CAAC;AAEpC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,WAAW,CAAC,CAAC;AAC9F,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC"}

package/dist/adapters/bun/server.d.ts

@@ -21,9 +21,10 @@ export interface BunServerOptions {
  *
  * @example
  * ```ts
- * import { useInitDummyJson, useBunCreate } from "katanakit-js/adapters/bun";
+ * import { dummyJsonApiConfig, useBunCreate } from "katanakit-js/adapters/bun";
+ * import { defineApiConfig } from "katanakit-js";
  *
- * useInitDummyJson();
+ * defineApiConfig(dummyJsonApiConfig);
  * const server = useBunCreate({ port: 3000 });
  * console.log(`Server running at ${server.url}`);
  * ```

package/dist/adapters/bun/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/adapters/bun/server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,eAAe,EAA2B,MAAM,aAAa,CAAC;AAK5E,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAChC,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,sDAAsD;IACtD,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACtF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,gBAAqB,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAWlF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAE5F;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAE9D;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,sBAAsB,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAK9E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/adapters/bun/server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,eAAe,EAA2B,MAAM,aAAa,CAAC;AAK5E,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAChC,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,sDAAsD;IACtD,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACtF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,gBAAqB,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAWlF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAE5F;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAE9D;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,sBAAsB,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAK9E"}

package/dist/adapters/bun/server.js

@@ -13,9 +13,10 @@ let server = null;
  *
  * @example
  * ```ts
- * import { useInitDummyJson, useBunCreate } from "katanakit-js/adapters/bun";
+ * import { dummyJsonApiConfig, useBunCreate } from "katanakit-js/adapters/bun";
+ * import { defineApiConfig } from "katanakit-js";
  *
- * useInitDummyJson();
+ * defineApiConfig(dummyJsonApiConfig);
  * const server = useBunCreate({ port: 3000 });
  * console.log(`Server running at ${server.url}`);
  * ```

package/dist/adapters/bun/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/adapters/bun/server.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC,OAAO,EAAwB,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE5E,yCAAyC;AACzC,IAAI,MAAM,GAAiC,IAAI,CAAC;AAchD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,YAAY,CAAC,UAA4B,EAAE;IAC1D,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,GAAG,GAAG,CAAC,KAAK,CAAY;QAC7B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,WAAW;QACzC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,uBAAuB,EAAE;QACnD,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,IAAsB,EAAE,QAAiB;IACpE,OAAO,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC9B,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,sBAAsB,GAAG,KAAK;IAC9D,IAAI,MAAM,EAAE,CAAC;QACZ,MAAM,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC1C,MAAM,GAAG,IAAI,CAAC;IACf,CAAC;AACF,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/adapters/bun/server.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC,OAAO,EAAwB,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE5E,yCAAyC;AACzC,IAAI,MAAM,GAAiC,IAAI,CAAC;AAchD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,YAAY,CAAC,UAA4B,EAAE;IAC1D,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,GAAG,GAAG,CAAC,KAAK,CAAY;QAC7B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,WAAW;QACzC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,uBAAuB,EAAE;QACnD,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,IAAsB,EAAE,QAAiB;IACpE,OAAO,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC9B,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,sBAAsB,GAAG,KAAK;IAC9D,IAAI,MAAM,EAAE,CAAC;QACZ,MAAM,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC1C,MAAM,GAAG,IAAI,CAAC;IACf,CAAC;AACF,CAAC"}

package/dist/adapters/insforge/index.d.ts

@@ -1,3 +1,3 @@
 export type { IfConfig, IfInsertRows, IfInvokeOptions, IfListOptions, IfOrder, IfRpcCall, IfStorageRef, IfTableQuery, IfUpdatePatch, IfWriteQuery, } from "../../types/index.js";
-export { useGetInsforgeClient, useIfDelete, useIfDownload, useIfGetPublicUrl, useIfInsert, useIfInvokeFunction, useIfListObjects, useIfRemove, useIfRpc, useIfSelect, useIfUpdate, useIfUpload, useInitInsforge, } from "./insforge.service.js";
+export { defineInsforgeConfig, useGetInsforgeClient, useIfDelete, useIfDownload, useIfGetPublicUrl, useIfInsert, useIfInvokeFunction, useIfListObjects, useIfRemove, useIfRpc, useIfSelect, useIfUpdate, useIfUpload, useInitInsforge, } from "./insforge.service.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/adapters/insforge/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/insforge/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,aAAa,EACb,OAAO,EACP,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,GACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,WAAW,EACX,WAAW,EACX,WAAW,EACX,eAAe,GACf,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/insforge/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,aAAa,EACb,OAAO,EACP,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,GACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,WAAW,EACX,WAAW,EACX,WAAW,EACX,eAAe,GACf,MAAM,uBAAuB,CAAC"}

package/dist/adapters/insforge/index.js

@@ -1,2 +1,2 @@
-export { useGetInsforgeClient, useIfDelete, useIfDownload, useIfGetPublicUrl, useIfInsert, useIfInvokeFunction, useIfListObjects, useIfRemove, useIfRpc, useIfSelect, useIfUpdate, useIfUpload, useInitInsforge, } from "./insforge.service.js";
+export { defineInsforgeConfig, useGetInsforgeClient, useIfDelete, useIfDownload, useIfGetPublicUrl, useIfInsert, useIfInvokeFunction, useIfListObjects, useIfRemove, useIfRpc, useIfSelect, useIfUpdate, useIfUpload, useInitInsforge, } from "./insforge.service.js";
 //# sourceMappingURL=index.js.map

package/dist/adapters/insforge/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/insforge/index.ts"],"names":[],"mappings":"AAYA,OAAO,EACN,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,WAAW,EACX,WAAW,EACX,WAAW,EACX,eAAe,GACf,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/insforge/index.ts"],"names":[],"mappings":"AAYA,OAAO,EACN,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,WAAW,EACX,WAAW,EACX,WAAW,EACX,eAAe,GACf,MAAM,uBAAuB,CAAC"}

package/dist/adapters/insforge/insforge.service.d.ts

@@ -1,9 +1,40 @@
 import { type InsForgeClient } from "@insforge/sdk";
-import type { FetchResult, IfConfig, IfInsertRows, IfInvokeOptions, IfListOptions, IfRpcCall, IfStorageRef, IfTableQuery, IfUpdatePatch, IfWriteQuery } from "../../types/index.js";
+import type { ConfigFacade, FetchResult, IfConfig, IfInsertRows, IfInvokeOptions, IfListOptions, IfRpcCall, IfStorageRef, IfTableQuery, IfUpdatePatch, IfWriteQuery } from "../../types/index.js";
+/**
+ * Registers the InsForge client and returns your methods alongside it — the
+ * config-file entry point. One call is the whole setup: no separate
+ * `useInitInsforge(...)` step.
+ *
+ * Prefer `apiKey` (server-only, admin) or `anonKey` (browser-safe) depending
+ * on the runtime. Declare methods with `function` (never arrows) so
+ * `this.config` resolves to the config you declared.
+ *
+ * @typeParam T - The literal passed in: InsForge config plus any methods.
+ * @param input - Backend URL + credentials + optional schema, plus your methods.
+ * @returns The declared config plus your methods (see {@link ConfigFacade}).
+ * @throws {Error} If the config fails validation.
+ *
+ * @example
+ * ```ts
+ * import { defineInsforgeConfig } from "katanakit-js/adapters/insforge";
+ *
+ * export default defineInsforgeConfig({
+ *   baseUrl: "https://app.insforge.app",
+ *   anonKey: "…",
+ *   listUsers: async function () {
+ *     return useIfSelect("users");
+ *   },
+ * });
+ * ```
+ */
+export declare function defineInsforgeConfig<T extends IfConfig>(input: T & ThisType<ConfigFacade<T>>): ConfigFacade<T>;
 /**
  * Registers the InsForge client. Call once per app. Prefer `apiKey`
  * (server-only, admin) or `anonKey` (browser-safe) depending on the runtime.
  *
+ * @deprecated Use {@link defineInsforgeConfig}, which registers the config and
+ * returns it with any methods declared on the same literal.
+ *
  * @param config - Backend URL + credentials + optional schema.
  * @throws {Error} If the config fails validation.
  *

package/dist/adapters/insforge/insforge.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"insforge.service.d.ts","sourceRoot":"","sources":["../../../src/adapters/insforge/insforge.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAgBrF,OAAO,KAAK,EAEX,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,aAAa,EACb,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,MAAM,sBAAsB,CAAC;AAkJ9B;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CActD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,GAAG,IAAI,CAE5D;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,KAAK,EAAE,YAAY,GACjB,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAwB3B;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAe3B;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,aAAa,GAClB,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAyB3B;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,KAAK,EAAE,YAAY,GACjB,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAc3B;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAYpF;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAChC,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,IAAI,GAAG,IAAI,GACf,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAW/C;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAsBjF;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAChC,GAAG,EAAE,YAAY,GACf,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAW/C;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAa/C;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,WAAW,CAAC;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBvF;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EACpD,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAazB"}
+{"version":3,"file":"insforge.service.d.ts","sourceRoot":"","sources":["../../../src/adapters/insforge/insforge.service.ts"],"names":[],"mappings":"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"}

package/dist/adapters/insforge/insforge.service.js

@@ -1,4 +1,5 @@
 import { createAdminClient, createClient } from "@insforge/sdk";
+import { useSplitConfig } from "../../core/services/utils.service.js";
 import { useValidate } from "../../core/services/validation.service.js";
 import { IfBucketSchema, IfConfigSchema, IfInsertRowsSchema, IfInvokeOptionsSchema, IfListOptionsSchema, IfRpcCallSchema, IfStorageRefSchema, IfTableNameSchema, IfTableQuerySchema, IfUpdatePatchSchema, IfWriteQuerySchema, } from "../../schemas/insforge.schema.js";
 /** Module-level client. InsForge is the database fallback, not the default. */
@@ -70,7 +71,7 @@ function invalidInput(parsed) {
 function notConfigured() {
     return {
         data: null,
-        error: { message: "[InsForge] Not configured. Call useInitInsforge() first.", status: 0 },
+        error: { message: "[InsForge] Not configured. Call defineInsforgeConfig() first.", status: 0 },
         url: "",
         status: 0,
         ok: false,
@@ -103,10 +104,46 @@ function scopedDatabase(database, schema) {
     }
     return database;
 }
+/**
+ * Registers the InsForge client and returns your methods alongside it — the
+ * config-file entry point. One call is the whole setup: no separate
+ * `useInitInsforge(...)` step.
+ *
+ * Prefer `apiKey` (server-only, admin) or `anonKey` (browser-safe) depending
+ * on the runtime. Declare methods with `function` (never arrows) so
+ * `this.config` resolves to the config you declared.
+ *
+ * @typeParam T - The literal passed in: InsForge config plus any methods.
+ * @param input - Backend URL + credentials + optional schema, plus your methods.
+ * @returns The declared config plus your methods (see {@link ConfigFacade}).
+ * @throws {Error} If the config fails validation.
+ *
+ * @example
+ * ```ts
+ * import { defineInsforgeConfig } from "katanakit-js/adapters/insforge";
+ *
+ * export default defineInsforgeConfig({
+ *   baseUrl: "https://app.insforge.app",
+ *   anonKey: "…",
+ *   listUsers: async function () {
+ *     return useIfSelect("users");
+ *   },
+ * });
+ * ```
+ */
+export function defineInsforgeConfig(input) {
+    const { config, methods } = useSplitConfig(input);
+    // Zod strips the method entries, so the whole literal is safe to validate.
+    useInitInsforge(input);
+    return { config, ...methods };
+}
 /**
  * Registers the InsForge client. Call once per app. Prefer `apiKey`
  * (server-only, admin) or `anonKey` (browser-safe) depending on the runtime.
  *
+ * @deprecated Use {@link defineInsforgeConfig}, which registers the config and
+ * returns it with any methods declared on the same literal.
+ *
  * @param config - Backend URL + credentials + optional schema.
  * @throws {Error} If the config fails validation.
  *