@rocicorp/zero 0.0.0-202410031711

package/out/zero-client/src/client/crud.d.ts

@@ -0,0 +1,52 @@
+import type { ReadonlyJSONObject } from '../../../shared/src/json.js';
+import type { MaybePromise } from '../../../shared/src/types.js';
+import type { EntityID } from '../../../zero-protocol/src/entity.js';
+import { type CRUDMutationArg, type CRUDOp, CRUD_MUTATION_NAME, type CreateOp, type DeleteOp, type SetOp, type UpdateOp } from '../../../zero-protocol/src/push.js';
+import type { Row } from '../../../zql/src/zql/ivm/data.js';
+import type { SchemaToRow } from '../../../zql/src/zql/query/query.js';
+import type { MutatorDefs, WriteTransaction } from './replicache-types.js';
+import type { Schema } from './zero.js';
+export type Parse<E extends Row> = (v: ReadonlyJSONObject) => E;
+export type Update<E extends Row> = Partial<E>;
+/**
+ * This is the type of the generated mutate.<name>.<verb> function.
+ */
+export type EntityCRUDMutate<E extends Row> = {
+    create: (value: E) => Promise<void>;
+    set: (value: E) => Promise<void>;
+    update: (value: Update<E>) => Promise<void>;
+    delete: (id: EntityID) => Promise<void>;
+};
+/**
+ * This is the type of the generated mutate.<name> object.
+ */
+export type MakeCRUDMutate<S extends Schema> = BaseCRUDMutate<S> & CRUDBatch<S>;
+export type BaseCRUDMutate<S extends Schema> = {
+    [K in keyof S['tables']]: EntityCRUDMutate<SchemaToRow<S['tables'][K]>>;
+};
+export type CRUDBatch<S extends Schema> = <R>(body: (m: BaseCRUDMutate<S>) => MaybePromise<R>) => Promise<R>;
+type ZeroCRUDMutate = {
+    [CRUD_MUTATION_NAME]: CRUDMutate;
+};
+/**
+ * This is the zero.mutate object part representing the CRUD operations. If the
+ * queries are `issue` and `label`, then this object will have `issue` and
+ * `label` properties.
+ */
+export declare function makeCRUDMutate<S extends Schema>(schema: S, repMutate: ZeroCRUDMutate): MakeCRUDMutate<S>;
+/**
+ * Creates the `{create, set, update, delete}` object for use inside a batch.
+ */
+export declare function makeBatchCRUDMutate<E extends Row>(entityType: string, ops: CRUDOp[]): EntityCRUDMutate<E>;
+export type WithCRUD<MD extends MutatorDefs> = MD & {
+    [CRUD_MUTATION_NAME]: CRUDMutator;
+};
+export type CRUDMutate = (crudArg: CRUDMutationArg) => Promise<void>;
+export type CRUDMutator = (tx: WriteTransaction, crudArg: CRUDMutationArg) => Promise<void>;
+export declare function makeCRUDMutator<S extends Schema>(_schemas: S): CRUDMutator;
+export declare function createImpl(tx: WriteTransaction, arg: CreateOp): Promise<void>;
+export declare function setImpl(tx: WriteTransaction, arg: SetOp): Promise<void>;
+export declare function updateImpl(tx: WriteTransaction, arg: UpdateOp): Promise<void>;
+export declare function deleteImpl(tx: WriteTransaction, arg: DeleteOp): Promise<void>;
+export {};
+//# sourceMappingURL=crud.d.ts.map

package/out/zero-client/src/client/crud.d.ts.map

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

package/out/zero-client/src/client/enable-analytics.d.ts

@@ -0,0 +1,3 @@
+export declare const IP_ADDRESS_HOSTNAME_REGEX: RegExp;
+export declare function shouldEnableAnalytics(server: string | null, enableAnalytics?: boolean): boolean;
+//# sourceMappingURL=enable-analytics.d.ts.map

package/out/zero-client/src/client/enable-analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enable-analytics.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/enable-analytics.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,yBAAyB,QAErC,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,eAAe,UAAO,GACrB,OAAO,CAeT"}

