eventsourcingdb 1.8.2 → 1.8.4

package/dist/types/isRecord.js

@@ -0,0 +1,13 @@
+const isRecord = (value) => {
+    if (value === null) {
+        return false;
+    }
+    if (typeof value !== 'object') {
+        return false;
+    }
+    if (Array.isArray(value)) {
+        return false;
+    }
+    return true;
+};
+export { isRecord };

package/dist/types/isString.d.ts

@@ -0,0 +1,2 @@
+declare const isString: (value: unknown) => value is string;
+export { isString };

package/dist/types/isString.js

@@ -0,0 +1,7 @@
+const isString = (value) => {
+    if (typeof value !== 'string') {
+        return false;
+    }
+    return true;
+};
+export { isString };

package/dist/types/isStringOrNull.d.ts

@@ -0,0 +1,2 @@
+declare const isStringOrNull: (value: unknown) => value is string | null;
+export { isStringOrNull };

package/dist/types/isStringOrNull.js

@@ -0,0 +1,10 @@
+const isStringOrNull = (value) => {
+    if (value === null) {
+        return true;
+    }
+    if (typeof value === 'string') {
+        return true;
+    }
+    return false;
+};
+export { isStringOrNull };

package/dist/types/isStringOrUndefined.d.ts

@@ -0,0 +1,2 @@
+declare const isStringOrUndefined: (value: unknown) => value is string | undefined;
+export { isStringOrUndefined };

package/dist/types/isStringOrUndefined.js

@@ -0,0 +1,10 @@
+const isStringOrUndefined = (value) => {
+    if (value === undefined) {
+        return true;
+    }
+    if (typeof value === 'string') {
+        return true;
+    }
+    return false;
+};
+export { isStringOrUndefined };

package/package.json

@@ -1,38 +1,35 @@
 {
   "name": "eventsourcingdb",
-  "version": "1.8.2",
+  "version": "1.8.4",
   "description": "The official JavaScript client SDK for EventSourcingDB.",
   "author": {
     "name": "the native web GmbH",
     "email": "hello@thenativeweb.io"
   },
+  "type": "module",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.mts",
-        "default": "./dist/index.mjs"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     }
   },
