@sequenceholdings/orm 2.0.0 → 2.1.1

package/dist/compiler.d.cts

@@ -3,8 +3,10 @@ import { ClaimKey, PredIr, RootIr, InputRefKind, TableMetaIr, CompiledOperation,
 import { DocumentNode, OperationDefinitionNode, FragmentDefinitionNode, GraphQLSchema, ValueNode, SelectionSetNode } from 'graphql';
 export { DynamicInputIssue, DynamicInputResult, NormalizedBoolExp, NormalizedOnConflict, NormalizedOrderBy, NormalizedRow, ORDER_BY_DIRECTIONS, ScalarKind, allowedBoolExpOperators, allowedOps, validateAppendInput, validateBoolExpInput, validateInsertInput, validateOnConflictInput, validateOrderByInput, validateSelectColumns, validateSetInput } from './dynamic-input.cjs';
 export { CompilePolicyInput, CompilePredicateInput, POLICY_COMPARE_OPS, POLICY_MAX_LINK_DEPTH, ParsedPolicy, PolicyColumnInfo, PolicyCompareOp, PolicyCompileError, PolicyCompileErrorCode, PolicyLinkInfo, PolicyNode, PolicyOperand, PolicyParseError, PolicyResolver, PolicyTableInfo, assertClaimsOnlyWhen, compilePolicy, compilePredicateV2, parsePolicy, walkPolicy } from './predicate-v2.cjs';
-export { P as PLATFORM_USER_TYPENAME, c as camelCase, e as enumTypeName, p as pascalCase } from './naming-DRyinU4u.cjs';
+export { P as PLATFORM_USER_TYPENAME, c as camelCase, g as enumTypeName, p as pascalCase } from './naming-CU9ThP_E.cjs';
 import 'zod';
+import './constants-YoFGjIBM.cjs';
+import './policy-1iZbGnZZ.cjs';
 
 type DiagnosticSeverity = 'error' | 'warning';
 interface CompilerDiagnostic {
@@ -109,6 +111,7 @@ declare function queryRootNames(table: string): {
     select: string;
     byPk: string;
     aggregate: string;
+    aggregateGroups: string;
 };
 type MutationOp = 'insert' | 'insertOne' | 'update' | 'updateByPk' | 'delete' | 'deleteByPk';
 declare function mutationRootNames(table: string): Record<MutationOp, string>;
@@ -132,7 +135,7 @@ declare function classifyInputType(name: string, tableByTypename: ReadonlyMap<st
  */
 
 interface QueryRootInfo {
-    kind: 'select' | 'byPk' | 'aggregate';
+    kind: 'select' | 'byPk' | 'aggregate' | 'aggregateGroups';
     table: string;
 }
 interface CrudMutationRootInfo {
@@ -156,7 +159,13 @@ interface CowMutationRootInfo {
     /** Override: properties copied INSERT…SELECT from synced (pk included). */
     copyColumns: readonly string[];
 }
-type MutationRootInfo = CrudMutationRootInfo | CowMutationRootInfo;
+/** A resolved-table write root (the table is the resolved view). */
+interface ResolvedMutationRootInfo {
+    op: 'resolvedWrite';
+    action: 'insert' | 'update' | 'delete' | 'revert';
+    table: string;
+}
+type MutationRootInfo = CrudMutationRootInfo | CowMutationRootInfo | ResolvedMutationRootInfo;
 interface CompileContext {
     namespace: string;
     tables: Record<string, TableMetaIr>;
@@ -328,6 +337,7 @@ declare class OperationLowerer {
     private readonly variables;
     constructor(ctx: CompileContext, restricted: RestrictedOperation);
     private meta;
+    /** A data column — cell-metadata columns are reachable only through `cells { … }`. */
     private column;
     private link;
     private fieldCandidates;
@@ -346,11 +356,48 @@ declare class OperationLowerer {
     private lowerLimit;
     private lowerOffset;
     lowerSelection(selectionSet: SelectionSetNode, table: string): SelectionIr;
+    /**
+     * `cells { <column> { at by … } }` — typed per-cell metadata. Plain tables
+     * offer `at`/`by`; resolved tables add the winning `source` and newer
+     * `conflicts { source at value }`.
+     */
+    private lowerCells;
     /** The `{ aggregate { count sum {…} avg {…} } nodes {…} }` block shared by roots and relations. */
     private lowerAggregateSelection;
+    /**
+     * The `{ key {…} aggregate {…} }` block of a grouped aggregate root. Same
+     * `aggregate` sub-block as the ungrouped shape (shared via
+     * `lowerAggregateFields`), but `key` replaces `nodes` — see the IR comment on
+     * `aggregateGroupsRootSchema` for why grouped roots have no `nodes`.
+     */
+    private lowerGroupedAggregateSelection;
+    /**
+     * `key { month officer }` → the projected group columns. Every field must be
+     * one of the query's own group keys: any other column is indeterminate
+     * within a group, so selecting it is a document error rather than an
+     * arbitrary pick.
+     */
+    private lowerGroupKeySelection;
+    /** The `count` / `sum {…}` / `avg {…}` fields inside an `aggregate { … }` block. */
+    private lowerAggregateFields;
     lowerRoots(operation: OperationDefinitionNode, kind: 'query' | 'mutation'): RootIr[];
+    private parseAffectedRowAssertion;
     private parseRootDirectives;
     private lowerQueryRoot;
+    /** `<t>AggregateGroups(where:, groupBy:, limit:, offset:)` → an aggregateGroups root. */
+    private lowerAggregateGroupsRoot;
+    /**
+     * `groupBy: [{ column: startedAt, bucket: MONTH }, …]` → GroupByKeyIr[].
+     *
+     * Document-authored only: a whole-argument variable is rejected rather than
+     * becoming a §4f slot. Group keys choose which expressions reach GROUP BY,
+     * and dynamic-input.ts refuses aggregation shapes from client input on the
+     * same reasoning — `where` stays dynamic, which is what runtime filtering
+     * actually needs.
+     */
+    private lowerGroupBy;
+    /** Like lowerLimit, but bounded by MAX_GROUPS and defaulting to it. */
+    private lowerGroupLimit;
     /** byPk-style pk arguments: one argument per primary-key column, exactly. */
     private lowerPkArgs;
     private lowerMutationRoot;
@@ -362,6 +409,12 @@ declare class OperationLowerer {
      * the structured fields, never from authored statements.
      */
     private lowerCowRoot;
+    /**
+     * Resolved-table roots: insertOne(object), updateByPk(pkColumns, _set),
+     * deleteByPk(pk…), revertByPk(pkColumns, columns). The executor writes only
+     * the touched cells into the manual source; `returning` reads the view.
+     */
+    private lowerResolvedRoot;
     private lowerMutationResponse;
     private lowerInsertObjects;
     private lowerInsertRow;

package/dist/compiler.d.ts

@@ -3,8 +3,10 @@ import { ClaimKey, PredIr, RootIr, InputRefKind, TableMetaIr, CompiledOperation,
 import { DocumentNode, OperationDefinitionNode, FragmentDefinitionNode, GraphQLSchema, ValueNode, SelectionSetNode } from 'graphql';
 export { DynamicInputIssue, DynamicInputResult, NormalizedBoolExp, NormalizedOnConflict, NormalizedOrderBy, NormalizedRow, ORDER_BY_DIRECTIONS, ScalarKind, allowedBoolExpOperators, allowedOps, validateAppendInput, validateBoolExpInput, validateInsertInput, validateOnConflictInput, validateOrderByInput, validateSelectColumns, validateSetInput } from './dynamic-input.js';
 export { CompilePolicyInput, CompilePredicateInput, POLICY_COMPARE_OPS, POLICY_MAX_LINK_DEPTH, ParsedPolicy, PolicyColumnInfo, PolicyCompareOp, PolicyCompileError, PolicyCompileErrorCode, PolicyLinkInfo, PolicyNode, PolicyOperand, PolicyParseError, PolicyResolver, PolicyTableInfo, assertClaimsOnlyWhen, compilePolicy, compilePredicateV2, parsePolicy, walkPolicy } from './predicate-v2.js';
-export { P as PLATFORM_USER_TYPENAME, c as camelCase, e as enumTypeName, p as pascalCase } from './naming-CTvWSRTf.js';
+export { P as PLATFORM_USER_TYPENAME, c as camelCase, g as enumTypeName, p as pascalCase } from './naming-CPfx7EfF.js';
 import 'zod';
+import './constants-YoFGjIBM.js';
+import './policy-1iZbGnZZ.js';
 
 type DiagnosticSeverity = 'error' | 'warning';
 interface CompilerDiagnostic {
@@ -109,6 +111,7 @@ declare function queryRootNames(table: string): {
     select: string;
     byPk: string;
     aggregate: string;
+    aggregateGroups: string;
 };
 type MutationOp = 'insert' | 'insertOne' | 'update' | 'updateByPk' | 'delete' | 'deleteByPk';
 declare function mutationRootNames(table: string): Record<MutationOp, string>;
@@ -132,7 +135,7 @@ declare function classifyInputType(name: string, tableByTypename: ReadonlyMap<st
  */
 
 interface QueryRootInfo {
-    kind: 'select' | 'byPk' | 'aggregate';
+    kind: 'select' | 'byPk' | 'aggregate' | 'aggregateGroups';
     table: string;
 }
 interface CrudMutationRootInfo {
@@ -156,7 +159,13 @@ interface CowMutationRootInfo {
     /** Override: properties copied INSERT…SELECT from synced (pk included). */
     copyColumns: readonly string[];
 }
-type MutationRootInfo = CrudMutationRootInfo | CowMutationRootInfo;
+/** A resolved-table write root (the table is the resolved view). */
+interface ResolvedMutationRootInfo {
+    op: 'resolvedWrite';
+    action: 'insert' | 'update' | 'delete' | 'revert';
+    table: string;
+}
+type MutationRootInfo = CrudMutationRootInfo | CowMutationRootInfo | ResolvedMutationRootInfo;
 interface CompileContext {
     namespace: string;
     tables: Record<string, TableMetaIr>;
@@ -328,6 +337,7 @@ declare class OperationLowerer {
     private readonly variables;
     constructor(ctx: CompileContext, restricted: RestrictedOperation);
     private meta;
+    /** A data column — cell-metadata columns are reachable only through `cells { … }`. */
     private column;
     private link;
     private fieldCandidates;
@@ -346,11 +356,48 @@ declare class OperationLowerer {
     private lowerLimit;
     private lowerOffset;
     lowerSelection(selectionSet: SelectionSetNode, table: string): SelectionIr;
+    /**
+     * `cells { <column> { at by … } }` — typed per-cell metadata. Plain tables
+     * offer `at`/`by`; resolved tables add the winning `source` and newer
+     * `conflicts { source at value }`.
+     */
+    private lowerCells;
     /** The `{ aggregate { count sum {…} avg {…} } nodes {…} }` block shared by roots and relations. */
     private lowerAggregateSelection;
+    /**
+     * The `{ key {…} aggregate {…} }` block of a grouped aggregate root. Same
+     * `aggregate` sub-block as the ungrouped shape (shared via
+     * `lowerAggregateFields`), but `key` replaces `nodes` — see the IR comment on
+     * `aggregateGroupsRootSchema` for why grouped roots have no `nodes`.
+     */
+    private lowerGroupedAggregateSelection;
+    /**
+     * `key { month officer }` → the projected group columns. Every field must be
+     * one of the query's own group keys: any other column is indeterminate
+     * within a group, so selecting it is a document error rather than an
+     * arbitrary pick.
+     */
+    private lowerGroupKeySelection;
+    /** The `count` / `sum {…}` / `avg {…}` fields inside an `aggregate { … }` block. */
+    private lowerAggregateFields;
     lowerRoots(operation: OperationDefinitionNode, kind: 'query' | 'mutation'): RootIr[];
+    private parseAffectedRowAssertion;
     private parseRootDirectives;
     private lowerQueryRoot;
+    /** `<t>AggregateGroups(where:, groupBy:, limit:, offset:)` → an aggregateGroups root. */
+    private lowerAggregateGroupsRoot;
+    /**
+     * `groupBy: [{ column: startedAt, bucket: MONTH }, …]` → GroupByKeyIr[].
+     *
+     * Document-authored only: a whole-argument variable is rejected rather than
+     * becoming a §4f slot. Group keys choose which expressions reach GROUP BY,
+     * and dynamic-input.ts refuses aggregation shapes from client input on the
+     * same reasoning — `where` stays dynamic, which is what runtime filtering
+     * actually needs.
+     */
+    private lowerGroupBy;
+    /** Like lowerLimit, but bounded by MAX_GROUPS and defaulting to it. */
+    private lowerGroupLimit;
     /** byPk-style pk arguments: one argument per primary-key column, exactly. */
     private lowerPkArgs;
     private lowerMutationRoot;
@@ -362,6 +409,12 @@ declare class OperationLowerer {
      * the structured fields, never from authored statements.
      */
     private lowerCowRoot;
+    /**
+     * Resolved-table roots: insertOne(object), updateByPk(pkColumns, _set),
+     * deleteByPk(pk…), revertByPk(pkColumns, columns). The executor writes only
+     * the touched cells into the manual source; `returning` reads the view.
+     */
+    private lowerResolvedRoot;
     private lowerMutationResponse;
     private lowerInsertObjects;
     private lowerInsertRow;