@tanstack/angular-db 0.0.1 → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kyle Mathews
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cjs/index.cjs

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const core = require("@angular/core");
+const db = require("@tanstack/db");
+function injectLiveQuery(opts) {
+  core.assertInInjectionContext(injectLiveQuery);
+  const destroyRef = core.inject(core.DestroyRef);
+  const collection = core.computed(() => {
+    const isExistingCollection = opts && typeof opts === `object` && typeof opts.subscribeChanges === `function` && typeof opts.startSyncImmediate === `function` && typeof opts.id === `string`;
+    if (isExistingCollection) {
+      return opts;
+    }
+    if (typeof opts === `function`) {
+      return db.createLiveQueryCollection({
+        query: opts,
+        startSync: true,
+        gcTime: 0
+      });
+    }
+    const isReactiveQueryOptions = opts && typeof opts === `object` && typeof opts.query === `function` && typeof opts.params === `function`;
+    if (isReactiveQueryOptions) {
+      const { params, query } = opts;
+      const currentParams = params();
+      return db.createLiveQueryCollection({
+        query: (q) => query({ params: currentParams, q }),
+        startSync: true,
+        gcTime: 0
+      });
+    }
+    if (opts && typeof opts === `object` && typeof opts.query === `function`) {
+      return db.createLiveQueryCollection(opts);
+    }
+    throw new Error(`Invalid options provided to injectLiveQuery`);
+  });
+  const state = core.signal(/* @__PURE__ */ new Map());
+  const data = core.signal([]);
+  const status = core.signal(`idle`);
+  const syncDataFromCollection = (currentCollection) => {
+    const newState = new Map(currentCollection.entries());
+    const newData = Array.from(currentCollection.values());
+    state.set(newState);
+    data.set(newData);
+    status.set(currentCollection.status);
+  };
+  let unsub = null;
+  const cleanup = () => {
+    unsub == null ? void 0 : unsub();
+    unsub = null;
+  };
+  core.effect((onCleanup) => {
+    const currentCollection = collection();
+    if (!currentCollection) {
+      return;
+    }
+    cleanup();
+    syncDataFromCollection(currentCollection);
+    if (currentCollection.status === `idle`) {
+      currentCollection.startSyncImmediate();
+      status.set(currentCollection.status);
+    }
+    unsub = currentCollection.subscribeChanges(
+      (_) => {
+        syncDataFromCollection(currentCollection);
+      }
+    );
+    currentCollection.onFirstReady(() => {
+      status.set(currentCollection.status);
+    });
+    onCleanup(cleanup);
+  });
+  destroyRef.onDestroy(cleanup);
+  return {
+    state,
+    data,
+    collection,
+    status,
+    isLoading: core.computed(
+      () => status() === `loading` || status() === `initialCommit`
+    ),
+    isReady: core.computed(() => status() === `ready`),
+    isIdle: core.computed(() => status() === `idle`),
+    isError: core.computed(() => status() === `error`),
+    isCleanedUp: core.computed(() => status() === `cleaned-up`)
+  };
+}
+exports.injectLiveQuery = injectLiveQuery;
+//# sourceMappingURL=index.cjs.map