package/out/zero-client/src/client/http-string.d.ts

@@ -0,0 +1,7 @@
+export type HTTPString = `http${'' | 's'}://${string}`;
+export type WSString = `ws${'' | 's'}://${string}`;
+export declare function toWSString(url: HTTPString): WSString;
+export declare function toHTTPString(url: WSString): HTTPString;
+export declare function assertHTTPString(url: string): asserts url is HTTPString;
+export declare function assertWSString(url: string): asserts url is WSString;
+//# sourceMappingURL=http-string.d.ts.map

package/out/zero-client/src/client/http-string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-string.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/http-string.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,OAAO,EAAE,GAAG,GAAG,MAAM,MAAM,EAAE,CAAC;AAEvD,MAAM,MAAM,QAAQ,GAAG,KAAK,EAAE,GAAG,GAAG,MAAM,MAAM,EAAE,CAAC;AAEnD,wBAAgB,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,QAAQ,CAEpD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,GAAG,UAAU,CAEtD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,UAAU,CAEvE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,QAAQ,CAEnE"}

package/out/zero-client/src/client/keys.d.ts

@@ -0,0 +1,11 @@
+import type { EntityID } from '../../../zero-protocol/src/entity.js';
+export declare const CLIENTS_KEY_PREFIX = "c/";
+export declare const DESIRED_QUERIES_KEY_PREFIX = "d/";
+export declare const GOT_QUERIES_KEY_PREFIX = "g/";
+export declare const ENTITIES_KEY_PREFIX = "e/";
+export declare function toClientsKey(clientID: string): string;
+export declare function toDesiredQueriesKey(clientID: string, hash: string): string;
+export declare function desiredQueriesPrefixForClient(clientID: string): string;
+export declare function toGotQueriesKey(hash: string): string;
+export declare function toEntitiesKey(entityType: string, entityID: EntityID): string;
+//# sourceMappingURL=keys.d.ts.map

package/out/zero-client/src/client/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/keys.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,6BAA6B,CAAC;AAE1D,eAAO,MAAM,kBAAkB,OAAO,CAAC;AACvC,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAC/C,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAW5E"}

package/out/zero-client/src/client/log-options.d.ts

@@ -0,0 +1,12 @@
+import { type LogLevel, type LogSink } from '@rocicorp/logger';
+import { type DatadogLogSinkOptions } from '../../../datadog';
+export type LogOptions = {
+    readonly logLevel: LogLevel;
+    readonly logSink: LogSink;
+};
+export declare function createLogOptions(options: {
+    consoleLogLevel: LogLevel;
+    server: string | null;
+    enableAnalytics: boolean;
+}, createDatadogLogSink?: (options: DatadogLogSinkOptions) => LogSink): LogOptions;
+//# sourceMappingURL=log-options.d.ts.map

package/out/zero-client/src/client/log-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-options.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/log-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,OAAO,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAiB,KAAK,qBAAqB,EAAC,MAAM,SAAS,CAAC;AA8BnE,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE;IACP,eAAe,EAAE,QAAQ,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;CAC1B,EACD,oBAAoB,GAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,OAE1B,GAC/B,UAAU,CAmCZ"}

package/out/zero-client/src/client/metrics.d.ts

