covara 0.0.1 → 0.6.0

package/dist/client/query-builder.d.ts

@@ -0,0 +1,130 @@
+export type Primitive = string | number | boolean | Date | null;
+export interface QueryBuilder {
+    eq: (field: string, value: unknown) => string;
+    neq: (field: string, value: unknown) => string;
+    gt: (field: string, value: number | Date | string) => string;
+    gte: (field: string, value: number | Date | string) => string;
+    lt: (field: string, value: number | Date | string) => string;
+    lte: (field: string, value: number | Date | string) => string;
+    like: (field: string, pattern: string) => string;
+    notLike: (field: string, pattern: string) => string;
+    ilike: (field: string, pattern: string) => string;
+    in: (field: string, values: unknown[]) => string;
+    out: (field: string, values: unknown[]) => string;
+    isNull: (field: string) => string;
+    isNotNull: (field: string) => string;
+    and: (...conditions: string[]) => string;
+    or: (...conditions: string[]) => string;
+    startsWith: (field: string, prefix: string) => string;
+    endsWith: (field: string, suffix: string) => string;
+    contains: (field: string, substring: string) => string;
+    icontains: (field: string, substring: string) => string;
+    between: (field: string, min: number | Date | string, max: number | Date | string) => string;
+    raw: (expression: string) => string;
+}
+export declare const q: QueryBuilder;
+export declare class QueryBuilderChain {
+    private fieldPrefix;
+    private conditions;
+    private combinator;
+    constructor(fieldPrefix?: string);
+    private getField;
+    eq(field: string, value: unknown): this;
+    neq(field: string, value: unknown): this;
+    gt(field: string, value: number | Date | string): this;
+    gte(field: string, value: number | Date | string): this;
+    lt(field: string, value: number | Date | string): this;
+    lte(field: string, value: number | Date | string): this;
+    like(field: string, pattern: string): this;
+    in(field: string, values: unknown[]): this;
+    out(field: string, values: unknown[]): this;
+    isNull(field: string): this;
+    isNotNull(field: string): this;
+    startsWith(field: string, prefix: string): this;
+    endsWith(field: string, suffix: string): this;
+    contains(field: string, substring: string): this;
+    between(field: string, min: number | Date | string, max: number | Date | string): this;
+    and(condition: string | QueryBuilderChain): this;
+    or(condition: string | QueryBuilderChain): this;
+    raw(expression: string): this;
+    build(): string;
+    toString(): string;
+}
+export declare const createQueryBuilder: (fieldPrefix?: string) => QueryBuilderChain;
+export declare const where: (fieldPrefix?: string) => QueryBuilderChain;
+export interface FieldBuilder<T extends Primitive = Primitive> {
+    eq: (value: T) => string;
+    neq: (value: T) => string;
+    gt: (value: NonNullable<T>) => string;
+    gte: (value: NonNullable<T>) => string;
+    lt: (value: NonNullable<T>) => string;
+    lte: (value: NonNullable<T>) => string;
+    in: (values: NonNullable<T>[]) => string;
+    out: (values: NonNullable<T>[]) => string;
+    isNull: () => string;
+    isNotNull: () => string;
+    like: (pattern: string) => string;
+    contains: (substring: string) => string;
+    startsWith: (prefix: string) => string;
+    endsWith: (suffix: string) => string;
+    between: (min: NonNullable<T>, max: NonNullable<T>) => string;
+}
+export declare const createFieldBuilder: <T extends Primitive = Primitive>(fieldName: string) => FieldBuilder<T>;
+export type TypedQueryBuilder<T> = {
+    [K in keyof T]-?: [Extract<T[K], Primitive>] extends [never] ? FieldBuilder : FieldBuilder<Extract<T[K], Primitive>>;
+};
+export declare const createTypedQueryBuilder: <T extends object>(fields?: (keyof T)[]) => TypedQueryBuilder<T>;
+export interface IncludeOptions {
+    select?: string[];
+    limit?: number;
+}
+export interface IncludeConfig {
+    name: string;
+    options?: IncludeOptions;
+}
+export declare const include: (...relations: (string | IncludeConfig)[]) => string;
+export declare const withSelect: (name: string, select: string[]) => IncludeConfig;
+export declare const withLimit: (name: string, limit: number) => IncludeConfig;
+export declare const withOptions: (name: string, options: IncludeOptions) => IncludeConfig;
+export declare class IncludeBuilder {
+    private configs;
+    add(name: string, options?: IncludeOptions): this;
+    select(name: string, fields: string[]): this;
+    limit(name: string, max: number): this;
+    build(): string;
+    toString(): string;
+}
+export declare const createIncludeBuilder: () => IncludeBuilder;
+type FieldType<T, K extends keyof T> = Extract<T[K], Primitive>;
+export interface TypedFilter<T> {
+    eq<K extends keyof T>(field: K, value: FieldType<T, K>): string;
+    neq<K extends keyof T>(field: K, value: FieldType<T, K>): string;
+    gt<K extends keyof T>(field: K, value: NonNullable<FieldType<T, K>>): string;
+    gte<K extends keyof T>(field: K, value: NonNullable<FieldType<T, K>>): string;
+    lt<K extends keyof T>(field: K, value: NonNullable<FieldType<T, K>>): string;
+    lte<K extends keyof T>(field: K, value: NonNullable<FieldType<T, K>>): string;
+    in<K extends keyof T>(field: K, values: NonNullable<FieldType<T, K>>[]): string;
+    out<K extends keyof T>(field: K, values: NonNullable<FieldType<T, K>>[]): string;
+    isNull<K extends keyof T>(field: K): string;
+    isNotNull<K extends keyof T>(field: K): string;
+    like<K extends keyof T>(field: K, pattern: string): string;
+    contains<K extends keyof T>(field: K, substring: string): string;
+    startsWith<K extends keyof T>(field: K, prefix: string): string;
+    endsWith<K extends keyof T>(field: K, suffix: string): string;
+    between<K extends keyof T>(field: K, min: NonNullable<FieldType<T, K>>, max: NonNullable<FieldType<T, K>>): string;
+    and(...conditions: string[]): string;
+    or(...conditions: string[]): string;
+    raw(expression: string): string;
+}
+/**
+ * Typed RSQL filter builder. Field names are validated against `keyof T` and
+ * value types are checked against the field type, while `raw()` remains an
+ * escape hatch for arbitrary expressions.
+ *
+ * @example
+ * const filter = f<Todo>().eq("completed", true); // 'completed==true'
+ */
+export declare const createTypedFilter: <T>() => TypedFilter<T>;
+export declare const f: <T>() => TypedFilter<T>;
+export default q;
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/client/query-builder.d.ts.map

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

