@requence/event-sourcing 1.4.1 → 1.5.1

package/dist/chunk-6q8mr1sg.js

@@ -1,13 +0,0 @@
-// src/superjson.ts
-import SuperJSON from "superjson";
-var superjson = new SuperJSON;
-function extendTypes(handler) {
-  handler(superjson);
-}
-function clone(obj) {
-  return superjson.deserialize(superjson.serialize(obj));
-}
-
-export { superjson, extendTypes, clone };
-
-//# debugId=97ED416FCC5782E564756E2164756E21

package/dist/chunk-6yrb30rx.js

@@ -1,22 +0,0 @@
-import {
-  RefreshingSkipError
-} from "./chunk-391m4mfp.js";
-
-// src/refresh.ts
-import { AsyncLocalStorage } from "node:async_hooks";
-var refreshStore = new AsyncLocalStorage;
-function isRefreshing() {
-  return refreshStore.getStore() ?? false;
-}
-function withRefreshing(handler) {
-  return refreshStore.run(true, handler);
-}
-function skipRefreshing() {
-  if (isRefreshing()) {
-    throw new RefreshingSkipError;
-  }
-}
-
-export { isRefreshing, withRefreshing, skipRefreshing };
-
-//# debugId=662B9CB5FCF319E264756E2164756E21

package/dist/chunk-dgzw1nj9.js.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/redis/redisLock.ts"],
-  "sourcesContent": [
-    "import type { Redis } from 'ioredis'\n\nimport type { LockCreator } from '../lock.ts'\n\nconst extendScript = `\n  if redis.call(\"get\", KEYS[1]) == ARGV[1] then\n      return redis.call(\"pexpire\", KEYS[1], ARGV[2])\n  else\n      return 0\n  end\n`\n\nconst deleteScript = `\n    if redis.call(\"get\", KEYS[1]) == ARGV[1] then\n        return redis.call(\"del\", KEYS[1])\n    else\n        return 0\n    end\n`\n\nexport function redisLock(client: Redis, defaultTtl = 5000): LockCreator {\n  return async (rawKey) => {\n    const key = Array.isArray(rawKey) ? rawKey.join(':') : rawKey\n    const token = crypto.randomUUID()\n\n    while (true) {\n      const acquired = await client.set(key, token, 'PX', defaultTtl, 'NX')\n\n      if (acquired !== 'OK') {\n        await new Promise((resolve) => setTimeout(resolve, 100))\n        continue\n      }\n\n      let isReleased = false\n      return {\n        async extend(ttl) {\n          const extended = await client.eval(\n            extendScript,\n            1,\n            key,\n            token,\n            ttl ?? defaultTtl / 2,\n          )\n          if (extended === 0) {\n            isReleased = true\n            return false\n          }\n          return true\n        },\n        async release() {\n          if (isReleased) {\n            return\n          }\n\n          isReleased = true\n          await client.eval(deleteScript, 1, key, token)\n        },\n      }\n    }\n  }\n}\n"
-  ],
-  "mappings": ";AAIA,IAAM,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQrB,IAAM,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQd,SAAS,SAAS,CAAC,QAAe,aAAa,MAAmB;AAAA,EACvE,OAAO,OAAO,WAAW;AAAA,IACvB,MAAM,MAAM,MAAM,QAAQ,MAAM,IAAI,OAAO,KAAK,GAAG,IAAI;AAAA,IACvD,MAAM,QAAQ,OAAO,WAAW;AAAA,IAEhC,OAAO,MAAM;AAAA,MACX,MAAM,WAAW,MAAM,OAAO,IAAI,KAAK,OAAO,MAAM,YAAY,IAAI;AAAA,MAEpE,IAAI,aAAa,MAAM;AAAA,QACrB,MAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,GAAG,CAAC;AAAA,QACvD;AAAA,MACF;AAAA,MAEA,IAAI,aAAa;AAAA,MACjB,OAAO;AAAA,aACC,OAAM,CAAC,KAAK;AAAA,UAChB,MAAM,WAAW,MAAM,OAAO,KAC5B,cACA,GACA,KACA,OACA,OAAO,aAAa,CACtB;AAAA,UACA,IAAI,aAAa,GAAG;AAAA,YAClB,aAAa;AAAA,YACb,OAAO;AAAA,UACT;AAAA,UACA,OAAO;AAAA;AAAA,aAEH,QAAO,GAAG;AAAA,UACd,IAAI,YAAY;AAAA,YACd;AAAA,UACF;AAAA,UAEA,aAAa;AAAA,UACb,MAAM,OAAO,KAAK,cAAc,GAAG,KAAK,KAAK;AAAA;AAAA,MAEjD;AAAA,IACF;AAAA;AAAA;",
-  "debugId": "09C372830E540B2B64756E2164756E21",
-  "names": []
-}

package/dist/chunk-jd4q8fcf.js

@@ -1,11 +0,0 @@
-// src/index.ts
-function isStreamId(stream) {
-  return "id" in stream;
-}
-function isStreamEvents(stream) {
-  return "events" in stream && Array.isArray(stream.events);
-}
-
-export { isStreamId, isStreamEvents };
-
-//# debugId=EF89CA439C05547264756E2164756E21