@@ -0,0 +1,115 @@
+import type { LogContext } from '@rocicorp/logger';
+import type { MaybePromise } from '../../../shared/src/types.js';
+import type { ErrorKind as ServerErrorKind } from '../../../zero-protocol/src/mod.js';
+export declare enum MetricName {
+    TimeToConnectMs = "time_to_connect_ms",
+    LastConnectError = "last_connect_error",
+    TimeToConnectMsV2 = "time_to_connect_ms_v2",
+    LastConnectErrorV2 = "last_connect_error_v2",
+    TotalTimeToConnectMs = "total_time_to_connect_ms",
+    NotConnected = "not_connected"
+}
+export declare const DID_NOT_CONNECT_VALUE: number;
+export declare const REPORT_INTERVAL_MS = 5000;
+type ClientDisconnectReason = 'AbruptClose' | 'CleanClose' | 'ClientClosed' | 'ConnectTimeout' | 'UnexpectedBaseCookie' | 'PingTimeout' | 'Hidden';
+export type DisconnectReason = {
+    server: ServerErrorKind;
+} | {
+    client: ClientDisconnectReason;
+};
+export declare function getLastConnectErrorValue(reason: DisconnectReason): string;
+type MetricsReporter = (metrics: Series[]) => MaybePromise<void>;
+export type MetricManagerOptions = {
+    reportIntervalMs: number;
+    host: string;
+    source: string;
+    reporter: MetricsReporter;
+    lc: LogContext;
+};
+/**
+ * MetricManager keeps track of the set of metrics in use and flushes them
+ * to a format suitable for reporting.
+ */
+export declare class MetricManager {
+    #private;
+    constructor(opts: MetricManagerOptions);
+    readonly timeToConnectMs: Gauge;
+    readonly lastConnectError: State;
+    setConnected(timeToConnectMs: number, totalTimeToConnectMs: number): void;
+    setDisconnectedWaitingForVisible(): void;
+    setConnectError(reason: DisconnectReason): void;
+    /**
+     * Tags to include in all metrics.
+     */
+    readonly tags: string[];
+    flush(): Promise<void>;
+    stop(): void;
+}
+/** Series is a time series of points for a single metric. */
+export type Series = {
+    host: string;
+    metric: string;
+    points: Point[];
+    tags?: string[];
+};
+/**
+ * A point is a second-resolution timestamp and a set of values for that
+ * timestamp. A point represents exactly one second in time and the values
+ * are those recorded for that second. The first element of this array
+ * is the timestamp and the second element is an array of values.
+ */
+export type Point = [number, number[]];
+type Flushable = {
+    flush(): Pick<Series, 'metric' | 'points'> | undefined;
+};
+/**
+ * Gauge is a metric type that represents a single value that can go up and
+ * down. It's typically used to track discrete values or counts eg the number
+ * of active users, number of connections, cpu load, etc. A gauge retains
+ * its value when flushed.
+ *
+ * We use a Gauge to sample at the client. If we are interested in tracking
+ * a metric value *per client*, the client can note the latest value in
+ * a Gauge metric. The metric is periodically reported via Reporter. On the
+ * server, we graph the value of the metric rolled up over the periodic
+ * reporting period, that is, counted over a span of time equal to the
+ * reporting period. The result is ~one point per client per reporting
+ * period.
+ */
+export declare class Gauge implements Flushable {
+    #private;
+    constructor(name: string);
+    set(value: number): void;
+    get(): number | undefined;
+    clear(): void;
+    flush(): {
+        metric: string;
+        points: Point[];
+    } | undefined;
+}
+/**
+ * State is a metric type that represents a specific state that the system is
+ * in, for example the state of a connection which may be 'open' or 'closed'.
+ * The state is given a name/prefix at construction time (eg 'connection') and
+ * then can be set to a specific state (eg 'open'). The prefix is prepended to
+ * the set state (eg, 'connection_open') and a value of 1 is reported.
+ * Unset/cleared states are not reported.
+ *
+ * Example:
+ *   const s = new State('connection');
+ *   s.set('open');
+ *   s.flush(); // returns {metric: 'connection_open', points: [[now(), [1]]]}
+ */
+export declare class State implements Flushable {
+    #private;
+    constructor(prefix: string, clearOnFlush?: boolean);
+    set(state: string): void;
+    get(): string | undefined;
+    clear(): void;
+    flush(): {
+        metric: string;
+        points: Point[];
+    } | undefined;
+}
+export {};
+//# sourceMappingURL=metrics.d.ts.map

