npm - @rocicorp/zero - Versions diffs - 1.6.0-canary.12 → 1.6.0-canary.13 - Mend

@rocicorp/zero 1.6.0-canary.12 → 1.6.0-canary.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (551) hide show

package/out/zero-client/src/client/inspector/lazy-inspector.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"lazy-inspector.js","names":[],"sources":["../../../../../../zero-client/src/client/inspector/lazy-inspector.ts"],"sourcesContent":["import type {BTreeRead} from '../../../../replicache/src/btree/read.ts';\nimport type {Read} from '../../../../replicache/src/dag/store.ts';\nimport {readFromHash} from '../../../../replicache/src/db/read.ts';\nimport * as FormatVersion from '../../../../replicache/src/format-version-enum.ts';\nimport {getClientGroup} from '../../../../replicache/src/persist/client-groups.ts';\nimport {\n getClient,\n getClients,\n type ClientMap,\n} from '../../../../replicache/src/persist/clients.ts';\nimport type {ReplicacheImpl} from '../../../../replicache/src/replicache-impl.ts';\nimport {withRead} from '../../../../replicache/src/with-transactions.ts';\nimport {assert} from '../../../../shared/src/asserts.ts';\nimport type {ReadonlyJSONValue} from '../../../../shared/src/json.ts';\nimport {TDigest, type ReadonlyTDigest} from '../../../../shared/src/tdigest.ts';\nimport * as valita from '../../../../shared/src/valita.ts';\nimport type {AnalyzeQueryResult} from '../../../../zero-protocol/src/analyze-query-result.ts';\nimport type {AST} from '../../../../zero-protocol/src/ast.ts';\nimport type {Row} from '../../../../zero-protocol/src/data.ts';\nimport {\n inspectAnalyzeQueryDownSchema,\n inspectAuthenticatedDownSchema,\n inspectMetricsDownSchema,\n inspectQueriesDownSchema,\n inspectVersionDownSchema,\n type InspectDownBody,\n type InspectQueryRow,\n type QueryServerMetrics as QueryServerMetricsJSON,\n} from '../../../../zero-protocol/src/inspect-down.ts';\nimport type {\n AnalyzeQueryOptions,\n InspectUpBody,\n} from '../../../../zero-protocol/src/inspect-up.ts';\nimport type {\n ClientMetricMap,\n ServerMetricMap,\n} from '../../../../zql/src/query/metrics-delegate.ts';\nimport type {QueryDelegate} from '../../../../zql/src/query/query-delegate.ts';\nimport {asQueryInternals} from '../../../../zql/src/query/query-internals.ts';\nimport type {AnyQuery} from '../../../../zql/src/query/query.ts';\nimport {nanoid} from '../../util/nanoid.ts';\nimport {ENTITIES_KEY_PREFIX} from '../keys.ts';\nimport type {MutatorDefs} from '../replicache-types.ts';\nimport {Client} from './client.ts';\nimport {createHTMLPasswordPrompt} from './html-dialog-prompt.ts';\nimport {type Lazy} from './inspector.ts';\nimport {Query} from './query.ts';\n\nexport type GetWebSocket = () => Promise<WebSocket>;\n\nexport type Metrics = {\n readonly [K in keyof (ClientMetricMap & ServerMetricMap)]: ReadonlyTDigest;\n};\n\ntype DistributiveOmit<T, K extends string> = T extends object\n ? Omit<T, K>\n : never;\n\nexport async function rpc<T extends InspectDownBody>(\n socket: WebSocket,\n arg: DistributiveOmit<InspectUpBody, 'id'>,\n downSchema: valita.Type<T>,\n): Promise<T['value']> {\n try {\n return await rpcNoAuthTry(socket, arg, downSchema);\n } catch (e) {\n if (e instanceof UnauthenticatedError) {\n const password = await createHTMLPasswordPrompt('Enter password:');\n if (password) {\n // Do authenticate rpc\n const authRes = await rpcNoAuthTry(\n socket,\n {op: 'authenticate', value: password},\n inspectAuthenticatedDownSchema,\n );\n if (authRes) {\n // If authentication is successful, retry the original RPC\n return rpcNoAuthTry(socket, arg, downSchema);\n }\n }\n throw new Error('Authentication failed');\n }\n throw e;\n }\n}\n\nfunction rpcNoAuthTry<T extends InspectDownBody>(\n socket: WebSocket,\n arg: DistributiveOmit<InspectUpBody, 'id'>,\n downSchema: valita.Type<T>,\n): Promise<T['value']> {\n return new Promise((resolve, reject) => {\n const id = nanoid();\n const f = (ev: MessageEvent) => {\n const msg = JSON.parse(ev.data);\n if (msg[0] === 'inspect') {\n const body = msg[1];\n if (body.id !== id) {\n return;\n }\n const res = valita.test(body, downSchema);\n if (res.ok) {\n if (res.value.op === 'error') {\n reject(new Error(res.value.value));\n } else {\n resolve(res.value.value);\n }\n } else {\n // Check if we got un authenticated/false response\n const authRes = valita.test(body, inspectAuthenticatedDownSchema);\n if (authRes.ok) {\n // Handle authenticated response\n assert(\n authRes.value.value === false,\n 'Expected unauthenticated response',\n );\n reject(new UnauthenticatedError());\n }\n\n reject(res.error);\n }\n socket.removeEventListener('message', f);\n }\n };\n socket.addEventListener('message', f);\n socket.send(JSON.stringify(['inspect', {...arg, id}]));\n });\n} // T extends forces T to be resolved\n\nexport function mergeMetrics(\n clientMetrics: QueryClientMetrics \| undefined,\n serverMetrics: QueryServerMetricsJSON \| null \| undefined,\n): ClientMetrics & ServerMetrics {\n const cm = clientMetrics ?? newClientMetrics();\n return {\n ...convertClientMetrics(cm),\n ...(serverMetrics\n ? convertServerMetrics(serverMetrics)\n : newServerMetrics()),\n };\n}\n\nfunction newClientMetrics(): QueryClientMetrics {\n return {\n 'query-materialization-client': undefined,\n 'query-materialization-end-to-end': undefined,\n 'query-update-client': new TDigest(),\n };\n}\n\nfunction convertClientMetrics(metrics: QueryClientMetrics): ClientMetrics {\n const hydrateDigest = new TDigest();\n if (metrics['query-materialization-client'] !== undefined) {\n hydrateDigest.add(metrics['query-materialization-client']);\n }\n const totalDigest = new TDigest();\n if (metrics['query-materialization-end-to-end'] !== undefined) {\n totalDigest.add(metrics['query-materialization-end-to-end']);\n }\n return {\n 'query-materialization-client': hydrateDigest,\n 'query-materialization-end-to-end': totalDigest,\n 'query-update-client': metrics['query-update-client'] as TDigest,\n };\n}\n\nfunction newServerMetrics(): ServerMetrics {\n return {\n 'query-materialization-server': new TDigest(),\n 'query-update-server': new TDigest(),\n };\n}\n\nfunction convertServerMetrics(metrics: QueryServerMetricsJSON): ServerMetrics {\n const hydrateMs = metrics['query-hydration-server-ms'];\n const hydrateDigest = new TDigest();\n if (hydrateMs !== undefined) {\n hydrateDigest.add(hydrateMs);\n }\n return {\n 'query-materialization-server': hydrateDigest,\n 'query-update-server': TDigest.fromJSON(metrics['query-update-server']),\n };\n}\n\nexport async function inspectorMetrics(\n delegate: ExtendedInspectorDelegate,\n): Promise<Metrics> {\n const clientMetrics = delegate.metrics;\n const serverMetricsJSON = await rpc(\n await delegate.getSocket(),\n {op: 'metrics'},\n inspectMetricsDownSchema,\n );\n return {\n ...(clientMetrics ?? newClientMetrics()),\n 'query-materialization-server': TDigest.fromJSON(\n serverMetricsJSON['query-materialization-server'],\n ),\n 'query-update-server': TDigest.fromJSON(\n serverMetricsJSON['query-update-server'],\n ),\n };\n}\n\nexport function inspectorClients(\n delegate: ExtendedInspectorDelegate,\n): Promise<Client[]> {\n return withDagRead(delegate, dagRead => clients(delegate, dagRead));\n}\n\nexport function inspectorClientsWithQueries(\n delegate: ExtendedInspectorDelegate,\n): Promise<Client[]> {\n return withDagRead(delegate, dagRead =>\n clientsWithQueries(delegate, dagRead),\n );\n}\n\nasync function withDagRead<T>(\n delegate: ExtendedInspectorDelegate,\n f: (dagRead: Read) => Promise<T>,\n): Promise<T> {\n const {rep} = delegate;\n await rep.refresh();\n await rep.persist();\n return withRead(rep.perdag, f);\n}\n\nasync function getBTree(dagRead: Read, clientID: string): Promise<BTreeRead> {\n const client = await getClient(clientID, dagRead);\n assert(client, `Client not found: ${clientID}`);\n const {clientGroupID} = client;\n const clientGroup = await getClientGroup(clientGroupID, dagRead);\n assert(clientGroup, `Client group not found: ${clientGroupID}`);\n const dbRead = await readFromHash(\n clientGroup.headHash,\n dagRead,\n FormatVersion.Latest,\n );\n return dbRead.map;\n}\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\ntype MapEntry<T extends ReadonlyMap<any, any>> =\n T extends ReadonlyMap<infer K, infer V> ? readonly [K, V] : never;\n\nasync function clients(\n delegate: ExtendedInspectorDelegate,\n dagRead: Read,\n predicate: (entry: MapEntry<ClientMap>) => boolean = () => true,\n): Promise<Client[]> {\n const clients = await getClients(dagRead);\n return [...clients.entries()]\n .filter(predicate)\n .map(\n ([clientID, {clientGroupID}]) =>\n new Client(delegate, clientID, clientGroupID),\n );\n}\n\nasync function clientsWithQueries(\n delegate: ExtendedInspectorDelegate,\n dagRead: Read,\n predicate: (entry: MapEntry<ClientMap>) => boolean = () => true,\n): Promise<Client[]> {\n const allClients = await clients(delegate, dagRead, predicate);\n const clientsWithQueries: Client[] = [];\n await Promise.all(\n allClients.map(async client => {\n const queries = await client.queries();\n if (queries.length > 0) {\n clientsWithQueries.push(client);\n }\n }),\n );\n return clientsWithQueries;\n}\n\nexport async function clientGroupClients(\n delegate: ExtendedInspectorDelegate,\n clientGroupID: Promise<string> \| string,\n): Promise<Client[]> {\n const id = await clientGroupID;\n return withDagRead(delegate, dagRead =>\n clients(delegate, dagRead, ([_, v]) => v.clientGroupID === id),\n );\n}\n\nexport async function clientGroupClientsWithQueries(\n delegate: ExtendedInspectorDelegate,\n clientGroupID: Promise<string> \| string,\n): Promise<Client[]> {\n const id = await clientGroupID;\n return withDagRead(delegate, dagRead =>\n clientsWithQueries(delegate, dagRead, ([_, v]) => v.clientGroupID === id),\n );\n}\n\nexport function clientGroupQueries(\n delegate: ExtendedInspectorDelegate,\n): Promise<Query[]> {\n return queries(delegate, {op: 'queries'});\n}\nexport function clientMap(\n delegate: ExtendedInspectorDelegate,\n clientID: string,\n): Promise<Map<string, ReadonlyJSONValue>> {\n return withDagRead(delegate, async dagRead => {\n const tree = await getBTree(dagRead, clientID);\n const map = new Map<string, ReadonlyJSONValue>();\n for await (const [key, value] of tree.scan('')) {\n map.set(key, value);\n }\n return map;\n });\n}\n\nexport function clientRows(\n delegate: ExtendedInspectorDelegate,\n clientID: string,\n tableName: string,\n): Promise<Row[]> {\n return withDagRead(delegate, async dagRead => {\n const prefix = ENTITIES_KEY_PREFIX + tableName + '/';\n const tree = await getBTree(dagRead, clientID);\n const rows: Row[] = [];\n for await (const [key, value] of tree.scan(prefix)) {\n if (!key.startsWith(prefix)) {\n break;\n }\n rows.push(value as Row);\n }\n return rows;\n });\n}\n\nexport async function serverVersion(\n delegate: ExtendedInspectorDelegate,\n): Promise<string> {\n return rpc(\n await delegate.getSocket(),\n {op: 'version'},\n inspectVersionDownSchema,\n );\n}\n\nexport function clientQueries(\n delegate: ExtendedInspectorDelegate,\n clientID: string,\n): Promise<Query[]> {\n return queries(delegate, {op: 'queries', clientID});\n}\n\nasync function queries(\n delegate: ExtendedInspectorDelegate,\n arg: {op: 'queries'; clientID?: string},\n): Promise<Query[]> {\n const rows: InspectQueryRow[] = await rpc(\n await delegate.getSocket(),\n arg,\n inspectQueriesDownSchema,\n );\n const queries = rows.map(row => new Query(row, delegate, delegate.getSocket));\n queries.sort((a, b) => (b.hydrateServer ?? 0) - (a.hydrateServer ?? 0));\n return queries;\n}\n\nexport async function analyzeQuery(\n delegate: ExtendedInspectorDelegate,\n query: AnyQuery,\n options?: AnalyzeQueryOptions,\n): Promise<AnalyzeQueryResult> {\n const qi = asQueryInternals(query);\n const {customQueryID} = qi;\n const queryParameters = customQueryID\n ? {name: customQueryID.name, args: customQueryID.args}\n : {ast: delegate.mapClientASTToServer(qi.ast)};\n\n return rpc(\n await delegate.getSocket(),\n {\n op: 'analyze-query',\n ...queryParameters,\n options,\n },\n inspectAnalyzeQueryDownSchema,\n );\n}\n\nexport async function analyzeServerAST(\n delegate: ExtendedInspectorDelegate,\n ast: AST,\n options?: AnalyzeQueryOptions,\n): Promise<AnalyzeQueryResult> {\n return rpc(\n await delegate.getSocket(),\n {op: 'analyze-query', ast, options},\n inspectAnalyzeQueryDownSchema,\n );\n}\n\nexport async function analyzeNamedQuery(\n delegate: ExtendedInspectorDelegate,\n name: string,\n args: ReadonlyArray<ReadonlyJSONValue>,\n options?: AnalyzeQueryOptions,\n): Promise<AnalyzeQueryResult> {\n return rpc(\n await delegate.getSocket(),\n {op: 'analyze-query', name, args, options},\n inspectAnalyzeQueryDownSchema,\n );\n}\n\n/*\n Sends an `authenticate` op to the server. Returns `true` if the password\n * is accepted (or the server is in a development mode that bypasses the\n * check). Use this from Node contexts where the default interactive HTML\n * prompt used by other inspector RPCs is not available.\n */\nexport async function authenticate(\n delegate: ExtendedInspectorDelegate,\n password: string,\n): Promise<boolean> {\n return rpc(\n await delegate.getSocket(),\n {op: 'authenticate', value: password},\n inspectAuthenticatedDownSchema,\n );\n}\n\nclass UnauthenticatedError extends Error {}\n\nexport interface InspectorDelegate {\n getQueryMetrics(hash: string): QueryClientMetrics \| undefined;\n getAST(queryID: string): AST \| undefined;\n readonly metrics: ClientMetrics;\n mapClientASTToServer(ast: AST): AST;\n setQueryEvictedCallback(\n cb: (hash: string, ast: AST, metrics: QueryClientMetrics) => void,\n ): void;\n}\n\nexport interface ExtendedInspectorDelegate extends InspectorDelegate {\n readonly rep: Rep;\n readonly getSocket: () => Promise<WebSocket>;\n readonly queryDelegate: QueryDelegate;\n lazy: Promise<Lazy>;\n}\n\nexport type Rep = ReplicacheImpl<MutatorDefs>;\n\nexport type QueryClientMetrics = {\n readonly 'query-materialization-client': number \| undefined;\n readonly 'query-materialization-end-to-end': number \| undefined;\n readonly 'query-update-client': ReadonlyTDigest;\n};\n\nexport type ClientMetrics = {\n readonly [K in keyof ClientMetricMap]: ReadonlyTDigest;\n};\n\nexport type ServerMetrics = {\n readonly [K in keyof ServerMetricMap]: ReadonlyTDigest;\n};\n"],"mappings":";;;;;;;;;;;;;;;;AA0DA,eAAsB,IACpB,QACA,KACA,YACqB;CACrB,IAAI;EACF,OAAO,MAAM,aAAa,QAAQ,KAAK,UAAU;CACnD,SAAS,GAAG;EACV,IAAI,aAAa,sBAAsB;GACrC,MAAM,WAAW,MAAM,yBAAyB,iBAAiB;GACjE,IAAI;QAOE,MALkB,aACpB,QACA;KAAC,IAAI;KAAgB,OAAO;IAAQ,GACpC,8BACF,GAGE,OAAO,aAAa,QAAQ,KAAK,UAAU;GAAA;GAG/C,MAAM,IAAI,MAAM,uBAAuB;EACzC;EACA,MAAM;CACR;AACF;AAEA,SAAS,aACP,QACA,KACA,YACqB;CACrB,OAAO,IAAI,SAAS,SAAS,WAAW;EACtC,MAAM,KAAK,OAAO;EAClB,MAAM,KAAK,OAAqB;GAC9B,MAAM,MAAM,KAAK,MAAM,GAAG,IAAI;GAC9B,IAAI,IAAI,OAAO,WAAW;IACxB,MAAM,OAAO,IAAI;IACjB,IAAI,KAAK,OAAO,IACd;IAEF,MAAM,MAAM,KAAY,MAAM,UAAU;IACxC,IAAI,IAAI,IACN,IAAI,IAAI,MAAM,OAAO,SACnB,OAAO,IAAI,MAAM,IAAI,MAAM,KAAK,CAAC;SAEjC,QAAQ,IAAI,MAAM,KAAK;SAEpB;KAEL,MAAM,UAAU,KAAY,MAAM,8BAA8B;KAChE,IAAI,QAAQ,IAAI;MAEd,OACE,QAAQ,MAAM,UAAU,OACxB,mCACF;MACA,OAAO,IAAI,qBAAqB,CAAC;KACnC;KAEA,OAAO,IAAI,KAAK;IAClB;IACA,OAAO,oBAAoB,WAAW,CAAC;GACzC;EACF;EACA,OAAO,iBAAiB,WAAW,CAAC;EACpC,OAAO,KAAK,KAAK,UAAU,CAAC,WAAW;GAAC,GAAG;GAAK;EAAE,CAAC,CAAC,CAAC;CACvD,CAAC;AACH;AAEA,SAAgB,aACd,eACA,eAC+B;CAE/B,OAAO;EACL,GAAG,qBAFM,iBAAiB,iBAAiB,CAEjB;EAC1B,GAAI,gBACA,qBAAqB,aAAa,IAClC,iBAAiB;CACvB;AACF;AAEA,SAAS,mBAAuC;CAC9C,OAAO;EACL,gCAAgC,KAAA;EAChC,oCAAoC,KAAA;EACpC,uBAAuB,IAAI,QAAQ;CACrC;AACF;AAEA,SAAS,qBAAqB,SAA4C;CACxE,MAAM,gBAAgB,IAAI,QAAQ;CAClC,IAAI,QAAQ,oCAAoC,KAAA,GAC9C,cAAc,IAAI,QAAQ,+BAA+B;CAE3D,MAAM,cAAc,IAAI,QAAQ;CAChC,IAAI,QAAQ,wCAAwC,KAAA,GAClD,YAAY,IAAI,QAAQ,mCAAmC;CAE7D,OAAO;EACL,gCAAgC;EAChC,oCAAoC;EACpC,uBAAuB,QAAQ;CACjC;AACF;AAEA,SAAS,mBAAkC;CACzC,OAAO;EACL,gCAAgC,IAAI,QAAQ;EAC5C,uBAAuB,IAAI,QAAQ;CACrC;AACF;AAEA,SAAS,qBAAqB,SAAgD;CAC5E,MAAM,YAAY,QAAQ;CAC1B,MAAM,gBAAgB,IAAI,QAAQ;CAClC,IAAI,cAAc,KAAA,GAChB,cAAc,IAAI,SAAS;CAE7B,OAAO;EACL,gCAAgC;EAChC,uBAAuB,QAAQ,SAAS,QAAQ,sBAAsB;CACxE;AACF;AAEA,eAAsB,iBACpB,UACkB;CAClB,MAAM,gBAAgB,SAAS;CAC/B,MAAM,oBAAoB,MAAM,IAC9B,MAAM,SAAS,UAAU,GACzB,EAAC,IAAI,UAAS,GACd,wBACF;CACA,OAAO;EACL,GAAI,iBAAiB,iBAAiB;EACtC,gCAAgC,QAAQ,SACtC,kBAAkB,+BACpB;EACA,uBAAuB,QAAQ,SAC7B,kBAAkB,sBACpB;CACF;AACF;AAEA,SAAgB,iBACd,UACmB;CACnB,OAAO,YAAY,WAAU,YAAW,QAAQ,UAAU,OAAO,CAAC;AACpE;AAEA,SAAgB,4BACd,UACmB;CACnB,OAAO,YAAY,WAAU,YAC3B,mBAAmB,UAAU,OAAO,CACtC;AACF;AAEA,eAAe,YACb,UACA,GACY;CACZ,MAAM,EAAC,QAAO;CACd,MAAM,IAAI,QAAQ;CAClB,MAAM,IAAI,QAAQ;CAClB,OAAO,SAAS,IAAI,QAAQ,CAAC;AAC/B;AAEA,eAAe,SAAS,SAAe,UAAsC;CAC3E,MAAM,SAAS,MAAM,UAAU,UAAU,OAAO;CAChD,OAAO,QAAQ,qBAAqB,UAAU;CAC9C,MAAM,EAAC,kBAAiB;CACxB,MAAM,cAAc,MAAM,eAAe,eAAe,OAAO;CAC/D,OAAO,aAAa,2BAA2B,eAAe;CAM9D,QAAO,MALc,aACnB,YAAY,UACZ,SACA,CACF,GACc;AAChB;AAMA,eAAe,QACb,UACA,SACA,kBAA2D,MACxC;CAEnB,OAAO,CAAC,IAAG,MADW,WAAW,OAAO,GACrB,QAAQ,CAAC,EACzB,OAAO,SAAS,EAChB,KACE,CAAC,UAAU,EAAC,qBACX,IAAI,OAAO,UAAU,UAAU,aAAa,CAChD;AACJ;AAEA,eAAe,mBACb,UACA,SACA,kBAA2D,MACxC;CACnB,MAAM,aAAa,MAAM,QAAQ,UAAU,SAAS,SAAS;CAC7D,MAAM,qBAA+B,CAAC;CACtC,MAAM,QAAQ,IACZ,WAAW,IAAI,OAAM,WAAU;EAE7B,KAAI,MADkB,OAAO,QAAQ,GACzB,SAAS,GACnB,mBAAmB,KAAK,MAAM;CAElC,CAAC,CACH;CACA,OAAO;AACT;AAEA,eAAsB,mBACpB,UACA,eACmB;CACnB,MAAM,KAAK,MAAM;CACjB,OAAO,YAAY,WAAU,YAC3B,QAAQ,UAAU,UAAU,CAAC,GAAG,OAAO,EAAE,kBAAkB,EAAE,CAC/D;AACF;AAEA,eAAsB,8BACpB,UACA,eACmB;CACnB,MAAM,KAAK,MAAM;CACjB,OAAO,YAAY,WAAU,YAC3B,mBAAmB,UAAU,UAAU,CAAC,GAAG,OAAO,EAAE,kBAAkB,EAAE,CAC1E;AACF;AAEA,SAAgB,mBACd,UACkB;CAClB,OAAO,QAAQ,UAAU,EAAC,IAAI,UAAS,CAAC;AAC1C;AACA,SAAgB,UACd,UACA,UACyC;CACzC,OAAO,YAAY,UAAU,OAAM,YAAW;EAC5C,MAAM,OAAO,MAAM,SAAS,SAAS,QAAQ;EAC7C,MAAM,sBAAM,IAAI,IAA+B;EAC/C,WAAW,MAAM,CAAC,KAAK,UAAU,KAAK,KAAK,EAAE,GAC3C,IAAI,IAAI,KAAK,KAAK;EAEpB,OAAO;CACT,CAAC;AACH;AAEA,SAAgB,WACd,UACA,UACA,WACgB;CAChB,OAAO,YAAY,UAAU,OAAM,YAAW;EAC5C,MAAM,SAAA,OAA+B,YAAY;EACjD,MAAM,OAAO,MAAM,SAAS,SAAS,QAAQ;EAC7C,MAAM,OAAc,CAAC;EACrB,WAAW,MAAM,CAAC,KAAK,UAAU,KAAK,KAAK,MAAM,GAAG;GAClD,IAAI,CAAC,IAAI,WAAW,MAAM,GACxB;GAEF,KAAK,KAAK,KAAY;EACxB;EACA,OAAO;CACT,CAAC;AACH;AAEA,eAAsB,cACpB,UACiB;CACjB,OAAO,IACL,MAAM,SAAS,UAAU,GACzB,EAAC,IAAI,UAAS,GACd,wBACF;AACF;AAEA,SAAgB,cACd,UACA,UACkB;CAClB,OAAO,QAAQ,UAAU;EAAC,IAAI;EAAW;CAAQ,CAAC;AACpD;AAEA,eAAe,QACb,UACA,KACkB;CAMlB,MAAM,WAAU,MALsB,IACpC,MAAM,SAAS,UAAU,GACzB,KACA,wBACF,GACqB,KAAI,QAAO,IAAI,MAAM,KAAK,UAAU,SAAS,SAAS,CAAC;CAC5E,QAAQ,MAAM,GAAG,OAAO,EAAE,iBAAiB,MAAM,EAAE,iBAAiB,EAAE;CACtE,OAAO;AACT;AAEA,eAAsB,aACpB,UACA,OACA,SAC6B;CAC7B,MAAM,KAAK,iBAAiB,KAAK;CACjC,MAAM,EAAC,kBAAiB;CACxB,MAAM,kBAAkB,gBACpB;EAAC,MAAM,cAAc;EAAM,MAAM,cAAc;CAAI,IACnD,EAAC,KAAK,SAAS,qBAAqB,GAAG,GAAG,EAAC;CAE/C,OAAO,IACL,MAAM,SAAS,UAAU,GACzB;EACE,IAAI;EACJ,GAAG;EACH;CACF,GACA,6BACF;AACF;AAEA,eAAsB,iBACpB,UACA,KACA,SAC6B;CAC7B,OAAO,IACL,MAAM,SAAS,UAAU,GACzB;EAAC,IAAI;EAAiB;EAAK;CAAO,GAClC,6BACF;AACF;AAEA,eAAsB,kBACpB,UACA,MACA,MACA,SAC6B;CAC7B,OAAO,IACL,MAAM,SAAS,UAAU,GACzB;EAAC,IAAI;EAAiB;EAAM;EAAM;CAAO,GACzC,6BACF;AACF;;;;;;;AAQA,eAAsB,aACpB,UACA,UACkB;CAClB,OAAO,IACL,MAAM,SAAS,UAAU,GACzB;EAAC,IAAI;EAAgB,OAAO;CAAQ,GACpC,8BACF;AACF;AAEA,IAAM,uBAAN,cAAmC,MAAM,CAAC"}
1	+ {"version":3,"file":"lazy-inspector.js","names":[],"sources":["../../../../../../zero-client/src/client/inspector/lazy-inspector.ts"],"sourcesContent":["import type {BTreeRead} from '../../../../replicache/src/btree/read.ts';\nimport type {Read} from '../../../../replicache/src/dag/store.ts';\nimport {readFromHash} from '../../../../replicache/src/db/read.ts';\nimport * as FormatVersion from '../../../../replicache/src/format-version-enum.ts';\nimport {getClientGroup} from '../../../../replicache/src/persist/client-groups.ts';\nimport {\n getClient,\n getClients,\n type ClientMap,\n} from '../../../../replicache/src/persist/clients.ts';\nimport type {ReplicacheImpl} from '../../../../replicache/src/replicache-impl.ts';\nimport {withRead} from '../../../../replicache/src/with-transactions.ts';\nimport {assert} from '../../../../shared/src/asserts.ts';\nimport type {ReadonlyJSONValue} from '../../../../shared/src/json.ts';\nimport {TDigest, type ReadonlyTDigest} from '../../../../shared/src/tdigest.ts';\nimport * as valita from '../../../../shared/src/valita.ts';\nimport type {AnalyzeQueryResult} from '../../../../zero-protocol/src/analyze-query-result.ts';\nimport type {AST} from '../../../../zero-protocol/src/ast.ts';\nimport type {Row} from '../../../../zero-protocol/src/data.ts';\nimport {\n inspectAnalyzeQueryDownSchema,\n inspectAuthenticatedDownSchema,\n inspectMetricsDownSchema,\n inspectQueriesDownSchema,\n inspectVersionDownSchema,\n type InspectDownBody,\n type InspectQueryRow,\n type QueryServerMetrics as QueryServerMetricsJSON,\n} from '../../../../zero-protocol/src/inspect-down.ts';\nimport type {\n AnalyzeQueryOptions,\n InspectUpBody,\n} from '../../../../zero-protocol/src/inspect-up.ts';\nimport type {\n ClientMetricMap,\n ServerMetricMap,\n} from '../../../../zql/src/query/metrics-delegate.ts';\nimport type {QueryDelegate} from '../../../../zql/src/query/query-delegate.ts';\nimport {asQueryInternals} from '../../../../zql/src/query/query-internals.ts';\nimport type {AnyQuery} from '../../../../zql/src/query/query.ts';\nimport {nanoid} from '../../util/nanoid.ts';\nimport {ENTITIES_KEY_PREFIX} from '../keys.ts';\nimport type {MutatorDefs} from '../replicache-types.ts';\nimport {Client} from './client.ts';\nimport {createHTMLPasswordPrompt} from './html-dialog-prompt.ts';\nimport {type Lazy} from './inspector.ts';\nimport {Query} from './query.ts';\n\nexport type GetWebSocket = () => Promise<WebSocket>;\n\nexport type Metrics = {\n readonly [K in keyof (ClientMetricMap & ServerMetricMap)]: ReadonlyTDigest;\n};\n\ntype DistributiveOmit<T, K extends string> = T extends object\n ? Omit<T, K>\n : never;\n\nexport async function rpc<T extends InspectDownBody>(\n socket: WebSocket,\n arg: DistributiveOmit<InspectUpBody, 'id'>,\n downSchema: valita.Type<T>,\n): Promise<T['value']> {\n try {\n return await rpcNoAuthTry(socket, arg, downSchema);\n } catch (e) {\n if (e instanceof UnauthenticatedError) {\n const password = await createHTMLPasswordPrompt('Enter password:');\n if (password) {\n // Do authenticate rpc\n const authRes = await rpcNoAuthTry(\n socket,\n {op: 'authenticate', value: password},\n inspectAuthenticatedDownSchema,\n );\n if (authRes) {\n // If authentication is successful, retry the original RPC\n return rpcNoAuthTry(socket, arg, downSchema);\n }\n }\n throw new Error('Authentication failed');\n }\n throw e;\n }\n}\n\nfunction rpcNoAuthTry<T extends InspectDownBody>(\n socket: WebSocket,\n arg: DistributiveOmit<InspectUpBody, 'id'>,\n downSchema: valita.Type<T>,\n): Promise<T['value']> {\n return new Promise((resolve, reject) => {\n const id = nanoid();\n const f = (ev: MessageEvent) => {\n const msg = JSON.parse(ev.data);\n if (msg[0] === 'inspect') {\n const body = msg[1];\n if (body.id !== id) {\n return;\n }\n const res = valita.test(body, downSchema);\n if (res.ok) {\n if (res.value.op === 'error') {\n reject(new Error(res.value.value));\n } else {\n resolve(res.value.value);\n }\n } else {\n // Check if we got un authenticated/false response\n const authRes = valita.test(body, inspectAuthenticatedDownSchema);\n if (authRes.ok) {\n // Handle authenticated response\n assert(\n authRes.value.value === false,\n 'Expected unauthenticated response',\n );\n reject(new UnauthenticatedError());\n }\n\n reject(res.error);\n }\n socket.removeEventListener('message', f);\n }\n };\n socket.addEventListener('message', f);\n socket.send(JSON.stringify(['inspect', {...arg, id}]));\n });\n} // T extends forces T to be resolved\n\nexport function mergeMetrics(\n clientMetrics: QueryClientMetrics \| undefined,\n serverMetrics: QueryServerMetricsJSON \| null \| undefined,\n): ClientMetrics & ServerMetrics {\n const cm = clientMetrics ?? newClientMetrics();\n return {\n ...convertClientMetrics(cm),\n ...(serverMetrics\n ? convertServerMetrics(serverMetrics)\n : newServerMetrics()),\n };\n}\n\nfunction newClientMetrics(): QueryClientMetrics {\n return {\n 'query-materialization-client': undefined,\n 'query-materialization-end-to-end': undefined,\n 'query-update-client': new TDigest(),\n };\n}\n\nfunction convertClientMetrics(metrics: QueryClientMetrics): ClientMetrics {\n const hydrateDigest = new TDigest();\n if (metrics['query-materialization-client'] !== undefined) {\n hydrateDigest.add(metrics['query-materialization-client']);\n }\n const totalDigest = new TDigest();\n if (metrics['query-materialization-end-to-end'] !== undefined) {\n totalDigest.add(metrics['query-materialization-end-to-end']);\n }\n return {\n 'query-materialization-client': hydrateDigest,\n 'query-materialization-end-to-end': totalDigest,\n 'query-update-client': metrics['query-update-client'] as TDigest,\n };\n}\n\nfunction newServerMetrics(): ServerMetrics {\n return {\n 'query-materialization-server': new TDigest(),\n 'query-update-server': new TDigest(),\n };\n}\n\nfunction convertServerMetrics(metrics: QueryServerMetricsJSON): ServerMetrics {\n const hydrateMs = metrics['query-hydration-server-ms'];\n const hydrateDigest = new TDigest();\n if (hydrateMs !== undefined) {\n hydrateDigest.add(hydrateMs);\n }\n return {\n 'query-materialization-server': hydrateDigest,\n 'query-update-server': TDigest.fromJSON(metrics['query-update-server']),\n };\n}\n\nexport async function inspectorMetrics(\n delegate: ExtendedInspectorDelegate,\n): Promise<Metrics> {\n const clientMetrics = delegate.metrics;\n const serverMetricsJSON = await rpc(\n await delegate.getSocket(),\n {op: 'metrics'},\n inspectMetricsDownSchema,\n );\n return {\n ...(clientMetrics ?? newClientMetrics()),\n 'query-materialization-server': TDigest.fromJSON(\n serverMetricsJSON['query-materialization-server'],\n ),\n 'query-update-server': TDigest.fromJSON(\n serverMetricsJSON['query-update-server'],\n ),\n };\n}\n\nexport function inspectorClients(\n delegate: ExtendedInspectorDelegate,\n): Promise<Client[]> {\n return withDagRead(delegate, dagRead => clients(delegate, dagRead));\n}\n\nexport function inspectorClientsWithQueries(\n delegate: ExtendedInspectorDelegate,\n): Promise<Client[]> {\n return withDagRead(delegate, dagRead =>\n clientsWithQueries(delegate, dagRead),\n );\n}\n\nasync function withDagRead<T>(\n delegate: ExtendedInspectorDelegate,\n f: (dagRead: Read) => Promise<T>,\n): Promise<T> {\n const {rep} = delegate;\n await rep.refresh();\n await rep.persist();\n return withRead(rep.perdag, f);\n}\n\nasync function getBTree(dagRead: Read, clientID: string): Promise<BTreeRead> {\n const client = await getClient(clientID, dagRead);\n assert(client, `Client not found: ${clientID}`);\n const {clientGroupID} = client;\n const clientGroup = await getClientGroup(clientGroupID, dagRead);\n assert(clientGroup, `Client group not found: ${clientGroupID}`);\n const dbRead = await readFromHash(\n clientGroup.headHash,\n dagRead,\n FormatVersion.Latest,\n );\n return dbRead.map;\n}\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\ntype MapEntry<T extends ReadonlyMap<any, any>> =\n T extends ReadonlyMap<infer K, infer V> ? readonly [K, V] : never;\n\nasync function clients(\n delegate: ExtendedInspectorDelegate,\n dagRead: Read,\n predicate: (entry: MapEntry<ClientMap>) => boolean = () => true,\n): Promise<Client[]> {\n const clients = await getClients(dagRead);\n return [...clients.entries()]\n .filter(predicate)\n .map(\n ([clientID, {clientGroupID}]) =>\n new Client(delegate, clientID, clientGroupID),\n );\n}\n\nasync function clientsWithQueries(\n delegate: ExtendedInspectorDelegate,\n dagRead: Read,\n predicate: (entry: MapEntry<ClientMap>) => boolean = () => true,\n): Promise<Client[]> {\n const allClients = await clients(delegate, dagRead, predicate);\n const clientsWithQueries: Client[] = [];\n await Promise.all(\n allClients.map(async client => {\n const queries = await client.queries();\n if (queries.length > 0) {\n clientsWithQueries.push(client);\n }\n }),\n );\n return clientsWithQueries;\n}\n\nexport async function clientGroupClients(\n delegate: ExtendedInspectorDelegate,\n clientGroupID: Promise<string> \| string,\n): Promise<Client[]> {\n const id = await clientGroupID;\n return withDagRead(delegate, dagRead =>\n clients(delegate, dagRead, ([_, v]) => v.clientGroupID === id),\n );\n}\n\nexport async function clientGroupClientsWithQueries(\n delegate: ExtendedInspectorDelegate,\n clientGroupID: Promise<string> \| string,\n): Promise<Client[]> {\n const id = await clientGroupID;\n return withDagRead(delegate, dagRead =>\n clientsWithQueries(delegate, dagRead, ([_, v]) => v.clientGroupID === id),\n );\n}\n\nexport function clientGroupQueries(\n delegate: ExtendedInspectorDelegate,\n): Promise<Query[]> {\n return queries(delegate, {op: 'queries'});\n}\nexport function clientMap(\n delegate: ExtendedInspectorDelegate,\n clientID: string,\n): Promise<Map<string, ReadonlyJSONValue>> {\n return withDagRead(delegate, async dagRead => {\n const tree = await getBTree(dagRead, clientID);\n const map = new Map<string, ReadonlyJSONValue>();\n for await (const [key, value] of tree.scan('')) {\n map.set(key, value);\n }\n return map;\n });\n}\n\nexport function clientRows(\n delegate: ExtendedInspectorDelegate,\n clientID: string,\n tableName: string,\n): Promise<Row[]> {\n return withDagRead(delegate, async dagRead => {\n const prefix = ENTITIES_KEY_PREFIX + tableName + '/';\n const tree = await getBTree(dagRead, clientID);\n const rows: Row[] = [];\n for await (const [key, value] of tree.scan(prefix)) {\n if (!key.startsWith(prefix)) {\n break;\n }\n rows.push(value as Row);\n }\n return rows;\n });\n}\n\nexport async function serverVersion(\n delegate: ExtendedInspectorDelegate,\n): Promise<string> {\n return rpc(\n await delegate.getSocket(),\n {op: 'version'},\n inspectVersionDownSchema,\n );\n}\n\nexport function clientQueries(\n delegate: ExtendedInspectorDelegate,\n clientID: string,\n): Promise<Query[]> {\n return queries(delegate, {op: 'queries', clientID});\n}\n\nasync function queries(\n delegate: ExtendedInspectorDelegate,\n arg: {op: 'queries'; clientID?: string},\n): Promise<Query[]> {\n const rows: InspectQueryRow[] = await rpc(\n await delegate.getSocket(),\n arg,\n inspectQueriesDownSchema,\n );\n const queries = rows.map(row => new Query(row, delegate, delegate.getSocket));\n queries.sort((a, b) => (b.hydrateServer ?? 0) - (a.hydrateServer ?? 0));\n return queries;\n}\n\nexport async function analyzeQuery(\n delegate: ExtendedInspectorDelegate,\n query: AnyQuery,\n options?: AnalyzeQueryOptions,\n): Promise<AnalyzeQueryResult> {\n const qi = asQueryInternals(query);\n const {customQueryID} = qi;\n const queryParameters = customQueryID\n ? {name: customQueryID.name, args: customQueryID.args}\n : {ast: delegate.mapClientASTToServer(qi.ast)};\n\n return rpc(\n await delegate.getSocket(),\n {\n op: 'analyze-query',\n ...queryParameters,\n options,\n },\n inspectAnalyzeQueryDownSchema,\n );\n}\n\nexport async function analyzeServerAST(\n delegate: ExtendedInspectorDelegate,\n ast: AST,\n options?: AnalyzeQueryOptions,\n): Promise<AnalyzeQueryResult> {\n return rpc(\n await delegate.getSocket(),\n {op: 'analyze-query', ast, options},\n inspectAnalyzeQueryDownSchema,\n );\n}\n\nexport async function analyzeNamedQuery(\n delegate: ExtendedInspectorDelegate,\n name: string,\n args: ReadonlyArray<ReadonlyJSONValue>,\n options?: AnalyzeQueryOptions,\n): Promise<AnalyzeQueryResult> {\n return rpc(\n await delegate.getSocket(),\n {op: 'analyze-query', name, args, options},\n inspectAnalyzeQueryDownSchema,\n );\n}\n\n/*\n Sends an `authenticate` op to the server. Returns `true` if the password\n * is accepted (or the server is in a development mode that bypasses the\n * check). Use this from Node contexts where the default interactive HTML\n * prompt used by other inspector RPCs is not available.\n */\nexport async function authenticate(\n delegate: ExtendedInspectorDelegate,\n password: string,\n): Promise<boolean> {\n return rpc(\n await delegate.getSocket(),\n {op: 'authenticate', value: password},\n inspectAuthenticatedDownSchema,\n );\n}\n\nclass UnauthenticatedError extends Error {}\n\nexport interface InspectorDelegate {\n getQueryMetrics(hash: string): QueryClientMetrics \| undefined;\n getAST(queryID: string): AST \| undefined;\n readonly metrics: ClientMetrics;\n mapClientASTToServer(ast: AST): AST;\n setQueryEvictedCallback(\n cb: (hash: string, ast: AST, metrics: QueryClientMetrics) => void,\n ): void;\n}\n\nexport interface ExtendedInspectorDelegate extends InspectorDelegate {\n readonly rep: Rep;\n readonly getSocket: () => Promise<WebSocket>;\n readonly queryDelegate: QueryDelegate;\n lazy: Promise<Lazy>;\n}\n\nexport type Rep = ReplicacheImpl<MutatorDefs>;\n\nexport type QueryClientMetrics = {\n readonly 'query-materialization-client': number \| undefined;\n readonly 'query-materialization-end-to-end': number \| undefined;\n readonly 'query-update-client': ReadonlyTDigest;\n};\n\nexport type ClientMetrics = {\n readonly [K in keyof ClientMetricMap]: ReadonlyTDigest;\n};\n\nexport type ServerMetrics = {\n readonly [K in keyof ServerMetricMap]: ReadonlyTDigest;\n};\n"],"mappings":"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"}

