@iwentsourcing/core 0.1.0

package/dist/storage/versioned/created-storage-builder.js

@@ -0,0 +1,162 @@
+import { createLazy, createTracedLazy } from '../../lazy/create-lazy.js';
+import { createLazyStorageClient } from '../lazy/create-lazy-storage-client.js';
+import { getVersionedStorageName } from './get-versioned-storage-name.js';
+import { addStorageVersion, getChecksum, getLatestStorageVersion, getStorageVersionForMigrations, } from './get-storage-version.js';
+import { versionedStorageStateMigrations } from './versioned-storage-state.js';
+import { buildStateDefinition } from '../migration/build-state-definition.js';
+import { buildMigrationHistory } from '../migration/build-migration-history.js';
+import { CustomError } from '../../error/custom-error.js';
+import { createRotatingMap } from '../../utils/rotating-map.js';
+import { ttlAbort } from '../../utils/ttl-abort.js';
+// Resolving a storage handle runs a migration-version check guarded by a
+// postgres advisory lock. That result is stable for a given schema, so handles
+// are cached and reused. Suggested defaults for callers that read these from
+// configuration; the builder itself applies no default.
+export const DEFAULT_STORAGE_CACHE_LIMIT = 512;
+export const DEFAULT_STORAGE_CACHE_TTL_SECONDS = 30 * 60;
+export function createStorageFactoryFromBuilder(storageBuilder) {
+    return {
+        open(name, state, signal) {
+            return storageBuilder.open(name, { state, migrationMode: 'deny-backward-incompatibility' }, signal);
+        },
+    };
+}
+export function createdStorageBuilder(provider, env, telemetry, lock, processSignal, cache) {
+    const lazyStorageManagement = createLazy(() => provider.open(`storage_management`, versionedStorageStateMigrations, processSignal));
+    const tracer = telemetry.createTracer('storage.builder');
+    const storageCache = createRotatingMap({
+        limit: cache.limit,
+        signal: processSignal,
+    });
+    return {
+        open(name, options) {
+            const initialMigration = buildMigrationHistory({}, options.state);
+            if (initialMigration.type === 'backward-incompatible') {
+                throw new CustomError('unable to migrate', {});
+            }
+            const schemaKey = JSON.stringify(initialMigration.migrations);
+            // Re-opening a storage with a changed schema is a migration. The
+            // cached handle is now stale — drop it so its entry signal aborts and
+            // the underlying connection is released, otherwise the migration
+            // re-open would reuse the pre-migration handle.
+            const cached = storageCache.get(name);
+            if (cached !== undefined && cached.schemaKey !== schemaKey) {
+                storageCache.delete(name);
+            }
+            // Give the entry a TTL only when one is configured and only when this
+            // call will actually create it — a cache hit ignores the signal, so
+            // building one would leak a timer per request.
+            const createsEntry = cached === undefined || cached.schemaKey !== schemaKey;
+            const ttlSignal = createsEntry && cache.ttl !== undefined
+                ? ttlAbort(cache.ttl)
+                : undefined;
+            // The handle is opened against the cache entry's own signal — not the
+            // caller's request signal — so it survives the request that first
+            // opened it and is released when the entry expires, is evicted, or
+            // the process stops.
+            const entry = storageCache.getOrCreate(name, (entrySignal) => ({
+                schemaKey,
+                lazy: createTracedLazy(tracer, 'storage-open', { attributes: { 'storage.name': name } }, async () => {
+                    const storageManagement = await lazyStorageManagement.resolve();
+                    const checksum = await getChecksum(env, initialMigration.migrations);
+                    return await lock.acquire(`storage-management-${name}`, async () => {
+                        const existingVersion = await getStorageVersionForMigrations(storageManagement, name, checksum, entrySignal);
+                        if (existingVersion) {
+                            const existingStorageName = getVersionedStorageName(name, existingVersion.version);
+                            return provider.open(existingStorageName, {
+                                state: options.state,
+                                migrations: initialMigration.migrations,
+                            }, entrySignal);
+                        }
+                        const latestStorageVersion = await getLatestStorageVersion(storageManagement, name, entrySignal);
+                        if (!latestStorageVersion) {
+                            const version = await addStorageVersion(storageManagement, name, checksum, null, false, entrySignal);
+                            const newStorageName = getVersionedStorageName(name, version);
+                            return provider.open(newStorageName, {
+                                state: options.state,
+                                migrations: initialMigration.migrations,
+                            }, entrySignal);
+                        }
+                        const currentStorageName = getVersionedStorageName(name, latestStorageVersion.version);
+                        const appliedMigrations = await provider.migrations(currentStorageName, entrySignal);
+                        const migrationsToApply = buildMigrationHistory(buildStateDefinition(appliedMigrations), options.state);
+                        if (migrationsToApply.type === 'backward-incompatible') {
+                            if (options.migrationMode === 'deny-backward-incompatibility') {
+                                throw new CustomError('unable to migrate state', {
+                                    name,
+                                    reason: migrationsToApply.reason,
+                                    version: latestStorageVersion.version.toString(),
+                                });
+                            }
+                            const newVersion = await addStorageVersion(storageManagement, name, checksum, latestStorageVersion, true, entrySignal);
+                            const newStorageName = getVersionedStorageName(name, newVersion);
+                            return provider.open(newStorageName, {
+                                state: options.state,
+                                migrations: initialMigration.migrations,
+                            }, entrySignal);
+                        }
+                        const upgradeMigrations = [
+                            ...appliedMigrations,
+                            ...migrationsToApply.migrations,
+                        ];
+                        const upgradeChecksum = await getChecksum(env, upgradeMigrations);
+                        const upgradeVersion = await addStorageVersion(storageManagement, name, upgradeChecksum, latestStorageVersion, false, entrySignal);
+                        const upgradeStorageName = getVersionedStorageName(name, upgradeVersion);
+                        return provider.open(upgradeStorageName, {
+                            state: options.state,
+                            migrations: upgradeMigrations,
+                        }, entrySignal);
+                    }, entrySignal);
+                }),
+            }), ttlSignal);
+            return createLazyStorageClient(options.state, name, () => entry.lazy);
+        },
+        async *versions(name) {
+            const storage = await lazyStorageManagement.resolve();
+            for await (const version of storage
+                .snapshot('versions')
+                .index('name')
+                .filter('name', name)
+                .range(null, { signal: processSignal })) {
+                yield {
+                    version: version.data.version,
+                    migrationChecksum: version.data.migrationChecksum,
+                };
+            }
+        },
+        async destroyAll(name, signal) {
+            const storage = await lazyStorageManagement.resolve();
+            const versions = [];
+            await storage.transaction(async (trx) => {
+                for await (const version of trx
+                    .snapshot('versions')
+                    .index('name')
+                    .filter('name', name)
+                    .range(null, { signal })) {
+                    if (!versions.includes(version.data.version)) {
+                        versions.push(version.data.version);
+                        await provider.destroy(getVersionedStorageName(name, version.data.version), signal);
+                    }
+                    await trx.state('versions').delete({
+                        name: version.data.name,
+                        migrationChecksum: version.data.migrationChecksum,
+                    });
+                }
+            }, signal);
+        },
+        async *dbs(signal) {
+            const storage = await lazyStorageManagement.resolve();
+            const names = [];
+            for await (const item of storage
+                .snapshot('versions')
+                .range(null, { signal })) {
+                if (names.includes(item.data.name)) {
+                    continue;
+                }
+                names.push(item.data.name);
+                yield item.data.name;
+            }
+        },
+    };
+}
+//# sourceMappingURL=created-storage-builder.js.map

