mates 0.4.0-beta.9 → 0.4.1

package/dist/minidb/index.d.ts

@@ -1,3 +1,3 @@
-export type { MiniDBInstance, MiniDBList, MiniDBMigrateFn, MiniDBMigrator, } from "./minidb";
+export type { MiniDBInstance, MiniDBMigrateFn, MiniDBMigrator, TableHandle, } from "./minidb";
 export { miniDB } from "./minidb";
 //# sourceMappingURL=index.d.ts.map

package/dist/minidb/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/minidb/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,UAAU,EACV,eAAe,EACf,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/minidb/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,WAAW,GACZ,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/minidb/minidb.d.ts

@@ -4,101 +4,95 @@ export type MiniDBMigrator = {
 };
 export type MiniDBMigrateFn = (oldVersion: number, newVersion: number, migrator: MiniDBMigrator) => void;
 /**
- * A reactive list backed by an IndexedDB object store.
+ * A reactive table handle backed by an IndexedDB object store.
  *
- * Calling `list()` returns a plain `T[]` and registers the list as a reactive
- * dependency — components and effects re-run automatically when any item
- * changes.  The returned array is a normal JS array so `.filter()`, `.sort()`,
- * `.map()` etc. work directly.
+ * - `list()` returns a plain `T[]` and registers the list as a reactive
+ *   dependency — components and effects re-run when any item changes.
+ *   The returned array is a normal JS array so `.filter()`, `.sort()`,
+ *   `.map()` etc. work directly.
  *
- * All write methods (`add`, `set`, `update`, `deleteRow`, `clear`) are async
- * and persist to IndexedDB before resolving.  Every write is also broadcast to
- * other tabs via `BroadcastChannel` so their atoms stay in sync.
+ * - `find(key)` queries IndexedDB directly without loading the full table
+ *   into memory. The result is a plain value, **not** reactive.
+ *
+ * All write methods (`add`, `delete`) persist to IndexedDB and broadcast
+ * to other tabs via `BroadcastChannel`.
  */