package/out/zero-client/src/client/inspector/query.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"query.js","names":["#socket","#serverAST"],"sources":["../../../../../../zero-client/src/client/inspector/query.ts"],"sourcesContent":["import {astToZQL} from '../../../../ast-to-zql/src/ast-to-zql.ts';\nimport type {ReadonlyJSONValue} from '../../../../shared/src/json.ts';\nimport {must} from '../../../../shared/src/must.ts';\nimport type {AnalyzeQueryResult} from '../../../../zero-protocol/src/analyze-query-result.ts';\nimport type {AST} from '../../../../zero-protocol/src/ast.ts';\nimport {\n type InspectQueryRow,\n inspectAnalyzeQueryDownSchema,\n} from '../../../../zero-protocol/src/inspect-down.ts';\nimport type {AnalyzeQueryOptions} from '../../../../zero-protocol/src/inspect-up.ts';\nimport {type TTL, normalizeTTL} from '../../../../zql/src/query/ttl.ts';\nimport {\n type ExtendedInspectorDelegate,\n type GetWebSocket,\n type Metrics,\n mergeMetrics,\n rpc,\n} from './lazy-inspector.ts';\n\nexport class Query {\n readonly #socket: GetWebSocket;\n\n readonly name: string \| null;\n readonly args: ReadonlyArray<ReadonlyJSONValue> \| null;\n readonly got: boolean;\n readonly ttl: TTL;\n readonly inactivatedAt: Date \| null;\n readonly rowCount: number;\n readonly deleted: boolean;\n readonly id: string;\n readonly clientID: string;\n readonly metrics: Metrics \| null;\n readonly clientZQL: string \| null;\n readonly serverZQL: string \| null;\n readonly #serverAST: AST \| null;\n\n readonly hydrateClient: number \| null;\n readonly hydrateServer: number \| null;\n readonly hydrateTotal: number \| null;\n\n readonly updateClientP50: number \| null;\n readonly updateClientP95: number \| null;\n readonly updateServerP50: number \| null;\n readonly updateServerP95: number \| null;\n\n constructor(\n row: InspectQueryRow,\n delegate: ExtendedInspectorDelegate,\n socket: GetWebSocket,\n ) {\n this.#socket = socket;\n\n const {ast, queryID, inactivatedAt} = row;\n // Use own properties to make this more useful in dev tools. For example, in\n // Chrome dev tools, if you do console.table(queries) you'll see the\n // properties in the table, if these were getters you would not see them in the table.\n this.clientID = row.clientID;\n this.id = queryID;\n this.inactivatedAt =\n inactivatedAt === null ? null : new Date(inactivatedAt);\n this.ttl = normalizeTTL(row.ttl);\n this.name = row.name;\n this.args = row.args;\n this.got = row.got;\n this.rowCount = row.rowCount;\n this.deleted = row.deleted;\n this.#serverAST = ast;\n this.serverZQL = ast ? ast.table + astToZQL(ast) : null;\n const clientAST = delegate.getAST(queryID);\n this.clientZQL = clientAST ? clientAST.table + astToZQL(clientAST) : null;\n\n // Merge client and server metrics\n const clientMetrics = delegate.getQueryMetrics(queryID);\n const serverMetrics = row.metrics;\n\n const merged = mergeMetrics(clientMetrics, serverMetrics);\n this.metrics = merged;\n\n const percentile = (\n name: keyof typeof merged,\n percentile: number,\n ): number \| null => {\n if (!merged?.[name]) {\n return null;\n }\n const n = merged[name].quantile(percentile);\n return Number.isNaN(n) ? null : n;\n };\n\n // Hydration times are plain numbers (performance.now()-based durations), so\n // read them directly instead of going through the TDigest percentile path.\n this.hydrateClient =\n clientMetrics?.['query-materialization-client'] ?? null;\n this.hydrateServer = serverMetrics?.['query-hydration-server-ms'] ?? null;\n this.hydrateTotal =\n clientMetrics?.['query-materialization-end-to-end'] ?? null;\n\n // Extract update metrics (P50 and P95) - handle NaN by defaulting to 0\n this.updateClientP50 = percentile('query-update-client', 0.5);\n this.updateClientP95 = percentile('query-update-client', 0.95);\n\n this.updateServerP50 = percentile('query-update-server', 0.5);\n this.updateServerP95 = percentile('query-update-server', 0.95);\n }\n\n async analyze(options?: AnalyzeQueryOptions): Promise<AnalyzeQueryResult> {\n const details =\n this.name && this.args\n ? {\n name: this.name,\n args: this.args,\n }\n : {value: must(this.#serverAST, 'AST is required for unnamed queries')};\n\n return rpc(\n await this.#socket(),\n {\n op: 'analyze-query',\n ...details,\n options,\n },\n inspectAnalyzeQueryDownSchema,\n );\n }\n}\n"],"mappings":";;;;;;AAmBA,IAAa,QAAb,MAAmB;CACjB;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CAEA;CACA;CACA;CACA;CAEA,YACE,KACA,UACA,QACA;~~EACA~~,~~KAAKA~~,~~UAAU~~;EAEf,MAAM,EAAC,KAAK,SAAS,kBAAiB;~~EAItC~~,~~KAAK~~,WAAW,IAAI;~~EACpB~~,~~KAAK~~,KAAK;~~EACV~~,~~KAAK~~,gBACH,kBAAkB,OAAO,OAAO,IAAI,KAAK,~~aAAa~~;~~EACxD~~,~~KAAK~~,MAAM,aAAa,IAAI,~~GAAG~~;~~EAC/B~~,~~KAAK~~,OAAO,IAAI;~~EAChB~~,~~KAAK~~,OAAO,IAAI;~~EAChB~~,~~KAAK~~,MAAM,IAAI;~~EACf~~,~~KAAK~~,WAAW,IAAI;~~EACpB~~,~~KAAK~~,UAAU,IAAI;~~EACnB~~,~~KAAKC~~,~~aAAa~~;~~EAClB~~,~~KAAK~~,YAAY,MAAM,IAAI,QAAQ,SAAS,GAAG~~,IAAI~~;EACnD,MAAM,YAAY,SAAS,OAAO,~~OAAO~~;~~EACzC~~,~~KAAK~~,YAAY,YAAY,UAAU,QAAQ,SAAS,~~SAAS~~,~~IAAI~~;EAGrE,MAAM,gBAAgB,SAAS,gBAAgB,~~OAAO~~;~~EACtD~~,MAAM,gBAAgB,IAAI;EAE1B,MAAM,SAAS,aAAa,eAAe,~~aAAa~~;~~EACxD~~,~~KAAK~~,UAAU;EAEf,MAAM,cACJ,MACA,eACkB;~~GAClB~~,~~IAAI~~,CAAC,SAAS,~~OACZ~~,~~OAAO~~;GAET,MAAM,IAAI,OAAO,MAAM,SAAS,~~UAAU~~;~~GAC1C~~,~~OAAO~~,OAAO,MAAM,~~CAAC~~,~~IAAI~~,OAAO~~;EAClC;EAIA~~,~~KAAK~~,gBACH,gBAAgB,mCAAmC;~~EACrD~~,~~KAAK~~,gBAAgB,gBAAgB,gCAAgC;~~EACrE~~,~~KAAK~~,eACH,gBAAgB,uCAAuC;~~EAGzD~~,~~KAAK~~,kBAAkB,WAAW,uBAAuB,~~EAAG~~;~~EAC5D~~,~~KAAK~~,kBAAkB,WAAW,uBAAuB,~~GAAI~~;~~EAE7D~~,~~KAAK~~,kBAAkB,WAAW,uBAAuB,~~EAAG~~;~~EAC5D~~,~~KAAK~~,kBAAkB,WAAW,uBAAuB,~~GAAI;CAC/D;CAEA~~,MAAM,QAAQ,SAA4D;EACxE,MAAM,UACJ,KAAK,QAAQ,KAAK,OACd;GACE,MAAM,KAAK;GACX,MAAM,KAAK;~~EACb~~,~~IACA~~,EAAC,OAAO,KAAK,~~KAAKA~~,~~YAAY~~,~~qCAAqC~~,EAAC;~~EAE1E~~,~~OAAO~~,IACL,MAAM,~~KAAKD~~,~~QAAQ~~,~~GACnB~~;GACE,IAAI;GACJ,GAAG;GACH;~~EACF~~,~~GACA~~,~~6BACF;CACF;AACF~~"}
1	+ {"version":3,"file":"query.js","names":["#socket","#serverAST"],"sources":["../../../../../../zero-client/src/client/inspector/query.ts"],"sourcesContent":["import {astToZQL} from '../../../../ast-to-zql/src/ast-to-zql.ts';\nimport type {ReadonlyJSONValue} from '../../../../shared/src/json.ts';\nimport {must} from '../../../../shared/src/must.ts';\nimport type {AnalyzeQueryResult} from '../../../../zero-protocol/src/analyze-query-result.ts';\nimport type {AST} from '../../../../zero-protocol/src/ast.ts';\nimport {\n type InspectQueryRow,\n inspectAnalyzeQueryDownSchema,\n} from '../../../../zero-protocol/src/inspect-down.ts';\nimport type {AnalyzeQueryOptions} from '../../../../zero-protocol/src/inspect-up.ts';\nimport {type TTL, normalizeTTL} from '../../../../zql/src/query/ttl.ts';\nimport {\n type ExtendedInspectorDelegate,\n type GetWebSocket,\n type Metrics,\n mergeMetrics,\n rpc,\n} from './lazy-inspector.ts';\n\nexport class Query {\n readonly #socket: GetWebSocket;\n\n readonly name: string \| null;\n readonly args: ReadonlyArray<ReadonlyJSONValue> \| null;\n readonly got: boolean;\n readonly ttl: TTL;\n readonly inactivatedAt: Date \| null;\n readonly rowCount: number;\n readonly deleted: boolean;\n readonly id: string;\n readonly clientID: string;\n readonly metrics: Metrics \| null;\n readonly clientZQL: string \| null;\n readonly serverZQL: string \| null;\n readonly #serverAST: AST \| null;\n\n readonly hydrateClient: number \| null;\n readonly hydrateServer: number \| null;\n readonly hydrateTotal: number \| null;\n\n readonly updateClientP50: number \| null;\n readonly updateClientP95: number \| null;\n readonly updateServerP50: number \| null;\n readonly updateServerP95: number \| null;\n\n constructor(\n row: InspectQueryRow,\n delegate: ExtendedInspectorDelegate,\n socket: GetWebSocket,\n ) {\n this.#socket = socket;\n\n const {ast, queryID, inactivatedAt} = row;\n // Use own properties to make this more useful in dev tools. For example, in\n // Chrome dev tools, if you do console.table(queries) you'll see the\n // properties in the table, if these were getters you would not see them in the table.\n this.clientID = row.clientID;\n this.id = queryID;\n this.inactivatedAt =\n inactivatedAt === null ? null : new Date(inactivatedAt);\n this.ttl = normalizeTTL(row.ttl);\n this.name = row.name;\n this.args = row.args;\n this.got = row.got;\n this.rowCount = row.rowCount;\n this.deleted = row.deleted;\n this.#serverAST = ast;\n this.serverZQL = ast ? ast.table + astToZQL(ast) : null;\n const clientAST = delegate.getAST(queryID);\n this.clientZQL = clientAST ? clientAST.table + astToZQL(clientAST) : null;\n\n // Merge client and server metrics\n const clientMetrics = delegate.getQueryMetrics(queryID);\n const serverMetrics = row.metrics;\n\n const merged = mergeMetrics(clientMetrics, serverMetrics);\n this.metrics = merged;\n\n const percentile = (\n name: keyof typeof merged,\n percentile: number,\n ): number \| null => {\n if (!merged?.[name]) {\n return null;\n }\n const n = merged[name].quantile(percentile);\n return Number.isNaN(n) ? null : n;\n };\n\n // Hydration times are plain numbers (performance.now()-based durations), so\n // read them directly instead of going through the TDigest percentile path.\n this.hydrateClient =\n clientMetrics?.['query-materialization-client'] ?? null;\n this.hydrateServer = serverMetrics?.['query-hydration-server-ms'] ?? null;\n this.hydrateTotal =\n clientMetrics?.['query-materialization-end-to-end'] ?? null;\n\n // Extract update metrics (P50 and P95) - handle NaN by defaulting to 0\n this.updateClientP50 = percentile('query-update-client', 0.5);\n this.updateClientP95 = percentile('query-update-client', 0.95);\n\n this.updateServerP50 = percentile('query-update-server', 0.5);\n this.updateServerP95 = percentile('query-update-server', 0.95);\n }\n\n async analyze(options?: AnalyzeQueryOptions): Promise<AnalyzeQueryResult> {\n const details =\n this.name && this.args\n ? {\n name: this.name,\n args: this.args,\n }\n : {value: must(this.#serverAST, 'AST is required for unnamed queries')};\n\n return rpc(\n await this.#socket(),\n {\n op: 'analyze-query',\n ...details,\n options,\n },\n inspectAnalyzeQueryDownSchema,\n );\n }\n}\n"],"mappings":";;;;;;AAmBA,IAAa,QAAb,MAAmB;CACjB;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CAEA;CACA;CACA;CACA;CAEA,YACE,KACA,UACA,QACA;AACA,QAAA,SAAe;EAEf,MAAM,EAAC,KAAK,SAAS,kBAAiB;AAItC,OAAK,WAAW,IAAI;AACpB,OAAK,KAAK;AACV,OAAK,gBACH,kBAAkB,OAAO,OAAO,IAAI,KAAK,cAAc;AACzD,OAAK,MAAM,aAAa,IAAI,IAAI;AAChC,OAAK,OAAO,IAAI;AAChB,OAAK,OAAO,IAAI;AAChB,OAAK,MAAM,IAAI;AACf,OAAK,WAAW,IAAI;AACpB,OAAK,UAAU,IAAI;AACnB,QAAA,YAAkB;AAClB,OAAK,YAAY,MAAM,IAAI,QAAQ,SAAS,IAAI,GAAG;EACnD,MAAM,YAAY,SAAS,OAAO,QAAQ;AAC1C,OAAK,YAAY,YAAY,UAAU,QAAQ,SAAS,UAAU,GAAG;EAGrE,MAAM,gBAAgB,SAAS,gBAAgB,QAAQ;EACvD,MAAM,gBAAgB,IAAI;EAE1B,MAAM,SAAS,aAAa,eAAe,cAAc;AACzD,OAAK,UAAU;EAEf,MAAM,cACJ,MACA,eACkB;AAClB,OAAI,CAAC,SAAS,MACZ,QAAO;GAET,MAAM,IAAI,OAAO,MAAM,SAAS,WAAW;AAC3C,UAAO,OAAO,MAAM,EAAE,GAAG,OAAO;;AAKlC,OAAK,gBACH,gBAAgB,mCAAmC;AACrD,OAAK,gBAAgB,gBAAgB,gCAAgC;AACrE,OAAK,eACH,gBAAgB,uCAAuC;AAGzD,OAAK,kBAAkB,WAAW,uBAAuB,GAAI;AAC7D,OAAK,kBAAkB,WAAW,uBAAuB,IAAK;AAE9D,OAAK,kBAAkB,WAAW,uBAAuB,GAAI;AAC7D,OAAK,kBAAkB,WAAW,uBAAuB,IAAK;;CAGhE,MAAM,QAAQ,SAA4D;EACxE,MAAM,UACJ,KAAK,QAAQ,KAAK,OACd;GACE,MAAM,KAAK;GACX,MAAM,KAAK;GACZ,GACD,EAAC,OAAO,KAAK,MAAA,WAAiB,sCAAsC,EAAC;AAE3E,SAAO,IACL,MAAM,MAAA,QAAc,EACpB;GACE,IAAI;GACJ,GAAG;GACH;GACD,EACD,8BACD"}

