@mszr/idb-dux 1.0.0

package/dist/commonjs/vue/baseline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/vue/baseline/index.ts"],"names":[],"mappings":";;;AAAA,8EAA8E;AAC9E,2DAA2D;AAC3D,gDAA0D;AAAjD,mGAAA,QAAQ,OAAA;AAAE,oGAAA,SAAS,OAAA;AAC5B,oDAA+C;AAAtC,mGAAA,MAAM,OAAA;AACf,sDAAiD;AAAxC,qGAAA,OAAO,OAAA;AAChB,iEAAkE;AAAzD,6GAAA,IAAI,OAAA;AAAE,2HAAA,kBAAkB,OAAA;AAEjC,yDAQ4B;AAP1B,mHAAA,cAAc,OAAA;AACd,0GAAA,KAAK,OAAA;AACL,gHAAA,WAAW,OAAA;AACX,oHAAA,eAAe,OAAA;AACf,oHAAA,eAAe,OAAA;AACf,mHAAA,cAAc,OAAA;AACd,uHAAA,kBAAkB,OAAA;AAOpB,6DAAwD;AAA/C,uHAAA,gBAAgB,OAAA;AAEzB,uCAAwD;AAA/C,oGAAA,QAAQ,OAAA;AAAE,6GAAA,iBAAiB,OAAA","sourcesContent":["// The internal baseline surface — consumed only by the overlay and the parity\n// harness, never re-exported from `/vue`. See UPSTREAM.md.\nexport { SignedIn, SignedOut } from './components/auth.js'\nexport { Cursor } from './components/Cursor.js'\nexport { Cursors } from './components/Cursors.js'\nexport { init, InstantDuxDatabase } from './InstantDuxDatabase.js'\nexport type { UseAuthReturn, UseQueryReturn } from './InstantDuxDatabase.js'\nexport {\n  InstantDuxRoom,\n  rooms,\n  usePresence,\n  usePublishTopic,\n  useSyncPresence,\n  useTopicEffect,\n  useTypingIndicator,\n} from './InstantDuxRoom.js'\nexport type {\n  PresenceHandle,\n  TypingIndicatorHandle,\n  TypingIndicatorOpts,\n} from './InstantDuxRoom.js'\nexport { useInfiniteQuery } from './useInfiniteQuery.js'\nexport type { InfiniteQueryResult } from './useInfiniteQuery.js'\nexport { isClient, tryOnScopeDispose } from './utils.js'\n"]}

package/dist/commonjs/vue/baseline/useInfiniteQuery.d.ts

@@ -0,0 +1,19 @@
+import type { InstantCoreDatabase, InstantSchemaDef, InstaQLOptions, InstaQLResponse, ValidQuery } from '@instantdb/core';
+import type { MaybeRefOrGetter, Ref, ShallowRef } from 'vue';
+export interface InfiniteQueryResult<Schema extends InstantSchemaDef<any, any, any>, Q extends ValidQuery<Q, Schema>, UseDates extends boolean> {
+    isLoading: Ref<boolean>;
+    data: ShallowRef<InstaQLResponse<Schema, Q, UseDates> | undefined>;
+    error: ShallowRef<{
+        message: string;
+    } | undefined>;
+    canLoadNextPage: Ref<boolean>;
+    loadNextPage: () => void;
+}
+/**
+ * Subscribe to a query and incrementally load more items.
+ *
+ * Only one top-level namespace in the query is allowed. Changing the query or
+ * options while the subscription is active resets and starts over.
+ */
+export declare function useInfiniteQuery<Schema extends InstantSchemaDef<any, any, any>, Q extends ValidQuery<Q, Schema>, UseDates extends boolean>(core: InstantCoreDatabase<Schema, UseDates>, query: MaybeRefOrGetter<Q | null>, opts?: MaybeRefOrGetter<InstaQLOptions | undefined>): InfiniteQueryResult<Schema, Q, UseDates>;
+//# sourceMappingURL=useInfiniteQuery.d.ts.map

package/dist/commonjs/vue/baseline/useInfiniteQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInfiniteQuery.d.ts","sourceRoot":"","sources":["../../../../src/vue/baseline/useInfiniteQuery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA6B,mBAAmB,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACpJ,OAAO,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AAY5D,MAAM,WAAW,mBAAmB,CAClC,MAAM,SAAS,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC9C,CAAC,SAAS,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,EAC/B,QAAQ,SAAS,OAAO;IAExB,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACvB,IAAI,EAAE,UAAU,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC,CAAA;IAClE,KAAK,EAAE,UAAU,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAA;IAClD,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IAC7B,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,SAAS,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAC9C,CAAC,SAAS,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,EAC/B,QAAQ,SAAS,OAAO,EAExB,IAAI,EAAE,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC3C,KAAK,EAAE,gBAAgB,CAAC,CAAC,GAAG,IAAI,CAAC,EACjC,IAAI,CAAC,EAAE,gBAAgB,CAAC,cAAc,GAAG,SAAS,CAAC,GAClD,mBAAmB,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,CAAC,CAsE1C"}

package/dist/commonjs/vue/baseline/useInfiniteQuery.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useInfiniteQuery = useInfiniteQuery;
+// Vendored from @instantdb/vue/src/useInfiniteQuery.ts — see UPSTREAM.md.
+// Delta: the SSR floor guard around the subscription.
+const core_1 = require("@instantdb/core");
+const vue_1 = require("vue");
+const utils_js_1 = require("./utils.js");
+/**
+ * Subscribe to a query and incrementally load more items.
+ *
+ * Only one top-level namespace in the query is allowed. Changing the query or
+ * options while the subscription is active resets and starts over.
+ */
+function useInfiniteQuery(core, query, opts) {
+    const initialQuery = (0, vue_1.toValue)(query);
+    // DUX-DELTA(ssr): no initial snapshot read on the server.
+    const snapshot = initialQuery && (0, utils_js_1.isClient)()
+        ? (0, core_1.getInfiniteQueryInitialSnapshot)(core, initialQuery, (0, vue_1.toValue)(opts))
+        : { data: undefined, error: undefined, canLoadNextPage: false };
+    // END DUX-DELTA
+    const isLoading = (0, vue_1.ref)(!snapshot.data && !snapshot.error);
+    const data = (0, vue_1.shallowRef)(snapshot.data);
+    const error = (0, vue_1.shallowRef)(snapshot.error);
+    const canLoadNextPage = (0, vue_1.ref)(snapshot.canLoadNextPage);
+    let subRef = null;
+    const stop = (0, vue_1.watch)([() => (0, core_1.weakHash)((0, vue_1.toValue)(query)), () => (0, core_1.weakHash)((0, vue_1.toValue)(opts))], (_, __, onCleanup) => {
+        subRef = null;
+        error.value = undefined;
+        data.value = undefined;
+        isLoading.value = true;
+        canLoadNextPage.value = false;
+        const q = (0, vue_1.toValue)(query);
+        if (!q)
+            return;
+        // DUX-DELTA(ssr): no subscription on the server.
+        if (!(0, utils_js_1.isClient)())
+            return;
+        // END DUX-DELTA
+        const sub = core.subscribeInfiniteQuery(q, (resp) => {
+            error.value = resp.error;
+            data.value = resp.data;
+            isLoading.value = false;
+            canLoadNextPage.value = resp.canLoadNextPage;
+        }, (0, vue_1.toValue)(opts));
+        subRef = sub;
+        onCleanup(() => {
+            sub.unsubscribe();
+            if (subRef === sub)
+                subRef = null;
+        });
+    }, { immediate: true });
+    const loadNextPage = () => {
+        subRef?.loadNextPage();
+    };
+    (0, utils_js_1.tryOnScopeDispose)(stop);
+    return {
+        isLoading,
+        data,
+        error,
+        canLoadNextPage,
+        loadNextPage,
+    };
+}
+//# sourceMappingURL=useInfiniteQuery.js.map