package/dist/client/query-builder.js

@@ -0,0 +1,300 @@
+const escapeValue = (value) => {
+    if (value === null) {
+        return "null";
+    }
+    if (typeof value === "string") {
+        const escaped = value
+            .replace(/\\/g, "\\\\")
+            .replace(/"/g, '\\"');
+        return `"${escaped}"`;
+    }
+    if (typeof value === "number") {
+        return String(value);
+    }
+    if (typeof value === "boolean") {
+        return String(value);
+    }
+    if (value instanceof Date) {
+        return `"${value.toISOString()}"`;
+    }
+    return String(value);
+};
+const escapeForArray = (values) => {
+    return values.map(escapeValue).join(",");
+};
+export const q = {
+    eq: (field, value) => `${field}==${escapeValue(value)}`,
+    neq: (field, value) => `${field}!=${escapeValue(value)}`,
+    gt: (field, value) => `${field}>${escapeValue(value)}`,
+    gte: (field, value) => `${field}>=${escapeValue(value)}`,
+    lt: (field, value) => `${field}<${escapeValue(value)}`,
+    lte: (field, value) => `${field}<=${escapeValue(value)}`,
+    like: (field, pattern) => `${field}%=${escapeValue(pattern)}`,
+    notLike: (field, pattern) => `${field}!%=${escapeValue(pattern)}`,
+    ilike: (field, pattern) => `${field}=ilike=${escapeValue(pattern)}`,
+    in: (field, values) => `${field}=in=(${escapeForArray(values)})`,
+    out: (field, values) => `${field}=out=(${escapeForArray(values)})`,
+    isNull: (field) => `${field}=isnull=true`,
+    isNotNull: (field) => `${field}=isnull=false`,
+    and: (...conditions) => {
+        const filtered = conditions.filter(Boolean);
+        if (filtered.length === 0)
+            return "";
+        if (filtered.length === 1)
+            return filtered[0];
+        return filtered.map((c) => `(${c})`).join(";");
+    },
+    or: (...conditions) => {
+        const filtered = conditions.filter(Boolean);
+        if (filtered.length === 0)
+            return "";
+        if (filtered.length === 1)
+            return filtered[0];
+        return filtered.map((c) => `(${c})`).join(",");
+    },
+    startsWith: (field, prefix) => `${field}=startswith=${escapeValue(prefix)}`,
+    endsWith: (field, suffix) => `${field}=endswith=${escapeValue(suffix)}`,
+    contains: (field, substring) => `${field}=contains=${escapeValue(substring)}`,
+    icontains: (field, substring) => `${field}=icontains=${escapeValue(substring)}`,
+    between: (field, min, max) => q.and(q.gte(field, min), q.lte(field, max)),
+    raw: (expression) => expression,
+};
+export class QueryBuilderChain {
+    constructor(fieldPrefix = "") {
+        this.fieldPrefix = fieldPrefix;
+        this.conditions = [];
+        this.combinator = "and";
+    }
+    getField(field) {
+        return this.fieldPrefix ? `${this.fieldPrefix}.${field}` : field;
+    }
+    eq(field, value) {
+        this.conditions.push(q.eq(this.getField(field), value));
+        return this;
+    }
+    neq(field, value) {
+        this.conditions.push(q.neq(this.getField(field), value));
+        return this;
+    }
+    gt(field, value) {
+        this.conditions.push(q.gt(this.getField(field), value));
+        return this;
+    }
+    gte(field, value) {
+        this.conditions.push(q.gte(this.getField(field), value));
+        return this;
+    }
+    lt(field, value) {
+        this.conditions.push(q.lt(this.getField(field), value));
+        return this;
+    }
+    lte(field, value) {
+        this.conditions.push(q.lte(this.getField(field), value));
+        return this;
+    }
+    like(field, pattern) {
+        this.conditions.push(q.like(this.getField(field), pattern));
+        return this;
+    }
+    in(field, values) {
+        this.conditions.push(q.in(this.getField(field), values));
+        return this;
+    }
+    out(field, values) {
+        this.conditions.push(q.out(this.getField(field), values));
+        return this;
+    }
+    isNull(field) {
+        this.conditions.push(q.isNull(this.getField(field)));
+        return this;
+    }
+    isNotNull(field) {
+        this.conditions.push(q.isNotNull(this.getField(field)));
+        return this;
+    }
+    startsWith(field, prefix) {
+        this.conditions.push(q.startsWith(this.getField(field), prefix));
+        return this;
+    }
+    endsWith(field, suffix) {
+        this.conditions.push(q.endsWith(this.getField(field), suffix));
+        return this;
+    }
+    contains(field, substring) {
+        this.conditions.push(q.contains(this.getField(field), substring));
+        return this;
+    }
+    between(field, min, max) {
+        this.conditions.push(q.between(this.getField(field), min, max));
+        return this;
+    }
+    and(condition) {
+        if (condition instanceof QueryBuilderChain) {
+            this.conditions.push(condition.build());
+        }
+        else {
+            this.conditions.push(condition);
+        }
+        return this;
+    }
+    or(condition) {
+        if (this.conditions.length > 0 && this.combinator === "and") {
+            const previous = this.conditions.join(";");
+            this.conditions = [previous];
+        }
+        this.combinator = "or";
+        if (condition instanceof QueryBuilderChain) {
+            this.conditions.push(condition.build());
+        }
+        else {
+            this.conditions.push(condition);
+        }
+        return this;
+    }
+    raw(expression) {
+        this.conditions.push(expression);
+        return this;
+    }
+    build() {
+        if (this.conditions.length === 0)
+            return "";
+        if (this.conditions.length === 1)
+            return this.conditions[0];
+        if (this.combinator === "or") {
+            return q.or(...this.conditions);
+        }
+        return q.and(...this.conditions);
+    }
+    toString() {
+        return this.build();
+    }
+}
+export const createQueryBuilder = (fieldPrefix) => {
+    return new QueryBuilderChain(fieldPrefix);
+};
+export const where = createQueryBuilder;
+export const createFieldBuilder = (fieldName) => {
+    return {
+        eq: (value) => q.eq(fieldName, value),
+        neq: (value) => q.neq(fieldName, value),
+        gt: (value) => q.gt(fieldName, value),
+        gte: (value) => q.gte(fieldName, value),
+        lt: (value) => q.lt(fieldName, value),
+        lte: (value) => q.lte(fieldName, value),
+        in: (values) => q.in(fieldName, values),
+        out: (values) => q.out(fieldName, values),
+        isNull: () => q.isNull(fieldName),
+        isNotNull: () => q.isNotNull(fieldName),
+        like: (pattern) => q.like(fieldName, pattern),
+        contains: (substring) => q.contains(fieldName, substring),
+        startsWith: (prefix) => q.startsWith(fieldName, prefix),
+        endsWith: (suffix) => q.endsWith(fieldName, suffix),
+        between: (min, max) => q.between(fieldName, min, max),
+    };
+};
+export const createTypedQueryBuilder = (fields) => {
+    // If fields are provided, create explicit builder
+    if (fields) {
+        const builder = {};
+        for (const field of fields) {
+            builder[field] = createFieldBuilder(String(field));
+        }
+        return builder;
+    }
+    // Otherwise, use Proxy for dynamic field access
+    return new Proxy({}, {
+        get(_target, prop) {
+            return createFieldBuilder(prop);
+        },
+    });
+};
+const buildIncludeString = (configs) => {
+    return configs
+        .map(({ name, options }) => {
+        if (!options || (options.select === undefined && options.limit === undefined)) {
+            return name;
+        }
+        const parts = [];
+        if (options.select && options.select.length > 0) {
+            parts.push(`select:${options.select.join(",")}`);
+        }
+        if (options.limit !== undefined) {
+            parts.push(`limit:${options.limit}`);
+        }
+        return `${name}(${parts.join(";")})`;
+    })
+        .join(",");
+};
+export const include = (...relations) => {
+    const configs = relations.map((r) => typeof r === "string" ? { name: r } : r);
+    return buildIncludeString(configs);
+};
+export const withSelect = (name, select) => ({
+    name,
+    options: { select },
+});
+export const withLimit = (name, limit) => ({
+    name,
+    options: { limit },
+});
+export const withOptions = (name, options) => ({
+    name,
+    options,
+});
+export class IncludeBuilder {
+    constructor() {
+        this.configs = [];
+    }
+    add(name, options) {
+        this.configs.push({ name, options });
+        return this;
+    }
+    select(name, fields) {
+        this.configs.push({ name, options: { select: fields } });
+        return this;
+    }
+    limit(name, max) {
+        this.configs.push({ name, options: { limit: max } });
+        return this;
+    }
+    build() {
+        return buildIncludeString(this.configs);
+    }
+    toString() {
+        return this.build();
+    }
+}
+export const createIncludeBuilder = () => {
+    return new IncludeBuilder();
+};
+/**
+ * Typed RSQL filter builder. Field names are validated against `keyof T` and
+ * value types are checked against the field type, while `raw()` remains an
+ * escape hatch for arbitrary expressions.
+ *
+ * @example
+ * const filter = f<Todo>().eq("completed", true); // 'completed==true'
+ */
+export const createTypedFilter = () => ({
+    eq: (field, value) => q.eq(String(field), value),
+    neq: (field, value) => q.neq(String(field), value),
+    gt: (field, value) => q.gt(String(field), value),
+    gte: (field, value) => q.gte(String(field), value),
+    lt: (field, value) => q.lt(String(field), value),
+    lte: (field, value) => q.lte(String(field), value),
+    in: (field, values) => q.in(String(field), values),
+    out: (field, values) => q.out(String(field), values),
+    isNull: (field) => q.isNull(String(field)),
+    isNotNull: (field) => q.isNotNull(String(field)),
+    like: (field, pattern) => q.like(String(field), pattern),
+    contains: (field, substring) => q.contains(String(field), substring),
+    startsWith: (field, prefix) => q.startsWith(String(field), prefix),
+    endsWith: (field, suffix) => q.endsWith(String(field), suffix),
+    between: (field, min, max) => q.between(String(field), min, max),
+    and: (...conditions) => q.and(...conditions),
+    or: (...conditions) => q.or(...conditions),
+    raw: (expression) => q.raw(expression),
+});
+export const f = createTypedFilter;
+export default q;
+//# sourceMappingURL=query-builder.js.map

package/dist/client/query-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.js","sourceRoot":"","sources":["../../src/client/query-builder.ts"],"names":[],"mappings":"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"}

package/dist/client/query-cache.d.ts

@@ -0,0 +1,64 @@
+import { LiveQuery, LiveQueryOptions } from "./live-store.js";
+import type { LiveListResourceClient } from "./types.js";
+export interface CachedQueryEntry<T extends {
+    id: string;
+} = {
+    id: string;
+}> {
+    path: string;
+    options: LiveQueryOptions;
+    query: LiveQuery<T>;
+    refCount: number;
+}
+export type InvalidatePredicate = (path: string, options: LiveQueryOptions) => boolean;
+export type InvalidateTarget = string | InvalidatePredicate;
+interface LiveQueryFactoryCallbacks {
+    onAuthError?: () => void;
+    getPendingCount?: () => Promise<number>;
+    onIdRemapped?: (optimisticId: string, serverId: string) => void;
+    getIdMappings?: () => Map<string, string>;
+    hasPendingMutationsForId?: (id: string) => Promise<boolean>;
+}
+/**
+ * Registry of live queries keyed by path + options. Backs `client.invalidate`
+ * and `client.prefetch`: it dedupes identical queries (ref-counted), lets the
+ * client mark matching stores stale and refetch them, and lets callers warm the
+ * cache before a component reads it.
+ */
+export declare class LiveQueryCache {
+    private entries;
+    private resolveRepo;
+    private callbacks;
+    constructor(config: {
+        resolveRepo: <T extends {
+            id: string;
+        }>(path: string) => LiveListResourceClient<T>;
+        callbacks?: LiveQueryFactoryCallbacks;
+    });
+    /** Acquire (or create) a shared live query and bump its ref count. */
+    acquire<T extends {
+        id: string;
+    }>(path: string, options?: LiveQueryOptions): LiveQuery<T>;
+    /** Release a previously-acquired query; destroys it when the last holder leaves. */
+    release(path: string, options?: LiveQueryOptions): void;
+    /** Peek an already-cached query without acquiring a reference. */
+    peek<T extends {
+        id: string;
+    }>(path: string, options?: LiveQueryOptions): LiveQuery<T> | undefined;
+    has(path: string, options?: LiveQueryOptions): boolean;
+    /**
+     * Warm the cache for a path/options without a component mounting. The created
+     * query is held with refCount 0 so it persists until explicitly invalidated or
+     * acquired; a later `acquire` reuses it so the first read is immediate.
+     */
+    prefetch<T extends {
+        id: string;
+    }>(path: string, options?: LiveQueryOptions): Promise<LiveQuery<T>>;
+    /** Mark matching queries stale and refetch them. Returns the count refreshed. */
+    invalidate(target: InvalidateTarget): number;
+    /** Destroy every cached query (used on client teardown). */
+    destroyAll(): void;
+    size(): number;
+}
+export {};
+//# sourceMappingURL=query-cache.d.ts.map

package/dist/client/query-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-cache.d.ts","sourceRoot":"","sources":["../../src/client/query-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,gBAAgB,CAAC;IAC1B,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC;AACvF,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,mBAAmB,CAAC;AAE5D,UAAU,yBAAyB;IACjC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,wBAAwB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7D;AAoBD;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,WAAW,CAAwE;IAC3F,OAAO,CAAC,SAAS,CAA4B;gBAEjC,MAAM,EAAE;QAClB,WAAW,EAAE,CAAC,CAAC,SAAS;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,EAAE,IAAI,EAAE,MAAM,KAAK,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACnF,SAAS,CAAC,EAAE,yBAAyB,CAAC;KACvC;IAKD,sEAAsE;IACtE,OAAO,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,gBAAqB,GAC7B,SAAS,CAAC,CAAC,CAAC;IAmBf,oFAAoF;IACpF,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,IAAI;IAW3D,kEAAkE;IAClE,IAAI,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,gBAAqB,GAC7B,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS;IAK3B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO;IAI1D;;;;OAIG;IACG,QAAQ,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EACrC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAmBxB,iFAAiF;IACjF,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM;IAW5C,4DAA4D;IAC5D,UAAU,IAAI,IAAI;IAOlB,IAAI,IAAI,MAAM;CAGf"}

package/dist/client/query-cache.js

@@ -0,0 +1,112 @@
+import { createLiveQuery } from "./live-store.js";
+const stableKey = (path, options) => `${path}::${JSON.stringify({
+    filter: options.filter ?? null,
+    include: options.include ?? null,
+    orderBy: options.orderBy ?? null,
+    limit: options.limit ?? null,
+    select: options.select ?? null,
+    subscriptionMode: options.subscriptionMode ?? null,
+})}`;
+const matches = (entry, target) => {
+    if (typeof target === "function") {
+        return target(entry.path, entry.options);
+    }
+    // String: exact path or prefix match (e.g. "/api/todos" matches "/api/todos").
+    return entry.path === target || entry.path.startsWith(target);
+};
+/**
+ * Registry of live queries keyed by path + options. Backs `client.invalidate`
+ * and `client.prefetch`: it dedupes identical queries (ref-counted), lets the
+ * client mark matching stores stale and refetch them, and lets callers warm the
+ * cache before a component reads it.
+ */
+export class LiveQueryCache {
+    constructor(config) {
+        this.entries = new Map();
+        this.resolveRepo = config.resolveRepo;
+        this.callbacks = config.callbacks ?? {};
+    }
+    /** Acquire (or create) a shared live query and bump its ref count. */
+    acquire(path, options = {}) {
+        const key = stableKey(path, options);
+        const existing = this.entries.get(key);
+        if (existing) {
+            existing.refCount += 1;
+            return existing.query;
+        }
+        const repo = this.resolveRepo(path);
+        const query = createLiveQuery(repo, options, this.callbacks);
+        this.entries.set(key, {
+            path,
+            options,
+            query: query,
+            refCount: 1,
+        });
+        return query;
+    }
+    /** Release a previously-acquired query; destroys it when the last holder leaves. */
+    release(path, options = {}) {
+        const key = stableKey(path, options);
+        const entry = this.entries.get(key);
+        if (!entry)
+            return;
+        entry.refCount -= 1;
+        if (entry.refCount <= 0) {
+            entry.query.destroy();
+            this.entries.delete(key);
+        }
+    }
+    /** Peek an already-cached query without acquiring a reference. */
+    peek(path, options = {}) {
+        const entry = this.entries.get(stableKey(path, options));
+        return entry?.query;
+    }
+    has(path, options = {}) {
+        return this.entries.has(stableKey(path, options));
+    }
+    /**
+     * Warm the cache for a path/options without a component mounting. The created
+     * query is held with refCount 0 so it persists until explicitly invalidated or
+     * acquired; a later `acquire` reuses it so the first read is immediate.
+     */
+    async prefetch(path, options = {}) {
+        const key = stableKey(path, options);
+        const existing = this.entries.get(key);
+        if (existing) {
+            await existing.query.refresh();
+            return existing.query;
+        }
+        const repo = this.resolveRepo(path);
+        const query = createLiveQuery(repo, options, this.callbacks);
+        this.entries.set(key, {
+            path,
+            options,
+            query: query,
+            refCount: 0,
+        });
+        await query.refresh();
+        return query;
+    }
+    /** Mark matching queries stale and refetch them. Returns the count refreshed. */
+    invalidate(target) {
+        let count = 0;
+        for (const entry of this.entries.values()) {
+            if (matches(entry, target)) {
+                count += 1;
+                void entry.query.refresh();
+            }
+        }
+        return count;
+    }
+    /** Destroy every cached query (used on client teardown). */
+    destroyAll() {
+        for (const entry of this.entries.values()) {
+            entry.query.destroy();
+        }
+        this.entries.clear();
+    }
+    size() {
+        return this.entries.size;
+    }
+}
+//# sourceMappingURL=query-cache.js.map

package/dist/client/query-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-cache.js","sourceRoot":"","sources":["../../src/client/query-cache.ts"],"names":[],"mappings":"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"}