package/out/zero-client/src/client/ivm-branch.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"ivm-branch.js","names":["#sources","#tables","#throwIfInvalid","#advanceError"],"sources":["../../../../../zero-client/src/client/ivm-branch.ts"],"sourcesContent":["import type {\n InternalDiff,\n InternalDiffOperation,\n NoIndexDiff,\n} from '../../../replicache/src/btree/node.ts';\nimport type {LazyStore} from '../../../replicache/src/dag/lazy-store.ts';\nimport {type Read, type Store} from '../../../replicache/src/dag/store.ts';\nimport {readFromHash} from '../../../replicache/src/db/read.ts';\nimport * as FormatVersion from '../../../replicache/src/format-version-enum.ts';\nimport type {Hash} from '../../../replicache/src/hash.ts';\nimport type {ZeroReadOptions} from '../../../replicache/src/replicache-options.ts';\nimport {diffBinarySearch} from '../../../replicache/src/subscriptions.ts';\nimport type {DiffsMap} from '../../../replicache/src/sync/diff.ts';\nimport {diff} from '../../../replicache/src/sync/diff.ts';\nimport {using, withRead} from '../../../replicache/src/with-transactions.ts';\nimport {assert} from '../../../shared/src/asserts.ts';\nimport {wrapIterable} from '../../../shared/src/iterables.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport type {Row} from '../../../zero-protocol/src/data.ts';\nimport type {TableSchema} from '../../../zero-schema/src/table-schema.ts';\nimport {MemorySource} from '../../../zql/src/ivm/memory-source.ts';\nimport {consume} from '../../../zql/src/ivm/stream.ts';\nimport {ENTITIES_KEY_PREFIX, sourceNameFromKey} from './keys.ts';\n\nimport {\n makeSourceChangeAdd,\n makeSourceChangeEdit,\n makeSourceChangeRemove,\n} from '../../../zql/src/ivm/source.ts';\n/*\n Replicache needs to rebase mutations onto different\n * commits of it's b-tree. These mutations can have reads\n * in them and those reads must be run against the IVM sources.\n \n To ensure the reads get the correct state, the IVM\n * sources need to reflect the state of the commit\n * being rebased onto. `IVMSourceBranch` allows us to:\n * 1. fork the IVM sources\n * 2. patch them up to match the desired head\n * 3. run the reads against the forked sources\n \n (2) is expected to be a cheap operation as there should only\n * ever be a few outstanding diffs to apply given Zero is meant\n * to be run in a connected state.\n /\nexport class IVMSourceBranch {\n readonly #sources: Map<string, MemorySource \| undefined>;\n readonly #tables: Record<string, TableSchema>;\n #advanceError: unknown;\n hash: Hash \| undefined;\n\n constructor(\n tables: Record<string, TableSchema>,\n hash?: Hash,\n sources: Map<string, MemorySource \| undefined> = new Map(),\n ) {\n this.#tables = tables;\n this.#sources = sources;\n this.hash = hash;\n }\n\n getSource(name: string): MemorySource \| undefined {\n this.#throwIfInvalid();\n\n if (this.#sources.has(name)) {\n return this.#sources.get(name);\n }\n\n const schema = this.#tables[name];\n const source = schema\n ? new MemorySource(name, schema.columns, schema.primaryKey)\n : undefined;\n this.#sources.set(name, source);\n return source;\n }\n\n clear() {\n this.#sources.clear();\n }\n\n #throwIfInvalid() {\n if (this.#advanceError) {\n throw this.#advanceError;\n }\n }\n\n /\n Mutates the current branch, advancing it to the new head\n * by applying the given diffs.\n /\n advance(expectedHead: Hash \| undefined, newHead: Hash, diffs: NoIndexDiff) {\n this.#throwIfInvalid();\n\n assert(\n this.hash === expectedHead,\n () =>\n `Expected head must match the main head. Got: ${this.hash}, expected: ${expectedHead}`,\n );\n\n try {\n applyDiffs(diffs, this);\n this.hash = newHead;\n } catch (e) {\n this.#advanceError = e;\n this.clear();\n throw e;\n }\n }\n\n /\n Fork the branch and patch it up to match the desired head.\n /\n async forkToHead(\n store: LazyStore,\n desiredHead: Hash,\n readOptions?: ZeroReadOptions,\n ): Promise<IVMSourceBranch> {\n this.#throwIfInvalid();\n\n const fork = this.fork();\n\n if (fork.hash === desiredHead) {\n return fork;\n }\n\n await patchBranch(desiredHead, store, fork, readOptions);\n fork.hash = desiredHead;\n return fork;\n }\n\n /\n Creates a new IVMSourceBranch that is a copy of the current one.\n * This is a cheap operation since the b-trees are shared until a write is performed\n * and then only the modified nodes are copied.\n \n IVM branches are forked when we need to rebase mutations.\n * The mutations modify the fork rather than original branch.\n */\n fork() {\n this.#throwIfInvalid();\n\n return new IVMSourceBranch(\n this.#tables,\n this.hash,\n new Map(\n wrapIterable(this.#sources.entries()).map(([name, source]) => [\n name,\n source?.fork(),\n ]),\n ),\n );\n }\n}\n\nexport async function initFromStore(\n branch: IVMSourceBranch,\n hash: Hash,\n store: Store,\n) {\n const diffs: InternalDiffOperation[] = [];\n await withRead(store, async dagRead => {\n const read = await readFromHash(hash, dagRead, FormatVersion.Latest);\n for await (const entry of read.map.scan(ENTITIES_KEY_PREFIX)) {\n if (!entry[0].startsWith(ENTITIES_KEY_PREFIX)) {\n break;\n }\n diffs.push({\n op: 'add',\n key: entry[0],\n newValue: entry[1],\n });\n }\n });\n\n branch.advance(undefined, hash, diffs);\n}\n\nasync function patchBranch(\n desiredHead: Hash,\n store: LazyStore,\n fork: IVMSourceBranch,\n readOptions: ZeroReadOptions \| undefined,\n) {\n const diffs = await computeDiffs(\n must(fork.hash),\n desiredHead,\n store,\n readOptions,\n );\n if (!diffs) {\n return;\n }\n applyDiffs(diffs, fork);\n}\n\nasync function computeDiffs(\n startHash: Hash,\n endHash: Hash,\n store: LazyStore,\n readOptions: ZeroReadOptions \| undefined,\n): Promise<InternalDiff \| undefined> {\n const readFn = (dagRead: Read) =>\n diff(\n startHash,\n endHash,\n dagRead,\n {\n shouldComputeDiffs: () => true,\n shouldComputeDiffsForIndex(_name) {\n return false;\n },\n },\n FormatVersion.Latest,\n );\n\n let diffs: DiffsMap;\n if (readOptions?.openLazySourceRead) {\n diffs = await using(store.read(readOptions.openLazySourceRead), readFn);\n } else if (readOptions?.openLazyRead) {\n diffs = await readFn(readOptions.openLazyRead);\n } else {\n diffs = await withRead(store, readFn);\n }\n\n return diffs.get('');\n}\n\nfunction applyDiffs(diffs: NoIndexDiff, branch: IVMSourceBranch) {\n for (\n let i = diffBinarySearch(diffs, ENTITIES_KEY_PREFIX, diff => diff.key);\n i < diffs.length;\n i++\n ) {\n const diff = diffs[i];\n const {key} = diff;\n if (!key.startsWith(ENTITIES_KEY_PREFIX)) {\n break;\n }\n const name = sourceNameFromKey(key);\n const source = must(branch.getSource(name));\n switch (diff.op) {\n case 'del':\n consume(source.push(makeSourceChangeRemove(diff.oldValue as Row)));\n break;\n case 'add':\n consume(source.push(makeSourceChangeAdd(diff.newValue as Row)));\n break;\n case 'change':\n consume(\n source.push(\n makeSourceChangeEdit(diff.newValue as Row, diff.oldValue as Row),\n ),\n );\n break;\n }\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,IAAa,kBAAb,MAAa,gBAAgB;CAC3B;CACA;CACA;CACA;CAEA,YACE,QACA,MACA,0BAAiD,IAAI,~~IAAI~~,~~GACzD~~;~~EACA~~,~~KAAKC~~,~~UAAU~~;~~EACf~~,~~KAAKD~~,~~WAAW~~;~~EAChB~~,~~KAAK~~,OAAO~~;CACd;CAEA~~,UAAU,MAAwC;~~EAChD~~,~~KAAKE~~,~~gBAAgB~~;~~EAErB~~,~~IAAI~~,~~KAAKF~~,~~SAAS~~,IAAI,~~IAAI~~,~~GACxB~~,~~OAAO~~,~~KAAKA~~,~~SAAS~~,IAAI,~~IAAI~~;~~EAG/B~~,MAAM,SAAS,~~KAAKC~~,~~QAAQ~~;EAC5B,MAAM,SAAS,SACX,IAAI,aAAa,MAAM,OAAO,SAAS,OAAO,~~UAAU~~,~~IACxD~~,KAAA;~~EACJ~~,~~KAAKD~~,~~SAAS~~,IAAI,MAAM,~~MAAM;EAC9B,~~OAAO;~~CACT;CAEA~~,QAAQ;~~EACN~~,~~KAAKA~~,~~SAAS~~,~~MAAM;CACtB;CAEA~~,kBAAkB;~~EAChB~~,~~IAAI~~,~~KAAKG~~,~~eACP~~,~~MAAM~~,~~KAAKA;CAEf;;;;;CAMA~~,QAAQ,cAAgC,SAAe,OAAoB;~~EACzE~~,~~KAAKD~~,~~gBAAgB~~;~~EAErB~~,~~OACE~~,KAAK,SAAS,oBAEZ,gDAAgD,KAAK,KAAK,cAAc,~~cAC5E~~;~~EAEA~~,~~IAAI~~;~~GACF~~,~~WAAW~~,OAAO,~~IAAI~~;~~GACtB~~,~~KAAK~~,OAAO;~~EACd~~,~~SAAS,~~GAAG;~~GACV~~,~~KAAKC~~,~~gBAAgB~~;~~GACrB~~,~~KAAK~~,~~MAAM~~;~~GACX~~,~~MAAM;EACR;CACF;;;;CAKA~~,MAAM,WACJ,OACA,aACA,aAC0B;~~EAC1B~~,~~KAAKD~~,~~gBAAgB~~;~~EAErB~~,MAAM,OAAO,KAAK,~~KAAK~~;~~EAEvB~~,~~IAAI~~,KAAK,SAAS,~~aAChB~~,~~OAAO~~;~~EAGT~~,~~MAAM~~,YAAY,aAAa,OAAO,MAAM,~~WAAW~~;~~EACvD~~,~~KAAK~~,OAAO;~~EACZ~~,~~OAAO;CACT;;;;;;;;;CAUA~~,OAAO;~~EACL~~,~~KAAKA~~,~~gBAAgB~~;~~EAErB~~,~~OAAO~~,IAAI,gBACT,~~KAAKD~~,~~SACL~~,KAAK,MACL,IAAI,IACF,aAAa,~~KAAKD~~,SAAS,~~QAAQ~~,CAAC,~~EAAE,~~KAAK,CAAC,MAAM,YAAY,CAC5D,MACA,QAAQ,~~KAAK~~,CACf,CAAC,CACH,CACF~~;CACF;AACF;AAyBA~~,eAAe,YACb,aACA,OACA,MACA,aACA;CACA,MAAM,QAAQ,MAAM,aAClB,KAAK,KAAK,~~IAAI~~,~~GACd~~,aACA,OACA,~~WACF~~;~~CACA~~,~~IAAI~~,CAAC,~~OACH~~;~~CAEF~~,~~WAAW~~,OAAO,~~IAAI;AACxB;AAEA~~,eAAe,aACb,WACA,SACA,OACA,aACmC;CACnC,MAAM,UAAU,YACd,KACE,WACA,SACA,SACA;EACE,0BAA0B;EAC1B,2BAA2B,OAAO;~~GAChC~~,~~OAAO;EACT;CACF~~,~~GACA~~,~~CACF~~;~~CAEF~~,IAAI;~~CACJ~~,~~IAAI~~,aAAa,~~oBACf~~,~~QAAQ~~,MAAM,MAAM,MAAM,KAAK,YAAY,~~kBAAkB~~,~~GAAG~~,~~MAAM~~;~~MACjE~~,~~IAAI,~~aAAa,~~cACtB~~,~~QAAQ~~,MAAM,OAAO,YAAY,~~YAAY~~;~~MAE7C~~,~~QAAQ~~,MAAM,SAAS,OAAO,~~MAAM~~;~~CAGtC~~,~~OAAO~~,MAAM,IAAI,~~EAAE;AACrB;AAEA~~,SAAS,WAAW,OAAoB,QAAyB;~~CAC~~/D,~~KACE~~,IAAI,IAAI,iBAAiB,OAAA,OAA4B,SAAQ,KAAK,~~GAAG~~,~~GACrE~~,IAAI,MAAM,QACV,KACA;EACA,MAAM,OAAO,MAAM;EACnB,MAAM,EAAC,QAAO;~~EACd~~,~~IAAI~~,CAAC,IAAI,WAAA,~~IAA8B~~,~~GACrC~~;EAEF,MAAM,OAAO,kBAAkB,~~GAAG~~;~~EAClC~~,MAAM,SAAS,KAAK,OAAO,UAAU,~~IAAI~~,CAAC;~~EAC1C~~,~~QAAQ~~,KAAK,IAAb;GACE,KAAK;~~IACH~~,~~QAAQ~~,OAAO,KAAK,uBAAuB,KAAK,~~QAAe~~,CAAC,CAAC;~~IACjE~~;GACF,KAAK;~~IACH~~,~~QAAQ~~,OAAO,KAAK,oBAAoB,KAAK,~~QAAe~~,CAAC,CAAC;~~IAC9D~~;GACF,KAAK;~~IACH~~,~~QACE~~,OAAO,KACL,qBAAqB,KAAK,UAAiB,KAAK,~~QAAe~~,CACjE,CACF;~~IACA;EACJ;CACF;AACF~~"}
1	+ {"version":3,"file":"ivm-branch.js","names":["#sources","#tables","#throwIfInvalid","#advanceError"],"sources":["../../../../../zero-client/src/client/ivm-branch.ts"],"sourcesContent":["import type {\n InternalDiff,\n InternalDiffOperation,\n NoIndexDiff,\n} from '../../../replicache/src/btree/node.ts';\nimport type {LazyStore} from '../../../replicache/src/dag/lazy-store.ts';\nimport {type Read, type Store} from '../../../replicache/src/dag/store.ts';\nimport {readFromHash} from '../../../replicache/src/db/read.ts';\nimport * as FormatVersion from '../../../replicache/src/format-version-enum.ts';\nimport type {Hash} from '../../../replicache/src/hash.ts';\nimport type {ZeroReadOptions} from '../../../replicache/src/replicache-options.ts';\nimport {diffBinarySearch} from '../../../replicache/src/subscriptions.ts';\nimport type {DiffsMap} from '../../../replicache/src/sync/diff.ts';\nimport {diff} from '../../../replicache/src/sync/diff.ts';\nimport {using, withRead} from '../../../replicache/src/with-transactions.ts';\nimport {assert} from '../../../shared/src/asserts.ts';\nimport {wrapIterable} from '../../../shared/src/iterables.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport type {Row} from '../../../zero-protocol/src/data.ts';\nimport type {TableSchema} from '../../../zero-schema/src/table-schema.ts';\nimport {MemorySource} from '../../../zql/src/ivm/memory-source.ts';\nimport {consume} from '../../../zql/src/ivm/stream.ts';\nimport {ENTITIES_KEY_PREFIX, sourceNameFromKey} from './keys.ts';\n\nimport {\n makeSourceChangeAdd,\n makeSourceChangeEdit,\n makeSourceChangeRemove,\n} from '../../../zql/src/ivm/source.ts';\n/*\n Replicache needs to rebase mutations onto different\n * commits of it's b-tree. These mutations can have reads\n * in them and those reads must be run against the IVM sources.\n \n To ensure the reads get the correct state, the IVM\n * sources need to reflect the state of the commit\n * being rebased onto. `IVMSourceBranch` allows us to:\n * 1. fork the IVM sources\n * 2. patch them up to match the desired head\n * 3. run the reads against the forked sources\n \n (2) is expected to be a cheap operation as there should only\n * ever be a few outstanding diffs to apply given Zero is meant\n * to be run in a connected state.\n /\nexport class IVMSourceBranch {\n readonly #sources: Map<string, MemorySource \| undefined>;\n readonly #tables: Record<string, TableSchema>;\n #advanceError: unknown;\n hash: Hash \| undefined;\n\n constructor(\n tables: Record<string, TableSchema>,\n hash?: Hash,\n sources: Map<string, MemorySource \| undefined> = new Map(),\n ) {\n this.#tables = tables;\n this.#sources = sources;\n this.hash = hash;\n }\n\n getSource(name: string): MemorySource \| undefined {\n this.#throwIfInvalid();\n\n if (this.#sources.has(name)) {\n return this.#sources.get(name);\n }\n\n const schema = this.#tables[name];\n const source = schema\n ? new MemorySource(name, schema.columns, schema.primaryKey)\n : undefined;\n this.#sources.set(name, source);\n return source;\n }\n\n clear() {\n this.#sources.clear();\n }\n\n #throwIfInvalid() {\n if (this.#advanceError) {\n throw this.#advanceError;\n }\n }\n\n /\n Mutates the current branch, advancing it to the new head\n * by applying the given diffs.\n /\n advance(expectedHead: Hash \| undefined, newHead: Hash, diffs: NoIndexDiff) {\n this.#throwIfInvalid();\n\n assert(\n this.hash === expectedHead,\n () =>\n `Expected head must match the main head. Got: ${this.hash}, expected: ${expectedHead}`,\n );\n\n try {\n applyDiffs(diffs, this);\n this.hash = newHead;\n } catch (e) {\n this.#advanceError = e;\n this.clear();\n throw e;\n }\n }\n\n /\n Fork the branch and patch it up to match the desired head.\n /\n async forkToHead(\n store: LazyStore,\n desiredHead: Hash,\n readOptions?: ZeroReadOptions,\n ): Promise<IVMSourceBranch> {\n this.#throwIfInvalid();\n\n const fork = this.fork();\n\n if (fork.hash === desiredHead) {\n return fork;\n }\n\n await patchBranch(desiredHead, store, fork, readOptions);\n fork.hash = desiredHead;\n return fork;\n }\n\n /\n Creates a new IVMSourceBranch that is a copy of the current one.\n * This is a cheap operation since the b-trees are shared until a write is performed\n * and then only the modified nodes are copied.\n \n IVM branches are forked when we need to rebase mutations.\n * The mutations modify the fork rather than original branch.\n */\n fork() {\n this.#throwIfInvalid();\n\n return new IVMSourceBranch(\n this.#tables,\n this.hash,\n new Map(\n wrapIterable(this.#sources.entries()).map(([name, source]) => [\n name,\n source?.fork(),\n ]),\n ),\n );\n }\n}\n\nexport async function initFromStore(\n branch: IVMSourceBranch,\n hash: Hash,\n store: Store,\n) {\n const diffs: InternalDiffOperation[] = [];\n await withRead(store, async dagRead => {\n const read = await readFromHash(hash, dagRead, FormatVersion.Latest);\n for await (const entry of read.map.scan(ENTITIES_KEY_PREFIX)) {\n if (!entry[0].startsWith(ENTITIES_KEY_PREFIX)) {\n break;\n }\n diffs.push({\n op: 'add',\n key: entry[0],\n newValue: entry[1],\n });\n }\n });\n\n branch.advance(undefined, hash, diffs);\n}\n\nasync function patchBranch(\n desiredHead: Hash,\n store: LazyStore,\n fork: IVMSourceBranch,\n readOptions: ZeroReadOptions \| undefined,\n) {\n const diffs = await computeDiffs(\n must(fork.hash),\n desiredHead,\n store,\n readOptions,\n );\n if (!diffs) {\n return;\n }\n applyDiffs(diffs, fork);\n}\n\nasync function computeDiffs(\n startHash: Hash,\n endHash: Hash,\n store: LazyStore,\n readOptions: ZeroReadOptions \| undefined,\n): Promise<InternalDiff \| undefined> {\n const readFn = (dagRead: Read) =>\n diff(\n startHash,\n endHash,\n dagRead,\n {\n shouldComputeDiffs: () => true,\n shouldComputeDiffsForIndex(_name) {\n return false;\n },\n },\n FormatVersion.Latest,\n );\n\n let diffs: DiffsMap;\n if (readOptions?.openLazySourceRead) {\n diffs = await using(store.read(readOptions.openLazySourceRead), readFn);\n } else if (readOptions?.openLazyRead) {\n diffs = await readFn(readOptions.openLazyRead);\n } else {\n diffs = await withRead(store, readFn);\n }\n\n return diffs.get('');\n}\n\nfunction applyDiffs(diffs: NoIndexDiff, branch: IVMSourceBranch) {\n for (\n let i = diffBinarySearch(diffs, ENTITIES_KEY_PREFIX, diff => diff.key);\n i < diffs.length;\n i++\n ) {\n const diff = diffs[i];\n const {key} = diff;\n if (!key.startsWith(ENTITIES_KEY_PREFIX)) {\n break;\n }\n const name = sourceNameFromKey(key);\n const source = must(branch.getSource(name));\n switch (diff.op) {\n case 'del':\n consume(source.push(makeSourceChangeRemove(diff.oldValue as Row)));\n break;\n case 'add':\n consume(source.push(makeSourceChangeAdd(diff.newValue as Row)));\n break;\n case 'change':\n consume(\n source.push(\n makeSourceChangeEdit(diff.newValue as Row, diff.oldValue as Row),\n ),\n );\n break;\n }\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,IAAa,kBAAb,MAAa,gBAAgB;CAC3B;CACA;CACA;CACA;CAEA,YACE,QACA,MACA,0BAAiD,IAAI,KAAK,EAC1D;AACA,QAAA,SAAe;AACf,QAAA,UAAgB;AAChB,OAAK,OAAO;;CAGd,UAAU,MAAwC;AAChD,QAAA,gBAAsB;AAEtB,MAAI,MAAA,QAAc,IAAI,KAAK,CACzB,QAAO,MAAA,QAAc,IAAI,KAAK;EAGhC,MAAM,SAAS,MAAA,OAAa;EAC5B,MAAM,SAAS,SACX,IAAI,aAAa,MAAM,OAAO,SAAS,OAAO,WAAW,GACzD,KAAA;AACJ,QAAA,QAAc,IAAI,MAAM,OAAO;AAC/B,SAAO;;CAGT,QAAQ;AACN,QAAA,QAAc,OAAO;;CAGvB,kBAAkB;AAChB,MAAI,MAAA,aACF,OAAM,MAAA;;;;;;CAQV,QAAQ,cAAgC,SAAe,OAAoB;AACzE,QAAA,gBAAsB;AAEtB,SACE,KAAK,SAAS,oBAEZ,gDAAgD,KAAK,KAAK,cAAc,eAC3E;AAED,MAAI;AACF,cAAW,OAAO,KAAK;AACvB,QAAK,OAAO;WACL,GAAG;AACV,SAAA,eAAqB;AACrB,QAAK,OAAO;AACZ,SAAM;;;;;;CAOV,MAAM,WACJ,OACA,aACA,aAC0B;AAC1B,QAAA,gBAAsB;EAEtB,MAAM,OAAO,KAAK,MAAM;AAExB,MAAI,KAAK,SAAS,YAChB,QAAO;AAGT,QAAM,YAAY,aAAa,OAAO,MAAM,YAAY;AACxD,OAAK,OAAO;AACZ,SAAO;;;;;;;;;;CAWT,OAAO;AACL,QAAA,gBAAsB;AAEtB,SAAO,IAAI,gBACT,MAAA,QACA,KAAK,MACL,IAAI,IACF,aAAa,MAAA,QAAc,SAAS,CAAC,CAAC,KAAK,CAAC,MAAM,YAAY,CAC5D,MACA,QAAQ,MAAM,CACf,CAAC,CACH,CACF;;;AA2BL,eAAe,YACb,aACA,OACA,MACA,aACA;CACA,MAAM,QAAQ,MAAM,aAClB,KAAK,KAAK,KAAK,EACf,aACA,OACA,YACD;AACD,KAAI,CAAC,MACH;AAEF,YAAW,OAAO,KAAK;;AAGzB,eAAe,aACb,WACA,SACA,OACA,aACmC;CACnC,MAAM,UAAU,YACd,KACE,WACA,SACA,SACA;EACE,0BAA0B;EAC1B,2BAA2B,OAAO;AAChC,UAAO;;EAEV,EACD,EACD;CAEH,IAAI;AACJ,KAAI,aAAa,mBACf,SAAQ,MAAM,MAAM,MAAM,KAAK,YAAY,mBAAmB,EAAE,OAAO;UAC9D,aAAa,aACtB,SAAQ,MAAM,OAAO,YAAY,aAAa;KAE9C,SAAQ,MAAM,SAAS,OAAO,OAAO;AAGvC,QAAO,MAAM,IAAI,GAAG;;AAGtB,SAAS,WAAW,OAAoB,QAAyB;AAC/D,MACE,IAAI,IAAI,iBAAiB,OAAA,OAA4B,SAAQ,KAAK,IAAI,EACtE,IAAI,MAAM,QACV,KACA;EACA,MAAM,OAAO,MAAM;EACnB,MAAM,EAAC,QAAO;AACd,MAAI,CAAC,IAAI,WAAA,KAA+B,CACtC;EAEF,MAAM,OAAO,kBAAkB,IAAI;EACnC,MAAM,SAAS,KAAK,OAAO,UAAU,KAAK,CAAC;AAC3C,UAAQ,KAAK,IAAb;GACE,KAAK;AACH,YAAQ,OAAO,KAAK,uBAAuB,KAAK,SAAgB,CAAC,CAAC;AAClE;GACF,KAAK;AACH,YAAQ,OAAO,KAAK,oBAAoB,KAAK,SAAgB,CAAC,CAAC;AAC/D;GACF,KAAK;AACH,YACE,OAAO,KACL,qBAAqB,KAAK,UAAiB,KAAK,SAAgB,CACjE,CACF;AACD"}

package/out/zero-client/src/client/keys.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"keys.js","names":[],"sources":["../../../../../zero-client/src/client/keys.ts"],"sourcesContent":["import {h128} from '../../../shared/src/hash.ts';\nimport * as v from '../../../shared/src/valita.ts';\nimport type {CompoundKey} from '../../../zero-protocol/src/ast.ts';\nimport type {Row} from '../../../zero-protocol/src/data.ts';\nimport type {MutationID} from '../../../zero-protocol/src/mutation-id.ts';\nimport {primaryKeyValueSchema} from '../../../zero-protocol/src/primary-key.ts';\n\nexport const DESIRED_QUERIES_KEY_PREFIX = 'd/';\nexport const GOT_QUERIES_KEY_PREFIX = 'g/';\nexport const ENTITIES_KEY_PREFIX = 'e/';\nexport const MUTATIONS_KEY_PREFIX = 'm/';\n\nexport function toDesiredQueriesKey(clientID: string, hash: string): string {\n return DESIRED_QUERIES_KEY_PREFIX + clientID + '/' + hash;\n}\n\nexport function desiredQueriesPrefixForClient(clientID: string): string {\n return DESIRED_QUERIES_KEY_PREFIX + clientID + '/';\n}\n\nexport function toGotQueriesKey(hash: string): string {\n return GOT_QUERIES_KEY_PREFIX + hash;\n}\n\nexport function toMutationResponseKey(mid: MutationID): string {\n return MUTATIONS_KEY_PREFIX + mid.clientID + '/' + mid.id;\n}\n\nexport function toPrimaryKeyString(\n tableName: string,\n primaryKey: CompoundKey,\n value: Row,\n): string {\n if (primaryKey.length === 1) {\n return (\n ENTITIES_KEY_PREFIX +\n tableName +\n '/' +\n v.parse(value[primaryKey[0]], primaryKeyValueSchema)\n );\n }\n\n const values = primaryKey.map(k => v.parse(value[k], primaryKeyValueSchema));\n const str = JSON.stringify(values);\n\n const idSegment = h128(str);\n return ENTITIES_KEY_PREFIX + tableName + '/' + idSegment;\n}\n\nexport function sourceNameFromKey(key: string): string {\n const slash = key.indexOf('/', ENTITIES_KEY_PREFIX.length);\n return key.slice(ENTITIES_KEY_PREFIX.length, slash);\n}\n"],"mappings":";;;AAYA,SAAgB,oBAAoB,UAAkB,MAAsB;~~CAC1E~~,~~OAAA~~,OAAoC,WAAW,MAAM~~;AACvD;AAEA~~,SAAgB,8BAA8B,UAA0B;~~CACtE~~,~~OAAA~~,OAAoC,WAAW~~;AACjD;AAEA~~,SAAgB,gBAAgB,MAAsB;~~CACpD~~,~~OAAA~~,OAAgC~~;AAClC;AAEA~~,SAAgB,sBAAsB,KAAyB;~~CAC7D~~,~~OAAA~~,OAA8B,IAAI,WAAW,MAAM,IAAI~~;AACzD;AAEA~~,SAAgB,mBACd,WACA,YACA,OACQ;~~CACR~~,~~IAAI~~,WAAW,WAAW,~~GACxB~~,~~OAAA~~,OAEE,YACA,MACA,MAAQ,MAAM,WAAW,KAAK,~~qBAAqB~~;~~CAIvD~~,MAAM,SAAS,WAAW,KAAI,MAAK,MAAQ,MAAM,IAAI,~~qBAAqB~~,CAAC;~~CAG3E~~,MAAM,YAAY,KAFN,KAAK,UAAU,~~MAEJ~~,~~CAAG~~;~~CAC1B~~,~~OAAA~~,OAA6B,YAAY,MAAM~~;AACjD;AAEA~~,SAAgB,kBAAkB,KAAqB;CACrD,MAAM,QAAQ,IAAI,QAAQ,KAAK,~~CAA0B~~;~~CACzD~~,~~OAAO~~,IAAI,MAAM,GAA4B,~~KAAK;AACpD~~"}
1	+ {"version":3,"file":"keys.js","names":[],"sources":["../../../../../zero-client/src/client/keys.ts"],"sourcesContent":["import {h128} from '../../../shared/src/hash.ts';\nimport * as v from '../../../shared/src/valita.ts';\nimport type {CompoundKey} from '../../../zero-protocol/src/ast.ts';\nimport type {Row} from '../../../zero-protocol/src/data.ts';\nimport type {MutationID} from '../../../zero-protocol/src/mutation-id.ts';\nimport {primaryKeyValueSchema} from '../../../zero-protocol/src/primary-key.ts';\n\nexport const DESIRED_QUERIES_KEY_PREFIX = 'd/';\nexport const GOT_QUERIES_KEY_PREFIX = 'g/';\nexport const ENTITIES_KEY_PREFIX = 'e/';\nexport const MUTATIONS_KEY_PREFIX = 'm/';\n\nexport function toDesiredQueriesKey(clientID: string, hash: string): string {\n return DESIRED_QUERIES_KEY_PREFIX + clientID + '/' + hash;\n}\n\nexport function desiredQueriesPrefixForClient(clientID: string): string {\n return DESIRED_QUERIES_KEY_PREFIX + clientID + '/';\n}\n\nexport function toGotQueriesKey(hash: string): string {\n return GOT_QUERIES_KEY_PREFIX + hash;\n}\n\nexport function toMutationResponseKey(mid: MutationID): string {\n return MUTATIONS_KEY_PREFIX + mid.clientID + '/' + mid.id;\n}\n\nexport function toPrimaryKeyString(\n tableName: string,\n primaryKey: CompoundKey,\n value: Row,\n): string {\n if (primaryKey.length === 1) {\n return (\n ENTITIES_KEY_PREFIX +\n tableName +\n '/' +\n v.parse(value[primaryKey[0]], primaryKeyValueSchema)\n );\n }\n\n const values = primaryKey.map(k => v.parse(value[k], primaryKeyValueSchema));\n const str = JSON.stringify(values);\n\n const idSegment = h128(str);\n return ENTITIES_KEY_PREFIX + tableName + '/' + idSegment;\n}\n\nexport function sourceNameFromKey(key: string): string {\n const slash = key.indexOf('/', ENTITIES_KEY_PREFIX.length);\n return key.slice(ENTITIES_KEY_PREFIX.length, slash);\n}\n"],"mappings":";;;AAYA,SAAgB,oBAAoB,UAAkB,MAAsB;AAC1E,QAAA,OAAoC,WAAW,MAAM;;AAGvD,SAAgB,8BAA8B,UAA0B;AACtE,QAAA,OAAoC,WAAW;;AAGjD,SAAgB,gBAAgB,MAAsB;AACpD,QAAA,OAAgC;;AAGlC,SAAgB,sBAAsB,KAAyB;AAC7D,QAAA,OAA8B,IAAI,WAAW,MAAM,IAAI;;AAGzD,SAAgB,mBACd,WACA,YACA,OACQ;AACR,KAAI,WAAW,WAAW,EACxB,QAAA,OAEE,YACA,MACA,MAAQ,MAAM,WAAW,KAAK,sBAAsB;CAIxD,MAAM,SAAS,WAAW,KAAI,MAAK,MAAQ,MAAM,IAAI,sBAAsB,CAAC;CAG5E,MAAM,YAAY,KAFN,KAAK,UAAU,OAAO,CAEP;AAC3B,QAAA,OAA6B,YAAY,MAAM;;AAGjD,SAAgB,kBAAkB,KAAqB;CACrD,MAAM,QAAQ,IAAI,QAAQ,KAAK,EAA2B;AAC1D,QAAO,IAAI,MAAM,GAA4B,MAAM"}