package/dist/cjs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../src/index.ts"],"sourcesContent":["import {\n  DestroyRef,\n  assertInInjectionContext,\n  computed,\n  effect,\n  inject,\n  signal,\n} from \"@angular/core\"\nimport { createLiveQueryCollection } from \"@tanstack/db\"\nimport type {\n  ChangeMessage,\n  Collection,\n  CollectionStatus,\n  Context,\n  GetResult,\n  InitialQueryBuilder,\n  LiveQueryCollectionConfig,\n  QueryBuilder,\n} from \"@tanstack/db\"\nimport type { Signal } from \"@angular/core\"\n\n/**\n * The result of calling `injectLiveQuery`.\n * Contains reactive signals for the query state and data.\n */\nexport interface InjectLiveQueryResult<\n  TResult extends object = any,\n  TKey extends string | number = string | number,\n  TUtils extends Record<string, any> = {},\n> {\n  /** A signal containing the complete state map of results keyed by their ID */\n  state: Signal<Map<TKey, TResult>>\n  /** A signal containing the results as an array */\n  data: Signal<Array<TResult>>\n  /** A signal containing the underlying collection instance */\n  collection: Signal<Collection<TResult, TKey, TUtils>>\n  /** A signal containing the current status of the collection */\n  status: Signal<CollectionStatus>\n  /** A signal indicating whether the collection is currently loading */\n  isLoading: Signal<boolean>\n  /** A signal indicating whether the collection is ready */\n  isReady: Signal<boolean>\n  /** A signal indicating whether the collection is idle */\n  isIdle: Signal<boolean>\n  /** A signal indicating whether the collection has an error */\n  isError: Signal<boolean>\n  /** A signal indicating whether the collection has been cleaned up */\n  isCleanedUp: Signal<boolean>\n}\n\nexport function injectLiveQuery<\n  TContext extends Context,\n  TParams extends any,\n>(options: {\n  params: () => TParams\n  query: (args: {\n    params: TParams\n    q: InitialQueryBuilder\n  }) => QueryBuilder<TContext>\n}): InjectLiveQueryResult<GetResult<TContext>>\nexport function injectLiveQuery<TContext extends Context>(\n  queryFn: (q: InitialQueryBuilder) => QueryBuilder<TContext>\n): InjectLiveQueryResult<GetResult<TContext>>\nexport function injectLiveQuery<TContext extends Context>(\n  config: LiveQueryCollectionConfig<TContext>\n): InjectLiveQueryResult<GetResult<TContext>>\nexport function injectLiveQuery<\n  TResult extends object,\n  TKey extends string | number,\n  TUtils extends Record<string, any>,\n>(\n  liveQueryCollection: Collection<TResult, TKey, TUtils>\n): InjectLiveQueryResult<TResult, TKey, TUtils>\nexport function injectLiveQuery(opts: any) {\n  assertInInjectionContext(injectLiveQuery)\n  const destroyRef = inject(DestroyRef)\n\n  const collection = computed(() => {\n    // Check if it's an existing collection\n    const isExistingCollection =\n      opts &&\n      typeof opts === `object` &&\n      typeof opts.subscribeChanges === `function` &&\n      typeof opts.startSyncImmediate === `function` &&\n      typeof opts.id === `string`\n\n    if (isExistingCollection) {\n      return opts\n    }\n\n    if (typeof opts === `function`) {\n      return createLiveQueryCollection({\n        query: opts,\n        startSync: true,\n        gcTime: 0,\n      })\n    }\n\n    // Check if it's reactive query options\n    const isReactiveQueryOptions =\n      opts &&\n      typeof opts === `object` &&\n      typeof opts.query === `function` &&\n      typeof opts.params === `function`\n\n    if (isReactiveQueryOptions) {\n      const { params, query } = opts\n      const currentParams = params()\n      return createLiveQueryCollection({\n        query: (q) => query({ params: currentParams, q }),\n        startSync: true,\n        gcTime: 0,\n      })\n    }\n\n    // Handle LiveQueryCollectionConfig objects\n    if (opts && typeof opts === `object` && typeof opts.query === `function`) {\n      return createLiveQueryCollection(opts)\n    }\n\n    throw new Error(`Invalid options provided to injectLiveQuery`)\n  })\n\n  const state = signal(new Map<string | number, any>())\n  const data = signal<Array<any>>([])\n  const status = signal<CollectionStatus>(`idle`)\n\n  const syncDataFromCollection = (\n    currentCollection: Collection<any, any, any>\n  ) => {\n    const newState = new Map(currentCollection.entries())\n    const newData = Array.from(currentCollection.values())\n\n    state.set(newState)\n    data.set(newData)\n    status.set(currentCollection.status)\n  }\n\n  let unsub: (() => void) | null = null\n  const cleanup = () => {\n    unsub?.()\n    unsub = null\n  }\n\n  effect((onCleanup) => {\n    const currentCollection = collection()\n\n    if (!currentCollection) {\n      return\n    }\n\n    cleanup()\n\n    // Initialize immediately with current state\n    syncDataFromCollection(currentCollection)\n\n    // Start sync if idle\n    if (currentCollection.status === `idle`) {\n      currentCollection.startSyncImmediate()\n      // Update status after starting sync\n      status.set(currentCollection.status)\n    }\n\n    // Subscribe to changes\n    unsub = currentCollection.subscribeChanges(\n      (_: Array<ChangeMessage<any>>) => {\n        syncDataFromCollection(currentCollection)\n      }\n    )\n\n    // Handle ready state\n    currentCollection.onFirstReady(() => {\n      status.set(currentCollection.status)\n    })\n\n    onCleanup(cleanup)\n  })\n\n  destroyRef.onDestroy(cleanup)\n\n  return {\n    state,\n    data,\n    collection,\n    status,\n    isLoading: computed(\n      () => status() === `loading` || status() === `initialCommit`\n    ),\n    isReady: computed(() => status() === `ready`),\n    isIdle: computed(() => status() === `idle`),\n    isError: computed(() => status() === `error`),\n    isCleanedUp: computed(() => status() === `cleaned-up`),\n  }\n}\n"],"names":["assertInInjectionContext","inject","DestroyRef","computed","createLiveQueryCollection","signal","effect"],"mappings":";;;;AAyEO,SAAS,gBAAgB,MAAW;AACzCA,OAAAA,yBAAyB,eAAe;AACxC,QAAM,aAAaC,KAAAA,OAAOC,eAAU;AAEpC,QAAM,aAAaC,KAAAA,SAAS,MAAM;AAEhC,UAAM,uBACJ,QACA,OAAO,SAAS,YAChB,OAAO,KAAK,qBAAqB,cACjC,OAAO,KAAK,uBAAuB,cACnC,OAAO,KAAK,OAAO;AAErB,QAAI,sBAAsB;AACxB,aAAO;AAAA,IACT;AAEA,QAAI,OAAO,SAAS,YAAY;AAC9B,aAAOC,6BAA0B;AAAA,QAC/B,OAAO;AAAA,QACP,WAAW;AAAA,QACX,QAAQ;AAAA,MAAA,CACT;AAAA,IACH;AAGA,UAAM,yBACJ,QACA,OAAO,SAAS,YAChB,OAAO,KAAK,UAAU,cACtB,OAAO,KAAK,WAAW;AAEzB,QAAI,wBAAwB;AAC1B,YAAM,EAAE,QAAQ,MAAA,IAAU;AAC1B,YAAM,gBAAgB,OAAA;AACtB,aAAOA,6BAA0B;AAAA,QAC/B,OAAO,CAAC,MAAM,MAAM,EAAE,QAAQ,eAAe,GAAG;AAAA,QAChD,WAAW;AAAA,QACX,QAAQ;AAAA,MAAA,CACT;AAAA,IACH;AAGA,QAAI,QAAQ,OAAO,SAAS,YAAY,OAAO,KAAK,UAAU,YAAY;AACxE,aAAOA,GAAAA,0BAA0B,IAAI;AAAA,IACvC;AAEA,UAAM,IAAI,MAAM,6CAA6C;AAAA,EAC/D,CAAC;AAED,QAAM,QAAQC,KAAAA,OAAO,oBAAI,KAA2B;AACpD,QAAM,OAAOA,KAAAA,OAAmB,EAAE;AAClC,QAAM,SAASA,KAAAA,OAAyB,MAAM;AAE9C,QAAM,yBAAyB,CAC7B,sBACG;AACH,UAAM,WAAW,IAAI,IAAI,kBAAkB,SAAS;AACpD,UAAM,UAAU,MAAM,KAAK,kBAAkB,QAAQ;AAErD,UAAM,IAAI,QAAQ;AAClB,SAAK,IAAI,OAAO;AAChB,WAAO,IAAI,kBAAkB,MAAM;AAAA,EACrC;AAEA,MAAI,QAA6B;AACjC,QAAM,UAAU,MAAM;AACpB;AACA,YAAQ;AAAA,EACV;AAEAC,OAAAA,OAAO,CAAC,cAAc;AACpB,UAAM,oBAAoB,WAAA;AAE1B,QAAI,CAAC,mBAAmB;AACtB;AAAA,IACF;AAEA,YAAA;AAGA,2BAAuB,iBAAiB;AAGxC,QAAI,kBAAkB,WAAW,QAAQ;AACvC,wBAAkB,mBAAA;AAElB,aAAO,IAAI,kBAAkB,MAAM;AAAA,IACrC;AAGA,YAAQ,kBAAkB;AAAA,MACxB,CAAC,MAAiC;AAChC,+BAAuB,iBAAiB;AAAA,MAC1C;AAAA,IAAA;AAIF,sBAAkB,aAAa,MAAM;AACnC,aAAO,IAAI,kBAAkB,MAAM;AAAA,IACrC,CAAC;AAED,cAAU,OAAO;AAAA,EACnB,CAAC;AAED,aAAW,UAAU,OAAO;AAE5B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAWH,KAAAA;AAAAA,MACT,MAAM,OAAA,MAAa,aAAa,aAAa;AAAA,IAAA;AAAA,IAE/C,SAASA,KAAAA,SAAS,MAAM,OAAA,MAAa,OAAO;AAAA,IAC5C,QAAQA,KAAAA,SAAS,MAAM,OAAA,MAAa,MAAM;AAAA,IAC1C,SAASA,KAAAA,SAAS,MAAM,OAAA,MAAa,OAAO;AAAA,IAC5C,aAAaA,KAAAA,SAAS,MAAM,OAAA,MAAa,YAAY;AAAA,EAAA;AAEzD;;"}