package/out/zero-client/src/client/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAC,SAAS,IAAI,eAAe,EAAC,MAAM,eAAe,CAAC;AAEhE,oBAAY,UAAU;IACpB,eAAe,uBAAuB;IACtC,gBAAgB,uBAAuB;IACvC,iBAAiB,0BAA0B;IAC3C,kBAAkB,0BAA0B;IAC5C,oBAAoB,6BAA6B;IACjD,YAAY,kBAAkB;CAC/B;AAMD,eAAO,MAAM,qBAAqB,QAAa,CAAC;AAEhD,eAAO,MAAM,kBAAkB,OAAQ,CAAC;AAExC,KAAK,sBAAsB,GACvB,aAAa,GACb,YAAY,GACZ,cAAc,GACd,gBAAgB,GAChB,sBAAsB,GACtB,aAAa,GACb,QAAQ,CAAC;AASb,MAAM,MAAM,gBAAgB,GACxB;IACE,MAAM,EAAE,eAAe,CAAC;CACzB,GACD;IACE,MAAM,EAAE,sBAAsB,CAAC;CAChC,CAAC;AAEN,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAKzE;AAYD,KAAK,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;AAEjE,MAAM,MAAM,oBAAoB,GAAG;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,eAAe,CAAC;IAC1B,EAAE,EAAE,UAAU,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,qBAAa,aAAa;;gBAOZ,IAAI,EAAE,oBAAoB;IAqCtC,QAAQ,CAAC,eAAe,QAEtB;IAMF,QAAQ,CAAC,gBAAgB,QAKvB;IAqCF,YAAY,CAAC,eAAe,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM;IAOlE,gCAAgC;IAmBhC,eAAe,CAAC,MAAM,EAAE,gBAAgB;IAOxC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAM;IAIvB,KAAK;IA4BX,IAAI;CAaL;AAMD,6DAA6D;AAC7D,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AACF;;;;;GAKG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAMvC,KAAK,SAAS,GAAG;IACf,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAAG,SAAS,CAAC;CACxD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,qBAAa,KAAM,YAAW,SAAS;;gBAIzB,IAAI,EAAE,MAAM;IAIxB,GAAG,CAAC,KAAK,EAAE,MAAM;IAIjB,GAAG;IAIH,KAAK;IAIL,KAAK;;;;CASN;AAMD;;;;;;;;;;;;GAYG;AACH,qBAAa,KAAM,YAAW,SAAS;;gBAKzB,MAAM,EAAE,MAAM,EAAE,YAAY,UAAQ;IAKhD,GAAG,CAAC,KAAK,EAAE,MAAM;IAIjB,GAAG;IAIH,KAAK;IAIL,KAAK;;;;CAYN"}

package/out/zero-client/src/client/options.d.ts

