ngx-zero 0.1.0

package/dist/instance-manager.js

@@ -0,0 +1,140 @@
+import { computed, DestroyRef, effect, EnvironmentInjector, ErrorHandler, inject, InjectionToken, runInInjectionContext, signal, untracked, } from '@angular/core';
+import { Zero } from '@rocicorp/zero';
+import { ngxZeroError } from './errors.js';
+import { diffZeroOptions, isExternalSource } from './options-diff.js';
+import { tryCatch } from './utils.js';
+export const ZERO_INSTANCE = new InjectionToken('ngx-zero/instance-manager');
+export const ZERO_CONSTRUCTOR = new InjectionToken('ngx-zero/zero-constructor', { providedIn: 'root', factory: () => options => new Zero(options) });
+export const ZERO_INSTANCE_HOOKS = new InjectionToken('ngx-zero/instance-hooks');
+function resolveSourceFactory(source) {
+    return typeof source === 'function' ? source : () => source;
+}
+export class ZeroInstanceManager {
+    #injector = inject(EnvironmentInjector);
+    #constructZero = inject(ZERO_CONSTRUCTOR);
+    #featureHooks = inject(ZERO_INSTANCE_HOOKS, { optional: true }) ?? [];
+    #errorHandler = inject(ErrorHandler);
+    #sourceFactory;
+    #source = computed(() => runInInjectionContext(this.#injector, this.#sourceFactory));
+    #zeroInstance = signal(undefined);
+    zeroOrThrow = computed(() => {
+        const zero = this.#zeroInstance();
+        if (zero === undefined) {
+            throw ngxZeroError('Zero instance not found. Call `start()` first.');
+        }
+        return zero;
+    });
+    #started = false;
+    #rotationPending = false;
+    #rotationGeneration = signal(0);
+    #detach;
+    constructor(source) {
+        this.#sourceFactory = resolveSourceFactory(source);
+        inject(DestroyRef).onDestroy(() => this.#destroy());
+    }
+    start() {
+        if (this.#started) {
+            throw ngxZeroError('Zero instance manager already started.');
+        }
+        this.#started = true;
+        // Reconcile synchronously so component field initializers can use the
+        // instance; the effect reacts only to later changes and rotations.
+        let previousSource = this.#source();
+        this.#reconcile(previousSource, undefined);
+        effect(() => {
+            const source = this.#source();
+            this.#rotationGeneration();
+            if (source === previousSource && !this.#rotationPending) {
+                return;
+            }
+            const previous = previousSource;
+            previousSource = source;
+            untracked(() => this.#reconcile(source, previous));
+        }, { injector: this.#injector });
+    }
+    #connect({ auth }) {
+        const zero = this.#zeroInstance();
+        if (!zero || !auth) {
+            return;
+        }
+        void zero.connection.connect({ auth });
+    }
+    #reconcile(next, previous) {
+        const instance = this.#zeroInstance();
+        if (isExternalSource(next)) {
+            this.#rotationPending = false;
+            if (instance !== next.zero) {
+                this.#setInstance(next.zero, { isExternal: true });
+            }
+            return;
+        }
+        if (instance === undefined ||
+            previous === undefined ||
+            isExternalSource(previous) ||
+            this.#rotationPending) {
+            return this.#createInstance(next);
+        }
+        const verdict = diffZeroOptions(previous, next);
+        if (verdict === 'recreate') {
+            return this.#createInstance(next);
+        }
+        if (verdict === 'connect') {
+            return this.#connect(next);
+        }
+    }
+    #runInstanceCreatedHooks(zero) {
+        for (const hook of this.#featureHooks) {
+            runInInjectionContext(this.#injector, () => hook.onInstanceCreated?.(zero));
+        }
+    }
+    #createInstance(options) {
+        const zeroOptions = this.#prepareZeroOptions(options);
+        const { result: zero, error } = tryCatch(() => this.#constructZero(zeroOptions));
+        if (error) {
+            return this.#errorHandler.handleError(error);
+        }
+        this.#setInstance(zero);
+    }
+    #setInstance(zero, options = {}) {
+        const { isExternal = false } = options;
+        this.#destroy();
+        this.#zeroInstance.set(zero);
+        this.#rotationPending = false;
+        if (!isExternal) {
+            this.#detach = () => {
+                void zero.close();
+            };
+            this.#runInstanceCreatedHooks(zero);
+        }
+    }
+    #prepareZeroOptions(options) {
+        return {
+            ...options,
+            onClientStateNotFound: this.#onClientStateNotFound(options),
+        };
+    }
+    #onClientStateNotFound(options) {
+        return () => {
+            if (this.#rotationPending) {
+                return;
+            }
+            if (options.onClientStateNotFound) {
+                tryCatch(() => options.onClientStateNotFound?.());
+                return;
+            }
+            this.#scheduleRotation();
+        };
+    }
+    #scheduleRotation() {
+        if (this.#rotationPending) {
+            return;
+        }
+        this.#rotationPending = true;
+        this.#rotationGeneration.update(generation => generation + 1);
+    }
+    #destroy() {
+        this.#detach?.();
+        this.#detach = undefined;
+    }
+}
+//# sourceMappingURL=instance-manager.js.map