-export type MiniDBList<T> = {
+export type TableHandle<T> = {
     /** Reactive — returns all items as `T[]`. Tracks as a dependency. */
     (): T[];
-    /** Reactive point lookup by id. */
-    get(id: string): T | undefined;
-    /** Reactive existence check by id. */
-    has(id: string): boolean;
-    /** Reactive item count. */
-    readonly size: number;
+    /** Reactive — returns all items as `T[]`. Alias for call syntax. */
+    list(): T[];
+    /**
+     * Non-reactive — fetches a single item by key directly from IndexedDB.
+     * Does NOT load the full table into memory. Returns `undefined` if not found.
+     */
+    find(key: string): Promise<T | undefined>;
     /**
      * Add an item. Uses the item's `id` field as the key when present,
      * otherwise auto-generates a UUID and assigns it.
      * @returns The id used.
      */
     add(item: T): Promise<string>;
-    /** Upsert — insert if absent, replace if present. */
-    set(id: string, item: T): Promise<void>;
-    /** Draft-style mutation — modify the item in-place, then persist. */
-    update(id: string, fn: (item: T) => void): Promise<void>;
-    /** Delete one item by id. */
-    deleteRow(id: string): Promise<void>;
-    /** Remove all items from the list. */
-    clear(): Promise<void>;
+    /** Delete one item by key. */
+    delete(key: string): Promise<void>;
+    /**
+     * Update an item in-place. Fetches from the in-memory atom, applies `fn`,
+     * persists to IndexedDB, and syncs the reactive state.
+     * Does nothing if the key doesn't exist.
+     */
+    update(key: string, fn: (item: T) => void): Promise<void>;
+    /** Reactive item count. */
+    readonly size: number;
 };
 export type MiniDBInstance = {
     /**
-     * Returns a reactive list for the given name.
+     * Returns a table handle for the given name.
      * The underlying IDB object store is created automatically on first call.
      *
-     * Await calls sequentially when requesting multiple new lists — each new
-     * list may internally close and reopen the database to add the store.
+     * Await calls sequentially when requesting multiple new tables — each new
+     * table may internally close and reopen the database to add the store.
      */
-    list<T>(name: string): Promise<MiniDBList<T>>;
+    table<T>(name: string): Promise<TableHandle<T>>;
 };
 /**
  * Opens (or creates) the opinionated `"mini-db"` IndexedDB database.
  *
  * - **Fixed name** — always `"mini-db"`, cannot be changed.
  * - **No schema** — object stores are created automatically on first
- *   `db.list()` call.
- * - **Designed for ≤ 1 000 records per list** — all data is held in memory
- *   as a reactive `mapAtom`.  Components re-render automatically on any write.
+ *   `db.table()` call.
+ * - **`list()` loads all into memory** as a reactive `mapAtom`. Components
+ *   re-render automatically on any write.
+ * - **`find()` queries IDB directly** without loading the full dataset.
  * - **No cursors, no indexes, no query builder** — use plain JS array methods
- *   (`filter`, `sort`, `map`, …) on the result of `list()`.
+ *   (`filter`, `sort`, `map`, …) on `list()`.
  * - **Cross-tab sync** — writes broadcast via `BroadcastChannel` so every
  *   open tab's atoms reflect changes immediately without polling.
  *
  * @param version    App-level data version (default `1`).  Increment to
  *                   trigger the `onMigrate` callback.
  * @param onMigrate  Called once when `version` changes.  Use
- *                   `migrator.clear("listName")` to wipe stale data.
+ *                   `migrator.clear("tableName")` to wipe stale data.
  *
  * @example
  * ```ts
  * interface User { id: string; name: string; role: string }
  *
- * // One shared instance — open at module level, export and reuse everywhere.
  * export const db = await miniDB(2, (oldV, newV, m) => {
  *   if (oldV < 2) m.clear("users");
  * });
  *
- * const users = await db.list<User>("users");
+ * const users = await db.table<User>("users");
  *
- * // ── Reactive template ─────────────────────────────────────────────────────
- * html`
- *   ${users()
- *     .filter(u => u.role === "admin")
- *     .sort((a, b) => a.name.localeCompare(b.name))
- *     .map(u => html`<li>${u.name}</li>`)}
- * `
+ * // ── Reactive: loads all into memory, tracks changes ──────────────────────
+ * users.list().filter(u => u.role === "admin")
  *
- * // ── Writes (IDB + atom + broadcast to other tabs) ─────────────────────────
- * await users.add({ id: "u1", name: "Alice", role: "admin" });
- * await users.add({ name: "Bob", role: "user" });      // auto-generates id
- * await users.set("u1", { id: "u1", name: "Alice B.", role: "admin" });
- * await users.update("u1", u => { u.role = "mod"; });
- * await users.deleteRow("u1");
- * await users.clear();
+ * // ── Non-reactive: direct IDB lookup, no memory load ──────────────────────
+ * const admin = await users.find("u1");
  *
- * // ── Reactive reads ────────────────────────────────────────────────────────
- * users();           // User[]
- * users.get("u1");   // User | undefined
- * users.has("u1");   // boolean
- * users.size;        // number
+ * // ── Writes ───────────────────────────────────────────────────────────────
+ * await users.add({ name: "Alice", role: "admin" });
+ * await users.add({ id: "u1", name: "Bob", role: "user" });
+ * await users.delete("u1");
  * ```
  */
 export declare function miniDB(version?: number, onMigrate?: MiniDBMigrateFn): Promise<MiniDBInstance>;

package/dist/minidb/minidb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"minidb.d.ts","sourceRoot":"","sources":["../../lib/minidb/minidb.ts"],"names":[],"mappings":"AAgDA,MAAM,MAAM,cAAc,GAAG;IAC3B,qDAAqD;IACrD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAC5B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,cAAc,KACrB,IAAI,CAAC;AAEV;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAC1B,qEAAqE;IACrE,IAAI,CAAC,EAAE,CAAC;IACR,mCAAmC;IACnC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAC/B,sCAAsC;IACtC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,qDAAqD;IACrD,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,qEAAqE;IACrE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,6BAA6B;IAC7B,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,sCAAsC;IACtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;;OAMG;IACH,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/C,CAAC;AAwNF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAsB,MAAM,CAC1B,OAAO,SAAI,EACX,SAAS,CAAC,EAAE,eAAe,GAC1B,OAAO,CAAC,cAAc,CAAC,CAqDzB"}
+{"version":3,"file":"minidb.d.ts","sourceRoot":"","sources":["../../lib/minidb/minidb.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,cAAc,GAAG;IAC3B,qDAAqD;IACrD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAC5B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,cAAc,KACrB,IAAI,CAAC;AAEV;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,qEAAqE;IACrE,IAAI,CAAC,EAAE,CAAC;IACR,oEAAoE;IACpE,IAAI,IAAI,CAAC,EAAE,CAAC;IACZ;;;OAGG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1C;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,8BAA8B;IAC9B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;;OAMG;IACH,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CACjD,CAAC;AAyLF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAsB,MAAM,CAC1B,OAAO,SAAI,EACX,SAAS,CAAC,EAAE,eAAe,GAC1B,OAAO,CAAC,cAAc,CAAC,CA6CzB"}

package/dist/on/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../lib/on/hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../lib/on/hooks.ts"],"names":[],"mappings":"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"}

package/dist/ssr/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./ssr-bridge";
 export * from "./ssrFlag";
+export * from "./useCtx";
 //# sourceMappingURL=index.d.ts.map

package/dist/ssr/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/ssr/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/ssr/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/ssr/useCtx.d.ts

@@ -0,0 +1,63 @@
+/**
+ * mates — useCtx
+ *
+ * Retrieves the current server-side Context (Hono-style) during SSR or
+ * RPC calls. Uses the same global AsyncLocalStorage key as mates-fullstack's
+ * ssr-context.ts, so it works inside the SSR esbuild bundle as well.
+ *
+ * Returns undefined when called outside a request context (e.g. client-side).
+ *
+ * @example
+ * // In a component outer function:
+ * const ctx = useCtx();
+ * if (ctx) {
+ *   console.log("request path:", ctx.req.path);
+ * }
+ */
+/**
+ * Minimal Ctx interface matching the Hono-style Context shape.
+ * Defined locally — mates doesn't import from mates-fullstack.
+ */
+export interface Ctx {
+    req: {
+        raw: Request;
+        method: string;
+        url: string;
+        path: string;
+        param(name: string): string | undefined;
+        query(name: string): string | undefined;
+        header(name: string): string | undefined;
+        params: Record<string, string>;
+        queries: Record<string, string>;
+    };
+    isSSR: boolean;
+    auth: Record<string, unknown> | null;
+    cookie: {
+        get(name: string): string | undefined;
+        getAll(): Record<string, string>;
+        set(name: string, value: string, options?: Record<string, unknown>): void;
+        delete(name: string, options?: Record<string, unknown>): void;
+    };
+    var: Record<string, unknown>;
+    set(key: string, value: unknown): void;
+    get(key: string): unknown;
+    [key: string]: unknown;
+}
+/**
+ * Get the current server-side Context (Hono-style).
+ *
+ * Returns `undefined` when called:
+ *  - On the client (browser)
+ *  - Outside a request handler
+ *
+ * Available when called:
+ *  - During SSR page rendering
+ *  - Inside RPC functions (both SSR and HTTP paths)
+ *  - Inside onRequest/onBeforeRPC/onAfterRPC hooks
+ */
+export declare function useCtx(): Ctx | undefined;
+/**
+ * Returns true when currently executing inside an SSR render pass.
+ */
+export declare function useIsSSR(): boolean;
+//# sourceMappingURL=useCtx.d.ts.map

package/dist/ssr/useCtx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCtx.d.ts","sourceRoot":"","sources":["../../lib/ssr/useCtx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH;;;GAGG;AACH,MAAM,WAAW,GAAG;IAClB,GAAG,EAAE;QACH,GAAG,EAAE,OAAO,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QACxC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QACxC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC,CAAC;IACF,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACrC,MAAM,EAAE;QACN,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QACtC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QAC1E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KAC/D,CAAC;IACF,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAiBD;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,IAAI,GAAG,GAAG,SAAS,CAUxC;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAUlC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mates",
-  "version": "0.4.0-beta.9",
+  "version": "0.4.1",
   "type": "module",
   "description": "Mates is a front end framework for building web applications",
   "main": "dist/index.js",

package/dist/Router/pathResolver.d.ts

@@ -1,9 +0,0 @@
-export { buildPath } from "./buildPath";
-export { hashAtom } from "./hashAtom";
-export { isPathMatching } from "./isPathMatching";
-export { location } from "./location";
-export { navigateTo } from "./navigateTo";
-export { lockNavigation, navigationLocked, unlockNavigation, } from "./navigationLock";
-export { pathAtom } from "./pathAtom";
-export { qsAtom } from "./qsAtom";
-//# sourceMappingURL=pathResolver.d.ts.map

package/dist/Router/pathResolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pathResolver.d.ts","sourceRoot":"","sources":["../../lib/Router/pathResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}