package/out/zero-client/src/client/log-options.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"log-options.js","names":["#wrappedLogSink","#level"],"sources":["../../../../../zero-client/src/client/log-options.ts"],"sourcesContent":["import {\n TeeLogSink,\n consoleLogSink,\n type Context,\n type LogLevel,\n type LogSink,\n} from '@rocicorp/logger';\nimport {\n DatadogLogSink,\n type DatadogLogSinkOptions,\n} from '../../../datadog/src/datadog-log-sink.ts';\nimport {appendPath, type HTTPString} from './http-string.ts';\nimport {version} from './version.ts';\n\nclass LevelFilterLogSink implements LogSink {\n readonly #wrappedLogSink: LogSink;\n readonly #level: LogLevel;\n\n constructor(wrappedLogSink: LogSink, level: LogLevel) {\n this.#wrappedLogSink = wrappedLogSink;\n this.#level = level;\n }\n\n log(level: LogLevel, context: Context \| undefined, ...args: unknown[]): void {\n if (this.#level === 'error' && level !== 'error') {\n return;\n }\n if (this.#level === 'info' && level === 'debug') {\n return;\n }\n this.#wrappedLogSink.log(level, context, ...args);\n }\n\n async flush() {\n await consoleLogSink.flush?.();\n }\n}\n\nconst DATADOG_LOG_LEVEL = 'info';\nconst ZERO_SASS_DOMAIN = '.reflect-server.net';\n\nexport type LogOptions = {\n readonly logLevel: LogLevel;\n readonly logSink: LogSink;\n};\n\nexport function createLogOptions(\n options: {\n consoleLogLevel: LogLevel;\n server: HTTPString \| null;\n enableAnalytics: boolean;\n consoleLogSink?: LogSink \| undefined;\n },\n createDatadogLogSink: (options: DatadogLogSinkOptions) => LogSink = (\n options: DatadogLogSinkOptions,\n ) => new DatadogLogSink(options),\n): LogOptions {\n const {consoleLogLevel, server, enableAnalytics} = options;\n const userSink = options.consoleLogSink ?? consoleLogSink;\n\n if (!enableAnalytics \|\| server === null) {\n return {\n logLevel: consoleLogLevel,\n logSink: userSink,\n };\n }\n\n const serverURL = new URL(server);\n const {hostname} = serverURL;\n const datadogServiceLabel = hostname.endsWith(ZERO_SASS_DOMAIN)\n ? hostname\n .substring(0, hostname.length - ZERO_SASS_DOMAIN.length)\n .toLowerCase()\n : hostname;\n const baseURL = new URL(appendPath(server, '/logs/v0/log'));\n const logLevel = consoleLogLevel === 'debug' ? 'debug' : 'info';\n const logSink = new TeeLogSink([\n new LevelFilterLogSink(userSink, consoleLogLevel),\n new LevelFilterLogSink(\n createDatadogLogSink({\n service: datadogServiceLabel,\n host: location.host,\n version,\n baseURL,\n }),\n DATADOG_LOG_LEVEL,\n ),\n ]);\n return {\n logLevel,\n logSink,\n };\n}\n"],"mappings":";;;;;AAcA,IAAM,qBAAN,MAA4C;CAC1C;CACA;CAEA,YAAY,gBAAyB,OAAiB;~~EACpD~~,~~KAAKA~~,~~kBAAkB~~;~~EACvB~~,~~KAAKC~~,~~SAAS;CAChB;CAEA~~,IAAI,OAAiB,SAA8B,GAAG,MAAuB;~~EAC3E~~,~~IAAI~~,~~KAAKA~~,~~WAAW~~,WAAW,UAAU,~~SACvC~~;~~EAEF~~,~~IAAI~~,~~KAAKA~~,~~WAAW~~,UAAU,UAAU,~~SACtC~~;~~EAEF~~,~~KAAKD~~,~~gBAAgB~~,IAAI,OAAO,SAAS,GAAG,~~IAAI;CAClD;CAEA~~,MAAM,QAAQ;~~EACZ~~,~~MAAM~~,eAAe,~~QAAQ;CAC/B;AACF;AAEA~~,IAAM,oBAAoB;AAC1B,IAAM,mBAAmB;AAOzB,SAAgB,iBACd,SAMA,wBACE,YACG,IAAI,eAAe,~~OAAO~~,~~GACnB~~;CACZ,MAAM,EAAC,iBAAiB,QAAQ,oBAAmB;CACnD,MAAM,WAAW,QAAQ,kBAAkB;~~CAE3C~~,~~IAAI~~,CAAC,mBAAmB,WAAW,~~MACjC~~,~~OAAO~~;EACL,UAAU;EACV,SAAS;~~CACX~~;~~CAIF~~,MAAM,EAAC,~~aAAY~~,~~IADG~~,IAAI,~~MACP~~;~~CACnB~~,MAAM,sBAAsB,SAAS,SAAS,~~gBAAgB~~,~~IAC1D~~,SACG,UAAU,GAAG,SAAS,SAAS,~~EAAuB~~,~~EACtD~~,~~YAAY~~,~~IACf~~;CACJ,MAAM,UAAU,IAAI,IAAI,WAAW,QAAQ,~~cAAc~~,CAAC;~~CAc1D~~,~~OAAO~~;EACL,UAde,oBAAoB,UAAU,UAAU;EAevD,~~SAAA~~,~~IAdkB~~,WAAW,CAC7B,IAAI,mBAAmB,UAAU,~~eAAe~~,~~GAChD~~,IAAI,mBACF,qBAAqB;GACnB,SAAS;GACT,MAAM,SAAS;GACf;GACA;~~EACF~~,CAAC,~~GACD~~,~~iBACF~~,CACF,~~CAGE~~;~~CACF;AACF~~"}
1	+ {"version":3,"file":"log-options.js","names":["#wrappedLogSink","#level"],"sources":["../../../../../zero-client/src/client/log-options.ts"],"sourcesContent":["import {\n TeeLogSink,\n consoleLogSink,\n type Context,\n type LogLevel,\n type LogSink,\n} from '@rocicorp/logger';\nimport {\n DatadogLogSink,\n type DatadogLogSinkOptions,\n} from '../../../datadog/src/datadog-log-sink.ts';\nimport {appendPath, type HTTPString} from './http-string.ts';\nimport {version} from './version.ts';\n\nclass LevelFilterLogSink implements LogSink {\n readonly #wrappedLogSink: LogSink;\n readonly #level: LogLevel;\n\n constructor(wrappedLogSink: LogSink, level: LogLevel) {\n this.#wrappedLogSink = wrappedLogSink;\n this.#level = level;\n }\n\n log(level: LogLevel, context: Context \| undefined, ...args: unknown[]): void {\n if (this.#level === 'error' && level !== 'error') {\n return;\n }\n if (this.#level === 'info' && level === 'debug') {\n return;\n }\n this.#wrappedLogSink.log(level, context, ...args);\n }\n\n async flush() {\n await consoleLogSink.flush?.();\n }\n}\n\nconst DATADOG_LOG_LEVEL = 'info';\nconst ZERO_SASS_DOMAIN = '.reflect-server.net';\n\nexport type LogOptions = {\n readonly logLevel: LogLevel;\n readonly logSink: LogSink;\n};\n\nexport function createLogOptions(\n options: {\n consoleLogLevel: LogLevel;\n server: HTTPString \| null;\n enableAnalytics: boolean;\n consoleLogSink?: LogSink \| undefined;\n },\n createDatadogLogSink: (options: DatadogLogSinkOptions) => LogSink = (\n options: DatadogLogSinkOptions,\n ) => new DatadogLogSink(options),\n): LogOptions {\n const {consoleLogLevel, server, enableAnalytics} = options;\n const userSink = options.consoleLogSink ?? consoleLogSink;\n\n if (!enableAnalytics \|\| server === null) {\n return {\n logLevel: consoleLogLevel,\n logSink: userSink,\n };\n }\n\n const serverURL = new URL(server);\n const {hostname} = serverURL;\n const datadogServiceLabel = hostname.endsWith(ZERO_SASS_DOMAIN)\n ? hostname\n .substring(0, hostname.length - ZERO_SASS_DOMAIN.length)\n .toLowerCase()\n : hostname;\n const baseURL = new URL(appendPath(server, '/logs/v0/log'));\n const logLevel = consoleLogLevel === 'debug' ? 'debug' : 'info';\n const logSink = new TeeLogSink([\n new LevelFilterLogSink(userSink, consoleLogLevel),\n new LevelFilterLogSink(\n createDatadogLogSink({\n service: datadogServiceLabel,\n host: location.host,\n version,\n baseURL,\n }),\n DATADOG_LOG_LEVEL,\n ),\n ]);\n return {\n logLevel,\n logSink,\n };\n}\n"],"mappings":";;;;;AAcA,IAAM,qBAAN,MAA4C;CAC1C;CACA;CAEA,YAAY,gBAAyB,OAAiB;AACpD,QAAA,iBAAuB;AACvB,QAAA,QAAc;;CAGhB,IAAI,OAAiB,SAA8B,GAAG,MAAuB;AAC3E,MAAI,MAAA,UAAgB,WAAW,UAAU,QACvC;AAEF,MAAI,MAAA,UAAgB,UAAU,UAAU,QACtC;AAEF,QAAA,eAAqB,IAAI,OAAO,SAAS,GAAG,KAAK;;CAGnD,MAAM,QAAQ;AACZ,QAAM,eAAe,SAAS;;;AAIlC,IAAM,oBAAoB;AAC1B,IAAM,mBAAmB;AAOzB,SAAgB,iBACd,SAMA,wBACE,YACG,IAAI,eAAe,QAAQ,EACpB;CACZ,MAAM,EAAC,iBAAiB,QAAQ,oBAAmB;CACnD,MAAM,WAAW,QAAQ,kBAAkB;AAE3C,KAAI,CAAC,mBAAmB,WAAW,KACjC,QAAO;EACL,UAAU;EACV,SAAS;EACV;CAIH,MAAM,EAAC,aADW,IAAI,IAAI,OAAO;CAEjC,MAAM,sBAAsB,SAAS,SAAS,iBAAiB,GAC3D,SACG,UAAU,GAAG,SAAS,SAAS,GAAwB,CACvD,aAAa,GAChB;CACJ,MAAM,UAAU,IAAI,IAAI,WAAW,QAAQ,eAAe,CAAC;AAc3D,QAAO;EACL,UAde,oBAAoB,UAAU,UAAU;EAevD,SAdc,IAAI,WAAW,CAC7B,IAAI,mBAAmB,UAAU,gBAAgB,EACjD,IAAI,mBACF,qBAAqB;GACnB,SAAS;GACT,MAAM,SAAS;GACf;GACA;GACD,CAAC,EACF,kBACD,CACF,CAAC;EAID"}

