@cratis/chronicle 0.0.1 → 0.2.0

package/dist/webhooks/WebhookDefinitionBuilder.js

@@ -0,0 +1,122 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import { getEventTypeFor } from '../events/eventTypeDecorator';
+import { EventSequenceId } from '../eventSequences/EventSequenceId';
+/**
+ * Implements {@link IWebhookDefinitionBuilder}.
+ */
+export class WebhookDefinitionBuilder {
+    _registeredEventTypes;
+    _eventTypes = new Set();
+    _headers = new Map();
+    _eventSequenceId = EventSequenceId.eventLog.value;
+    _authorization;
+    _isReplayable = true;
+    _isActive = true;
+    /**
+     * Creates a new builder.
+     * @param _registeredEventTypes - Registered event types.
+     */
+    constructor(_registeredEventTypes) {
+        this._registeredEventTypes = _registeredEventTypes;
+    }
+    /** @inheritdoc */
+    onEventSequence(eventSequenceId) {
+        this._eventSequenceId = eventSequenceId.value;
+        return this;
+    }
+    /** @inheritdoc */
+    withBasicAuth(username, password) {
+        const value = {
+            Username: username,
+            Password: password
+        };
+        this._authorization = {
+            Value0: value,
+            Value1: undefined,
+            Value2: undefined
+        };
+        return this;
+    }
+    /** @inheritdoc */
+    withBearerToken(token) {
+        const value = { Token: token };
+        this._authorization = {
+            Value0: undefined,
+            Value1: value,
+            Value2: undefined
+        };
+        return this;
+    }
+    /** @inheritdoc */
+    withOAuth(authority, clientId, clientSecret) {
+        const value = {
+            Authority: authority,
+            ClientId: clientId,
+            ClientSecret: clientSecret
+        };
+        this._authorization = {
+            Value0: undefined,
+            Value1: undefined,
+            Value2: value
+        };
+        return this;
+    }
+    /** @inheritdoc */
+    withHeader(key, value) {
+        this._headers.set(key, value);
+        return this;
+    }
+    /** @inheritdoc */
+    withEventType(eventType) {
+        this._eventTypes.add(eventType);
+        return this;
+    }
+    /** @inheritdoc */
+    notReplayable() {
+        this._isReplayable = false;
+        return this;
+    }
+    /** @inheritdoc */
+    notActive() {
+        this._isActive = false;
+        return this;
+    }
+    /**
+     * Builds a webhook definition.
+     * When no event types are explicitly configured, all registered event types are used.
+     * @param id - Webhook identifier.
+     * @param targetUrl - Webhook target URL.
+     * @returns A contract webhook definition.
+     */
+    build(id, targetUrl) {
+        if (!targetUrl.value) {
+            throw new Error(`Webhook '${id.value}' has an empty target URL.`);
+        }
+        const selectedEventTypes = this._eventTypes.size > 0 ? [...this._eventTypes] : this._registeredEventTypes.all;
+        const eventTypes = selectedEventTypes.map(type => {
+            const metadata = getEventTypeFor(type);
+            if (metadata.id.value === '00000000-0000-0000-0000-000000000000') {
+                throw new Error(`Event type '${type.name}' has an invalid or uninitialized event type id.`);
+            }
+            return {
+                Id: metadata.id.value,
+                Generation: metadata.generation.value,
+                Tombstone: false
+            };
+        });
+        return {
+            EventSequenceId: this._eventSequenceId,
+            Identifier: id.value,
+            EventTypes: eventTypes,
+            Target: {
+                Url: targetUrl.value,
+                Authorization: this._authorization,
+                Headers: Object.fromEntries(this._headers)
+            },
+            IsReplayable: this._isReplayable,
+            IsActive: this._isActive
+        };
+    }
+}
+//# sourceMappingURL=WebhookDefinitionBuilder.js.map