package/dist/chunk-ty9bhdvx.js.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/lock.ts"],
-  "sourcesContent": [
-    "import { Mutex } from 'async-mutex'\n\nexport default function lock(defaultTtl = 5000) {\n  const locks = new Map<string, Mutex>()\n  return async (key: string | string[]) => {\n    const k = Array.isArray(key) ? key.join(':') : key\n    if (!locks.has(k)) {\n      locks.set(k, new Mutex())\n    }\n\n    const mutex = locks.get(k)!\n\n    const releaseMutex = await mutex.acquire()\n    let isReleased = false\n\n    let timer: ReturnType<typeof setTimeout>\n    const startTimer = (ttl: number) => {\n      timer = setTimeout(() => {\n        if (!isReleased) {\n          console.warn('lock ttl expired for key', k)\n          isReleased = true\n          releaseMutex()\n          if (!mutex.isLocked()) {\n            locks.delete(k)\n          }\n        }\n      }, ttl)\n    }\n\n    startTimer(defaultTtl)\n\n    return {\n      async extend(ttl?: number) {\n        if (isReleased) {\n          return false\n        }\n        clearTimeout(timer)\n        startTimer(ttl ?? defaultTtl / 2)\n        return true\n      },\n      async release() {\n        if (isReleased) {\n          return\n        }\n\n        isReleased = true\n        clearTimeout(timer)\n        releaseMutex()\n\n        if (!mutex.isLocked()) {\n          locks.delete(k)\n        }\n      },\n    }\n  }\n}\n\nexport type LockCreator = ReturnType<typeof lock>\n"
-  ],
-  "mappings": ";AAAA;AAEA,SAAwB,IAAI,CAAC,aAAa,MAAM;AAAA,EAC9C,MAAM,QAAQ,IAAI;AAAA,EAClB,OAAO,OAAO,QAA2B;AAAA,IACvC,MAAM,IAAI,MAAM,QAAQ,GAAG,IAAI,IAAI,KAAK,GAAG,IAAI;AAAA,IAC/C,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG;AAAA,MACjB,MAAM,IAAI,GAAG,IAAI,KAAO;AAAA,IAC1B;AAAA,IAEA,MAAM,QAAQ,MAAM,IAAI,CAAC;AAAA,IAEzB,MAAM,eAAe,MAAM,MAAM,QAAQ;AAAA,IACzC,IAAI,aAAa;AAAA,IAEjB,IAAI;AAAA,IACJ,MAAM,aAAa,CAAC,QAAgB;AAAA,MAClC,QAAQ,WAAW,MAAM;AAAA,QACvB,IAAI,CAAC,YAAY;AAAA,UACf,QAAQ,KAAK,4BAA4B,CAAC;AAAA,UAC1C,aAAa;AAAA,UACb,aAAa;AAAA,UACb,IAAI,CAAC,MAAM,SAAS,GAAG;AAAA,YACrB,MAAM,OAAO,CAAC;AAAA,UAChB;AAAA,QACF;AAAA,SACC,GAAG;AAAA;AAAA,IAGR,WAAW,UAAU;AAAA,IAErB,OAAO;AAAA,WACC,OAAM,CAAC,KAAc;AAAA,QACzB,IAAI,YAAY;AAAA,UACd,OAAO;AAAA,QACT;AAAA,QACA,aAAa,KAAK;AAAA,QAClB,WAAW,OAAO,aAAa,CAAC;AAAA,QAChC,OAAO;AAAA;AAAA,WAEH,QAAO,GAAG;AAAA,QACd,IAAI,YAAY;AAAA,UACd;AAAA,QACF;AAAA,QAEA,aAAa;AAAA,QACb,aAAa,KAAK;AAAA,QAClB,aAAa;AAAA,QAEb,IAAI,CAAC,MAAM,SAAS,GAAG;AAAA,UACrB,MAAM,OAAO,CAAC;AAAA,QAChB;AAAA;AAAA,IAEJ;AAAA;AAAA;",
-  "debugId": "1272FCF41F0B661064756E2164756E21",
-  "names": []
-}