package/dist/instance-manager.js.map

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

package/dist/mutator-call-tracker.d.ts

@@ -0,0 +1,16 @@
+import { type Signal } from '@angular/core';
+import type { MutatorResultDetails } from '@rocicorp/zero';
+import type { MutatorError } from './mutator-ref.js';
+export declare class MutatorCallTracker {
+    #private;
+    readonly clientPending: Signal<boolean>;
+    readonly pending: Signal<boolean>;
+    readonly clientResult: Signal<MutatorResultDetails | undefined>;
+    readonly serverResult: Signal<MutatorResultDetails | undefined>;
+    readonly error: Signal<MutatorError | undefined>;
+    begin(): number;
+    settleClient(callId: number, details: MutatorResultDetails): void;
+    settleServer(callId: number, details: MutatorResultDetails): void;
+    destroy(): void;
+}
+//# sourceMappingURL=mutator-call-tracker.d.ts.map

package/dist/mutator-call-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutator-call-tracker.d.ts","sourceRoot":"","sources":["../src/mutator-call-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAUrD,qBAAa,kBAAkB;;IAM7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,CAGpC;IAEH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAG9B;IAEH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAE7D;IAEF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAE7D;IAEF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC,CAS7C;IAEH,KAAK,IAAI,MAAM;IAQf,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAOjE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAOjE,OAAO,IAAI,IAAI;CAOhB"}

package/dist/mutator-call-tracker.js