package/dist/commonjs/vue/baseline/useInfiniteQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInfiniteQuery.js","sourceRoot":"","sources":["../../../../src/vue/baseline/useInfiniteQuery.ts"],"names":[],"mappings":";;AA+BA,4CA8EC;AA3GD,0EAA0E;AAC1E,sDAAsD;AACtD,0CAIwB;AACxB,6BAAqD;AAErD,yCAAwD;AAcxD;;;;;GAKG;AACH,SAAgB,gBAAgB,CAK9B,IAA2C,EAC3C,KAAiC,EACjC,IAAmD;IAEnD,MAAM,YAAY,GAAG,IAAA,aAAO,EAAC,KAAK,CAAC,CAAA;IACnC,0DAA0D;IAC1D,MAAM,QAAQ,GAAG,YAAY,IAAI,IAAA,mBAAQ,GAAE;QACzC,CAAC,CAAC,IAAA,sCAA+B,EAAC,IAAI,EAAE,YAAY,EAAE,IAAA,aAAO,EAAC,IAAI,CAAC,CAAC;QACpE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,KAAK,EAAE,CAAA;IACjE,gBAAgB;IAEhB,MAAM,SAAS,GAAG,IAAA,SAAG,EAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IACxD,MAAM,IAAI,GAAG,IAAA,gBAAU,EACrB,QAAQ,CAAC,IAAW,CACrB,CAAA;IACD,MAAM,KAAK,GAAG,IAAA,gBAAU,EAAkC,QAAQ,CAAC,KAAK,CAAC,CAAA;IACzE,MAAM,eAAe,GAAG,IAAA,SAAG,EAAC,QAAQ,CAAC,eAAe,CAAC,CAAA;IAErD,IAAI,MAAM,GAAqC,IAAI,CAAA;IAEnD,MAAM,IAAI,GAAG,IAAA,WAAK,EAChB,CAAC,GAAG,EAAE,CAAC,IAAA,eAAQ,EAAC,IAAA,aAAO,EAAC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,IAAA,eAAQ,EAAC,IAAA,aAAO,EAAC,IAAI,CAAC,CAAC,CAAC,EAC/D,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE;QACnB,MAAM,GAAG,IAAI,CAAA;QACb,KAAK,CAAC,KAAK,GAAG,SAAS,CAAA;QACvB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAA;QACtB,SAAS,CAAC,KAAK,GAAG,IAAI,CAAA;QACtB,eAAe,CAAC,KAAK,GAAG,KAAK,CAAA;QAE7B,MAAM,CAAC,GAAG,IAAA,aAAO,EAAC,KAAK,CAAC,CAAA;QACxB,IAAI,CAAC,CAAC;YACJ,OAAM;QAER,iDAAiD;QACjD,IAAI,CAAC,IAAA,mBAAQ,GAAE;YACb,OAAM;QACR,gBAAgB;QAEhB,MAAM,GAAG,GAAG,IAAI,CAAC,sBAAsB,CACrC,CAAC,EACD,CAAC,IAAS,EAAE,EAAE;YACZ,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;YACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAA;YACtB,SAAS,CAAC,KAAK,GAAG,KAAK,CAAA;YACvB,eAAe,CAAC,KAAK,GAAG,IAAI,CAAC,eAAe,CAAA;QAC9C,CAAC,EACD,IAAA,aAAO,EAAC,IAAI,CAAC,CACd,CAAA;QAED,MAAM,GAAG,GAAG,CAAA;QAEZ,SAAS,CAAC,GAAG,EAAE;YACb,GAAG,CAAC,WAAW,EAAE,CAAA;YACjB,IAAI,MAAM,KAAK,GAAG;gBAChB,MAAM,GAAG,IAAI,CAAA;QACjB,CAAC,CAAC,CAAA;IACJ,CAAC,EACD,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CAAA;IAED,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,MAAM,EAAE,YAAY,EAAE,CAAA;IACxB,CAAC,CAAA;IAED,IAAA,4BAAiB,EAAC,IAAI,CAAC,CAAA;IAEvB,OAAO;QACL,SAAS;QACT,IAAI;QACJ,KAAK;QACL,eAAe;QACf,YAAY;KAC+B,CAAA;AAC/C,CAAC","sourcesContent":["import type { InfiniteQuerySubscription, InstantCoreDatabase, InstantSchemaDef, InstaQLOptions, InstaQLResponse, ValidQuery } from '@instantdb/core'\nimport type { MaybeRefOrGetter, Ref, ShallowRef } from 'vue'\n// Vendored from @instantdb/vue/src/useInfiniteQuery.ts — see UPSTREAM.md.\n// Delta: the SSR floor guard around the subscription.\nimport {\n  getInfiniteQueryInitialSnapshot,\n\n  weakHash,\n} from '@instantdb/core'\nimport { ref, shallowRef, toValue, watch } from 'vue'\n\nimport { isClient, tryOnScopeDispose } from './utils.js'\n\nexport interface InfiniteQueryResult<\n  Schema extends InstantSchemaDef<any, any, any>,\n  Q extends ValidQuery<Q, Schema>,\n  UseDates extends boolean,\n> {\n  isLoading: Ref<boolean>\n  data: ShallowRef<InstaQLResponse<Schema, Q, UseDates> | undefined>\n  error: ShallowRef<{ message: string } | undefined>\n  canLoadNextPage: Ref<boolean>\n  loadNextPage: () => void\n}\n\n/**\n * Subscribe to a query and incrementally load more items.\n *\n * Only one top-level namespace in the query is allowed. Changing the query or\n * options while the subscription is active resets and starts over.\n */\nexport function useInfiniteQuery<\n  Schema extends InstantSchemaDef<any, any, any>,\n  Q extends ValidQuery<Q, Schema>,\n  UseDates extends boolean,\n>(\n  core: InstantCoreDatabase<Schema, UseDates>,\n  query: MaybeRefOrGetter<Q | null>,\n  opts?: MaybeRefOrGetter<InstaQLOptions | undefined>,\n): InfiniteQueryResult<Schema, Q, UseDates> {\n  const initialQuery = toValue(query)\n  // DUX-DELTA(ssr): no initial snapshot read on the server.\n  const snapshot = initialQuery && isClient()\n    ? getInfiniteQueryInitialSnapshot(core, initialQuery, toValue(opts))\n    : { data: undefined, error: undefined, canLoadNextPage: false }\n  // END DUX-DELTA\n\n  const isLoading = ref(!snapshot.data && !snapshot.error)\n  const data = shallowRef<InstaQLResponse<Schema, Q, UseDates> | undefined>(\n    snapshot.data as any,\n  )\n  const error = shallowRef<{ message: string } | undefined>(snapshot.error)\n  const canLoadNextPage = ref(snapshot.canLoadNextPage)\n\n  let subRef: InfiniteQuerySubscription | null = null\n\n  const stop = watch(\n    [() => weakHash(toValue(query)), () => weakHash(toValue(opts))],\n    (_, __, onCleanup) => {\n      subRef = null\n      error.value = undefined\n      data.value = undefined\n      isLoading.value = true\n      canLoadNextPage.value = false\n\n      const q = toValue(query)\n      if (!q)\n        return\n\n      // DUX-DELTA(ssr): no subscription on the server.\n      if (!isClient())\n        return\n      // END DUX-DELTA\n\n      const sub = core.subscribeInfiniteQuery(\n        q,\n        (resp: any) => {\n          error.value = resp.error\n          data.value = resp.data\n          isLoading.value = false\n          canLoadNextPage.value = resp.canLoadNextPage\n        },\n        toValue(opts),\n      )\n\n      subRef = sub\n\n      onCleanup(() => {\n        sub.unsubscribe()\n        if (subRef === sub)\n          subRef = null\n      })\n    },\n    { immediate: true },\n  )\n\n  const loadNextPage = () => {\n    subRef?.loadNextPage()\n  }\n\n  tryOnScopeDispose(stop)\n\n  return {\n    isLoading,\n    data,\n    error,\n    canLoadNextPage,\n    loadNextPage,\n  } as InfiniteQueryResult<Schema, Q, UseDates>\n}\n"]}