package/out/zero-client/src/client/make-mutate-property.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"make-mutate-property.js","names":[],"sources":["../../../../../zero-client/src/client/make-mutate-property.ts"],"sourcesContent":["import type {DeepMerge} from '../../../shared/src/deep-merge.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport type {Schema} from '../../../zero-types/src/schema.ts';\nimport {\n customMutatorKey,\n type Transaction,\n} from '../../../zql/src/mutate/custom.ts';\nimport type {DBMutator} from './crud.ts';\nimport type {CustomMutatorDefs, MutatorResult} from './custom.ts';\nimport type {MutatorProxy} from './mutator-proxy.ts';\n\n/*\n Creates and populates a mutate property object by processing mutator definitions recursively.\n \n This function traverses through mutator definitions (either schema-based or custom) and builds\n * a corresponding object structure where each mutator is wrapped by the mutator proxy. It handles\n * both flat mutator functions and nested mutator definition objects.\n \n @template S - The schema type that defines the structure of the data\n * @template C - The context type used by mutators, defaults to unknown\n \n @param mutators - The mutator definitions to process, can be schema-based or custom mutator definitions\n * @param mutatorProxy - The proxy object responsible for wrapping mutators with additional functionality\n * @param mutateObject - The target object to populate with wrapped mutators\n * @param replicacheMutate - The source object containing the actual mutator implementations to wrap\n \n @returns void - This function mutates the mutateObject parameter directly\n \n @remarks\n * The function recursively processes nested mutator structures, creating corresponding nested objects\n * in the mutateObject. For leaf mutators (functions or mutator definitions), it generates a full key\n * using different separators ('.' for mutator definitions, '\|' for custom functions) and wraps them\n * using the mutator proxy.\n /\nexport function addCustomMutatorsProperties(\n mutators: CustomMutatorDefs,\n mutatorProxy: MutatorProxy,\n mutateObject: Record<string, unknown>,\n replicacheMutate: Record<string, unknown>,\n): void {\n const processMutators = (\n mutators: CustomMutatorDefs,\n path: string[],\n mutateObject: Record<string, unknown>,\n ) => {\n for (const [key, mutator] of Object.entries(mutators)) {\n path.push(key);\n if (typeof mutator === 'function') {\n const fullKey = customMutatorKey('\|', path);\n mutateObject[key] = mutatorProxy.wrapCustomMutator(\n fullKey,\n must(replicacheMutate[fullKey]) as unknown as (\n ...args: unknown[]\n ) => MutatorResult,\n );\n } else {\n // Nested namespace - recursive build and process.\n let existing = mutateObject[key];\n if (existing === undefined) {\n existing = {};\n mutateObject[key] = existing;\n }\n processMutators(\n mutator as CustomMutatorDefs,\n path,\n existing as Record<string, unknown>,\n );\n }\n path.pop();\n }\n };\n\n processMutators(mutators, [], mutateObject);\n}\n\n/\n Builds the mutate type from legacy CustomMutatorDefs, handling arbitrary nesting.\n * Each node can be either a CustomMutatorImpl function or a namespace containing more mutators.\n */\ntype MakeFromMutatorDefinitions<\n S extends Schema,\n MD extends CustomMutatorDefs,\n C,\n> = {\n readonly [K in keyof MD]: MD[K] extends (\n tx: Transaction<S>,\n ...args: infer Args\n ) => Promise<void>\n ? (...args: Args) => MutatorResult\n : MD[K] extends CustomMutatorDefs\n ? MakeFromMutatorDefinitions<S, MD[K], C>\n : never;\n};\n\nexport type MakeMutatePropertyType<\n S extends Schema,\n MD extends CustomMutatorDefs \| undefined,\n C,\n> = MD extends CustomMutatorDefs\n ? S['enableLegacyMutators'] extends true\n ? DeepMerge<DBMutator<S>, MakeFromMutatorDefinitions<S, MD, C>>\n : MakeFromMutatorDefinitions<S, MD, C>\n : DBMutator<S>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,4BACd,UACA,cACA,cACA,kBACM;CACN,MAAM,mBACJ,UACA,MACA,iBACG;~~EACH~~,~~KAAK~~,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,~~QAAQ~~,~~GAAG~~;~~GACrD~~,~~KAAK~~,KAAK,~~GAAG~~;~~GACb~~,~~IAAI~~,OAAO,YAAY,YAAY;IACjC,MAAM,UAAU,iBAAiB,KAAK,~~IAAI~~;~~IAC1C~~,~~aAAa~~,OAAO,aAAa,kBAC/B,SACA,KAAK,iBAAiB,~~QAAQ~~,CAGhC;~~GACF,OAAO~~;IAEL,IAAI,WAAW,aAAa;~~IAC5B~~,~~IAAI~~,aAAa,KAAA,GAAW;~~KAC1B~~,~~WAAW~~,~~CAAC~~;~~KACZ~~,~~aAAa~~,OAAO~~;IACtB;IACA~~,~~gBACE~~,SACA,MACA,~~QACF;GACF;GACA~~,KAAK,~~IAAI;EACX;CACF;CAEA~~,~~gBAAgB,~~UAAU,~~CAAC~~,~~GAAG~~,~~YAAY;AAC5C~~"}
1	+ {"version":3,"file":"make-mutate-property.js","names":[],"sources":["../../../../../zero-client/src/client/make-mutate-property.ts"],"sourcesContent":["import type {DeepMerge} from '../../../shared/src/deep-merge.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport type {Schema} from '../../../zero-types/src/schema.ts';\nimport {\n customMutatorKey,\n type Transaction,\n} from '../../../zql/src/mutate/custom.ts';\nimport type {DBMutator} from './crud.ts';\nimport type {CustomMutatorDefs, MutatorResult} from './custom.ts';\nimport type {MutatorProxy} from './mutator-proxy.ts';\n\n/*\n Creates and populates a mutate property object by processing mutator definitions recursively.\n \n This function traverses through mutator definitions (either schema-based or custom) and builds\n * a corresponding object structure where each mutator is wrapped by the mutator proxy. It handles\n * both flat mutator functions and nested mutator definition objects.\n \n @template S - The schema type that defines the structure of the data\n * @template C - The context type used by mutators, defaults to unknown\n \n @param mutators - The mutator definitions to process, can be schema-based or custom mutator definitions\n * @param mutatorProxy - The proxy object responsible for wrapping mutators with additional functionality\n * @param mutateObject - The target object to populate with wrapped mutators\n * @param replicacheMutate - The source object containing the actual mutator implementations to wrap\n \n @returns void - This function mutates the mutateObject parameter directly\n \n @remarks\n * The function recursively processes nested mutator structures, creating corresponding nested objects\n * in the mutateObject. For leaf mutators (functions or mutator definitions), it generates a full key\n * using different separators ('.' for mutator definitions, '\|' for custom functions) and wraps them\n * using the mutator proxy.\n /\nexport function addCustomMutatorsProperties(\n mutators: CustomMutatorDefs,\n mutatorProxy: MutatorProxy,\n mutateObject: Record<string, unknown>,\n replicacheMutate: Record<string, unknown>,\n): void {\n const processMutators = (\n mutators: CustomMutatorDefs,\n path: string[],\n mutateObject: Record<string, unknown>,\n ) => {\n for (const [key, mutator] of Object.entries(mutators)) {\n path.push(key);\n if (typeof mutator === 'function') {\n const fullKey = customMutatorKey('\|', path);\n mutateObject[key] = mutatorProxy.wrapCustomMutator(\n fullKey,\n must(replicacheMutate[fullKey]) as unknown as (\n ...args: unknown[]\n ) => MutatorResult,\n );\n } else {\n // Nested namespace - recursive build and process.\n let existing = mutateObject[key];\n if (existing === undefined) {\n existing = {};\n mutateObject[key] = existing;\n }\n processMutators(\n mutator as CustomMutatorDefs,\n path,\n existing as Record<string, unknown>,\n );\n }\n path.pop();\n }\n };\n\n processMutators(mutators, [], mutateObject);\n}\n\n/\n Builds the mutate type from legacy CustomMutatorDefs, handling arbitrary nesting.\n * Each node can be either a CustomMutatorImpl function or a namespace containing more mutators.\n */\ntype MakeFromMutatorDefinitions<\n S extends Schema,\n MD extends CustomMutatorDefs,\n C,\n> = {\n readonly [K in keyof MD]: MD[K] extends (\n tx: Transaction<S>,\n ...args: infer Args\n ) => Promise<void>\n ? (...args: Args) => MutatorResult\n : MD[K] extends CustomMutatorDefs\n ? MakeFromMutatorDefinitions<S, MD[K], C>\n : never;\n};\n\nexport type MakeMutatePropertyType<\n S extends Schema,\n MD extends CustomMutatorDefs \| undefined,\n C,\n> = MD extends CustomMutatorDefs\n ? S['enableLegacyMutators'] extends true\n ? DeepMerge<DBMutator<S>, MakeFromMutatorDefinitions<S, MD, C>>\n : MakeFromMutatorDefinitions<S, MD, C>\n : DBMutator<S>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,4BACd,UACA,cACA,cACA,kBACM;CACN,MAAM,mBACJ,UACA,MACA,iBACG;AACH,OAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,SAAS,EAAE;AACrD,QAAK,KAAK,IAAI;AACd,OAAI,OAAO,YAAY,YAAY;IACjC,MAAM,UAAU,iBAAiB,KAAK,KAAK;AAC3C,iBAAa,OAAO,aAAa,kBAC/B,SACA,KAAK,iBAAiB,SAAS,CAGhC;UACI;IAEL,IAAI,WAAW,aAAa;AAC5B,QAAI,aAAa,KAAA,GAAW;AAC1B,gBAAW,EAAE;AACb,kBAAa,OAAO;;AAEtB,oBACE,SACA,MACA,SACD;;AAEH,QAAK,KAAK;;;AAId,iBAAgB,UAAU,EAAE,EAAE,aAAa"}

package/out/zero-client/src/client/make-replicache-mutators.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"make-replicache-mutators.js","names":[],"sources":["../../../../../zero-client/src/client/make-replicache-mutators.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport type {MutatorDefs} from '../../../replicache/src/types.ts';\nimport type {ReadonlyJSONValue} from '../../../shared/src/json.ts';\nimport {CRUD_MUTATION_NAME} from '../../../zero-protocol/src/mutation.ts';\nimport type {Schema} from '../../../zero-types/src/schema.ts';\nimport {customMutatorKey} from '../../../zql/src/mutate/custom.ts';\nimport {\n isMutatorRegistry,\n type AnyMutatorRegistry,\n} from '../../../zql/src/mutate/mutator-registry.ts';\nimport {isMutator, type Mutator} from '../../../zql/src/mutate/mutator.ts';\nimport {ClientErrorKind} from './client-error-kind.ts';\nimport {makeCRUDMutator, type CRUDMutator} from './crud.ts';\nimport type {CustomMutatorDefs, CustomMutatorImpl} from './custom.ts';\nimport {\n makeReplicacheMutator as makeReplicacheMutatorLegacy,\n TransactionImpl,\n} from './custom.ts';\nimport {ClientError} from './error.ts';\nimport type {WriteTransaction} from './replicache-types.ts';\n\nexport function extendReplicacheMutators<S extends Schema, C>(\n lc: LogContext,\n context: C,\n mutators: AnyMutatorRegistry \| CustomMutatorDefs,\n schema: S,\n mutateObject: Record<string, unknown>,\n): void {\n // Recursively process mutator definitions at arbitrary depth\n const processMutators = (mutators: object, path: string[]) => {\n for (const [key, mutator] of Object.entries(mutators)) {\n if (key === '~') {\n // Skip phantom type\n continue;\n }\n\n path.push(key);\n if (isMutator(mutator)) {\n const fullKey = customMutatorKey('.', path);\n mutateObject[fullKey] = makeReplicacheMutator(\n lc,\n mutator,\n schema,\n context,\n );\n } else if (typeof mutator === 'function') {\n const fullKey = customMutatorKey('\|', path);\n mutateObject[fullKey] = makeReplicacheMutatorLegacy(\n lc,\n // oxlint-disable-next-line no-explicit-any\n mutator as CustomMutatorImpl<any>,\n schema,\n context,\n );\n } else if (mutator !== null && typeof mutator === 'object') {\n processMutators(mutator, path);\n }\n path.pop();\n }\n };\n\n processMutators(mutators, []);\n}\n\nfunction makeReplicacheMutator<\n TArgs extends ReadonlyJSONValue \| undefined,\n TSchema extends Schema,\n TContext,\n TWrappedTransaction,\n>(\n lc: LogContext,\n mutator: Mutator<TArgs, TSchema, TContext, TWrappedTransaction>,\n schema: TSchema,\n context: TContext,\n): (repTx: WriteTransaction, args: ReadonlyJSONValue) => Promise<void> {\n return async (\n repTx: WriteTransaction,\n args: ReadonlyJSONValue,\n ): Promise<void> => {\n const tx = new TransactionImpl(lc, repTx, schema);\n // fn does input validation internally\n await mutator.fn({\n args: args as TArgs,\n ctx: context,\n tx: tx,\n });\n };\n}\n\n/*\n Creates Replicache mutators from mutator definitions.\n \n This function processes mutator definitions at arbitrary depth, supporting both\n * new-style mutator definitions and legacy custom mutator implementations. It creates\n * a mutator object with the CRUD mutator and any provided custom mutators, with keys\n * generated based on their path in the mutator definition hierarchy.\n \n @template S - The schema type that defines the structure of the data\n * @template C - The type of the context object passed to mutators\n \n @param schema - The schema instance used for validation and type checking\n * @param mutators - The mutator definitions to process, can be nested objects or custom mutator definitions\n * @param context - The context to be passed to mutators\n * @param lc - The log context used for logging operations\n \n @returns A mutator definitions object containing the CRUD mutator and any custom mutators\n \n @remarks\n * - New-style mutator definitions use '.' as a separator in their keys\n * - Legacy custom mutator implementations use '\|' as a separator in their keys\n * - The CRUD mutator can be disabled by setting `enableLegacyMutators: false` in the schema\n /\nexport function makeReplicacheMutators<const S extends Schema, C>(\n schema: S,\n mutators: AnyMutatorRegistry \| CustomMutatorDefs \| undefined,\n context: C,\n lc: LogContext,\n): MutatorDefs & {_zero_crud: CRUDMutator} {\n const {enableLegacyMutators = false} = schema;\n\n const replicacheMutators = {\n [CRUD_MUTATION_NAME]: enableLegacyMutators\n ? makeCRUDMutator(schema)\n : // TODO(arv): This code is unreachable since the public API prevents\n // calling CRUD mutators when enableLegacyMutators is false. Remove this.\n () =>\n Promise.reject(\n new ClientError({\n kind: ClientErrorKind.Internal,\n message: 'Zero CRUD mutators are not enabled.',\n }),\n ),\n };\n\n if (mutators) {\n if (isMutatorRegistry(mutators)) {\n extendFromMutatorRegistry(\n lc,\n context,\n mutators,\n schema,\n replicacheMutators,\n );\n } else {\n extendReplicacheMutators(\n lc,\n context,\n mutators as CustomMutatorDefs,\n schema,\n replicacheMutators,\n );\n }\n }\n\n return replicacheMutators;\n}\n\n/\n Extends replicache mutators from a MutatorRegistry.\n * Walks the registry tree and wraps each Mutator.fn for Replicache.\n */\nfunction extendFromMutatorRegistry<S extends Schema, C>(\n lc: LogContext,\n context: C,\n registry: AnyMutatorRegistry,\n schema: S,\n mutateObject: Record<string, unknown>,\n): void {\n const walk = (node: unknown) => {\n if (typeof node !== 'object' \|\| node === null) {\n return;\n }\n for (const value of Object.values(node)) {\n if (isMutator<S>(value)) {\n // Mutator.fn already handles validation internally\n mutateObject[value.mutatorName] = (\n repTx: WriteTransaction,\n args: ReadonlyJSONValue,\n ): Promise<void> => {\n const tx = new TransactionImpl(lc, repTx, schema);\n return value.fn({args, ctx: context, tx});\n };\n } else if (typeof value === 'object' && value !== null) {\n // Nested namespace\n walk(value);\n }\n }\n };\n walk(registry);\n}\n"],"mappings":";;;;;;;;;AAqBA,SAAgB,yBACd,IACA,SACA,UACA,QACA,cACM;CAEN,MAAM,mBAAmB,UAAkB,SAAmB;~~EAC5D~~,~~KAAK~~,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,~~QAAQ~~,~~GAAG~~;~~GACrD~~,~~IAAI~~,QAAQ,~~KAEV~~;~~GAGF~~,~~KAAK~~,KAAK,~~GAAG~~;~~GACb~~,~~IAAI~~,UAAU,~~OAAO~~,~~GAAG~~;IACtB,MAAM,UAAU,iBAAiB,KAAK,~~IAAI~~;~~IAC1C~~,~~aAAa~~,WAAW,sBACtB,IACA,SACA,QACA,~~OACF~~;~~GACF~~,OAAO,~~IAAI,OAAO,~~YAAY,YAAY;IACxC,MAAM,UAAU,iBAAiB,KAAK,~~IAAI~~;~~IAC1C~~,~~aAAa~~,WAAW,wBACtB,IAEA,SACA,QACA,~~OACF~~;~~GACF~~,~~OAAO,IAAI,~~YAAY,QAAQ,OAAO,YAAY,~~UAChD~~,~~gBAAgB~~,SAAS,~~IAAI~~;~~GAE/B~~,KAAK,~~IAAI;EACX;CACF;CAEA~~,~~gBAAgB,~~UAAU,~~CAAC~~,CAAC~~;AAC9B;AAEA~~,SAAS,sBAMP,IACA,SACA,QACA,SACqE;~~CACrE~~,~~OAAO~~,OACL,OACA,SACkB;EAClB,MAAM,KAAK,IAAI,gBAAgB,IAAI,OAAO,~~MAAM~~;~~EAEhD~~,~~MAAM~~,QAAQ,GAAG;GACT;GACN,KAAK;GACD;~~EACN~~,CAAC~~;CACH;AACF;;;;;;;;;;;;;;;;;;;;;;;;AAyBA~~,SAAgB,uBACd,QACA,UACA,SACA,IACyC;CACzC,MAAM,EAAC,uBAAuB,UAAS;CAEvC,MAAM,qBAAqB,GACxB,qBAAqB,uBAClB,gBAAgB,~~MAAM~~,~~UAIpB~~,QAAQ,OACN,IAAI,YAAY;EACd,MAAM;EACN,SAAS;~~CACX~~,CAAC,CACH,EACR;~~CAEA~~,~~IAAI~~,~~UACF~~,~~IAAI~~,kBAAkB,~~QAAQ~~,~~GAC5B~~,~~0BACE~~,IACA,SACA,UACA,QACA,~~kBACF~~;~~MAEA~~,~~yBACE~~,IACA,SACA,UACA,QACA,~~kBACF~~;~~CAIJ~~,~~OAAO;AACT;;;;;AAMA~~,SAAS,0BACP,IACA,SACA,UACA,QACA,cACM;CACN,MAAM,QAAQ,SAAkB;~~EAC9B~~,~~IAAI~~,OAAO,SAAS,YAAY,SAAS,~~MACvC~~;~~EAEF~~,~~KAAK~~,MAAM,SAAS,OAAO,OAAO,~~IAAI~~,~~GACpC~~,~~IAAI~~,UAAa,~~KAAK~~,~~GAEpB~~,~~aAAa~~,MAAM,gBACjB,OACA,SACkB;GAClB,MAAM,KAAK,IAAI,gBAAgB,IAAI,OAAO,~~MAAM~~;~~GAChD~~,~~OAAO~~,MAAM,GAAG;IAAC;IAAM,KAAK;IAAS;~~GAAE~~,CAAC~~;EAC1C;OACK~~,~~IAAI,~~OAAO,UAAU,YAAY,UAAU,~~MAEhD~~,~~KAAK~~,~~KAAK;CAGhB;CACA~~,~~KAAK~~,~~QAAQ;AACf~~"}
1	+ {"version":3,"file":"make-replicache-mutators.js","names":[],"sources":["../../../../../zero-client/src/client/make-replicache-mutators.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport type {MutatorDefs} from '../../../replicache/src/types.ts';\nimport type {ReadonlyJSONValue} from '../../../shared/src/json.ts';\nimport {CRUD_MUTATION_NAME} from '../../../zero-protocol/src/mutation.ts';\nimport type {Schema} from '../../../zero-types/src/schema.ts';\nimport {customMutatorKey} from '../../../zql/src/mutate/custom.ts';\nimport {\n isMutatorRegistry,\n type AnyMutatorRegistry,\n} from '../../../zql/src/mutate/mutator-registry.ts';\nimport {isMutator, type Mutator} from '../../../zql/src/mutate/mutator.ts';\nimport {ClientErrorKind} from './client-error-kind.ts';\nimport {makeCRUDMutator, type CRUDMutator} from './crud.ts';\nimport type {CustomMutatorDefs, CustomMutatorImpl} from './custom.ts';\nimport {\n makeReplicacheMutator as makeReplicacheMutatorLegacy,\n TransactionImpl,\n} from './custom.ts';\nimport {ClientError} from './error.ts';\nimport type {WriteTransaction} from './replicache-types.ts';\n\nexport function extendReplicacheMutators<S extends Schema, C>(\n lc: LogContext,\n context: C,\n mutators: AnyMutatorRegistry \| CustomMutatorDefs,\n schema: S,\n mutateObject: Record<string, unknown>,\n): void {\n // Recursively process mutator definitions at arbitrary depth\n const processMutators = (mutators: object, path: string[]) => {\n for (const [key, mutator] of Object.entries(mutators)) {\n if (key === '~') {\n // Skip phantom type\n continue;\n }\n\n path.push(key);\n if (isMutator(mutator)) {\n const fullKey = customMutatorKey('.', path);\n mutateObject[fullKey] = makeReplicacheMutator(\n lc,\n mutator,\n schema,\n context,\n );\n } else if (typeof mutator === 'function') {\n const fullKey = customMutatorKey('\|', path);\n mutateObject[fullKey] = makeReplicacheMutatorLegacy(\n lc,\n // oxlint-disable-next-line no-explicit-any\n mutator as CustomMutatorImpl<any>,\n schema,\n context,\n );\n } else if (mutator !== null && typeof mutator === 'object') {\n processMutators(mutator, path);\n }\n path.pop();\n }\n };\n\n processMutators(mutators, []);\n}\n\nfunction makeReplicacheMutator<\n TArgs extends ReadonlyJSONValue \| undefined,\n TSchema extends Schema,\n TContext,\n TWrappedTransaction,\n>(\n lc: LogContext,\n mutator: Mutator<TArgs, TSchema, TContext, TWrappedTransaction>,\n schema: TSchema,\n context: TContext,\n): (repTx: WriteTransaction, args: ReadonlyJSONValue) => Promise<void> {\n return async (\n repTx: WriteTransaction,\n args: ReadonlyJSONValue,\n ): Promise<void> => {\n const tx = new TransactionImpl(lc, repTx, schema);\n // fn does input validation internally\n await mutator.fn({\n args: args as TArgs,\n ctx: context,\n tx: tx,\n });\n };\n}\n\n/*\n Creates Replicache mutators from mutator definitions.\n \n This function processes mutator definitions at arbitrary depth, supporting both\n * new-style mutator definitions and legacy custom mutator implementations. It creates\n * a mutator object with the CRUD mutator and any provided custom mutators, with keys\n * generated based on their path in the mutator definition hierarchy.\n \n @template S - The schema type that defines the structure of the data\n * @template C - The type of the context object passed to mutators\n \n @param schema - The schema instance used for validation and type checking\n * @param mutators - The mutator definitions to process, can be nested objects or custom mutator definitions\n * @param context - The context to be passed to mutators\n * @param lc - The log context used for logging operations\n \n @returns A mutator definitions object containing the CRUD mutator and any custom mutators\n \n @remarks\n * - New-style mutator definitions use '.' as a separator in their keys\n * - Legacy custom mutator implementations use '\|' as a separator in their keys\n * - The CRUD mutator can be disabled by setting `enableLegacyMutators: false` in the schema\n /\nexport function makeReplicacheMutators<const S extends Schema, C>(\n schema: S,\n mutators: AnyMutatorRegistry \| CustomMutatorDefs \| undefined,\n context: C,\n lc: LogContext,\n): MutatorDefs & {_zero_crud: CRUDMutator} {\n const {enableLegacyMutators = false} = schema;\n\n const replicacheMutators = {\n [CRUD_MUTATION_NAME]: enableLegacyMutators\n ? makeCRUDMutator(schema)\n : // TODO(arv): This code is unreachable since the public API prevents\n // calling CRUD mutators when enableLegacyMutators is false. Remove this.\n () =>\n Promise.reject(\n new ClientError({\n kind: ClientErrorKind.Internal,\n message: 'Zero CRUD mutators are not enabled.',\n }),\n ),\n };\n\n if (mutators) {\n if (isMutatorRegistry(mutators)) {\n extendFromMutatorRegistry(\n lc,\n context,\n mutators,\n schema,\n replicacheMutators,\n );\n } else {\n extendReplicacheMutators(\n lc,\n context,\n mutators as CustomMutatorDefs,\n schema,\n replicacheMutators,\n );\n }\n }\n\n return replicacheMutators;\n}\n\n/\n Extends replicache mutators from a MutatorRegistry.\n * Walks the registry tree and wraps each Mutator.fn for Replicache.\n */\nfunction extendFromMutatorRegistry<S extends Schema, C>(\n lc: LogContext,\n context: C,\n registry: AnyMutatorRegistry,\n schema: S,\n mutateObject: Record<string, unknown>,\n): void {\n const walk = (node: unknown) => {\n if (typeof node !== 'object' \|\| node === null) {\n return;\n }\n for (const value of Object.values(node)) {\n if (isMutator<S>(value)) {\n // Mutator.fn already handles validation internally\n mutateObject[value.mutatorName] = (\n repTx: WriteTransaction,\n args: ReadonlyJSONValue,\n ): Promise<void> => {\n const tx = new TransactionImpl(lc, repTx, schema);\n return value.fn({args, ctx: context, tx});\n };\n } else if (typeof value === 'object' && value !== null) {\n // Nested namespace\n walk(value);\n }\n }\n };\n walk(registry);\n}\n"],"mappings":";;;;;;;;;AAqBA,SAAgB,yBACd,IACA,SACA,UACA,QACA,cACM;CAEN,MAAM,mBAAmB,UAAkB,SAAmB;AAC5D,OAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,SAAS,EAAE;AACrD,OAAI,QAAQ,IAEV;AAGF,QAAK,KAAK,IAAI;AACd,OAAI,UAAU,QAAQ,EAAE;IACtB,MAAM,UAAU,iBAAiB,KAAK,KAAK;AAC3C,iBAAa,WAAW,sBACtB,IACA,SACA,QACA,QACD;cACQ,OAAO,YAAY,YAAY;IACxC,MAAM,UAAU,iBAAiB,KAAK,KAAK;AAC3C,iBAAa,WAAW,wBACtB,IAEA,SACA,QACA,QACD;cACQ,YAAY,QAAQ,OAAO,YAAY,SAChD,iBAAgB,SAAS,KAAK;AAEhC,QAAK,KAAK;;;AAId,iBAAgB,UAAU,EAAE,CAAC;;AAG/B,SAAS,sBAMP,IACA,SACA,QACA,SACqE;AACrE,QAAO,OACL,OACA,SACkB;EAClB,MAAM,KAAK,IAAI,gBAAgB,IAAI,OAAO,OAAO;AAEjD,QAAM,QAAQ,GAAG;GACT;GACN,KAAK;GACD;GACL,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BN,SAAgB,uBACd,QACA,UACA,SACA,IACyC;CACzC,MAAM,EAAC,uBAAuB,UAAS;CAEvC,MAAM,qBAAqB,GACxB,qBAAqB,uBAClB,gBAAgB,OAAO,SAIrB,QAAQ,OACN,IAAI,YAAY;EACd,MAAM;EACN,SAAS;EACV,CAAC,CACH,EACR;AAED,KAAI,SACF,KAAI,kBAAkB,SAAS,CAC7B,2BACE,IACA,SACA,UACA,QACA,mBACD;KAED,0BACE,IACA,SACA,UACA,QACA,mBACD;AAIL,QAAO;;;;;;AAOT,SAAS,0BACP,IACA,SACA,UACA,QACA,cACM;CACN,MAAM,QAAQ,SAAkB;AAC9B,MAAI,OAAO,SAAS,YAAY,SAAS,KACvC;AAEF,OAAK,MAAM,SAAS,OAAO,OAAO,KAAK,CACrC,KAAI,UAAa,MAAM,CAErB,cAAa,MAAM,gBACjB,OACA,SACkB;GAClB,MAAM,KAAK,IAAI,gBAAgB,IAAI,OAAO,OAAO;AACjD,UAAO,MAAM,GAAG;IAAC;IAAM,KAAK;IAAS;IAAG,CAAC;;WAElC,OAAO,UAAU,YAAY,UAAU,KAEhD,MAAK,MAAM;;AAIjB,MAAK,SAAS"}