package/dist/cjs/index.d.cts

@@ -0,0 +1,36 @@
+import { Collection, CollectionStatus, Context, GetResult, InitialQueryBuilder, LiveQueryCollectionConfig, QueryBuilder } from '@tanstack/db';
+import { Signal } from '@angular/core';
+/**
+ * The result of calling `injectLiveQuery`.
+ * Contains reactive signals for the query state and data.
+ */
+export interface InjectLiveQueryResult<TResult extends object = any, TKey extends string | number = string | number, TUtils extends Record<string, any> = {}> {
+    /** A signal containing the complete state map of results keyed by their ID */
+    state: Signal<Map<TKey, TResult>>;
+    /** A signal containing the results as an array */
+    data: Signal<Array<TResult>>;
+    /** A signal containing the underlying collection instance */
+    collection: Signal<Collection<TResult, TKey, TUtils>>;
+    /** A signal containing the current status of the collection */
+    status: Signal<CollectionStatus>;
+    /** A signal indicating whether the collection is currently loading */
+    isLoading: Signal<boolean>;
+    /** A signal indicating whether the collection is ready */
+    isReady: Signal<boolean>;
+    /** A signal indicating whether the collection is idle */
+    isIdle: Signal<boolean>;
+    /** A signal indicating whether the collection has an error */
+    isError: Signal<boolean>;
+    /** A signal indicating whether the collection has been cleaned up */
+    isCleanedUp: Signal<boolean>;
+}
+export declare function injectLiveQuery<TContext extends Context, TParams extends any>(options: {
+    params: () => TParams;
+    query: (args: {
+        params: TParams;
+        q: InitialQueryBuilder;
+    }) => QueryBuilder<TContext>;
+}): InjectLiveQueryResult<GetResult<TContext>>;
+export declare function injectLiveQuery<TContext extends Context>(queryFn: (q: InitialQueryBuilder) => QueryBuilder<TContext>): InjectLiveQueryResult<GetResult<TContext>>;
+export declare function injectLiveQuery<TContext extends Context>(config: LiveQueryCollectionConfig<TContext>): InjectLiveQueryResult<GetResult<TContext>>;
+export declare function injectLiveQuery<TResult extends object, TKey extends string | number, TUtils extends Record<string, any>>(liveQueryCollection: Collection<TResult, TKey, TUtils>): InjectLiveQueryResult<TResult, TKey, TUtils>;