package/dist/storage/versioned/created-storage-builder.js.map

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

package/dist/storage/versioned/generate-state-version.d.ts

@@ -0,0 +1,3 @@
+import { RuntimeEnv } from '../../environment/runtime-env.js';
+import { StateDefinitions } from '../state-declaration.js';
+export declare function generateStateVersion(env: RuntimeEnv, state: StateDefinitions): Promise<string>;

package/dist/storage/versioned/generate-state-version.js

@@ -0,0 +1,13 @@
+import { serializeObject } from '../../utils/serialize-object.js';
+import { sha1 } from '../../authentication/sha1.js';
+export function generateStateVersion(env, state) {
+    const versionString = serializeObject(Object.entries(state).map(([name, value]) => {
+        return {
+            name,
+            schema: value.schema,
+            indices: value.indices,
+        };
+    }));
+    return sha1(env, versionString);
+}
+//# sourceMappingURL=generate-state-version.js.map

package/dist/storage/versioned/generate-state-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-state-version.js","sourceRoot":"","sources":["../../../src/storage/versioned/generate-state-version.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAEpD,MAAM,UAAU,oBAAoB,CAAC,GAAe,EAAE,KAAuB;IAC3E,MAAM,aAAa,GAAG,eAAe,CACnC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;QAC1C,OAAO;YACL,IAAI;YACJ,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;AAClC,CAAC"}