package/out/zero-client/src/client/metrics.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"metrics.js","names":["#reportIntervalMs","#host","#reporter","#lc","#setNotConnectedReason","#timerID","#register","#notConnected","#timeToConnectMsV2","#lastConnectErrorV2","#totalTimeToConnectMs","#metrics","#name","#value","#prefix","#clearOnFlush","#current"],"sources":["../../../../../zero-client/src/client/metrics.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport type {MaybePromise} from '../../../shared/src/types.ts';\nimport {ClientErrorKind} from './client-error-kind.ts';\nimport {\n isClientError,\n isServerError,\n type ZeroError,\n type ZeroErrorKind,\n} from './error.ts';\nimport {MetricName} from './metric-name.ts';\n\n// This value is used to indicate that the client's last connection attempt\n// failed. We don't make this -1 because we want to stack this never connected\n// state in a graph on top of actual connection times, so it should be greater\n// than any other value.\nexport const DID_NOT_CONNECT_VALUE = 100 * 1000;\n\nexport const REPORT_INTERVAL_MS = 5_000;\n\ntype NotConnectedReason =\n \| 'init'\n \| 'error'\n \| 'hidden'\n \| 'hidden_was_init'\n \| 'hidden_was_error';\n\nexport function getLastConnectErrorValue(reason: ZeroError) {\n return `${isServerError(reason) ? 'server_' : 'client_'}${camelToSnake(reason.kind)}` as const;\n}\n\nconst upperCasesRegExp = /\\.?(?=[A-Z])/;\n\n// camelToSnake is used to convert a ZeroErrorKind into a suitable\n// metric name, eg AuthInvalidated => auth_invalidated. It converts\n// both PascalCase and camelCase to snake_case.\nfunction camelToSnake(kind: ZeroErrorKind): string {\n return kind.split(upperCasesRegExp).join('_').toLowerCase();\n}\n\n/*\n Returns whether an error should be reported in metrics and\n * increment the connect error count.\n \n Returns `true` for all server errors and client errors that represent actual\n * connection problems. Returns `false` for expected client-side disconnections\n * (user disconnect, client closed, hidden tab, clean/abrupt close).\n /\nexport function shouldReportConnectError(reason: ZeroError): boolean {\n if (!isClientError(reason)) {\n return true;\n }\n switch (reason.kind) {\n case ClientErrorKind.Hidden:\n case ClientErrorKind.ClientClosed:\n case ClientErrorKind.UserDisconnect:\n case ClientErrorKind.CleanClose:\n case ClientErrorKind.AbruptClose:\n return false;\n default:\n return true;\n }\n}\n\ntype MetricsReporter = (metrics: Series[]) => MaybePromise<void>;\n\nexport type MetricManagerOptions = {\n reportIntervalMs: number;\n host: string;\n source: string;\n reporter: MetricsReporter;\n lc: LogContext;\n};\n\n/\n MetricManager keeps track of the set of metrics in use and flushes them\n * to a format suitable for reporting.\n /\nexport class MetricManager {\n #reportIntervalMs: number;\n #host: string;\n #reporter: MetricsReporter;\n #lc: LogContext;\n #timerID: ReturnType<typeof setInterval> \| null;\n\n constructor(opts: MetricManagerOptions) {\n this.#reportIntervalMs = opts.reportIntervalMs;\n this.#host = opts.host;\n this.#reporter = opts.reporter;\n this.#lc = opts.lc;\n\n this.tags.push(`source:${opts.source}`);\n\n this.timeToConnectMs.set(DID_NOT_CONNECT_VALUE);\n this.#setNotConnectedReason('init');\n\n this.#timerID = setInterval(() => {\n void this.flush();\n }, this.#reportIntervalMs);\n }\n\n #metrics: Flushable[] = [];\n\n // timeToConnectMs measures the time from the call to connect() to receiving\n // the 'connected' ws message. We record the DID_NOT_CONNECT_VALUE if the previous\n // connection attempt failed for any reason.\n //\n // We set the gauge using #connectStart as follows:\n // - #connectStart is undefined if we are disconnected or connected; it is\n // defined only in the Connecting state, as a number representing the timestamp\n // at which we started connecting.\n // - #connectStart is set to the current time when connect() is called.\n // - When we receive the 'connected' message we record the time to connect and\n // set #connectStart to undefined.\n // - If disconnect() is called with a defined #connectStart then we record\n // DID_NOT_CONNECT_VALUE and set #connectStart to undefined.\n //\n // TODO: this should be folded into the ConnectionManager.\n readonly timeToConnectMs = this.#register(\n new Gauge(MetricName.TimeToConnectMs),\n );\n\n // lastConnectError records the last error that occurred when connecting,\n // if any. It is cleared when connecting successfully or when reported, so this\n // state only gets reported if there was a failure during the reporting period and\n // we are still not connected.\n readonly lastConnectError = this.#register(\n new State(\n MetricName.LastConnectError,\n true, // clearOnFlush\n ),\n );\n\n // notConnected records the reason why the client is not currently connected.\n // It is cleared when the client successfully connects.\n readonly #notConnected = this.#register(new State(MetricName.NotConnected));\n\n // The time from the call to connect() to receiving the 'connected' ws message\n // for the current connection. Cleared when the client is not connected.\n // TODO: Not actually currently cleared on disconnect untill there is a\n // connect error, or client reports disconnected and waiting for visible.\n // Should have a value iff _notConnected has no value.\n readonly #timeToConnectMsV2 = this.#register(\n new Gauge(MetricName.TimeToConnectMsV2),\n );\n\n // lastConnectErrorV2 records the last error that occurred when connecting,\n // if any. It is cleared when the client successfully connects or\n // stops trying to connect due to being hidden.\n // Should have a value iff notConnected state is NotConnectedReason.Error.\n readonly #lastConnectErrorV2 = this.#register(\n new State(MetricName.LastConnectErrorV2),\n );\n\n // The total time it took to connect across retries for the current\n // connection. Cleared when the client is not connected.\n // TODO: Not actually currently cleared on disconnect until there is a\n // connect error, or client reports disconnected and waiting for visible.\n // See Zero.#totalToConnectStart for details of how this total is computed.\n // Should have a value iff _notConnected has no value.\n readonly #totalTimeToConnectMs = this.#register(\n new Gauge(MetricName.TotalTimeToConnectMs),\n );\n\n #setNotConnectedReason(reason: NotConnectedReason) {\n this.#notConnected.set(reason);\n }\n\n setConnected(timeToConnectMs: number, totalTimeToConnectMs: number) {\n this.#notConnected.clear();\n this.#lastConnectErrorV2.clear();\n this.#timeToConnectMsV2.set(timeToConnectMs);\n this.#totalTimeToConnectMs.set(totalTimeToConnectMs);\n }\n\n setDisconnectedWaitingForVisible() {\n this.#timeToConnectMsV2.clear();\n this.#totalTimeToConnectMs.clear();\n this.#lastConnectErrorV2.clear();\n let notConnectedReason: NotConnectedReason;\n switch (this.#notConnected.get()) {\n case 'init':\n notConnectedReason = 'hidden_was_init';\n break;\n case 'error':\n notConnectedReason = 'hidden_was_error';\n break;\n default:\n notConnectedReason = 'hidden';\n break;\n }\n this.#setNotConnectedReason(notConnectedReason);\n }\n\n setConnectError(reason: ZeroError) {\n this.#timeToConnectMsV2.clear();\n this.#totalTimeToConnectMs.clear();\n this.#setNotConnectedReason('error');\n this.#lastConnectErrorV2.set(getLastConnectErrorValue(reason));\n }\n\n /\n Tags to include in all metrics.\n /\n readonly tags: string[] = [];\n\n // Flushes all metrics to an array of time series (plural), one Series\n // per metric.\n async flush() {\n const lc = this.#lc;\n if (this.#timerID === null) {\n lc.error?.('MetricManager.flush() called but already stopped');\n return;\n }\n const allSeries: Series[] = [];\n for (const metric of this.#metrics) {\n const series = metric.flush();\n if (series !== undefined) {\n allSeries.push({\n ...series,\n host: this.#host,\n tags: this.tags,\n });\n }\n }\n if (allSeries.length === 0) {\n lc?.debug?.('No metrics to report');\n return;\n }\n try {\n await this.#reporter(allSeries);\n } catch (e) {\n lc?.error?.('Error reporting metrics', e);\n }\n }\n\n stop() {\n if (this.#timerID === null) {\n this.#lc.error?.('MetricManager.stop() called but already stopped');\n return;\n }\n clearInterval(this.#timerID);\n this.#timerID = null;\n }\n\n #register<M extends Flushable>(metric: M) {\n this.#metrics.push(metric);\n return metric;\n }\n}\n\n// These two types are influenced by Datadog's API's needs. We could change what\n// we use internally if necessary, but we'd just have to convert to/from before\n// sending to DD. So for convenience we go with their format.\n\n/* Series is a time series of points for a single metric. /\nexport type Series = {\n host: string;\n metric: string; // We call this 'name' bc 'metric' is overloaded in code.\n points: Point[];\n tags?: string[];\n};\n/\n A point is a second-resolution timestamp and a set of values for that\n * timestamp. A point represents exactly one second in time and the values\n * are those recorded for that second. The first element of this array\n * is the timestamp and the second element is an array of values.\n /\nexport type Point = [number, number[]];\n\nfunction makePoint(ts: number, value: number): Point {\n return [ts, [value]];\n}\n\ntype Flushable = {\n flush(): Pick<Series, 'metric' \| 'points'> \| undefined;\n};\n\n/\n Gauge is a metric type that represents a single value that can go up and\n * down. It's typically used to track discrete values or counts eg the number\n * of active users, number of connections, cpu load, etc. A gauge retains\n * its value when flushed.\n \n We use a Gauge to sample at the client. If we are interested in tracking\n * a metric value per client, the client can note the latest value in\n * a Gauge metric. The metric is periodically reported via Reporter. On the\n * server, we graph the value of the metric rolled up over the periodic\n * reporting period, that is, counted over a span of time equal to the\n * reporting period. The result is ~one point per client per reporting\n * period.\n /\nexport class Gauge implements Flushable {\n readonly #name: string;\n #value: number \| undefined = undefined;\n\n constructor(name: string) {\n this.#name = name;\n }\n\n set(value: number) {\n this.#value = value;\n }\n\n get() {\n return this.#value;\n }\n\n clear() {\n this.#value = undefined;\n }\n\n flush() {\n if (this.#value === undefined) {\n return undefined;\n }\n // Gauge reports the timestamp at flush time, not at the point the value was\n // recorded.\n const points = [makePoint(t(), this.#value)];\n return {metric: this.#name, points};\n }\n}\n\nfunction t() {\n return Math.round(Date.now() / 1000);\n}\n\n/\n State is a metric type that represents a specific state that the system is\n * in, for example the state of a connection which may be 'open' or 'closed'.\n * The state is given a name/prefix at construction time (eg 'connection') and\n * then can be set to a specific state (eg 'open'). The prefix is prepended to\n * the set state (eg, 'connection_open') and a value of 1 is reported.\n * Unset/cleared states are not reported.\n \n Example:\n * const s = new State('connection');\n * s.set('open');\n * s.flush(); // returns {metric: 'connection_open', points: [[now(), [1]]]}\n */\nexport class State implements Flushable {\n readonly #prefix: string;\n readonly #clearOnFlush: boolean;\n #current: string \| undefined = undefined;\n\n constructor(prefix: string, clearOnFlush = false) {\n this.#prefix = prefix;\n this.#clearOnFlush = clearOnFlush;\n }\n\n set(state: string) {\n this.#current = state;\n }\n\n get() {\n return this.#current;\n }\n\n clear() {\n this.#current = undefined;\n }\n\n flush() {\n if (this.#current === undefined) {\n return undefined;\n }\n const gauge = new Gauge([this.#prefix, this.#current].join('_'));\n gauge.set(1);\n const series = gauge.flush();\n if (this.#clearOnFlush) {\n this.clear();\n }\n return series;\n }\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"metrics.js","names":["#reportIntervalMs","#host","#reporter","#lc","#setNotConnectedReason","#timerID","#register","#notConnected","#timeToConnectMsV2","#lastConnectErrorV2","#totalTimeToConnectMs","#metrics","#name","#value","#prefix","#clearOnFlush","#current"],"sources":["../../../../../zero-client/src/client/metrics.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport type {MaybePromise} from '../../../shared/src/types.ts';\nimport {ClientErrorKind} from './client-error-kind.ts';\nimport {\n isClientError,\n isServerError,\n type ZeroError,\n type ZeroErrorKind,\n} from './error.ts';\nimport {MetricName} from './metric-name.ts';\n\n// This value is used to indicate that the client's last connection attempt\n// failed. We don't make this -1 because we want to stack this never connected\n// state in a graph on top of actual connection times, so it should be greater\n// than any other value.\nexport const DID_NOT_CONNECT_VALUE = 100 * 1000;\n\nexport const REPORT_INTERVAL_MS = 5_000;\n\ntype NotConnectedReason =\n \| 'init'\n \| 'error'\n \| 'hidden'\n \| 'hidden_was_init'\n \| 'hidden_was_error';\n\nexport function getLastConnectErrorValue(reason: ZeroError) {\n return `${isServerError(reason) ? 'server_' : 'client_'}${camelToSnake(reason.kind)}` as const;\n}\n\nconst upperCasesRegExp = /\\.?(?=[A-Z])/;\n\n// camelToSnake is used to convert a ZeroErrorKind into a suitable\n// metric name, eg AuthInvalidated => auth_invalidated. It converts\n// both PascalCase and camelCase to snake_case.\nfunction camelToSnake(kind: ZeroErrorKind): string {\n return kind.split(upperCasesRegExp).join('_').toLowerCase();\n}\n\n/*\n Returns whether an error should be reported in metrics and\n * increment the connect error count.\n \n Returns `true` for all server errors and client errors that represent actual\n * connection problems. Returns `false` for expected client-side disconnections\n * (user disconnect, client closed, hidden tab, clean/abrupt close).\n /\nexport function shouldReportConnectError(reason: ZeroError): boolean {\n if (!isClientError(reason)) {\n return true;\n }\n switch (reason.kind) {\n case ClientErrorKind.Hidden:\n case ClientErrorKind.ClientClosed:\n case ClientErrorKind.UserDisconnect:\n case ClientErrorKind.CleanClose:\n case ClientErrorKind.AbruptClose:\n return false;\n default:\n return true;\n }\n}\n\ntype MetricsReporter = (metrics: Series[]) => MaybePromise<void>;\n\nexport type MetricManagerOptions = {\n reportIntervalMs: number;\n host: string;\n source: string;\n reporter: MetricsReporter;\n lc: LogContext;\n};\n\n/\n MetricManager keeps track of the set of metrics in use and flushes them\n * to a format suitable for reporting.\n /\nexport class MetricManager {\n #reportIntervalMs: number;\n #host: string;\n #reporter: MetricsReporter;\n #lc: LogContext;\n #timerID: ReturnType<typeof setInterval> \| null;\n\n constructor(opts: MetricManagerOptions) {\n this.#reportIntervalMs = opts.reportIntervalMs;\n this.#host = opts.host;\n this.#reporter = opts.reporter;\n this.#lc = opts.lc;\n\n this.tags.push(`source:${opts.source}`);\n\n this.timeToConnectMs.set(DID_NOT_CONNECT_VALUE);\n this.#setNotConnectedReason('init');\n\n this.#timerID = setInterval(() => {\n void this.flush();\n }, this.#reportIntervalMs);\n }\n\n #metrics: Flushable[] = [];\n\n // timeToConnectMs measures the time from the call to connect() to receiving\n // the 'connected' ws message. We record the DID_NOT_CONNECT_VALUE if the previous\n // connection attempt failed for any reason.\n //\n // We set the gauge using #connectStart as follows:\n // - #connectStart is undefined if we are disconnected or connected; it is\n // defined only in the Connecting state, as a number representing the timestamp\n // at which we started connecting.\n // - #connectStart is set to the current time when connect() is called.\n // - When we receive the 'connected' message we record the time to connect and\n // set #connectStart to undefined.\n // - If disconnect() is called with a defined #connectStart then we record\n // DID_NOT_CONNECT_VALUE and set #connectStart to undefined.\n //\n // TODO: this should be folded into the ConnectionManager.\n readonly timeToConnectMs = this.#register(\n new Gauge(MetricName.TimeToConnectMs),\n );\n\n // lastConnectError records the last error that occurred when connecting,\n // if any. It is cleared when connecting successfully or when reported, so this\n // state only gets reported if there was a failure during the reporting period and\n // we are still not connected.\n readonly lastConnectError = this.#register(\n new State(\n MetricName.LastConnectError,\n true, // clearOnFlush\n ),\n );\n\n // notConnected records the reason why the client is not currently connected.\n // It is cleared when the client successfully connects.\n readonly #notConnected = this.#register(new State(MetricName.NotConnected));\n\n // The time from the call to connect() to receiving the 'connected' ws message\n // for the current connection. Cleared when the client is not connected.\n // TODO: Not actually currently cleared on disconnect untill there is a\n // connect error, or client reports disconnected and waiting for visible.\n // Should have a value iff _notConnected has no value.\n readonly #timeToConnectMsV2 = this.#register(\n new Gauge(MetricName.TimeToConnectMsV2),\n );\n\n // lastConnectErrorV2 records the last error that occurred when connecting,\n // if any. It is cleared when the client successfully connects or\n // stops trying to connect due to being hidden.\n // Should have a value iff notConnected state is NotConnectedReason.Error.\n readonly #lastConnectErrorV2 = this.#register(\n new State(MetricName.LastConnectErrorV2),\n );\n\n // The total time it took to connect across retries for the current\n // connection. Cleared when the client is not connected.\n // TODO: Not actually currently cleared on disconnect until there is a\n // connect error, or client reports disconnected and waiting for visible.\n // See Zero.#totalToConnectStart for details of how this total is computed.\n // Should have a value iff _notConnected has no value.\n readonly #totalTimeToConnectMs = this.#register(\n new Gauge(MetricName.TotalTimeToConnectMs),\n );\n\n #setNotConnectedReason(reason: NotConnectedReason) {\n this.#notConnected.set(reason);\n }\n\n setConnected(timeToConnectMs: number, totalTimeToConnectMs: number) {\n this.#notConnected.clear();\n this.#lastConnectErrorV2.clear();\n this.#timeToConnectMsV2.set(timeToConnectMs);\n this.#totalTimeToConnectMs.set(totalTimeToConnectMs);\n }\n\n setDisconnectedWaitingForVisible() {\n this.#timeToConnectMsV2.clear();\n this.#totalTimeToConnectMs.clear();\n this.#lastConnectErrorV2.clear();\n let notConnectedReason: NotConnectedReason;\n switch (this.#notConnected.get()) {\n case 'init':\n notConnectedReason = 'hidden_was_init';\n break;\n case 'error':\n notConnectedReason = 'hidden_was_error';\n break;\n default:\n notConnectedReason = 'hidden';\n break;\n }\n this.#setNotConnectedReason(notConnectedReason);\n }\n\n setConnectError(reason: ZeroError) {\n this.#timeToConnectMsV2.clear();\n this.#totalTimeToConnectMs.clear();\n this.#setNotConnectedReason('error');\n this.#lastConnectErrorV2.set(getLastConnectErrorValue(reason));\n }\n\n /\n Tags to include in all metrics.\n /\n readonly tags: string[] = [];\n\n // Flushes all metrics to an array of time series (plural), one Series\n // per metric.\n async flush() {\n const lc = this.#lc;\n if (this.#timerID === null) {\n lc.error?.('MetricManager.flush() called but already stopped');\n return;\n }\n const allSeries: Series[] = [];\n for (const metric of this.#metrics) {\n const series = metric.flush();\n if (series !== undefined) {\n allSeries.push({\n ...series,\n host: this.#host,\n tags: this.tags,\n });\n }\n }\n if (allSeries.length === 0) {\n lc?.debug?.('No metrics to report');\n return;\n }\n try {\n await this.#reporter(allSeries);\n } catch (e) {\n lc?.error?.('Error reporting metrics', e);\n }\n }\n\n stop() {\n if (this.#timerID === null) {\n this.#lc.error?.('MetricManager.stop() called but already stopped');\n return;\n }\n clearInterval(this.#timerID);\n this.#timerID = null;\n }\n\n #register<M extends Flushable>(metric: M) {\n this.#metrics.push(metric);\n return metric;\n }\n}\n\n// These two types are influenced by Datadog's API's needs. We could change what\n// we use internally if necessary, but we'd just have to convert to/from before\n// sending to DD. So for convenience we go with their format.\n\n/* Series is a time series of points for a single metric. /\nexport type Series = {\n host: string;\n metric: string; // We call this 'name' bc 'metric' is overloaded in code.\n points: Point[];\n tags?: string[];\n};\n/\n A point is a second-resolution timestamp and a set of values for that\n * timestamp. A point represents exactly one second in time and the values\n * are those recorded for that second. The first element of this array\n * is the timestamp and the second element is an array of values.\n /\nexport type Point = [number, number[]];\n\nfunction makePoint(ts: number, value: number): Point {\n return [ts, [value]];\n}\n\ntype Flushable = {\n flush(): Pick<Series, 'metric' \| 'points'> \| undefined;\n};\n\n/\n Gauge is a metric type that represents a single value that can go up and\n * down. It's typically used to track discrete values or counts eg the number\n * of active users, number of connections, cpu load, etc. A gauge retains\n * its value when flushed.\n \n We use a Gauge to sample at the client. If we are interested in tracking\n * a metric value per client, the client can note the latest value in\n * a Gauge metric. The metric is periodically reported via Reporter. On the\n * server, we graph the value of the metric rolled up over the periodic\n * reporting period, that is, counted over a span of time equal to the\n * reporting period. The result is ~one point per client per reporting\n * period.\n /\nexport class Gauge implements Flushable {\n readonly #name: string;\n #value: number \| undefined = undefined;\n\n constructor(name: string) {\n this.#name = name;\n }\n\n set(value: number) {\n this.#value = value;\n }\n\n get() {\n return this.#value;\n }\n\n clear() {\n this.#value = undefined;\n }\n\n flush() {\n if (this.#value === undefined) {\n return undefined;\n }\n // Gauge reports the timestamp at flush time, not at the point the value was\n // recorded.\n const points = [makePoint(t(), this.#value)];\n return {metric: this.#name, points};\n }\n}\n\nfunction t() {\n return Math.round(Date.now() / 1000);\n}\n\n/\n State is a metric type that represents a specific state that the system is\n * in, for example the state of a connection which may be 'open' or 'closed'.\n * The state is given a name/prefix at construction time (eg 'connection') and\n * then can be set to a specific state (eg 'open'). The prefix is prepended to\n * the set state (eg, 'connection_open') and a value of 1 is reported.\n * Unset/cleared states are not reported.\n \n Example:\n * const s = new State('connection');\n * s.set('open');\n * s.flush(); // returns {metric: 'connection_open', points: [[now(), [1]]]}\n */\nexport class State implements Flushable {\n readonly #prefix: string;\n readonly #clearOnFlush: boolean;\n #current: string \| undefined = undefined;\n\n constructor(prefix: string, clearOnFlush = false) {\n this.#prefix = prefix;\n this.#clearOnFlush = clearOnFlush;\n }\n\n set(state: string) {\n this.#current = state;\n }\n\n get() {\n return this.#current;\n }\n\n clear() {\n this.#current = undefined;\n }\n\n flush() {\n if (this.#current === undefined) {\n return undefined;\n }\n const gauge = new Gauge([this.#prefix, this.#current].join('_'));\n gauge.set(1);\n const series = gauge.flush();\n if (this.#clearOnFlush) {\n this.clear();\n }\n return series;\n }\n}\n"],"mappings":"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"}

package/out/zero-client/src/client/mutation-tracker.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"mutation-tracker.js","names":["#outstandingMutations","#ephemeralIDsByMutationID","#allMutationsAppliedListeners","#lc","#ackMutations","#onFatalError","#largestOutstandingMutationID","#currentMutationID","#clientID","#processMutationResponses","#settleMutation","#notifyAllMutationsAppliedListeners","#processMutationError","#processMutationOk","#fatalErrorFromPushError","#processPushOk","#resolveMutations"],"sources":["../../../../../zero-client/src/client/mutation-tracker.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport {resolver, type Resolver} from '@rocicorp/resolver';\nimport type {NoIndexDiff} from '../../../replicache/src/btree/node.ts';\nimport type {ReplicacheImpl} from '../../../replicache/src/impl.ts';\nimport type {\n EphemeralID,\n MutationTrackingData,\n} from '../../../replicache/src/replicache-options.ts';\nimport {assert, unreachable} from '../../../shared/src/asserts.ts';\nimport {getErrorDetails} from '../../../shared/src/error.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport {emptyObject} from '../../../shared/src/sentinels.ts';\nimport * as v from '../../../shared/src/valita.ts';\nimport {\n ApplicationError,\n isApplicationError,\n wrapWithApplicationError,\n} from '../../../zero-protocol/src/application-error.ts';\nimport {ErrorKind} from '../../../zero-protocol/src/error-kind.ts';\nimport {ErrorOrigin} from '../../../zero-protocol/src/error-origin.ts';\nimport {ErrorReason} from '../../../zero-protocol/src/error-reason.ts';\nimport {ProtocolError} from '../../../zero-protocol/src/error.ts';\nimport type {MutationID} from '../../../zero-protocol/src/mutation-id.ts';\nimport {\n mutationResultSchema,\n type MutationError,\n type MutationOk,\n} from '../../../zero-protocol/src/mutation.ts';\nimport type {\n PushError,\n PushOk,\n PushResponseBody,\n} from '../../../zero-protocol/src/push.ts';\nimport type {MutatorResultSuccessDetails} from './custom.ts';\nimport {isZeroError, type ZeroError} from './error.ts';\nimport {MUTATIONS_KEY_PREFIX} from './keys.ts';\n\ntype MutationSuccessType = MutatorResultSuccessDetails;\ntype MutationErrorType = ApplicationError \| ZeroError;\n\nlet currentEphemeralID = 0;\nfunction nextEphemeralID(): EphemeralID {\n return ++currentEphemeralID as EphemeralID;\n}\n\nconst successResultDetails: MutationSuccessType = {type: 'success'};\n\n/*\n Tracks what pushes are in-flight and resolves promises when they're acked.\n /\nexport class MutationTracker {\n readonly #outstandingMutations: Map<\n EphemeralID,\n {\n mutationID?: number \| undefined;\n resolver: Resolver<MutationSuccessType, MutationErrorType>;\n }\n >;\n readonly #ephemeralIDsByMutationID: Map<number, EphemeralID>;\n readonly #allMutationsAppliedListeners: Set<() => void>;\n readonly #lc: LogContext;\n\n readonly #ackMutations: (upTo: MutationID) => void;\n readonly #onFatalError: (error: ZeroError) => void;\n\n #clientID: string \| undefined;\n #largestOutstandingMutationID: number;\n #currentMutationID: number;\n\n constructor(\n lc: LogContext,\n ackMutations: (upTo: MutationID) => void,\n onFatalError: (error: ZeroError) => void,\n ) {\n this.#lc = lc.withContext('MutationTracker');\n this.#outstandingMutations = new Map();\n this.#ephemeralIDsByMutationID = new Map();\n this.#allMutationsAppliedListeners = new Set();\n this.#largestOutstandingMutationID = 0;\n this.#currentMutationID = 0;\n this.#ackMutations = ackMutations;\n this.#onFatalError = onFatalError;\n }\n\n setClientIDAndWatch(\n clientID: string,\n experimentalWatch: ReplicacheImpl['experimentalWatch'],\n ) {\n assert(this.#clientID === undefined, 'clientID already set');\n this.#clientID = clientID;\n experimentalWatch(\n diffs => {\n this.#processMutationResponses(diffs);\n },\n {\n prefix: MUTATIONS_KEY_PREFIX + clientID + '/',\n initialValuesInFirstDiff: true,\n },\n );\n }\n\n trackMutation(): MutationTrackingData<MutationSuccessType> {\n const id = nextEphemeralID();\n const mutationResolver = resolver<MutationSuccessType, MutationErrorType>();\n\n this.#outstandingMutations.set(id, {\n resolver: mutationResolver,\n });\n return {ephemeralID: id, serverPromise: mutationResolver.promise};\n }\n\n mutationIDAssigned(id: EphemeralID, mutationID: number): void {\n const entry = this.#outstandingMutations.get(id);\n if (entry) {\n entry.mutationID = mutationID;\n this.#ephemeralIDsByMutationID.set(mutationID, id);\n this.#largestOutstandingMutationID = Math.max(\n this.#largestOutstandingMutationID,\n mutationID,\n );\n }\n }\n\n /\n Reject the mutation due to an unhandled exception on the client.\n * The mutation must not have been persisted to the client store.\n /\n rejectMutation(id: EphemeralID, e: unknown): void {\n const entry = this.#outstandingMutations.get(id);\n if (entry) {\n this.#settleMutation(id, entry, wrapWithApplicationError(e));\n }\n }\n\n /\n Reject all outstanding mutations. Called when the client is in a state\n * that prevents mutations from being applied, such as offline or closed.\n /\n rejectAllOutstandingMutations(error: ZeroError): void {\n if (this.#outstandingMutations.size === 0) {\n return;\n }\n for (const [id, entry] of this.#outstandingMutations) {\n this.#settleMutation(id, entry, error);\n }\n this.#largestOutstandingMutationID = this.#currentMutationID;\n this.#notifyAllMutationsAppliedListeners();\n }\n\n /\n Used when zero-cache pokes down mutation results.\n /\n #processMutationResponses(diffs: NoIndexDiff): void {\n const clientID = must(this.#clientID);\n let largestLmid = 0;\n for (const diff of diffs) {\n const mutationID = Number(\n diff.key.slice(MUTATIONS_KEY_PREFIX.length + clientID.length + 1),\n );\n assert(\n !isNaN(mutationID),\n `MutationTracker received a diff with an invalid mutation ID: ${diff.key}`,\n );\n largestLmid = Math.max(largestLmid, mutationID);\n switch (diff.op) {\n case 'add': {\n const result = v.parse(diff.newValue, mutationResultSchema);\n if ('error' in result) {\n this.#processMutationError(clientID, mutationID, result);\n } else {\n this.#processMutationOk(clientID, mutationID, result);\n }\n break;\n }\n case 'del':\n break;\n case 'change':\n throw new Error('MutationTracker does not expect change operations');\n }\n }\n\n if (largestLmid > 0) {\n this.#ackMutations({\n clientID: must(this.#clientID),\n id: largestLmid,\n });\n }\n }\n\n processPushResponse(response: PushResponseBody): void {\n if ('error' in response) {\n this.#lc.error?.(\n 'Received an error response when pushing mutations',\n response,\n );\n const fatalError = this.#fatalErrorFromPushError(response);\n if (fatalError) {\n this.#onFatalError(fatalError);\n }\n } else {\n this.#processPushOk(response);\n }\n }\n\n #fatalErrorFromPushError(error: PushError): ZeroError \| undefined {\n switch (error.error) {\n case 'unsupportedPushVersion':\n return new ProtocolError({\n kind: ErrorKind.PushFailed,\n origin: ErrorOrigin.ZeroCache,\n reason: ErrorReason.Internal,\n message: `Unsupported push version`,\n mutationIDs: [],\n });\n case 'unsupportedSchemaVersion':\n return new ProtocolError({\n kind: ErrorKind.PushFailed,\n origin: ErrorOrigin.ZeroCache,\n reason: ErrorReason.Internal,\n message: `Unsupported schema version`,\n mutationIDs: [],\n });\n case 'http':\n return new ProtocolError({\n kind: ErrorKind.PushFailed,\n origin: ErrorOrigin.ZeroCache,\n reason: ErrorReason.HTTP,\n status: error.status,\n message: `Fetch from API server returned non-OK status ${error.status}: ${error.details ?? 'unknown'}`,\n mutationIDs: [],\n });\n case 'zeroPusher':\n return new ProtocolError({\n kind: ErrorKind.PushFailed,\n origin: ErrorOrigin.ZeroCache,\n reason: ErrorReason.Internal,\n message: `ZeroPusher error: ${error.details ?? 'unknown'}`,\n mutationIDs: [],\n });\n default:\n unreachable(error);\n }\n }\n\n /\n DEPRECATED: to be removed when we switch to fully driving\n * mutation resolution via poke.\n \n When we reconnect to zero-cache, we resolve all outstanding mutations\n * whose ID is less than or equal to the lastMutationID.\n \n The reason is that any responses the API server sent\n * to those mutations have been lost.\n \n An example case: the API server responds while the connection\n * is down. Those responses are lost.\n \n Mutations whose LMID is > the lastMutationID are not resolved\n * since they will be retried by the client, giving us another chance\n * at getting a response.\n \n The only way to ensure that all API server responses are\n * received would be to have the API server write them\n * to the DB while writing the LMID.\n /\n onConnected(lastMutationID: number) {\n this.lmidAdvanced(lastMutationID);\n }\n\n /\n lmid advance will:\n * 1. notify \"allMutationsApplied\" listeners if the lastMutationID\n * is greater than or equal to the largest outstanding mutation ID.\n * 2. resolve all mutations whose mutation ID is less than or equal to\n * the lastMutationID.\n /\n lmidAdvanced(lastMutationID: number): void {\n assert(\n lastMutationID >= this.#currentMutationID,\n 'lmid must be greater than or equal to current lmid',\n );\n if (lastMutationID === this.#currentMutationID) {\n return;\n }\n\n try {\n this.#currentMutationID = lastMutationID;\n this.#resolveMutations(lastMutationID);\n } finally {\n if (lastMutationID >= this.#largestOutstandingMutationID) {\n // this is very important otherwise we hang query de-registration\n this.#notifyAllMutationsAppliedListeners();\n }\n }\n }\n\n get size() {\n return this.#outstandingMutations.size;\n }\n\n #resolveMutations(upTo: number): void {\n // We resolve all mutations whose mutation ID is less than or equal to\n // the upTo mutation ID.\n for (const [id, entry] of this.#outstandingMutations) {\n if (entry.mutationID && entry.mutationID <= upTo) {\n this.#settleMutation(id, entry, emptyObject);\n } else {\n break; // the map is in insertion order which is in mutation ID order\n }\n }\n }\n\n #processPushOk(success: PushOk): void {\n for (const mutation of success.mutations) {\n if ('error' in mutation.result) {\n this.#processMutationError(\n mutation.id.clientID,\n mutation.id.id,\n mutation.result,\n );\n } else {\n this.#processMutationOk(\n mutation.id.clientID,\n mutation.id.id,\n mutation.result,\n );\n }\n }\n }\n\n #processMutationError(\n clientID: string,\n mid: number,\n error: MutationError \| Omit<PushError, 'mutationIDs'>,\n ): void {\n assert(\n clientID === this.#clientID,\n 'received mutation for the wrong client',\n );\n\n // Each tab sends all mutations for the client group\n // and the server responds back to the individual client that actually\n // ran the mutation. This means that N clients can send the same\n // mutation concurrently. If that happens, the promise for the mutation tracked\n // by this class will try to be resolved N times.\n // Every time after the first, the ephemeral ID will not be found.\n //\n // We also reject all outstanding mutations when the client is in a state\n // that prevents mutations from being applied, such as offline or closed.\n // In this case, the ephemeral ID will also not be found.\n const ephemeralID = this.#ephemeralIDsByMutationID.get(mid);\n if (!ephemeralID) {\n this.#lc.debug?.(\n 'Mutation already resolved or rejected (e.g. due to disconnect); ignore late reject.',\n );\n return;\n }\n\n const entry = this.#outstandingMutations.get(ephemeralID);\n assert(\n entry && entry.mutationID === mid,\n `outstanding mutation not found for mutation ID ${mid} and ephemeral ID ${ephemeralID}`,\n );\n\n if (error.error === 'alreadyProcessed') {\n this.#settleMutation(ephemeralID, entry, emptyObject);\n return;\n }\n\n this.#settleMutation(\n ephemeralID,\n entry,\n error.error === 'app'\n ? new ApplicationError(\n error.message ?? `Unknown application error: ${error.error}`,\n error.details ? {details: error.details} : undefined,\n )\n : new ProtocolError({\n kind: ErrorKind.InvalidPush,\n origin: ErrorOrigin.Server,\n reason: ErrorReason.Internal,\n message:\n error.error === 'oooMutation'\n ? 'Server reported an out-of-order mutation'\n : `Unknown fallback error with mutation ID ${mid}: ${error.error}`,\n details: getErrorDetails(error),\n }),\n );\n\n // this is included for backwards compatibility with the per-mutation fatal error responses\n if (error.error === 'oooMutation') {\n this.#onFatalError(\n new ProtocolError({\n kind: ErrorKind.InvalidPush,\n origin: ErrorOrigin.Server,\n reason: ErrorReason.Internal,\n message: 'Server reported an out-of-order mutation',\n details: error.details,\n }),\n );\n }\n }\n\n #processMutationOk(clientID: string, mid: number, result: MutationOk): void {\n assert(\n clientID === this.#clientID,\n 'received mutation for the wrong client',\n );\n\n // We reject all outstanding mutations when the client is in a state\n // that prevents mutations from being applied, such as offline or closed.\n // In this case, the ephemeral ID will not be found.\n const ephemeralID = this.#ephemeralIDsByMutationID.get(mid);\n if (!ephemeralID) {\n this.#lc.debug?.(\n 'Mutation already resolved or rejected (e.g. due to disconnect); ignore late resolve.',\n );\n return;\n }\n\n const entry = this.#outstandingMutations.get(ephemeralID);\n assert(\n entry && entry.mutationID === mid,\n `outstanding mutation not found for mutation ID ${mid} and ephemeral ID ${ephemeralID}`,\n );\n this.#settleMutation(ephemeralID, entry, result);\n }\n\n #settleMutation<Result extends MutationOk \| ApplicationError \| ZeroError>(\n ephemeralID: EphemeralID,\n entry: {\n mutationID?: number \| undefined;\n resolver: Resolver<MutationSuccessType, MutationErrorType>;\n },\n result: Result,\n ): void {\n if (isApplicationError(result) \|\| isZeroError(result)) {\n // we reject here and catch in the mutator proxy\n // the mutator proxy catches both client and server errors\n entry.resolver.reject(result);\n } else {\n entry.resolver.resolve(successResultDetails);\n }\n\n this.#outstandingMutations.delete(ephemeralID);\n if (entry.mutationID) {\n this.#ephemeralIDsByMutationID.delete(entry.mutationID);\n }\n }\n\n /\n Be notified when all mutations have been included in the server snapshot.\n \n The query manager will not de-register queries from the server until there\n * are no pending mutations.\n \n The reason is that a mutation may need to be rebased. We do not want\n * data that was available the first time it was run to not be available\n * on a rebase.\n */\n onAllMutationsApplied(listener: () => void): void {\n this.#allMutationsAppliedListeners.add(listener);\n }\n\n #notifyAllMutationsAppliedListeners() {\n for (const listener of this.#allMutationsAppliedListeners) {\n listener();\n }\n }\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"mutation-tracker.js","names":["#outstandingMutations","#ephemeralIDsByMutationID","#allMutationsAppliedListeners","#lc","#ackMutations","#onFatalError","#largestOutstandingMutationID","#currentMutationID","#clientID","#processMutationResponses","#settleMutation","#notifyAllMutationsAppliedListeners","#processMutationError","#processMutationOk","#fatalErrorFromPushError","#processPushOk","#resolveMutations"],"sources":["../../../../../zero-client/src/client/mutation-tracker.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport {resolver, type Resolver} from '@rocicorp/resolver';\nimport type {NoIndexDiff} from '../../../replicache/src/btree/node.ts';\nimport type {ReplicacheImpl} from '../../../replicache/src/impl.ts';\nimport type {\n EphemeralID,\n MutationTrackingData,\n} from '../../../replicache/src/replicache-options.ts';\nimport {assert, unreachable} from '../../../shared/src/asserts.ts';\nimport {getErrorDetails} from '../../../shared/src/error.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport {emptyObject} from '../../../shared/src/sentinels.ts';\nimport * as v from '../../../shared/src/valita.ts';\nimport {\n ApplicationError,\n isApplicationError,\n wrapWithApplicationError,\n} from '../../../zero-protocol/src/application-error.ts';\nimport {ErrorKind} from '../../../zero-protocol/src/error-kind.ts';\nimport {ErrorOrigin} from '../../../zero-protocol/src/error-origin.ts';\nimport {ErrorReason} from '../../../zero-protocol/src/error-reason.ts';\nimport {ProtocolError} from '../../../zero-protocol/src/error.ts';\nimport type {MutationID} from '../../../zero-protocol/src/mutation-id.ts';\nimport {\n mutationResultSchema,\n type MutationError,\n type MutationOk,\n} from '../../../zero-protocol/src/mutation.ts';\nimport type {\n PushError,\n PushOk,\n PushResponseBody,\n} from '../../../zero-protocol/src/push.ts';\nimport type {MutatorResultSuccessDetails} from './custom.ts';\nimport {isZeroError, type ZeroError} from './error.ts';\nimport {MUTATIONS_KEY_PREFIX} from './keys.ts';\n\ntype MutationSuccessType = MutatorResultSuccessDetails;\ntype MutationErrorType = ApplicationError \| ZeroError;\n\nlet currentEphemeralID = 0;\nfunction nextEphemeralID(): EphemeralID {\n return ++currentEphemeralID as EphemeralID;\n}\n\nconst successResultDetails: MutationSuccessType = {type: 'success'};\n\n/*\n Tracks what pushes are in-flight and resolves promises when they're acked.\n /\nexport class MutationTracker {\n readonly #outstandingMutations: Map<\n EphemeralID,\n {\n mutationID?: number \| undefined;\n resolver: Resolver<MutationSuccessType, MutationErrorType>;\n }\n >;\n readonly #ephemeralIDsByMutationID: Map<number, EphemeralID>;\n readonly #allMutationsAppliedListeners: Set<() => void>;\n readonly #lc: LogContext;\n\n readonly #ackMutations: (upTo: MutationID) => void;\n readonly #onFatalError: (error: ZeroError) => void;\n\n #clientID: string \| undefined;\n #largestOutstandingMutationID: number;\n #currentMutationID: number;\n\n constructor(\n lc: LogContext,\n ackMutations: (upTo: MutationID) => void,\n onFatalError: (error: ZeroError) => void,\n ) {\n this.#lc = lc.withContext('MutationTracker');\n this.#outstandingMutations = new Map();\n this.#ephemeralIDsByMutationID = new Map();\n this.#allMutationsAppliedListeners = new Set();\n this.#largestOutstandingMutationID = 0;\n this.#currentMutationID = 0;\n this.#ackMutations = ackMutations;\n this.#onFatalError = onFatalError;\n }\n\n setClientIDAndWatch(\n clientID: string,\n experimentalWatch: ReplicacheImpl['experimentalWatch'],\n ) {\n assert(this.#clientID === undefined, 'clientID already set');\n this.#clientID = clientID;\n experimentalWatch(\n diffs => {\n this.#processMutationResponses(diffs);\n },\n {\n prefix: MUTATIONS_KEY_PREFIX + clientID + '/',\n initialValuesInFirstDiff: true,\n },\n );\n }\n\n trackMutation(): MutationTrackingData<MutationSuccessType> {\n const id = nextEphemeralID();\n const mutationResolver = resolver<MutationSuccessType, MutationErrorType>();\n\n this.#outstandingMutations.set(id, {\n resolver: mutationResolver,\n });\n return {ephemeralID: id, serverPromise: mutationResolver.promise};\n }\n\n mutationIDAssigned(id: EphemeralID, mutationID: number): void {\n const entry = this.#outstandingMutations.get(id);\n if (entry) {\n entry.mutationID = mutationID;\n this.#ephemeralIDsByMutationID.set(mutationID, id);\n this.#largestOutstandingMutationID = Math.max(\n this.#largestOutstandingMutationID,\n mutationID,\n );\n }\n }\n\n /\n Reject the mutation due to an unhandled exception on the client.\n * The mutation must not have been persisted to the client store.\n /\n rejectMutation(id: EphemeralID, e: unknown): void {\n const entry = this.#outstandingMutations.get(id);\n if (entry) {\n this.#settleMutation(id, entry, wrapWithApplicationError(e));\n }\n }\n\n /\n Reject all outstanding mutations. Called when the client is in a state\n * that prevents mutations from being applied, such as offline or closed.\n /\n rejectAllOutstandingMutations(error: ZeroError): void {\n if (this.#outstandingMutations.size === 0) {\n return;\n }\n for (const [id, entry] of this.#outstandingMutations) {\n this.#settleMutation(id, entry, error);\n }\n this.#largestOutstandingMutationID = this.#currentMutationID;\n this.#notifyAllMutationsAppliedListeners();\n }\n\n /\n Used when zero-cache pokes down mutation results.\n /\n #processMutationResponses(diffs: NoIndexDiff): void {\n const clientID = must(this.#clientID);\n let largestLmid = 0;\n for (const diff of diffs) {\n const mutationID = Number(\n diff.key.slice(MUTATIONS_KEY_PREFIX.length + clientID.length + 1),\n );\n assert(\n !isNaN(mutationID),\n `MutationTracker received a diff with an invalid mutation ID: ${diff.key}`,\n );\n largestLmid = Math.max(largestLmid, mutationID);\n switch (diff.op) {\n case 'add': {\n const result = v.parse(diff.newValue, mutationResultSchema);\n if ('error' in result) {\n this.#processMutationError(clientID, mutationID, result);\n } else {\n this.#processMutationOk(clientID, mutationID, result);\n }\n break;\n }\n case 'del':\n break;\n case 'change':\n throw new Error('MutationTracker does not expect change operations');\n }\n }\n\n if (largestLmid > 0) {\n this.#ackMutations({\n clientID: must(this.#clientID),\n id: largestLmid,\n });\n }\n }\n\n processPushResponse(response: PushResponseBody): void {\n if ('error' in response) {\n this.#lc.error?.(\n 'Received an error response when pushing mutations',\n response,\n );\n const fatalError = this.#fatalErrorFromPushError(response);\n if (fatalError) {\n this.#onFatalError(fatalError);\n }\n } else {\n this.#processPushOk(response);\n }\n }\n\n #fatalErrorFromPushError(error: PushError): ZeroError \| undefined {\n switch (error.error) {\n case 'unsupportedPushVersion':\n return new ProtocolError({\n kind: ErrorKind.PushFailed,\n origin: ErrorOrigin.ZeroCache,\n reason: ErrorReason.Internal,\n message: `Unsupported push version`,\n mutationIDs: [],\n });\n case 'unsupportedSchemaVersion':\n return new ProtocolError({\n kind: ErrorKind.PushFailed,\n origin: ErrorOrigin.ZeroCache,\n reason: ErrorReason.Internal,\n message: `Unsupported schema version`,\n mutationIDs: [],\n });\n case 'http':\n return new ProtocolError({\n kind: ErrorKind.PushFailed,\n origin: ErrorOrigin.ZeroCache,\n reason: ErrorReason.HTTP,\n status: error.status,\n message: `Fetch from API server returned non-OK status ${error.status}: ${error.details ?? 'unknown'}`,\n mutationIDs: [],\n });\n case 'zeroPusher':\n return new ProtocolError({\n kind: ErrorKind.PushFailed,\n origin: ErrorOrigin.ZeroCache,\n reason: ErrorReason.Internal,\n message: `ZeroPusher error: ${error.details ?? 'unknown'}`,\n mutationIDs: [],\n });\n default:\n unreachable(error);\n }\n }\n\n /\n DEPRECATED: to be removed when we switch to fully driving\n * mutation resolution via poke.\n \n When we reconnect to zero-cache, we resolve all outstanding mutations\n * whose ID is less than or equal to the lastMutationID.\n \n The reason is that any responses the API server sent\n * to those mutations have been lost.\n \n An example case: the API server responds while the connection\n * is down. Those responses are lost.\n \n Mutations whose LMID is > the lastMutationID are not resolved\n * since they will be retried by the client, giving us another chance\n * at getting a response.\n \n The only way to ensure that all API server responses are\n * received would be to have the API server write them\n * to the DB while writing the LMID.\n /\n onConnected(lastMutationID: number) {\n this.lmidAdvanced(lastMutationID);\n }\n\n /\n lmid advance will:\n * 1. notify \"allMutationsApplied\" listeners if the lastMutationID\n * is greater than or equal to the largest outstanding mutation ID.\n * 2. resolve all mutations whose mutation ID is less than or equal to\n * the lastMutationID.\n /\n lmidAdvanced(lastMutationID: number): void {\n assert(\n lastMutationID >= this.#currentMutationID,\n 'lmid must be greater than or equal to current lmid',\n );\n if (lastMutationID === this.#currentMutationID) {\n return;\n }\n\n try {\n this.#currentMutationID = lastMutationID;\n this.#resolveMutations(lastMutationID);\n } finally {\n if (lastMutationID >= this.#largestOutstandingMutationID) {\n // this is very important otherwise we hang query de-registration\n this.#notifyAllMutationsAppliedListeners();\n }\n }\n }\n\n get size() {\n return this.#outstandingMutations.size;\n }\n\n #resolveMutations(upTo: number): void {\n // We resolve all mutations whose mutation ID is less than or equal to\n // the upTo mutation ID.\n for (const [id, entry] of this.#outstandingMutations) {\n if (entry.mutationID && entry.mutationID <= upTo) {\n this.#settleMutation(id, entry, emptyObject);\n } else {\n break; // the map is in insertion order which is in mutation ID order\n }\n }\n }\n\n #processPushOk(success: PushOk): void {\n for (const mutation of success.mutations) {\n if ('error' in mutation.result) {\n this.#processMutationError(\n mutation.id.clientID,\n mutation.id.id,\n mutation.result,\n );\n } else {\n this.#processMutationOk(\n mutation.id.clientID,\n mutation.id.id,\n mutation.result,\n );\n }\n }\n }\n\n #processMutationError(\n clientID: string,\n mid: number,\n error: MutationError \| Omit<PushError, 'mutationIDs'>,\n ): void {\n assert(\n clientID === this.#clientID,\n 'received mutation for the wrong client',\n );\n\n // Each tab sends all mutations for the client group\n // and the server responds back to the individual client that actually\n // ran the mutation. This means that N clients can send the same\n // mutation concurrently. If that happens, the promise for the mutation tracked\n // by this class will try to be resolved N times.\n // Every time after the first, the ephemeral ID will not be found.\n //\n // We also reject all outstanding mutations when the client is in a state\n // that prevents mutations from being applied, such as offline or closed.\n // In this case, the ephemeral ID will also not be found.\n const ephemeralID = this.#ephemeralIDsByMutationID.get(mid);\n if (!ephemeralID) {\n this.#lc.debug?.(\n 'Mutation already resolved or rejected (e.g. due to disconnect); ignore late reject.',\n );\n return;\n }\n\n const entry = this.#outstandingMutations.get(ephemeralID);\n assert(\n entry && entry.mutationID === mid,\n `outstanding mutation not found for mutation ID ${mid} and ephemeral ID ${ephemeralID}`,\n );\n\n if (error.error === 'alreadyProcessed') {\n this.#settleMutation(ephemeralID, entry, emptyObject);\n return;\n }\n\n this.#settleMutation(\n ephemeralID,\n entry,\n error.error === 'app'\n ? new ApplicationError(\n error.message ?? `Unknown application error: ${error.error}`,\n error.details ? {details: error.details} : undefined,\n )\n : new ProtocolError({\n kind: ErrorKind.InvalidPush,\n origin: ErrorOrigin.Server,\n reason: ErrorReason.Internal,\n message:\n error.error === 'oooMutation'\n ? 'Server reported an out-of-order mutation'\n : `Unknown fallback error with mutation ID ${mid}: ${error.error}`,\n details: getErrorDetails(error),\n }),\n );\n\n // this is included for backwards compatibility with the per-mutation fatal error responses\n if (error.error === 'oooMutation') {\n this.#onFatalError(\n new ProtocolError({\n kind: ErrorKind.InvalidPush,\n origin: ErrorOrigin.Server,\n reason: ErrorReason.Internal,\n message: 'Server reported an out-of-order mutation',\n details: error.details,\n }),\n );\n }\n }\n\n #processMutationOk(clientID: string, mid: number, result: MutationOk): void {\n assert(\n clientID === this.#clientID,\n 'received mutation for the wrong client',\n );\n\n // We reject all outstanding mutations when the client is in a state\n // that prevents mutations from being applied, such as offline or closed.\n // In this case, the ephemeral ID will not be found.\n const ephemeralID = this.#ephemeralIDsByMutationID.get(mid);\n if (!ephemeralID) {\n this.#lc.debug?.(\n 'Mutation already resolved or rejected (e.g. due to disconnect); ignore late resolve.',\n );\n return;\n }\n\n const entry = this.#outstandingMutations.get(ephemeralID);\n assert(\n entry && entry.mutationID === mid,\n `outstanding mutation not found for mutation ID ${mid} and ephemeral ID ${ephemeralID}`,\n );\n this.#settleMutation(ephemeralID, entry, result);\n }\n\n #settleMutation<Result extends MutationOk \| ApplicationError \| ZeroError>(\n ephemeralID: EphemeralID,\n entry: {\n mutationID?: number \| undefined;\n resolver: Resolver<MutationSuccessType, MutationErrorType>;\n },\n result: Result,\n ): void {\n if (isApplicationError(result) \|\| isZeroError(result)) {\n // we reject here and catch in the mutator proxy\n // the mutator proxy catches both client and server errors\n entry.resolver.reject(result);\n } else {\n entry.resolver.resolve(successResultDetails);\n }\n\n this.#outstandingMutations.delete(ephemeralID);\n if (entry.mutationID) {\n this.#ephemeralIDsByMutationID.delete(entry.mutationID);\n }\n }\n\n /\n Be notified when all mutations have been included in the server snapshot.\n \n The query manager will not de-register queries from the server until there\n * are no pending mutations.\n \n The reason is that a mutation may need to be rebased. We do not want\n * data that was available the first time it was run to not be available\n * on a rebase.\n */\n onAllMutationsApplied(listener: () => void): void {\n this.#allMutationsAppliedListeners.add(listener);\n }\n\n #notifyAllMutationsAppliedListeners() {\n for (const listener of this.#allMutationsAppliedListeners) {\n listener();\n }\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAwCA,IAAI,qBAAqB;AACzB,SAAS,kBAA+B;AACtC,QAAO,EAAE;;AAGX,IAAM,uBAA4C,EAAC,MAAM,WAAU;;;;AAKnE,IAAa,kBAAb,MAA6B;CAC3B;CAOA;CACA;CACA;CAEA;CACA;CAEA;CACA;CACA;CAEA,YACE,IACA,cACA,cACA;AACA,QAAA,KAAW,GAAG,YAAY,kBAAkB;AAC5C,QAAA,uCAA6B,IAAI,KAAK;AACtC,QAAA,2CAAiC,IAAI,KAAK;AAC1C,QAAA,+CAAqC,IAAI,KAAK;AAC9C,QAAA,+BAAqC;AACrC,QAAA,oBAA0B;AAC1B,QAAA,eAAqB;AACrB,QAAA,eAAqB;;CAGvB,oBACE,UACA,mBACA;AACA,SAAO,MAAA,aAAmB,KAAA,GAAW,uBAAuB;AAC5D,QAAA,WAAiB;AACjB,qBACE,UAAS;AACP,SAAA,yBAA+B,MAAM;KAEvC;GACE,QAAA,OAA+B,WAAW;GAC1C,0BAA0B;GAC3B,CACF;;CAGH,gBAA2D;EACzD,MAAM,KAAK,iBAAiB;EAC5B,MAAM,mBAAmB,UAAkD;AAE3E,QAAA,qBAA2B,IAAI,IAAI,EACjC,UAAU,kBACX,CAAC;AACF,SAAO;GAAC,aAAa;GAAI,eAAe,iBAAiB;GAAQ;;CAGnE,mBAAmB,IAAiB,YAA0B;EAC5D,MAAM,QAAQ,MAAA,qBAA2B,IAAI,GAAG;AAChD,MAAI,OAAO;AACT,SAAM,aAAa;AACnB,SAAA,yBAA+B,IAAI,YAAY,GAAG;AAClD,SAAA,+BAAqC,KAAK,IACxC,MAAA,8BACA,WACD;;;;;;;CAQL,eAAe,IAAiB,GAAkB;EAChD,MAAM,QAAQ,MAAA,qBAA2B,IAAI,GAAG;AAChD,MAAI,MACF,OAAA,eAAqB,IAAI,OAAO,yBAAyB,EAAE,CAAC;;;;;;CAQhE,8BAA8B,OAAwB;AACpD,MAAI,MAAA,qBAA2B,SAAS,EACtC;AAEF,OAAK,MAAM,CAAC,IAAI,UAAU,MAAA,qBACxB,OAAA,eAAqB,IAAI,OAAO,MAAM;AAExC,QAAA,+BAAqC,MAAA;AACrC,QAAA,oCAA0C;;;;;CAM5C,0BAA0B,OAA0B;EAClD,MAAM,WAAW,KAAK,MAAA,SAAe;EACrC,IAAI,cAAc;AAClB,OAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,aAAa,OACjB,KAAK,IAAI,MAAA,IAAoC,SAAS,SAAS,EAAE,CAClE;AACD,UACE,CAAC,MAAM,WAAW,EAClB,gEAAgE,KAAK,MACtE;AACD,iBAAc,KAAK,IAAI,aAAa,WAAW;AAC/C,WAAQ,KAAK,IAAb;IACE,KAAK,OAAO;KACV,MAAM,SAAS,MAAQ,KAAK,UAAU,qBAAqB;AAC3D,SAAI,WAAW,OACb,OAAA,qBAA2B,UAAU,YAAY,OAAO;SAExD,OAAA,kBAAwB,UAAU,YAAY,OAAO;AAEvD;;IAEF,KAAK,MACH;IACF,KAAK,SACH,OAAM,IAAI,MAAM,oDAAoD;;;AAI1E,MAAI,cAAc,EAChB,OAAA,aAAmB;GACjB,UAAU,KAAK,MAAA,SAAe;GAC9B,IAAI;GACL,CAAC;;CAIN,oBAAoB,UAAkC;AACpD,MAAI,WAAW,UAAU;AACvB,SAAA,GAAS,QACP,qDACA,SACD;GACD,MAAM,aAAa,MAAA,wBAA8B,SAAS;AAC1D,OAAI,WACF,OAAA,aAAmB,WAAW;QAGhC,OAAA,cAAoB,SAAS;;CAIjC,yBAAyB,OAAyC;AAChE,UAAQ,MAAM,OAAd;GACE,KAAK,yBACH,QAAO,IAAI,cAAc;IACvB,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,aAAa,EAAE;IAChB,CAAC;GACJ,KAAK,2BACH,QAAO,IAAI,cAAc;IACvB,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,aAAa,EAAE;IAChB,CAAC;GACJ,KAAK,OACH,QAAO,IAAI,cAAc;IACvB,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,QAAQ,MAAM;IACd,SAAS,gDAAgD,MAAM,OAAO,IAAI,MAAM,WAAW;IAC3F,aAAa,EAAE;IAChB,CAAC;GACJ,KAAK,aACH,QAAO,IAAI,cAAc;IACvB,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,SAAS,qBAAqB,MAAM,WAAW;IAC/C,aAAa,EAAE;IAChB,CAAC;GACJ,QACE,aAAY,MAAM;;;;;;;;;;;;;;;;;;;;;;;;CAyBxB,YAAY,gBAAwB;AAClC,OAAK,aAAa,eAAe;;;;;;;;;CAUnC,aAAa,gBAA8B;AACzC,SACE,kBAAkB,MAAA,mBAClB,qDACD;AACD,MAAI,mBAAmB,MAAA,kBACrB;AAGF,MAAI;AACF,SAAA,oBAA0B;AAC1B,SAAA,iBAAuB,eAAe;YAC9B;AACR,OAAI,kBAAkB,MAAA,6BAEpB,OAAA,oCAA0C;;;CAKhD,IAAI,OAAO;AACT,SAAO,MAAA,qBAA2B;;CAGpC,kBAAkB,MAAoB;AAGpC,OAAK,MAAM,CAAC,IAAI,UAAU,MAAA,qBACxB,KAAI,MAAM,cAAc,MAAM,cAAc,KAC1C,OAAA,eAAqB,IAAI,OAAO,YAAY;MAE5C;;CAKN,eAAe,SAAuB;AACpC,OAAK,MAAM,YAAY,QAAQ,UAC7B,KAAI,WAAW,SAAS,OACtB,OAAA,qBACE,SAAS,GAAG,UACZ,SAAS,GAAG,IACZ,SAAS,OACV;MAED,OAAA,kBACE,SAAS,GAAG,UACZ,SAAS,GAAG,IACZ,SAAS,OACV;;CAKP,sBACE,UACA,KACA,OACM;AACN,SACE,aAAa,MAAA,UACb,yCACD;EAYD,MAAM,cAAc,MAAA,yBAA+B,IAAI,IAAI;AAC3D,MAAI,CAAC,aAAa;AAChB,SAAA,GAAS,QACP,sFACD;AACD;;EAGF,MAAM,QAAQ,MAAA,qBAA2B,IAAI,YAAY;AACzD,SACE,SAAS,MAAM,eAAe,KAC9B,kDAAkD,IAAI,oBAAoB,cAC3E;AAED,MAAI,MAAM,UAAU,oBAAoB;AACtC,SAAA,eAAqB,aAAa,OAAO,YAAY;AACrD;;AAGF,QAAA,eACE,aACA,OACA,MAAM,UAAU,QACZ,IAAI,iBACF,MAAM,WAAW,8BAA8B,MAAM,SACrD,MAAM,UAAU,EAAC,SAAS,MAAM,SAAQ,GAAG,KAAA,EAC5C,GACD,IAAI,cAAc;GAChB,MAAM;GACN,QAAQ;GACR,QAAQ;GACR,SACE,MAAM,UAAU,gBACZ,6CACA,2CAA2C,IAAI,IAAI,MAAM;GAC/D,SAAS,gBAAgB,MAAM;GAChC,CAAC,CACP;AAGD,MAAI,MAAM,UAAU,cAClB,OAAA,aACE,IAAI,cAAc;GAChB,MAAM;GACN,QAAQ;GACR,QAAQ;GACR,SAAS;GACT,SAAS,MAAM;GAChB,CAAC,CACH;;CAIL,mBAAmB,UAAkB,KAAa,QAA0B;AAC1E,SACE,aAAa,MAAA,UACb,yCACD;EAKD,MAAM,cAAc,MAAA,yBAA+B,IAAI,IAAI;AAC3D,MAAI,CAAC,aAAa;AAChB,SAAA,GAAS,QACP,uFACD;AACD;;EAGF,MAAM,QAAQ,MAAA,qBAA2B,IAAI,YAAY;AACzD,SACE,SAAS,MAAM,eAAe,KAC9B,kDAAkD,IAAI,oBAAoB,cAC3E;AACD,QAAA,eAAqB,aAAa,OAAO,OAAO;;CAGlD,gBACE,aACA,OAIA,QACM;AACN,MAAI,mBAAmB,OAAO,IAAI,YAAY,OAAO,CAGnD,OAAM,SAAS,OAAO,OAAO;MAE7B,OAAM,SAAS,QAAQ,qBAAqB;AAG9C,QAAA,qBAA2B,OAAO,YAAY;AAC9C,MAAI,MAAM,WACR,OAAA,yBAA+B,OAAO,MAAM,WAAW;;;;;;;;;;;;CAc3D,sBAAsB,UAA4B;AAChD,QAAA,6BAAmC,IAAI,SAAS;;CAGlD,sCAAsC;AACpC,OAAK,MAAM,YAAY,MAAA,6BACrB,WAAU"}

package/out/zero-client/src/client/mutator-proxy.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"mutator-proxy.js","names":["#lc","#connectionManager","#mutationTracker","#onConnectionStateChange","#mutationRejection","#makeZeroErrorResultDetails","#makeApplicationErrorResultDetails","#normalizeResultPromise"],"sources":["../../../../../zero-client/src/client/mutator-proxy.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport {unreachable} from '../../../shared/src/asserts.ts';\nimport type {ReadonlyJSONValue} from '../../../shared/src/json.ts';\nimport type {ApplicationError} from '../../../zero-protocol/src/application-error.ts';\nimport {wrapWithApplicationError} from '../../../zero-protocol/src/application-error.ts';\nimport {ClientErrorKind} from './client-error-kind.ts';\nimport type {\n ConnectionManager,\n ConnectionManagerState,\n} from './connection-manager.ts';\nimport {ConnectionStatus} from './connection-status.ts';\nimport type {\n MutatorResult,\n MutatorResultErrorDetails,\n MutatorResultSuccessDetails,\n} from './custom.ts';\nimport {isZeroError, type ZeroError} from './error.ts';\nimport type {MutationTracker} from './mutation-tracker.ts';\n\nconst successResultDetails = {\n type: 'success',\n} as const satisfies MutatorResultSuccessDetails;\nconst successResult = () => successResultDetails;\n\nfunction getStateDescription(error: ZeroError): string {\n switch (error.kind) {\n case ClientErrorKind.Offline:\n return 'offline';\n case ClientErrorKind.ClientClosed:\n return 'closed';\n default:\n return 'in error state';\n }\n}\n\ntype CachedMutationRejection = {\n readonly error: ZeroError;\n readonly promise: Promise<MutatorResultErrorDetails>;\n};\n\nexport class MutatorProxy {\n readonly #lc: LogContext;\n readonly #connectionManager: ConnectionManager;\n readonly #mutationTracker: MutationTracker;\n #mutationRejection: CachedMutationRejection \| undefined;\n\n constructor(\n lc: LogContext,\n connectionManager: ConnectionManager,\n mutationTracker: MutationTracker,\n ) {\n this.#lc = lc;\n this.#connectionManager = connectionManager;\n this.#mutationTracker = mutationTracker;\n\n this.#connectionManager.subscribe(state =>\n this.#onConnectionStateChange(state),\n );\n this.#onConnectionStateChange(connectionManager.state);\n }\n\n get mutationRejectionError(): ZeroError \| undefined {\n return this.#mutationRejection?.error;\n }\n\n /*\n Called when the connection state changes.\n \n If the connection state is disconnected, error, or closed, the\n * mutation rejection error is set and all outstanding `.server` promises in\n * the mutation tracker are rejected with the error.\n */\n #onConnectionStateChange(state: ConnectionManagerState) {\n // we short circuit the rejection if the error is due to a missing cacheURL\n // this allows local writes to continue\n if (\n state.name === ConnectionStatus.Disconnected &&\n state.reason.kind === ClientErrorKind.NoSocketOrigin\n ) {\n this.#mutationRejection = undefined;\n return;\n }\n\n switch (state.name) {\n case ConnectionStatus.Disconnected:\n case ConnectionStatus.Error:\n case ConnectionStatus.Closed:\n this.#mutationRejection = {\n error: state.reason,\n promise: Promise.resolve(\n this.#makeZeroErrorResultDetails(state.reason),\n ),\n };\n this.#mutationTracker.rejectAllOutstandingMutations(state.reason);\n break;\n case ConnectionStatus.Connected:\n case ConnectionStatus.Connecting:\n case ConnectionStatus.NeedsAuth:\n this.#mutationRejection = undefined;\n return;\n default:\n unreachable(state);\n }\n }\n\n wrapCustomMutator<\n F extends (...args: [] \| [ReadonlyJSONValue]) => {\n client: Promise<unknown>;\n server: Promise<unknown>;\n },\n >(name: string, f: F): (...args: Parameters<F>) => MutatorResult {\n return (...args) => {\n if (this.#mutationRejection) {\n const error = this.#mutationRejection.error;\n this.#lc.warn?.(\n `Mutation \"${name}\" rejected because Zero is ${getStateDescription(error)}. Details: ${error.message}. See also: https://zero.rocicorp.dev/docs/connection.`,\n );\n return {\n client: this.#mutationRejection.promise,\n server: this.#mutationRejection.promise,\n } as const satisfies MutatorResult;\n }\n\n let result: {\n client: Promise<unknown>;\n server: Promise<unknown>;\n };\n\n const cachedMutationPromises: Partial<\n Record<'client' \| 'server', Promise<MutatorResultErrorDetails>>\n > = {};\n\n const wrapErrorFor =\n (origin: 'client' \| 'server') =>\n (error: unknown): Promise<MutatorResultErrorDetails> => {\n const cachedPromise = cachedMutationPromises[origin];\n if (cachedPromise) {\n return cachedPromise;\n }\n\n if (isZeroError(error)) {\n this.#lc.error?.(`Mutator \"${name}\" error on ${origin}`, error);\n\n const zeroErrorPromise = this.#makeZeroErrorResultDetails(error);\n cachedMutationPromises[origin] = zeroErrorPromise;\n return zeroErrorPromise;\n }\n\n const applicationError = wrapWithApplicationError(error);\n this.#lc.error?.(\n `Mutator \"${name}\" app error on ${origin}`,\n applicationError,\n );\n\n const applicationErrorPromise =\n this.#makeApplicationErrorResultDetails(applicationError);\n cachedMutationPromises[origin] = applicationErrorPromise;\n return applicationErrorPromise;\n };\n\n try {\n result = f(...args);\n } catch (error) {\n const clientPromise = wrapErrorFor('client')(error);\n const serverPromise = wrapErrorFor('server')(error);\n\n return {\n client: clientPromise,\n server: serverPromise,\n } as const satisfies MutatorResult;\n }\n\n const client = this.#normalizeResultPromise(\n result.client,\n wrapErrorFor('client'),\n );\n const server = this.#normalizeResultPromise(\n result.server,\n wrapErrorFor('server'),\n );\n\n return {\n client,\n server,\n };\n };\n }\n\n #normalizeResultPromise(\n promise: Promise<unknown>,\n wrapError: (error: unknown) => Promise<MutatorResultErrorDetails>,\n ) {\n return promise.then<MutatorResultSuccessDetails, MutatorResultErrorDetails>(\n successResult,\n wrapError,\n );\n }\n\n #makeZeroErrorResultDetails(zeroError: ZeroError) {\n return Promise.resolve({\n type: 'error',\n error: {\n type: 'zero',\n message: zeroError.message,\n },\n } as const satisfies MutatorResultErrorDetails);\n }\n\n #makeApplicationErrorResultDetails(applicationError: ApplicationError) {\n return Promise.resolve({\n type: 'error',\n error: {\n type: 'app',\n message: applicationError.message,\n details: applicationError.details,\n },\n } as const satisfies MutatorResultErrorDetails);\n }\n}\n"],"mappings":";;;;;;AAmBA,IAAM,uBAAuB,EAC3B,MAAM,~~UACR~~;~~AACA~~,IAAM,sBAAsB;AAE5B,SAAS,oBAAoB,OAA0B;~~CACrD~~,~~QAAQ~~,MAAM,MAAd;EACE,KAAK,~~SACH~~,~~OAAO~~;EACT,KAAK,~~cACH~~,~~OAAO~~;EACT,~~SACE~~,~~OAAO;CACX;AACF;AAOA~~,IAAa,eAAb,MAA0B;CACxB;CACA;CACA;CACA;CAEA,YACE,IACA,mBACA,iBACA;~~EACA~~,~~KAAKA~~,~~MAAM~~;~~EACX~~,~~KAAKC~~,~~qBAAqB~~;~~EAC1B~~,~~KAAKC~~,~~mBAAmB~~;~~EAExB~~,~~KAAKD~~,~~mBAAmB~~,WAAU,UAChC,~~KAAKE~~,~~yBAAyB~~,~~KAAK~~,CACrC;~~EACA~~,~~KAAKA~~,~~yBAAyB~~,kBAAkB,~~KAAK;CACvD;CAEA~~,IAAI,yBAAgD;~~EAClD~~,~~OAAO~~,~~KAAKC~~,~~oBAAoB;CAClC;;;;;;;;CASA~~,yBAAyB,OAA+B;~~EAGtD~~,~~IACE~~,MAAM,SAAS,kBACf,MAAM,OAAO,SAAS,kBACtB;~~GACA~~,~~KAAKA~~,~~qBAAqB~~,KAAA;~~GAC1B;EACF;EAEA~~,~~QAAQ~~,MAAM,MAAd;GACE,KAAK;GACL,KAAK;GACL,KAAK;~~IACH~~,~~KAAKA~~,~~qBAAqB~~;KACxB,OAAO,MAAM;KACb,SAAS,QAAQ,QACf,~~KAAKC~~,~~4BAA4B~~,MAAM,~~MAAM~~,CAC/C;~~IACF~~;~~IACA~~,~~KAAKH~~,~~iBAAiB~~,8BAA8B,MAAM,~~MAAM~~;~~IAChE~~;GACF,KAAK;GACL,KAAK;GACL,KAAK;~~IACH~~,~~KAAKE~~,~~qBAAqB~~,KAAA;~~IAC1B~~;GACF,~~SACE~~,~~YAAY~~,~~KAAK;EACrB;CACF;CAEA~~,kBAKE,MAAc,GAAiD;~~EAC~~/D,~~QAAQ~~,GAAG,SAAS;~~GAClB~~,~~IAAI~~,~~KAAKA~~,~~oBAAoB~~;IAC3B,MAAM,QAAQ,~~KAAKA~~,~~mBAAmB~~;~~IACtC~~,~~KAAKJ~~,~~IAAI~~,OACP,aAAa,KAAK,6BAA6B,oBAAoB,~~KAAK~~,~~EAAE~~,aAAa,MAAM,QAAQ,~~uDACvG~~;~~IACA~~,~~OAAO~~;KACL,QAAQ,~~KAAKI~~,~~mBAAmB~~;KAChC,QAAQ,~~KAAKA~~,~~mBAAmB~~;~~IAClC;GACF;GAEA~~,IAAI;GAKJ,MAAM,yBAEF,~~CAAC~~;~~GAEL~~,MAAM,gBACH,YACA,UAAuD;IACtD,MAAM,gBAAgB,uBAAuB;~~IAC7C~~,~~IAAI~~,~~eACF~~,~~OAAO~~;~~IAGT~~,~~IAAI~~,YAAY,~~KAAK~~,~~GAAG~~;~~KACtB~~,~~KAAKJ~~,~~IAAI~~,QAAQ,YAAY,KAAK,aAAa,UAAU,~~KAAK~~;~~KAE9D~~,MAAM,mBAAmB,~~KAAKK~~,~~4BAA4B~~,~~KAAK~~;~~KAC/D~~,~~uBAAuB~~,UAAU;~~KACjC~~,~~OAAO;IACT;IAEA~~,MAAM,mBAAmB,yBAAyB,~~KAAK~~;~~IACvD~~,~~KAAKL~~,~~IAAI~~,QACP,YAAY,KAAK,iBAAiB,UAClC,~~gBACF~~;~~IAEA~~,MAAM,0BACJ,~~KAAKM~~,~~mCAAmC~~,~~gBAAgB~~;~~IAC1D~~,~~uBAAuB~~,UAAU;~~IACjC~~,~~OAAO;GACT;GAEF~~,~~IAAI~~;~~IACF~~,~~SAAS~~,EAAE,GAAG,~~IAAI~~;~~GACpB~~,~~SAAS,~~OAAO;~~IAId~~,~~OAAO~~;KACL,QAJoB,aAAa,~~QAAQ~~,~~EAAE~~,~~KAInC~~;~~KACR~~,QAJoB,aAAa,~~QAAQ~~,~~EAAE~~,~~KAInC~~;~~IACV;GACF;GAWA~~,~~OAAO~~;IACL,QAVa,~~KAAKC~~,~~wBAClB~~,OAAO,QACP,aAAa,~~QAAQ~~,~~CAQrB~~;~~IACA~~,QAPa,~~KAAKA~~,~~wBAClB~~,OAAO,QACP,aAAa,~~QAAQ~~,~~CAKrB~~;~~GACF;EACF;CACF;CAEA~~,wBACE,SACA,WACA;~~EACA~~,~~OAAO~~,QAAQ,KACb,eACA,~~SACF;CACF;CAEA~~,4BAA4B,WAAsB;~~EAChD~~,~~OAAO~~,QAAQ,QAAQ;GACrB,MAAM;GACN,OAAO;IACL,MAAM;IACN,SAAS,UAAU;~~GACrB~~;~~EACF~~,CAA8C~~;CAChD;CAEA~~,mCAAmC,kBAAoC;~~EACrE~~,~~OAAO~~,QAAQ,QAAQ;GACrB,MAAM;GACN,OAAO;IACL,MAAM;IACN,SAAS,iBAAiB;IAC1B,SAAS,iBAAiB;~~GAC5B~~;~~EACF~~,CAA8C~~;CAChD;AACF~~"}
1	+ {"version":3,"file":"mutator-proxy.js","names":["#lc","#connectionManager","#mutationTracker","#onConnectionStateChange","#mutationRejection","#makeZeroErrorResultDetails","#makeApplicationErrorResultDetails","#normalizeResultPromise"],"sources":["../../../../../zero-client/src/client/mutator-proxy.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport {unreachable} from '../../../shared/src/asserts.ts';\nimport type {ReadonlyJSONValue} from '../../../shared/src/json.ts';\nimport type {ApplicationError} from '../../../zero-protocol/src/application-error.ts';\nimport {wrapWithApplicationError} from '../../../zero-protocol/src/application-error.ts';\nimport {ClientErrorKind} from './client-error-kind.ts';\nimport type {\n ConnectionManager,\n ConnectionManagerState,\n} from './connection-manager.ts';\nimport {ConnectionStatus} from './connection-status.ts';\nimport type {\n MutatorResult,\n MutatorResultErrorDetails,\n MutatorResultSuccessDetails,\n} from './custom.ts';\nimport {isZeroError, type ZeroError} from './error.ts';\nimport type {MutationTracker} from './mutation-tracker.ts';\n\nconst successResultDetails = {\n type: 'success',\n} as const satisfies MutatorResultSuccessDetails;\nconst successResult = () => successResultDetails;\n\nfunction getStateDescription(error: ZeroError): string {\n switch (error.kind) {\n case ClientErrorKind.Offline:\n return 'offline';\n case ClientErrorKind.ClientClosed:\n return 'closed';\n default:\n return 'in error state';\n }\n}\n\ntype CachedMutationRejection = {\n readonly error: ZeroError;\n readonly promise: Promise<MutatorResultErrorDetails>;\n};\n\nexport class MutatorProxy {\n readonly #lc: LogContext;\n readonly #connectionManager: ConnectionManager;\n readonly #mutationTracker: MutationTracker;\n #mutationRejection: CachedMutationRejection \| undefined;\n\n constructor(\n lc: LogContext,\n connectionManager: ConnectionManager,\n mutationTracker: MutationTracker,\n ) {\n this.#lc = lc;\n this.#connectionManager = connectionManager;\n this.#mutationTracker = mutationTracker;\n\n this.#connectionManager.subscribe(state =>\n this.#onConnectionStateChange(state),\n );\n this.#onConnectionStateChange(connectionManager.state);\n }\n\n get mutationRejectionError(): ZeroError \| undefined {\n return this.#mutationRejection?.error;\n }\n\n /*\n Called when the connection state changes.\n \n If the connection state is disconnected, error, or closed, the\n * mutation rejection error is set and all outstanding `.server` promises in\n * the mutation tracker are rejected with the error.\n */\n #onConnectionStateChange(state: ConnectionManagerState) {\n // we short circuit the rejection if the error is due to a missing cacheURL\n // this allows local writes to continue\n if (\n state.name === ConnectionStatus.Disconnected &&\n state.reason.kind === ClientErrorKind.NoSocketOrigin\n ) {\n this.#mutationRejection = undefined;\n return;\n }\n\n switch (state.name) {\n case ConnectionStatus.Disconnected:\n case ConnectionStatus.Error:\n case ConnectionStatus.Closed:\n this.#mutationRejection = {\n error: state.reason,\n promise: Promise.resolve(\n this.#makeZeroErrorResultDetails(state.reason),\n ),\n };\n this.#mutationTracker.rejectAllOutstandingMutations(state.reason);\n break;\n case ConnectionStatus.Connected:\n case ConnectionStatus.Connecting:\n case ConnectionStatus.NeedsAuth:\n this.#mutationRejection = undefined;\n return;\n default:\n unreachable(state);\n }\n }\n\n wrapCustomMutator<\n F extends (...args: [] \| [ReadonlyJSONValue]) => {\n client: Promise<unknown>;\n server: Promise<unknown>;\n },\n >(name: string, f: F): (...args: Parameters<F>) => MutatorResult {\n return (...args) => {\n if (this.#mutationRejection) {\n const error = this.#mutationRejection.error;\n this.#lc.warn?.(\n `Mutation \"${name}\" rejected because Zero is ${getStateDescription(error)}. Details: ${error.message}. See also: https://zero.rocicorp.dev/docs/connection.`,\n );\n return {\n client: this.#mutationRejection.promise,\n server: this.#mutationRejection.promise,\n } as const satisfies MutatorResult;\n }\n\n let result: {\n client: Promise<unknown>;\n server: Promise<unknown>;\n };\n\n const cachedMutationPromises: Partial<\n Record<'client' \| 'server', Promise<MutatorResultErrorDetails>>\n > = {};\n\n const wrapErrorFor =\n (origin: 'client' \| 'server') =>\n (error: unknown): Promise<MutatorResultErrorDetails> => {\n const cachedPromise = cachedMutationPromises[origin];\n if (cachedPromise) {\n return cachedPromise;\n }\n\n if (isZeroError(error)) {\n this.#lc.error?.(`Mutator \"${name}\" error on ${origin}`, error);\n\n const zeroErrorPromise = this.#makeZeroErrorResultDetails(error);\n cachedMutationPromises[origin] = zeroErrorPromise;\n return zeroErrorPromise;\n }\n\n const applicationError = wrapWithApplicationError(error);\n this.#lc.error?.(\n `Mutator \"${name}\" app error on ${origin}`,\n applicationError,\n );\n\n const applicationErrorPromise =\n this.#makeApplicationErrorResultDetails(applicationError);\n cachedMutationPromises[origin] = applicationErrorPromise;\n return applicationErrorPromise;\n };\n\n try {\n result = f(...args);\n } catch (error) {\n const clientPromise = wrapErrorFor('client')(error);\n const serverPromise = wrapErrorFor('server')(error);\n\n return {\n client: clientPromise,\n server: serverPromise,\n } as const satisfies MutatorResult;\n }\n\n const client = this.#normalizeResultPromise(\n result.client,\n wrapErrorFor('client'),\n );\n const server = this.#normalizeResultPromise(\n result.server,\n wrapErrorFor('server'),\n );\n\n return {\n client,\n server,\n };\n };\n }\n\n #normalizeResultPromise(\n promise: Promise<unknown>,\n wrapError: (error: unknown) => Promise<MutatorResultErrorDetails>,\n ) {\n return promise.then<MutatorResultSuccessDetails, MutatorResultErrorDetails>(\n successResult,\n wrapError,\n );\n }\n\n #makeZeroErrorResultDetails(zeroError: ZeroError) {\n return Promise.resolve({\n type: 'error',\n error: {\n type: 'zero',\n message: zeroError.message,\n },\n } as const satisfies MutatorResultErrorDetails);\n }\n\n #makeApplicationErrorResultDetails(applicationError: ApplicationError) {\n return Promise.resolve({\n type: 'error',\n error: {\n type: 'app',\n message: applicationError.message,\n details: applicationError.details,\n },\n } as const satisfies MutatorResultErrorDetails);\n }\n}\n"],"mappings":";;;;;;AAmBA,IAAM,uBAAuB,EAC3B,MAAM,WACP;AACD,IAAM,sBAAsB;AAE5B,SAAS,oBAAoB,OAA0B;AACrD,SAAQ,MAAM,MAAd;EACE,KAAK,QACH,QAAO;EACT,KAAK,aACH,QAAO;EACT,QACE,QAAO;;;AASb,IAAa,eAAb,MAA0B;CACxB;CACA;CACA;CACA;CAEA,YACE,IACA,mBACA,iBACA;AACA,QAAA,KAAW;AACX,QAAA,oBAA0B;AAC1B,QAAA,kBAAwB;AAExB,QAAA,kBAAwB,WAAU,UAChC,MAAA,wBAA8B,MAAM,CACrC;AACD,QAAA,wBAA8B,kBAAkB,MAAM;;CAGxD,IAAI,yBAAgD;AAClD,SAAO,MAAA,mBAAyB;;;;;;;;;CAUlC,yBAAyB,OAA+B;AAGtD,MACE,MAAM,SAAS,kBACf,MAAM,OAAO,SAAS,kBACtB;AACA,SAAA,oBAA0B,KAAA;AAC1B;;AAGF,UAAQ,MAAM,MAAd;GACE,KAAK;GACL,KAAK;GACL,KAAK;AACH,UAAA,oBAA0B;KACxB,OAAO,MAAM;KACb,SAAS,QAAQ,QACf,MAAA,2BAAiC,MAAM,OAAO,CAC/C;KACF;AACD,UAAA,gBAAsB,8BAA8B,MAAM,OAAO;AACjE;GACF,KAAK;GACL,KAAK;GACL,KAAK;AACH,UAAA,oBAA0B,KAAA;AAC1B;GACF,QACE,aAAY,MAAM;;;CAIxB,kBAKE,MAAc,GAAiD;AAC/D,UAAQ,GAAG,SAAS;AAClB,OAAI,MAAA,mBAAyB;IAC3B,MAAM,QAAQ,MAAA,kBAAwB;AACtC,UAAA,GAAS,OACP,aAAa,KAAK,6BAA6B,oBAAoB,MAAM,CAAC,aAAa,MAAM,QAAQ,wDACtG;AACD,WAAO;KACL,QAAQ,MAAA,kBAAwB;KAChC,QAAQ,MAAA,kBAAwB;KACjC;;GAGH,IAAI;GAKJ,MAAM,yBAEF,EAAE;GAEN,MAAM,gBACH,YACA,UAAuD;IACtD,MAAM,gBAAgB,uBAAuB;AAC7C,QAAI,cACF,QAAO;AAGT,QAAI,YAAY,MAAM,EAAE;AACtB,WAAA,GAAS,QAAQ,YAAY,KAAK,aAAa,UAAU,MAAM;KAE/D,MAAM,mBAAmB,MAAA,2BAAiC,MAAM;AAChE,4BAAuB,UAAU;AACjC,YAAO;;IAGT,MAAM,mBAAmB,yBAAyB,MAAM;AACxD,UAAA,GAAS,QACP,YAAY,KAAK,iBAAiB,UAClC,iBACD;IAED,MAAM,0BACJ,MAAA,kCAAwC,iBAAiB;AAC3D,2BAAuB,UAAU;AACjC,WAAO;;AAGX,OAAI;AACF,aAAS,EAAE,GAAG,KAAK;YACZ,OAAO;AAId,WAAO;KACL,QAJoB,aAAa,SAAS,CAAC,MAAM;KAKjD,QAJoB,aAAa,SAAS,CAAC,MAAM;KAKlD;;AAYH,UAAO;IACL,QAVa,MAAA,uBACb,OAAO,QACP,aAAa,SAAS,CACvB;IAQC,QAPa,MAAA,uBACb,OAAO,QACP,aAAa,SAAS,CACvB;IAKA;;;CAIL,wBACE,SACA,WACA;AACA,SAAO,QAAQ,KACb,eACA,UACD;;CAGH,4BAA4B,WAAsB;AAChD,SAAO,QAAQ,QAAQ;GACrB,MAAM;GACN,OAAO;IACL,MAAM;IACN,SAAS,UAAU;IACpB;GACF,CAA8C;;CAGjD,mCAAmC,kBAAoC;AACrE,SAAO,QAAQ,QAAQ;GACrB,MAAM;GACN,OAAO;IACL,MAAM;IACN,SAAS,iBAAiB;IAC1B,SAAS,iBAAiB;IAC3B;GACF,CAA8C"}