@loradb/lora-graphql 0.17.0 → 0.18.0

package/dist/index.js

@@ -1,5 +1,5 @@
-import { D as e, L as r, a as o, M as l, b as i, c as d, d as n, e as t, f, g as m, i as p, l as c, p as h, r as D, s as b, h as u, t as v, v as L } from "./driver-BmnRtkpd.js";
-import { d as x } from "./diff-8nsBSSNP.js";
+import { D as e, L as r, a as o, M as l, b as i, c as d, d as n, e as t, f, g as m, i as p, l as c, p as h, r as D, s as b, h as u, t as v, v as L } from "./driver-CQj9gkvl.js";
+import { d as x } from "./diff-fpWH5KUa.js";
 export {
   e as DEFAULT_GUARDS,
   r as LoraGraphQL,

package/dist/lora-graphql.d.ts

@@ -81,14 +81,15 @@ export interface LoraGraphQLOptions extends ModelOptions, ObservabilityOptions {
     /** Called with every database error, masked or not. */
     onError?: (event: DatabaseErrorEvent) => void;
     /**
-     * Limits on the documents `execute()` and `persist()` accept: depth,
+     * Limits on the documents `execute()`, `subscribe()` and `persist()`
+     * accept: depth,
      * aliases, root fields, tokens, introspection. `false` turns them off.
      * For other servers use `validationRules()` or `envelopPlugin()`.
      */
     guards?: DocumentGuards | false;
     /**
-     * Make `execute()` refuse `source` and run only persisted operations
-     * by `id`. Default false.
+     * Make `execute()` and `subscribe()` refuse `source` and run only
+     * persisted operations by `id`. Default false.
      */
     persistedOnly?: boolean;
 }
@@ -270,10 +271,20 @@ export declare class LoraGraphQL {
      */
     loadManifest(manifest: OperationManifest): void;
     /**
-     * Execute an operation against the schema. Parsed and validated
-     * documents are cached by source text; persisted ones by id.
+     * Execute a query or mutation against the schema. Parsed and validated
+     * documents are cached by source text; persisted ones by id. A
+     * subscription runs with {@link LoraGraphQL.subscribe}.
      */
     execute(args: ExecuteArgs): Promise<ExecutionResult>;
+    /**
+     * Run a subscription: an async iterable of results, one per event, or a
+     * single result with the errors when it cannot start (an unknown id, a
+     * validation error, a denied subscribe). Takes the same arguments as
+     * {@link LoraGraphQL.execute}, a persisted id included, with the same
+     * document cache and guards. End it with `return()` on the iterator, or
+     * with an `AbortSignal` passed as `context.signal`.
+     */
+    subscribe(args: ExecuteArgs): Promise<AsyncIterableIterator<ExecutionResult> | ExecutionResult>;
     /** Called after every committed mutation with its exact write-set. */
     onWrite(listener: (change: WriteChange) => void): () => void;
     /**

package/dist/testing.js

@@ -1,5 +1,5 @@
 import { graphql as h } from "graphql";
-import { L as w, l as u } from "./driver-BmnRtkpd.js";
+import { L as w, l as u } from "./driver-CQj9gkvl.js";
 async function L(l) {
   let s;
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loradb/lora-graphql",
-  "version": "0.17.0",
+  "version": "0.18.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",
@@ -64,7 +64,7 @@
     "bench": "vitest bench --run"
   },
   "peerDependencies": {
-    "@loradb/lora-node": "^0.17.0",
+    "@loradb/lora-node": "^0.18.0",
     "graphql": "^16.8.0 || ^17.0.0"
   },
   "devDependencies": {