package/dist/storage/versioned/get-storage-version.d.ts

@@ -0,0 +1,13 @@
+import { StorageInterface } from '../storage-interface.js';
+import { versionedStorageState } from './versioned-storage-state.js';
+import { Migration } from '../migration/migrations.js';
+import { RuntimeEnv } from '../../environment/runtime-env.js';
+export interface MigrationVersion {
+    name: string;
+    version: number;
+    migrationChecksum: string;
+}
+export declare function getLatestStorageVersion(storageManagement: StorageInterface<typeof versionedStorageState>, name: string, signal: AbortSignal): Promise<MigrationVersion | null>;
+export declare function getStorageVersionForMigrations(storageManagement: StorageInterface<typeof versionedStorageState>, name: string, checksum: string, signal: AbortSignal): Promise<MigrationVersion | null>;
+export declare function getChecksum(env: RuntimeEnv, migrations: Migration[]): Promise<string>;
+export declare function addStorageVersion(storageManagement: StorageInterface<typeof versionedStorageState>, name: string, checksum: string, current: MigrationVersion | null, breakingChange: boolean, signal: AbortSignal): Promise<number>;

package/dist/storage/versioned/get-storage-version.js

@@ -0,0 +1,49 @@
+import { firstOfRange } from '../first-of-range.js';
+import { getVersionedStorageName } from './get-versioned-storage-name.js';
+import { sha1 } from '../../authentication/sha1.js';
+export async function getLatestStorageVersion(storageManagement, name, signal) {
+    const latestVersion = await firstOfRange(storageManagement
+        .snapshot('versions')
+        .index('name')
+        .filter('name', name)
+        .range(null, { dir: 'prev', signal }));
+    if (!latestVersion) {
+        return null;
+    }
+    return {
+        version: latestVersion.data.version,
+        name: getVersionedStorageName(name, latestVersion.data.version),
+        migrationChecksum: latestVersion.data.migrationChecksum,
+    };
+}
+export async function getStorageVersionForMigrations(storageManagement, name, checksum, signal) {
+    const latestVersion = await storageManagement
+        .snapshot('versions')
+        .get({ name, migrationChecksum: checksum }, { signal });
+    if (!latestVersion) {
+        return null;
+    }
+    return {
+        version: latestVersion.data.version,
+        name: getVersionedStorageName(name, latestVersion.data.version),
+        migrationChecksum: latestVersion.data.migrationChecksum,
+    };
+}
+export function getChecksum(env, migrations) {
+    return sha1(env, JSON.stringify(migrations));
+}
+export async function addStorageVersion(storageManagement, name, checksum, current, breakingChange, signal) {
+    const version = current
+        ? breakingChange
+            ? current.version + 1
+            : current.version
+        : 1;
+    await storageManagement.state('versions').upsert({
+        name,
+        version,
+        migrationChecksum: checksum,
+        createdAt: new Date(),
+    }, signal);
+    return version;
+}
+//# sourceMappingURL=get-storage-version.js.map