package/dist/commonjs/vue/baseline/utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Run `fn` when the current effect scope is disposed. Returns true if a scope
+ * was active (and the callback was registered), false otherwise. Lets hooks
+ * work both inside component setup and inside a manual `effectScope()` without
+ * blowing up when called outside any scope.
+ */
+export declare function tryOnScopeDispose(fn: () => void): boolean;
+export declare function isClient(): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/commonjs/vue/baseline/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/vue/baseline/utils.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAMzD;AAOD,wBAAgB,QAAQ,IAAI,OAAO,CAElC"}

package/dist/commonjs/vue/baseline/utils.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tryOnScopeDispose = tryOnScopeDispose;
+exports.isClient = isClient;
+// Vendored from @instantdb/vue/src/utils.ts — see UPSTREAM.md.
+const vue_1 = require("vue");
+/**
+ * Run `fn` when the current effect scope is disposed. Returns true if a scope
+ * was active (and the callback was registered), false otherwise. Lets hooks
+ * work both inside component setup and inside a manual `effectScope()` without
+ * blowing up when called outside any scope.
+ */
+function tryOnScopeDispose(fn) {
+    if ((0, vue_1.getCurrentScope)()) {
+        (0, vue_1.onScopeDispose)(fn);
+        return true;
+    }
+    return false;
+}
+// DUX-DELTA(ssr): the SSR-resilience floor (vision principle 6). Hooks must
+// not crash on the server and must not open subscriptions there; this is the
+// one predicate every reactive baseline hook guards on. No official
+// counterpart — it is dux's addition, isolated here so the drift check never
+// flags it as upstream divergence.
+function isClient() {
+    return typeof window !== 'undefined';
+}
+// END DUX-DELTA
+//# sourceMappingURL=utils.js.map

package/dist/commonjs/vue/baseline/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/vue/baseline/utils.ts"],"names":[],"mappings":";;AASA,8CAMC;AAOD,4BAEC;AAxBD,+DAA+D;AAC/D,6BAAqD;AAErD;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,EAAc;IAC9C,IAAI,IAAA,qBAAe,GAAE,EAAE,CAAC;QACtB,IAAA,oBAAc,EAAC,EAAE,CAAC,CAAA;QAClB,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,4EAA4E;AAC5E,6EAA6E;AAC7E,oEAAoE;AACpE,6EAA6E;AAC7E,mCAAmC;AACnC,SAAgB,QAAQ;IACtB,OAAO,OAAO,MAAM,KAAK,WAAW,CAAA;AACtC,CAAC;AACD,gBAAgB","sourcesContent":["// Vendored from @instantdb/vue/src/utils.ts — see UPSTREAM.md.\nimport { getCurrentScope, onScopeDispose } from 'vue'\n\n/**\n * Run `fn` when the current effect scope is disposed. Returns true if a scope\n * was active (and the callback was registered), false otherwise. Lets hooks\n * work both inside component setup and inside a manual `effectScope()` without\n * blowing up when called outside any scope.\n */\nexport function tryOnScopeDispose(fn: () => void): boolean {\n  if (getCurrentScope()) {\n    onScopeDispose(fn)\n    return true\n  }\n  return false\n}\n\n// DUX-DELTA(ssr): the SSR-resilience floor (vision principle 6). Hooks must\n// not crash on the server and must not open subscriptions there; this is the\n// one predicate every reactive baseline hook guards on. No official\n// counterpart — it is dux's addition, isolated here so the drift check never\n// flags it as upstream divergence.\nexport function isClient(): boolean {\n  return typeof window !== 'undefined'\n}\n// END DUX-DELTA\n"]}

package/dist/commonjs/vue/baseline/version.d.ts

@@ -0,0 +1,3 @@
+import { version } from '@instantdb/version';
+export default version;
+//# sourceMappingURL=version.d.ts.map

package/dist/commonjs/vue/baseline/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../../src/vue/baseline/version.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAE5C,eAAe,OAAO,CAAA"}

package/dist/commonjs/vue/baseline/version.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Vendored from @instantdb/vue/src/version.ts — see UPSTREAM.md.
+const version_1 = require("@instantdb/version");
+exports.default = version_1.version;
+//# sourceMappingURL=version.js.map

package/dist/commonjs/vue/baseline/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../../src/vue/baseline/version.ts"],"names":[],"mappings":";;AAAA,iEAAiE;AACjE,gDAA4C;AAE5C,kBAAe,iBAAO,CAAA","sourcesContent":["// Vendored from @instantdb/vue/src/version.ts — see UPSTREAM.md.\nimport { version } from '@instantdb/version'\n\nexport default version\n"]}

