@noy-db/in-nextjs 0.2.0-pre.8 → 0.3.0-pre.1

package/README.md

@@ -26,7 +26,7 @@ See the [main repository](https://github.com/vLannaAi/noy-db#readme) for setup,
 
 - Source — [`packages/in-nextjs`](https://github.com/vLannaAi/noy-db/tree/main/packages/in-nextjs)
 - Issues — [github.com/vLannaAi/noy-db/issues](https://github.com/vLannaAi/noy-db/issues)
-- Spec — [`SPEC.md`](https://github.com/vLannaAi/noy-db/blob/main/SPEC.md)
+- Spec — [`SPEC.md`](https://github.com/vLannaAi/noy-db-docs/blob/main/SPEC.md)
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noy-db/in-nextjs",
-  "version": "0.2.0-pre.8",
+  "version": "0.3.0-pre.1",
   "description": "Next.js App Router helpers for noy-db — server components, route handlers, client hooks, and cookie-based session. Thin bridge that composes @noy-db/in-react with Next's cookies()/headers() APIs.",
   "license": "MIT",
   "author": "vLannaAi <vicio@lanna.ai>",
@@ -17,27 +17,14 @@
   "sideEffects": false,
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     },
     "./client": {
-      "import": {
-        "types": "./dist/client.d.ts",
-        "default": "./dist/client.js"
-      },
-      "require": {
-        "types": "./dist/client.d.cts",
-        "default": "./dist/client.cjs"
-      }
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
     }
   },
-  "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -46,13 +33,13 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.0.0"
   },
   "peerDependencies": {
     "next": "^14.0.0 || ^15.0.0",
     "react": "^18.0.0 || ^19.0.0",
-    "@noy-db/hub": "0.2.0-pre.8",
-    "@noy-db/in-react": "0.2.0-pre.8"
+    "@noy-db/hub": "0.3.0-pre.1",
+    "@noy-db/in-react": "0.3.0-pre.1"
   },
   "peerDependenciesMeta": {
     "next": {
@@ -66,8 +53,8 @@
     }
   },
   "devDependencies": {
-    "@noy-db/hub": "0.2.0-pre.8",
-    "@noy-db/in-react": "0.2.0-pre.8"
+    "@noy-db/hub": "0.3.0-pre.1",
+    "@noy-db/in-react": "0.3.0-pre.1"
   },
   "keywords": [
     "noy-db",

package/dist/client.cjs

@@ -1,25 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/client.ts
-var client_exports = {};
-module.exports = __toCommonJS(client_exports);
-__reExport(client_exports, require("@noy-db/in-react"), module.exports);
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ...require("@noy-db/in-react")
-});
-//# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/client.ts"],"sourcesContent":["/**\n * **@noy-db/in-nextjs/client** — client-component hooks.\n *\n * Re-export of `@noy-db/in-react` so `'use client'` files don't\n * accidentally pull in `next/headers` (which only works in server\n * contexts and breaks the client bundle).\n *\n * Use inside any Next.js client component:\n *\n * ```tsx\n * 'use client'\n * import { useNoydb, useVault, useCollection } from '@noy-db/in-nextjs/client'\n * ```\n *\n * @packageDocumentation\n */\n\nexport * from '@noy-db/in-react'\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA;AAAA;AAiBA,2BAAc,6BAjBd;","names":[]}

package/dist/client.d.cts

@@ -1 +0,0 @@
-export * from '@noy-db/in-react';

package/dist/index.cjs

@@ -1,161 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  clearSession: () => clearSession,
-  configureNoydb: () => configureNoydb,
-  cookieSession: () => cookieSession,
-  getNoydb: () => getNoydb,
-  getVault: () => getVault,
-  resetNoydbConfig: () => resetNoydbConfig,
-  withNoydb: () => withNoydb,
-  withVault: () => withVault,
-  writeSession: () => writeSession
-});
-module.exports = __toCommonJS(src_exports);
-async function defaultCookies() {
-  const mod = await import("next/headers").catch(() => null);
-  if (!mod) {
-    throw new Error(
-      "[@noy-db/in-nextjs] `next/headers` is unavailable. Supply a custom `cookies` resolver in cookieSession({ cookies: () => \u2026 }) when running outside a Next.js server context."
-    );
-  }
-  return mod.cookies();
-}
-function cookieSession(options = {}) {
-  const cookieName = options.cookieName ?? "noydb_session";
-  const userCookieName = options.userCookieName ?? "noydb_user";
-  const getJar = options.cookies ?? defaultCookies;
-  const maxAgeSeconds = options.maxAgeSeconds ?? 3600;
-  return {
-    async read() {
-      const jar = await Promise.resolve(getJar());
-      const sessionCookie = jar.get(cookieName);
-      const userCookie = jar.get(userCookieName);
-      if (!sessionCookie || !userCookie) return null;
-      return { userId: userCookie.value, sessionToken: sessionCookie.value };
-    },
-    async write(value) {
-      const jar = await Promise.resolve(getJar());
-      const opts = {
-        httpOnly: true,
-        secure: true,
-        sameSite: "lax",
-        path: "/",
-        maxAge: value.maxAgeSeconds ?? maxAgeSeconds
-      };
-      jar.set(cookieName, value.sessionToken, opts);
-      jar.set(userCookieName, value.userId, opts);
-    },
-    async clear() {
-      const jar = await Promise.resolve(getJar());
-      jar.delete(cookieName);
-      jar.delete(userCookieName);
-    }
-  };
-}
-var configured = null;
-function configureNoydb(options) {
-  configured = {
-    factory: options.factory,
-    session: options.session ?? cookieSession()
-  };
-}
-function requireConfig() {
-  if (!configured) {
-    throw new Error(
-      "[@noy-db/in-nextjs] configureNoydb({ factory, session }) must be called before getNoydb()."
-    );
-  }
-  return configured;
-}
-async function getNoydb() {
-  const { factory, session } = requireConfig();
-  const current = await session.read();
-  return factory(current);
-}
-async function getVault(db, name) {
-  return db.openVault(name);
-}
-function withVault(vaultName, handler) {
-  return async (request) => {
-    const db = await getNoydb();
-    try {
-      const vault = await db.openVault(vaultName);
-      return await handler(vault, request);
-    } finally {
-      await safeClose(db);
-    }
-  };
-}
-function withNoydb(handler) {
-  return async (request) => {
-    const db = await getNoydb();
-    try {
-      return await handler(db, request);
-    } finally {
-      await safeClose(db);
-    }
-  };
-}
-async function writeSession(value) {
-  const { session } = requireConfig();
-  await session.write(value);
-}
-async function clearSession() {
-  const { session } = requireConfig();
-  await session.clear();
-}
-function resetNoydbConfig() {
-  configured = null;
-}
-async function safeClose(db) {
-  try {
-    const result = db.close();
-    if (result && typeof result.then === "function") {
-      await result;
-    }
-  } catch {
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  clearSession,
-  configureNoydb,
-  cookieSession,
-  getNoydb,
-  getVault,
-  resetNoydbConfig,
-  withNoydb,
-  withVault,
-  writeSession
-});
-//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * **@noy-db/in-nextjs** — Next.js App Router helpers for noy-db.\n *\n * Two surfaces:\n *\n *   - **Default export** (this file): **server-only** helpers that\n *     use Next's `cookies()` and `headers()` APIs. Import from\n *     `@noy-db/in-nextjs` inside server components, route handlers,\n *     and server actions.\n *\n *   - **`@noy-db/in-nextjs/client`**: re-exports of `@noy-db/in-react`\n *     hooks for client components. Import from\n *     `@noy-db/in-nextjs/client` inside any `'use client'` file.\n *\n * Keeping them in separate entry points means Next's bundler prunes\n * the server helpers out of the client bundle automatically — no\n * manual `'use server'` / `'use client'` annotations needed.\n *\n * ## Cookie-based session\n *\n * The default session store reads an opaque session token from a\n * cookie (`noydb_session` by default) and passes it to the hub. The\n * token IS NOT the vault passphrase — it's a reference token that\n * the hub resolves against its own session table. Tokens rotate on\n * every unlock and invalidate on logout.\n *\n * ```ts\n * // app/invoices/page.tsx  (server component)\n * import { getNoydb, getVault } from '@noy-db/in-nextjs'\n *\n * export default async function InvoicesPage() {\n *   const db = await getNoydb()\n *   const vault = await getVault(db, 'acme')\n *   const invoices = await vault.collection('invoices').list()\n *   return <InvoicesList items={invoices} />\n * }\n * ```\n *\n * ```ts\n * // app/api/invoices/route.ts  (route handler)\n * import { withVault } from '@noy-db/in-nextjs'\n * import { NextResponse } from 'next/server'\n *\n * export const GET = withVault('acme', async (vault) => {\n *   const invoices = await vault.collection('invoices').list()\n *   return NextResponse.json(invoices)\n * })\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { Noydb, Vault } from '@noy-db/hub'\n\n// ─── Session-store abstraction ─────────────────────────────────────────\n\n/**\n * Pluggable session resolver. Default implementation reads from Next's\n * `cookies()` API; consumers can swap in a header-based or memory-based\n * resolver for testing or custom auth.\n */\nexport interface SessionStore {\n  /** Returns the user id + session token for the current request, or null when absent. */\n  read(): Promise<{ userId: string; sessionToken: string } | null>\n  /** Write a new session token (called on unlock or rotation). */\n  write(value: { userId: string; sessionToken: string; maxAgeSeconds?: number }): Promise<void>\n  /** Clear the session (called on logout). */\n  clear(): Promise<void>\n}\n\n/**\n * Duck-typed `cookies()` return — we don't import from `next/headers`\n * directly so tests don't need Next's runtime.\n */\nexport interface NextCookieJar {\n  get(name: string): { name: string; value: string } | undefined\n  set(name: string, value: string, options?: { httpOnly?: boolean; secure?: boolean; sameSite?: 'lax' | 'strict' | 'none'; maxAge?: number; path?: string }): void\n  delete(name: string): void\n}\n\nexport interface CookieSessionOptions {\n  /** How to obtain Next's cookie jar. Default dynamically imports `next/headers`. */\n  readonly cookies?: () => Promise<NextCookieJar> | NextCookieJar\n  /** Cookie name for the session token. Default `'noydb_session'`. */\n  readonly cookieName?: string\n  /** Cookie name for the user id. Default `'noydb_user'`. */\n  readonly userCookieName?: string\n  /** Cookie maxAge in seconds. Default 1 hour. */\n  readonly maxAgeSeconds?: number\n}\n\nasync function defaultCookies(): Promise<NextCookieJar> {\n  // Dynamic import keeps `next/headers` out of non-Next environments.\n  const mod = (await import('next/headers').catch(() => null)) as\n    | { cookies: () => Promise<NextCookieJar> | NextCookieJar }\n    | null\n  if (!mod) {\n    throw new Error(\n      \"[@noy-db/in-nextjs] `next/headers` is unavailable. Supply a custom `cookies` resolver \" +\n      \"in cookieSession({ cookies: () => … }) when running outside a Next.js server context.\",\n    )\n  }\n  return mod.cookies()\n}\n\n/** Build a cookie-backed session store for Next.js server contexts. */\nexport function cookieSession(options: CookieSessionOptions = {}): SessionStore {\n  const cookieName = options.cookieName ?? 'noydb_session'\n  const userCookieName = options.userCookieName ?? 'noydb_user'\n  const getJar = options.cookies ?? defaultCookies\n  const maxAgeSeconds = options.maxAgeSeconds ?? 3600\n\n  return {\n    async read() {\n      const jar = await Promise.resolve(getJar())\n      const sessionCookie = jar.get(cookieName)\n      const userCookie = jar.get(userCookieName)\n      if (!sessionCookie || !userCookie) return null\n      return { userId: userCookie.value, sessionToken: sessionCookie.value }\n    },\n    async write(value) {\n      const jar = await Promise.resolve(getJar())\n      const opts = {\n        httpOnly: true,\n        secure: true,\n        sameSite: 'lax' as const,\n        path: '/',\n        maxAge: value.maxAgeSeconds ?? maxAgeSeconds,\n      }\n      jar.set(cookieName, value.sessionToken, opts)\n      jar.set(userCookieName, value.userId, opts)\n    },\n    async clear() {\n      const jar = await Promise.resolve(getJar())\n      jar.delete(cookieName)\n      jar.delete(userCookieName)\n    },\n  }\n}\n\n// ─── Server helpers ────────────────────────────────────────────────────\n\n/**\n * The Noydb factory contract — consumers call `setNoydbFactory()` at\n * app init with whatever store + auth wiring they prefer. The factory\n * receives the current session and returns an opened Noydb instance.\n */\nexport type NoydbFactory = (session: { userId: string; sessionToken: string } | null) => Promise<Noydb>\n\nlet configured: { factory: NoydbFactory; session: SessionStore } | null = null\n\n/**\n * Configure the Next.js integration. Call once at app init (e.g. in\n * `app/layout.tsx` or a `lib/noydb.ts` module).\n */\nexport function configureNoydb(options: { factory: NoydbFactory; session?: SessionStore }): void {\n  configured = {\n    factory: options.factory,\n    session: options.session ?? cookieSession(),\n  }\n}\n\nfunction requireConfig(): NonNullable<typeof configured> {\n  if (!configured) {\n    throw new Error(\n      \"[@noy-db/in-nextjs] configureNoydb({ factory, session }) must be called before getNoydb().\",\n    )\n  }\n  return configured\n}\n\n/**\n * Server-only helper. Reads the current session from cookies, invokes\n * the configured factory, and returns an open `Noydb` instance.\n */\nexport async function getNoydb(): Promise<Noydb> {\n  const { factory, session } = requireConfig()\n  const current = await session.read()\n  return factory(current)\n}\n\n/** Convenience: open a vault by name, returning the `Vault` directly. */\nexport async function getVault(db: Noydb, name: string): Promise<Vault> {\n  return db.openVault(name)\n}\n\n/**\n * Route-handler wrapper. Opens the vault once per request and passes\n * it to your handler. The Noydb instance is closed on exit so the\n * session keys don't outlive the response.\n */\nexport function withVault<T extends Request, R>(\n  vaultName: string,\n  handler: (vault: Vault, request: T) => Promise<R>,\n): (request: T) => Promise<R> {\n  return async (request: T) => {\n    const db = await getNoydb()\n    try {\n      const vault = await db.openVault(vaultName)\n      return await handler(vault, request)\n    } finally {\n      await safeClose(db)\n    }\n  }\n}\n\n/**\n * Route-handler wrapper that does NOT open a vault — use when the\n * handler needs direct `Noydb` access (e.g. managing multiple vaults\n * per request).\n */\nexport function withNoydb<T extends Request, R>(\n  handler: (db: Noydb, request: T) => Promise<R>,\n): (request: T) => Promise<R> {\n  return async (request: T) => {\n    const db = await getNoydb()\n    try {\n      return await handler(db, request)\n    } finally {\n      await safeClose(db)\n    }\n  }\n}\n\n/**\n * Server action helper — write a new session on login. Called from a\n * server action that validated the user's passphrase through\n * `@noy-db/on-*` and received a session token back.\n */\nexport async function writeSession(value: { userId: string; sessionToken: string; maxAgeSeconds?: number }): Promise<void> {\n  const { session } = requireConfig()\n  await session.write(value)\n}\n\n/** Server action helper — clear the session on logout. */\nexport async function clearSession(): Promise<void> {\n  const { session } = requireConfig()\n  await session.clear()\n}\n\n/** Introspection — useful for tests. Resets the configured factory. */\nexport function resetNoydbConfig(): void {\n  configured = null\n}\n\n/**\n * Defensively close a Noydb instance, tolerating sync + async close\n * signatures without tripping `await-thenable` lint.\n */\nasync function safeClose(db: Noydb): Promise<void> {\n  try {\n    const result: unknown = db.close()\n    if (result && typeof (result as { then?: unknown }).then === 'function') {\n      await (result as Promise<unknown>)\n    }\n  } catch {\n    // best-effort — never block the response on teardown\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -1,156 +0,0 @@
-import { Noydb, Vault } from '@noy-db/hub';
-
-/**
- * **@noy-db/in-nextjs** — Next.js App Router helpers for noy-db.
- *
- * Two surfaces:
- *
- *   - **Default export** (this file): **server-only** helpers that
- *     use Next's `cookies()` and `headers()` APIs. Import from
- *     `@noy-db/in-nextjs` inside server components, route handlers,
- *     and server actions.
- *
- *   - **`@noy-db/in-nextjs/client`**: re-exports of `@noy-db/in-react`
- *     hooks for client components. Import from
- *     `@noy-db/in-nextjs/client` inside any `'use client'` file.
- *
- * Keeping them in separate entry points means Next's bundler prunes
- * the server helpers out of the client bundle automatically — no
- * manual `'use server'` / `'use client'` annotations needed.
- *
- * ## Cookie-based session
- *
- * The default session store reads an opaque session token from a
- * cookie (`noydb_session` by default) and passes it to the hub. The
- * token IS NOT the vault passphrase — it's a reference token that
- * the hub resolves against its own session table. Tokens rotate on
- * every unlock and invalidate on logout.
- *
- * ```ts
- * // app/invoices/page.tsx  (server component)
- * import { getNoydb, getVault } from '@noy-db/in-nextjs'
- *
- * export default async function InvoicesPage() {
- *   const db = await getNoydb()
- *   const vault = await getVault(db, 'acme')
- *   const invoices = await vault.collection('invoices').list()
- *   return <InvoicesList items={invoices} />
- * }
- * ```
- *
- * ```ts
- * // app/api/invoices/route.ts  (route handler)
- * import { withVault } from '@noy-db/in-nextjs'
- * import { NextResponse } from 'next/server'
- *
- * export const GET = withVault('acme', async (vault) => {
- *   const invoices = await vault.collection('invoices').list()
- *   return NextResponse.json(invoices)
- * })
- * ```
- *
- * @packageDocumentation
- */
-
-/**
- * Pluggable session resolver. Default implementation reads from Next's
- * `cookies()` API; consumers can swap in a header-based or memory-based
- * resolver for testing or custom auth.
- */
-interface SessionStore {
-    /** Returns the user id + session token for the current request, or null when absent. */
-    read(): Promise<{
-        userId: string;
-        sessionToken: string;
-    } | null>;
-    /** Write a new session token (called on unlock or rotation). */
-    write(value: {
-        userId: string;
-        sessionToken: string;
-        maxAgeSeconds?: number;
-    }): Promise<void>;
-    /** Clear the session (called on logout). */
-    clear(): Promise<void>;
-}
-/**
- * Duck-typed `cookies()` return — we don't import from `next/headers`
- * directly so tests don't need Next's runtime.
- */
-interface NextCookieJar {
-    get(name: string): {
-        name: string;
-        value: string;
-    } | undefined;
-    set(name: string, value: string, options?: {
-        httpOnly?: boolean;
-        secure?: boolean;
-        sameSite?: 'lax' | 'strict' | 'none';
-        maxAge?: number;
-        path?: string;
-    }): void;
-    delete(name: string): void;
-}
-interface CookieSessionOptions {
-    /** How to obtain Next's cookie jar. Default dynamically imports `next/headers`. */
-    readonly cookies?: () => Promise<NextCookieJar> | NextCookieJar;
-    /** Cookie name for the session token. Default `'noydb_session'`. */
-    readonly cookieName?: string;
-    /** Cookie name for the user id. Default `'noydb_user'`. */
-    readonly userCookieName?: string;
-    /** Cookie maxAge in seconds. Default 1 hour. */
-    readonly maxAgeSeconds?: number;
-}
-/** Build a cookie-backed session store for Next.js server contexts. */
-declare function cookieSession(options?: CookieSessionOptions): SessionStore;
-/**
- * The Noydb factory contract — consumers call `setNoydbFactory()` at
- * app init with whatever store + auth wiring they prefer. The factory
- * receives the current session and returns an opened Noydb instance.
- */
-type NoydbFactory = (session: {
-    userId: string;
-    sessionToken: string;
-} | null) => Promise<Noydb>;
-/**
- * Configure the Next.js integration. Call once at app init (e.g. in
- * `app/layout.tsx` or a `lib/noydb.ts` module).
- */
-declare function configureNoydb(options: {
-    factory: NoydbFactory;
-    session?: SessionStore;
-}): void;
-/**
- * Server-only helper. Reads the current session from cookies, invokes
- * the configured factory, and returns an open `Noydb` instance.
- */
-declare function getNoydb(): Promise<Noydb>;
-/** Convenience: open a vault by name, returning the `Vault` directly. */
-declare function getVault(db: Noydb, name: string): Promise<Vault>;
-/**
- * Route-handler wrapper. Opens the vault once per request and passes
- * it to your handler. The Noydb instance is closed on exit so the
- * session keys don't outlive the response.
- */
-declare function withVault<T extends Request, R>(vaultName: string, handler: (vault: Vault, request: T) => Promise<R>): (request: T) => Promise<R>;
-/**
- * Route-handler wrapper that does NOT open a vault — use when the
- * handler needs direct `Noydb` access (e.g. managing multiple vaults
- * per request).
- */
-declare function withNoydb<T extends Request, R>(handler: (db: Noydb, request: T) => Promise<R>): (request: T) => Promise<R>;
-/**
- * Server action helper — write a new session on login. Called from a
- * server action that validated the user's passphrase through
- * `@noy-db/on-*` and received a session token back.
- */
-declare function writeSession(value: {
-    userId: string;
-    sessionToken: string;
-    maxAgeSeconds?: number;
-}): Promise<void>;
-/** Server action helper — clear the session on logout. */
-declare function clearSession(): Promise<void>;
-/** Introspection — useful for tests. Resets the configured factory. */
-declare function resetNoydbConfig(): void;
-
-export { type CookieSessionOptions, type NextCookieJar, type NoydbFactory, type SessionStore, clearSession, configureNoydb, cookieSession, getNoydb, getVault, resetNoydbConfig, withNoydb, withVault, writeSession };