package/dist/chunk-vep2byx4.js.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/createAggregateRoot.ts"],
-  "sourcesContent": [
-    "import { AsyncLocalStorage } from 'node:async_hooks'\n\nimport { deepEqual } from 'fast-equals'\nimport { z } from 'zod/v4'\n\nimport type {\n  EmitEvents,\n  InternalAppendEvents,\n  LoadEvents,\n} from './createEventStore.ts'\nimport { getProcessManagerInfo } from './createProcessManager.ts'\nimport { getProjectionInfo } from './createProjection.ts'\nimport {\n  CommandError,\n  ConcurrencyError,\n  EventValidationError,\n  InfiniteLoopError,\n  ValidationError,\n} from './errors.ts'\nimport type { LockCreator } from './lock.ts'\nimport { isRefreshing } from './refresh.ts'\nimport createSnapshotGenerator, {\n  type CompleteSnapshotGenerator,\n  type InternalSnapshotGenerator,\n  type SnapshotGenerator,\n} from './snapshotGenerator.ts'\nimport { clone } from './superjson.ts'\nimport type { Transaction, TransactionDelay } from './transaction.ts'\nimport type {\n  BaseInputEvent,\n  BaseOutputEvent,\n  EventTemplate,\n  Keys,\n  MaybePromise,\n  Merge,\n  OutputEvents,\n  Prettify,\n} from './utilityTypes.ts'\nimport { awaitAll, normalizeArray } from './utils.ts'\nimport {\n  type WrappedEvent,\n  type WrappedEventBuilder,\n  handleEventError,\n  unwrapEvent,\n  wrappedEventBuilder,\n} from './wrappedEventBuilder.ts'\n\ntype UppercaseRecord<T extends Record<string, any>> = {\n  [K in keyof T]: K extends Capitalize<K & string>\n    ? any\n    : `Error: Key '${K & string}' must be Capitalized`\n}\n\ntype BaseEventMap = Record<\n  string,\n  z.ZodType | (z.ZodType | { schema: z.ZodType; version: number })[]\n>\n\ntype DownstreamRootPromise = () => Promise<unknown>\nconst downstreamRootsPromiseStore = new AsyncLocalStorage<\n  DownstreamRootPromise[]\n>()\n\nfunction registerRootPromiseToUpstream(rootPromise: DownstreamRootPromise) {\n  downstreamRootsPromiseStore.getStore()?.push(rootPromise)\n}\n\nasync function collectDownstreamRootPromise(handler: () => Promise<void>) {\n  const rootPromises: DownstreamRootPromise[] = []\n  await downstreamRootsPromiseStore.run(rootPromises, handler)\n  return async () => {\n    await Promise.all(rootPromises.map((promise) => promise()))\n  }\n}\n\ntype BaseInternalEvent<\n  Type extends string,\n  Version extends number,\n  Payload = unknown,\n> = BaseOutputEvent<Type, Version, Payload>\n\ntype InternalEvent<Event extends EventTemplate> = Prettify<\n  {\n    [K in Event as K['version']]: Omit<\n      BaseInternalEvent<K['type'], K['version'], z.output<K['schema']>>,\n      'createdAt' | 'position' | 'streamVersion'\n    > & {\n      // only set when folding persisted events (stream loading/replay);\n      // events yielded by a command fold before they are appended and have\n      // no position yet\n      position?: number\n    }\n  }[Event['version']]\n>\n\ntype InternalEventHandlers<Events extends EventTemplate> = {\n  [K in Events as `on${K['type']}`]?: (\n    event: InternalEvent<K>,\n  ) => MaybePromise<void>\n}\n\ntype EventsFromMap<EventMap extends BaseEventMap> = Prettify<\n  {\n    [K in keyof EventMap]: { type: K & string } & (EventMap[K] extends z.ZodType\n      ? { schema: EventMap[K]; version: 0 }\n      : EventMap[K] extends { schema: infer S; version: infer V }\n        ? S extends z.ZodType\n          ? { schema: S; version: V }\n          : never\n        : EventMap[K] extends Array<infer I>\n          ? I extends z.ZodType\n            ? { schema: I; version: 0 }\n            : I extends { schema: infer S; version: infer V }\n              ? { schema: S; version: V }\n              : never\n          : never)\n  }[keyof EventMap]\n>\n\ntype Constructor<T> = new (...args: any[]) => T\n\ntype Command = (\n  ...args: any[]\n) =>\n  | MaybePromise<void | WrappedEvent | WrappedEvent[]>\n  | Iterable<WrappedEvent>\n  | AsyncIterable<WrappedEvent>\n\ntype Utils = {\n  reset: () => void\n  replayUntil: (streamVersion: number) => Promise<void>\n}\n\ntype VersionBuilder = <V extends number, S extends z.ZodType>(\n  version: V,\n  schema: S,\n) => { schema: S; version: V }\n\n/**\n * Options for {@link Stream.settled}.\n *\n * `maxRetries` — how many times to reload the stream and re-apply the dispatched\n * commands when the append loses the optimistic-concurrency race\n * ({@link ConcurrencyError}). Defaults to `0` (no retry — surface the error, the\n * historical behaviour). Only the append is retried; command handlers must be\n * pure functions of loaded state and their arguments for retries to be safe.\n */\nexport type SettledOptions = {\n  maxRetries?: number\n}\n\ntype Stream<Commands extends Record<string, Command>, State> = {\n  [A in keyof Commands]: (\n    ...args: Parameters<Commands[A]>\n  ) => Stream<Commands, State>\n} & {\n  settled: (options?: SettledOptions) => Promise<Stream<Commands, State>>\n  state: () => Promise<State>\n  transformError: <T extends Error>(\n    error: Constructor<T>,\n    errorHandler: (commandError: CommandError<T>) => Error,\n  ) => Stream<Commands, State>\n  readonly streamId: string\n}\n\nexport type AnyStream = {\n  settled: (options?: SettledOptions) => Promise<AnyStream>\n  state: () => Promise<unknown>\n  transformError: <T extends Error>(\n    error: Constructor<T>,\n    errorHandler: (error: CommandError<T>) => Error,\n  ) => AnyStream\n}\n\nexport type AnyAggregateRoot = {\n  type: string\n  loadStream: (\n    id: string,\n    filter?: (event: BaseOutputEvent) => MaybePromise<boolean>,\n  ) => AnyStream\n  newStream: () => AnyStream\n  $inferState: any\n  $inferEvents: any\n  $inferEvent: any\n  $inferCommandParameters: any\n}\n\ntype EventHandlerOptions = {\n  streamId: string\n  extendLock: (ms?: number) => Promise<boolean>\n}\n\nexport type AggregateRootApi<\n  Name,\n  State = never,\n  Events extends EventTemplate = never,\n  Commands extends Record<string, Command> = Record<string, Command>,\n  Flags extends {\n    withInitialState: boolean\n    withEvents: boolean\n    withCommands: boolean\n    withEventHandlers: boolean\n    withSnapshots: boolean\n  } = {\n    withInitialState: false\n    withEvents: false\n    withCommands: true\n    withEventHandlers: true\n    withSnapshots: false\n  },\n> = {\n  withInitialState: <NextState extends Record<string, unknown>>(\n    state: NextState,\n  ) => Omit<\n    AggregateRootApi<\n      Name,\n      NextState,\n      Events,\n      Commands,\n      Merge<Flags, { withInitialState: true; withEventHandlers: false }>\n    >,\n    Keys<Merge<Flags, { withInitialState: true; withEventHandlers: false }>>\n  >\n  withCommands: <\n    NextCommands extends Record<\n      Exclude<string, 'state' | 'settled' | 'transformError' | 'streamId'>,\n      Command\n    >,\n  >(\n    handlers: [State] extends [never]\n      ? (\n          event: WrappedEventBuilder<Events>,\n          options: EventHandlerOptions,\n        ) => NextCommands\n      : (\n          state: Readonly<State>,\n          event: WrappedEventBuilder<Events>,\n          options: EventHandlerOptions,\n        ) => NextCommands,\n  ) => Omit<\n    AggregateRootApi<\n      Name,\n      State,\n      Events,\n      NextCommands,\n      Merge<\n        Flags,\n        { withInitialState: true; withCommands: true; withEvents: true }\n      >\n    >,\n    Keys<\n      Merge<\n        Flags,\n        { withInitialState: true; withCommands: true; withEvents: true }\n      >\n    >\n  >\n  withEvents: {\n    <EventMap extends BaseEventMap>(\n      handler: EventMap & UppercaseRecord<EventMap>,\n    ): Omit<\n      AggregateRootApi<\n        Name,\n        State,\n        EventsFromMap<EventMap>,\n        Commands,\n        Merge<\n          Flags,\n          {\n            withInitialState: true\n            withEvents: true\n            withCommands: false\n          }\n        >\n      >,\n      Keys<\n        Merge<\n          Flags,\n          {\n            withInitialState: true\n            withEvents: true\n            withCommands: false\n          }\n        >\n      >\n    >\n    <EventMap extends BaseEventMap>(\n      handler: (utils: {\n        version: VersionBuilder\n        z: typeof z\n      }) => EventMap & UppercaseRecord<EventMap>,\n    ): Omit<\n      AggregateRootApi<\n        Name,\n        State,\n        EventsFromMap<EventMap>,\n        Commands,\n        Merge<\n          Flags,\n          {\n            withInitialState: true\n            withEvents: true\n            withCommands: false\n          }\n        >\n      >,\n      Keys<\n        Merge<\n          Flags,\n          {\n            withInitialState: true\n            withEvents: true\n            withCommands: false\n          }\n        >\n      >\n    >\n  }\n  withEventHandlers: (\n    handler: (state: State, utils: Utils) => InternalEventHandlers<Events>,\n  ) => Omit<\n    AggregateRootApi<\n      Name,\n      State,\n      Events,\n      Commands,\n      Merge<\n        Flags,\n        { withInitialState: true; withEventHandlers: true; withEvents: true }\n      >\n    >,\n    Keys<\n      Merge<\n        Flags,\n        { withInitialState: true; withEventHandlers: true; withEvents: true }\n      >\n    >\n  >\n  withSnapshots: (\n    handler: (\n      state: State,\n      generate: SnapshotGenerator<Omit<Snapshot, 'schemaVersion' | 'state'>>,\n      utils: { z: typeof z },\n    ) => CompleteSnapshotGenerator,\n  ) => Omit<\n    AggregateRootApi<\n      Name,\n      State,\n      Events,\n      Commands,\n      Merge<Flags, { withSnapshots: true }>\n    >,\n    Keys<Merge<Flags, { withSnapshots: true }>>\n  >\n  loadStream: (\n    id: string,\n    filter?: (event: OutputEvents<Events>) => MaybePromise<boolean>,\n  ) => Stream<Commands, State>\n  newStream: (id?: string) => Stream<Commands, State>\n\n  $inferEvents: OutputEvents<Events>\n  $inferEvent: OutputEvents<Events> extends BaseOutputEvent\n    ? { [E in OutputEvents<Events> as E['type']]: E }\n    : never\n  $inferState: State\n  $inferCommandParameters: {\n    [CommandName in keyof Commands]: Parameters<Commands[CommandName]>\n  }\n  readonly type: Name\n}\n\nexport type InternalAggregateRootApi = {\n  linkEventStore: (\n    loadEvents: LoadEvents,\n    appendEvents: InternalAppendEvents,\n    emitEvents: EmitEvents,\n    transaction: Transaction,\n    lock: LockCreator,\n    snapshots?: AggregateRootSnapshotMethods,\n  ) => void\n  eventTypes: string[]\n  readonly type: string\n}\n\nconst snapshotSchema = z.object({\n  streamId: z.string(),\n  schemaVersion: z.int(),\n  state: z.unknown(),\n  createdAt: z.date(),\n  streamVersion: z.int(),\n  streamType: z.string(),\n  lastEventPosition: z.int(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n})\n\nexport type Snapshot = z.output<typeof snapshotSchema>\n\nexport type AggregateRootSnapshotMethods = {\n  get: (select: {\n    stream: string\n    id: string\n  }) => MaybePromise<Snapshot | null | undefined>\n  put: (snapshot: Snapshot) => MaybePromise<void>\n  delete: (\n    target: {\n      stream: string\n      id: string\n    },\n    fromPosition: number,\n  ) => MaybePromise<void>\n}\n\nexport function createAggregateRoot<Name extends string>(type: Name) {\n  let initialState: any = null\n  let createEventHandlers: (\n    state: any,\n  ) => InternalEventHandlers<any> = () => ({})\n\n  let loadEvents!: LoadEvents\n  let appendEvents!: InternalAppendEvents\n  let emitEvents!: EmitEvents\n  let snapshots: AggregateRootSnapshotMethods | undefined\n  let createLock!: LockCreator\n  let transaction!: Transaction\n\n  let createCommands: (\n    state: any,\n    eventBuilder: (name: string, payload: unknown) => WrappedEvent,\n    options: EventHandlerOptions,\n  ) => Record<string, Command> = () => ({})\n\n  const registeredEvents = new Map<string, Map<number, z.ZodType>>()\n  let createSnapshotApi:\n    | ((\n        state: any,\n        generate: SnapshotGenerator<any>,\n        utils: { z: typeof z },\n      ) => CompleteSnapshotGenerator & InternalSnapshotGenerator)\n    | null = null\n\n  const loadUntil = async (\n    state: any,\n    snapshotApi:\n      | (CompleteSnapshotGenerator & InternalSnapshotGenerator)\n      | undefined,\n    id: string,\n    untilPosition?: number,\n    filter?: (event: BaseOutputEvent) => MaybePromise<boolean>,\n  ) => {\n    let position = 0\n    let version = 0\n    if (snapshotApi) {\n      const snapshot = await snapshots?.get({\n        stream: type,\n        id,\n      })\n      if (snapshot) {\n        const result = snapshotSchema.safeParse(snapshot)\n\n        if (!result.success) {\n          throw new ValidationError(\n            'loaded aggregate root snapshot does not comply with schema',\n            result.error,\n          )\n        }\n\n        snapshotApi.internalApply(result.data)\n        position = snapshot.lastEventPosition\n        version = snapshot.streamVersion\n      }\n    }\n\n    const events = loadEvents(\n      { stream: type, id },\n      {\n        from: position,\n        to: untilPosition,\n      },\n    )\n    const eventHandlers = createEventHandlers(state)\n    for await (const event of events) {\n      version += 1\n      if ((await filter?.(event)) === false) {\n        continue\n      }\n      await (eventHandlers as any)[`on${event.type}`]?.(event)\n    }\n\n    return version\n  }\n\n  // A command as dispatched by the caller, recorded so it can be re-applied\n  // against a freshly-loaded stream when a settle() retries a ConcurrencyError.\n  type RecordedCommand = { name: string; args: any[] }\n\n  type CreateStreamConfig = {\n    // Whether to load the existing stream before commands run. `false` for\n    // newStream (expects version 0); `true` for loadStream and every retry.\n    load?: boolean\n    filter?: (event: BaseOutputEvent) => MaybePromise<boolean>\n    // Seeded on a retry so replayed commands re-apply automatically, and\n    // transformError handlers registered before settle() carry over.\n    replayCommands?: RecordedCommand[]\n    errorHandlerEntries?: [\n      Constructor<Error>,\n      (error: CommandError<Error>) => Error,\n    ][]\n  }\n\n  const createStream = (\n    state: any,\n    streamId: string,\n    config: CreateStreamConfig = {},\n  ) => {\n    // Captured at the dispatch site so a settle() retry can re-apply the\n    // commands within the same AsyncLocalStorage state (user metadata scopes,\n    // process-manager info, …) that the original attempt observed.\n    const dispatchContext = AsyncLocalStorage.snapshot()\n    let version = 0\n    const snapshotApi = createSnapshotApi?.(\n      state,\n      createSnapshotGenerator() as any,\n      { z },\n    )\n    const errorHandlers = new Map<\n      Constructor<Error>,\n      (error: CommandError<Error>) => Error\n    >(config.errorHandlerEntries)\n    const dispatchedCommands: RecordedCommand[] = []\n    let downstreamSettledPromise = () => Promise.resolve()\n    let releaseLock!: () => Promise<void>\n    let extendLock!: EventHandlerOptions['extendLock']\n\n    const warnReleaseLock = () => {\n      if (releasedAfterChain) {\n        console.warn(`aggregate root for ${type}:${streamId} was open too long`)\n      }\n      releaseLock()\n    }\n\n    const processEvents = async (events: BaseInputEvent[]) => {\n      if (!appendEvents) {\n        throw new Error(\n          `aggregate root ${type} is not linked to an event store`,\n        )\n      }\n\n      const persistedEvents = await appendEvents(\n        { stream: type, id: streamId },\n        events,\n        version,\n      )\n\n      warnReleaseLock()\n\n      for (const persistedEvent of persistedEvents) {\n        const snapshot = await snapshotApi?.internalCapture(\n          persistedEvent,\n          persistedEvent.streamVersion,\n        )\n\n        if (snapshot) {\n          await snapshots?.put({\n            state: snapshot.state,\n            lastEventPosition: persistedEvent.position,\n            streamId,\n            streamVersion: version,\n            streamType: type,\n            schemaVersion: snapshot.version,\n            createdAt: new Date(),\n          })\n        }\n      }\n\n      version += events.length\n\n      downstreamSettledPromise = await collectDownstreamRootPromise(() =>\n        emitEvents(persistedEvents),\n      )\n    }\n\n    let commandChain = createLock([type, streamId]).then((lock) => {\n      releaseLock = lock.release\n      extendLock = lock.extend\n      return [] as Error | BaseInputEvent[]\n    })\n    let commandChainTouched = false\n    let releasedAfterChain = false\n    let transactionDelay: TransactionDelay | undefined\n\n    const stateReady = Promise.withResolvers<Error | undefined>()\n\n    const rawCommands = createCommands(state, wrappedEventBuilder, {\n      streamId,\n      extendLock,\n    })\n\n    const commands = Object.fromEntries(\n      Object.entries(rawCommands).map(([commandName, commandFn]) => [\n        commandName,\n        (...args: any[]) => {\n          // don't create new events when refreshing the process manager\n          if (isRefreshing()) {\n            return api.commands\n          }\n\n          // Record for a potential settle() retry (reload + re-apply).\n          dispatchedCommands.push({ name: commandName, args })\n\n          const commandId = crypto.randomUUID()\n          transactionDelay ??= transaction.delay()\n          commandChainTouched = true\n          commandChain = commandChain\n            .then(async (previousEvents) => {\n              if (previousEvents instanceof Error) {\n                return previousEvents\n              }\n              const events = (\n                await normalizeArray(\n                  commandFn.apply(rawCommands, args),\n                  () => extendLock(),\n                )\n              ).filter((event) => Boolean(event))\n\n              const baseInputEvents = await Promise.all(\n                events.map(async (event) => {\n                  event.withAdditionalMetadata({ commandName })\n                  event.withDefaultCausationId(commandId)\n\n                  const unwrappedEvent = unwrapEvent(event)\n\n                  const eventVersions = registeredEvents.get(\n                    unwrappedEvent.type,\n                  )\n                  if (!eventVersions) {\n                    throw new Error(\n                      `cannot append unknown event ${unwrappedEvent.type}`,\n                    )\n                  }\n                  const latestVersion = Math.max(\n                    ...Array.from(eventVersions.keys()),\n                  )\n                  const schema = eventVersions.get(latestVersion)!\n\n                  const result = schema.safeParse(unwrappedEvent.payload)\n                  if (!result.success) {\n                    const error = new EventValidationError(\n                      `payload does not comply with schema for event ${unwrappedEvent.type}@${latestVersion} at stream ${streamId}`,\n                      result.error,\n                    )\n\n                    await handleEventError(event, error)\n                    throw error\n                  }\n\n                  unwrappedEvent.payload = result.data\n\n                  return {\n                    ...unwrappedEvent,\n                    schemaVersion: latestVersion,\n                  }\n                }),\n              )\n\n              const eventHandlers = createEventHandlers(state)\n              for (const event of baseInputEvents) {\n                const processManagerInfo = getProcessManagerInfo()\n                if (processManagerInfo) {\n                  if (\n                    processManagerInfo.event.streamId === streamId &&\n                    processManagerInfo.event.streamType === type &&\n                    processManagerInfo.event.type === event.type &&\n                    deepEqual(processManagerInfo.event.payload, event.payload)\n                  ) {\n                    return new InfiniteLoopError(\n                      `Infinite loop detected. Process Manager \"${processManagerInfo.name}\" listens and emits same event \"${event.type}\" for stream ${type}:${streamId}, causing a recurring event cycle`,\n                    )\n                  }\n                }\n\n                await eventHandlers[`on${event.type}`]?.({\n                  ...event,\n                  streamId,\n                  streamType: type,\n                })\n              }\n\n              return [...previousEvents, ...baseInputEvents]\n            })\n            .catch((error) => {\n              if (!(error instanceof Error)) {\n                throw error\n              }\n\n              const commandError = new CommandError(\n                type,\n                commandName,\n                streamId,\n                error,\n              )\n              for (const [ErrorType, handler] of errorHandlers) {\n                if (error instanceof ErrorType) {\n                  return new CommandError(\n                    type,\n                    commandName,\n                    streamId,\n                    handler(commandError),\n                  )\n                }\n              }\n\n              return commandError\n            })\n\n          const currentCommandChain = commandChain\n          currentCommandChain.then(async (allEvents) => {\n            if (\n              // we are the last command\n              currentCommandChain === commandChain\n            ) {\n              stateReady.resolve(\n                allEvents instanceof Error ? allEvents : undefined,\n              )\n\n              commandChain = commandChain.then(async () => {\n                // no Error in chain\n                if (Array.isArray(allEvents)) {\n                  transactionDelay?.resolve()\n                  try {\n                    await transactionDelay?.commit()\n                  } catch (error) {\n                    if (error instanceof Error) {\n                      warnReleaseLock()\n                      return error\n                    }\n                  }\n\n                  await processEvents(allEvents)\n                  return []\n                }\n\n                warnReleaseLock()\n                transactionDelay?.reject(allEvents)\n                if (transaction.active) {\n                  return []\n                }\n\n                throw allEvents\n              })\n            }\n          })\n\n          return api.commands\n        },\n      ]),\n    )\n\n    setImmediate(() => {\n      if (!commandChainTouched) {\n        releasedAfterChain = true\n        commandChain = commandChain.then((v) => {\n          releaseLock()\n          return v\n        })\n      }\n    })\n\n    const api = {\n      load(filter?: (event: BaseOutputEvent) => MaybePromise<boolean>) {\n        // ensure commands are executed after load is finished\n        commandChain = commandChain\n          .then(() =>\n            loadUntil(state, snapshotApi, streamId, undefined, filter),\n          )\n          .then((loadedVersion) => {\n            version = loadedVersion\n            return []\n          })\n      },\n      commands: {\n        ...commands,\n        async state() {\n          const maybeError = await Promise.race([\n            stateReady.promise,\n            awaitAll(() => commandChain),\n          ])\n\n          if (maybeError) {\n            throw maybeError\n          }\n\n          return state\n        },\n        async settled(options?: SettledOptions): Promise<any> {\n          const parentProcessManager = getProcessManagerInfo()\n          if (parentProcessManager) {\n            const error = new Error(\n              `aggregateRoot.settled() cannot be called inside a process manager. Attempted on aggregate stream \"${type}\" within Process Manager ${parentProcessManager.name}. To configure how dispatched streams settle, pass options to createProcessManager(name, { settled }).`,\n            )\n            commandChain = commandChain.then(() => error)\n            throw error\n          }\n\n          if (transaction.active) {\n            const error = new Error(\n              `aggregateRoot.settled() cannot be called inside a transaction. Attempted on aggregate stream \"${type}\". To configure how dispatched streams settle, pass options to transaction(handler, { settled }).`,\n            )\n            commandChain = commandChain.then(() => error)\n            throw error\n          }\n\n          const maxRetries = options?.maxRetries ?? 0\n\n          try {\n            await awaitAll(() => commandChain)\n          } catch (error) {\n            // Optimistic-concurrency recovery: another writer advanced the\n            // stream between load and append. Reload and re-apply the same\n            // commands against the fresh version. A failed append leaves this\n            // attempt's lock held (it never reached releaseLock), so release it\n            // before the retry re-acquires — otherwise the retry blocks until\n            // the lock's TTL lapses.\n            if (maxRetries > 0 && error instanceof ConcurrencyError) {\n              await releaseLock?.()\n\n              // Re-create the stream within the async context captured at the\n              // dispatch site, so the replayed commands and event\n              // post-processing observe the same AsyncLocalStorage state as\n              // the original attempt. Two scopes are explicitly exited: the\n              // transaction (the first attempt already passed its commit gate;\n              // re-entering the committed store would swallow errors and\n              // register dead delays) and the upstream collection (this retry\n              // is settled right here, not through another auto-settle\n              // registration).\n              const retryStream = dispatchContext(() =>\n                transaction.exit(() =>\n                  downstreamRootsPromiseStore.exit(() =>\n                    createStream(clone(initialState), streamId, {\n                      load: true,\n                      filter: config.filter,\n                      replayCommands: dispatchedCommands,\n                      errorHandlerEntries: Array.from(errorHandlers),\n                    }),\n                  ),\n                ),\n              )\n\n              return retryStream.commands.settled({\n                ...options,\n                maxRetries: maxRetries - 1,\n              })\n            }\n\n            throw error\n          }\n\n          await downstreamSettledPromise()\n          return api.commands\n        },\n        transformError(\n          error: Constructor<Error>,\n          handler: (error: Error) => never,\n        ) {\n          errorHandlers.set(error, handler)\n          return api.commands\n        },\n        streamId,\n      },\n    }\n\n    // Streams dispatched inside a process manager or a transaction cannot\n    // call settled() themselves — the surrounding scope settles them when it\n    // completes. Capture the defaults declared on that scope\n    // (createProcessManager / transaction options) so the auto-settle\n    // inherits them.\n    const autoSettleOptions =\n      getProcessManagerInfo()?.settledDefaults ?? transaction.settledDefaults\n\n    registerRootPromiseToUpstream(() => api.commands.settled(autoSettleOptions))\n    transaction.after(() => api.commands.settled(autoSettleOptions))\n\n    // Fold existing events before commands run (loadStream, and every retry).\n    if (config.load) {\n      api.load(config.filter)\n    }\n\n    // Re-apply the caller's commands on a retry so the fresh, reloaded stream\n    // reproduces the original intent against the current version.\n    for (const { name, args } of config.replayCommands ?? []) {\n      ;(api.commands as any)[name](...args)\n    }\n\n    return api\n  }\n\n  const api: AggregateRootApi<Name> & InternalAggregateRootApi = {\n    type,\n    withInitialState: (state) => {\n      initialState = clone(state)\n      return api as any\n    },\n\n    withCommands(handlers) {\n      createCommands = (state, eventBuilder, options) => {\n        if (state === null) {\n          return (handlers as any)(eventBuilder, options)\n        }\n\n        return (handlers as any)(state, eventBuilder, options)\n      }\n\n      return api as any\n    },\n\n    withEvents(handler) {\n      const eventMap: BaseEventMap =\n        typeof handler === 'function'\n          ? handler({ version: (version, schema) => ({ version, schema }), z })\n          : handler\n\n      for (const [type, config] of Object.entries(eventMap)) {\n        const versions = Array.isArray(config) ? config : [config]\n        for (const v of versions) {\n          let schema: z.ZodType\n          let version: number\n          if (typeof v === 'object' && 'version' in v) {\n            schema = v.schema\n            version = v.version\n          } else {\n            schema = v\n            version = 0\n          }\n\n          if (registeredEvents.get(type)?.has(version)) {\n            throw new Error(\n              `event ${type} is already registered in version ${version}`,\n            )\n          }\n\n          if (!registeredEvents.has(type)) {\n            registeredEvents.set(type, new Map())\n          }\n          registeredEvents.get(type)!.set(version, schema)\n        }\n      }\n      return api as any\n    },\n\n    withEventHandlers(handler) {\n      createEventHandlers = handler as any\n      return api as any\n    },\n\n    withSnapshots: (handler) => {\n      createSnapshotApi = handler as any\n      return api as any\n    },\n\n    newStream(id) {\n      if (!loadEvents) {\n        throw new Error(\n          `aggregate root ${type} is not linked to an event store`,\n        )\n      }\n\n      const parentProjectionName = getProjectionInfo()?.name\n      if (parentProjectionName) {\n        throw new Error(\n          `aggregateRoot.newStream() cannot be called inside a projection. Attempted on aggregate stream ${type} within Projection ${parentProjectionName}.`,\n        )\n      }\n      return createStream(clone(initialState), id ?? crypto.randomUUID(), {\n        load: false,\n      }).commands as any\n    },\n\n    loadStream(id, filter) {\n      if (!loadEvents) {\n        throw new Error(\n          `aggregate root ${type} is not linked to an event store`,\n        )\n      }\n\n      const parentProjectionName = getProjectionInfo()?.name\n      if (parentProjectionName) {\n        throw new Error(\n          `aggregateRoot.loadStream(\"${id}\") cannot be called inside a projection. Attempted on aggregate stream ${type} within Projection ${parentProjectionName}.`,\n        )\n      }\n      return createStream(clone(initialState), id, {\n        load: true,\n        filter: filter as any,\n      }).commands as any\n    },\n\n    linkEventStore(load, append, emit, trans, lock, snap) {\n      loadEvents = load\n      appendEvents = append\n      emitEvents = emit\n      transaction = trans\n      createLock = lock\n      snapshots = snap\n    },\n    get eventTypes() {\n      return Array.from(registeredEvents.keys())\n    },\n    $inferEvents: null as never,\n    $inferEvent: null as never,\n    $inferState: null as never,\n    $inferCommandParameters: null as never,\n  }\n\n  return api as Omit<\n    AggregateRootApi<Name>,\n    'withCommands' | 'withEventHandlers'\n  >\n}\n"
-  ],
-  "mappings": "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",
-  "debugId": "B5710AAA1BE9FD0F64756E2164756E21",
-  "names": []
-}