package/dist/esm/index.d.ts

@@ -0,0 +1,36 @@
+import { Collection, CollectionStatus, Context, GetResult, InitialQueryBuilder, LiveQueryCollectionConfig, QueryBuilder } from '@tanstack/db';
+import { Signal } from '@angular/core';
+/**
+ * The result of calling `injectLiveQuery`.
+ * Contains reactive signals for the query state and data.
+ */
+export interface InjectLiveQueryResult<TResult extends object = any, TKey extends string | number = string | number, TUtils extends Record<string, any> = {}> {
+    /** A signal containing the complete state map of results keyed by their ID */
+    state: Signal<Map<TKey, TResult>>;
+    /** A signal containing the results as an array */
+    data: Signal<Array<TResult>>;
+    /** A signal containing the underlying collection instance */
+    collection: Signal<Collection<TResult, TKey, TUtils>>;
+    /** A signal containing the current status of the collection */
+    status: Signal<CollectionStatus>;
+    /** A signal indicating whether the collection is currently loading */
+    isLoading: Signal<boolean>;
+    /** A signal indicating whether the collection is ready */
+    isReady: Signal<boolean>;
+    /** A signal indicating whether the collection is idle */
+    isIdle: Signal<boolean>;
+    /** A signal indicating whether the collection has an error */
+    isError: Signal<boolean>;
+    /** A signal indicating whether the collection has been cleaned up */
+    isCleanedUp: Signal<boolean>;
+}
+export declare function injectLiveQuery<TContext extends Context, TParams extends any>(options: {
+    params: () => TParams;
+    query: (args: {
+        params: TParams;
+        q: InitialQueryBuilder;
+    }) => QueryBuilder<TContext>;
+}): InjectLiveQueryResult<GetResult<TContext>>;
+export declare function injectLiveQuery<TContext extends Context>(queryFn: (q: InitialQueryBuilder) => QueryBuilder<TContext>): InjectLiveQueryResult<GetResult<TContext>>;
+export declare function injectLiveQuery<TContext extends Context>(config: LiveQueryCollectionConfig<TContext>): InjectLiveQueryResult<GetResult<TContext>>;
+export declare function injectLiveQuery<TResult extends object, TKey extends string | number, TUtils extends Record<string, any>>(liveQueryCollection: Collection<TResult, TKey, TUtils>): InjectLiveQueryResult<TResult, TKey, TUtils>;