package/dist/webhooks/WebhookDefinitionBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookDefinitionBuilder.js","sourceRoot":"","sources":["../../webhooks/WebhookDefinitionBuilder.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAWrG,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAKpE;;GAEG;AACH,MAAM,OAAO,wBAAwB;IAYJ;IAXZ,WAAW,GAAG,IAAI,GAAG,EAAe,CAAC;IACrC,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,gBAAgB,GAAG,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC;IAClD,cAAc,CAAgF;IAC9F,aAAa,GAAG,IAAI,CAAC;IACrB,SAAS,GAAG,IAAI,CAAC;IAEzB;;;OAGG;IACH,YAA6B,qBAAkC;QAAlC,0BAAqB,GAArB,qBAAqB,CAAa;IAAG,CAAC;IAEnE,kBAAkB;IAClB,eAAe,CAAC,eAAgC;QAC5C,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAC,KAAK,CAAC;QAC9C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,kBAAkB;IAClB,aAAa,CAAC,QAAgB,EAAE,QAAgB;QAC5C,MAAM,KAAK,GAAuB;YAC9B,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,QAAQ;SACrB,CAAC;QACF,IAAI,CAAC,cAAc,GAAG;YAClB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,SAAS;SACpB,CAAC;QACF,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,kBAAkB;IAClB,eAAe,CAAC,KAAa;QACzB,MAAM,KAAK,GAA6B,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACzD,IAAI,CAAC,cAAc,GAAG;YAClB,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,SAAS;SACpB,CAAC;QACF,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,kBAAkB;IAClB,SAAS,CAAC,SAAiB,EAAE,QAAgB,EAAE,YAAoB;QAC/D,MAAM,KAAK,GAAuB;YAC9B,SAAS,EAAE,SAAS;YACpB,QAAQ,EAAE,QAAQ;YAClB,YAAY,EAAE,YAAY;SAC7B,CAAC;QACF,IAAI,CAAC,cAAc,GAAG;YAClB,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,KAAK;SAChB,CAAC;QACF,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,kBAAkB;IAClB,UAAU,CAAC,GAAW,EAAE,KAAa;QACjC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,kBAAkB;IAClB,aAAa,CAAC,SAAsB;QAChC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,kBAAkB;IAClB,aAAa;QACT,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,kBAAkB;IAClB,SAAS;QACL,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,EAAa,EAAE,SAA2B;QAC5C,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC,KAAK,4BAA4B,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,kBAAkB,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC;QAC9G,MAAM,UAAU,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YAC7C,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,QAAQ,CAAC,EAAE,CAAC,KAAK,KAAK,sCAAsC,EAAE,CAAC;gBAC/D,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,IAAI,kDAAkD,CAAC,CAAC;YAChG,CAAC;YACD,OAAO;gBACH,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK;gBACrB,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK;gBACrC,SAAS,EAAE,KAAK;aACnB,CAAC;QACN,CAAC,CAAC,CAAC;QAEH,OAAO;YACH,eAAe,EAAE,IAAI,CAAC,gBAAgB;YACtC,UAAU,EAAE,EAAE,CAAC,KAAK;YACpB,UAAU,EAAE,UAAU;YACtB,MAAM,EAAE;gBACJ,GAAG,EAAE,SAAS,CAAC,KAAK;gBACpB,aAAa,EAAE,IAAI,CAAC,cAAc;gBAClC,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC;aAC7C;YACD,YAAY,EAAE,IAAI,CAAC,aAAa;YAChC,QAAQ,EAAE,IAAI,CAAC,SAAS;SAC3B,CAAC;IACN,CAAC;CACJ"}

package/dist/webhooks/WebhookId.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Represents the unique identifier of a webhook.
+ */
+export declare class WebhookId {
+    readonly value: string;
+    constructor(value: string);
+    /** @inheritdoc */
+    toString(): string;
+}
+//# sourceMappingURL=WebhookId.d.ts.map

package/dist/webhooks/WebhookId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookId.d.ts","sourceRoot":"","sources":["../../webhooks/WebhookId.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,SAAS;IACN,QAAQ,CAAC,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;IAElC,kBAAkB;IAClB,QAAQ,IAAI,MAAM;CAGrB"}

package/dist/webhooks/WebhookId.js

@@ -0,0 +1,16 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Represents the unique identifier of a webhook.
+ */
+export class WebhookId {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    /** @inheritdoc */
+    toString() {
+        return this.value;
+    }
+}
+//# sourceMappingURL=WebhookId.js.map

package/dist/webhooks/WebhookId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookId.js","sourceRoot":"","sources":["../../webhooks/WebhookId.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG;;GAEG;AACH,MAAM,OAAO,SAAS;IACG;IAArB,YAAqB,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAEtC,kBAAkB;IAClB,QAAQ;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;CACJ"}