package/dist/storage/versioned/get-storage-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-storage-version.js","sourceRoot":"","sources":["../../../src/storage/versioned/get-storage-version.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAQpD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,iBAAiE,EACjE,IAAY,EACZ,MAAmB;IAEnB,MAAM,aAAa,GAAG,MAAM,YAAY,CACtC,iBAAiB;SACd,QAAQ,CAAC,UAAU,CAAC;SACpB,KAAK,CAAC,MAAM,CAAC;SACb,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC;SACpB,KAAK,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CACxC,CAAC;IACF,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,OAAO;QACnC,IAAI,EAAE,uBAAuB,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;QAC/D,iBAAiB,EAAE,aAAa,CAAC,IAAI,CAAC,iBAAiB;KACxD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,iBAAiE,EACjE,IAAY,EACZ,QAAgB,EAChB,MAAmB;IAEnB,MAAM,aAAa,GAAG,MAAM,iBAAiB;SAC1C,QAAQ,CAAC,UAAU,CAAC;SACpB,GAAG,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,OAAO;QACnC,IAAI,EAAE,uBAAuB,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;QAC/D,iBAAiB,EAAE,aAAa,CAAC,IAAI,CAAC,iBAAiB;KACxD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,GAAe,EACf,UAAuB;IAEvB,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,iBAAiE,EACjE,IAAY,EACZ,QAAgB,EAChB,OAAgC,EAChC,cAAuB,EACvB,MAAmB;IAEnB,MAAM,OAAO,GAAG,OAAO;QACrB,CAAC,CAAC,cAAc;YACd,CAAC,CAAC,OAAO,CAAC,OAAO,GAAG,CAAC;YACrB,CAAC,CAAC,OAAO,CAAC,OAAO;QACnB,CAAC,CAAC,CAAC,CAAC;IACN,MAAM,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,CAC9C;QACE,IAAI;QACJ,OAAO;QACP,iBAAiB,EAAE,QAAQ;QAC3B,SAAS,EAAE,IAAI,IAAI,EAAE;KACtB,EACD,MAAM,CACP,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/storage/versioned/get-versioned-storage-name.d.ts

@@ -0,0 +1 @@
+export declare function getVersionedStorageName(name: string, increment: number): string;

package/dist/storage/versioned/get-versioned-storage-name.js

@@ -0,0 +1,4 @@
+export function getVersionedStorageName(name, increment) {
+    return `${name}_v${increment}`;
+}
+//# sourceMappingURL=get-versioned-storage-name.js.map

package/dist/storage/versioned/get-versioned-storage-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-versioned-storage-name.js","sourceRoot":"","sources":["../../../src/storage/versioned/get-versioned-storage-name.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,uBAAuB,CACrC,IAAY,EACZ,SAAiB;IAEjB,OAAO,GAAG,IAAI,KAAK,SAAS,EAAE,CAAC;AACjC,CAAC"}

package/dist/storage/versioned/migration-mode.d.ts

@@ -0,0 +1 @@
+export type MigrationMode = 'allow-backward-incompatibility' | 'deny-backward-incompatibility';

package/dist/storage/versioned/migration-mode.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=migration-mode.js.map

package/dist/storage/versioned/migration-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-mode.js","sourceRoot":"","sources":["../../../src/storage/versioned/migration-mode.ts"],"names":[],"mappings":""}

package/dist/storage/versioned/migration-options.d.ts

@@ -0,0 +1,6 @@
+import { StateDefinitions } from '../state-declaration.js';
+import { MigrationMode } from './migration-mode.js';
+export interface MigrationOptions<TState extends StateDefinitions> {
+    state: TState;
+    migrationMode: MigrationMode;
+}

package/dist/storage/versioned/migration-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=migration-options.js.map

package/dist/storage/versioned/migration-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-options.js","sourceRoot":"","sources":["../../../src/storage/versioned/migration-options.ts"],"names":[],"mappings":""}

package/dist/storage/versioned/storage-builder.d.ts

@@ -0,0 +1,10 @@
+import { StateDefinitions } from '../state-declaration.js';
+import { StorageClient } from '../tracker/tracked-state.js';
+import { StorageVersion } from './storage-version.js';
+import { MigrationOptions } from './migration-options.js';
+export interface StorageBuilder {
+    open<TState extends StateDefinitions>(name: string, options: MigrationOptions<TState>, signal: AbortSignal): StorageClient<TState>;
+    versions(name: string): AsyncGenerator<StorageVersion>;
+    destroyAll(name: string, signal: AbortSignal): Promise<void>;
+    dbs(signal: AbortSignal): AsyncGenerator<string>;
+}