package/dist/esm/index.js

@@ -0,0 +1,87 @@
+import { assertInInjectionContext, inject, DestroyRef, computed, signal, effect } from "@angular/core";
+import { createLiveQueryCollection } from "@tanstack/db";
+function injectLiveQuery(opts) {
+  assertInInjectionContext(injectLiveQuery);
+  const destroyRef = inject(DestroyRef);
+  const collection = computed(() => {
+    const isExistingCollection = opts && typeof opts === `object` && typeof opts.subscribeChanges === `function` && typeof opts.startSyncImmediate === `function` && typeof opts.id === `string`;
+    if (isExistingCollection) {
+      return opts;
+    }
+    if (typeof opts === `function`) {
+      return createLiveQueryCollection({
+        query: opts,
+        startSync: true,
+        gcTime: 0
+      });
+    }
+    const isReactiveQueryOptions = opts && typeof opts === `object` && typeof opts.query === `function` && typeof opts.params === `function`;
+    if (isReactiveQueryOptions) {
+      const { params, query } = opts;
+      const currentParams = params();
+      return createLiveQueryCollection({
+        query: (q) => query({ params: currentParams, q }),
+        startSync: true,
+        gcTime: 0
+      });
+    }
+    if (opts && typeof opts === `object` && typeof opts.query === `function`) {
+      return createLiveQueryCollection(opts);
+    }
+    throw new Error(`Invalid options provided to injectLiveQuery`);
+  });
+  const state = signal(/* @__PURE__ */ new Map());
+  const data = signal([]);
+  const status = signal(`idle`);
+  const syncDataFromCollection = (currentCollection) => {
+    const newState = new Map(currentCollection.entries());
+    const newData = Array.from(currentCollection.values());
+    state.set(newState);
+    data.set(newData);
+    status.set(currentCollection.status);
+  };
+  let unsub = null;
+  const cleanup = () => {
+    unsub == null ? void 0 : unsub();
+    unsub = null;
+  };
+  effect((onCleanup) => {
+    const currentCollection = collection();
+    if (!currentCollection) {
+      return;
+    }
+    cleanup();
+    syncDataFromCollection(currentCollection);
+    if (currentCollection.status === `idle`) {
+      currentCollection.startSyncImmediate();
+      status.set(currentCollection.status);
+    }
+    unsub = currentCollection.subscribeChanges(
+      (_) => {
+        syncDataFromCollection(currentCollection);
+      }
+    );
+    currentCollection.onFirstReady(() => {
+      status.set(currentCollection.status);
+    });
+    onCleanup(cleanup);
+  });
+  destroyRef.onDestroy(cleanup);
+  return {
+    state,
+    data,
+    collection,
+    status,
+    isLoading: computed(
+      () => status() === `loading` || status() === `initialCommit`
+    ),
+    isReady: computed(() => status() === `ready`),
+    isIdle: computed(() => status() === `idle`),
+    isError: computed(() => status() === `error`),
+    isCleanedUp: computed(() => status() === `cleaned-up`)
+  };
+}
+export {
+  injectLiveQuery
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/index.ts"],"sourcesContent":["import {\n  DestroyRef,\n  assertInInjectionContext,\n  computed,\n  effect,\n  inject,\n  signal,\n} from \"@angular/core\"\nimport { createLiveQueryCollection } from \"@tanstack/db\"\nimport type {\n  ChangeMessage,\n  Collection,\n  CollectionStatus,\n  Context,\n  GetResult,\n  InitialQueryBuilder,\n  LiveQueryCollectionConfig,\n  QueryBuilder,\n} from \"@tanstack/db\"\nimport type { Signal } from \"@angular/core\"\n\n/**\n * The result of calling `injectLiveQuery`.\n * Contains reactive signals for the query state and data.\n */\nexport interface InjectLiveQueryResult<\n  TResult extends object = any,\n  TKey extends string | number = string | number,\n  TUtils extends Record<string, any> = {},\n> {\n  /** A signal containing the complete state map of results keyed by their ID */\n  state: Signal<Map<TKey, TResult>>\n  /** A signal containing the results as an array */\n  data: Signal<Array<TResult>>\n  /** A signal containing the underlying collection instance */\n  collection: Signal<Collection<TResult, TKey, TUtils>>\n  /** A signal containing the current status of the collection */\n  status: Signal<CollectionStatus>\n  /** A signal indicating whether the collection is currently loading */\n  isLoading: Signal<boolean>\n  /** A signal indicating whether the collection is ready */\n  isReady: Signal<boolean>\n  /** A signal indicating whether the collection is idle */\n  isIdle: Signal<boolean>\n  /** A signal indicating whether the collection has an error */\n  isError: Signal<boolean>\n  /** A signal indicating whether the collection has been cleaned up */\n  isCleanedUp: Signal<boolean>\n}\n\nexport function injectLiveQuery<\n  TContext extends Context,\n  TParams extends any,\n>(options: {\n  params: () => TParams\n  query: (args: {\n    params: TParams\n    q: InitialQueryBuilder\n  }) => QueryBuilder<TContext>\n}): InjectLiveQueryResult<GetResult<TContext>>\nexport function injectLiveQuery<TContext extends Context>(\n  queryFn: (q: InitialQueryBuilder) => QueryBuilder<TContext>\n): InjectLiveQueryResult<GetResult<TContext>>\nexport function injectLiveQuery<TContext extends Context>(\n  config: LiveQueryCollectionConfig<TContext>\n): InjectLiveQueryResult<GetResult<TContext>>\nexport function injectLiveQuery<\n  TResult extends object,\n  TKey extends string | number,\n  TUtils extends Record<string, any>,\n>(\n  liveQueryCollection: Collection<TResult, TKey, TUtils>\n): InjectLiveQueryResult<TResult, TKey, TUtils>\nexport function injectLiveQuery(opts: any) {\n  assertInInjectionContext(injectLiveQuery)\n  const destroyRef = inject(DestroyRef)\n\n  const collection = computed(() => {\n    // Check if it's an existing collection\n    const isExistingCollection =\n      opts &&\n      typeof opts === `object` &&\n      typeof opts.subscribeChanges === `function` &&\n      typeof opts.startSyncImmediate === `function` &&\n      typeof opts.id === `string`\n\n    if (isExistingCollection) {\n      return opts\n    }\n\n    if (typeof opts === `function`) {\n      return createLiveQueryCollection({\n        query: opts,\n        startSync: true,\n        gcTime: 0,\n      })\n    }\n\n    // Check if it's reactive query options\n    const isReactiveQueryOptions =\n      opts &&\n      typeof opts === `object` &&\n      typeof opts.query === `function` &&\n      typeof opts.params === `function`\n\n    if (isReactiveQueryOptions) {\n      const { params, query } = opts\n      const currentParams = params()\n      return createLiveQueryCollection({\n        query: (q) => query({ params: currentParams, q }),\n        startSync: true,\n        gcTime: 0,\n      })\n    }\n\n    // Handle LiveQueryCollectionConfig objects\n    if (opts && typeof opts === `object` && typeof opts.query === `function`) {\n      return createLiveQueryCollection(opts)\n    }\n\n    throw new Error(`Invalid options provided to injectLiveQuery`)\n  })\n\n  const state = signal(new Map<string | number, any>())\n  const data = signal<Array<any>>([])\n  const status = signal<CollectionStatus>(`idle`)\n\n  const syncDataFromCollection = (\n    currentCollection: Collection<any, any, any>\n  ) => {\n    const newState = new Map(currentCollection.entries())\n    const newData = Array.from(currentCollection.values())\n\n    state.set(newState)\n    data.set(newData)\n    status.set(currentCollection.status)\n  }\n\n  let unsub: (() => void) | null = null\n  const cleanup = () => {\n    unsub?.()\n    unsub = null\n  }\n\n  effect((onCleanup) => {\n    const currentCollection = collection()\n\n    if (!currentCollection) {\n      return\n    }\n\n    cleanup()\n\n    // Initialize immediately with current state\n    syncDataFromCollection(currentCollection)\n\n    // Start sync if idle\n    if (currentCollection.status === `idle`) {\n      currentCollection.startSyncImmediate()\n      // Update status after starting sync\n      status.set(currentCollection.status)\n    }\n\n    // Subscribe to changes\n    unsub = currentCollection.subscribeChanges(\n      (_: Array<ChangeMessage<any>>) => {\n        syncDataFromCollection(currentCollection)\n      }\n    )\n\n    // Handle ready state\n    currentCollection.onFirstReady(() => {\n      status.set(currentCollection.status)\n    })\n\n    onCleanup(cleanup)\n  })\n\n  destroyRef.onDestroy(cleanup)\n\n  return {\n    state,\n    data,\n    collection,\n    status,\n    isLoading: computed(\n      () => status() === `loading` || status() === `initialCommit`\n    ),\n    isReady: computed(() => status() === `ready`),\n    isIdle: computed(() => status() === `idle`),\n    isError: computed(() => status() === `error`),\n    isCleanedUp: computed(() => status() === `cleaned-up`),\n  }\n}\n"],"names":[],"mappings":";;AAyEO,SAAS,gBAAgB,MAAW;AACzC,2BAAyB,eAAe;AACxC,QAAM,aAAa,OAAO,UAAU;AAEpC,QAAM,aAAa,SAAS,MAAM;AAEhC,UAAM,uBACJ,QACA,OAAO,SAAS,YAChB,OAAO,KAAK,qBAAqB,cACjC,OAAO,KAAK,uBAAuB,cACnC,OAAO,KAAK,OAAO;AAErB,QAAI,sBAAsB;AACxB,aAAO;AAAA,IACT;AAEA,QAAI,OAAO,SAAS,YAAY;AAC9B,aAAO,0BAA0B;AAAA,QAC/B,OAAO;AAAA,QACP,WAAW;AAAA,QACX,QAAQ;AAAA,MAAA,CACT;AAAA,IACH;AAGA,UAAM,yBACJ,QACA,OAAO,SAAS,YAChB,OAAO,KAAK,UAAU,cACtB,OAAO,KAAK,WAAW;AAEzB,QAAI,wBAAwB;AAC1B,YAAM,EAAE,QAAQ,MAAA,IAAU;AAC1B,YAAM,gBAAgB,OAAA;AACtB,aAAO,0BAA0B;AAAA,QAC/B,OAAO,CAAC,MAAM,MAAM,EAAE,QAAQ,eAAe,GAAG;AAAA,QAChD,WAAW;AAAA,QACX,QAAQ;AAAA,MAAA,CACT;AAAA,IACH;AAGA,QAAI,QAAQ,OAAO,SAAS,YAAY,OAAO,KAAK,UAAU,YAAY;AACxE,aAAO,0BAA0B,IAAI;AAAA,IACvC;AAEA,UAAM,IAAI,MAAM,6CAA6C;AAAA,EAC/D,CAAC;AAED,QAAM,QAAQ,OAAO,oBAAI,KAA2B;AACpD,QAAM,OAAO,OAAmB,EAAE;AAClC,QAAM,SAAS,OAAyB,MAAM;AAE9C,QAAM,yBAAyB,CAC7B,sBACG;AACH,UAAM,WAAW,IAAI,IAAI,kBAAkB,SAAS;AACpD,UAAM,UAAU,MAAM,KAAK,kBAAkB,QAAQ;AAErD,UAAM,IAAI,QAAQ;AAClB,SAAK,IAAI,OAAO;AAChB,WAAO,IAAI,kBAAkB,MAAM;AAAA,EACrC;AAEA,MAAI,QAA6B;AACjC,QAAM,UAAU,MAAM;AACpB;AACA,YAAQ;AAAA,EACV;AAEA,SAAO,CAAC,cAAc;AACpB,UAAM,oBAAoB,WAAA;AAE1B,QAAI,CAAC,mBAAmB;AACtB;AAAA,IACF;AAEA,YAAA;AAGA,2BAAuB,iBAAiB;AAGxC,QAAI,kBAAkB,WAAW,QAAQ;AACvC,wBAAkB,mBAAA;AAElB,aAAO,IAAI,kBAAkB,MAAM;AAAA,IACrC;AAGA,YAAQ,kBAAkB;AAAA,MACxB,CAAC,MAAiC;AAChC,+BAAuB,iBAAiB;AAAA,MAC1C;AAAA,IAAA;AAIF,sBAAkB,aAAa,MAAM;AACnC,aAAO,IAAI,kBAAkB,MAAM;AAAA,IACrC,CAAC;AAED,cAAU,OAAO;AAAA,EACnB,CAAC;AAED,aAAW,UAAU,OAAO;AAE5B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW;AAAA,MACT,MAAM,OAAA,MAAa,aAAa,aAAa;AAAA,IAAA;AAAA,IAE/C,SAAS,SAAS,MAAM,OAAA,MAAa,OAAO;AAAA,IAC5C,QAAQ,SAAS,MAAM,OAAA,MAAa,MAAM;AAAA,IAC1C,SAAS,SAAS,MAAM,OAAA,MAAa,OAAO;AAAA,IAC5C,aAAa,SAAS,MAAM,OAAA,MAAa,YAAY;AAAA,EAAA;AAEzD;"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tanstack/angular-db",
   "description": "Angular integration for @tanstack/db",