package/dist/webhooks/WebhookTargetUrl.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Represents the target URL for a webhook.
+ */
+export declare class WebhookTargetUrl {
+    readonly value: string;
+    constructor(value: string);
+    /** @inheritdoc */
+    toString(): string;
+}
+//# sourceMappingURL=WebhookTargetUrl.d.ts.map

package/dist/webhooks/WebhookTargetUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookTargetUrl.d.ts","sourceRoot":"","sources":["../../webhooks/WebhookTargetUrl.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,gBAAgB;IACb,QAAQ,CAAC,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;IAElC,kBAAkB;IAClB,QAAQ,IAAI,MAAM;CAGrB"}

package/dist/webhooks/WebhookTargetUrl.js

@@ -0,0 +1,16 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Represents the target URL for a webhook.
+ */
+export class WebhookTargetUrl {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    /** @inheritdoc */
+    toString() {
+        return this.value;
+    }
+}
+//# sourceMappingURL=WebhookTargetUrl.js.map

package/dist/webhooks/WebhookTargetUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookTargetUrl.js","sourceRoot":"","sources":["../../webhooks/WebhookTargetUrl.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACJ;IAArB,YAAqB,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAEtC,kBAAkB;IAClB,QAAQ;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;CACJ"}

package/dist/webhooks/Webhooks.d.ts

@@ -0,0 +1,38 @@
+import { type WebhookDefinition } from '@cratis/chronicle.contracts';
+import { IClientArtifactsProvider } from '../artifacts';
+import { ChronicleConnection } from '../connection';
+import { IEventTypes } from '../events/IEventTypes';
+import { IWebhookDefinitionBuilder } from './IWebhookDefinitionBuilder';
+import { IWebhooks } from './IWebhooks';
+import { WebhookId } from './WebhookId';
+import { WebhookTargetUrl } from './WebhookTargetUrl';
+/**
+ * Implements {@link IWebhooks}.
+ */
+export declare class Webhooks implements IWebhooks {
+    private readonly _eventStore;
+    private readonly _connection;
+    private readonly _eventTypes;
+    private readonly _clientArtifacts;
+    private readonly _discovered;
+    /**
+     * Creates a new {@link Webhooks} instance.
+     * @param _eventStore - Event store name.
+     * @param _connection - Chronicle connection.
+     * @param _eventTypes - Event types manager.
+     * @param _clientArtifacts - Client artifacts provider.
+     */
+    constructor(_eventStore: string, _connection: ChronicleConnection, _eventTypes: IEventTypes, _clientArtifacts: IClientArtifactsProvider);
+    /** @inheritdoc */
+    discover(): Promise<void>;
+    /** @inheritdoc */
+    registerDiscovered(): Promise<void>;
+    /** @inheritdoc */
+    register(webhookId: WebhookId | string, targetUrl: WebhookTargetUrl | string, configure: (builder: IWebhookDefinitionBuilder) => void): Promise<void>;
+    /** @inheritdoc */
+    getWebhooks(): Promise<WebhookDefinition[]>;
+    /** @inheritdoc */
+    remove(webhookId: WebhookId | string): Promise<void>;
+    private buildDefinition;
+}
+//# sourceMappingURL=Webhooks.d.ts.map

package/dist/webhooks/Webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Webhooks.d.ts","sourceRoot":"","sources":["../../webhooks/Webhooks.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEpF,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD;;GAEG;AACH,qBAAa,QAAS,YAAW,SAAS;IAWlC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAbrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwC;IAEpE;;;;;;OAMG;gBAEkB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,mBAAmB,EAChC,WAAW,EAAE,WAAW,EACxB,gBAAgB,EAAE,wBAAwB;IAG/D,kBAAkB;IACZ,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAa/B,kBAAkB;IACZ,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBzC,kBAAkB;IACZ,QAAQ,CACV,SAAS,EAAE,SAAS,GAAG,MAAM,EAC7B,SAAS,EAAE,gBAAgB,GAAG,MAAM,EACpC,SAAS,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,IAAI,GACxD,OAAO,CAAC,IAAI,CAAC;IAehB,kBAAkB;IACZ,WAAW,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAKjD,kBAAkB;IACZ,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1D,OAAO,CAAC,eAAe;CAqB1B"}

package/dist/webhooks/Webhooks.js