package/dist/chunk-yn2sjcg3.js.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/createCheckpointApi.ts"],
-  "sourcesContent": [
-    "import z from 'zod/v4'\n\nimport type { LoadEvents } from './createEventStore.ts'\nimport { CheckpointConcurrencyError, ValidationError } from './errors.ts'\nimport type {\n  BaseOutputEvent,\n  MaybePromise,\n  StreamEvents,\n} from './utilityTypes.ts'\n\nconst checkpointSchema = z.object({\n  lastEventPosition: z.int(),\n  type: z.enum(['projection', 'processManager']),\n  name: z.string(),\n  metadata: z.record(z.string(), z.any()),\n  version: z.int(),\n})\n\nexport type Checkpoint = z.output<typeof checkpointSchema>\n\nexport type CheckpointMethods = {\n  get: (\n    type: 'projection' | 'processManager',\n    name: string,\n  ) => MaybePromise<Checkpoint | null | undefined>\n  delete: (\n    type: 'projection' | 'processManager',\n    name: string,\n  ) => MaybePromise<void>\n  /**\n   * Persist a checkpoint using optimistic concurrency control.\n   *\n   * The write must only succeed if the currently stored version equals\n   * `expectedVersion` (or, when `expectedVersion` is `null`, if no checkpoint\n   * exists yet). `checkpoint.version` holds the version to store on success.\n   * Return `true` when the write was applied and `false` when it was rejected\n   * because another writer had advanced the checkpoint in the meantime.\n   */\n  upsert: (\n    checkpoint: Checkpoint,\n    expectedVersion: number | null,\n  ) => MaybePromise<boolean>\n}\n\nexport function createCheckpointApi(\n  params: CheckpointMethods & {\n    loadEvents: LoadEvents\n    relatedStreamEvents: StreamEvents[] | null\n    name: string\n    type: 'processManager' | 'projection'\n    apply: (event: BaseOutputEvent) => MaybePromise<void>\n    applyAfter?: (event: BaseOutputEvent) => MaybePromise<void>\n  },\n) {\n  // In-memory view of the persisted checkpoint version. `null` means \"no\n  // checkpoint has been written yet\". It is kept in sync with the store on\n  // every load/upsert so optimistic-concurrency writes can detect when another\n  // instance has advanced the same checkpoint.\n  let version: number | null = null\n\n  const api = {\n    relatedStreamEvents: params.relatedStreamEvents,\n    async clear() {\n      await params.delete(params.type, params.name)\n      version = null\n    },\n    /**\n     * Load the persisted checkpoint and sync the local version. Returns the\n     * raw checkpoint (or `null`), so callers can rehydrate their own state\n     * (e.g. a process manager reloading its folded state) from it.\n     */\n    async load() {\n      const checkpoint = await params.get(params.type, params.name)\n      version = checkpoint?.version ?? null\n      return checkpoint ?? null\n    },\n    /**\n     * Persist the checkpoint position (and optional metadata) for the given\n     * event.\n     *\n     * - `'cas'` (compare-and-swap): the write must land on top of the exact\n     *   version we last observed. If another writer advanced the checkpoint,\n     *   the local version is refreshed and a {@link CheckpointConcurrencyError}\n     *   is thrown so the caller can re-fold its state and retry. Used for\n     *   process managers that fold state into the checkpoint.\n     * - `'monotonic'` (default): retries on conflict, skipping the write once\n     *   the stored position already covers this event. Safe for cursors with\n     *   no derived state (projections, stateless/after-effect writes).\n     */\n    async upsert(\n      event: BaseOutputEvent,\n      metadata: Record<string, any> = {},\n      mode: 'cas' | 'monotonic' = 'monotonic',\n    ) {\n      while (true) {\n        const expectedVersion = version\n        const nextVersion = (expectedVersion ?? -1) + 1\n        const committed = await params.upsert(\n          {\n            lastEventPosition: event.position,\n            type: params.type,\n            name: params.name,\n            metadata,\n            version: nextVersion,\n          },\n          expectedVersion,\n        )\n\n        if (committed) {\n          version = nextVersion\n          return\n        }\n\n        // Another writer advanced this checkpoint. Refresh our view of it.\n        const current = await api.load()\n\n        if (mode === 'cas') {\n          throw new CheckpointConcurrencyError(\n            params.type,\n            params.name,\n            expectedVersion,\n          )\n        }\n\n        // monotonic: the stored cursor already covers this event, nothing to do.\n        if (current && current.lastEventPosition >= event.position) {\n          return\n        }\n      }\n    },\n    async rehydrated(\n      options: {\n        onMetadata?: (metadata: Record<string, any>) => unknown\n        getMetadata?: () => Record<string, any>\n        onProgress?: (index: number, event: BaseOutputEvent) => void\n      } = {},\n    ) {\n      const checkpoint = await api.load()\n      let startPosition = 0\n      if (checkpoint) {\n        const result = checkpointSchema.safeParse(checkpoint)\n        if (!result.success) {\n          throw new ValidationError(\n            `loaded checkpoint for ${params.type} ${params.name} does not comply with schema`,\n            result.error,\n          )\n        }\n        startPosition = checkpoint.lastEventPosition + 1\n        options.onMetadata?.(checkpoint.metadata)\n      }\n\n      const events = params.loadEvents(params.relatedStreamEvents, {\n        from: startPosition,\n      })\n\n      let index = 0\n      let lastEvent: BaseOutputEvent | null = null\n      for await (const event of events) {\n        lastEvent = event\n        await params.apply(event)\n        index++\n        options.onProgress?.(index, event)\n      }\n\n      if (!lastEvent) {\n        return // up to date\n      }\n\n      if (params.applyAfter) {\n        for await (const event of events) {\n          await params.applyAfter(event)\n        }\n      }\n\n      await api.upsert(lastEvent, options.getMetadata?.())\n    },\n  }\n\n  return api\n}\n\nexport type CheckpointApi = ReturnType<typeof createCheckpointApi>\n"
-  ],
-  "mappings": ";;;;;;AAAA;AAUA,IAAM,mBAAmB,EAAE,OAAO;AAAA,EAChC,mBAAmB,EAAE,IAAI;AAAA,EACzB,MAAM,EAAE,KAAK,CAAC,cAAc,gBAAgB,CAAC;AAAA,EAC7C,MAAM,EAAE,OAAO;AAAA,EACf,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,IAAI,CAAC;AAAA,EACtC,SAAS,EAAE,IAAI;AACjB,CAAC;AA4BM,SAAS,mBAAmB,CACjC,QAQA;AAAA,EAKA,IAAI,UAAyB;AAAA,EAE7B,MAAM,MAAM;AAAA,IACV,qBAAqB,OAAO;AAAA,SACtB,MAAK,GAAG;AAAA,MACZ,MAAM,OAAO,OAAO,OAAO,MAAM,OAAO,IAAI;AAAA,MAC5C,UAAU;AAAA;AAAA,SAON,KAAI,GAAG;AAAA,MACX,MAAM,aAAa,MAAM,OAAO,IAAI,OAAO,MAAM,OAAO,IAAI;AAAA,MAC5D,UAAU,YAAY,WAAW;AAAA,MACjC,OAAO,cAAc;AAAA;AAAA,SAejB,OAAM,CACV,OACA,WAAgC,CAAC,GACjC,OAA4B,aAC5B;AAAA,MACA,OAAO,MAAM;AAAA,QACX,MAAM,kBAAkB;AAAA,QACxB,MAAM,eAAe,mBAAmB,MAAM;AAAA,QAC9C,MAAM,YAAY,MAAM,OAAO,OAC7B;AAAA,UACE,mBAAmB,MAAM;AAAA,UACzB,MAAM,OAAO;AAAA,UACb,MAAM,OAAO;AAAA,UACb;AAAA,UACA,SAAS;AAAA,QACX,GACA,eACF;AAAA,QAEA,IAAI,WAAW;AAAA,UACb,UAAU;AAAA,UACV;AAAA,QACF;AAAA,QAGA,MAAM,UAAU,MAAM,IAAI,KAAK;AAAA,QAE/B,IAAI,SAAS,OAAO;AAAA,UAClB,MAAM,IAAI,2BACR,OAAO,MACP,OAAO,MACP,eACF;AAAA,QACF;AAAA,QAGA,IAAI,WAAW,QAAQ,qBAAqB,MAAM,UAAU;AAAA,UAC1D;AAAA,QACF;AAAA,MACF;AAAA;AAAA,SAEI,WAAU,CACd,UAII,CAAC,GACL;AAAA,MACA,MAAM,aAAa,MAAM,IAAI,KAAK;AAAA,MAClC,IAAI,gBAAgB;AAAA,MACpB,IAAI,YAAY;AAAA,QACd,MAAM,SAAS,iBAAiB,UAAU,UAAU;AAAA,QACpD,IAAI,CAAC,OAAO,SAAS;AAAA,UACnB,MAAM,IAAI,gBACR,yBAAyB,OAAO,QAAQ,OAAO,oCAC/C,OAAO,KACT;AAAA,QACF;AAAA,QACA,gBAAgB,WAAW,oBAAoB;AAAA,QAC/C,QAAQ,aAAa,WAAW,QAAQ;AAAA,MAC1C;AAAA,MAEA,MAAM,SAAS,OAAO,WAAW,OAAO,qBAAqB;AAAA,QAC3D,MAAM;AAAA,MACR,CAAC;AAAA,MAED,IAAI,QAAQ;AAAA,MACZ,IAAI,YAAoC;AAAA,MACxC,iBAAiB,SAAS,QAAQ;AAAA,QAChC,YAAY;AAAA,QACZ,MAAM,OAAO,MAAM,KAAK;AAAA,QACxB;AAAA,QACA,QAAQ,aAAa,OAAO,KAAK;AAAA,MACnC;AAAA,MAEA,IAAI,CAAC,WAAW;AAAA,QACd;AAAA,MACF;AAAA,MAEA,IAAI,OAAO,YAAY;AAAA,QACrB,iBAAiB,SAAS,QAAQ;AAAA,UAChC,MAAM,OAAO,WAAW,KAAK;AAAA,QAC/B;AAAA,MACF;AAAA,MAEA,MAAM,IAAI,OAAO,WAAW,QAAQ,cAAc,CAAC;AAAA;AAAA,EAEvD;AAAA,EAEA,OAAO;AAAA;",
-  "debugId": "E7ED2588EB8CF7CA64756E2164756E21",
-  "names": []
-}