@ttt-productions/query-core 0.4.6 → 0.6.0

package/dist/domain-events/cache-invalidation.d.ts

@@ -0,0 +1,28 @@
+import type { Query, QueryClient, QueryKey } from "@tanstack/react-query";
+export type RefetchType = "active" | "all" | "none";
+export type CacheInvalidation = {
+    kind: "exact";
+    queryKey: QueryKey;
+    refetchType?: RefetchType;
+} | {
+    kind: "prefix";
+    queryKey: QueryKey;
+    refetchType?: RefetchType;
+} | {
+    kind: "predicate";
+    description: string;
+    match: (query: Query) => boolean;
+    refetchType?: RefetchType;
+};
+export declare function exact(queryKey: QueryKey, opts?: {
+    refetchType?: RefetchType;
+}): CacheInvalidation;
+export declare function prefix(queryKey: QueryKey, opts?: {
+    refetchType?: RefetchType;
+}): CacheInvalidation;
+export declare function predicate(description: string, match: (query: Query) => boolean, opts?: {
+    refetchType?: RefetchType;
+}): CacheInvalidation;
+export declare function serializeInvalidation(inv: CacheInvalidation): string;
+export declare function applyInvalidations(queryClient: QueryClient, invalidations: ReadonlyArray<CacheInvalidation>): void;
+//# sourceMappingURL=cache-invalidation.d.ts.map

package/dist/domain-events/cache-invalidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-invalidation.d.ts","sourceRoot":"","sources":["../../src/domain-events/cache-invalidation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE1E,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpD,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,WAAW,CAAC,EAAE,WAAW,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,WAAW,CAAC,EAAE,WAAW,CAAA;CAAE,GACjE;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IACjC,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,CAAC;AAEN,wBAAgB,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,WAAW,CAAA;CAAE,GAAG,iBAAiB,CAEjG;AAED,wBAAgB,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,WAAW,CAAA;CAAE,GAAG,iBAAiB,CAElG;AAED,wBAAgB,SAAS,CACvB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,EAChC,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,WAAW,CAAA;CAAE,GACnC,iBAAiB,CAEnB;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAGpE;AAED,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAC9C,IAAI,CA4BN"}

package/dist/domain-events/cache-invalidation.js

@@ -0,0 +1,45 @@
+export function exact(queryKey, opts) {
+    return { kind: "exact", queryKey, refetchType: opts?.refetchType };
+}
+export function prefix(queryKey, opts) {
+    return { kind: "prefix", queryKey, refetchType: opts?.refetchType };
+}
+export function predicate(description, match, opts) {
+    return { kind: "predicate", description, match, refetchType: opts?.refetchType };
+}
+export function serializeInvalidation(inv) {
+    if (inv.kind === "predicate")
+        return `predicate:${inv.description}`;
+    return `${inv.kind}:${JSON.stringify(inv.queryKey)}`;
+}
+export function applyInvalidations(queryClient, invalidations) {
+    const seen = new Set();
+    for (const inv of invalidations) {
+        const sig = serializeInvalidation(inv);
+        if (seen.has(sig))
+            continue;
+        seen.add(sig);
+        const refetchType = inv.refetchType ?? "active";
+        if (inv.kind === "exact") {
+            void queryClient.invalidateQueries({
+                queryKey: inv.queryKey,
+                exact: true,
+                refetchType,
+            });
+        }
+        else if (inv.kind === "prefix") {
+            void queryClient.invalidateQueries({
+                queryKey: inv.queryKey,
+                exact: false,
+                refetchType,
+            });
+        }
+        else {
+            void queryClient.invalidateQueries({
+                predicate: inv.match,
+                refetchType,
+            });
+        }
+    }
+}
+//# sourceMappingURL=cache-invalidation.js.map