package/dist/commonjs/vue/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `@mszr/idb-dux/vue` — the Vue client.
+ *
+ * `init`, `defineDb`, the enhanced db (hooks, rooms, typed tx, pass-throughs),
+ * and the `SignedIn`/`SignedOut`/`Cursors` components. SSR-resilient by
+ * default; a thin overlay over the internal baseline.
+ *
+ * Spec: `../../../docs/dux-spec-vue.md`.
+ */
+export { IdbApiError, IdbError } from '../errors.js';
+export type { IdbIssue } from '../errors.js';
+export type { IdbRoomName, IdbRoomPresence, IdbRooms, IdbRoomTopics, } from '../schema/index.js';
+export { id, lookup } from '../tx/index.js';
+export { Cursors, SignedIn, SignedOut } from './baseline/index.js';
+export type { IdbClient } from './overlay/db.js';
+export { defineDb, init } from './overlay/defineDb.js';
+export type { IdbDefineDbOptions } from './overlay/defineDb.js';
+export { makeResult } from './overlay/result.js';
+export type { IdbResult } from './overlay/result.js';
+export type { IdbAuthResult, IdbAuthResultRefs, IdbAuthResultState, IdbAuthUser, IdbClientConfig, IdbConnectionResult, IdbConnectionStatus, IdbInfiniteQueryResult, IdbLocalIdResult, IdbQueryResult, IdbQueryResultData, IdbQueryResultRefs, IdbQueryResultState, IdbUserOptions, } from './overlay/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/commonjs/vue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/vue/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACpD,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAE5C,YAAY,EACV,WAAW,EACX,eAAe,EACf,QAAQ,EACR,aAAa,GACd,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAE3C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAElE,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAA;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,GACf,MAAM,oBAAoB,CAAA"}

package/dist/commonjs/vue/index.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * `@mszr/idb-dux/vue` — the Vue client.
+ *
+ * `init`, `defineDb`, the enhanced db (hooks, rooms, typed tx, pass-throughs),
+ * and the `SignedIn`/`SignedOut`/`Cursors` components. SSR-resilient by
+ * default; a thin overlay over the internal baseline.
+ *
+ * Spec: `../../../docs/dux-spec-vue.md`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeResult = exports.init = exports.defineDb = exports.SignedOut = exports.SignedIn = exports.Cursors = exports.lookup = exports.id = exports.IdbError = exports.IdbApiError = void 0;
+// The branded error family ([§7.4]) — `e instanceof IdbError`.
+var errors_js_1 = require("../errors.js");
+Object.defineProperty(exports, "IdbApiError", { enumerable: true, get: function () { return errors_js_1.IdbApiError; } });
+Object.defineProperty(exports, "IdbError", { enumerable: true, get: function () { return errors_js_1.IdbError; } });
+// Re-exports — official names kept at the boundary.
+var index_js_1 = require("../tx/index.js");
+Object.defineProperty(exports, "id", { enumerable: true, get: function () { return index_js_1.id; } });
+Object.defineProperty(exports, "lookup", { enumerable: true, get: function () { return index_js_1.lookup; } });
+// Components — official names kept ([§7.3]). Shipped as `.ts` render functions.
+var index_js_2 = require("./baseline/index.js");
+Object.defineProperty(exports, "Cursors", { enumerable: true, get: function () { return index_js_2.Cursors; } });
+Object.defineProperty(exports, "SignedIn", { enumerable: true, get: function () { return index_js_2.SignedIn; } });
+Object.defineProperty(exports, "SignedOut", { enumerable: true, get: function () { return index_js_2.SignedOut; } });
+var defineDb_js_1 = require("./overlay/defineDb.js");
+Object.defineProperty(exports, "defineDb", { enumerable: true, get: function () { return defineDb_js_1.defineDb; } });
+Object.defineProperty(exports, "init", { enumerable: true, get: function () { return defineDb_js_1.init; } });
+var result_js_1 = require("./overlay/result.js");
+Object.defineProperty(exports, "makeResult", { enumerable: true, get: function () { return result_js_1.makeResult; } });
+//# sourceMappingURL=index.js.map

package/dist/commonjs/vue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/vue/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,+DAA+D;AAC/D,0CAAoD;AAA3C,wGAAA,WAAW,OAAA;AAAE,qGAAA,QAAQ,OAAA;AAS9B,oDAAoD;AACpD,2CAA2C;AAAlC,8FAAA,EAAE,OAAA;AAAE,kGAAA,MAAM,OAAA;AACnB,gFAAgF;AAChF,gDAAkE;AAAzD,mGAAA,OAAO,OAAA;AAAE,oGAAA,QAAQ,OAAA;AAAE,qGAAA,SAAS,OAAA;AAGrC,qDAAsD;AAA7C,uGAAA,QAAQ,OAAA;AAAE,mGAAA,IAAI,OAAA;AAEvB,iDAAgD;AAAvC,uGAAA,UAAU,OAAA","sourcesContent":["/**\n * `@mszr/idb-dux/vue` — the Vue client.\n *\n * `init`, `defineDb`, the enhanced db (hooks, rooms, typed tx, pass-throughs),\n * and the `SignedIn`/`SignedOut`/`Cursors` components. SSR-resilient by\n * default; a thin overlay over the internal baseline.\n *\n * Spec: `../../../docs/dux-spec-vue.md`.\n */\n\n// The branded error family ([§7.4]) — `e instanceof IdbError`.\nexport { IdbApiError, IdbError } from '../errors.js'\nexport type { IdbIssue } from '../errors.js'\n// Schema-rooted room type extractors ([§6]) — room shapes read off your schema.\nexport type {\n  IdbRoomName,\n  IdbRoomPresence,\n  IdbRooms,\n  IdbRoomTopics,\n} from '../schema/index.js'\n// Re-exports — official names kept at the boundary.\nexport { id, lookup } from '../tx/index.js'\n// Components — official names kept ([§7.3]). Shipped as `.ts` render functions.\nexport { Cursors, SignedIn, SignedOut } from './baseline/index.js'\n// The enhanced db type; the value comes from init/defineDb.\nexport type { IdbClient } from './overlay/db.js'\nexport { defineDb, init } from './overlay/defineDb.js'\nexport type { IdbDefineDbOptions } from './overlay/defineDb.js'\nexport { makeResult } from './overlay/result.js'\nexport type { IdbResult } from './overlay/result.js'\nexport type {\n  IdbAuthResult,\n  IdbAuthResultRefs,\n  IdbAuthResultState,\n  IdbAuthUser,\n  IdbClientConfig,\n  IdbConnectionResult,\n  IdbConnectionStatus,\n  IdbInfiniteQueryResult,\n  IdbLocalIdResult,\n  IdbQueryResult,\n  IdbQueryResultData,\n  IdbQueryResultRefs,\n  IdbQueryResultState,\n  IdbUserOptions,\n} from './overlay/types.js'\n"]}

package/dist/commonjs/vue/overlay/db.d.ts