-  "version": "0.0.1",
+  "version": "0.1.1",
   "author": "Ethan McDaniel",
   "license": "MIT",
   "repository": {
@@ -15,13 +15,14 @@
     "angular",
     "typescript"
   ],
-  "packageManager": "pnpm@10.6.3",
   "dependencies": {
-    "@tanstack/db": "workspace:*"
+    "@tanstack/db": "0.2.5"
   },
   "devDependencies": {
     "@angular/common": "^19.0.0",
+    "@angular/compiler": "^19.0.0",
     "@angular/core": "^19.0.0",
+    "@angular/platform-browser": "^19.0.0",
     "@angular/platform-browser-dynamic": "^19.0.0",
     "@vitest/coverage-istanbul": "^3.0.9",
     "rxjs": "^7.8.0",
@@ -50,13 +51,13 @@
     "@angular/core": ">=16.0.0",
     "rxjs": ">=6.0.0"
   },
+  "sideEffects": false,
+  "type": "module",
+  "types": "dist/esm/index.d.ts",
   "scripts": {
     "build": "vite build",
     "dev": "vite build --watch",
     "test": "npx vitest --run",
     "lint": "eslint . --fix"
-  },
-  "sideEffects": false,
-  "type": "module",
-  "types": "dist/esm/index.d.ts"
-}
+  }
+}

package/src/index.ts

@@ -24,9 +24,9 @@ import type { Signal } from "@angular/core"
  * Contains reactive signals for the query state and data.
  */
 export interface InjectLiveQueryResult<
-  TResult = any,
+  TResult extends object = any,
   TKey extends string | number = string | number,
-  TUtils extends Record<string, any> = Record<string, never>,
+  TUtils extends Record<string, any> = {},
 > {
   /** A signal containing the complete state map of results keyed by their ID */
   state: Signal<Map<TKey, TResult>>