@@ -0,0 +1,92 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import { ObserverOwner } from '@cratis/chronicle.contracts';
+import { EventSequenceId } from '../eventSequences/EventSequenceId';
+import { WebhookDefinitionBuilder } from './WebhookDefinitionBuilder';
+import { WebhookId } from './WebhookId';
+import { WebhookTargetUrl } from './WebhookTargetUrl';
+import { getWebhookMetadata } from './webhook';
+/**
+ * Implements {@link IWebhooks}.
+ */
+export class Webhooks {
+    _eventStore;
+    _connection;
+    _eventTypes;
+    _clientArtifacts;
+    _discovered = new Map();
+    /**
+     * Creates a new {@link Webhooks} instance.
+     * @param _eventStore - Event store name.
+     * @param _connection - Chronicle connection.
+     * @param _eventTypes - Event types manager.
+     * @param _clientArtifacts - Client artifacts provider.
+     */
+    constructor(_eventStore, _connection, _eventTypes, _clientArtifacts) {
+        this._eventStore = _eventStore;
+        this._connection = _connection;
+        this._eventTypes = _eventTypes;
+        this._clientArtifacts = _clientArtifacts;
+    }
+    /** @inheritdoc */
+    async discover() {
+        this._discovered.clear();
+        for (const type of this._clientArtifacts.webhooks) {
+            const metadata = getWebhookMetadata(type);
+            if (!metadata) {
+                continue;
+            }
+            const definition = this.buildDefinition(type, metadata.id, metadata.targetUrl, undefined, metadata.eventSequenceId);
+            this._discovered.set(metadata.id.value, definition);
+        }
+    }
+    /** @inheritdoc */
+    async registerDiscovered() {
+        if (this._discovered.size === 0) {
+            await this.discover();
+        }
+        if (this._discovered.size === 0) {
+            return;
+        }
+        await this._connection.webhooks.add({
+            EventStore: this._eventStore,
+            Owner: ObserverOwner.Client,
+            Webhooks: [...this._discovered.values()]
+        });
+    }
+    /** @inheritdoc */
+    async register(webhookId, targetUrl, configure) {
+        const definition = this.buildDefinition(undefined, typeof webhookId === 'string' ? new WebhookId(webhookId) : webhookId, typeof targetUrl === 'string' ? new WebhookTargetUrl(targetUrl) : targetUrl, configure);
+        await this._connection.webhooks.add({
+            EventStore: this._eventStore,
+            Owner: ObserverOwner.Client,
+            Webhooks: [definition]
+        });
+    }
+    /** @inheritdoc */
+    async getWebhooks() {
+        const response = await this._connection.webhooks.getWebhooks({ EventStore: this._eventStore });
+        return response.items ?? [];
+    }
+    /** @inheritdoc */
+    async remove(webhookId) {
+        const id = typeof webhookId === 'string' ? webhookId : webhookId.value;
+        await this._connection.webhooks.remove({
+            EventStore: this._eventStore,
+            Webhooks: [id]
+        });
+    }
+    buildDefinition(type, id, targetUrl, configure, eventSequenceId) {
+        const builder = new WebhookDefinitionBuilder(this._eventTypes);
+        configure?.(builder);
+        if (type) {
+            const instance = new type();
+            instance.define(builder);
+        }
+        if (eventSequenceId) {
+            builder.onEventSequence(new EventSequenceId(eventSequenceId));
+        }
+        return builder.build(id, targetUrl);
+    }
+}
+//# sourceMappingURL=Webhooks.js.map

package/dist/webhooks/Webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Webhooks.js","sourceRoot":"","sources":["../../webhooks/Webhooks.ts"],"names":[],"mappings":"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"}

package/dist/webhooks/index.d.ts

@@ -0,0 +1,10 @@
+export { WebhookId } from './WebhookId';
+export { WebhookTargetUrl } from './WebhookTargetUrl';
+export { webhook, getWebhookMetadata, isWebhook } from './webhook';
+export type { WebhookMetadata } from './webhook';
+export type { IWebhook } from './IWebhook';
+export type { IWebhookDefinitionBuilder } from './IWebhookDefinitionBuilder';
+export type { IWebhooks } from './IWebhooks';
+export { WebhookDefinitionBuilder } from './WebhookDefinitionBuilder';
+export { Webhooks } from './Webhooks';
+//# sourceMappingURL=index.d.ts.map

package/dist/webhooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../webhooks/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAC7E,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/webhooks/index.js