@@ -0,0 +1,106 @@
+import type { ComputedRef, MaybeRefOrGetter } from 'vue';
+import type { IdbQueryData, IdbQueryOptions, IdbValidQuery } from '../../query/index.js';
+import type { IdbSchema } from '../../schema/defineSchema.js';
+import type { IdbRegisteredSchema } from '../../schema/register.js';
+import type { IdbTx, IdbTxChunkInput } from '../../tx/index.js';
+import type { InstantDuxDatabase } from '../baseline/index.js';
+import type { IdbAuthResult, IdbAuthUser, IdbConnectionResult, IdbInfiniteQueryResult, IdbLocalIdResult, IdbQueryResult, IdbUserOptions } from './types.js';
+/** A query input: a query, a ref/getter of one, or a factory returning null to pause. */
+type QueryInput<Q> = MaybeRefOrGetter<Q | null>;
+export declare class IdbClient<S extends IdbSchema = IdbRegisteredSchema> {
+    #private;
+    /** The schema-typed tx chain — shared machinery with `/admin` ([root §5]). */
+    readonly tx: IdbTx<S>;
+    /** Rooms hooks — stateful ones return the result pattern ([§6]). */
+    readonly rooms: {
+        useTopicEffect: typeof import("../baseline/InstantDuxRoom.js").useTopicEffect;
+        usePublishTopic: typeof import("../baseline/InstantDuxRoom.js").usePublishTopic;
+        usePresence: <RoomSchema extends import("@instantdb/core").RoomSchemaShape, RoomType extends keyof RoomSchema, Keys extends keyof RoomSchema[RoomType]["presence"]>(room: import("../baseline/InstantDuxRoom.js").InstantDuxRoom<any, RoomSchema, RoomType>, opts?: import("@instantdb/core").PresenceOpts<RoomSchema[RoomType]["presence"], Keys>) => {
+            peers: import("vue").ShallowRef<{
+                [peerId: string]: Pick<RoomSchema[RoomType]["presence"], Keys> & {
+                    peerId: string;
+                };
+            }>;
+            isLoading: import("vue").ShallowRef<boolean>;
+            user: import("vue").ShallowRef<(Pick<RoomSchema[RoomType]["presence"], Keys> & {
+                peerId: string;
+            }) | undefined>;
+            error: import("vue").ShallowRef<string | undefined>;
+        } & {
+            refs: {
+                peers: import("vue").ShallowRef<{
+                    [peerId: string]: Pick<RoomSchema[RoomType]["presence"], Keys> & {
+                        peerId: string;
+                    };
+                }>;
+                isLoading: import("vue").ShallowRef<boolean>;
+                user: import("vue").ShallowRef<(Pick<RoomSchema[RoomType]["presence"], Keys> & {
+                    peerId: string;
+                }) | undefined>;
+                error: import("vue").ShallowRef<string | undefined>;
+            };
+            state: import("./result.js").StateOf<{
+                peers: import("vue").ShallowRef<{
+                    [peerId: string]: Pick<RoomSchema[RoomType]["presence"], Keys> & {
+                        peerId: string;
+                    };
+                }>;
+                isLoading: import("vue").ShallowRef<boolean>;
+                user: import("vue").ShallowRef<(Pick<RoomSchema[RoomType]["presence"], Keys> & {
+                    peerId: string;
+                }) | undefined>;
+                error: import("vue").ShallowRef<string | undefined>;
+            }>;
+        } & {
+            publishPresence: (data: Partial<RoomSchema[RoomType]["presence"]>) => void;
+        };
+        useSyncPresence: typeof import("../baseline/InstantDuxRoom.js").useSyncPresence;
+        useTypingIndicator: <RoomSchema extends import("@instantdb/core").RoomSchemaShape, RoomType extends keyof RoomSchema>(room: import("../baseline/InstantDuxRoom.js").InstantDuxRoom<any, RoomSchema, RoomType>, inputName: string, opts?: import("../baseline/InstantDuxRoom.js").TypingIndicatorOpts) => {
+            active: import("vue").Ref<RoomSchema[RoomType]["presence"][], RoomSchema[RoomType]["presence"][]>;
+        } & {
+            refs: {
+                active: import("vue").Ref<RoomSchema[RoomType]["presence"][], RoomSchema[RoomType]["presence"][]>;
+            };
+            state: import("./result.js").StateOf<{
+                active: import("vue").Ref<RoomSchema[RoomType]["presence"][], RoomSchema[RoomType]["presence"][]>;
+            }>;
+        } & {
+            setActive: (active: boolean) => void;
+            inputProps: {
+                onKeydown: (e: KeyboardEvent) => void;
+                onBlur: () => void;
+            };
+        };
+    };
+    constructor(baseline: InstantDuxDatabase<S>, schema: IdbSchema | undefined);
+    get auth(): import("@instantdb/core").Auth;
+    get storage(): import("@instantdb/core").Storage;
+    get streams(): import("@instantdb/core").Streams;
+    transact: (chunks: IdbTxChunkInput<S> | IdbTxChunkInput<S>[]) => Promise<import("@instantdb/core").TransactionResult>;
+    getAuth: () => Promise<IdbAuthUser | null>;
+    getLocalId: (name: string) => Promise<string>;
+    room: InstantDuxDatabase<S>["room"];
+    /**
+     * Subscribe to a query. Destructure top-level scopes directly — full
+     * shaping ($only/$at/$as/$m, array normalization, singularization) per the
+     * root spec, plus the result pattern. A factory returning `null` pauses.
+     */
+    useQuery: <const Q extends IdbValidQuery<Q, S>>(query: QueryInput<Q>, opts?: MaybeRefOrGetter<IdbQueryOptions<S> | null | undefined>) => IdbQueryResult<Q, S>;
+    /** Imperative one-shot with identical shaping — plain shaped data, no refs. */
+    queryOnce: <const Q extends IdbValidQuery<Q, S>>(query: Q, opts?: IdbQueryOptions<S>) => Promise<IdbQueryData<Q, S>>;
+    /** The data plane, paginated — same shaping, plus `loadNextPage`. */
+    useInfiniteQuery: <const Q extends IdbValidQuery<Q, S>>(query: QueryInput<Q>, opts?: MaybeRefOrGetter<IdbQueryOptions<S> | undefined>) => IdbInfiniteQueryResult<Q, S>;
+    useAuth: () => IdbAuthResult;
+    /**
+     * The user-centric projection. `requireUser: true` types `user` present and
+     * throws at access when there's none; the default leaves it optional.
+     */
+    useUser(opts: {
+        requireUser: true;
+    }): ComputedRef<IdbAuthUser>;
+    useUser(opts?: IdbUserOptions): ComputedRef<IdbAuthUser | undefined>;
+    useConnectionStatus: () => IdbConnectionResult;
+    useLocalId: (name: MaybeRefOrGetter<string>) => IdbLocalIdResult;
+}
+export {};
+//# sourceMappingURL=db.d.ts.map

