@cratis/chronicle 0.0.1

package/dist/ChronicleClient.js

@@ -0,0 +1,396 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import { diag } from '@opentelemetry/api';
+import { SpanStatusCode } from '@opentelemetry/api';
+import { ChronicleConnection } from './connection';
+import { ConnectionLifecycle } from './connection/ConnectionLifecycle';
+import { EventStore } from './EventStore';
+import { EventStoreName } from './EventStoreName';
+import { EventStoreNamespaceName } from './EventStoreNamespaceName';
+import { ChronicleMetrics } from './Metrics';
+import { ChronicleTracer } from './Tracing';
+import { TypeDiscoverer } from './types';
+/**
+ * Implements {@link IChronicleClient} by managing a gRPC connection to the
+ * Chronicle Kernel via {@link ChronicleConnection}.
+ *
+ * Create a client by providing {@link ChronicleOptions} configured with a connection string:
+ *
+ * ```typescript
+ * const client = new ChronicleClient(ChronicleOptions.fromConnectionString('chronicle://localhost:35000'));
+ * const store = await client.getEventStore('MyStore');
+ * await store.eventLog.append('my-entity-id', new MyEvent('data'));
+ * client.dispose();
+ * ```
+ */
+export class ChronicleClient {
+    options;
+    static _healthCheckIntervalMs = 5000;
+    _connection;
+    _stores = new Map();
+    _lifecycle = new ConnectionLifecycle();
+    _logger = diag.createComponentLogger({
+        namespace: '@cratis/chronicle/ChronicleClient'
+    });
+    _watchdogHandle;
+    _connectOperation;
+    _reconnectOperation;
+    _discoveryOperation;
+    _isDisposed = false;
+    _keepAliveAbortController;
+    /**
+     * Creates a new {@link ChronicleClient} using the provided options.
+     * @param options - The options to configure the client, including the connection string.
+     */
+    constructor(options) {
+        this.options = options;
+        // When TLS is disabled, pass pre-built insecure credentials directly.
+        // @cratis/chronicle.contracts ≤15.24.3 always composes call credentials with
+        // channel credentials, which gRPC forbids for insecure channels. Passing
+        // credentials explicitly bypasses that code path. Remove once a fixed version
+        // of chronicle.contracts is released.
+        const connectionOptions = options.connectionString.disableTls
+            ? { connectionString: options.connectionString, credentials: options.connectionString.createCredentials() }
+            : { connectionString: options.connectionString };
+        this._connection = new ChronicleConnection(connectionOptions);
+        this._logger.info('Created Chronicle client', {
+            serverAddress: `${options.connectionString.serverAddress.host}:${options.connectionString.serverAddress.port}`,
+            disableTls: options.connectionString.disableTls
+        });
+        if (options.discoveryPatterns.length > 0) {
+            this._discoveryOperation = TypeDiscoverer.default.discover(options.discoveryPatterns);
+            this._discoveryOperation.catch(error => {
+                this._logger.error('Artifact file discovery failed', { error: String(error) });
+            });
+        }
+        this._lifecycle.onConnected(async () => {
+            if (this._stores.size === 0) {
+                this._logger.debug('No event stores cached; nothing to register on connected lifecycle callback', {
+                    connectionId: this._lifecycle.connectionId
+                });
+                return;
+            }
+            this._logger.info('Connection lifecycle connected; registering artifacts for cached event stores', {
+                connectionId: this._lifecycle.connectionId,
+                eventStoreCount: this._stores.size
+            });
+            await Promise.all([...this._stores.values()].map(store => this.registerArtifactsForStore(store, 'connected')));
+        });
+        this._lifecycle.onDisconnected(async () => {
+            this._logger.warn('Connection lifecycle disconnected', {
+                connectionId: this._lifecycle.connectionId
+            });
+        });
+        this.startConnectionWatchdog();
+    }
+    /** @inheritdoc */
+    async getEventStore(name, namespace) {
+        const storeName = typeof name === 'string' ? new EventStoreName(name) : name;
+        const namespaceName = namespace === undefined
+            ? EventStoreNamespaceName.default
+            : typeof namespace === 'string'
+                ? new EventStoreNamespaceName(namespace)
+                : namespace;
+        return ChronicleTracer.startActiveSpan('chronicle.client.get_event_store', async (span) => {
+            span.setAttribute('chronicle.event_store', storeName.value);
+            span.setAttribute('chronicle.namespace', namespaceName.value);
+            try {
+                const store = await this.withReconnect('get_event_store', async () => {
+                    await this.ensureConnected();
+                    const key = `${storeName.value}/${namespaceName.value}`;
+                    const existing = this._stores.get(key);
+                    if (existing) {
+                        this._logger.verbose('Returning cached event store', {
+                            eventStore: storeName.value,
+                            namespace: namespaceName.value
+                        });
+                        return existing;
+                    }
+                    this._logger.debug('Ensuring event store exists in kernel', {
+                        eventStore: storeName.value
+                    });
+                    await this._connection.eventStores.ensure({ Name: storeName.value });
+                    const created = new EventStore(storeName, namespaceName, this._connection, this._lifecycle);
+                    this._stores.set(key, created);
+                    await this.registerArtifactsForStore(created, 'new-store');
+                    return created;
+                });
+                ChronicleMetrics.eventStoreRetrievals.add(1, {
+                    'chronicle.event_store': storeName.value,
+                    'chronicle.namespace': namespaceName.value
+                });
+                span.setStatus({ code: SpanStatusCode.OK });
+                return store;
+            }
+            catch (error) {
+                span.setStatus({ code: SpanStatusCode.ERROR, message: String(error) });
+                span.recordException(error);
+                this._logger.error('Failed getting event store', {
+                    eventStore: storeName.value,
+                    namespace: namespaceName.value,
+                    error: this.toErrorMessage(error)
+                });
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
+    }
+    /** @inheritdoc */
+    async getEventStores() {
+        return ChronicleTracer.startActiveSpan('chronicle.client.get_event_stores', async (span) => {
+            try {
+                const response = await this.withReconnect('get_event_stores', async () => {
+                    await this.ensureConnected();
+                    return this._connection.eventStores.getEventStores({});
+                });
+                const result = (response.items ?? []).map((name) => new EventStoreName(name));
+                this._logger.verbose('Retrieved event stores from kernel', {
+                    count: result.length
+                });
+                span.setStatus({ code: SpanStatusCode.OK });
+                return result;
+            }
+            catch (error) {
+                span.setStatus({ code: SpanStatusCode.ERROR, message: String(error) });
+                span.recordException(error);
+                this._logger.error('Failed retrieving event stores', {
+                    error: this.toErrorMessage(error)
+                });
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        });
+    }
+    /** @inheritdoc */
+    dispose() {
+        this._isDisposed = true;
+        if (this._watchdogHandle) {
+            clearInterval(this._watchdogHandle);
+            this._watchdogHandle = undefined;
+        }
+        if (this._lifecycle.isConnected) {
+            void this._lifecycle.disconnected(error => {
+                this._logger.error('Disconnected lifecycle callback failed during dispose', {
+                    error: this.toErrorMessage(error)
+                });
+            });
+        }
+        this._keepAliveAbortController?.abort();
+        this._keepAliveAbortController = undefined;
+        this._connection.disconnect();
+        this._logger.info('Disposed Chronicle client');
+    }
+    async connectWithRetry() {
+        let attempt = 0;
+        while (!this._isDisposed) {
+            try {
+                if (attempt > 0) {
+                    // Recreate the gRPC channel so we start from IDLE. A failed
+                    // probe can leave the channel in TRANSIENT_FAILURE, which gRPC
+                    // won't recover without a fresh channel. The contracts connect()
+                    // is also bypassed here — it uses watchConnectivityState and
+                    // rejects as soon as the state changes to CONNECTING (not READY),
+                    // making it unreliable for initial connection establishment.
+                    this._connection.resetChannel();
+                }
+                this._logger.debug('Connecting to Chronicle kernel', { attempt: attempt + 1 });
+                // Probe with a real RPC call. gRPC connects lazily on the first call,
+                // so this effectively waits until the channel reaches READY or fails.
+                await this._connection.server.getVersionInfo({}, { signal: AbortSignal.timeout(10_000) });
+                this._logger.info('Connected to Chronicle kernel');
+                await this.startKernelKeepAlive();
+                await this._lifecycle.connected(error => {
+                    this._logger.error('Connected lifecycle callback failed', {
+                        error: this.toErrorMessage(error)
+                    });
+                });
+                return;
+            }
+            catch (error) {
+                attempt++;
+                const delayMs = Math.min(1000 * Math.pow(2, attempt - 1), 30_000);
+                this._logger.warn('Connection attempt failed, retrying', {
+                    attempt,
+                    delayMs,
+                    error: this.toErrorMessage(error)
+                });
+                await new Promise(resolve => setTimeout(resolve, delayMs));
+            }
+        }
+        throw new Error('ChronicleClient was disposed during connection attempt.');
+    }
+    async ensureConnected() {
+        if (this._isDisposed) {
+            throw new Error('ChronicleClient is disposed. Create a new client instance before making calls.');
+        }
+        if (this._lifecycle.isConnected) {
+            return;
+        }
+        if (!this._connectOperation) {
+            this._connectOperation = this.connectWithRetry().finally(() => {
+                this._connectOperation = undefined;
+            });
+        }
+        await this._connectOperation;
+    }
+    async reconnect(reason, error) {
+        if (!this._reconnectOperation) {
+            this._reconnectOperation = (async () => {
+                this._logger.warn('Reconnecting to Chronicle kernel', {
+                    reason,
+                    error: this.toErrorMessage(error)
+                });
+                if (this._lifecycle.isConnected) {
+                    await this._lifecycle.disconnected(disconnectError => {
+                        this._logger.error('Disconnected lifecycle callback failed', {
+                            error: this.toErrorMessage(disconnectError)
+                        });
+                    });
+                }
+                let attempt = 0;
+                while (!this._isDisposed) {
+                    try {
+                        this._connection.resetChannel();
+                        await this._connection.server.getVersionInfo({}, { signal: AbortSignal.timeout(10_000) });
+                        this._logger.info('Reconnected to Chronicle kernel', { attempt: attempt + 1 });
+                        await this.startKernelKeepAlive();
+                        await this._lifecycle.connected(connectedError => {
+                            this._logger.error('Connected lifecycle callback failed after reconnect', {
+                                error: this.toErrorMessage(connectedError)
+                            });
+                        });
+                        return;
+                    }
+                    catch (reconnectError) {
+                        attempt++;
+                        const delayMs = Math.min(1000 * Math.pow(2, attempt - 1), 30_000);
+                        this._logger.warn('Reconnect attempt failed, retrying', {
+                            attempt,
+                            delayMs,
+                            error: this.toErrorMessage(reconnectError)
+                        });
+                        await new Promise(resolve => setTimeout(resolve, delayMs));
+                    }
+                }
+            })().finally(() => {
+                this._reconnectOperation = undefined;
+            });
+        }
+        await this._reconnectOperation;
+    }
+    async withReconnect(operation, action) {
+        try {
+            return await action();
+        }
+        catch (error) {
+            if (!this.shouldReconnect(error)) {
+                throw error;
+            }
+            await this.reconnect(operation, error);
+            return action();
+        }
+    }
+    shouldReconnect(error) {
+        const code = Number(error?.code ?? -1);
+        const details = String(error?.details ?? '');
+        const message = this.toErrorMessage(error);
+        if (code === 4 || code === 13 || code === 14) {
+            return true;
+        }
+        const connectionIndicators = [
+            'deadline exceeded',
+            'unavailable',
+            'connection',
+            'connectivity',
+            'channel',
+            'socket',
+            'econnrefused',
+            'etimedout'
+        ];
+        const combined = `${details} ${message}`.toLowerCase();
+        return connectionIndicators.some(indicator => combined.includes(indicator));
+    }
+    toErrorMessage(error) {
+        if (error instanceof Error) {
+            return error.message;
+        }
+        return String(error);
+    }
+    startConnectionWatchdog() {
+        this._watchdogHandle = setInterval(() => {
+            void this.runHealthCheck();
+        }, ChronicleClient._healthCheckIntervalMs);
+        this._watchdogHandle.unref?.();
+    }
+    async runHealthCheck() {
+        if (this._isDisposed || !this._lifecycle.isConnected) {
+            return;
+        }
+        try {
+            await this._connection.server.getVersionInfo({});
+            this._logger.verbose('Connection health check passed');
+        }
+        catch (error) {
+            await this.reconnect('watchdog-health-check', error);
+        }
+    }
+    async startKernelKeepAlive() {
+        this._keepAliveAbortController?.abort();
+        this._keepAliveAbortController = new AbortController();
+        const { signal } = this._keepAliveAbortController;
+        const keepAliveStream = this._connection.connections.connect({ ConnectionId: this._lifecycle.connectionId, ClientVersion: '1.0.0', IsRunningWithDebugger: false }, { signal });
+        const iterator = keepAliveStream[Symbol.asyncIterator]();
+        const firstResult = await iterator.next();
+        if (firstResult.done) {
+            throw new Error('Connection service stream ended before sending first keep-alive');
+        }
+        await this._connection.connections.connectionKeepAlive(firstResult.value);
+        this._logger.info('Client registered with kernel keep-alive mechanism', {
+            connectionId: this._lifecycle.connectionId
+        });
+        void this.runKeepAliveLoop(iterator, signal);
+    }
+    async runKeepAliveLoop(iterator, signal) {
+        try {
+            while (!signal.aborted) {
+                const result = await iterator.next();
+                if (result.done) {
+                    this._logger.info('Keep-alive stream ended');
+                    break;
+                }
+                await this._connection.connections.connectionKeepAlive(result.value);
+                this._logger.verbose('Keep-alive ping responded', {
+                    connectionId: this._lifecycle.connectionId
+                });
+            }
+        }
+        catch (err) {
+            if (!signal.aborted) {
+                this._logger.warn('Keep-alive loop ended with error', {
+                    error: this.toErrorMessage(err)
+                });
+            }
+        }
+    }
+    async registerArtifactsForStore(store, reason) {
+        this._logger.debug('Registering artifacts for event store', {
+            eventStore: store.name.value,
+            namespace: store.namespace.value,
+            reason
+        });
+        if (this._discoveryOperation) {
+            await this._discoveryOperation;
+        }
+        await store.registerArtifacts();
+        this._logger.info('Registered artifacts for event store', {
+            eventStore: store.name.value,
+            namespace: store.namespace.value,
+            reason
+        });
+    }
+}
+//# sourceMappingURL=ChronicleClient.js.map

package/dist/ChronicleClient.js.map

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

package/dist/ChronicleOptions.d.ts

@@ -0,0 +1,54 @@
+import { IClientArtifactsProvider } from './artifacts';
+import { ChronicleConnectionString } from './connection';
+type ChronicleOptionsFactoryParams = {
+    clientArtifactsProvider?: IClientArtifactsProvider;
+    discoveryPatterns?: string[];
+};
+/**
+ * Represents configuration options for the Chronicle client.
+ */
+export declare class ChronicleOptions {
+    /**
+     * The connection string used to connect to the Chronicle Kernel.
+     */
+    readonly connectionString: ChronicleConnectionString;
+    /**
+     * The program identifier used in causation metadata.
+     */
+    readonly programIdentifier: string;
+    /**
+     * The software version used in causation metadata.
+     */
+    readonly softwareVersion: string;
+    /**
+     * The software commit hash used in causation metadata.
+     */
+    readonly softwareCommit: string;
+    /**
+     * The provider used for client artifact discovery.
+     */
+    readonly clientArtifactsProvider: IClientArtifactsProvider;
+    /**
+     * Glob patterns used to discover artifact files at startup.
+     * Patterns prefixed with '!' are treated as exclusions.
+     * Set to an empty array to disable automatic file discovery.
+     */
+    readonly discoveryPatterns: string[];
+    private constructor();
+    /**
+     * Creates a {@link ChronicleOptions} instance from a connection string.
+     * @param connectionString - The connection string to parse and use.
+     * @returns A new ChronicleOptions instance.
+     */
+    static fromConnectionString(connectionString: string | ChronicleConnectionString, options?: ChronicleOptionsFactoryParams): ChronicleOptions;
+    /**
+     * Creates a {@link ChronicleOptions} instance for local development.
+     * Connects to Chronicle on localhost:35000 using the standard development
+     * client credentials and with TLS disabled, matching the default Chronicle
+     * development server configuration.
+     * @returns A new ChronicleOptions instance for development.
+     */
+    static development(options?: ChronicleOptionsFactoryParams): ChronicleOptions;
+}
+export {};
+//# sourceMappingURL=ChronicleOptions.d.ts.map

package/dist/ChronicleOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChronicleOptions.d.ts","sourceRoot":"","sources":["../ChronicleOptions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkC,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAWzD,KAAK,6BAA6B,GAAG;IACjC,uBAAuB,CAAC,EAAE,wBAAwB,CAAC;IACnD,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,qBAAa,gBAAgB;IACzB;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,yBAAyB,CAAC;IAErD;;OAEG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,uBAAuB,EAAE,wBAAwB,CAAC;IAE3D;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAErC,OAAO;IAmBP;;;;OAIG;IACH,MAAM,CAAC,oBAAoB,CACvB,gBAAgB,EAAE,MAAM,GAAG,yBAAyB,EACpD,OAAO,CAAC,EAAE,6BAA6B,GACxC,gBAAgB;IAOnB;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,6BAA6B,GAAG,gBAAgB;CAMhF"}

package/dist/ChronicleOptions.js

@@ -0,0 +1,75 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import { DefaultClientArtifactsProvider } from './artifacts';
+import { ChronicleConnectionString } from './connection';
+/**
+ * Represents configuration options for the Chronicle client.
+ */
+export class ChronicleOptions {
+    /**
+     * The connection string used to connect to the Chronicle Kernel.
+     */
+    connectionString;
+    /**
+     * The program identifier used in causation metadata.
+     */
+    programIdentifier;
+    /**
+     * The software version used in causation metadata.
+     */
+    softwareVersion;
+    /**
+     * The software commit hash used in causation metadata.
+     */
+    softwareCommit;
+    /**
+     * The provider used for client artifact discovery.
+     */
+    clientArtifactsProvider;
+    /**
+     * Glob patterns used to discover artifact files at startup.
+     * Patterns prefixed with '!' are treated as exclusions.
+     * Set to an empty array to disable automatic file discovery.
+     */
+    discoveryPatterns;
+    constructor(options) {
+        this.connectionString = options.connectionString;
+        this.programIdentifier = options.programIdentifier ?? 'Unknown';
+        this.softwareVersion = options.softwareVersion ?? '0.0.0';
+        this.softwareCommit = options.softwareCommit ?? 'Unknown';
+        this.clientArtifactsProvider = options.clientArtifactsProvider ?? DefaultClientArtifactsProvider.default;
+        this.discoveryPatterns = options.discoveryPatterns ?? [
+            '**/*.ts',
+            '!**/*.d.ts',
+            '!**/node_modules',
+            '!**/dist',
+            '!**/build',
+            '!**/.git',
+            '!**/.vscode',
+            '!**/*.spec.ts',
+            '!**/*.test.ts'
+        ];
+    }
+    /**
+     * Creates a {@link ChronicleOptions} instance from a connection string.
+     * @param connectionString - The connection string to parse and use.
+     * @returns A new ChronicleOptions instance.
+     */
+    static fromConnectionString(connectionString, options) {
+        const parsed = typeof connectionString === 'string'
+            ? new ChronicleConnectionString(connectionString)
+            : connectionString;
+        return new ChronicleOptions({ connectionString: parsed, clientArtifactsProvider: options?.clientArtifactsProvider, discoveryPatterns: options?.discoveryPatterns });
+    }
+    /**
+     * Creates a {@link ChronicleOptions} instance for local development.
+     * Connects to Chronicle on localhost:35000 using the standard development
+     * client credentials and with TLS disabled, matching the default Chronicle
+     * development server configuration.
+     * @returns A new ChronicleOptions instance for development.
+     */
+    static development(options) {
+        return ChronicleOptions.fromConnectionString('chronicle://chronicle-dev-client:chronicle-dev-secret@localhost:35000?disableTls=true', options);
+    }
+}
+//# sourceMappingURL=ChronicleOptions.js.map

package/dist/ChronicleOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChronicleOptions.js","sourceRoot":"","sources":["../ChronicleOptions.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,8BAA8B,EAA4B,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAgBzD;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACzB;;OAEG;IACM,gBAAgB,CAA4B;IAErD;;OAEG;IACM,iBAAiB,CAAS;IAEnC;;OAEG;IACM,eAAe,CAAS;IAEjC;;OAEG;IACM,cAAc,CAAS;IAEhC;;OAEG;IACM,uBAAuB,CAA2B;IAE3D;;;;OAIG;IACM,iBAAiB,CAAW;IAErC,YAAoB,OAA0C;QAC1D,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;QACjD,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,SAAS,CAAC;QAChE,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC;QAC1D,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,SAAS,CAAC;QAC1D,IAAI,CAAC,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,IAAI,8BAA8B,CAAC,OAAO,CAAC;QACzG,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI;YAClD,SAAS;YACT,YAAY;YACZ,kBAAkB;YAClB,UAAU;YACV,WAAW;YACX,UAAU;YACV,aAAa;YACb,eAAe;YACf,eAAe;SAClB,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,oBAAoB,CACvB,gBAAoD,EACpD,OAAuC;QAEvC,MAAM,MAAM,GAAG,OAAO,gBAAgB,KAAK,QAAQ;YAC/C,CAAC,CAAC,IAAI,yBAAyB,CAAC,gBAAgB,CAAC;YACjD,CAAC,CAAC,gBAAgB,CAAC;QACvB,OAAO,IAAI,gBAAgB,CAAC,EAAE,gBAAgB,EAAE,MAAM,EAAE,uBAAuB,EAAE,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACxK,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAAC,OAAuC;QACtD,OAAO,gBAAgB,CAAC,oBAAoB,CACxC,uFAAuF,EACvF,OAAO,CACV,CAAC;IACN,CAAC;CACJ"}

package/dist/EventSequences/AppendError.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Represents an error that occurred while appending an event.
+ */
+export interface AppendError {
+    /** The error message describing the failure. */
+    readonly message: string;
+}
+//# sourceMappingURL=AppendError.d.ts.map

package/dist/EventSequences/AppendError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppendError.d.ts","sourceRoot":"","sources":["../../EventSequences/AppendError.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B"}

package/dist/EventSequences/AppendError.js

@@ -0,0 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export {};
+//# sourceMappingURL=AppendError.js.map

package/dist/EventSequences/AppendError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppendError.js","sourceRoot":"","sources":["../../EventSequences/AppendError.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/EventSequences/AppendOptions.d.ts

@@ -0,0 +1,11 @@
+import { Guid } from '@cratis/fundamentals';
+/**
+ * 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;
+}
+//# sourceMappingURL=AppendOptions.d.ts.map

package/dist/EventSequences/AppendOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppendOptions.d.ts","sourceRoot":"","sources":["../../EventSequences/AppendOptions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/EventSequences/AppendOptions.js

@@ -0,0 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export {};
+//# sourceMappingURL=AppendOptions.js.map

package/dist/EventSequences/AppendOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppendOptions.js","sourceRoot":"","sources":["../../EventSequences/AppendOptions.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/EventSequences/AppendResult.d.ts

@@ -0,0 +1,17 @@
+import { AppendError } from './AppendError';
+import { ConstraintViolation } from './ConstraintViolation';
+import { EventSequenceNumber } from './EventSequenceNumber';
+/**
+ * Represents the result of appending a single event to an event sequence.
+ */
+export interface AppendResult {
+    /** The sequence number assigned to the appended event. */
+    readonly sequenceNumber: EventSequenceNumber;
+    /** Constraint violations that occurred, if any. */
+    readonly constraintViolations: ReadonlyArray<ConstraintViolation>;
+    /** Errors that occurred during appending, if any. */
+    readonly errors: ReadonlyArray<AppendError>;
+    /** Whether the append was successful (no violations or errors). */
+    readonly isSuccess: boolean;
+}
+//# sourceMappingURL=AppendResult.d.ts.map

package/dist/EventSequences/AppendResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppendResult.d.ts","sourceRoot":"","sources":["../../EventSequences/AppendResult.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,EAAE,mBAAmB,CAAC;IAE7C,mDAAmD;IACnD,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAElE,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAE5C,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC/B"}

package/dist/EventSequences/AppendResult.js

@@ -0,0 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export {};
+//# sourceMappingURL=AppendResult.js.map

package/dist/EventSequences/AppendResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppendResult.js","sourceRoot":"","sources":["../../EventSequences/AppendResult.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/EventSequences/ConstraintViolation.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Represents a constraint violation that occurred while appending an event.
+ */
+export interface ConstraintViolation {
+    /** The constraint identifier that was violated. */
+    readonly constraintId: string;
+    /** The violation message. */
+    readonly message: string;
+    /** Additional details about the violation. */
+    readonly details: Readonly<Record<string, string>>;
+}
+//# sourceMappingURL=ConstraintViolation.d.ts.map