@@ -0,0 +1,8 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export { WebhookId } from './WebhookId';
+export { WebhookTargetUrl } from './WebhookTargetUrl';
+export { webhook, getWebhookMetadata, isWebhook } from './webhook';
+export { WebhookDefinitionBuilder } from './WebhookDefinitionBuilder';
+export { Webhooks } from './Webhooks';
+//# sourceMappingURL=index.js.map

package/dist/webhooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../webhooks/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAKnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/webhooks/webhook.d.ts

@@ -0,0 +1,41 @@
+import 'reflect-metadata';
+import { WebhookId } from './WebhookId';
+import { WebhookTargetUrl } from './WebhookTargetUrl';
+/**
+ * Metadata stored on a webhook class.
+ */
+export interface WebhookMetadata {
+    /** The webhook identifier. */
+    readonly id: WebhookId;
+    /** The webhook target URL. */
+    readonly targetUrl: WebhookTargetUrl;
+    /** Optional explicit event sequence id. */
+    readonly eventSequenceId: string | undefined;
+}
+/**
+ * TypeScript decorator that marks a class as a discoverable webhook.
+ * Overloads:
+ * - `@webhook(targetUrl)` -> class name is used as identifier.
+ * - `@webhook(id, targetUrl)` -> explicit identifier.
+ * - `@webhook(id, targetUrl, eventSequenceId)` -> explicit identifier and event sequence.
+ * @param idOrTargetUrl - The webhook identifier or target URL.
+ * @param targetUrlOrUndefined - The webhook target URL when id is provided.
+ * @param eventSequenceId - Optional event sequence identifier.
+ * @returns A class decorator.
+ */
+export declare function webhook(targetUrl: string): ClassDecorator;
+export declare function webhook(id: string, targetUrl: string): ClassDecorator;
+export declare function webhook(id: string, targetUrl: string, eventSequenceId: string): ClassDecorator;
+/**
+ * Gets webhook metadata from a webhook class.
+ * @param target - The class constructor.
+ * @returns The metadata, if any.
+ */
+export declare function getWebhookMetadata(target: Function): WebhookMetadata | undefined;
+/**
+ * Checks whether a class has webhook metadata.
+ * @param target - The class constructor.
+ * @returns True when decorated as webhook.
+ */
+export declare function isWebhook(target: Function): boolean;
+//# sourceMappingURL=webhook.d.ts.map

package/dist/webhooks/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../webhooks/webhook.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAC;AAG1B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAKtD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IAEvB,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IAErC,2CAA2C;IAC3C,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CAChD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAAC;AAC3D,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,CAAC;AACvE,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,cAAc,CAAC;AA2BhG;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,GAAG,eAAe,GAAG,SAAS,CAEhF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAEnD"}

package/dist/webhooks/webhook.js

@@ -0,0 +1,44 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import 'reflect-metadata';
+import { DecoratorType, TypeDiscoverer } from '../types';
+import { WebhookId } from './WebhookId';
+import { WebhookTargetUrl } from './WebhookTargetUrl';
+/** Metadata key used to store webhook information on a class. */
+const WEBHOOK_METADATA_KEY = 'chronicle:webhook';
+export function webhook(idOrTargetUrl, targetUrlOrUndefined, eventSequenceId) {
+    return (target) => {
+        const hasExplicitId = targetUrlOrUndefined !== undefined;
+        const explicitId = hasExplicitId ? idOrTargetUrl : undefined;
+        const resolvedTargetUrl = hasExplicitId ? targetUrlOrUndefined : idOrTargetUrl;
+        if (!resolvedTargetUrl) {
+            throw new Error('A webhook targetUrl must be a non-empty string for @webhook.');
+        }
+        const constructor = target;
+        const webhookId = new WebhookId(explicitId ?? constructor.name);
+        const metadata = {
+            id: webhookId,
+            targetUrl: new WebhookTargetUrl(resolvedTargetUrl),
+            eventSequenceId
+        };
+        Reflect.defineMetadata(WEBHOOK_METADATA_KEY, metadata, target);
+        TypeDiscoverer.default.register(DecoratorType.Webhook, constructor, webhookId.value);
+    };
+}
+/**
+ * Gets webhook metadata from a webhook class.
+ * @param target - The class constructor.
+ * @returns The metadata, if any.
+ */
+export function getWebhookMetadata(target) {
+    return Reflect.getMetadata(WEBHOOK_METADATA_KEY, target);
+}
+/**
+ * Checks whether a class has webhook metadata.
+ * @param target - The class constructor.
+ * @returns True when decorated as webhook.
+ */
+export function isWebhook(target) {
+    return Reflect.hasMetadata(WEBHOOK_METADATA_KEY, target);
+}
+//# sourceMappingURL=webhook.js.map

