@rocicorp/zero 0.25.0 → 0.26.0-canary.0

package/out/zero-protocol/src/analyze-query-result.d.ts

@@ -7,6 +7,143 @@ export declare const rowsByQuerySchema: v.Type<Record<string, Readonly<Record<st
 export type RowsByQuery = v.Infer<typeof rowsByQuerySchema>;
 export declare const rowsBySourceSchema: v.Type<Record<string, Record<string, Readonly<Record<string, import("../../shared/src/json.ts").ReadonlyJSONValue | undefined>>[]>>>;
 export type RowsBySource = v.Infer<typeof rowsBySourceSchema>;
+declare const attemptStartEventJSONSchema: v.ObjectType<{
+    type: v.Type<"attempt-start">;
+    attemptNumber: v.Type<number>;
+    totalAttempts: v.Type<number>;
+}, undefined>;
+declare const connectionSelectedEventJSONSchema: v.ObjectType<{
+    type: v.Type<"connection-selected">;
+    attemptNumber: v.Type<number>;
+    connection: v.Type<string>;
+    cost: v.Type<number>;
+    isRoot: v.Type<boolean>;
+}, undefined>;
+declare const planFailedEventJSONSchema: v.ObjectType<{
+    type: v.Type<"plan-failed">;
+    attemptNumber: v.Type<number>;
+    reason: v.Type<string>;
+}, undefined>;
+declare const bestPlanSelectedEventJSONSchema: v.ObjectType<{
+    type: v.Type<"best-plan-selected">;
+    bestAttemptNumber: v.Type<number>;
+    totalCost: v.Type<number>;
+    flipPattern: v.Type<number>;
+    joinStates: v.ArrayType<v.ObjectType<{
+        join: v.Type<string>;
+        type: v.UnionType<[v.Type<"semi">, v.Type<"flipped">, v.Type<"unflippable">]>;
+    }, undefined>>;
+}, undefined>;
+declare const nodeConstraintEventJSONSchema: v.ObjectType<{
+    type: v.Type<"node-constraint">;
+    attemptNumber: v.Optional<number>;
+    nodeType: v.UnionType<[v.Type<"connection">, v.Type<"join">, v.Type<"fan-out">, v.Type<"fan-in">, v.Type<"terminus">]>;
+    node: v.Type<string>;
+    branchPattern: v.ArrayType<v.Type<number>>;
+    constraint: v.Optional<Record<string, unknown> | null>;
+    from: v.Type<string>;
+}, undefined>;
+declare const planDebugEventJSONSchema: v.UnionType<[v.ObjectType<{
+    type: v.Type<"attempt-start">;
+    attemptNumber: v.Type<number>;
+    totalAttempts: v.Type<number>;
+}, undefined>, v.ObjectType<{
+    type: v.Type<"connection-costs">;
+    attemptNumber: v.Type<number>;
+    costs: v.ArrayType<v.ObjectType<{
+        connection: v.Type<string>;
+        cost: v.Type<number>;
+        costEstimate: v.ObjectType<{
+            startupCost: v.Type<number>;
+            scanEst: v.Type<number>;
+            cost: v.Type<number>;
+            returnedRows: v.Type<number>;
+            selectivity: v.Type<number>;
+            limit: v.Optional<number>;
+        }, undefined>;
+        pinned: v.Type<boolean>;
+        constraints: v.Type<Record<string, Record<string, unknown> | null>>;
+        constraintCosts: v.Type<Record<string, {
+            limit?: number | undefined;
+            startupCost: number;
+            scanEst: number;
+            cost: number;
+            returnedRows: number;
+            selectivity: number;
+        }>>;
+    }, undefined>>;
+}, undefined>, v.ObjectType<{
+    type: v.Type<"connection-selected">;
+    attemptNumber: v.Type<number>;
+    connection: v.Type<string>;
+    cost: v.Type<number>;
+    isRoot: v.Type<boolean>;
+}, undefined>, v.ObjectType<{
+    type: v.Type<"constraints-propagated">;
+    attemptNumber: v.Type<number>;
+    connectionConstraints: v.ArrayType<v.ObjectType<{
+        connection: v.Type<string>;
+        constraints: v.Type<Record<string, Record<string, unknown> | null>>;
+        constraintCosts: v.Type<Record<string, {
+            limit?: number | undefined;
+            startupCost: number;
+            scanEst: number;
+            cost: number;
+            returnedRows: number;
+            selectivity: number;
+        }>>;
+    }, undefined>>;
+}, undefined>, v.ObjectType<{
+    type: v.Type<"plan-complete">;
+    attemptNumber: v.Type<number>;
+    totalCost: v.Type<number>;
+    flipPattern: v.Type<number>;
+    joinStates: v.ArrayType<v.ObjectType<{
+        join: v.Type<string>;
+        type: v.UnionType<[v.Type<"semi">, v.Type<"flipped">, v.Type<"unflippable">]>;
+    }, undefined>>;
+}, undefined>, v.ObjectType<{
+    type: v.Type<"plan-failed">;
+    attemptNumber: v.Type<number>;
+    reason: v.Type<string>;
+}, undefined>, v.ObjectType<{
+    type: v.Type<"best-plan-selected">;
+    bestAttemptNumber: v.Type<number>;
+    totalCost: v.Type<number>;
+    flipPattern: v.Type<number>;
+    joinStates: v.ArrayType<v.ObjectType<{
+        join: v.Type<string>;
+        type: v.UnionType<[v.Type<"semi">, v.Type<"flipped">, v.Type<"unflippable">]>;
+    }, undefined>>;
+}, undefined>, v.ObjectType<{
+    type: v.Type<"node-cost">;
+    attemptNumber: v.Optional<number>;
+    nodeType: v.UnionType<[v.Type<"connection">, v.Type<"join">, v.Type<"fan-out">, v.Type<"fan-in">, v.Type<"terminus">]>;
+    node: v.Type<string>;
+    branchPattern: v.ArrayType<v.Type<number>>;
+    downstreamChildSelectivity: v.Type<number>;
+    costEstimate: v.ObjectType<{
+        startupCost: v.Type<number>;
+        scanEst: v.Type<number>;
+        cost: v.Type<number>;
+        returnedRows: v.Type<number>;
+        selectivity: v.Type<number>;
+        limit: v.Optional<number>;
+    }, undefined>;
+    filters: v.Optional<import("./ast.ts").Condition>;
+    ordering: v.Optional<readonly (readonly [string, "desc" | "asc"])[]>;
+    joinType: v.Optional<"semi" | "flipped" | "unflippable">;
+}, undefined>, v.ObjectType<{
+    type: v.Type<"node-constraint">;
+    attemptNumber: v.Optional<number>;
+    nodeType: v.UnionType<[v.Type<"connection">, v.Type<"join">, v.Type<"fan-out">, v.Type<"fan-in">, v.Type<"terminus">]>;
+    node: v.Type<string>;
+    branchPattern: v.ArrayType<v.Type<number>>;
+    constraint: v.Optional<Record<string, unknown> | null>;
+    from: v.Type<string>;
+}, undefined>]>;
+export type PlanDebugEventJSON = v.Infer<typeof planDebugEventJSONSchema>;
+export { attemptStartEventJSONSchema, connectionSelectedEventJSONSchema, planFailedEventJSONSchema, bestPlanSelectedEventJSONSchema, nodeConstraintEventJSONSchema, };
 export declare const analyzeQueryResultSchema: v.ObjectType<{
     warnings: v.ArrayType<v.Type<string>>;
     syncedRows: v.Optional<Record<string, Readonly<Record<string, import("../../shared/src/json.ts").ReadonlyJSONValue | undefined>>[]>>;
@@ -20,10 +157,110 @@ export declare const analyzeQueryResultSchema: v.ObjectType<{
     vendedRowCounts: v.Optional<Record<string, Record<string, number>>>;
     /** @deprecated Use readRows */
     vendedRows: v.Optional<Record<string, Record<string, Readonly<Record<string, import("../../shared/src/json.ts").ReadonlyJSONValue | undefined>>[]>>>;
-    plans: v.Optional<Record<string, string[]>>;
+    sqlitePlans: v.Optional<Record<string, string[]>>;
     readRows: v.Optional<Record<string, Record<string, Readonly<Record<string, import("../../shared/src/json.ts").ReadonlyJSONValue | undefined>>[]>>>;
     readRowCountsByQuery: v.Optional<Record<string, Record<string, number>>>;
     readRowCount: v.Optional<number>;
+    dbScansByQuery: v.Optional<Record<string, Record<string, number>>>;
+    joinPlans: v.Optional<({
+        type: "attempt-start";
+        attemptNumber: number;
+        totalAttempts: number;
+    } | {
+        type: "connection-costs";
+        attemptNumber: number;
+        costs: {
+            connection: string;
+            cost: number;
+            costEstimate: {
+                limit?: number | undefined;
+                startupCost: number;
+                scanEst: number;
+                cost: number;
+                returnedRows: number;
+                selectivity: number;
+            };
+            pinned: boolean;
+            constraints: Record<string, Record<string, unknown> | null>;
+            constraintCosts: Record<string, {
+                limit?: number | undefined;
+                startupCost: number;
+                scanEst: number;
+                cost: number;
+                returnedRows: number;
+                selectivity: number;
+            }>;
+        }[];
+    } | {
+        type: "connection-selected";
+        attemptNumber: number;
+        connection: string;
+        cost: number;
+        isRoot: boolean;
+    } | {
+        type: "constraints-propagated";
+        attemptNumber: number;
+        connectionConstraints: {
+            connection: string;
+            constraints: Record<string, Record<string, unknown> | null>;
+            constraintCosts: Record<string, {
+                limit?: number | undefined;
+                startupCost: number;
+                scanEst: number;
+                cost: number;
+                returnedRows: number;
+                selectivity: number;
+            }>;
+        }[];
+    } | {
+        type: "plan-complete";
+        attemptNumber: number;
+        totalCost: number;
+        flipPattern: number;
+        joinStates: {
+            join: string;
+            type: "semi" | "flipped" | "unflippable";
+        }[];
+    } | {
+        type: "plan-failed";
+        attemptNumber: number;
+        reason: string;
+    } | {
+        type: "best-plan-selected";
+        bestAttemptNumber: number;
+        totalCost: number;
+        flipPattern: number;
+        joinStates: {
+            join: string;
+            type: "semi" | "flipped" | "unflippable";
+        }[];
+    } | {
+        attemptNumber?: number | undefined;
+        filters?: import("./ast.ts").Condition | undefined;
+        ordering?: readonly (readonly [string, "desc" | "asc"])[] | undefined;
+        joinType?: "semi" | "flipped" | "unflippable" | undefined;
+        type: "node-cost";
+        nodeType: "join" | "connection" | "fan-out" | "fan-in" | "terminus";
+        node: string;
+        branchPattern: number[];
+        downstreamChildSelectivity: number;
+        costEstimate: {
+            limit?: number | undefined;
+            startupCost: number;
+            scanEst: number;
+            cost: number;
+            returnedRows: number;
+            selectivity: number;
+        };
+    } | {
+        attemptNumber?: number | undefined;
+        constraint?: Record<string, unknown> | null | undefined;
+        type: "node-constraint";
+        nodeType: "join" | "connection" | "fan-out" | "fan-in" | "terminus";
+        node: string;
+        branchPattern: number[];
+        from: string;
+    })[]>;
 }, undefined>;
 export type AnalyzeQueryResult = v.Infer<typeof analyzeQueryResultSchema>;
 //# sourceMappingURL=analyze-query-result.d.ts.map

package/out/zero-protocol/src/analyze-query-result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-query-result.d.ts","sourceRoot":"","sources":["../../../../zero-protocol/src/analyze-query-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,4BAA4B,CAAC;AAIhD,eAAO,MAAM,sBAAsB,gCAAuB,CAAC;AAC3D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,uBAAuB,gDAAmC,CAAC;AACxE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,iBAAiB,sHAA+B,CAAC;AAC9D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,kBAAkB,sIAA8B,CAAC;AAC9D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,wBAAwB;;;;;IAKnC,8CAA8C;;;;IAI9C,2CAA2C;;IAE3C,+BAA+B;;;;;;aAM/B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}
+{"version":3,"file":"analyze-query-result.d.ts","sourceRoot":"","sources":["../../../../zero-protocol/src/analyze-query-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,4BAA4B,CAAC;AAKhD,eAAO,MAAM,sBAAsB,gCAAuB,CAAC;AAC3D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,uBAAuB,gDAAmC,CAAC;AACxE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,iBAAiB,sHAA+B,CAAC;AAC9D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,kBAAkB,sIAA8B,CAAC;AAC9D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAe9D,QAAA,MAAM,2BAA2B;;;;aAI/B,CAAC;AAiBH,QAAA,MAAM,iCAAiC;;;;;;aAMrC,CAAC;AAiCH,QAAA,MAAM,yBAAyB;;;;aAI7B,CAAC;AAEH,QAAA,MAAM,+BAA+B;;;;;;;;;aAWnC,CAAC;AAuBH,QAAA,MAAM,6BAA6B;;;;;;;;aAQjC,CAAC;AAEH,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAU7B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,OAAO,EACL,2BAA2B,EAC3B,iCAAiC,EACjC,yBAAyB,EACzB,+BAA+B,EAC/B,6BAA6B,GAC9B,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;IAKnC,8CAA8C;;;;IAI9C,2CAA2C;;IAE3C,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAQ/B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/out/zero-protocol/src/analyze-query-result.js

@@ -1,25 +1,160 @@
-import * as v from "../../shared/src/valita.js";
+import "../../shared/src/valita.js";
+import { orderingSchema, conditionSchema } from "./ast.js";
 import { rowSchema } from "./data.js";
-export const rowCountsByQuerySchema = v.record(v.number());
-export const rowCountsBySourceSchema = v.record(rowCountsByQuerySchema);
-export const rowsByQuerySchema = v.record(v.array(rowSchema));
-export const rowsBySourceSchema = v.record(rowsByQuerySchema);
-export const analyzeQueryResultSchema = v.object({
-    warnings: v.array(v.string()),
-    syncedRows: v.record(v.array(rowSchema)).optional(),
-    syncedRowCount: v.number(),
-    start: v.number(),
-    /** @deprecated Use start + elapsed instead */
-    end: v.number(),
-    elapsed: v.number().optional(),
-    afterPermissions: v.string().optional(),
-    /** @deprecated Use readRowCountsByQuery */
-    vendedRowCounts: rowCountsBySourceSchema.optional(),
-    /** @deprecated Use readRows */
-    vendedRows: rowsBySourceSchema.optional(),
-    plans: v.record(v.array(v.string())).optional(),
-    readRows: rowsBySourceSchema.optional(),
-    readRowCountsByQuery: rowCountsBySourceSchema.optional(),
-    readRowCount: v.number().optional(),
-});
-//# sourceMappingURL=analyze-query-result.js.map
+import { record, number, array, object, union, unknown, null as _null, literal, boolean, string } from "@badrap/valita";
+const rowCountsByQuerySchema = record(number());
+const rowCountsBySourceSchema = record(rowCountsByQuerySchema);
+const rowsByQuerySchema = record(array(rowSchema));
+const rowsBySourceSchema = record(rowsByQuerySchema);
+const costEstimateJSONSchema = object({
+  startupCost: number(),
+  scanEst: number(),
+  cost: number(),
+  returnedRows: number(),
+  selectivity: number(),
+  limit: number().optional()
+});
+const plannerConstraintSchema = record(union(unknown(), _null()));
+const attemptStartEventJSONSchema = object({
+  type: literal("attempt-start"),
+  attemptNumber: number(),
+  totalAttempts: number()
+});
+const connectionCostsEventJSONSchema = object({
+  type: literal("connection-costs"),
+  attemptNumber: number(),
+  costs: array(
+    object({
+      connection: string(),
+      cost: number(),
+      costEstimate: costEstimateJSONSchema,
+      pinned: boolean(),
+      constraints: record(union(plannerConstraintSchema, _null())),
+      constraintCosts: record(costEstimateJSONSchema)
+    })
+  )
+});
+const connectionSelectedEventJSONSchema = object({
+  type: literal("connection-selected"),
+  attemptNumber: number(),
+  connection: string(),
+  cost: number(),
+  isRoot: boolean()
+});
+const constraintsPropagatedEventJSONSchema = object({
+  type: literal("constraints-propagated"),
+  attemptNumber: number(),
+  connectionConstraints: array(
+    object({
+      connection: string(),
+      constraints: record(union(plannerConstraintSchema, _null())),
+      constraintCosts: record(costEstimateJSONSchema)
+    })
+  )
+});
+const joinTypeSchema = union(
+  literal("semi"),
+  literal("flipped"),
+  literal("unflippable")
+);
+const planCompleteEventJSONSchema = object({
+  type: literal("plan-complete"),
+  attemptNumber: number(),
+  totalCost: number(),
+  flipPattern: number(),
+  joinStates: array(
+    object({
+      join: string(),
+      type: joinTypeSchema
+    })
+  )
+});
+const planFailedEventJSONSchema = object({
+  type: literal("plan-failed"),
+  attemptNumber: number(),
+  reason: string()
+});
+const bestPlanSelectedEventJSONSchema = object({
+  type: literal("best-plan-selected"),
+  bestAttemptNumber: number(),
+  totalCost: number(),
+  flipPattern: number(),
+  joinStates: array(
+    object({
+      join: string(),
+      type: joinTypeSchema
+    })
+  )
+});
+const nodeTypeSchema = union(
+  literal("connection"),
+  literal("join"),
+  literal("fan-out"),
+  literal("fan-in"),
+  literal("terminus")
+);
+const nodeCostEventJSONSchema = object({
+  type: literal("node-cost"),
+  attemptNumber: number().optional(),
+  nodeType: nodeTypeSchema,
+  node: string(),
+  branchPattern: array(number()),
+  downstreamChildSelectivity: number(),
+  costEstimate: costEstimateJSONSchema,
+  filters: conditionSchema.optional(),
+  ordering: orderingSchema.optional(),
+  joinType: joinTypeSchema.optional()
+});
+const nodeConstraintEventJSONSchema = object({
+  type: literal("node-constraint"),
+  attemptNumber: number().optional(),
+  nodeType: nodeTypeSchema,
+  node: string(),
+  branchPattern: array(number()),
+  constraint: union(plannerConstraintSchema, _null()).optional(),
+  from: string()
+});
+const planDebugEventJSONSchema = union(
+  attemptStartEventJSONSchema,
+  connectionCostsEventJSONSchema,
+  connectionSelectedEventJSONSchema,
+  constraintsPropagatedEventJSONSchema,
+  planCompleteEventJSONSchema,
+  planFailedEventJSONSchema,
+  bestPlanSelectedEventJSONSchema,
+  nodeCostEventJSONSchema,
+  nodeConstraintEventJSONSchema
+);
+const analyzeQueryResultSchema = object({
+  warnings: array(string()),
+  syncedRows: record(array(rowSchema)).optional(),
+  syncedRowCount: number(),
+  start: number(),
+  /** @deprecated Use start + elapsed instead */
+  end: number(),
+  elapsed: number().optional(),
+  afterPermissions: string().optional(),
+  /** @deprecated Use readRowCountsByQuery */
+  vendedRowCounts: rowCountsBySourceSchema.optional(),
+  /** @deprecated Use readRows */
+  vendedRows: rowsBySourceSchema.optional(),
+  sqlitePlans: record(array(string())).optional(),
+  readRows: rowsBySourceSchema.optional(),
+  readRowCountsByQuery: rowCountsBySourceSchema.optional(),
+  readRowCount: number().optional(),
+  dbScansByQuery: rowCountsBySourceSchema.optional(),
+  joinPlans: array(planDebugEventJSONSchema).optional()
+});
+export {
+  analyzeQueryResultSchema,
+  attemptStartEventJSONSchema,
+  bestPlanSelectedEventJSONSchema,
+  connectionSelectedEventJSONSchema,
+  nodeConstraintEventJSONSchema,
+  planFailedEventJSONSchema,
+  rowCountsByQuerySchema,
+  rowCountsBySourceSchema,
+  rowsByQuerySchema,
+  rowsBySourceSchema
+};
+//# sourceMappingURL=analyze-query-result.js.map

package/out/zero-protocol/src/analyze-query-result.js.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-query-result.js","sourceRoot":"","sources":["../../../../zero-protocol/src/analyze-query-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,4BAA4B,CAAC;AAEhD,OAAO,EAAC,SAAS,EAAC,MAAM,WAAW,CAAC;AAEpC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AAG3D,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAGxE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;AAG9D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAG9D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,8CAA8C;IAC9C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,2CAA2C;IAC3C,eAAe,EAAE,uBAAuB,CAAC,QAAQ,EAAE;IACnD,+BAA+B;IAC/B,UAAU,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC/C,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IACvC,oBAAoB,EAAE,uBAAuB,CAAC,QAAQ,EAAE;IACxD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC"}
+{"version":3,"file":"analyze-query-result.js","sources":["../../../../zero-protocol/src/analyze-query-result.ts"],"sourcesContent":["import * as v from '../../shared/src/valita.ts';\n\nimport {conditionSchema, orderingSchema} from './ast.ts';\nimport {rowSchema} from './data.ts';\n\nexport const rowCountsByQuerySchema = v.record(v.number());\nexport type RowCountsByQuery = v.Infer<typeof rowCountsByQuerySchema>;\n\nexport const rowCountsBySourceSchema = v.record(rowCountsByQuerySchema);\nexport type RowCountsBySource = v.Infer<typeof rowCountsBySourceSchema>;\n\nexport const rowsByQuerySchema = v.record(v.array(rowSchema));\nexport type RowsByQuery = v.Infer<typeof rowsByQuerySchema>;\n\nexport const rowsBySourceSchema = v.record(rowsByQuerySchema);\nexport type RowsBySource = v.Infer<typeof rowsBySourceSchema>;\n\n// Planner debug event schemas\n\nconst costEstimateJSONSchema = v.object({\n  startupCost: v.number(),\n  scanEst: v.number(),\n  cost: v.number(),\n  returnedRows: v.number(),\n  selectivity: v.number(),\n  limit: v.number().optional(),\n});\n\nconst plannerConstraintSchema = v.record(v.union(v.unknown(), v.null()));\n\nconst attemptStartEventJSONSchema = v.object({\n  type: v.literal('attempt-start'),\n  attemptNumber: v.number(),\n  totalAttempts: v.number(),\n});\n\nconst connectionCostsEventJSONSchema = v.object({\n  type: v.literal('connection-costs'),\n  attemptNumber: v.number(),\n  costs: v.array(\n    v.object({\n      connection: v.string(),\n      cost: v.number(),\n      costEstimate: costEstimateJSONSchema,\n      pinned: v.boolean(),\n      constraints: v.record(v.union(plannerConstraintSchema, v.null())),\n      constraintCosts: v.record(costEstimateJSONSchema),\n    }),\n  ),\n});\n\nconst connectionSelectedEventJSONSchema = v.object({\n  type: v.literal('connection-selected'),\n  attemptNumber: v.number(),\n  connection: v.string(),\n  cost: v.number(),\n  isRoot: v.boolean(),\n});\n\nconst constraintsPropagatedEventJSONSchema = v.object({\n  type: v.literal('constraints-propagated'),\n  attemptNumber: v.number(),\n  connectionConstraints: v.array(\n    v.object({\n      connection: v.string(),\n      constraints: v.record(v.union(plannerConstraintSchema, v.null())),\n      constraintCosts: v.record(costEstimateJSONSchema),\n    }),\n  ),\n});\n\nconst joinTypeSchema = v.union(\n  v.literal('semi'),\n  v.literal('flipped'),\n  v.literal('unflippable'),\n);\n\nconst planCompleteEventJSONSchema = v.object({\n  type: v.literal('plan-complete'),\n  attemptNumber: v.number(),\n  totalCost: v.number(),\n  flipPattern: v.number(),\n  joinStates: v.array(\n    v.object({\n      join: v.string(),\n      type: joinTypeSchema,\n    }),\n  ),\n});\n\nconst planFailedEventJSONSchema = v.object({\n  type: v.literal('plan-failed'),\n  attemptNumber: v.number(),\n  reason: v.string(),\n});\n\nconst bestPlanSelectedEventJSONSchema = v.object({\n  type: v.literal('best-plan-selected'),\n  bestAttemptNumber: v.number(),\n  totalCost: v.number(),\n  flipPattern: v.number(),\n  joinStates: v.array(\n    v.object({\n      join: v.string(),\n      type: joinTypeSchema,\n    }),\n  ),\n});\n\nconst nodeTypeSchema = v.union(\n  v.literal('connection'),\n  v.literal('join'),\n  v.literal('fan-out'),\n  v.literal('fan-in'),\n  v.literal('terminus'),\n);\n\nconst nodeCostEventJSONSchema = v.object({\n  type: v.literal('node-cost'),\n  attemptNumber: v.number().optional(),\n  nodeType: nodeTypeSchema,\n  node: v.string(),\n  branchPattern: v.array(v.number()),\n  downstreamChildSelectivity: v.number(),\n  costEstimate: costEstimateJSONSchema,\n  filters: conditionSchema.optional(),\n  ordering: orderingSchema.optional(),\n  joinType: joinTypeSchema.optional(),\n});\n\nconst nodeConstraintEventJSONSchema = v.object({\n  type: v.literal('node-constraint'),\n  attemptNumber: v.number().optional(),\n  nodeType: nodeTypeSchema,\n  node: v.string(),\n  branchPattern: v.array(v.number()),\n  constraint: v.union(plannerConstraintSchema, v.null()).optional(),\n  from: v.string(),\n});\n\nconst planDebugEventJSONSchema = v.union(\n  attemptStartEventJSONSchema,\n  connectionCostsEventJSONSchema,\n  connectionSelectedEventJSONSchema,\n  constraintsPropagatedEventJSONSchema,\n  planCompleteEventJSONSchema,\n  planFailedEventJSONSchema,\n  bestPlanSelectedEventJSONSchema,\n  nodeCostEventJSONSchema,\n  nodeConstraintEventJSONSchema,\n);\n\nexport type PlanDebugEventJSON = v.Infer<typeof planDebugEventJSONSchema>;\n\nexport {\n  attemptStartEventJSONSchema,\n  connectionSelectedEventJSONSchema,\n  planFailedEventJSONSchema,\n  bestPlanSelectedEventJSONSchema,\n  nodeConstraintEventJSONSchema,\n};\n\nexport const analyzeQueryResultSchema = v.object({\n  warnings: v.array(v.string()),\n  syncedRows: v.record(v.array(rowSchema)).optional(),\n  syncedRowCount: v.number(),\n  start: v.number(),\n  /** @deprecated Use start + elapsed instead */\n  end: v.number(),\n  elapsed: v.number().optional(),\n  afterPermissions: v.string().optional(),\n  /** @deprecated Use readRowCountsByQuery */\n  vendedRowCounts: rowCountsBySourceSchema.optional(),\n  /** @deprecated Use readRows */\n  vendedRows: rowsBySourceSchema.optional(),\n  sqlitePlans: v.record(v.array(v.string())).optional(),\n  readRows: rowsBySourceSchema.optional(),\n  readRowCountsByQuery: rowCountsBySourceSchema.optional(),\n  readRowCount: v.number().optional(),\n  dbScansByQuery: rowCountsBySourceSchema.optional(),\n  joinPlans: v.array(planDebugEventJSONSchema).optional(),\n});\n\nexport type AnalyzeQueryResult = v.Infer<typeof analyzeQueryResultSchema>;\n"],"names":["v.record","v.number","v.array","v.object","v.union","v.unknown","v.null","v.literal","v.string","v.boolean"],"mappings":"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"}

package/out/zero-protocol/src/application-error.d.ts

@@ -4,13 +4,6 @@ import type { ReadonlyJSONValue } from '../../shared/src/json.ts';
  *
  * Use these when you need to attach additional context to an error that will
  * be sent back to the client.
- *
- * @property details Structured data forwarded to the client alongside the
- * error. Values must be JSON-serializable so they can safely cross the network
- * boundary.
- * @property cause Optional underlying error that triggered this application
- * error. This is surfaced through the standard `cause` property for debugging
- * on the server.
  */
 export interface ApplicationErrorOptions<T extends ReadonlyJSONValue | undefined> {
     details?: T;
@@ -23,10 +16,11 @@ export interface ApplicationErrorOptions<T extends ReadonlyJSONValue | undefined
  * Use this when you want to return a descriptive message along with the
  * JSON-serializable `details`.
  */
-export declare class ApplicationError<const T extends ReadonlyJSONValue | undefined = undefined> extends Error {
+export declare class ApplicationError<const T extends ReadonlyJSONValue | undefined = ReadonlyJSONValue | undefined> extends Error {
     #private;
     constructor(message: string, options?: ApplicationErrorOptions<T> | undefined);
     get details(): T;
+    get kind(): 'Application';
 }
 export declare function isApplicationError(error: unknown): error is ApplicationError;
 export declare function wrapWithApplicationError<T extends ReadonlyJSONValue | undefined = ReadonlyJSONValue | undefined>(error: unknown): ApplicationError<T>;

package/out/zero-protocol/src/application-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application-error.d.ts","sourceRoot":"","sources":["../../../../zero-protocol/src/application-error.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAEhE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,uBAAuB,CACtC,CAAC,SAAS,iBAAiB,GAAG,SAAS;IAEvC,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;GAMG;AACH,qBAAa,gBAAgB,CAC3B,KAAK,CAAC,CAAC,SAAS,iBAAiB,GAAG,SAAS,GAAG,SAAS,CACzD,SAAQ,KAAK;;gBAOX,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,SAAS;IAOlD,IAAI,OAAO,IAAI,CAAC,CAEf;CACF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED,wBAAgB,wBAAwB,CACtC,CAAC,SAAS,iBAAiB,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,EACvE,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAYrC"}
+{"version":3,"file":"application-error.d.ts","sourceRoot":"","sources":["../../../../zero-protocol/src/application-error.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB,CACtC,CAAC,SAAS,iBAAiB,GAAG,SAAS;IAEvC,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;GAMG;AACH,qBAAa,gBAAgB,CAC3B,KAAK,CAAC,CAAC,SAAS,iBAAiB,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAC7E,SAAQ,KAAK;;gBAOX,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,SAAS;IAOlD,IAAI,OAAO,IAAI,CAAC,CAEf;IAED,IAAI,IAAI,IAAI,aAAa,CAExB;CACF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED,wBAAgB,wBAAwB,CACtC,CAAC,SAAS,iBAAiB,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,EACvE,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAYrC"}

package/out/zero-protocol/src/application-error.js

@@ -1,37 +1,38 @@
-import { getErrorDetails, getErrorMessage } from "../../shared/src/error.js";
-/**
- * Error type that application code can throw to surface structured metadata back to
- * the client.
- *
- * Use this when you want to return a descriptive message along with the
- * JSON-serializable `details`.
- */
-export class ApplicationError extends Error {
-    /**
-     * This maps onto errors for transform and push app-level failures.
-     */
-    #details;
-    constructor(message, options) {
-        super(message, { cause: options?.cause });
-        this.name = 'ApplicationError';
-        this.#details = options?.details ?? undefined;
-    }
-    get details() {
-        return this.#details;
-    }
+import { getErrorMessage, getErrorDetails } from "../../shared/src/error.js";
+class ApplicationError extends Error {
+  /**
+   * This maps onto errors for transform and push app-level failures.
+   */
+  #details;
+  constructor(message, options) {
+    super(message, { cause: options?.cause });
+    this.name = "ApplicationError";
+    this.#details = options?.details ?? void 0;
+  }
+  get details() {
+    return this.#details;
+  }
+  get kind() {
+    return "Application";
+  }
 }
-export function isApplicationError(error) {
-    return error instanceof ApplicationError;
+function isApplicationError(error) {
+  return error instanceof ApplicationError;
 }
-export function wrapWithApplicationError(error) {
-    if (isApplicationError(error)) {
-        return error;
-    }
-    const message = getErrorMessage(error);
-    const details = getErrorDetails(error);
-    return new ApplicationError(message, {
-        cause: error,
-        details: details,
-    });
+function wrapWithApplicationError(error) {
+  if (isApplicationError(error)) {
+    return error;
+  }
+  const message = getErrorMessage(error);
+  const details = getErrorDetails(error);
+  return new ApplicationError(message, {
+    cause: error,
+    details
+  });
 }
-//# sourceMappingURL=application-error.js.map
+export {
+  ApplicationError,
+  isApplicationError,
+  wrapWithApplicationError
+};
+//# sourceMappingURL=application-error.js.map

package/out/zero-protocol/src/application-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"application-error.js","sourceRoot":"","sources":["../../../../zero-protocol/src/application-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAE,eAAe,EAAC,MAAM,2BAA2B,CAAC;AAuB3E;;;;;;GAMG;AACH,MAAM,OAAO,gBAEX,SAAQ,KAAK;IACb;;OAEG;IACM,QAAQ,CAAI;IAErB,YACE,OAAe,EACf,OAAgD;QAEhD,KAAK,CAAC,OAAO,EAAE,EAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAC,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,IAAK,SAAe,CAAC;IACvD,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,YAAY,gBAAgB,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,wBAAwB,CAEtC,KAAc;IACd,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,KAA4B,CAAC;IACtC,CAAC;IAED,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAEvC,OAAO,IAAI,gBAAgB,CAAI,OAAO,EAAE;QACtC,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,OAAY;KACtB,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"application-error.js","sources":["../../../../zero-protocol/src/application-error.ts"],"sourcesContent":["import {getErrorDetails, getErrorMessage} from '../../shared/src/error.ts';\nimport type {ReadonlyJSONValue} from '../../shared/src/json.ts';\n\n/**\n * Options accepted by {@link ApplicationError}.\n *\n * Use these when you need to attach additional context to an error that will\n * be sent back to the client.\n */\nexport interface ApplicationErrorOptions<\n  T extends ReadonlyJSONValue | undefined,\n> {\n  details?: T;\n  cause?: unknown;\n}\n\n/**\n * Error type that application code can throw to surface structured metadata back to\n * the client.\n *\n * Use this when you want to return a descriptive message along with the\n * JSON-serializable `details`.\n */\nexport class ApplicationError<\n  const T extends ReadonlyJSONValue | undefined = ReadonlyJSONValue | undefined,\n> extends Error {\n  /**\n   * This maps onto errors for transform and push app-level failures.\n   */\n  readonly #details: T;\n\n  constructor(\n    message: string,\n    options?: ApplicationErrorOptions<T> | undefined,\n  ) {\n    super(message, {cause: options?.cause});\n    this.name = 'ApplicationError';\n    this.#details = options?.details ?? (undefined as T);\n  }\n\n  get details(): T {\n    return this.#details;\n  }\n\n  get kind(): 'Application' {\n    return 'Application';\n  }\n}\n\nexport function isApplicationError(error: unknown): error is ApplicationError {\n  return error instanceof ApplicationError;\n}\n\nexport function wrapWithApplicationError<\n  T extends ReadonlyJSONValue | undefined = ReadonlyJSONValue | undefined,\n>(error: unknown): ApplicationError<T> {\n  if (isApplicationError(error)) {\n    return error as ApplicationError<T>;\n  }\n\n  const message = getErrorMessage(error);\n  const details = getErrorDetails(error);\n\n  return new ApplicationError<T>(message, {\n    cause: error,\n    details: details as T,\n  });\n}\n"],"names":[],"mappings":";AAuBO,MAAM,yBAEH,MAAM;AAAA;AAAA;AAAA;AAAA,EAIL;AAAA,EAET,YACE,SACA,SACA;AACA,UAAM,SAAS,EAAC,OAAO,SAAS,OAAM;AACtC,SAAK,OAAO;AACZ,SAAK,WAAW,SAAS,WAAY;AAAA,EACvC;AAAA,EAEA,IAAI,UAAa;AACf,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,OAAsB;AACxB,WAAO;AAAA,EACT;AACF;AAEO,SAAS,mBAAmB,OAA2C;AAC5E,SAAO,iBAAiB;AAC1B;AAEO,SAAS,yBAEd,OAAqC;AACrC,MAAI,mBAAmB,KAAK,GAAG;AAC7B,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,gBAAgB,KAAK;AACrC,QAAM,UAAU,gBAAgB,KAAK;AAErC,SAAO,IAAI,iBAAoB,SAAS;AAAA,IACtC,OAAO;AAAA,IACP;AAAA,EAAA,CACD;AACH;"}

package/out/zero-protocol/src/ast.d.ts

@@ -12,7 +12,7 @@ export declare const SUBQ_PREFIX = "zsubq_";
 export declare const selectorSchema: v.Type<string>;
 export declare const toStaticParam: unique symbol;
 export declare const planIdSymbol: unique symbol;
-export declare const orderingSchema: v.Type<readonly (readonly [string, "asc" | "desc"])[]>;
+export declare const orderingSchema: v.Type<readonly (readonly [string, "desc" | "asc"])[]>;
 export type System = 'permissions' | 'client' | 'test';
 export declare const primitiveSchema: v.UnionType<[v.Type<string>, v.Type<number>, v.Type<boolean>, v.Type<null>]>;
 export declare const equalityOpsSchema: v.Type<"=" | "!=" | "IS" | "IS NOT">;
@@ -55,7 +55,7 @@ export declare const correlatedSubquerySchemaOmitSubquery: v.ObjectType<Readonly
         childField: v.Type<CompoundKey>;
     }>, undefined>;
     hidden: v.Optional<boolean>;
-    system: v.Optional<"client" | "permissions" | "test">;
+    system: v.Optional<"permissions" | "client" | "test">;
 }>, undefined>;
 export declare const correlatedSubquerySchema: v.Type<CorrelatedSubquery>;
 export declare const astSchema: v.Type<AST>;