@@ -0,0 +1,94 @@
+import type { LogLevel } from '@rocicorp/logger';
+import type { KVStoreProvider } from '../../../replicache';
+import type { MaybePromise } from '../../../shared/src/types.js';
+import type { Schema } from './zero.js';
+/**
+ * Configuration for [[Zero]].
+ */
+export interface ZeroOptions<S extends Schema> {
+    /**
+     * Server to connect to, for example "https://myapp-myteam.zero.ms/".
+     */
+    server?: string | null | undefined;
+    /**
+     * Identifies and authenticates the user.
+     *
+     * This value is required when you provide a `authHandler` to your ReflectServer.
+     * During connection this value is passed to your provided `authHandler`, which should use it to
+     * authenticate the user. The `userID` returned by your `authHandler` for this value
+     * must be equal to [[ReflectOptions.userID]].
+     *
+     * In the case authentication fails, the connection to the server will be
+     * closed and Reflect will retry connecting with exponential backoff.
+     *
+     * If a function is provided here, that function is invoked before each
+     * attempt. This provides the application the opportunity to calculate or
+     * fetch a fresh token.
+     */
+    auth?: string | (() => MaybePromise<string>) | undefined;
+    /**
+     * A unique identifier for the user. Must be non-empty.
+     *
+     * For efficiency, a new Zero instance will initialize its state from
+     * the persisted state of an existing Zero instance with the same
+     * `userID`, `roomID`, domain and browser profile.
+     */
+    userID: string;
+    /**
+     * The server side data can be restricted to a jurisdiction. This is
+     * useful for GDPR compliance.
+     */
+    jurisdiction?: 'eu' | undefined;
+    /**
+     * Determines the level of detail at which Zero logs messages about
+     * its operation. Messages are logged to the `console`.
+     *
+     * When this is set to `'debug'`, `'info'` and `'error'` messages are also
+     * logged. When set to `'info'`, `'info'` and `'error'` but not
+     * `'debug'` messages are logged. When set to `'error'` only `'error'`
+     * messages are logged.
+     *
+     * Default is `'error'`.
+     */
+    logLevel?: LogLevel | undefined;
+    /**
+     * This defines the schema of the tables used in Zero and their relationships
+     * to one another.
+     */
+    schema: S;
+    /**
+     * `onOnlineChange` is called when the Zero instance's online status changes
+     */
+    onOnlineChange?: ((online: boolean) => void) | undefined;
+    /**
+     * The number of milliseconds to wait before disconnecting a Zero
+     * instance whose tab has become hidden.
+     *
+     * Instances in hidden tabs are disconnected to save resources.
+     *
+     * Default is 5_000.
+     */
+    hiddenTabDisconnectDelay?: number | undefined;
+    /**
+     * Help Zero improve its service by automatically sending diagnostic and
+     * usage data.
+     *
+     * Default is true.
+     */
+    enableAnalytics?: boolean | undefined;
+    /**
+     * Determines what kind of storage implementation to use on the client.
+     *
+     * Defaults to `'idb'` which means that Zero uses an IndexedDB storage
+     * implementation. This allows the data to be persisted on the client and
+     * enables faster syncs between application restarts.
+     *
+     * By setting this to `'mem'`, Zero uses an in memory storage and
+     * the data is not persisted on the client.
+     *
+     * You can also set this to a function that is used to create new KV stores,
+     * allowing a custom implementation of the underlying storage layer.
+     */
+    kvStore?: 'mem' | 'idb' | KVStoreProvider | undefined;
+}
+//# sourceMappingURL=options.d.ts.map

package/out/zero-client/src/client/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,WAAW,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM;IAC3C;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAEnC;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAEzD;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,YAAY,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAEhC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAEhC;;;OAGG;IACH,MAAM,EAAE,CAAC,CAAC;IAEV;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAEzD;;;;;;;OAOG;IACH,wBAAwB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE9C;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAEtC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,eAAe,GAAG,SAAS,CAAC;CACvD"}

package/out/zero-client/src/client/query-manager.d.ts

@@ -0,0 +1,16 @@
+import type { ClientID } from '../../../replicache';
+import type { ChangeDesiredQueriesMessage, QueriesPatch } from '../../../zero-protocol/src/mod.js';
+import { type AST } from '../../../zql/src/zql/ast/ast.js';
+import type { ReadTransaction } from '../mod.js';
+/**
+ * Tracks what queries the client is currently subscribed to on the server.
+ * Sends `changeDesiredQueries` message to server when this changes.
+ * Deduplicates requests so that we only listen to a given unique query once.
+ */
+export declare class QueryManager {
+    #private;
+    constructor(clientID: ClientID, send: (change: ChangeDesiredQueriesMessage) => void);
+    getQueriesPatch(tx: ReadTransaction): Promise<QueriesPatch>;
+    add(ast: AST): () => void;
+}
+//# sourceMappingURL=query-manager.d.ts.map

package/out/zero-client/src/client/query-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-manager.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/query-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AAGzC,OAAO,KAAK,EAAC,2BAA2B,EAAE,YAAY,EAAC,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAe,KAAK,GAAG,EAAC,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,WAAW,CAAC;AAG/C;;;;GAIG;AACH,qBAAa,YAAY;;gBAOrB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,CAAC,MAAM,EAAE,2BAA2B,KAAK,IAAI;IAM/C,eAAe,CAAC,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC;IAoBjE,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,IAAI;CAyC1B"}

package/out/zero-client/src/client/reload-error-handler.d.ts