package/dist/storage/versioned/storage-builder.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=storage-builder.js.map

package/dist/storage/versioned/storage-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-builder.js","sourceRoot":"","sources":["../../../src/storage/versioned/storage-builder.ts"],"names":[],"mappings":""}

package/dist/storage/versioned/storage-factory.d.ts

@@ -0,0 +1,5 @@
+import { StateDefinitions } from '../state-declaration.js';
+import { StorageClient } from '../tracker/tracked-state.js';
+export interface StorageFactory {
+    open<TState extends StateDefinitions>(name: string, state: TState, signal: AbortSignal): StorageClient<TState>;
+}

package/dist/storage/versioned/storage-factory.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=storage-factory.js.map

package/dist/storage/versioned/storage-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-factory.js","sourceRoot":"","sources":["../../../src/storage/versioned/storage-factory.ts"],"names":[],"mappings":""}

package/dist/storage/versioned/storage-version.d.ts

@@ -0,0 +1,4 @@
+export interface StorageVersion {
+    version: number;
+    migrationChecksum: string;
+}

package/dist/storage/versioned/storage-version.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=storage-version.js.map

package/dist/storage/versioned/storage-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-version.js","sourceRoot":"","sources":["../../../src/storage/versioned/storage-version.ts"],"names":[],"mappings":""}

package/dist/storage/versioned/versioned-storage-state.d.ts

@@ -0,0 +1,26 @@
+export declare const versionedStorageState: {
+    versions: import("../state-declaration.js").StateDeclaration<"versions", {
+        name: string;
+        createdAt: Date;
+        version: number;
+        migrationChecksum: string;
+    }, "name" | "migrationChecksum", Record<string, never> & Record<"name", import("../state-declaration.js").StateIndex<{
+        name: string;
+        createdAt: Date;
+        version: number;
+        migrationChecksum: string;
+    }, ["name", "version"]>>>;
+};
+export declare const versionedStorageStateMigrations: import("../migration/define-migration-history.js").MigrationHistory<{
+    versions: import("../state-declaration.js").StateDeclaration<"versions", {
+        name: string;
+        createdAt: Date;
+        version: number;
+        migrationChecksum: string;
+    }, "name" | "migrationChecksum", Record<string, never> & Record<"name", import("../state-declaration.js").StateIndex<{
+        name: string;
+        createdAt: Date;
+        version: number;
+        migrationChecksum: string;
+    }, ["name", "version"]>>>;
+}>;

package/dist/storage/versioned/versioned-storage-state.js

@@ -0,0 +1,22 @@
+import { defineState } from '../define-state.js';
+import { declareState } from '../declare-state.js';
+import { string } from '../../typing/string.js';
+import { number } from '../../typing/number.js';
+import { date } from '../../typing/date.js';
+import { defineAddStateIndexMigration, defineAddStateMigration, } from '../migration/migrations.js';
+import { defineMigrationHistory } from '../migration/define-migration-history.js';
+export const versionedStorageState = defineState([
+    declareState('versions', {
+        name: string(),
+        version: number(),
+        migrationChecksum: string(),
+        createdAt: date(),
+    }, ['name', 'migrationChecksum']).index('name', ['name', 'version']),
+]);
+export const versionedStorageStateMigrations = defineMigrationHistory(versionedStorageState, defineAddStateMigration('versions', {
+    name: string(),
+    version: number(),
+    migrationChecksum: string(),
+    createdAt: date(),
+}, ['name', 'migrationChecksum'], {}), defineAddStateIndexMigration('versions', 'name', ['name', 'version'], false));
+//# sourceMappingURL=versioned-storage-state.js.map