-  "types": "./dist/index.d.cts",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
   "dependencies": {
-    "testcontainers": "12.0.4"
+    "testcontainers": "12.1.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.5.2",
-    "@types/node": "25.9.3",
+    "@biomejs/biome": "2.5.5",
+    "@types/node": "26.1.1",
     "get-port": "7.2.0",
-    "tsdown": "0.22.3",
-    "tsx": "4.22.5",
-    "typescript": "6.0.3"
+    "tsx": "4.23.1",
+    "typescript": "7.0.2"
   },
   "scripts": {
     "analyze": "npx tsc --noEmit && npx biome check --error-on-warnings .",
-    "build": "npx tsc --noEmit && npx tsdown --format cjs,esm --dts --minify --out-dir ./dist ./src/index.ts",
+    "build": "npx tsc -p tsconfig.build.json",
     "format": "npx biome check --write .",
     "qa": "npm run analyze && npm run test",
     "test": "node --test --import tsx \"./src/**/*.test.ts\""

package/.editorconfig

@@ -1,22 +0,0 @@
-# top-most EditorConfig file
-root = true
-
-[*]
-charset = utf-8
-end_of_line = lf
-indent_size = 2
-indent_style = tab
-insert_final_newline = true
-trim_trailing_whitespace = true
-
-[*.json]
-indent_size = 2
-indent_style = space
-
-[*.md]
-indent_size = 2
-indent_style = space
-
-[*.yml]
-indent_size = 2
-indent_style = space

package/.nvmrc

@@ -1 +0,0 @@
-26.3.1

package/dist/index.cjs

@@ -1,3 +0,0 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require("node:crypto");c=s(c);let l=require("testcontainers");var u=class{specversion;id;time;#e;source;subject;type;datacontenttype;data;hash;predecessorhash;traceparent;tracestate;signature;constructor({specversion:e,id:t,time:n,timeFromServer:r,source:i,subject:a,type:o,datacontenttype:s,data:c,hash:l,predecessorhash:u,traceparent:d,tracestate:f,signature:p}){this.specversion=e,this.id=t,this.time=n,this.#e=r,this.source=i,this.subject=a,this.type=o,this.datacontenttype=s,this.data=c,this.hash=l,this.predecessorhash=u,this.traceparent=d,this.tracestate=f,this.signature=p}verifyHash(){let e=`${this.specversion}|${this.id}|${this.predecessorhash}|${this.#e}|${this.source}|${this.subject}|${this.type}|${this.datacontenttype}`,t=c.default.createHash(`sha256`).update(e).digest(`hex`),n=c.default.createHash(`sha256`).update(JSON.stringify(this.data)).digest(`hex`);if(c.default.createHash(`sha256`).update(`${t}${n}`).digest(`hex`)!==this.hash)throw Error(`Failed to verify hash.`)}verifySignature(e){if(this.signature===null)throw Error(`Signature must not be null.`);this.verifyHash();let t=`esdb:signature:v1:`;if(!this.signature.startsWith(t))throw Error(`Signature must start with '${t}'`);let n=this.signature.slice(18),r=Buffer.from(n,`hex`),i=Buffer.from(this.hash,`utf8`);if(!c.default.verify(null,i,e,r))throw Error(`Signature verification failed.`)}};const d=e=>new u({specversion:e.specversion,id:e.id,time:new Date(e.time),timeFromServer:e.time,source:e.source,subject:e.subject,type:e.type,datacontenttype:e.datacontenttype,data:e.data,hash:e.hash,predecessorhash:e.predecessorhash,traceparent:e.traceparent,tracestate:e.tracestate,signature:e.signature}),f=e=>!(typeof e!=`object`||!e||Array.isArray(e)),p=(e,t)=>{if(!f(e))return!1;for(let n of Object.keys(t)){let r=t[n],i=e[n];if(typeof r==`function`){if(!r(i))return!1;continue}if(!f(i)||!p(i,r))return!1}return!0},m=e=>typeof e==`string`,h=e=>e===null||typeof e==`string`,g=e=>e===void 0||typeof e==`string`,_=e=>p(e,{specversion:m,id:m,time:m,source:m,subject:m,type:m,datacontenttype:m,data:f,hash:m,predecessorhash:m,traceparent:g,tracestate:g,signature:h}),v=e=>{let t=e.headers.get(`Server`);return!(!t||!t.startsWith(`EventSourcingDB/`))},y=async function*(e,t){let n=e.getReader(),r=new TextDecoder(`utf-8`),i=``,a=()=>{n.cancel().catch(()=>{})};if(t.aborted){await n.cancel().catch(()=>{});return}t.addEventListener(`abort`,a);try{for(;!t.aborted;){let{done:e,value:t}=await n.read();if(e)break;i+=r.decode(t,{stream:!0});let a=i.indexOf(`
-`);for(;a!==-1;){let e=i.slice(0,a).trim();i=i.slice(a+1),e&&(yield JSON.parse(e)),a=i.indexOf(`
-`)}}}finally{t.removeEventListener(`abort`,a),await n.cancel().catch(()=>{})}},b=e=>p(e,{type:e=>e===`event`,payload:{specversion:m,id:m,time:m,source:m,subject:m,type:m,datacontenttype:m,data:f,hash:m,predecessorhash:m,traceparent:g,tracestate:g,signature:h}}),x=e=>p(e,{type:e=>e===`error`,payload:{error:m}}),S=e=>typeof e==`boolean`,C=e=>p(e,{type:e=>e===`eventType`,payload:{eventType:m,isPhantom:S}}),w=e=>p(e,{type:e=>e===`heartbeat`}),T=e=>p(e,{type:e=>e===`row`,payload:e=>e!==void 0}),E=e=>p(e,{type:e=>e===`subject`,payload:{subject:m}});var D=class{#e;#t;#n(e){return new URL(e,this.#e).toString()}constructor(e,t){this.#e=e,this.#t=t}async ping(){let e=this.#n(`/api/v1/ping`),t=await fetch(e,{method:`get`});if(!v(t))throw Error(`Server must be EventSourcingDB.`);if(t.status!==200)throw Error(`Failed to ping, got HTTP status code '${t.status}', expected '200'.`);let n=await t.json();if(!p(n,{type:m}))throw Error(`Failed to parse response.`);if(n.type!==`io.eventsourcingdb.api.ping-received`)throw Error(`Failed to ping.`)}async verifyApiToken(){let e=this.#n(`/api/v1/verify-api-token`),t=await fetch(e,{method:`post`,headers:{authorization:`Bearer ${this.#t}`}});if(!v(t))throw Error(`Server must be EventSourcingDB.`);if(t.status!==200)throw Error(`Failed to verify API token, got HTTP status code '${t.status}', expected '200'.`);let n=await t.json();if(!p(n,{type:m}))throw Error(`Failed to parse response.`);if(n.type!==`io.eventsourcingdb.api.api-token-verified`)throw Error(`Failed to verify API token.`)}async writeEvents(e,t=[]){let n=this.#n(`/api/v1/write-events`),r=await fetch(n,{method:`post`,headers:{authorization:`Bearer ${this.#t}`,"content-type":`application/json`},body:JSON.stringify({events:e,preconditions:t})});if(!v(r))throw Error(`Server must be EventSourcingDB.`);if(r.status!==200)throw Error(`Failed to write events, got HTTP status code '${r.status}', expected '200'.`);let i=await r.json();if(!Array.isArray(i))throw Error(`Failed to parse response.`);return i.map(e=>{if(!_(e))throw Error(`Failed to parse response item.`);return d(e)})}readEvents(e,t,n){let r=this.#n(`/api/v1/read-events`),i=this.#t;return(async function*(){let a=new AbortController,o=n??a.signal,s=!n,c;if(n&&!n.aborted){let e=()=>a.abort();n.addEventListener(`abort`,e,{once:!0}),c=()=>n.removeEventListener(`abort`,e)}try{let n=await fetch(r,{method:`post`,headers:{authorization:`Bearer ${i}`,"content-type":`application/json`},body:JSON.stringify({subject:e,options:t}),signal:o});if(!v(n)){let e=n.headers.get(`Server`);throw Error(e?`Server must be EventSourcingDB, got Server header: '${e}'.`:`Server must be EventSourcingDB, but Server header is missing.`)}if(n.status!==200)throw Error(`Failed to read events, got HTTP status code '${n.status}', expected '200'.`);if(!n.body)throw Error(`Failed to read events.`);for await(let e of y(n.body,o)){if(x(e))throw Error(`${e.payload.error}.`);if(b(e)){yield d(e.payload);continue}throw Error(`Failed to read events.`)}}catch(e){if(e instanceof DOMException&&e.name===`AbortError`)return;throw e}finally{c&&c(),s&&a.abort()}})()}runEventQlQuery(e,t){let n=this.#n(`/api/v1/run-eventql-query`),r=this.#t;return(async function*(){let i=new AbortController,a=t??i.signal,o=!t,s;if(t&&!t.aborted){let e=()=>i.abort();t.addEventListener(`abort`,e,{once:!0}),s=()=>t.removeEventListener(`abort`,e)}try{let t=await fetch(n,{method:`post`,headers:{authorization:`Bearer ${r}`,"content-type":`application/json`},body:JSON.stringify({query:e}),signal:a});if(!v(t)){let e=t.headers.get(`Server`);throw Error(e?`Server must be EventSourcingDB, got Server header: '${e}'.`:`Server must be EventSourcingDB, but Server header is missing.`)}if(t.status!==200)throw Error(`Failed to run EventQL query, got HTTP status code '${t.status}', expected '200'.`);if(!t.body)throw Error(`Failed to run EventQL query.`);for await(let e of y(t.body,a))if(!w(e)){if(x(e))throw Error(`${e.payload.error}.`);if(T(e)){yield e.payload;continue}throw Error(`Failed to run EventQL query.`)}}catch(e){if(e instanceof DOMException&&e.name===`AbortError`)return;throw e}finally{s&&s(),o&&i.abort()}})()}observeEvents(e,t,n){let r=this.#n(`/api/v1/observe-events`),i=this.#t;return(async function*(){let a=new AbortController,o=n??a.signal,s=!n,c;if(n&&!n.aborted){let e=()=>a.abort();n.addEventListener(`abort`,e,{once:!0}),c=()=>n.removeEventListener(`abort`,e)}try{let n=await fetch(r,{method:`post`,headers:{authorization:`Bearer ${i}`,"content-type":`application/json`},body:JSON.stringify({subject:e,options:t}),signal:o});if(!v(n)){let e=n.headers.get(`Server`);throw Error(e?`Server must be EventSourcingDB, got Server header: '${e}'.`:`Server must be EventSourcingDB, but Server header is missing.`)}if(n.status!==200)throw Error(`Failed to observe events, got HTTP status code '${n.status}', expected '200'.`);if(!n.body)throw Error(`Failed to observe events.`);for await(let e of y(n.body,o))if(!w(e)){if(x(e))throw Error(`${e.payload.error}.`);if(b(e)){yield d(e.payload);continue}throw Error(`Failed to observe events.`)}}catch(e){if(e instanceof DOMException&&e.name===`AbortError`)return;throw e}finally{c&&c(),s&&a.abort()}})()}async registerEventSchema(e,t){let n=this.#n(`/api/v1/register-event-schema`),r=await fetch(n,{method:`post`,headers:{authorization:`Bearer ${this.#t}`,"content-type":`application/json`},body:JSON.stringify({eventType:e,schema:t})});if(!v(r))throw Error(`Server must be EventSourcingDB.`);if(r.status!==200)throw Error(`Failed to register event schema, got HTTP status code '${r.status}', expected '200'.`)}readSubjects(e,t){let n=this.#n(`/api/v1/read-subjects`),r=this.#t;return(async function*(){let i=new AbortController,a=t??i.signal,o=!t,s;if(t&&!t.aborted){let e=()=>i.abort();t.addEventListener(`abort`,e,{once:!0}),s=()=>t.removeEventListener(`abort`,e)}try{let t=await fetch(n,{method:`post`,headers:{authorization:`Bearer ${r}`,"content-type":`application/json`},body:JSON.stringify({baseSubject:e}),signal:a});if(!v(t)){let e=t.headers.get(`Server`);throw Error(e?`Server must be EventSourcingDB, got Server header: '${e}'.`:`Server must be EventSourcingDB, but Server header is missing.`)}if(t.status!==200)throw Error(`Failed to read subjects, got HTTP status code '${t.status}', expected '200'.`);if(!t.body)throw Error(`Failed to read subjects.`);for await(let e of y(t.body,a)){if(x(e))throw Error(`${e.payload.error}.`);if(E(e)){yield e.payload.subject;continue}throw Error(`Failed to read subjects.`)}}catch(e){if(e instanceof DOMException&&e.name===`AbortError`)return;throw e}finally{s&&s(),o&&i.abort()}})()}async readEventType(e){let t=this.#n(`/api/v1/read-event-type`),n=await fetch(t,{method:`post`,headers:{authorization:`Bearer ${this.#t}`,"content-type":`application/json`},body:JSON.stringify({eventType:e})});if(!v(n))throw Error(`Server must be EventSourcingDB.`);if(n.status!==200)throw Error(`Failed to read event type, got HTTP status code '${n.status}', expected '200'.`);let r=await n.json();if(!p(r,{eventType:m,isPhantom:S}))throw Error(`Failed to parse response.`);return r}readEventTypes(e){let t=this.#n(`/api/v1/read-event-types`),n=this.#t;return(async function*(){let r=new AbortController,i=e??r.signal,a=!e,o;if(e&&!e.aborted){let t=()=>r.abort();e.addEventListener(`abort`,t,{once:!0}),o=()=>e.removeEventListener(`abort`,t)}try{let e=await fetch(t,{method:`post`,headers:{authorization:`Bearer ${n}`},signal:i});if(!v(e)){let t=e.headers.get(`Server`);throw Error(t?`Server must be EventSourcingDB, got Server header: '${t}'.`:`Server must be EventSourcingDB, but Server header is missing.`)}if(e.status!==200)throw Error(`Failed to read event types, got HTTP status code '${e.status}', expected '200'.`);if(!e.body)throw Error(`Failed to read event types.`);for await(let t of y(e.body,i))if(!w(t)){if(x(t))throw Error(`${t.payload.error}.`);if(C(t)){yield t.payload;continue}throw Error(`Failed to read event types.`)}}catch(e){if(e instanceof DOMException&&e.name===`AbortError`)return;throw e}finally{o&&o(),a&&r.abort()}})()}},O=class{#e=`thenativeweb/eventsourcingdb`;#t=`latest`;#n=3e3;#r=`secret`;#i;#a;withImageTag(e){return this.#t=e,this}withApiToken(e){return this.#r=e,this}withSigningKey(){let{privateKey:e}=c.default.generateKeyPairSync(`ed25519`);return this.#i=e,this}withPort(e){return this.#n=e,this}async start(){let e=[`run`,`--api-token`,this.#r,`--data-directory-temporary`,`--http-enabled`,`--https-enabled=false`],t=[];this.#i!==void 0&&(e.push(`--signing-key-file`),e.push(`/etc/esdb/signing-key.pem`),t.push({content:this.#i.export({format:`pem`,type:`pkcs8`}),target:`/etc/esdb/signing-key.pem`,mode:511})),this.#a=await new l.GenericContainer(`${this.#e}:${this.#t}`).withExposedPorts(this.#n).withCommand(e).withCopyContentToContainer(t).withWaitStrategy(l.Wait.forHttp(`/api/v1/ping`,this.#n).withStartupTimeout(1e4)).start()}getHost(){if(this.#a===void 0)throw Error(`Container must be running.`);return this.#a.getHost()}getMappedPort(){if(this.#a===void 0)throw Error(`Container must be running.`);return this.#a.getMappedPort(this.#n)}getBaseUrl(){if(this.#a===void 0)throw Error(`Container must be running.`);let e=this.getHost(),t=this.getMappedPort();return new URL(`http://${e}:${t}`)}getApiToken(){return this.#r}getSigningKey(){if(this.#i===void 0)throw Error(`Signing key not set.`);return this.#i}getVerificationKey(){if(this.#i===void 0)throw Error(`Signing key not set.`);return c.default.createPublicKey(this.#i)}isRunning(){return this.#a!==void 0}async stop(){this.#a!==void 0&&(await this.#a.stop(),this.#a=void 0)}getClient(){return new D(this.getBaseUrl(),this.getApiToken())}};const k=e=>({type:`isEventQlQueryTrue`,payload:{query:e}}),A=(e,t)=>({type:`isSubjectOnEventId`,payload:{subject:e,eventId:t}}),j=e=>({type:`isSubjectPopulated`,payload:{subject:e}}),M=e=>({type:`isSubjectPristine`,payload:{subject:e}});exports.Client=D,exports.Container=O,exports.isEventQlQueryTrue=k,exports.isSubjectOnEventId=A,exports.isSubjectPopulated=j,exports.isSubjectPristine=M;

package/dist/index.d.cts

@@ -1,182 +0,0 @@
-import crypto from "node:crypto";
-
-//#region src/Event.d.ts
-declare class Event {
-  #private;
-  specversion: string;
-  id: string;
-  time: Date;
-  source: string;
-  subject: string;
-  type: string;
-  datacontenttype: string;
-  data: Record<string, unknown>;
-  hash: string;
-  predecessorhash: string;
-  traceparent?: string;
-  tracestate?: string;
-  signature: string | null;
-  constructor({
-    specversion,
-    id,
-    time,
-    timeFromServer,
-    source,
-    subject,
-    type,
-    datacontenttype,
-    data,
-    hash,
-    predecessorhash,
-    traceparent,
-    tracestate,
-    signature
-  }: {
-    specversion: string;
-    id: string;
-    time: Date;
-    timeFromServer: string;
-    source: string;
-    subject: string;
-    type: string;
-    datacontenttype: string;
-    data: Record<string, unknown>;
-    hash: string;
-    predecessorhash: string;
-    traceparent?: string;
-    tracestate?: string;
-    signature: string | null;
-  });
-  verifyHash(): void;
-  verifySignature(verificationKey: crypto.KeyObject): void;
-}
-//#endregion
-//#region src/EventCandidate.d.ts
-interface EventCandidate {
-  source: string;
-  subject: string;
-  type: string;
-  data: Record<string, unknown>;
-  traceparent?: string;
-  tracestate?: string;
-}
-//#endregion
-//#region src/EventType.d.ts
-interface EventType {
-  eventType: string;
-  isPhantom: boolean;
-  schema?: Record<string, unknown>;
-}
-//#endregion
-//#region src/Bound.d.ts
-type BoundType = 'inclusive' | 'exclusive';
-interface Bound {
-  id: string;
-  type: BoundType;
-}
-//#endregion
-//#region src/ObserveEventsOptions.d.ts
-type ObserveIfEventIsMissing = 'read-everything' | 'wait-for-event';
-interface ObserveFromLatestEvent {
-  subject: string;
-  type: string;
-  ifEventIsMissing: ObserveIfEventIsMissing;
-}
-interface ObserveEventsOptions {
-  recursive: boolean;
-  lowerBound?: Bound;
-  fromLatestEvent?: ObserveFromLatestEvent;
-}
-//#endregion
-//#region src/Precondition.d.ts
-interface IsSubjectPristinePrecondition {
-  subject: string;
-}
-interface IsSubjectPopulatedPrecondition {
-  subject: string;
-}
-interface IsSubjectOnEventIdPrecondition {
-  subject: string;
-  eventId: string;
-}
-interface IsEventQlQueryTruePrecondition {
-  query: string;
-}
-type Precondition = {
-  type: 'isSubjectPristine';
-  payload: IsSubjectPristinePrecondition;
-} | {
-  type: 'isSubjectOnEventId';
-  payload: IsSubjectOnEventIdPrecondition;
-} | {
-  type: 'isSubjectPopulated';
-  payload: IsSubjectPopulatedPrecondition;
-} | {
-  type: 'isEventQlQueryTrue';
-  payload: IsEventQlQueryTruePrecondition;
-};
-//#endregion
-//#region src/ReadEventsOptions.d.ts
-type Order = 'chronological' | 'antichronological';
-type ReadIfEventIsMissing = 'read-nothing' | 'read-everything';
-interface ReadFromLatestEvent {
-  subject: string;
-  type: string;
-  ifEventIsMissing: ReadIfEventIsMissing;
-}
-interface ReadEventsOptions {
-  recursive: boolean;
-  order?: Order;
-  lowerBound?: Bound;
-  upperBound?: Bound;
-  fromLatestEvent?: ReadFromLatestEvent;
-}
-//#endregion
-//#region src/Client.d.ts
-declare class Client {
-  #private;
-  constructor(url: URL, apiToken: string);
-  ping(): Promise<void>;
-  verifyApiToken(): Promise<void>;
-  writeEvents(events: EventCandidate[], preconditions?: Precondition[]): Promise<Event[]>;
-  readEvents(subject: string, options: ReadEventsOptions, signal?: AbortSignal): AsyncGenerator<Event, void, void>;
-  runEventQlQuery(query: string, signal?: AbortSignal): AsyncGenerator<unknown, void, void>;
-  observeEvents(subject: string, options: ObserveEventsOptions, signal?: AbortSignal): AsyncGenerator<Event, void, void>;
-  registerEventSchema(eventType: string, schema: Record<string, unknown>): Promise<void>;
-  readSubjects(baseSubject: string, signal?: AbortSignal): AsyncGenerator<string, void, void>;
-  readEventType(eventType: string): Promise<EventType>;
-  readEventTypes(signal?: AbortSignal): AsyncGenerator<EventType, void, void>;
-}
-//#endregion
-//#region src/Container.d.ts
-declare class Container {
-  #private;
-  withImageTag(tag: string): this;
-  withApiToken(token: string): this;
-  withSigningKey(): this;
-  withPort(port: number): this;
-  start(): Promise<void>;
-  getHost(): string;
-  getMappedPort(): number;
-  getBaseUrl(): URL;
-  getApiToken(): string;
-  getSigningKey(): crypto.KeyObject;
-  getVerificationKey(): crypto.KeyObject;
-  isRunning(): boolean;
-  stop(): Promise<void>;
-  getClient(): Client;
-}
-//#endregion
-//#region src/isEventQlQueryTrue.d.ts
-declare const isEventQlQueryTrue: (query: string) => Precondition;
-//#endregion
-//#region src/isSubjectOnEventId.d.ts
-declare const isSubjectOnEventId: (subject: string, eventId: string) => Precondition;
-//#endregion
-//#region src/isSubjectPopulated.d.ts
-declare const isSubjectPopulated: (subject: string) => Precondition;
-//#endregion
-//#region src/isSubjectPristine.d.ts
-declare const isSubjectPristine: (subject: string) => Precondition;
-//#endregion
-export { Client, Container, type Event, type EventCandidate, type EventType, type ObserveEventsOptions, type Precondition, type ReadEventsOptions, isEventQlQueryTrue, isSubjectOnEventId, isSubjectPopulated, isSubjectPristine };

package/dist/index.d.mts

@@ -1,182 +0,0 @@
-import crypto from "node:crypto";
-
-//#region src/Event.d.ts
-declare class Event {
-  #private;
-  specversion: string;
-  id: string;
-  time: Date;
-  source: string;
-  subject: string;
-  type: string;
-  datacontenttype: string;
-  data: Record<string, unknown>;
-  hash: string;
-  predecessorhash: string;
-  traceparent?: string;
-  tracestate?: string;
-  signature: string | null;
-  constructor({
-    specversion,
-    id,
-    time,
-    timeFromServer,
-    source,
-    subject,
-    type,
-    datacontenttype,
-    data,
-    hash,
-    predecessorhash,
-    traceparent,
-    tracestate,
-    signature
-  }: {
-    specversion: string;
-    id: string;
-    time: Date;
-    timeFromServer: string;
-    source: string;
-    subject: string;
-    type: string;
-    datacontenttype: string;
-    data: Record<string, unknown>;
-    hash: string;
-    predecessorhash: string;
-    traceparent?: string;
-    tracestate?: string;
-    signature: string | null;
-  });
-  verifyHash(): void;
-  verifySignature(verificationKey: crypto.KeyObject): void;
-}
-//#endregion
-//#region src/EventCandidate.d.ts
-interface EventCandidate {
-  source: string;
-  subject: string;
-  type: string;
-  data: Record<string, unknown>;
-  traceparent?: string;
-  tracestate?: string;
-}
-//#endregion
-//#region src/EventType.d.ts
-interface EventType {
-  eventType: string;
-  isPhantom: boolean;
-  schema?: Record<string, unknown>;
-}
-//#endregion
-//#region src/Bound.d.ts
-type BoundType = 'inclusive' | 'exclusive';
-interface Bound {
-  id: string;
-  type: BoundType;
-}
-//#endregion
-//#region src/ObserveEventsOptions.d.ts
-type ObserveIfEventIsMissing = 'read-everything' | 'wait-for-event';
-interface ObserveFromLatestEvent {
-  subject: string;
-  type: string;
-  ifEventIsMissing: ObserveIfEventIsMissing;
-}
-interface ObserveEventsOptions {
-  recursive: boolean;
-  lowerBound?: Bound;
-  fromLatestEvent?: ObserveFromLatestEvent;
-}
-//#endregion
-//#region src/Precondition.d.ts
-interface IsSubjectPristinePrecondition {
-  subject: string;
-}
-interface IsSubjectPopulatedPrecondition {
-  subject: string;
-}
-interface IsSubjectOnEventIdPrecondition {
-  subject: string;
-  eventId: string;
-}
-interface IsEventQlQueryTruePrecondition {
-  query: string;
-}
-type Precondition = {
-  type: 'isSubjectPristine';
-  payload: IsSubjectPristinePrecondition;
-} | {
-  type: 'isSubjectOnEventId';
-  payload: IsSubjectOnEventIdPrecondition;
-} | {
-  type: 'isSubjectPopulated';
-  payload: IsSubjectPopulatedPrecondition;
-} | {
-  type: 'isEventQlQueryTrue';
-  payload: IsEventQlQueryTruePrecondition;
-};
-//#endregion
-//#region src/ReadEventsOptions.d.ts
-type Order = 'chronological' | 'antichronological';
-type ReadIfEventIsMissing = 'read-nothing' | 'read-everything';
-interface ReadFromLatestEvent {
-  subject: string;
-  type: string;
-  ifEventIsMissing: ReadIfEventIsMissing;
-}
-interface ReadEventsOptions {
-  recursive: boolean;
-  order?: Order;
-  lowerBound?: Bound;
-  upperBound?: Bound;
-  fromLatestEvent?: ReadFromLatestEvent;
-}
-//#endregion
-//#region src/Client.d.ts
-declare class Client {
-  #private;
-  constructor(url: URL, apiToken: string);
-  ping(): Promise<void>;
-  verifyApiToken(): Promise<void>;
-  writeEvents(events: EventCandidate[], preconditions?: Precondition[]): Promise<Event[]>;
-  readEvents(subject: string, options: ReadEventsOptions, signal?: AbortSignal): AsyncGenerator<Event, void, void>;
-  runEventQlQuery(query: string, signal?: AbortSignal): AsyncGenerator<unknown, void, void>;
-  observeEvents(subject: string, options: ObserveEventsOptions, signal?: AbortSignal): AsyncGenerator<Event, void, void>;
-  registerEventSchema(eventType: string, schema: Record<string, unknown>): Promise<void>;
-  readSubjects(baseSubject: string, signal?: AbortSignal): AsyncGenerator<string, void, void>;
-  readEventType(eventType: string): Promise<EventType>;
-  readEventTypes(signal?: AbortSignal): AsyncGenerator<EventType, void, void>;
-}
-//#endregion
-//#region src/Container.d.ts
-declare class Container {
-  #private;
-  withImageTag(tag: string): this;
-  withApiToken(token: string): this;
-  withSigningKey(): this;
-  withPort(port: number): this;
-  start(): Promise<void>;
-  getHost(): string;
-  getMappedPort(): number;
-  getBaseUrl(): URL;
-  getApiToken(): string;
-  getSigningKey(): crypto.KeyObject;
-  getVerificationKey(): crypto.KeyObject;
-  isRunning(): boolean;
-  stop(): Promise<void>;
-  getClient(): Client;
-}
-//#endregion
-//#region src/isEventQlQueryTrue.d.ts
-declare const isEventQlQueryTrue: (query: string) => Precondition;
-//#endregion
-//#region src/isSubjectOnEventId.d.ts
-declare const isSubjectOnEventId: (subject: string, eventId: string) => Precondition;
-//#endregion
-//#region src/isSubjectPopulated.d.ts
-declare const isSubjectPopulated: (subject: string) => Precondition;
-//#endregion
-//#region src/isSubjectPristine.d.ts
-declare const isSubjectPristine: (subject: string) => Precondition;
-//#endregion
-export { Client, Container, type Event, type EventCandidate, type EventType, type ObserveEventsOptions, type Precondition, type ReadEventsOptions, isEventQlQueryTrue, isSubjectOnEventId, isSubjectPopulated, isSubjectPristine };

package/dist/index.mjs

@@ -1,3 +0,0 @@
-import e from"node:crypto";import{GenericContainer as t,Wait as n}from"testcontainers";var r=class{specversion;id;time;#e;source;subject;type;datacontenttype;data;hash;predecessorhash;traceparent;tracestate;signature;constructor({specversion:e,id:t,time:n,timeFromServer:r,source:i,subject:a,type:o,datacontenttype:s,data:c,hash:l,predecessorhash:u,traceparent:d,tracestate:f,signature:p}){this.specversion=e,this.id=t,this.time=n,this.#e=r,this.source=i,this.subject=a,this.type=o,this.datacontenttype=s,this.data=c,this.hash=l,this.predecessorhash=u,this.traceparent=d,this.tracestate=f,this.signature=p}verifyHash(){let t=`${this.specversion}|${this.id}|${this.predecessorhash}|${this.#e}|${this.source}|${this.subject}|${this.type}|${this.datacontenttype}`,n=e.createHash(`sha256`).update(t).digest(`hex`),r=e.createHash(`sha256`).update(JSON.stringify(this.data)).digest(`hex`);if(e.createHash(`sha256`).update(`${n}${r}`).digest(`hex`)!==this.hash)throw Error(`Failed to verify hash.`)}verifySignature(t){if(this.signature===null)throw Error(`Signature must not be null.`);this.verifyHash();let n=`esdb:signature:v1:`;if(!this.signature.startsWith(n))throw Error(`Signature must start with '${n}'`);let r=this.signature.slice(18),i=Buffer.from(r,`hex`),a=Buffer.from(this.hash,`utf8`);if(!e.verify(null,a,t,i))throw Error(`Signature verification failed.`)}};const i=e=>new r({specversion:e.specversion,id:e.id,time:new Date(e.time),timeFromServer:e.time,source:e.source,subject:e.subject,type:e.type,datacontenttype:e.datacontenttype,data:e.data,hash:e.hash,predecessorhash:e.predecessorhash,traceparent:e.traceparent,tracestate:e.tracestate,signature:e.signature}),a=e=>!(typeof e!=`object`||!e||Array.isArray(e)),o=(e,t)=>{if(!a(e))return!1;for(let n of Object.keys(t)){let r=t[n],i=e[n];if(typeof r==`function`){if(!r(i))return!1;continue}if(!a(i)||!o(i,r))return!1}return!0},s=e=>typeof e==`string`,c=e=>e===null||typeof e==`string`,l=e=>e===void 0||typeof e==`string`,u=e=>o(e,{specversion:s,id:s,time:s,source:s,subject:s,type:s,datacontenttype:s,data:a,hash:s,predecessorhash:s,traceparent:l,tracestate:l,signature:c}),d=e=>{let t=e.headers.get(`Server`);return!(!t||!t.startsWith(`EventSourcingDB/`))},f=async function*(e,t){let n=e.getReader(),r=new TextDecoder(`utf-8`),i=``,a=()=>{n.cancel().catch(()=>{})};if(t.aborted){await n.cancel().catch(()=>{});return}t.addEventListener(`abort`,a);try{for(;!t.aborted;){let{done:e,value:t}=await n.read();if(e)break;i+=r.decode(t,{stream:!0});let a=i.indexOf(`
-`);for(;a!==-1;){let e=i.slice(0,a).trim();i=i.slice(a+1),e&&(yield JSON.parse(e)),a=i.indexOf(`
-`)}}}finally{t.removeEventListener(`abort`,a),await n.cancel().catch(()=>{})}},p=e=>o(e,{type:e=>e===`event`,payload:{specversion:s,id:s,time:s,source:s,subject:s,type:s,datacontenttype:s,data:a,hash:s,predecessorhash:s,traceparent:l,tracestate:l,signature:c}}),m=e=>o(e,{type:e=>e===`error`,payload:{error:s}}),h=e=>typeof e==`boolean`,g=e=>o(e,{type:e=>e===`eventType`,payload:{eventType:s,isPhantom:h}}),_=e=>o(e,{type:e=>e===`heartbeat`}),v=e=>o(e,{type:e=>e===`row`,payload:e=>e!==void 0}),y=e=>o(e,{type:e=>e===`subject`,payload:{subject:s}});var b=class{#e;#t;#n(e){return new URL(e,this.#e).toString()}constructor(e,t){this.#e=e,this.#t=t}async ping(){let e=this.#n(`/api/v1/ping`),t=await fetch(e,{method:`get`});if(!d(t))throw Error(`Server must be EventSourcingDB.`);if(t.status!==200)throw Error(`Failed to ping, got HTTP status code '${t.status}', expected '200'.`);let n=await t.json();if(!o(n,{type:s}))throw Error(`Failed to parse response.`);if(n.type!==`io.eventsourcingdb.api.ping-received`)throw Error(`Failed to ping.`)}async verifyApiToken(){let e=this.#n(`/api/v1/verify-api-token`),t=await fetch(e,{method:`post`,headers:{authorization:`Bearer ${this.#t}`}});if(!d(t))throw Error(`Server must be EventSourcingDB.`);if(t.status!==200)throw Error(`Failed to verify API token, got HTTP status code '${t.status}', expected '200'.`);let n=await t.json();if(!o(n,{type:s}))throw Error(`Failed to parse response.`);if(n.type!==`io.eventsourcingdb.api.api-token-verified`)throw Error(`Failed to verify API token.`)}async writeEvents(e,t=[]){let n=this.#n(`/api/v1/write-events`),r=await fetch(n,{method:`post`,headers:{authorization:`Bearer ${this.#t}`,"content-type":`application/json`},body:JSON.stringify({events:e,preconditions:t})});if(!d(r))throw Error(`Server must be EventSourcingDB.`);if(r.status!==200)throw Error(`Failed to write events, got HTTP status code '${r.status}', expected '200'.`);let a=await r.json();if(!Array.isArray(a))throw Error(`Failed to parse response.`);return a.map(e=>{if(!u(e))throw Error(`Failed to parse response item.`);return i(e)})}readEvents(e,t,n){let r=this.#n(`/api/v1/read-events`),a=this.#t;return(async function*(){let o=new AbortController,s=n??o.signal,c=!n,l;if(n&&!n.aborted){let e=()=>o.abort();n.addEventListener(`abort`,e,{once:!0}),l=()=>n.removeEventListener(`abort`,e)}try{let n=await fetch(r,{method:`post`,headers:{authorization:`Bearer ${a}`,"content-type":`application/json`},body:JSON.stringify({subject:e,options:t}),signal:s});if(!d(n)){let e=n.headers.get(`Server`);throw Error(e?`Server must be EventSourcingDB, got Server header: '${e}'.`:`Server must be EventSourcingDB, but Server header is missing.`)}if(n.status!==200)throw Error(`Failed to read events, got HTTP status code '${n.status}', expected '200'.`);if(!n.body)throw Error(`Failed to read events.`);for await(let e of f(n.body,s)){if(m(e))throw Error(`${e.payload.error}.`);if(p(e)){yield i(e.payload);continue}throw Error(`Failed to read events.`)}}catch(e){if(e instanceof DOMException&&e.name===`AbortError`)return;throw e}finally{l&&l(),c&&o.abort()}})()}runEventQlQuery(e,t){let n=this.#n(`/api/v1/run-eventql-query`),r=this.#t;return(async function*(){let i=new AbortController,a=t??i.signal,o=!t,s;if(t&&!t.aborted){let e=()=>i.abort();t.addEventListener(`abort`,e,{once:!0}),s=()=>t.removeEventListener(`abort`,e)}try{let t=await fetch(n,{method:`post`,headers:{authorization:`Bearer ${r}`,"content-type":`application/json`},body:JSON.stringify({query:e}),signal:a});if(!d(t)){let e=t.headers.get(`Server`);throw Error(e?`Server must be EventSourcingDB, got Server header: '${e}'.`:`Server must be EventSourcingDB, but Server header is missing.`)}if(t.status!==200)throw Error(`Failed to run EventQL query, got HTTP status code '${t.status}', expected '200'.`);if(!t.body)throw Error(`Failed to run EventQL query.`);for await(let e of f(t.body,a))if(!_(e)){if(m(e))throw Error(`${e.payload.error}.`);if(v(e)){yield e.payload;continue}throw Error(`Failed to run EventQL query.`)}}catch(e){if(e instanceof DOMException&&e.name===`AbortError`)return;throw e}finally{s&&s(),o&&i.abort()}})()}observeEvents(e,t,n){let r=this.#n(`/api/v1/observe-events`),a=this.#t;return(async function*(){let o=new AbortController,s=n??o.signal,c=!n,l;if(n&&!n.aborted){let e=()=>o.abort();n.addEventListener(`abort`,e,{once:!0}),l=()=>n.removeEventListener(`abort`,e)}try{let n=await fetch(r,{method:`post`,headers:{authorization:`Bearer ${a}`,"content-type":`application/json`},body:JSON.stringify({subject:e,options:t}),signal:s});if(!d(n)){let e=n.headers.get(`Server`);throw Error(e?`Server must be EventSourcingDB, got Server header: '${e}'.`:`Server must be EventSourcingDB, but Server header is missing.`)}if(n.status!==200)throw Error(`Failed to observe events, got HTTP status code '${n.status}', expected '200'.`);if(!n.body)throw Error(`Failed to observe events.`);for await(let e of f(n.body,s))if(!_(e)){if(m(e))throw Error(`${e.payload.error}.`);if(p(e)){yield i(e.payload);continue}throw Error(`Failed to observe events.`)}}catch(e){if(e instanceof DOMException&&e.name===`AbortError`)return;throw e}finally{l&&l(),c&&o.abort()}})()}async registerEventSchema(e,t){let n=this.#n(`/api/v1/register-event-schema`),r=await fetch(n,{method:`post`,headers:{authorization:`Bearer ${this.#t}`,"content-type":`application/json`},body:JSON.stringify({eventType:e,schema:t})});if(!d(r))throw Error(`Server must be EventSourcingDB.`);if(r.status!==200)throw Error(`Failed to register event schema, got HTTP status code '${r.status}', expected '200'.`)}readSubjects(e,t){let n=this.#n(`/api/v1/read-subjects`),r=this.#t;return(async function*(){let i=new AbortController,a=t??i.signal,o=!t,s;if(t&&!t.aborted){let e=()=>i.abort();t.addEventListener(`abort`,e,{once:!0}),s=()=>t.removeEventListener(`abort`,e)}try{let t=await fetch(n,{method:`post`,headers:{authorization:`Bearer ${r}`,"content-type":`application/json`},body:JSON.stringify({baseSubject:e}),signal:a});if(!d(t)){let e=t.headers.get(`Server`);throw Error(e?`Server must be EventSourcingDB, got Server header: '${e}'.`:`Server must be EventSourcingDB, but Server header is missing.`)}if(t.status!==200)throw Error(`Failed to read subjects, got HTTP status code '${t.status}', expected '200'.`);if(!t.body)throw Error(`Failed to read subjects.`);for await(let e of f(t.body,a)){if(m(e))throw Error(`${e.payload.error}.`);if(y(e)){yield e.payload.subject;continue}throw Error(`Failed to read subjects.`)}}catch(e){if(e instanceof DOMException&&e.name===`AbortError`)return;throw e}finally{s&&s(),o&&i.abort()}})()}async readEventType(e){let t=this.#n(`/api/v1/read-event-type`),n=await fetch(t,{method:`post`,headers:{authorization:`Bearer ${this.#t}`,"content-type":`application/json`},body:JSON.stringify({eventType:e})});if(!d(n))throw Error(`Server must be EventSourcingDB.`);if(n.status!==200)throw Error(`Failed to read event type, got HTTP status code '${n.status}', expected '200'.`);let r=await n.json();if(!o(r,{eventType:s,isPhantom:h}))throw Error(`Failed to parse response.`);return r}readEventTypes(e){let t=this.#n(`/api/v1/read-event-types`),n=this.#t;return(async function*(){let r=new AbortController,i=e??r.signal,a=!e,o;if(e&&!e.aborted){let t=()=>r.abort();e.addEventListener(`abort`,t,{once:!0}),o=()=>e.removeEventListener(`abort`,t)}try{let e=await fetch(t,{method:`post`,headers:{authorization:`Bearer ${n}`},signal:i});if(!d(e)){let t=e.headers.get(`Server`);throw Error(t?`Server must be EventSourcingDB, got Server header: '${t}'.`:`Server must be EventSourcingDB, but Server header is missing.`)}if(e.status!==200)throw Error(`Failed to read event types, got HTTP status code '${e.status}', expected '200'.`);if(!e.body)throw Error(`Failed to read event types.`);for await(let t of f(e.body,i))if(!_(t)){if(m(t))throw Error(`${t.payload.error}.`);if(g(t)){yield t.payload;continue}throw Error(`Failed to read event types.`)}}catch(e){if(e instanceof DOMException&&e.name===`AbortError`)return;throw e}finally{o&&o(),a&&r.abort()}})()}},x=class{#e=`thenativeweb/eventsourcingdb`;#t=`latest`;#n=3e3;#r=`secret`;#i;#a;withImageTag(e){return this.#t=e,this}withApiToken(e){return this.#r=e,this}withSigningKey(){let{privateKey:t}=e.generateKeyPairSync(`ed25519`);return this.#i=t,this}withPort(e){return this.#n=e,this}async start(){let e=[`run`,`--api-token`,this.#r,`--data-directory-temporary`,`--http-enabled`,`--https-enabled=false`],r=[];this.#i!==void 0&&(e.push(`--signing-key-file`),e.push(`/etc/esdb/signing-key.pem`),r.push({content:this.#i.export({format:`pem`,type:`pkcs8`}),target:`/etc/esdb/signing-key.pem`,mode:511})),this.#a=await new t(`${this.#e}:${this.#t}`).withExposedPorts(this.#n).withCommand(e).withCopyContentToContainer(r).withWaitStrategy(n.forHttp(`/api/v1/ping`,this.#n).withStartupTimeout(1e4)).start()}getHost(){if(this.#a===void 0)throw Error(`Container must be running.`);return this.#a.getHost()}getMappedPort(){if(this.#a===void 0)throw Error(`Container must be running.`);return this.#a.getMappedPort(this.#n)}getBaseUrl(){if(this.#a===void 0)throw Error(`Container must be running.`);let e=this.getHost(),t=this.getMappedPort();return new URL(`http://${e}:${t}`)}getApiToken(){return this.#r}getSigningKey(){if(this.#i===void 0)throw Error(`Signing key not set.`);return this.#i}getVerificationKey(){if(this.#i===void 0)throw Error(`Signing key not set.`);return e.createPublicKey(this.#i)}isRunning(){return this.#a!==void 0}async stop(){this.#a!==void 0&&(await this.#a.stop(),this.#a=void 0)}getClient(){return new b(this.getBaseUrl(),this.getApiToken())}};const S=e=>({type:`isEventQlQueryTrue`,payload:{query:e}}),C=(e,t)=>({type:`isSubjectOnEventId`,payload:{subject:e,eventId:t}}),w=e=>({type:`isSubjectPopulated`,payload:{subject:e}}),T=e=>({type:`isSubjectPristine`,payload:{subject:e}});export{b as Client,x as Container,S as isEventQlQueryTrue,C as isSubjectOnEventId,w as isSubjectPopulated,T as isSubjectPristine};