package/dist/domain-events/cache-invalidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-invalidation.js","sourceRoot":"","sources":["../../src/domain-events/cache-invalidation.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,KAAK,CAAC,QAAkB,EAAE,IAAoC;IAC5E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,QAAkB,EAAE,IAAoC;IAC7E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,WAAmB,EACnB,KAAgC,EAChC,IAAoC;IAEpC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAsB;IAC1D,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,aAAa,GAAG,CAAC,WAAW,EAAE,CAAC;IACpE,OAAO,GAAG,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,WAAwB,EACxB,aAA+C;IAE/C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEd,MAAM,WAAW,GAAgB,GAAG,CAAC,WAAW,IAAI,QAAQ,CAAC;QAE7D,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACzB,KAAK,WAAW,CAAC,iBAAiB,CAAC;gBACjC,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,KAAK,EAAE,IAAI;gBACX,WAAW;aACZ,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjC,KAAK,WAAW,CAAC,iBAAiB,CAAC;gBACjC,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,KAAK,EAAE,KAAK;gBACZ,WAAW;aACZ,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,KAAK,WAAW,CAAC,iBAAiB,CAAC;gBACjC,SAAS,EAAE,GAAG,CAAC,KAAK;gBACpB,WAAW;aACZ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/domain-events/create-domain-event-invalidator.d.ts

@@ -0,0 +1,39 @@
+import type { QueryClient } from "@tanstack/react-query";
+import { exact, prefix, predicate, type CacheInvalidation } from "./cache-invalidation.js";
+/**
+ * Registry shape: each event type maps to a function from the event's `ids`
+ * payload to the list of cache invalidations that event should trigger.
+ */
+export type DomainEventInvalidationRegistry<TEvent extends {
+    type: string;
+    ids: unknown;
+}> = {
+    [K in TEvent["type"]]: (ids: Extract<TEvent, {
+        type: K;
+    }>["ids"]) => ReadonlyArray<CacheInvalidation>;
+};
+export interface DomainEventInvalidator<TEvent extends {
+    type: string;
+    ids: unknown;
+}> {
+    notify(queryClient: QueryClient, event: TEvent): void;
+    notifyAll(queryClient: QueryClient, events: ReadonlyArray<TEvent>): void;
+    /** Test/debug helpers. */
+    readonly helpers: {
+        exact: typeof exact;
+        prefix: typeof prefix;
+        predicate: typeof predicate;
+    };
+    /** Direct access to the registry, mainly for tests. */
+    readonly registry: DomainEventInvalidationRegistry<TEvent>;
+}
+/**
+ * Build a domain-event → cache-invalidation notifier from a typed registry.
+ * The registry's keys are statically tied to `TEvent["type"]`, so missing or
+ * extra entries are compile errors.
+ */
+export declare function createDomainEventInvalidator<TEvent extends {
+    type: string;
+    ids: unknown;
+}>(registry: DomainEventInvalidationRegistry<TEvent>): DomainEventInvalidator<TEvent>;
+//# sourceMappingURL=create-domain-event-invalidator.d.ts.map

package/dist/domain-events/create-domain-event-invalidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-domain-event-invalidator.d.ts","sourceRoot":"","sources":["../../src/domain-events/create-domain-event-invalidator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAEL,KAAK,EACL,MAAM,EACN,SAAS,EACT,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAEjC;;;GAGG;AACH,MAAM,MAAM,+BAA+B,CAAC,MAAM,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,IAAI;KAC1F,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CACrB,GAAG,EAAE,OAAO,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC,KAAK,CAAC,KACrC,aAAa,CAAC,iBAAiB,CAAC;CACtC,CAAC;AAEF,MAAM,WAAW,sBAAsB,CAAC,MAAM,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE;IACnF,MAAM,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,SAAS,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACzE,0BAA0B;IAC1B,QAAQ,CAAC,OAAO,EAAE;QAChB,KAAK,EAAE,OAAO,KAAK,CAAC;QACpB,MAAM,EAAE,OAAO,MAAM,CAAC;QACtB,SAAS,EAAE,OAAO,SAAS,CAAC;KAC7B,CAAC;IACF,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,+BAA+B,CAAC,MAAM,CAAC,CAAC;CAC5D;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,EACxF,QAAQ,EAAE,+BAA+B,CAAC,MAAM,CAAC,GAChD,sBAAsB,CAAC,MAAM,CAAC,CA4BhC"}

