@loradb/lora-graphql 0.20.2 → 0.22.0

package/dist/model/types.d.ts

@@ -84,7 +84,11 @@ export interface ScalarField extends FieldBase {
     } | undefined;
     description: string | undefined;
 }
-export type NestedOperation = "CREATE" | "CONNECT" | "DISCONNECT" | "UPDATE" | "DELETE";
+export type NestedOperation = "CREATE" | "CONNECT" | "DISCONNECT"
+/** `update: [{ key, edge, node }]`: the connected node and the properties. */
+ | "UPDATE"
+/** `update: [{ key, edge }]`: the relationship's properties only. */
+ | "UPDATE_EDGE" | "DELETE";
 export interface RelationshipField extends FieldBase {
     kind: "relationship";
     name: string;
@@ -140,6 +144,13 @@ export interface CypherArgument {
     type: TypeShape;
     defaultValue: unknown;
     description: string | undefined;
+    /** `@size(max:)`: the most items a list argument takes. */
+    maxItems?: number | undefined;
+    /** `@range(min:, max:)`: bounds of an Int or Float argument. */
+    range?: {
+        min?: number | undefined;
+        max?: number | undefined;
+    } | undefined;
 }
 export interface CypherField extends FieldBase {
     kind: "cypher";
@@ -180,8 +191,15 @@ export interface CustomField extends FieldBase {
     description: string | undefined;
 }
 export type Field = ScalarField | RelationshipField | CypherField | CustomField;
-/** A `${jwt.path}` / `${context.path}` placeholder inside a rule string. */
+/**
+ * A placeholder inside a rule string: `${jwt.path}`, `${context.path}`,
+ * `${viewer.field}`, or a value of the node the rule is about:
+ * `${node.path}` in a type's rules, `${source.path}` / `${target.path}` /
+ * `${edge.property}` in a relationship field's rules.
+ */
 export declare const PLACEHOLDER: RegExp;
+/** The placeholder sources that name a node (or edge) of the rule itself. */
+export declare const RULE_REFERENCES: Set<string>;
 /** `{ node, jwt, AND, OR, NOT }`, as written in `@authorization`. */
 export type AuthorizationWhere = Record<string, unknown>;
 export interface AuthorizationFilterRule {
@@ -202,7 +220,10 @@ export interface AuthorizationValidateRule {
 export interface Authorization {
     filter: readonly AuthorizationFilterRule[];
     validate: readonly AuthorizationValidateRule[];
-    /** `bypass: false`: the schema's bypass does not skip these rules. */
+    /**
+     * `bypass: false`: the schema's bypass does not skip these rules.
+     * `true`: it does, as when left out, and `check()` does not note it.
+     */
     bypass?: boolean;
     /** `public:` operations deliberately open to every caller. */
     public?: ReadonlySet<AuthOperation>;
@@ -248,8 +269,28 @@ export interface NodeType {
     search: readonly SearchIndex[];
     /** Interfaces the type implements. */
     interfaces: readonly string[];
+    /** `@uniqueTogether`: combinations no two nodes of the type may share. */
+    uniqueTogether: readonly UniqueTogether[];
     description: string | undefined;
 }
+/**
+ * `@uniqueTogether(fields:, where:)`: no two nodes of the type (among those
+ * matching `where`) hold the same value of every field. A combination
+ * with a null scalar, a missing single relationship or an empty set is
+ * exempt, as a null is in a unique index.
+ */
+export interface UniqueTogether {
+    /** The fields as declared, for messages. */
+    fields: readonly string[];
+    /** Scalar fields, compared by stored value. */
+    scalars: readonly ScalarField[];
+    /** Single relationships, compared by the target's @key. */
+    singles: readonly RelationshipField[];
+    /** At most one list relationship, compared as the set of target keys. */
+    set: RelationshipField | undefined;
+    /** A `<Type>Where`-shaped filter: only nodes matching it are compared. */
+    where: Record<string, unknown> | undefined;
+}
 export type SearchIndex = {
     kind: "fulltext";
     name: string;
@@ -346,6 +387,8 @@ export interface GraphModel {
     } | undefined;
     /** Secret cursors are signed with, when configured. */
     cursorSecret: string | undefined;
+    /** The global page-size cap (`maxLimit`); also caps `nodes(ids:)`. */
+    maxLimit?: number | undefined;
 }
 export interface ModelWarning {
     type: string;

package/dist/model/unique-together.d.ts

@@ -0,0 +1,3 @@
+import { GraphModel, NodeType } from './types.js';
+/** The `@uniqueTogether` types `statement` may write. */
+export declare function uniqueTogetherTouched(model: GraphModel, statement: string): NodeType[];

package/dist/schema/build.d.ts

@@ -1,6 +1,6 @@
 import { GraphQLSchema, GraphQLFieldResolver, GraphQLResolveInfo, GraphQLScalarType } from 'graphql';
 import { RootKind } from '../compile/read.js';
-import { AbstractType, CustomField, CypherField, GraphModel, NodeType, SearchIndex } from '../model/types.js';
+import { AbstractType, CustomField, CypherField, GraphModel, NodeType, ScalarField, SearchIndex } from '../model/types.js';
 import { MutationResolver } from './mutations.js';
 /** One event of a generated subscription. */
 export interface ChangeEvent {
@@ -22,6 +22,11 @@ export interface SchemaHooks {
     resolveAbstract: (abstract: AbstractType, info: GraphQLResolveInfo, context: unknown) => Promise<unknown>;
     subscribe: (node: NodeType, args: Record<string, unknown>, context: unknown) => AsyncIterable<ChangeEvent>;
     resolveChangedNode: (node: NodeType, event: ChangeEvent, info: GraphQLResolveInfo, context: unknown) => Promise<unknown>;
+    /**
+     * A `previousState` value as the subscriber may see it: throws when
+     * field-level @authentication refuses it, applies masks by the claims.
+     */
+    previousValue: (node: NodeType, field: ScalarField, value: unknown, context: unknown) => unknown;
     /** Implementations of custom scalars, by name (the scalars option). */
     scalars?: Readonly<Record<string, GraphQLScalarType>> | undefined;
     /** The resolver of a `@customResolver` field (from the resolvers option). */

package/dist/testing.js

@@ -1,5 +1,5 @@
 import { graphql as g } from "graphql";
-import { L as h, l as b } from "./driver-XeJM24iP.js";
+import { a as h, l as b } from "./driver-C5dSoSD8.js";
 async function T(l) {
   let u;
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loradb/lora-graphql",
-  "version": "0.20.2",
+  "version": "0.22.0",
   "description": "Schema-first GraphQL for LoraDB: one annotated SDL becomes an executable, index-aware GraphQL API that compiles every operation to a single Cypher statement.",
   "license": "BUSL-1.1",
   "packageManager": "yarn@4.5.1",
@@ -65,7 +65,7 @@
     "bench:load": "node bench/load/main.mjs"
   },
   "peerDependencies": {
-    "@loradb/lora-node": "^0.20.2",
+    "@loradb/lora-node": "^0.22.0",
     "graphql": "^16.8.0 || ^17.0.0"
   },
   "devDependencies": {