package/dist/commonjs/vue/overlay/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../../../src/vue/overlay/db.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/vue/overlay/db.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdbClient = void 0;
+const core_1 = require("@instantdb/core");
+/**
+ * The enhanced db — the only public client surface. A thin overlay over the
+ * vendored baseline ([dux-spec-vue.md §1]): hooks compose baseline hooks and
+ * reshape through the pure `shapeResult`, never forking the baseline. SSR
+ * resilience comes from the baseline guards; shaping and the result pattern
+ * are added here.
+ */
+const vue_1 = require("vue");
+const index_js_1 = require("../../query/index.js");
+const index_js_2 = require("../../tx/index.js");
+const result_js_1 = require("./result.js");
+const index_js_3 = require("./rooms/index.js");
+class IdbClient {
+    /** The schema-typed tx chain — shared machinery with `/admin` ([root §5]). */
+    tx = (0, index_js_2.typedTx)();
+    /** Rooms hooks — stateful ones return the result pattern ([§6]). */
+    rooms = index_js_3.rooms;
+    #baseline;
+    #schema;
+    constructor(baseline, schema) {
+        this.#baseline = baseline;
+        this.#schema = (0, index_js_1.shapingSchema)(schema);
+    }
+    // ----- pass-throughs to the baseline -----
+    get auth() {
+        return this.#baseline.auth;
+    }
+    get storage() {
+        return this.#baseline.storage;
+    }
+    get streams() {
+        return this.#baseline.streams;
+    }
+    transact = (chunks) => this.#baseline.transact(chunks);
+    getAuth = () => this.#baseline.getAuth();
+    getLocalId = (name) => this.#baseline.getLocalId(name);
+    room = ((type, id) => this.#baseline.room(type, id));
+    // ----- the data plane -----
+    /**
+     * Subscribe to a query. Destructure top-level scopes directly — full
+     * shaping ($only/$at/$as/$m, array normalization, singularization) per the
+     * root spec, plus the result pattern. A factory returning `null` pauses.
+     */
+    useQuery = (query, opts) => {
+        const duxQuery = (0, vue_1.computed)(() => (0, vue_1.toValue)(query));
+        const base = this.#baseline.useQuery((() => {
+            const q = duxQuery.value;
+            return q ? (0, index_js_1.toWireQuery)(q) : null;
+        }), opts);
+        const shaped = (0, vue_1.computed)(() => {
+            const q = duxQuery.value;
+            return q ? (0, index_js_1.shapeResult)(base.data.value, q, this.#schema) : {};
+        });
+        return (0, result_js_1.makeDynamicResult)({ isLoading: base.isLoading, error: base.error, pageInfo: base.pageInfo }, key => (0, vue_1.computed)(() => shaped.value[key]));
+    };
+    /** Imperative one-shot with identical shaping — plain shaped data, no refs. */
+    queryOnce = async (query, opts) => {
+        const { data } = await this.#baseline.queryOnce((0, index_js_1.toWireQuery)(query), opts);
+        return (0, index_js_1.shapeResult)(data, query, this.#schema);
+    };
+    /** The data plane, paginated — same shaping, plus `loadNextPage`. */
+    useInfiniteQuery = (query, opts) => {
+        const duxQuery = (0, vue_1.computed)(() => (0, vue_1.toValue)(query));
+        const base = this.#baseline.useInfiniteQuery((() => {
+            const q = duxQuery.value;
+            return q ? (0, index_js_1.toWireQuery)(q) : null;
+        }), opts);
+        const shaped = (0, vue_1.computed)(() => {
+            const q = duxQuery.value;
+            return q ? (0, index_js_1.shapeResult)(base.data.value, q, this.#schema) : {};
+        });
+        return (0, result_js_1.makeDynamicResult)({ isLoading: base.isLoading, error: base.error, canLoadNextPage: base.canLoadNextPage }, key => (0, vue_1.computed)(() => shaped.value[key]), { loadNextPage: base.loadNextPage });
+    };
+    // ----- auth, connection, identity -----
+    useAuth = () => {
+        const { isLoading, user, error } = this.#baseline.useAuth();
+        // dux types `user` as IdbAuthUser | undefined — fold the official null.
+        const userRef = (0, vue_1.computed)(() => user.value ?? undefined);
+        return (0, result_js_1.makeResult)({ isLoading, user: userRef, error });
+    };
+    useUser(opts) {
+        const { user } = this.useAuth();
+        return (0, vue_1.computed)(() => {
+            if (!user.value && opts?.requireUser) {
+                throw new core_1.InstantError('useUser({ requireUser: true }) must be used behind an auth gate');
+            }
+            return user.value;
+        });
+    }
+    useConnectionStatus = () => {
+        const status = this.#baseline.useConnectionStatus();
+        return (0, result_js_1.makeResult)({ status });
+    };
+    useLocalId = (name) => {
+        const localId = this.#baseline.useLocalId(name);
+        return (0, result_js_1.makeResult)({ localId });
+    };
+}
+exports.IdbClient = IdbClient;
+void index_js_1.resultKeys; // exported utility; kept available for tooling
+//# sourceMappingURL=db.js.map

