eventsourcingdb 1.0.2 → 1.1.0

package/README.md

@@ -94,6 +94,22 @@ const writtenEvents = await client.writeEvents([
 
 *Note that according to the CloudEvents standard, event IDs must be of type string.*
 
+#### Using the `isEventQlTrue` precondition
+
+If you want to write events depending on an EventQL query, import the `isEventQlTrue` function and pass it as an array of preconditions in the second argument:
+
+```typescript
+import { isEventQlTrue } from 'eventsourcingdb';
+
+const writtenEvents = await client.writeEvents([
+  // events
+], [
+  isEventQlTrue(`FROM e IN events WHERE e.type == 'io.eventsourcingdb.library.book-borrowed' PROJECT INTO COUNT() < 10`)
+]);
+```
+
+*Note that the query must return a single row with a single value, which is interpreted as a boolean.*
+
 ### Reading Events
 
 To read all events of a subject, call the `readEvents` function with the subject as the first argument and an options object as the second argument. Set the `recursive` option to `false`. This ensures that only events of the given subject are returned, not events of nested subjects.

package/dist/index.d.mts

@@ -53,12 +53,18 @@ interface IsSubjectOnEventIdPrecondition {
     subject: string;
     eventId: string;
 }
+interface IsEventQlTruePrecondition {
+    query: string;
+}
 type Precondition = {
     type: 'isSubjectPristine';
     payload: IsSubjectPristinePrecondition;
 } | {
     type: 'isSubjectOnEventId';
     payload: IsSubjectOnEventIdPrecondition;
+} | {
+    type: 'isEventQlTrue';
+    payload: IsEventQlTruePrecondition;
 };
 
 type Order = 'chronological' | 'antichronological';

package/dist/index.d.ts

@@ -53,12 +53,18 @@ interface IsSubjectOnEventIdPrecondition {
     subject: string;
     eventId: string;
 }
+interface IsEventQlTruePrecondition {
+    query: string;
+}
 type Precondition = {
     type: 'isSubjectPristine';
     payload: IsSubjectPristinePrecondition;
 } | {
     type: 'isSubjectOnEventId';
     payload: IsSubjectOnEventIdPrecondition;
+} | {
+    type: 'isEventQlTrue';
+    payload: IsEventQlTruePrecondition;
 };
 
 type Order = 'chronological' | 'antichronological';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eventsourcingdb",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "The official JavaScript client SDK for EventSourcingDB.",
   "author": {
     "name": "the native web GmbH",