@@ -0,0 +1,5 @@
+import type { LogContext } from '@rocicorp/logger';
+export declare const RELOAD_REASON_STORAGE_KEY = "_zeroReloadReason";
+export declare function reloadWithReason(lc: LogContext, reload: () => void, reason: string): void;
+export declare function reportReloadReason(lc: LogContext): void;
+//# sourceMappingURL=reload-error-handler.d.ts.map

package/out/zero-client/src/client/reload-error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload-error-handler.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/reload-error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAEjD,eAAO,MAAM,yBAAyB,sBAAsB,CAAC;AAI7D,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,UAAU,EACd,MAAM,EAAE,MAAM,IAAI,EAClB,MAAM,EAAE,MAAM,QAQf;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,UAAU,QAShD"}

package/out/zero-client/src/client/replicache-types.d.ts

@@ -0,0 +1,48 @@
+import type { MutatorReturn, ReadonlyJSONObject, ReadTransaction as ReplicacheReadTransaction, WriteTransaction as ReplicacheWriteTransaction } from '../../../replicache';
+/**
+ * `AuthData` must include a `userID` which is unique stable identifier
+ * for the user.
+ * `AuthData` has a size limit of 6 KB.
+ * `AuthData` is passed via {@link WriteTransaction.auth} to mutators
+ * when they are run on the server, which can use it to supplement
+ * mutator args and to authorize the mutation.
+ */
+export type AuthData = ReadonlyJSONObject & {
+    readonly userID: string;
+};
+/** Environment variables. */
+export type Env = {
+    readonly [key: string]: string;
+};
+export interface ReadTransaction extends ReplicacheReadTransaction {
+    /**
+     * When a mutator is run on the server, the `AuthData` for the connection
+     * that pushed the mutation (i.e. the `AuthData` returned by the
+     * {@link ReflectServerOptions.authHandler} when it authenticated the
+     * connection).  Always undefined on the client. This can be used to implement
+     * fine-grained server-side authorization of mutations.
+     */
+    readonly auth?: AuthData | undefined;
+    /**
+     * When a mutator is run on the server, `Env` contains environment variables.
+     */
+    readonly env?: Env | undefined;
+}
+export interface WriteTransaction extends ReplicacheWriteTransaction {
+    /**
+     * When a mutator is run on the server, the `AuthData` for the connection
+     * that pushed the mutation (i.e. the `AuthData` returned by the
+     * {@link ReflectServerOptions.authHandler} when it authenticated the
+     * connection).  Always undefined on the client. This can be used to implement
+     * fine-grained server-side authorization of mutations.
+     */
+    readonly auth?: AuthData | undefined;
+    /**
+     * When a mutator is run on the server, `Env` contains environment variables.
+     */
+    readonly env?: Env | undefined;
+}
+export type MutatorDefs = {
+    [key: string]: (tx: WriteTransaction, args?: any) => MutatorReturn;
+};
+//# sourceMappingURL=replicache-types.d.ts.map

package/out/zero-client/src/client/replicache-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replicache-types.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/replicache-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,eAAe,IAAI,yBAAyB,EAC5C,gBAAgB,IAAI,0BAA0B,EAC/C,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,kBAAkB,GAAG;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAAC;AAEtE,6BAA6B;AAC7B,MAAM,MAAM,GAAG,GAAG;IAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAC,CAAC;AAEnD,MAAM,WAAW,eAAgB,SAAQ,yBAAyB;IAChE;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,gBAAiB,SAAQ,0BAA0B;IAClE;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,CACb,EAAE,EAAE,gBAAgB,EAGpB,IAAI,CAAC,EAAE,GAAG,KACP,aAAa,CAAC;CACpB,CAAC"}

package/out/zero-client/src/client/server-error.d.ts

@@ -0,0 +1,12 @@
+import { ErrorKind } from '../../../zero-protocol/src/mod.js';
+/**
+ * Represents an error sent by server as part of Zero protocol.
+ */
+export declare class ServerError<K extends ErrorKind = ErrorKind> extends Error {
+    readonly kind: K;
+    readonly name = "ServerError";
+    constructor(kind: K, message: string);
+}
+export declare function isServerError(ex: unknown): ex is ServerError;
+export declare function isAuthError(ex: unknown): ex is ServerError<ErrorKind.AuthInvalidated> | ServerError<ErrorKind.Unauthorized>;
+//# sourceMappingURL=server-error.d.ts.map