package/dist/domain-events/create-domain-event-invalidator.js

@@ -0,0 +1,31 @@
+import { applyInvalidations, exact, prefix, predicate, } from "./cache-invalidation.js";
+/**
+ * Build a domain-event → cache-invalidation notifier from a typed registry.
+ * The registry's keys are statically tied to `TEvent["type"]`, so missing or
+ * extra entries are compile errors.
+ */
+export function createDomainEventInvalidator(registry) {
+    function lookup(type) {
+        return registry[type];
+    }
+    function notify(queryClient, event) {
+        const fn = lookup(event.type);
+        const invalidations = fn(event.ids);
+        applyInvalidations(queryClient, invalidations);
+    }
+    function notifyAll(queryClient, events) {
+        const all = [];
+        for (const event of events) {
+            const fn = lookup(event.type);
+            all.push(...fn(event.ids));
+        }
+        applyInvalidations(queryClient, all);
+    }
+    return {
+        notify,
+        notifyAll,
+        helpers: { exact, prefix, predicate },
+        registry,
+    };
+}
+//# sourceMappingURL=create-domain-event-invalidator.js.map

package/dist/domain-events/create-domain-event-invalidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-domain-event-invalidator.js","sourceRoot":"","sources":["../../src/domain-events/create-domain-event-invalidator.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,KAAK,EACL,MAAM,EACN,SAAS,GAEV,MAAM,yBAAyB,CAAC;AAyBjC;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,QAAiD;IAEjD,SAAS,MAAM,CAA+B,IAAW;QACvD,OAAO,QAAQ,CAAC,IAAI,CAEiB,CAAC;IACxC,CAAC;IAED,SAAS,MAAM,CAAC,WAAwB,EAAE,KAAa;QACrD,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,IAAsB,CAAC,CAAC;QAChD,MAAM,aAAa,GAAG,EAAE,CAAC,KAAK,CAAC,GAAuD,CAAC,CAAC;QACxF,kBAAkB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACjD,CAAC;IAED,SAAS,SAAS,CAAC,WAAwB,EAAE,MAA6B;QACxE,MAAM,GAAG,GAAwB,EAAE,CAAC;QACpC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,IAAsB,CAAC,CAAC;YAChD,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAuD,CAAC,CAAC,CAAC;QACjF,CAAC;QACD,kBAAkB,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,OAAO;QACL,MAAM;QACN,SAAS;QACT,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE;QACrC,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/domain-events/index.d.ts

@@ -0,0 +1,5 @@
+export { exact, prefix, predicate, serializeInvalidation, applyInvalidations, } from "./cache-invalidation.js";
+export type { CacheInvalidation, RefetchType } from "./cache-invalidation.js";
+export { createDomainEventInvalidator } from "./create-domain-event-invalidator.js";
+export type { DomainEventInvalidator, DomainEventInvalidationRegistry, } from "./create-domain-event-invalidator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/domain-events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain-events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,MAAM,EACN,SAAS,EACT,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACpF,YAAY,EACV,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,sCAAsC,CAAC"}

package/dist/domain-events/index.js

@@ -0,0 +1,3 @@
+export { exact, prefix, predicate, serializeInvalidation, applyInvalidations, } from "./cache-invalidation.js";
+export { createDomainEventInvalidator } from "./create-domain-event-invalidator.js";
+//# sourceMappingURL=index.js.map

package/dist/domain-events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain-events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,MAAM,EACN,SAAS,EACT,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/firestore/types.d.ts