package/dist/webhooks/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../webhooks/webhook.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,iEAAiE;AACjE,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AA8BjD,MAAM,UAAU,OAAO,CAAC,aAAqB,EAAE,oBAA6B,EAAE,eAAwB;IAClG,OAAO,CAAC,MAAc,EAAE,EAAE;QACtB,MAAM,aAAa,GAAG,oBAAoB,KAAK,SAAS,CAAC;QACzD,MAAM,UAAU,GAAG,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7D,MAAM,iBAAiB,GAAG,aAAa,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,aAAa,CAAC;QAE/E,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,WAAW,GAAG,MAAkB,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,UAAU,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;QAChE,MAAM,QAAQ,GAAoB;YAC9B,EAAE,EAAE,SAAS;YACb,SAAS,EAAE,IAAI,gBAAgB,CAAC,iBAAiB,CAAC;YAClD,eAAe;SAClB,CAAC;QACF,OAAO,CAAC,cAAc,CAAC,oBAAoB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/D,cAAc,CAAC,OAAO,CAAC,QAAQ,CAC3B,aAAa,CAAC,OAAO,EACrB,WAA0B,EAC1B,SAAS,CAAC,KAAK,CAClB,CAAC;IACN,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAgB;IAC/C,OAAO,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAAgB;IACtC,OAAO,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC"}

package/eventSequences/AppendOptions.ts

@@ -0,0 +1,19 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { Guid } from '@cratis/fundamentals';
+import type { ConcurrencyScope } from './ConcurrencyScope';
+
+/**
+ * Options for appending an event to an event sequence.
+ */
+export interface AppendOptions {
+    /** Optional correlation identifier for tracking the append operation. */
+    correlationId?: string | Guid;
+
+    /** Optional explicit sequence number to use for the event. */
+    eventSourceId?: string;
+
+    /** Optional concurrency scope to use for append operations. */
+    concurrencyScope?: ConcurrencyScope;
+}

package/eventSequences/ConcurrencyScope.ts

@@ -0,0 +1,27 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { EventType } from '../events';
+
+/**
+ * Represents a concurrency scope for append operations.
+ */
+export interface ConcurrencyScope {
+    /** The expected sequence number used for concurrency validation. */
+    sequenceNumber: bigint;
+
+    /** Whether to include event source identifier as part of the scope. */
+    eventSourceId?: boolean;
+
+    /** Optional event stream type to scope to. */
+    eventStreamType?: string;
+
+    /** Optional event stream identifier to scope to. */
+    eventStreamId?: string;
+
+    /** Optional event source type to scope to. */
+    eventSourceType?: string;
+
+    /** Optional event types to scope to. */
+    eventTypes?: EventType[];
+}

package/eventSequences/EventForEventSourceId.ts

@@ -0,0 +1,13 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * Represents an event paired with the event source identifier it belongs to.
+ */
+export interface EventForEventSourceId {
+    /** The event source identifier for the event. */
+    readonly eventSourceId: string;
+
+    /** The event payload to append. */
+    readonly event: object;
+}

package/eventSequences/EventLog.ts

@@ -0,0 +1,23 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { ChronicleConnection } from '../connection';
+import { EventSequence } from './EventSequence';
+import { EventSequenceId } from './EventSequenceId';
+import { IEventLog } from './IEventLog';
+import { IUnitOfWorkManager } from '../transactions/IUnitOfWorkManager';
+
+/**
+ * Implements {@link IEventLog} by extending the base {@link EventSequence}.
+ * The event log is the default event sequence used for all domain events.
+ */
+export class EventLog extends EventSequence implements IEventLog {
+    constructor(
+        eventStoreName: string,
+        namespace: string,
+        connection: ChronicleConnection,
+        unitOfWorkManager: IUnitOfWorkManager
+    ) {
+        super(EventSequenceId.eventLog, eventStoreName, namespace, connection, unitOfWorkManager);
+    }
+}