package/dist/commonjs/vue/overlay/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../../../src/vue/overlay/db.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ComputedRef, MaybeRefOrGetter } from 'vue'\nimport type { IdbQueryData, IdbQueryOptions, IdbValidQuery } from '../../query/index.js'\nimport type { IdbSchema } from '../../schema/defineSchema.js'\nimport type { IdbRegisteredSchema } from '../../schema/register.js'\nimport type { IdbTx, IdbTxChunkInput } from '../../tx/index.js'\nimport type { InstantDuxDatabase } from '../baseline/index.js'\nimport type {\n  IdbAuthResult,\n  IdbAuthUser,\n  IdbConnectionResult,\n  IdbInfiniteQueryResult,\n  IdbLocalIdResult,\n  IdbQueryResult,\n  IdbUserOptions,\n} from './types.js'\nimport { InstantError } from '@instantdb/core'\n/**\n * The enhanced db — the only public client surface. A thin overlay over the\n * vendored baseline ([dux-spec-vue.md §1]): hooks compose baseline hooks and\n * reshape through the pure `shapeResult`, never forking the baseline. SSR\n * resilience comes from the baseline guards; shaping and the result pattern\n * are added here.\n */\nimport { computed, toValue } from 'vue'\nimport { resultKeys, shapeResult, shapingSchema, toWireQuery } from '../../query/index.js'\nimport { typedTx } from '../../tx/index.js'\nimport { makeDynamicResult, makeResult } from './result.js'\nimport { rooms as overlayRooms } from './rooms/index.js'\n\n/** A query input: a query, a ref/getter of one, or a factory returning null to pause. */\ntype QueryInput<Q> = MaybeRefOrGetter<Q | null>\n\nexport class IdbClient<S extends IdbSchema = IdbRegisteredSchema> {\n  /** The schema-typed tx chain — shared machinery with `/admin` ([root §5]). */\n  public readonly tx: IdbTx<S> = typedTx<S>()\n  /** Rooms hooks — stateful ones return the result pattern ([§6]). */\n  public readonly rooms = overlayRooms\n\n  readonly #baseline: InstantDuxDatabase<S>\n  readonly #schema: IdbSchema\n\n  constructor(baseline: InstantDuxDatabase<S>, schema: IdbSchema | undefined) {\n    this.#baseline = baseline\n    this.#schema = shapingSchema(schema)\n  }\n\n  // ----- pass-throughs to the baseline -----\n\n  get auth() {\n    return this.#baseline.auth\n  }\n\n  get storage() {\n    return this.#baseline.storage\n  }\n\n  get streams() {\n    return this.#baseline.streams\n  }\n\n  transact = (chunks: IdbTxChunkInput<S> | IdbTxChunkInput<S>[]) =>\n    this.#baseline.transact(chunks as any)\n\n  getAuth = (): Promise<IdbAuthUser | null> => this.#baseline.getAuth()\n  getLocalId = (name: string): Promise<string> => this.#baseline.getLocalId(name)\n\n  room = ((type?: any, id?: any) => this.#baseline.room(type, id)) as\n    InstantDuxDatabase<S>['room']\n\n  // ----- the data plane -----\n\n  /**\n   * Subscribe to a query. Destructure top-level scopes directly — full\n   * shaping ($only/$at/$as/$m, array normalization, singularization) per the\n   * root spec, plus the result pattern. A factory returning `null` pauses.\n   */\n  useQuery = <const Q extends IdbValidQuery<Q, S>>(\n    query: QueryInput<Q>,\n    opts?: MaybeRefOrGetter<IdbQueryOptions<S> | null | undefined>,\n  ): IdbQueryResult<Q, S> => {\n    const duxQuery = computed(() => toValue(query) as Record<string, any> | null)\n    const base = this.#baseline.useQuery(\n      (() => {\n        const q = duxQuery.value\n        return q ? toWireQuery(q) : null\n      }) as any,\n      opts as any,\n    )\n    const shaped = computed(() => {\n      const q = duxQuery.value\n      return q ? shapeResult(base.data.value, q, this.#schema) : {}\n    })\n    return makeDynamicResult(\n      { isLoading: base.isLoading, error: base.error, pageInfo: base.pageInfo },\n      key => computed(() => shaped.value[key]),\n    )\n  }\n\n  /** Imperative one-shot with identical shaping — plain shaped data, no refs. */\n  queryOnce = async <const Q extends IdbValidQuery<Q, S>>(\n    query: Q,\n    opts?: IdbQueryOptions<S>,\n  ): Promise<IdbQueryData<Q, S>> => {\n    const { data } = await this.#baseline.queryOnce(\n      toWireQuery(query as Record<string, any>) as any,\n      opts as any,\n    )\n    return shapeResult(data, query as Record<string, any>, this.#schema) as IdbQueryData<Q, S>\n  }\n\n  /** The data plane, paginated — same shaping, plus `loadNextPage`. */\n  useInfiniteQuery = <const Q extends IdbValidQuery<Q, S>>(\n    query: QueryInput<Q>,\n    opts?: MaybeRefOrGetter<IdbQueryOptions<S> | undefined>,\n  ): IdbInfiniteQueryResult<Q, S> => {\n    const duxQuery = computed(() => toValue(query) as Record<string, any> | null)\n    const base = this.#baseline.useInfiniteQuery(\n      (() => {\n        const q = duxQuery.value\n        return q ? toWireQuery(q) : null\n      }) as any,\n      opts as any,\n    )\n    const shaped = computed(() => {\n      const q = duxQuery.value\n      return q ? shapeResult(base.data.value, q, this.#schema) : {}\n    })\n    return makeDynamicResult(\n      { isLoading: base.isLoading, error: base.error, canLoadNextPage: base.canLoadNextPage },\n      key => computed(() => shaped.value[key]),\n      { loadNextPage: base.loadNextPage },\n    )\n  }\n\n  // ----- auth, connection, identity -----\n\n  useAuth = (): IdbAuthResult => {\n    const { isLoading, user, error } = this.#baseline.useAuth()\n    // dux types `user` as IdbAuthUser | undefined — fold the official null.\n    const userRef = computed(() => user.value ?? undefined)\n    return makeResult({ isLoading, user: userRef, error })\n  }\n\n  /**\n   * The user-centric projection. `requireUser: true` types `user` present and\n   * throws at access when there's none; the default leaves it optional.\n   */\n  useUser(opts: { requireUser: true }): ComputedRef<IdbAuthUser>\n  useUser(opts?: IdbUserOptions): ComputedRef<IdbAuthUser | undefined>\n  useUser(opts?: IdbUserOptions): ComputedRef<IdbAuthUser | undefined> {\n    const { user } = this.useAuth()\n    return computed(() => {\n      if (!user.value && opts?.requireUser) {\n        throw new InstantError(\n          'useUser({ requireUser: true }) must be used behind an auth gate',\n        )\n      }\n      return user.value\n    })\n  }\n\n  useConnectionStatus = (): IdbConnectionResult => {\n    const status = this.#baseline.useConnectionStatus()\n    return makeResult({ status })\n  }\n\n  useLocalId = (name: MaybeRefOrGetter<string>): IdbLocalIdResult => {\n    const localId = this.#baseline.useLocalId(name)\n    return makeResult({ localId })\n  }\n}\n\nvoid resultKeys // exported utility; kept available for tooling\n"]}

package/dist/commonjs/vue/overlay/defineDb.d.ts

@@ -0,0 +1,34 @@
+import type { IdbSchema } from '../../schema/defineSchema.js';
+import type { IdbRegisteredSchema } from '../../schema/register.js';
+import type { IdbClientConfig } from './types.js';
+import { IdbClient } from './db.js';
+/**
+ * Build the db eagerly — for apps whose config is available at module load.
+ *
+ * The client is `markRaw`'d: it is a stable handle, not reactive state (its
+ * reactivity lives in the refs its hooks return), so it must never be wrapped
+ * in a reactive proxy. Storing it in a Pinia store or `reactive()` is the
+ * normal case, and a proxy would break the pass-through getters (`auth`,
+ * `storage`, `streams`) — reading a private field through a proxy throws. This
+ * makes the client proxy-safe with zero userland ceremony.
+ */
+export declare function init<S extends IdbSchema = IdbRegisteredSchema>(config: IdbClientConfig<S>): IdbClient<S>;
+/** `defineDb` options: the schema, a lazy `getAppId`, and the rest of config. */
+export type IdbDefineDbOptions<S extends IdbSchema> = Omit<IdbClientConfig<S>, 'appId'> & {
+    /** Resolved on first use (framework runtime config, env indirection, …). */
+    getAppId: () => string;
+};
+/**
+ * Returns a factory: the first call resolves config and creates the db;
+ * subsequent calls return the same instance. No framework-wide singleton —
+ * global state stays the app's responsibility.
+ *
+ * @example
+ *   export const useDb = defineDb({
+ *     schema,
+ *     getAppId: () => useRuntimeConfig().public.instantAppId,
+ *     firstPartyPath: '/api/idb',
+ *   })
+ */
+export declare function defineDb<S extends IdbSchema = IdbRegisteredSchema>(options: IdbDefineDbOptions<S>): () => IdbClient<S>;
+//# sourceMappingURL=defineDb.d.ts.map

package/dist/commonjs/vue/overlay/defineDb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineDb.d.ts","sourceRoot":"","sources":["../../../../src/vue/overlay/defineDb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAQjD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAEnC;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,SAAS,GAAG,mBAAmB,EAC5D,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GACzB,SAAS,CAAC,CAAC,CAAC,CAGd;AAED,iFAAiF;AACjF,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG;IACxF,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,MAAM,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,SAAS,GAAG,mBAAmB,EAChE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,MAAM,SAAS,CAAC,CAAC,CAAC,CAQpB"}

package/dist/commonjs/vue/overlay/defineDb.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.init = init;
+exports.defineDb = defineDb;
+/**
+ * Setup — `init` (eager) and `defineDb` (memoized lazy factory). `defineDb`
+ * gives first-class support to the app-id-resolves-at-runtime pattern instead
+ * of a hand-rolled lazy-init-and-memoize dance ([dux-spec-vue.md §2]).
+ */
+const vue_1 = require("vue");
+const index_js_1 = require("../baseline/index.js");
+const db_js_1 = require("./db.js");
+/**
+ * Build the db eagerly — for apps whose config is available at module load.
+ *
+ * The client is `markRaw`'d: it is a stable handle, not reactive state (its
+ * reactivity lives in the refs its hooks return), so it must never be wrapped
+ * in a reactive proxy. Storing it in a Pinia store or `reactive()` is the
+ * normal case, and a proxy would break the pass-through getters (`auth`,
+ * `storage`, `streams`) — reading a private field through a proxy throws. This
+ * makes the client proxy-safe with zero userland ceremony.
+ */
+function init(config) {
+    const baseline = (0, index_js_1.init)(config);
+    return (0, vue_1.markRaw)(new db_js_1.IdbClient(baseline, config.schema));
+}
+/**
+ * Returns a factory: the first call resolves config and creates the db;
+ * subsequent calls return the same instance. No framework-wide singleton —
+ * global state stays the app's responsibility.
+ *
+ * @example
+ *   export const useDb = defineDb({
+ *     schema,
+ *     getAppId: () => useRuntimeConfig().public.instantAppId,
+ *     firstPartyPath: '/api/idb',
+ *   })
+ */
+function defineDb(options) {
+    let instance;
+    const { getAppId, ...config } = options;
+    return () => {
+        if (!instance)
+            instance = init({ ...config, appId: getAppId() });
+        return instance;
+    };
+}
+//# sourceMappingURL=defineDb.js.map

package/dist/commonjs/vue/overlay/defineDb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineDb.js","sourceRoot":"","sources":["../../../../src/vue/overlay/defineDb.ts"],"names":[],"mappings":";;AAsBA,oBAKC;AAoBD,4BAUC;AAtDD;;;;GAIG;AACH,6BAA6B;AAC7B,mDAA2D;AAC3D,mCAAmC;AAEnC;;;;;;;;;GASG;AACH,SAAgB,IAAI,CAClB,MAA0B;IAE1B,MAAM,QAAQ,GAAG,IAAA,eAAY,EAAC,MAAa,CAAC,CAAA;IAC5C,OAAO,IAAA,aAAO,EAAC,IAAI,iBAAS,CAAI,QAAe,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;AAClE,CAAC;AAQD;;;;;;;;;;;GAWG;AACH,SAAgB,QAAQ,CACtB,OAA8B;IAE9B,IAAI,QAAkC,CAAA;IACtC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,CAAA;IACvC,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,QAAQ;YACX,QAAQ,GAAG,IAAI,CAAI,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAwB,CAAC,CAAA;QAC5E,OAAO,QAAQ,CAAA;IACjB,CAAC,CAAA;AACH,CAAC","sourcesContent":["import type { IdbSchema } from '../../schema/defineSchema.js'\nimport type { IdbRegisteredSchema } from '../../schema/register.js'\nimport type { IdbClientConfig } from './types.js'\n/**\n * Setup — `init` (eager) and `defineDb` (memoized lazy factory). `defineDb`\n * gives first-class support to the app-id-resolves-at-runtime pattern instead\n * of a hand-rolled lazy-init-and-memoize dance ([dux-spec-vue.md §2]).\n */\nimport { markRaw } from 'vue'\nimport { init as baselineInit } from '../baseline/index.js'\nimport { IdbClient } from './db.js'\n\n/**\n * Build the db eagerly — for apps whose config is available at module load.\n *\n * The client is `markRaw`'d: it is a stable handle, not reactive state (its\n * reactivity lives in the refs its hooks return), so it must never be wrapped\n * in a reactive proxy. Storing it in a Pinia store or `reactive()` is the\n * normal case, and a proxy would break the pass-through getters (`auth`,\n * `storage`, `streams`) — reading a private field through a proxy throws. This\n * makes the client proxy-safe with zero userland ceremony.\n */\nexport function init<S extends IdbSchema = IdbRegisteredSchema>(\n  config: IdbClientConfig<S>,\n): IdbClient<S> {\n  const baseline = baselineInit(config as any)\n  return markRaw(new IdbClient<S>(baseline as any, config.schema))\n}\n\n/** `defineDb` options: the schema, a lazy `getAppId`, and the rest of config. */\nexport type IdbDefineDbOptions<S extends IdbSchema> = Omit<IdbClientConfig<S>, 'appId'> & {\n  /** Resolved on first use (framework runtime config, env indirection, …). */\n  getAppId: () => string\n}\n\n/**\n * Returns a factory: the first call resolves config and creates the db;\n * subsequent calls return the same instance. No framework-wide singleton —\n * global state stays the app's responsibility.\n *\n * @example\n *   export const useDb = defineDb({\n *     schema,\n *     getAppId: () => useRuntimeConfig().public.instantAppId,\n *     firstPartyPath: '/api/idb',\n *   })\n */\nexport function defineDb<S extends IdbSchema = IdbRegisteredSchema>(\n  options: IdbDefineDbOptions<S>,\n): () => IdbClient<S> {\n  let instance: IdbClient<S> | undefined\n  const { getAppId, ...config } = options\n  return () => {\n    if (!instance)\n      instance = init<S>({ ...config, appId: getAppId() } as IdbClientConfig<S>)\n    return instance\n  }\n}\n"]}

package/dist/commonjs/vue/overlay/result.d.ts

@@ -0,0 +1,29 @@
+import type { Ref } from 'vue';
+/** The flat ref bag a hook produces (`{ isLoading, error, todos, … }`). */
+export type RefsBag = Record<string, Ref<any>>;
+type Unref<R> = R extends Ref<infer V> ? V : never;
+/** `.state` — getter projection over the refs, `.value`-free and read-only. */
+export type StateOf<Refs> = {
+    readonly [K in keyof Refs]: Unref<Refs[K]>;
+};
+/** The full result: top-level refs (spread in), plus `.refs` and `.state`. */
+export type IdbResult<Refs> = Refs & {
+    refs: Refs;
+    state: StateOf<Refs>;
+};
+/**
+ * Wrap a hook's flat ref bag into the result pattern. The refs are spread to
+ * the top level, exposed again under `.refs`, and projected read-only under a
+ * raw `.state`.
+ */
+export declare function makeResult<Refs extends RefsBag>(refs: Refs): IdbResult<Refs>;
+/**
+ * The result pattern for hooks whose key set is *dynamic* (query scopes
+ * depend on the query, which can change at runtime). `staticRefs` are always
+ * present (`isLoading`, `error`, …); any other accessed key is resolved
+ * through `scopeRef`, which the builder memoizes. Destructuring, `.refs`
+ * passthrough, and the raw `.state` projection all work over arbitrary keys.
+ */
+export declare function makeDynamicResult<Static extends RefsBag>(staticRefs: Static, scopeRef: (key: string) => Ref<any>, extras?: Record<string, unknown>): any;
+export {};
+//# sourceMappingURL=result.d.ts.map