package/dist/storage/versioned/versioned-storage-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioned-storage-state.js","sourceRoot":"","sources":["../../../src/storage/versioned/versioned-storage-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAElF,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC;IAC/C,YAAY,CACV,UAAU,EACV;QACE,IAAI,EAAE,MAAM,EAAE;QACd,OAAO,EAAE,MAAM,EAAE;QACjB,iBAAiB,EAAE,MAAM,EAAE;QAC3B,SAAS,EAAE,IAAI,EAAE;KAClB,EACD,CAAC,MAAM,EAAE,mBAAmB,CAAU,CACvC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,CAAU,CAAC;CAC9C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,sBAAsB,CACnE,qBAAqB,EACrB,uBAAuB,CACrB,UAAU,EACV;IACE,IAAI,EAAE,MAAM,EAAE;IACd,OAAO,EAAE,MAAM,EAAE;IACjB,iBAAiB,EAAE,MAAM,EAAE;IAC3B,SAAS,EAAE,IAAI,EAAE;CAClB,EACD,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAC7B,EAAE,CACH,EACD,4BAA4B,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,CAC7E,CAAC"}

package/dist/stream/build-stream-name.d.ts

@@ -0,0 +1,6 @@
+import { EventAuth } from '../event-store/event-auth.js';
+import { StreamArgs } from './stream-args.js';
+export declare function buildStreamKey(pattern: string, { auth, args }: {
+    auth?: EventAuth;
+    args: StreamArgs;
+}): string;

package/dist/stream/build-stream-name.js

@@ -0,0 +1,16 @@
+import { replacePlaceholders } from './replace-placeholders.js';
+import { fallbackAuth } from '../event-store/fallback-auth.js';
+export function buildStreamKey(pattern, { auth, args }) {
+    const authValue = fallbackAuth(auth);
+    const placeholderValues = {
+        ...Object.entries(args).reduce((map, [key, arg]) => {
+            map[`args.${key.toLowerCase()}`] = arg;
+            return map;
+        }, {}),
+        'auth.sub': authValue.sub,
+        'auth.aud': authValue.aud,
+        'auth.iss': authValue.iss,
+    };
+    return replacePlaceholders(pattern, placeholderValues).value;
+}
+//# sourceMappingURL=build-stream-name.js.map

package/dist/stream/build-stream-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-stream-name.js","sourceRoot":"","sources":["../../src/stream/build-stream-name.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAE/D,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,EAAE,IAAI,EAAE,IAAI,EAA0C;IAEtD,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAErC,MAAM,iBAAiB,GAAG;QACxB,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAC5B,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE;YAClB,GAAG,CAAC,QAAQ,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;YACvC,OAAO,GAAG,CAAC;QACb,CAAC,EACD,EAAE,CACH;QACD,UAAU,EAAE,SAAS,CAAC,GAAG;QACzB,UAAU,EAAE,SAAS,CAAC,GAAG;QACzB,UAAU,EAAE,SAAS,CAAC,GAAG;KAC1B,CAAC;IAEF,OAAO,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,KAAK,CAAC;AAC/D,CAAC"}

package/dist/stream/build-stream-name.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/stream/build-stream-name.test.js

@@ -0,0 +1,30 @@
+import { it, describe } from 'node:test';
+import { equal } from 'node:assert';
+import { buildStreamKey } from './build-stream-name.js';
+describe('buildStreamName', () => {
+    it('should replace auth', () => {
+        equal(buildStreamKey('test-$(auth.sub)', {
+            auth: {
+                sub: '1234',
+                iss: 'demo',
+                aud: 'demo',
+            },
+            args: {},
+        }), 'test-1234');
+    });
+    it('should replace args', () => {
+        equal(buildStreamKey('test-$(args.id)', { args: { id: '1234' } }), 'test-1234');
+    });
+    it('should build regex with specified args', () => {
+        equal(buildStreamKey('test-$(args.id)', { args: { id: '1' } }), 'test-1');
+    });
+    it('should build regex with specified args', () => {
+        equal(buildStreamKey('test-$(args.id)-$(args.test)', {
+            args: { id: '1', test: 'arg' },
+        }), 'test-1-arg');
+    });
+    it('should build regex with open auth', () => {
+        equal(buildStreamKey('test-$(args.id)-$(auth.sub)', { args: { id: '1' } }), 'test-1-anonymous');
+    });
+});
+//# sourceMappingURL=build-stream-name.test.js.map

