117 lines
3.8 KiB
TypeScript
117 lines
3.8 KiB
TypeScript
import type { AtomId, InterfaceRevisionId, MemberId, ValueType } from "../capability-model/types.js";
|
|
import type {
|
|
TypeParameter,
|
|
InterfaceApplicationExpression,
|
|
ObjectTypeExpression,
|
|
ClosedTypeArgument,
|
|
} from "../capability-model/generics.js";
|
|
|
|
export type QueryUse = "select" | "predicate" | "order" | "aggregate" | "group" | "distinct";
|
|
export interface QueryAllowance {
|
|
interfaceRevisionId: InterfaceRevisionId;
|
|
memberId: MemberId;
|
|
uses: QueryUse[];
|
|
reason: string;
|
|
}
|
|
export interface QueryBudgets {
|
|
rows: number;
|
|
depth: number;
|
|
resultBytes: number;
|
|
candidates: number;
|
|
rpcCalls: number;
|
|
concurrency: number;
|
|
deadlineMs: number;
|
|
}
|
|
export const defaultQueryBudgets: Readonly<QueryBudgets> = Object.freeze({
|
|
rows: 100,
|
|
depth: 8,
|
|
resultBytes: 1048576,
|
|
candidates: 100,
|
|
rpcCalls: 200,
|
|
concurrency: 8,
|
|
deadlineMs: 10000,
|
|
});
|
|
export type QueryRoot<Interface = InterfaceRevisionId> =
|
|
| { kind: "object"; interface: Interface }
|
|
| { kind: "workspace-interface"; interface: Interface };
|
|
export interface QueryDeclaration {
|
|
placement?: { kind: "replica" } | { kind: "local"; sourceQueryId: string };
|
|
id: string;
|
|
displayName: string;
|
|
root: QueryRoot;
|
|
document: string;
|
|
operation: string;
|
|
fragments: string[];
|
|
views: { atomId: AtomId; interfaceRevisionId: InterfaceRevisionId }[];
|
|
allowances: QueryAllowance[];
|
|
budgets: QueryBudgets;
|
|
watch: boolean;
|
|
polling?: { intervalMs: number; reason: string };
|
|
application?: { templateId: string; arguments: ClosedTypeArgument[] };
|
|
argumentRequirements?: {
|
|
target: import("../capability-model/types.js").ObjectExpectation;
|
|
required: InterfaceRevisionId;
|
|
}[];
|
|
}
|
|
/** Source-only template; neither parameters nor synthetic bound witnesses are installed. */
|
|
export interface QueryTemplate {
|
|
declaration: Omit<QueryDeclaration, "root" | "views" | "allowances">;
|
|
parameters: TypeParameter[];
|
|
root: QueryRoot<InterfaceApplicationExpression>;
|
|
views: { target: ObjectTypeExpression; interface: InterfaceApplicationExpression }[];
|
|
allowances: { interface: InterfaceApplicationExpression; memberName: string; uses: QueryUse[]; reason: string }[];
|
|
}
|
|
export interface QueryFieldEffect {
|
|
interfaceRevisionId: InterfaceRevisionId;
|
|
memberId: MemberId;
|
|
uses: QueryUse[];
|
|
execution: "native" | "rpc-permitted" | "portable";
|
|
}
|
|
export interface QuerySourceLocation {
|
|
file: string;
|
|
line: number;
|
|
column: number;
|
|
}
|
|
export class QueryCompileError extends Error {
|
|
constructor(
|
|
readonly code: string,
|
|
message: string,
|
|
readonly location?: QuerySourceLocation,
|
|
) {
|
|
super(`${code}${location ? ` ${location.file}:${location.line}:${location.column}` : ""}: ${message}`);
|
|
this.name = "QueryCompileError";
|
|
}
|
|
}
|
|
export interface CheckedQuery {
|
|
declaration: QueryDeclaration;
|
|
definitionDigest: string;
|
|
/** Fixed, validated document: never supplied by runtime callers. */
|
|
document: string;
|
|
schema: string;
|
|
variables: ValueType;
|
|
output: ValueType;
|
|
effects: QueryFieldEffect[];
|
|
selection: QuerySelection[];
|
|
variableDefaults: Record<string, QueryArgument>;
|
|
sourceFiles: string[];
|
|
}
|
|
|
|
export type QueryArgument =
|
|
| { kind: "variable"; name: string }
|
|
| { kind: "literal"; value: string | number | boolean | null }
|
|
| { kind: "list"; values: QueryArgument[] }
|
|
| { kind: "object"; fields: Record<string, QueryArgument> };
|
|
export interface QuerySelection {
|
|
liveSelectionId?: string;
|
|
name: string;
|
|
key: string;
|
|
interfaceRevisionId?: InterfaceRevisionId;
|
|
memberId?: MemberId;
|
|
targetInterfaceRevisionId?: InterfaceRevisionId;
|
|
conditions: { include: boolean; value: QueryArgument }[];
|
|
arguments: Record<string, QueryArgument>;
|
|
selection: QuerySelection[];
|
|
relational?: import("./relational.js").QueryRelationalPlan;
|
|
predicate?: import("./relational.js").QueryPredicate;
|
|
}
|