package/out/zero-client/src/client/server-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-error.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/server-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,eAAe,CAAC;AAExC;;GAEG;AACH,qBAAa,WAAW,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,CAAE,SAAQ,KAAK;IACrE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,IAAI,iBAAiB;gBAClB,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM;CAIrC;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,WAAW,CAE5D;AAED,wBAAgB,WAAW,CACzB,EAAE,EAAE,OAAO,GACV,EAAE,IACD,WAAW,CAAC,SAAS,CAAC,eAAe,CAAC,GACtC,WAAW,CAAC,SAAS,CAAC,YAAY,CAAC,CAEtC"}

package/out/zero-client/src/client/server-option.d.ts

@@ -0,0 +1,3 @@
+import type { HTTPString } from './http-string.js';
+export declare function getServer(server: string | undefined | null): HTTPString | null;
+//# sourceMappingURL=server-option.d.ts.map

package/out/zero-client/src/client/server-option.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-option.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/server-option.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AA8CjD,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAChC,UAAU,GAAG,IAAI,CAKnB"}

package/out/zero-client/src/client/version.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The current version of Zero.
+ */
+export declare const version: string;
+//# sourceMappingURL=version.d.ts.map

package/out/zero-client/src/client/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/version.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,OAAO,QAAe,CAAC"}

package/out/zero-client/src/client/zero-poke-handler.d.ts

@@ -0,0 +1,28 @@
+import type { LogContext } from '@rocicorp/logger';
+import type { ClientID } from '../../../replicache';
+import type { PokeInternal } from 'replicache/impl';
+import type { PokeEndBody, PokePartBody, PokeStartBody } from '../../../zero-protocol/src/mod.js';
+type PokeAccumulator = {
+    readonly pokeStart: PokeStartBody;
+    readonly parts: PokePartBody[];
+};
+/**
+ * Handles the multi-part format of zero pokes.
+ * As an optimization it also debounces pokes, only poking Replicache with a
+ * merged poke at most once per frame (as determined by requestAnimationFrame).
+ * The client cannot control how fast the server sends pokes, and it can only
+ * update the UI once per frame. This debouncing avoids wastefully
+ * computing separate diffs and IVM updates for intermediate states that will
+ * never been displayed to the UI.
+ */
+export declare class PokeHandler {
+    #private;
+    constructor(replicachePoke: (poke: PokeInternal) => Promise<void>, onPokeError: () => void, clientID: ClientID, lc: LogContext);
+    handlePokeStart(pokeStart: PokeStartBody): void;
+    handlePokePart(pokePart: PokePartBody): number | undefined;
+    handlePokeEnd(pokeEnd: PokeEndBody): void;
+    handleDisconnect(): void;
+}
+export declare function mergePokes(pokeBuffer: PokeAccumulator[]): PokeInternal | undefined;
+export {};
+//# sourceMappingURL=zero-poke-handler.d.ts.map

package/out/zero-client/src/client/zero-poke-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zero-poke-handler.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/zero-poke-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAC,QAAQ,EAAiB,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EAAyB,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAC1E,OAAO,KAAK,EAGV,WAAW,EACX,YAAY,EACZ,aAAa,EAEd,MAAM,eAAe,CAAC;AAQvB,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC;CAChC,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,WAAW;;gBAcpB,cAAc,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,EACrD,WAAW,EAAE,MAAM,IAAI,EACvB,QAAQ,EAAE,QAAQ,EAClB,EAAE,EAAE,UAAU;IAQhB,eAAe,CAAC,SAAS,EAAE,aAAa;IAiBxC,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS;IAY1D,aAAa,CAAC,OAAO,EAAE,WAAW;IAelC,gBAAgB,IAAI,IAAI;CAoEzB;AAED,wBAAgB,UAAU,CACxB,UAAU,EAAE,eAAe,EAAE,GAC5B,YAAY,GAAG,SAAS,CAuE1B"}