package/dist/stream/build-stream-name.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-stream-name.test.js","sourceRoot":"","sources":["../../src/stream/build-stream-name.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,KAAK,CACH,cAAc,CAAC,kBAAkB,EAAE;YACjC,IAAI,EAAE;gBACJ,GAAG,EAAE,MAAM;gBACX,GAAG,EAAE,MAAM;gBACX,GAAG,EAAE,MAAM;aACZ;YACD,IAAI,EAAE,EAAE;SACT,CAAC,EACF,WAAW,CACZ,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,KAAK,CACH,cAAc,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAC3D,WAAW,CACZ,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,KAAK,CAAC,cAAc,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,KAAK,CACH,cAAc,CAAC,8BAA8B,EAAE;YAC7C,IAAI,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE;SAC/B,CAAC,EACF,YAAY,CACb,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,KAAK,CACH,cAAc,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,EACpE,kBAAkB,CACnB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/stream/define-events.d.ts

@@ -0,0 +1,4 @@
+import { EventDeclaration } from '../event-store/event-declarations.js';
+export declare function defineEvents<T extends EventDeclaration<any>[]>(val: T): {
+    [Prop in T[number] as Prop['key']]: Prop;
+};

package/dist/stream/define-events.js

@@ -0,0 +1,7 @@
+export function defineEvents(val) {
+    return val.reduce((map, evt) => {
+        map[evt.key] = evt;
+        return map;
+    }, {});
+}
+//# sourceMappingURL=define-events.js.map

package/dist/stream/define-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-events.js","sourceRoot":"","sources":["../../src/stream/define-events.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAC1B,GAAM;IAEN,OAAO,GAAG,CAAC,MAAM,CAAM,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAClC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QACnB,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC"}

package/dist/stream/define-stream.d.ts

@@ -0,0 +1,9 @@
+import { StateDeclarations } from '../storage/state-declaration.js';
+import { EventDeclarations } from '../event-store/event-declarations.js';
+import { OutputDeclarations } from './output-declarations.js';
+import { RealmDefinition } from '../realm/realm-definition.js';
+import { AuthProviders } from '../authentication/auth-providers.js';
+import { HandleDeclarations } from './handle-declarations.js';
+import { StreamOptions } from './stream-options.js';
+import { StreamHostRuntime } from '../runtime/host-runtime.js';
+export declare function defineStream<TState extends StateDeclarations, TEvent extends EventDeclarations, THandle extends HandleDeclarations<TState, TEvent, TOutput>, TOutput extends OutputDeclarations, TRealm extends RealmDefinition<AuthProviders>>(realm: TRealm, opts: StreamOptions<TState, TEvent, THandle, TOutput>): StreamHostRuntime<TState, TEvent, TOutput, TRealm>;

package/dist/stream/define-stream.js

@@ -0,0 +1,23 @@
+import { generateVersion } from '../realm/generate-version.js';
+import { createHostRuntime } from '../runtime/create-host-runtime.js';
+export function defineStream(realm, opts) {
+    return {
+        source: {
+            realm: realm,
+            version: generateVersion(opts.state, opts.events, opts.outputs, {
+                stateGrant: opts.stateGrant ?? [],
+                eventGrant: opts.eventGrant ?? [],
+            }),
+            outputs: opts.outputs,
+            state: opts.state,
+            events: opts.events,
+            pattern: opts.pattern,
+            handle: opts.handle,
+            auth: opts.auth,
+            stateGrant: opts.stateGrant ?? [],
+            eventGrant: opts.eventGrant ?? [],
+        },
+        runtime: createHostRuntime(opts.events, opts.handle, opts.outputs),
+    };
+}
+//# sourceMappingURL=define-stream.js.map

package/dist/stream/define-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-stream.js","sourceRoot":"","sources":["../../src/stream/define-stream.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,MAAM,UAAU,YAAY,CAO1B,KAAa,EACb,IAAqD;IAErD,OAAO;QACL,MAAM,EAAE;YACN,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE;gBAC9D,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;gBACjC,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;aAClC,CAAC;YACF,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;YACjC,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;SAClC;QACD,OAAO,EAAE,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC;KACnE,CAAC;AACJ,CAAC"}