@@ -39,7 +39,7 @@ export interface FirestoreDocOptions<T> extends FirestoreBaseOptions {
  * Options for collection queries.
  */
 export interface FirestoreCollectionOptions<T> extends FirestoreBaseOptions {
-    /** Collection path (e.g., 'users' or 'projects/abc/members') */
+    /** Collection path (e.g., 'users' or 'entities/abc/members') */
     collectionPath: string;
     /** Firestore query constraints (where, orderBy, etc.) */
     constraints?: QueryConstraint[];

package/dist/index.d.ts

@@ -7,4 +7,6 @@ export type { WithId, FirestoreBaseOptions, FirestoreDocOptions, FirestoreCollec
 export { docWithId } from './firestore/types.js';
 export { flattenInfiniteData, getInfiniteDataCount, } from './firestore/infinite-helpers.js';
 export type { FirestoreSearchConfig, FirestoreSearchOptions, } from './search/types.js';
+export { createDomainEventInvalidator, exact, prefix, predicate, serializeInvalidation, applyInvalidations, } from "./domain-events/index.js";
+export type { DomainEventInvalidator, DomainEventInvalidationRegistry, CacheInvalidation, RefetchType, } from "./domain-events/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAGlE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG1C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGzF,YAAY,EACV,MAAM,EACN,oBAAoB,EACpB,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,iCAAiC,CAAC;AAGzC,YAAY,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAGlE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG1C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGzF,YAAY,EACV,MAAM,EACN,oBAAoB,EACpB,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,iCAAiC,CAAC;AAGzC,YAAY,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,4BAA4B,EAC5B,KAAK,EACL,MAAM,EACN,SAAS,EACT,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,sBAAsB,EACtB,+BAA+B,EAC/B,iBAAiB,EACjB,WAAW,GACZ,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -6,4 +6,6 @@ export { keys, createKeyScope } from './keys.js';
 export { invalidateByPrefix, removeByPrefix, updateQueryData } from './cache-helpers.js';
 export { docWithId } from './firestore/types.js';
 export { flattenInfiniteData, getInfiniteDataCount, } from './firestore/infinite-helpers.js';
+// Domain-event invalidator (mechanism — consumers register their event registry)
+export { createDomainEventInvalidator, exact, prefix, predicate, serializeInvalidation, applyInvalidations, } from "./domain-events/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,aAAa;AACb,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGjD,gBAAgB;AAChB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAgBzF,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,aAAa;AACb,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGjD,gBAAgB;AAChB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAgBzF,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,iCAAiC,CAAC;AAQzC,iFAAiF;AACjF,OAAO,EACL,4BAA4B,EAC5B,KAAK,EACL,MAAM,EACN,SAAS,EACT,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC"}

package/dist/keys.d.ts

@@ -37,7 +37,7 @@ export declare const keys: {
         readonly list: (param?: SerializedKeyPart) => QueryKey;
         readonly custom: (...parts: SerializedKeyPart[]) => QueryKey;
     };
-    readonly projects: {
+    readonly entities: {
         readonly all: QueryKey;
         readonly detail: (id: string) => QueryKey;
         readonly list: (param?: SerializedKeyPart) => QueryKey;

package/dist/keys.js

@@ -21,11 +21,11 @@ export const keys = {
         list: (param) => withScope('skills', 'list', param),
         custom: (...parts) => withScope('skills', ...parts),
     },
-    projects: {
-        all: withScope('projects'),
-        detail: (id) => withScope('projects', 'detail', id),
-        list: (param) => withScope('projects', 'list', param),
-        custom: (...parts) => withScope('projects', ...parts),
+    entities: {
+        all: withScope('entities'),
+        detail: (id) => withScope('entities', 'detail', id),
+        list: (param) => withScope('entities', 'list', param),
+        custom: (...parts) => withScope('entities', ...parts),
     },
     messages: {
         all: withScope('messages'),

package/dist/react/firestore/use-firestore-collection.d.ts

@@ -7,16 +7,16 @@ import type { FirestoreCollectionOptions, WithId } from '../../firestore/types.j
  * For large collections, use useFirestoreInfinite or useFirestorePaginated.
  * * @example
  * ```tsx
- * // Fetch all channels in a project
+ * // Fetch all channels in an entity
  * const { data: channels } = useFirestoreCollection<Channel>({
- * collectionPath: `projects/${projectId}/channels`,
- * queryKey: ['channels', projectId],
+ * collectionPath: `entities/${entityId}/channels`,
+ * queryKey: ['channels', entityId],
  * constraints: [orderBy('createdAt', 'asc')],
  * });
  * * // With realtime updates
  * const { data: members } = useFirestoreCollection<Member>({
- * collectionPath: `projects/${projectId}/members`,
- * queryKey: ['members', projectId],
+ * collectionPath: `entities/${entityId}/members`,
+ * queryKey: ['members', entityId],
  * subscribe: true,
  * });
  * ```

package/dist/react/firestore/use-firestore-collection.js

@@ -9,16 +9,16 @@ import { useFirestoreDb } from './context.js';
  * For large collections, use useFirestoreInfinite or useFirestorePaginated.
  * * @example
  * ```tsx
- * // Fetch all channels in a project
+ * // Fetch all channels in an entity
  * const { data: channels } = useFirestoreCollection<Channel>({
- * collectionPath: `projects/${projectId}/channels`,
- * queryKey: ['channels', projectId],
+ * collectionPath: `entities/${entityId}/channels`,
+ * queryKey: ['channels', entityId],
  * constraints: [orderBy('createdAt', 'asc')],
  * });
  * * // With realtime updates
  * const { data: members } = useFirestoreCollection<Member>({
- * collectionPath: `projects/${projectId}/members`,
- * queryKey: ['members', projectId],
+ * collectionPath: `entities/${entityId}/members`,
+ * queryKey: ['members', entityId],
  * subscribe: true,
  * });
  * ```

package/dist/react/firestore/use-firestore-doc.d.ts

@@ -11,9 +11,9 @@ import type { FirestoreDocOptions, WithId } from '../../firestore/types.js';
  * queryKey: ['user', userId],
  * });
  * * // With realtime updates
- * const { data: project } = useFirestoreDoc<Project>({
- * docPath: `projects/${projectId}`,
- * queryKey: ['project', projectId],
+ * const { data: entity } = useFirestoreDoc<Entity>({
+ * docPath: `entities/${entityId}`,
+ * queryKey: ['entity', entityId],
  * subscribe: true,
  * });
  * * // Conditional fetch

package/dist/react/firestore/use-firestore-doc.js

@@ -13,9 +13,9 @@ import { useFirestoreDb } from './context.js';
  * queryKey: ['user', userId],
  * });
  * * // With realtime updates
- * const { data: project } = useFirestoreDoc<Project>({
- * docPath: `projects/${projectId}`,
- * queryKey: ['project', projectId],
+ * const { data: entity } = useFirestoreDoc<Entity>({
+ * docPath: `entities/${entityId}`,
+ * queryKey: ['entity', entityId],
  * subscribe: true,
  * });
  * * // Conditional fetch

package/dist/react/firestore/useBatchFirestoreDocs.d.ts

@@ -5,7 +5,7 @@ export type BatchFirestoreDocsOptions = {
      */
     db: Firestore;
     /**
-     * Full collection path (e.g., 'publicUsers', 'projects/public')
+     * Full collection path (e.g., 'publicUsers', 'entities/public')
      */
     collectionPath: string;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ttt-productions/query-core",
-    "version": "0.4.6",
+    "version": "0.6.0",
     "description": "Shared TanStack Query (React Query) client defaults, query key helpers, and Firestore integration hooks for TTT Productions apps",
     "repository": {
         "type": "git",