@@ -0,0 +1,53 @@
+import { computed, signal } from '@angular/core';
+const IDLE = { callId: 0, client: undefined, server: undefined };
+export class MutatorCallTracker {
+    #nextCallId = 0;
+    #destroyed = false;
+    #state = signal(IDLE);
+    clientPending = computed(() => {
+        const state = this.#state();
+        return state.callId !== 0 && state.client === undefined;
+    });
+    pending = computed(() => {
+        const state = this.#state();
+        return state.callId !== 0 && state.server === undefined;
+    });
+    clientResult = computed(() => this.#state().client);
+    serverResult = computed(() => this.#state().server);
+    error = computed(() => {
+        const state = this.#state();
+        if (state.client?.type === 'error') {
+            return state.client.error;
+        }
+        if (state.server?.type === 'error') {
+            return state.server.error;
+        }
+        return undefined;
+    });
+    begin() {
+        const callId = ++this.#nextCallId;
+        if (!this.#destroyed) {
+            this.#state.set({ callId, client: undefined, server: undefined });
+        }
+        return callId;
+    }
+    settleClient(callId, details) {
+        if (this.#isStale(callId)) {
+            return;
+        }
+        this.#state.update(state => ({ ...state, client: details }));
+    }
+    settleServer(callId, details) {
+        if (this.#isStale(callId)) {
+            return;
+        }
+        this.#state.update(state => ({ ...state, server: details }));
+    }
+    destroy() {
+        this.#destroyed = true;
+    }
+    #isStale(callId) {
+        return this.#destroyed || this.#state().callId !== callId;
+    }
+}
+//# sourceMappingURL=mutator-call-tracker.js.map

package/dist/mutator-call-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutator-call-tracker.js","sourceRoot":"","sources":["../src/mutator-call-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAe,MAAM,eAAe,CAAC;AAU9D,MAAM,IAAI,GAAc,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAE5E,MAAM,OAAO,kBAAkB;IAC7B,WAAW,GAAG,CAAC,CAAC;IAChB,UAAU,GAAG,KAAK,CAAC;IAEV,MAAM,GAAG,MAAM,CAAY,IAAI,CAAC,CAAC;IAEjC,aAAa,GAAoB,QAAQ,CAAC,GAAG,EAAE;QACtD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEM,OAAO,GAAoB,QAAQ,CAAC,GAAG,EAAE;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEM,YAAY,GAA6C,QAAQ,CACxE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAC3B,CAAC;IAEO,YAAY,GAA6C,QAAQ,CACxE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAC3B,CAAC;IAEO,KAAK,GAAqC,QAAQ,CAAC,GAAG,EAAE;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;QAC5B,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;QAC5B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,KAAK;QACH,MAAM,MAAM,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,YAAY,CAAC,MAAc,EAAE,OAA6B;QACxD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,YAAY,CAAC,MAAc,EAAE,OAA6B;QACxD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO;QACL,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED,QAAQ,CAAC,MAAc;QACrB,OAAO,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,KAAK,MAAM,CAAC;IAC5D,CAAC;CACF"}

package/dist/mutator-ref.d.ts

@@ -0,0 +1,35 @@
+import type { Injector, Signal } from '@angular/core';
+import type { MutatorResult, MutatorResultDetails, MutatorResultErrorDetails, ReadonlyJSONValue } from '@rocicorp/zero';
+/** Error payload of a failed mutation phase. */
+export type MutatorError = MutatorResultErrorDetails['error'];
+/** Zero's (unexported) MutatorCallable parameter shape as a tuple. */
+export type MutatorArgs<TInput extends ReadonlyJSONValue | undefined> = [
+    TInput
+] extends [undefined] ? [] : undefined extends TInput ? [args?: TInput] : [args: TInput];
+/** Bound mutate() plus signals projecting the latest call's lifecycle. */
+export interface MutatorRef<TInput extends ReadonlyJSONValue | undefined> {
+    /**
+     * Returned client/server promises never reject — rejections normalize to
+     * {type:'error', error:{type:'zero', message}}. Throws synchronously
+     * (state untouched) for setup errors. Safe to destructure.
+     */
+    mutate(...args: MutatorArgs<TInput>): MutatorResult;
+    /** True from mutate() until the latest call's optimistic apply settles. */
+    readonly clientPending: Signal<boolean>;
+    /**
+     * True from mutate() until the latest call's server outcome settles.
+     * Never settles on a local-only instance (cacheURL: null).
+     */
+    readonly pending: Signal<boolean>;
+    /** Latest call's optimistic outcome; undefined while idle or in flight. */
+    readonly clientResult: Signal<MutatorResultDetails | undefined>;
+    /** Latest call's authoritative outcome; undefined while idle or unconfirmed. */
+    readonly serverResult: Signal<MutatorResultDetails | undefined>;
+    /** Client error, else server error (rollback); cleared by next mutate(). */
+    readonly error: Signal<MutatorError | undefined>;
+}
+export interface InjectMutatorOptions {
+    /** Resolve dependencies from an explicit injection context. */
+    injector?: Injector;
+}
+//# sourceMappingURL=mutator-ref.d.ts.map

package/dist/mutator-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutator-ref.d.ts","sourceRoot":"","sources":["../src/mutator-ref.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAExB,gDAAgD;AAChD,MAAM,MAAM,YAAY,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;AAE9D,sEAAsE;AACtE,MAAM,MAAM,WAAW,CAAC,MAAM,SAAS,iBAAiB,GAAG,SAAS,IAClE;IAAC,MAAM;CAAC,SAAS,CAAC,SAAS,CAAC,GACxB,EAAE,GACF,SAAS,SAAS,MAAM,GACtB,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,GACf,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAEvB,0EAA0E;AAC1E,MAAM,WAAW,UAAU,CAAC,MAAM,SAAS,iBAAiB,GAAG,SAAS;IACtE;;;;OAIG;IACH,MAAM,CAAC,GAAG,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC;IAEpD,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;IAChE,gFAAgF;IAChF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;IAChE,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB"}

package/dist/mutator-ref.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mutator-ref.js.map

package/dist/mutator-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutator-ref.js","sourceRoot":"","sources":["../src/mutator-ref.ts"],"names":[],"mappings":""}

package/dist/options-diff.d.ts

@@ -0,0 +1,6 @@
+import type { ZeroOptions } from '@rocicorp/zero';
+import type { ExternalZeroSource, ZeroOptionsOrExternalSource, ZeroReconcileVerdict } from './types.js';
+export declare function isExternalSource(s: ZeroOptionsOrExternalSource): s is ExternalZeroSource;
+export declare function diffZeroOptions(prev: ZeroOptions, next: ZeroOptions): ZeroReconcileVerdict;
+export declare function diffAuth(prev: ZeroOptions['auth'], next: ZeroOptions['auth']): ZeroReconcileVerdict;
+//# sourceMappingURL=options-diff.d.ts.map

package/dist/options-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-diff.d.ts","sourceRoot":"","sources":["../src/options-diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EACV,kBAAkB,EAClB,2BAA2B,EAC3B,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,2BAA2B,GAAG,CAAC,IAAI,kBAAkB,CAExF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,GAAG,oBAAoB,CAW1F;AAWD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,oBAAoB,CAanG"}

package/dist/options-diff.js

@@ -0,0 +1,31 @@
+export function isExternalSource(s) {
+    return 'zero' in s;
+}
+export function diffZeroOptions(prev, next) {
+    for (const key of diffableKeys(prev, next)) {
+        const a = prev[key];
+        const b = next[key];
+        if (!Object.is(a, b)) {
+            return 'recreate';
+        }
+    }
+    return diffAuth(prev.auth, next.auth);
+}
+function diffableKeys(prev, next) {
+    const keys = new Set([...Object.keys(prev), ...Object.keys(next)]);
+    keys.delete('auth');
+    keys.delete('onClientStateNotFound');
+    return keys;
+}
+export function diffAuth(prev, next) {
+    const prevIsString = typeof prev === 'string';
+    const nextIsString = typeof next === 'string';
+    if (prevIsString !== nextIsString) {
+        return 'recreate';
+    }
+    if (nextIsString && !Object.is(prev, next)) {
+        return 'connect';
+    }
+    return 'noop';
+}
+//# sourceMappingURL=options-diff.js.map

package/dist/options-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-diff.js","sourceRoot":"","sources":["../src/options-diff.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,gBAAgB,CAAC,CAA8B;IAC7D,OAAO,MAAM,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAiB,EAAE,IAAiB;IAClE,KAAK,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAI,IAAgC,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,CAAC,GAAI,IAAgC,CAAC,GAAG,CAAC,CAAC;QAEjD,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACrB,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,YAAY,CAAC,IAAiB,EAAE,IAAiB;IACxD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEnE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpB,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAErC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAyB,EAAE,IAAyB;IAC3E,MAAM,YAAY,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC;IAC9C,MAAM,YAAY,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC;IAE9C,IAAI,YAAY,KAAK,YAAY,EAAE,CAAC;QAClC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI,YAAY,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QAC3C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/provide-zero-testing.d.ts

@@ -0,0 +1,7 @@
+import type { EnvironmentProviders } from '@angular/core';
+import type { ZeroOptions } from '@rocicorp/zero';
+import type { ZeroFeature } from './features.js';
+export type ZeroTestingOptions = Omit<ZeroOptions, 'cacheURL' | 'server'>;
+export declare function provideZeroTesting(source: ZeroTestingOptions | (() => ZeroTestingOptions), ...features: ZeroFeature[]): EnvironmentProviders;
+export declare function toTestingZeroOptions(user: ZeroTestingOptions): ZeroOptions;
+//# sourceMappingURL=provide-zero-testing.d.ts.map

package/dist/provide-zero-testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provide-zero-testing.d.ts","sourceRoot":"","sources":["../src/provide-zero-testing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,QAAQ,CAAC,CAAC;AAE1E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,GAAG,CAAC,MAAM,kBAAkB,CAAC,EACvD,GAAG,QAAQ,EAAE,WAAW,EAAE,GACzB,oBAAoB,CAKtB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,WAAW,CAQ1E"}

package/dist/provide-zero-testing.js

@@ -0,0 +1,17 @@
+import { provideZero } from './provide-zero.js';
+export function provideZeroTesting(source, ...features) {
+    return provideZero(() => {
+        const user = typeof source === 'function' ? source() : source;
+        return toTestingZeroOptions(user);
+    }, ...features);
+}
+export function toTestingZeroOptions(user) {
+    return {
+        logLevel: 'error',
+        kvStore: 'mem',
+        ...user,
+        cacheURL: null,
+        server: null,
+    };
+}
+//# sourceMappingURL=provide-zero-testing.js.map

package/dist/provide-zero-testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provide-zero-testing.js","sourceRoot":"","sources":["../src/provide-zero-testing.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKhD,MAAM,UAAU,kBAAkB,CAChC,MAAuD,EACvD,GAAG,QAAuB;IAE1B,OAAO,WAAW,CAAC,GAAG,EAAE;QACtB,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9D,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAwB;IAC3D,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,KAAK;QACd,GAAG,IAAI;QACP,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,IAAI;KACE,CAAC;AACnB,CAAC"}

package/dist/provide-zero.d.ts

@@ -0,0 +1,5 @@
+import { type EnvironmentProviders } from '@angular/core';
+import { type ZeroFeature } from './features.js';
+import type { ZeroInstanceOptions } from './types.js';
+export declare function provideZero(source: ZeroInstanceOptions, ...features: ZeroFeature[]): EnvironmentProviders;
+//# sourceMappingURL=provide-zero.d.ts.map

package/dist/provide-zero.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provide-zero.d.ts","sourceRoot":"","sources":["../src/provide-zero.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAE3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAgB,WAAW,CACzB,MAAM,EAAE,mBAAmB,EAC3B,GAAG,QAAQ,EAAE,WAAW,EAAE,GACzB,oBAAoB,CAQtB"}

package/dist/provide-zero.js

@@ -0,0 +1,12 @@
+import { inject, makeEnvironmentProviders, provideEnvironmentInitializer, } from '@angular/core';
+import { assertUniqueFeatureKinds } from './features.js';
+import { ZERO_INSTANCE, ZeroInstanceManager } from './instance-manager.js';
+export function provideZero(source, ...features) {
+    assertUniqueFeatureKinds(features);
+    return makeEnvironmentProviders([
+        ...features.flatMap(f => [...f.ɵproviders]),
+        { provide: ZERO_INSTANCE, useFactory: () => new ZeroInstanceManager(source) },
+        provideEnvironmentInitializer(() => inject(ZERO_INSTANCE).start()),
+    ]);
+}
+//# sourceMappingURL=provide-zero.js.map

package/dist/provide-zero.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provide-zero.js","sourceRoot":"","sources":["../src/provide-zero.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,wBAAwB,EACxB,6BAA6B,GAE9B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,wBAAwB,EAAoB,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG3E,MAAM,UAAU,WAAW,CACzB,MAA2B,EAC3B,GAAG,QAAuB;IAE1B,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAEnC,OAAO,wBAAwB,CAAC;QAC9B,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;QAC3C,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,mBAAmB,CAAC,MAAM,CAAC,EAAE;QAC7E,6BAA6B,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,KAAK,EAAE,CAAC;KACnE,CAAC,CAAC;AACL,CAAC"}

package/dist/query-identity.d.ts

@@ -0,0 +1,15 @@
+import type { AnyCustomQuery, AnyQuery, Zero } from '@rocicorp/zero';
+/** Widest thunk result; the injectQuery overloads own the precise typing. */
+export type AnyQueryOrRequest = AnyQuery | ReturnType<AnyCustomQuery>;
+export type QueryKey = string;
+/** A thunk result resolved against one Zero instance's current context. */
+export interface ResolvedQuery {
+    readonly key: QueryKey;
+    readonly query: AnyQuery;
+}
+/**
+ * Resolves like `zero.materialize` does, so Zero defines identity. The key
+ * includes the format because `.one()` and `.limit(1)` share an AST hash.
+ */
+export declare function resolveQuery(zero: Zero, value: AnyQueryOrRequest): ResolvedQuery;
+//# sourceMappingURL=query-identity.d.ts.map

package/dist/query-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-identity.d.ts","sourceRoot":"","sources":["../src/query-identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAQrE,6EAA6E;AAC7E,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;AAEtE,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,iBAAiB,GACvB,aAAa,CAgBf"}

package/dist/query-identity.js

@@ -0,0 +1,20 @@
+import { addContextToQuery, asQueryInternals, queryInternalsTag, } from '@rocicorp/zero/bindings';
+import { ngxZeroError } from './errors.js';
+/**
+ * Resolves like `zero.materialize` does, so Zero defines identity. The key
+ * includes the format because `.one()` and `.limit(1)` share an AST hash.
+ */
+export function resolveQuery(zero, value) {
+    const query = addContextToQuery(value, zero.context);
+    // An uncalled registry query passes through resolution untouched.
+    if (!(queryInternalsTag in query)) {
+        throw ngxZeroError('injectQuery() thunk must return a Query or a QueryRequest ' +
+            '(did you forget to call the registry query, e.g. `queries.issue.mine()`?).');
+    }
+    const internals = asQueryInternals(query);
+    return {
+        key: `${internals.hash()}:${JSON.stringify(internals.format)}`,
+        query,
+    };
+}
+//# sourceMappingURL=query-identity.js.map

package/dist/query-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-identity.js","sourceRoot":"","sources":["../src/query-identity.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAa3C;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAU,EACV,KAAwB;IAExB,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAErD,kEAAkE;IAClE,IAAI,CAAC,CAAC,iBAAiB,IAAK,KAAgB,CAAC,EAAE,CAAC;QAC9C,MAAM,YAAY,CAChB,4DAA4D;YAC1D,4EAA4E,CAC/E,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC1C,OAAO;QACL,GAAG,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;QAC9D,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/query-ref.d.ts

@@ -0,0 +1,27 @@
+import type { Injector, Signal } from '@angular/core';
+import type { ErroredQuery, TTL } from '@rocicorp/zero';
+/** Zero's ResultType plus 'disabled' for a thunk that returned falsy. */
+export type QueryStatus = 'unknown' | 'complete' | 'error' | 'disabled';
+/** TStatus lets the always-enabled overload exclude 'disabled'. */
+export interface QueryRef<TData, TStatus extends QueryStatus = Exclude<QueryStatus, 'disabled'>> {
+    /** List queries: Row[]. `.one()` queries: Row | undefined. */
+    readonly data: Signal<TData>;
+    readonly status: Signal<TStatus>;
+    /** Cleared on any later successful emission or re-materialization. */
+    readonly error: Signal<ErroredQuery | undefined>;
+    /** Convenience for `status() === 'complete'`. */
+    readonly isComplete: Signal<boolean>;
+    /** Destroy and re-materialize; no-op while disabled or after host destroy. */
+    retry(): void;
+    /** Forward a TTL to the current view only — never re-materializes. */
+    updateTTL(ttl: TTL): void;
+}
+export interface InjectQueryOptions {
+    /** Passed to `zero.materialize(request, { ttl })` once per materialization. */
+    ttl?: TTL;
+    /** Keep previous data across an empty, unknown same-instance query change. */
+    keepPreviousData?: boolean;
+    /** Resolve dependencies from an explicit injection context. */
+    injector?: Injector;
+}
+//# sourceMappingURL=query-ref.d.ts.map

package/dist/query-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-ref.d.ts","sourceRoot":"","sources":["../src/query-ref.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAExD,yEAAyE;AACzE,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;AAExE,mEAAmE;AACnE,MAAM,WAAW,QAAQ,CACvB,KAAK,EACL,OAAO,SAAS,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC;IAE9D,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACjC,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IACjD,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACrC,8EAA8E;IAC9E,KAAK,IAAI,IAAI,CAAC;IACd,sEAAsE;IACtE,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB"}

package/dist/query-ref.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=query-ref.js.map

package/dist/query-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-ref.js","sourceRoot":"","sources":["../src/query-ref.ts"],"names":[],"mappings":""}

package/dist/query-view-controller.d.ts

@@ -0,0 +1,48 @@
+import type { AnyQuery, TTL, Zero } from '@rocicorp/zero';
+import type { QueryKey } from './query-identity.js';
+import type { QueryStatus } from './query-ref.js';
+export declare const DISABLED: unique symbol;
+/** Deduped on `(zero, key)` upstream — reference equality is the fast path. */
+export type QuerySpec = EnabledQuerySpec | DisabledQuerySpec;
+export interface EnabledQuerySpec {
+    readonly zero: Zero;
+    readonly key: QueryKey;
+    /** Already resolved against `zero`'s context by resolveQuery(). */
+    readonly query: AnyQuery;
+}
+export interface DisabledQuerySpec {
+    readonly zero: Zero;
+    readonly key: typeof DISABLED;
+    readonly query: undefined;
+}
+export declare class QueryViewController {
+    #private;
+    readonly data: import("@angular/core").Signal<unknown>;
+    readonly status: import("@angular/core").Signal<QueryStatus>;
+    readonly error: import("@angular/core").Signal<{
+        message?: string | undefined;
+        details?: import("@rocicorp/zero").ReadonlyJSONValue | undefined;
+        error: "app";
+        id: string;
+        name: string;
+    } | {
+        details?: import("@rocicorp/zero").ReadonlyJSONValue | undefined;
+        error: "parse";
+        id: string;
+        name: string;
+        message: string;
+    } | undefined>;
+    constructor(options: {
+        keepPreviousData: boolean;
+        ttl: TTL | undefined;
+    });
+    /** Candidate-first: on a throw the prior session stays fully live. */
+    reconcile(spec: QuerySpec, options?: {
+        force?: boolean;
+    }): void;
+    /** `untracked` so it is callable from templates and effects without deps. */
+    retry(currentSpec: () => QuerySpec): void;
+    updateTTL(ttl: TTL): void;
+    destroy(): void;
+}
+//# sourceMappingURL=query-view-controller.d.ts.map

package/dist/query-view-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-view-controller.d.ts","sourceRoot":"","sources":["../src/query-view-controller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EAGR,GAAG,EAEH,IAAI,EACL,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,eAAO,MAAM,QAAQ,EAAE,OAAO,MAAoC,CAAC;AAEnE,+EAA+E;AAC/E,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,OAAO,QAAQ,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AAeD,qBAAa,mBAAmB;;IAY9B,QAAQ,CAAC,IAAI,0CAA2B;IACxC,QAAQ,CAAC,MAAM,8CAA6B;IAC5C,QAAQ,CAAC,KAAK;;;;;;;;;;;;mBAA4B;gBAE9B,OAAO,EAAE;QACnB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,GAAG,EAAE,GAAG,GAAG,SAAS,CAAC;KACtB;IAKD,sEAAsE;IACtE,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IAmInE,6EAA6E;IAC7E,KAAK,CAAC,WAAW,EAAE,MAAM,SAAS,GAAG,IAAI;IAczC,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAIzB,OAAO,IAAI,IAAI;CAOhB"}