package/dist/stream/event-store-transformer.d.ts

@@ -0,0 +1,11 @@
+import { EventDeclarations } from '../event-store/event-declarations.js';
+import { StateValue } from '../storage/state-value.js';
+import { Telemetry } from '../tracer/telemetry.js';
+export interface EventTransformer<TEvents extends EventDeclarations> {
+    serialize<K extends string & keyof TEvents>(pattern: string, evt: K, data: TEvents[K]['type']['_output']): Record<string, StateValue>;
+    deserialize<K extends string & keyof TEvents>(pattern: string, evt: K, data: Record<string, StateValue>): TEvents[K]['type']['_output'];
+}
+export declare function createEventStoreTransformer<TEvents extends EventDeclarations>(opts: {
+    patterns: Record<string, EventDeclarations>;
+    telemetry: Telemetry;
+}): EventTransformer<TEvents>;

package/dist/stream/event-store-transformer.js

@@ -0,0 +1,38 @@
+import { validate } from '../typing/validate.js';
+import { deserializeData, getStateData, } from '../runtime/get-state-data-keys.js';
+export function createEventStoreTransformer(opts) {
+    const transformer = opts.telemetry.createTracer('event-store-transformer');
+    return {
+        deserialize(pattern, evt, data) {
+            const events = opts.patterns[pattern];
+            if (!events) {
+                throw new Error(`pattern ${pattern} not found`);
+            }
+            const eventStruct = events[evt];
+            if (!eventStruct) {
+                throw new Error(`event type ${evt} not found`);
+            }
+            return transformer.createSpan('deserialize', { attributes: { event: evt, pattern } }, () => {
+                return deserializeData(eventStruct.type, data, opts.telemetry);
+            });
+        },
+        serialize(pattern, evt, data) {
+            const events = opts.patterns[pattern];
+            if (!events) {
+                throw new Error(`pattern ${pattern} not found`);
+            }
+            const eventStruct = events[evt];
+            if (!eventStruct) {
+                throw new Error(`event type ${evt} not found`);
+            }
+            const [eventError, eventData] = validate(data, eventStruct.type);
+            if (eventError) {
+                throw new Error('event validation error: ' + eventError.message);
+            }
+            return transformer.createSpan('serialize', { attributes: { event: evt, pattern } }, () => {
+                return getStateData(eventStruct.type, eventData);
+            });
+        },
+    };
+}
+//# sourceMappingURL=event-store-transformer.js.map

package/dist/stream/event-store-transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store-transformer.js","sourceRoot":"","sources":["../../src/stream/event-store-transformer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EACL,eAAe,EACf,YAAY,GACb,MAAM,mCAAmC,CAAC;AAgB3C,MAAM,UAAU,2BAA2B,CAEzC,IAGD;IACC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,yBAAyB,CAAC,CAAC;IAE3E,OAAO;QACL,WAAW,CACT,OAAe,EACf,GAAM,EACN,IAAgC;YAEhC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,YAAY,CAAC,CAAC;YAClD,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,cAAc,GAAG,YAAY,CAAC,CAAC;YACjD,CAAC;YAED,OAAO,WAAW,CAAC,UAAU,CAC3B,aAAa,EACb,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EACvC,GAAG,EAAE;gBACH,OAAO,eAAe,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YACjE,CAAC,CACF,CAAC;QACJ,CAAC;QACD,SAAS,CACP,OAAe,EACf,GAAM,EACN,IAAmC;YAEnC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,YAAY,CAAC,CAAC;YAClD,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,cAAc,GAAG,YAAY,CAAC,CAAC;YACjD,CAAC;YAED,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;YACjE,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;YACnE,CAAC;YAED,OAAO,WAAW,CAAC,UAAU,CAC3B,WAAW,EACX,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EACvC,GAAG,EAAE;gBACH,OAAO,YAAY,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YACnD,CAAC,CACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/stream/get-placeholder-names.d.ts

@@ -0,0 +1,5 @@
+export declare function getPlaceholderNames(pattern: string): Generator<{
+    name: string;
+    index: number;
+    match: string;
+}>;