@velajs/vela 1.19.0 → 1.19.1

package/dist/live/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["encodeListDelta","DEFAULT_KEY_FIELD","isClientLiveFrame","LIVE_PROTOCOL","LIVE_ERROR_CODES","encodeLiveEnvelope","COMMIT_CURSOR_HEADER","COMMIT_EPOCH_HEADER"],"sources":["../../src/live/live.cursor.ts","../../src/live/live.tokens.ts","../../src/live/live.decorators.ts","../../src/live/live.delta.ts","../../src/live/presence.ts","../../src/live/live.engine.ts","../../src/live/live.invalidation.ts","../../src/live/live.module.ts"],"sourcesContent":["import type { CommitStamp, CursorLog, ResumeVerdict } from './live.types';\n\ninterface LogEntry {\n  seq: number;\n  tags: string[];\n}\n\nconst intersects = (a: readonly string[], b: ReadonlySet<string>): boolean =>\n  a.some((tag) => b.has(tag));\n\n/**\n * The in-core `CursorLog`: a bounded in-memory ring, epoch minted per process\n * (Web Crypto). A restart rolls the epoch, so every reconnecting client falls\n * back to snapshot — exactly the documented node/dev semantics. Within one\n * process lifetime resume works for gaps the ring still covers; a trimmed gap\n * degrades to snapshot (mirrors lunora's CDC retention rule,\n * `ctx-db-cdc.ts` — retention gap → snapshot).\n *\n * The Cloudflare transport replaces this with a Durable-Object SQLite log so\n * resume survives hibernation and eviction.\n */\nexport class InMemoryCursorLog implements CursorLog {\n  private readonly epoch = crypto.randomUUID();\n  private readonly entries: LogEntry[] = [];\n  private seq = 0;\n\n  constructor(private readonly maxEntries = 1024) {}\n\n  append(tags: string[]): CommitStamp {\n    this.seq += 1;\n    this.entries.push({ seq: this.seq, tags });\n    if (this.entries.length > this.maxEntries) {\n      this.entries.splice(0, this.entries.length - this.maxEntries);\n    }\n    return { cursor: this.seq, epoch: this.epoch };\n  }\n\n  current(): CommitStamp {\n    return { cursor: this.seq, epoch: this.epoch };\n  }\n\n  evaluateResume(\n    sinceCursor: number,\n    sinceEpoch: string,\n    subscriptionTags: string[],\n  ): ResumeVerdict {\n    // Forked timeline (restart/reset) — the client's cursor means nothing here.\n    if (sinceEpoch !== this.epoch) return 'snapshot';\n    // Rollback guard: a cursor from the future is unexplainable.\n    if (sinceCursor > this.seq) return 'snapshot';\n    if (sinceCursor === this.seq) return 'resume';\n    // Retention: the ring must still cover (sinceCursor, seq].\n    const oldest = this.entries[0];\n    if (oldest === undefined || oldest.seq > sinceCursor + 1) return 'snapshot';\n\n    const subTags = new Set(subscriptionTags);\n    for (const entry of this.entries) {\n      if (entry.seq <= sinceCursor) continue;\n      if (intersects(entry.tags, subTags)) return 'rerun';\n    }\n    return 'resume';\n  }\n}\n","import { InjectionToken } from '../index';\nimport type { CursorLog, LiveDriver, LiveModuleOptions } from './live.types';\n\n// Free-form metadata keys — same string-token convention as the queue module.\nexport const LIVE_RESOLVER_METADATA = 'vela:live:resolver';\nexport const LIVE_QUERY_METADATA = 'vela:live:query';\n\n/** The invalidation driver in effect for a `LiveModule` instance (`localLive()` by default). */\nexport const LIVE_DRIVER = new InjectionToken<LiveDriver>('vela:live:driver');\n\n/** The ordered tag-invalidation log backing cursors/epochs for this log scope. */\nexport const LIVE_CURSOR_LOG = new InjectionToken<CursorLog>('vela:live:cursor-log');\n\n// forRoot() options carrier.\nexport const LIVE_MODULE_OPTIONS = new InjectionToken<LiveModuleOptions>('LIVE_MODULE_OPTIONS');\n","import { createDiscoverableDecorator, defineMetadata, getMetadata } from '../index';\nimport { LIVE_QUERY_METADATA, LIVE_RESOLVER_METADATA } from './live.tokens';\nimport type { LiveQueryMetadata, LiveQueryOptions, LiveResolverMetadata } from './live.types';\n\nconst LiveResolverMeta = createDiscoverableDecorator<LiveResolverMetadata>(LIVE_RESOLVER_METADATA);\n\n/**\n * Marks a provider class as a live-query resolver:\n *\n * ```ts\n * @LiveResolver()\n * @Injectable()\n * class TodoLive {\n *   constructor(private readonly todos: TodoService) {}\n *\n *   @LiveQuery('todos.list', { tags: (a: { listId: string }) => [`todos:${a.listId}`] })\n *   list(args: { listId: string }, ctx: LiveQueryContext) {\n *     return this.todos.byList(args.listId, ctx.identity?.userId);\n *   }\n * }\n * ```\n *\n * Clients subscribe by query name over the `$live` reserved event; the engine\n * re-runs a handler whenever one of its tags is invalidated and pushes the\n * result (as a keyed delta when possible). Stack with `@Injectable()`, exactly\n * like `@Processor`.\n */\nexport function LiveResolver(): ClassDecorator {\n  return LiveResolverMeta({}) as ClassDecorator;\n}\n\n/**\n * Declares a live query on a resolver method. The handler receives\n * `(args, ctx: LiveQueryContext)` positionally — args are validated once at\n * subscribe (via `options.parse`), then replayed verbatim into every re-run\n * under the subscriber's captured identity.\n */\nexport function LiveQuery<A = unknown>(\n  name: string,\n  options: LiveQueryOptions<A>,\n): MethodDecorator {\n  return (target: object, propertyKey: string | symbol) => {\n    const ctor = target.constructor;\n    const existing =\n      (getMetadata(LIVE_QUERY_METADATA, ctor) as LiveQueryMetadata[] | undefined) ?? [];\n    existing.push({ name, methodName: propertyKey, options: options as LiveQueryOptions });\n    defineMetadata(LIVE_QUERY_METADATA, existing, ctor);\n  };\n}\n\n/** `@LiveQuery` entries declared on a resolver class (declaration order). */\nexport function getLiveQueries(resolverClass: object): LiveQueryMetadata[] {\n  return (getMetadata(LIVE_QUERY_METADATA, resolverClass) as LiveQueryMetadata[] | undefined) ?? [];\n}\n","import { DEFAULT_KEY_FIELD, encodeListDelta } from '@velajs/live-protocol';\nimport type { ServerLiveFrame } from '@velajs/live-protocol';\nimport type { CommitStamp, SubscriptionRecord } from './live.types';\n\n/**\n * Decide what one re-run puts on the wire — pure, so the contract is\n * unit-testable without sockets:\n *\n * - byte-identical to the baseline → `settled` (cursor still advances; this\n *   is what drops client optimistic layers for writes that didn't change the\n *   result);\n * - baseline exists and the shared codec can diff → `delta` (batched keyed\n *   row ops);\n * - otherwise (first send after subscribe/resume, codec bailed, unparseable\n *   baseline) → full `data` snapshot.\n */\nexport function encodeSubscriptionUpdate(\n  record: SubscriptionRecord,\n  json: string,\n  result: unknown,\n  stamp: CommitStamp,\n  initial: boolean,\n): ServerLiveFrame {\n  const settled: ServerLiveFrame = {\n    t: 'settled',\n    sub: record.sub,\n    cursor: stamp.cursor,\n    epoch: stamp.epoch,\n  };\n\n  if (!initial && record.lastJson !== undefined) {\n    if (record.lastJson === json) return settled;\n\n    let previous: unknown;\n    let parsed = false;\n    try {\n      previous = JSON.parse(record.lastJson);\n      parsed = true;\n    } catch {\n      // Unparseable baseline — fall through to a snapshot.\n    }\n    if (parsed) {\n      const ops = encodeListDelta(previous, result, record.key ?? DEFAULT_KEY_FIELD);\n      if (ops !== undefined && ops.length > 0) {\n        return { t: 'delta', sub: record.sub, ops, cursor: stamp.cursor, epoch: stamp.epoch };\n      }\n      if (ops !== undefined) return settled;\n    }\n  }\n\n  return { t: 'data', sub: record.sub, snapshot: result, cursor: stamp.cursor, epoch: stamp.epoch };\n}\n","import { Inject, Injectable } from '../index';\nimport { LiveQuery, LiveResolver } from './live.decorators';\n\n/** The invalidation tag for one room's roster. `$`-prefixed: never collides with app tags. */\nexport const presenceTag = (room: string): string => `$presence:${room}`;\n\n/** The built-in roster query name (`useLiveQuery`-able like any app query). */\nexport const PRESENCE_ROSTER_QUERY = '$presence.roster';\n\n/** One present connection as returned by the roster query. Keyed by `id` so list deltas apply. */\nexport interface PresenceMember {\n  /** The connection id that heartbeats this membership. */\n  id: string;\n  meta?: unknown;\n  lastSeen: number;\n}\n\ninterface RoomState {\n  members: Map<string, { meta?: unknown; lastSeen: number }>;\n}\n\n/**\n * The presence preset's server half. Heartbeats arrive as `{ t: 'presence' }`\n * frames on the live socket (routed here by the engine); the roster is a\n * built-in live query invalidated per room. Departure is immediate: the WS\n * close hook reaps the member without waiting out the TTL. Staleness (an\n * ungraceful drop the transport never noticed) is filtered AT READ TIME —\n * no timers, per the edge rules (`setInterval` is forbidden).\n *\n * Scope note: the roster lives in this log scope (one process on node, one\n * room-DO on Cloudflare — where it is exactly the room's roster).\n */\nexport class PresenceService {\n  private readonly rooms = new Map<string, RoomState>();\n  private readonly roomsByClient = new Map<string, Set<string>>();\n  private invalidator?: (tags: string[]) => void;\n\n  constructor(\n    private readonly ttlMs = 30_000,\n    readonly enabled = true,\n  ) {}\n\n  /** Wired by the engine so beats/reaps invalidate through the live driver. */\n  bindInvalidator(invalidator: (tags: string[]) => void): void {\n    this.invalidator = invalidator;\n  }\n\n  beat(room: string, clientId: string, meta?: unknown): void {\n    if (!this.enabled) return;\n    let state = this.rooms.get(room);\n    if (!state) {\n      state = { members: new Map() };\n      this.rooms.set(room, state);\n    }\n    state.members.set(clientId, { meta, lastSeen: Date.now() });\n\n    let joined = this.roomsByClient.get(clientId);\n    if (!joined) {\n      joined = new Set();\n      this.roomsByClient.set(clientId, joined);\n    }\n    joined.add(room);\n\n    this.invalidator?.([presenceTag(room)]);\n  }\n\n  /** Immediate departure on socket close — peers see it without a TTL wait. */\n  reap(clientId: string): void {\n    const joined = this.roomsByClient.get(clientId);\n    if (!joined) return;\n    this.roomsByClient.delete(clientId);\n    for (const room of joined) {\n      const state = this.rooms.get(room);\n      if (!state) continue;\n      state.members.delete(clientId);\n      if (state.members.size === 0) this.rooms.delete(room);\n      this.invalidator?.([presenceTag(room)]);\n    }\n  }\n\n  roster(room: string): PresenceMember[] {\n    const state = this.rooms.get(room);\n    if (!state) return [];\n    const oldestAlive = Date.now() - this.ttlMs;\n    return [...state.members.entries()]\n      .filter(([, member]) => member.lastSeen >= oldestAlive)\n      .map(([id, member]) => ({ id, meta: member.meta, lastSeen: member.lastSeen }));\n  }\n}\n\n/** The built-in resolver backing `$presence.roster`. Registered by `LiveModule` unless presence is disabled. */\n@LiveResolver()\n@Injectable()\nexport class PresenceResolver {\n  constructor(@Inject(PresenceService) private readonly presence: PresenceService) {}\n\n  @LiveQuery(PRESENCE_ROSTER_QUERY, {\n    tags: (args: { room: string }) => [presenceTag(args.room)],\n    parse: (args: unknown) => {\n      const room = (args as { room?: unknown } | undefined)?.room;\n      if (typeof room !== 'string' || room.length === 0) {\n        throw new Error(\"presence roster args require a non-empty 'room' string\");\n      }\n      return { room };\n    },\n  })\n  roster(args: { room: string }): PresenceMember[] {\n    return this.presence.roster(args.room);\n  }\n}\n","import {\n  LIVE_ERROR_CODES,\n  LIVE_PROTOCOL,\n  encodeLiveEnvelope,\n  isClientLiveFrame,\n} from '@velajs/live-protocol';\nimport type { ClientLiveFrame, LiveErrorCode, ServerLiveFrame } from '@velajs/live-protocol';\nimport {\n  Container,\n  DiscoveryService,\n  Inject,\n  Injectable,\n  Optional,\n  PipelineRunner,\n  ReservedWsEvent,\n  buildEntrypointExecutionContext,\n  isVelaError,\n  resolveErrorReporter,\n  resolveScopedComponents,\n  runInEntrypointScope,\n  toErrorBody,\n} from '../index';\nimport type {\n  ContributesEntrypoints,\n  Entrypoint,\n  OnApplicationBootstrap,\n  ReservedWsEventHandler,\n  Token,\n  Type,\n  WsClient,\n  WsMessage,\n} from '../index';\nimport { getLiveQueries } from './live.decorators';\nimport { encodeSubscriptionUpdate } from './live.delta';\nimport {\n  LIVE_CURSOR_LOG,\n  LIVE_DRIVER,\n  LIVE_MODULE_OPTIONS,\n  LIVE_RESOLVER_METADATA,\n} from './live.tokens';\nimport type {\n  CommitStamp,\n  CursorLog,\n  InvalidationCommand,\n  LiveDriver,\n  LiveEntrypointMeta,\n  LiveIdentity,\n  LiveInvalidationSink,\n  LiveModuleOptions,\n  LiveQueryContext,\n  LiveQueryOptions,\n  LiveResolverMetadata,\n  SubscriptionRecord,\n} from './live.types';\nimport { PresenceService } from './presence';\n\n/** How many subscriptions refresh concurrently per flush (lunora's socket-pool default). */\nconst REFRESH_POOL_SIZE = 8;\n\ninterface RegisteredQuery {\n  token: Type;\n  methodName: string | symbol;\n  options: LiveQueryOptions;\n}\n\ninterface ConnectionEntry {\n  client: WsClient;\n  path: string;\n  subs: Map<string, SubscriptionRecord>;\n}\n\n/**\n * Where the engine persists a connection's subscription records inside\n * `client.data` (committed through `WsClient.commit()`). On Cloudflare that\n * lands in the hibernation attachment, so subscriptions survive DO eviction;\n * the transport replays them via `restoreSubscription` on wake. On node,\n * `commit()` is a no-op and this is just in-memory bookkeeping.\n */\nexport const LIVE_SUBS_DATA_KEY = '__velaLiveSubs';\n\n/** Read the subscription records a transport persisted for a connection (wake/restore path). */\nexport function readPersistedLiveSubscriptions(client: WsClient): SubscriptionRecord[] {\n  const raw = (client.data as Record<string, unknown> | undefined)?.[LIVE_SUBS_DATA_KEY];\n  if (!Array.isArray(raw)) return [];\n  return raw.filter(\n    (record): record is SubscriptionRecord =>\n      typeof record === 'object' &&\n      record !== null &&\n      typeof (record as SubscriptionRecord).sub === 'string' &&\n      typeof (record as SubscriptionRecord).query === 'string' &&\n      Array.isArray((record as SubscriptionRecord).tags),\n  );\n}\n\nconst defaultIdentity = (client: WsClient): LiveIdentity | undefined => {\n  const data = client.data as Record<string, unknown> | undefined;\n  if (!data || Object.keys(data).length === 0) return undefined;\n  return { ...data } as LiveIdentity;\n};\n\nasync function runPool<T>(\n  items: T[],\n  size: number,\n  run: (item: T) => Promise<void>,\n): Promise<void> {\n  const queue = [...items];\n  const workers = Array.from({ length: Math.min(size, queue.length) }, async () => {\n    for (let item = queue.shift(); item !== undefined; item = queue.shift()) {\n      await run(item);\n    }\n  });\n  await Promise.all(workers);\n}\n\n/**\n * The live-query engine of ONE log scope: routes `$live` frames (subscribe /\n * unsubscribe / presence), owns the subscription registry, and turns tag\n * invalidations into re-run → diff → push cycles.\n *\n * Delivery semantics (ported from lunora's `shard-do.ts` refresh loop):\n * - **Coalescing**: a burst of invalidations collapses into one flush; every\n *   committed invalidation is observed by a flush that STARTS after it\n *   committed (`applyInvalidation` appends to the log before arming the\n *   drain, and the drain re-loops while tags are pending).\n * - **At-least-once**: a subscription's diff baseline (`lastJson`) advances\n *   only when the frame left the socket; keyed deltas are idempotent on\n *   replay.\n * - **Frame suppression**: a byte-identical re-run sends `settled` — no\n *   payload, but the cursor still advances so client optimistic layers drop.\n * - **Outbound expiry**: a subscription whose captured identity lapsed is\n *   dropped (socket closed) before it receives another scoped push.\n * - **Cursor-before-run**: the stamp a frame carries is read BEFORE the\n *   re-run, so a result can only be NEWER than its cursor claims — an\n *   invalidation racing the run is re-observed by the next flush, never lost.\n *\n * Transports reach the engine via `app.entrypoints.ofKind('live')` (it\n * contributes itself) — the same contract the WebSocket triad uses.\n */\n@ReservedWsEvent('$live')\n@Injectable()\nexport class LiveEngine\n  implements\n    OnApplicationBootstrap,\n    ContributesEntrypoints,\n    ReservedWsEventHandler,\n    LiveInvalidationSink\n{\n  private readonly queries = new Map<string, RegisteredQuery>();\n  private readonly connections = new Map<string, ConnectionEntry>();\n  private readonly pendingTags = new Set<string>();\n  private drainChain: Promise<void> = Promise.resolve();\n  private draining = false;\n\n  constructor(\n    @Inject(Container) private readonly container: Container,\n    @Inject(DiscoveryService) private readonly discovery: DiscoveryService,\n    @Inject(LIVE_CURSOR_LOG) private readonly log: CursorLog,\n    @Inject(LIVE_DRIVER) driver: LiveDriver,\n    @Inject(LIVE_MODULE_OPTIONS) private readonly options: LiveModuleOptions,\n    @Optional() @Inject(PresenceService) private readonly presence?: PresenceService,\n  ) {\n    driver.bind(this);\n    this.presence?.bindInvalidator((tags) => {\n      void driver.dispatch({ tags });\n    });\n  }\n\n  async onApplicationBootstrap(): Promise<void> {\n    for (const found of this.discovery.providersWithMeta<LiveResolverMetadata>(\n      LIVE_RESOLVER_METADATA,\n    )) {\n      if (!found.instance) continue;\n      for (const declared of getLiveQueries(found.metatype)) {\n        if (this.queries.has(declared.name)) {\n          const msg =\n            `[vela] duplicate @LiveQuery('${declared.name}') ` +\n            `(${found.metatype.name}); keeping the first.`;\n          if (this.container.getDiagnostics() === 'throw') throw new Error(msg);\n          console.warn(msg);\n          continue;\n        }\n        this.queries.set(declared.name, {\n          token: found.metatype,\n          methodName: declared.methodName,\n          options: declared.options,\n        });\n      }\n    }\n  }\n\n  /** The `'live'` entrypoint — how transports (node registrar, CF DO bootstrap) find the engine. */\n  collectEntrypoints(): Entrypoint<LiveEntrypointMeta>[] {\n    return [\n      {\n        kind: 'live',\n        token: LiveEngine as unknown as Token,\n        instance: this,\n        meta: { engine: this },\n      },\n    ];\n  }\n\n  // ---- ReservedWsEventHandler ----\n\n  async handleReservedEvent(path: string, client: WsClient, message: WsMessage): Promise<void> {\n    const frame = message.data;\n    // Forward-compat: unknown frame shapes are ignored, not errors.\n    if (!isClientLiveFrame(frame)) return;\n\n    switch (frame.t) {\n      case 'sub':\n        await this.onSubscribe(path, client, frame);\n        return;\n      case 'unsub': {\n        const conn = this.connections.get(client.id);\n        if (!conn) return;\n        conn.subs.delete(frame.sub);\n        if (conn.subs.size === 0) this.connections.delete(client.id);\n        await this.persistSubscriptions(conn);\n        return;\n      }\n      case 'presence':\n        if (this.presence?.enabled) {\n          this.presence.beat(frame.room, client.id, frame.meta);\n        }\n        return;\n    }\n  }\n\n  async handleSocketClose(_path: string, client: WsClient): Promise<void> {\n    this.connections.delete(client.id);\n    this.presence?.reap(client.id);\n  }\n\n  // ---- LiveInvalidationSink ----\n\n  async applyInvalidation(cmd: InvalidationCommand): Promise<CommitStamp> {\n    const stamp = await this.log.append(cmd.tags);\n    for (const tag of cmd.tags) this.pendingTags.add(tag);\n    this.scheduleDrain();\n    return stamp;\n  }\n\n  /** Settles when every pending invalidation has been flushed (tests, graceful transports). */\n  async whenIdle(): Promise<void> {\n    do {\n      await this.drainChain;\n    } while (this.draining || this.pendingTags.size > 0);\n  }\n\n  /**\n   * Re-attach a persisted subscription without the subscribe handshake — the\n   * Cloudflare transport replays hibernation-attachment records through this\n   * on wake. No frames are sent; the next relevant invalidation pushes.\n   */\n  restoreSubscription(path: string, client: WsClient, record: SubscriptionRecord): void {\n    this.ensureConnection(path, client).subs.set(record.sub, record);\n  }\n\n  // ---- subscribe path ----\n\n  private async onSubscribe(\n    path: string,\n    client: WsClient,\n    frame: Extract<ClientLiveFrame, { t: 'sub' }>,\n  ): Promise<void> {\n    if (frame.v !== undefined && frame.v > LIVE_PROTOCOL) {\n      this.sendFrame(client, {\n        t: 'error',\n        sub: frame.sub,\n        code: LIVE_ERROR_CODES.UNSUPPORTED_PROTOCOL,\n        message: `server speaks live protocol v${LIVE_PROTOCOL}, client asked for v${frame.v}`,\n        fatal: true,\n      });\n      return;\n    }\n\n    const conn = this.ensureConnection(path, client);\n    if (conn.subs.has(frame.sub)) {\n      this.sendFrame(client, {\n        t: 'error',\n        sub: frame.sub,\n        code: LIVE_ERROR_CODES.DUPLICATE_SUB,\n        message: `subscription id '${frame.sub}' is already active on this socket`,\n        fatal: false,\n      });\n      return;\n    }\n\n    const registered = this.queries.get(frame.query);\n    if (!registered) {\n      this.sendFrame(client, {\n        t: 'error',\n        sub: frame.sub,\n        code: LIVE_ERROR_CODES.UNKNOWN_QUERY,\n        message: `no @LiveQuery('${frame.query}') is registered`,\n        fatal: true,\n      });\n      return;\n    }\n\n    let args: unknown = frame.args;\n    if (registered.options.parse) {\n      try {\n        args = registered.options.parse(frame.args);\n      } catch (err) {\n        this.sendFrame(client, {\n          t: 'error',\n          sub: frame.sub,\n          code: LIVE_ERROR_CODES.BAD_ARGS,\n          message: err instanceof Error ? err.message : 'invalid subscription args',\n          fatal: true,\n        });\n        return;\n      }\n    }\n\n    // Resolver-tier guards run ONCE, here (app-wide guards already ran in the\n    // dispatcher's reserved-event path). Re-runs are server-initiated and rely\n    // on the identity captured below instead of re-authorizing.\n    if (!(await this.runSubscribeGuards(registered, client, frame.query, args))) {\n      this.sendFrame(client, {\n        t: 'error',\n        sub: frame.sub,\n        code: LIVE_ERROR_CODES.FORBIDDEN,\n        message: `subscription to '${frame.query}' was rejected`,\n        fatal: true,\n      });\n      return;\n    }\n\n    const identity = (this.options.identity ?? defaultIdentity)(client);\n    const tags =\n      typeof registered.options.tags === 'function'\n        ? registered.options.tags(args)\n        : registered.options.tags;\n\n    const record: SubscriptionRecord = {\n      sub: frame.sub,\n      query: frame.query,\n      args,\n      tags,\n      key: frame.key ?? registered.options.key,\n      identity,\n    };\n    conn.subs.set(frame.sub, record);\n    await this.persistSubscriptions(conn);\n    this.sendFrame(client, { t: 'ack', sub: frame.sub });\n\n    // Resume: when the client's cursor is still explainable and none of the\n    // subscription's tags were invalidated in the gap, a tiny `resume` frame\n    // keeps its cached value — no re-run at all. The diff baseline stays\n    // undefined, so the next relevant change sends a full snapshot.\n    if (frame.sinceCursor !== undefined && frame.sinceEpoch !== undefined) {\n      const verdict = await this.log.evaluateResume(frame.sinceCursor, frame.sinceEpoch, tags);\n      if (verdict === 'resume') {\n        const stamp = await this.log.current();\n        if (\n          this.sendFrame(client, {\n            t: 'resume',\n            sub: frame.sub,\n            cursor: stamp.cursor,\n            epoch: stamp.epoch,\n          })\n        ) {\n          record.lastCursor = stamp.cursor;\n        }\n        return;\n      }\n    }\n\n    await this.push(conn, record, await this.log.current(), { initial: true });\n  }\n\n  private async runSubscribeGuards(\n    registered: RegisteredQuery,\n    client: WsClient,\n    query: string,\n    args: unknown,\n  ): Promise<boolean> {\n    const guards = resolveScopedComponents(\n      'guard',\n      registered.token,\n      registered.methodName,\n      this.container,\n    );\n    if (guards.length === 0) return true;\n    const context = buildEntrypointExecutionContext(\n      'live',\n      registered.token,\n      registered.methodName,\n      {\n        query,\n        args,\n        client,\n      },\n    );\n    try {\n      for (const guard of guards) {\n        if (!(await guard.canActivate(context))) return false;\n      }\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  // ---- refresh path ----\n\n  private scheduleDrain(): void {\n    if (this.draining) return;\n    this.draining = true;\n    this.drainChain = this.drainChain\n      .then(() => this.drainLoop())\n      .catch((err) => {\n        if (this.container.getDiagnostics() !== 'silent') {\n          console.warn('[vela] live refresh flush failed:', err);\n        }\n      })\n      .finally(() => {\n        this.draining = false;\n        if (this.pendingTags.size > 0) this.scheduleDrain();\n      });\n  }\n\n  private async drainLoop(): Promise<void> {\n    while (this.pendingTags.size > 0) {\n      const changed = new Set(this.pendingTags);\n      this.pendingTags.clear();\n\n      // The stamp is resolved once per pass, BEFORE the re-runs (lunora\n      // resolves its CDC cut the same way): results can only be newer than\n      // the cursor they carry.\n      const stamp = await this.log.current();\n\n      const work: Array<{ conn: ConnectionEntry; record: SubscriptionRecord }> = [];\n      for (const conn of this.connections.values()) {\n        for (const record of conn.subs.values()) {\n          if (record.tags.some((tag) => changed.has(tag))) work.push({ conn, record });\n        }\n      }\n\n      await runPool(work, REFRESH_POOL_SIZE, async ({ conn, record }) => {\n        await this.push(conn, record, stamp, { initial: false });\n      });\n    }\n  }\n\n  /**\n   * Map a resolver failure to its live error-frame code. A branded\n   * {@link VelaError} carries an HTTP-ish status that projects onto the live\n   * vocabulary (403 → forbidden, 400/422 → bad_args); everything else — and\n   * every unbranded error — is `internal` (the client sees a redacted message).\n   */\n  private static liveFrameCode(err: unknown): LiveErrorCode {\n    if (!isVelaError(err)) return LIVE_ERROR_CODES.INTERNAL;\n    if (err.status === 403) return LIVE_ERROR_CODES.FORBIDDEN;\n    if (err.status === 400 || err.status === 422) return LIVE_ERROR_CODES.BAD_ARGS;\n    return LIVE_ERROR_CODES.INTERNAL;\n  }\n\n  private async push(\n    conn: ConnectionEntry,\n    record: SubscriptionRecord,\n    stamp: CommitStamp,\n    { initial }: { initial: boolean },\n  ): Promise<void> {\n    // Outbound expiry enforcement — the only place expiry CAN be enforced for\n    // a passive subscriber.\n    const expiresAt = record.identity?.expiresAt;\n    if (typeof expiresAt === 'number' && expiresAt <= Date.now()) {\n      this.connections.delete(conn.client.id);\n      try {\n        conn.client.close(1008, 'identity expired');\n      } catch {\n        // already gone\n      }\n      return;\n    }\n\n    let json: string;\n    let result: unknown;\n    try {\n      result = await this.runQuery(record, conn.client);\n      // `undefined` has no JSON form — normalize so the frame always carries\n      // an explicit `snapshot` and the baseline stays a string.\n      if (result === undefined) result = null;\n      json = JSON.stringify(result);\n    } catch (err) {\n      if (initial) {\n        // Close the leak: an initial-subscribe resolver failure is REDACTED\n        // through `toErrorBody` (the single wire-redaction seam) — an unbranded\n        // error's raw message never reaches the browser, it surfaces only via\n        // the reporter. Branded VelaErrors keep their client-facing message.\n        conn.subs.delete(record.sub);\n        const reporter = resolveErrorReporter(this.container);\n        reporter.report(err, { edge: 'live', source: record.query });\n        const safe = toErrorBody(err, { catalog: reporter.catalog });\n        this.sendFrame(conn.client, {\n          t: 'error',\n          sub: record.sub,\n          code: LiveEngine.liveFrameCode(err),\n          message: safe.body.error.message,\n          fatal: true,\n        });\n      } else if (this.container.getDiagnostics() !== 'silent') {\n        // Transient: baseline untouched, the subscription retries next flush.\n        console.warn(`[vela] live query '${record.query}' re-run failed (will retry):`, err);\n      }\n      return;\n    }\n\n    const frame = encodeSubscriptionUpdate(record, json, result, stamp, initial);\n    if (this.sendFrame(conn.client, frame)) {\n      record.lastJson = json;\n      record.lastCursor = stamp.cursor;\n    }\n  }\n\n  private async runQuery(record: SubscriptionRecord, client: WsClient): Promise<unknown> {\n    const registered = this.queries.get(record.query);\n    if (!registered) throw new Error(`live query '${record.query}' disappeared from the registry`);\n\n    return runInEntrypointScope(this.container, async (scope) => {\n      // Async seam: lazy resolver modules materialize, request-scoped\n      // resolvers rebuild per run (mirrors queue dispatch).\n      const instance = (await scope.resolveAsync(registered.token)) as Record<\n        string | symbol,\n        unknown\n      >;\n      const liveContext: LiveQueryContext = {\n        identity: record.identity,\n        clientId: client.id,\n        rooms: [...client.rooms],\n      };\n      const context = buildEntrypointExecutionContext(\n        'live',\n        registered.token,\n        registered.methodName,\n        {\n          query: record.query,\n          args: record.args,\n          client,\n        },\n      );\n      const interceptors = resolveScopedComponents(\n        'interceptor',\n        registered.token,\n        registered.methodName,\n        scope,\n      );\n      return PipelineRunner.run({\n        context,\n        guards: [],\n        interceptors,\n        resolveArgs: async () => [record.args, liveContext],\n        invoke: async (args) => {\n          const method = instance[registered.methodName] as (...a: unknown[]) => unknown;\n          return method.apply(instance, args);\n        },\n      });\n    });\n  }\n\n  /**\n   * Mirror the connection's records into `client.data` + `commit()` so\n   * hibernating transports can replay them on wake. The volatile diff\n   * baseline (`lastJson`/`lastCursor`) is deliberately stripped: it can be\n   * large (the whole last result vs the 16 KiB attachment cap) and a lost\n   * baseline just means the next relevant change sends a full snapshot.\n   */\n  private async persistSubscriptions(conn: ConnectionEntry): Promise<void> {\n    const records = [...conn.subs.values()].map(\n      ({ lastJson: _lastJson, lastCursor: _lastCursor, ...persisted }) => persisted,\n    );\n    try {\n      (conn.client.data as Record<string, unknown>)[LIVE_SUBS_DATA_KEY] = records;\n      await conn.client.commit();\n    } catch (err) {\n      if (this.container.getDiagnostics() !== 'silent') {\n        console.warn(\n          '[vela] live subscription persistence failed (resume across eviction disabled):',\n          err,\n        );\n      }\n    }\n  }\n\n  private ensureConnection(path: string, client: WsClient): ConnectionEntry {\n    let conn = this.connections.get(client.id);\n    if (!conn) {\n      conn = { client, path, subs: new Map() };\n      this.connections.set(client.id, conn);\n    }\n    return conn;\n  }\n\n  private sendFrame(client: WsClient, frame: ServerLiveFrame): boolean {\n    try {\n      client.sendRaw(encodeLiveEnvelope(frame));\n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n","import { COMMIT_CURSOR_HEADER, COMMIT_EPOCH_HEADER } from '@velajs/live-protocol';\nimport { getContext } from 'hono/context-storage';\nimport type {\n  CommitStamp,\n  InvalidationCommand,\n  LiveDriver,\n  LiveInvalidationSink,\n} from './live.types';\n\n/** Single-scope default driver: deliver straight to this process's engine. */\nexport function localLive(): LiveDriver {\n  let sink: LiveInvalidationSink | undefined;\n  return {\n    kind: 'local',\n    bind(s) {\n      sink = s;\n    },\n    dispatch(cmd) {\n      return sink?.applyInvalidation(cmd);\n    },\n  };\n}\n\n/**\n * Per-app wrapper around a (possibly SHARED) driver instance.\n *\n * A driver passed to `LiveModule.forRoot({ driver })` is a plain config object\n * — and on Cloudflare the SAME app module (thus the same driver object)\n * bootstraps in the Worker isolate AND inside each Durable Object, often\n * within one isolate. Mutable per-app state must therefore never live on the\n * driver itself: the DO flipping a shared `durableObjectLive()` into local\n * mode would otherwise poison the Worker's engine, which then executes the\n * DO's storage handle in the wrong request context (\"Cannot perform I/O on\n * behalf of a different request\").\n *\n * The wrapper owns the per-app sink and the per-app local-mode flag; isolate-\n * wide concerns (env capture) forward to the underlying driver. Platform init\n * hooks (`_setLocalMode`, `_initializeEnv`) are exposed pass-through so\n * platform packages can keep type-guarding on their presence.\n */\nexport function perAppLiveDriver(underlying: LiveDriver): LiveDriver {\n  let ownSink: LiveInvalidationSink | undefined;\n  let localMode = false;\n  const cfHooks = underlying as Partial<{\n    _setLocalMode(): void;\n    _initializeEnv(env: Record<string, unknown>): void;\n  }>;\n\n  return {\n    get kind() {\n      return underlying.kind;\n    },\n    bind(sink) {\n      ownSink = sink;\n      underlying.bind(sink);\n    },\n    dispatch(cmd) {\n      if (localMode && ownSink) return ownSink.applyInvalidation(cmd);\n      return underlying.dispatch(cmd);\n    },\n    start: underlying.start ? () => underlying.start?.() : undefined,\n    stop: underlying.stop ? () => underlying.stop?.() : undefined,\n    // Platform hooks (Cloudflare): local mode is PER APP; env is per isolate.\n    _setLocalMode() {\n      localMode = true;\n    },\n    _initializeEnv(env: Record<string, unknown>) {\n      cfHooks._initializeEnv?.(env);\n    },\n  } as LiveDriver;\n}\n\n/**\n * The injectable invalidation surface for custom (non-CRUD) write paths:\n *\n * ```ts\n * await this.live.invalidate({ tags: ['todos:' + listId] });\n * ```\n *\n * Every affected live query re-runs and pushes. Returns the commit stamp of\n * the targeted log scope so mutation endpoints can expose it to the client\n * (`Vela-Commit-Cursor` / `Vela-Commit-Epoch`) — the cursor optimistic\n * updates gate on. When ambient request access is enabled\n * (`VelaFactory.create(m, { ambientContainer: true })`) the headers are\n * stamped onto the current HTTP response automatically; otherwise stamp them\n * yourself via {@link stampCommitHeaders}.\n */\nexport class LiveInvalidation {\n  constructor(private readonly driver: LiveDriver) {}\n\n  async invalidate(cmd: InvalidationCommand): Promise<CommitStamp | undefined> {\n    const stamp = await this.driver.dispatch(cmd);\n    if (stamp) stampAmbientCommitHeaders(stamp);\n    return stamp;\n  }\n}\n\n/** Write the commit headers onto a Hono context (a mutation route's response). */\nexport function stampCommitHeaders(\n  c: { header: (name: string, value: string) => unknown },\n  stamp: CommitStamp,\n): void {\n  c.header(COMMIT_CURSOR_HEADER, String(stamp.cursor));\n  c.header(COMMIT_EPOCH_HEADER, stamp.epoch);\n}\n\n/**\n * Best-effort automatic header stamping through Hono's ambient context\n * storage. A no-op outside a request or when `contextStorage()` isn't\n * registered — ALS keeps this per-request-correct under concurrency (a\n * mutable singleton slot would race interleaved awaits).\n */\nfunction stampAmbientCommitHeaders(stamp: CommitStamp): void {\n  try {\n    stampCommitHeaders(getContext(), stamp);\n  } catch {\n    // Ambient access not enabled, or invalidate() ran outside a request\n    // (queue job, cron tick) — there is no HTTP response to stamp.\n  }\n}\n","import { defineModule } from '../index';\nimport { InMemoryCursorLog } from './live.cursor';\nimport { LiveEngine } from './live.engine';\nimport { LiveInvalidation, localLive, perAppLiveDriver } from './live.invalidation';\nimport { LIVE_CURSOR_LOG, LIVE_DRIVER, LIVE_MODULE_OPTIONS } from './live.tokens';\nimport type { LiveDriver, LiveModuleOptions } from './live.types';\nimport { PresenceResolver, PresenceService } from './presence';\n\n/**\n * First-party live-query module (tag-based realtime reactivity) — authored,\n * like the queue module, entirely on vela's public API (`live-openness.test.ts`\n * machine-verifies it; the only extra dependency is the shared wire package\n * `@velajs/live-protocol`).\n *\n * ```ts\n * imports: [WebSocketModule.forRoot({}), LiveModule.forRoot({})]\n * ```\n *\n * App code declares `@LiveResolver` classes with `@LiveQuery(name, { tags })`\n * methods; clients subscribe over the `$live` reserved WebSocket event; writes\n * invalidate tags via `LiveInvalidation` (the `@velajs/crud` bridge does it\n * automatically per table). See `LIVE.md` for the wire protocol, delivery\n * guarantees, and the resume story.\n *\n * Deliberately EAGER (like WebSocketModule): the engine self-drives — it\n * claims the `$live` event at bootstrap and receives invalidations from\n * writes that never touch a live token — so the lazy-module contract\n * (\"nothing self-drives\") rules laziness out.\n */\nconst { ConfigurableModuleClass } = defineModule<LiveModuleOptions>({\n  name: 'Live',\n  optionsToken: LIVE_MODULE_OPTIONS,\n  key: (options) => `live#${options?.driver?.kind ?? 'local'}`,\n  setup: ({ OPTIONS, options }) => ({\n    providers: [\n      {\n        provide: LIVE_CURSOR_LOG,\n        useFactory: (o: LiveModuleOptions) => o.log ?? new InMemoryCursorLog(),\n        inject: [OPTIONS],\n      },\n      {\n        provide: LIVE_DRIVER,\n        // Wrapped per app: user-supplied drivers are shared config objects\n        // (the same module bootstraps in the Worker AND in each Durable\n        // Object), so per-app sink/mode state lives in the wrapper — see\n        // perAppLiveDriver.\n        useFactory: (o: LiveModuleOptions) => perAppLiveDriver(o.driver ?? localLive()),\n        inject: [OPTIONS],\n      },\n      {\n        provide: PresenceService,\n        useFactory: (o: LiveModuleOptions) => {\n          const presence = o.presence;\n          if (presence === false) return new PresenceService(undefined, false);\n          return new PresenceService(presence?.ttlMs, true);\n        },\n        inject: [OPTIONS],\n      },\n      {\n        provide: LiveInvalidation,\n        useFactory: (driver: LiveDriver) => new LiveInvalidation(driver),\n        inject: [LIVE_DRIVER],\n      },\n      LiveEngine,\n      // The built-in `$presence.roster` resolver. Skipping it is STRUCTURAL\n      // (`presence: false` must be visible at forRoot/forRootAsync call time,\n      // like queue's `queues`); a disabled-at-runtime service still no-ops.\n      ...(options?.presence === false ? [] : [PresenceResolver]),\n    ],\n    exports: [LiveEngine, LiveInvalidation, LIVE_DRIVER, LIVE_CURSOR_LOG, PresenceService],\n  }),\n});\n\nexport class LiveModule extends ConfigurableModuleClass {}\n"],"mappings":";;;;;;;;;;AAOA,MAAM,cAAc,GAAsB,MACxC,EAAE,MAAM,QAAQ,EAAE,IAAI,GAAG,CAAC;;;;;;;;;;;;AAa5B,IAAa,oBAAb,MAAoD;CAKrB;CAJ7B,QAAyB,OAAO,WAAW;CAC3C,UAAuC,CAAC;CACxC,MAAc;CAEd,YAAY,aAA8B,MAAM;EAAnB,KAAA,aAAA;CAAoB;CAEjD,OAAO,MAA6B;EAClC,KAAK,OAAO;EACZ,KAAK,QAAQ,KAAK;GAAE,KAAK,KAAK;GAAK;EAAK,CAAC;EACzC,IAAI,KAAK,QAAQ,SAAS,KAAK,YAC7B,KAAK,QAAQ,OAAO,GAAG,KAAK,QAAQ,SAAS,KAAK,UAAU;EAE9D,OAAO;GAAE,QAAQ,KAAK;GAAK,OAAO,KAAK;EAAM;CAC/C;CAEA,UAAuB;EACrB,OAAO;GAAE,QAAQ,KAAK;GAAK,OAAO,KAAK;EAAM;CAC/C;CAEA,eACE,aACA,YACA,kBACe;EAEf,IAAI,eAAe,KAAK,OAAO,OAAO;EAEtC,IAAI,cAAc,KAAK,KAAK,OAAO;EACnC,IAAI,gBAAgB,KAAK,KAAK,OAAO;EAErC,MAAM,SAAS,KAAK,QAAQ;EAC5B,IAAI,WAAW,KAAA,KAAa,OAAO,MAAM,cAAc,GAAG,OAAO;EAEjE,MAAM,UAAU,IAAI,IAAI,gBAAgB;EACxC,KAAK,MAAM,SAAS,KAAK,SAAS;GAChC,IAAI,MAAM,OAAO,aAAa;GAC9B,IAAI,WAAW,MAAM,MAAM,OAAO,GAAG,OAAO;EAC9C;EACA,OAAO;CACT;AACF;;;AC1DA,MAAa,yBAAyB;AACtC,MAAa,sBAAsB;;AAGnC,MAAa,cAAc,IAAI,eAA2B,kBAAkB;;AAG5E,MAAa,kBAAkB,IAAI,eAA0B,sBAAsB;AAGnF,MAAa,sBAAsB,IAAI,eAAkC,qBAAqB;;;ACV9F,MAAM,mBAAmB,4BAAkD,sBAAsB;;;;;;;;;;;;;;;;;;;;;;AAuBjG,SAAgB,eAA+B;CAC7C,OAAO,iBAAiB,CAAC,CAAC;AAC5B;;;;;;;AAQA,SAAgB,UACd,MACA,SACiB;CACjB,QAAQ,QAAgB,gBAAiC;EACvD,MAAM,OAAO,OAAO;EACpB,MAAM,WACH,YAAA,mBAAiC,IAAI,KAAyC,CAAC;EAClF,SAAS,KAAK;GAAE;GAAM,YAAY;GAAsB;EAA4B,CAAC;EACrF,eAAe,qBAAqB,UAAU,IAAI;CACpD;AACF;;AAGA,SAAgB,eAAe,eAA4C;CACzE,OAAQ,YAAA,mBAAiC,aAAa,KAAyC,CAAC;AAClG;;;;;;;;;;;;;;;ACrCA,SAAgB,yBACd,QACA,MACA,QACA,OACA,SACiB;CACjB,MAAM,UAA2B;EAC/B,GAAG;EACH,KAAK,OAAO;EACZ,QAAQ,MAAM;EACd,OAAO,MAAM;CACf;CAEA,IAAI,CAAC,WAAW,OAAO,aAAa,KAAA,GAAW;EAC7C,IAAI,OAAO,aAAa,MAAM,OAAO;EAErC,IAAI;EACJ,IAAI,SAAS;EACb,IAAI;GACF,WAAW,KAAK,MAAM,OAAO,QAAQ;GACrC,SAAS;EACX,QAAQ,CAER;EACA,IAAI,QAAQ;GACV,MAAM,MAAMA,kBAAgB,UAAU,QAAQ,OAAO,OAAOC,mBAAiB;GAC7E,IAAI,QAAQ,KAAA,KAAa,IAAI,SAAS,GACpC,OAAO;IAAE,GAAG;IAAS,KAAK,OAAO;IAAK;IAAK,QAAQ,MAAM;IAAQ,OAAO,MAAM;GAAM;GAEtF,IAAI,QAAQ,KAAA,GAAW,OAAO;EAChC;CACF;CAEA,OAAO;EAAE,GAAG;EAAQ,KAAK,OAAO;EAAK,UAAU;EAAQ,QAAQ,MAAM;EAAQ,OAAO,MAAM;CAAM;AAClG;;;;AC/CA,MAAa,eAAe,SAAyB,aAAa;;AAGlE,MAAa,wBAAwB;;;;;;;;;;;;AAyBrC,IAAa,kBAAb,MAA6B;CAMR;CACR;CANX,wBAAyB,IAAI,IAAuB;CACpD,gCAAiC,IAAI,IAAyB;CAC9D;CAEA,YACE,QAAyB,KACzB,UAAmB,MACnB;EAFiB,KAAA,QAAA;EACR,KAAA,UAAA;CACR;;CAGH,gBAAgB,aAA6C;EAC3D,KAAK,cAAc;CACrB;CAEA,KAAK,MAAc,UAAkB,MAAsB;EACzD,IAAI,CAAC,KAAK,SAAS;EACnB,IAAI,QAAQ,KAAK,MAAM,IAAI,IAAI;EAC/B,IAAI,CAAC,OAAO;GACV,QAAQ,EAAE,yBAAS,IAAI,IAAI,EAAE;GAC7B,KAAK,MAAM,IAAI,MAAM,KAAK;EAC5B;EACA,MAAM,QAAQ,IAAI,UAAU;GAAE;GAAM,UAAU,KAAK,IAAI;EAAE,CAAC;EAE1D,IAAI,SAAS,KAAK,cAAc,IAAI,QAAQ;EAC5C,IAAI,CAAC,QAAQ;GACX,yBAAS,IAAI,IAAI;GACjB,KAAK,cAAc,IAAI,UAAU,MAAM;EACzC;EACA,OAAO,IAAI,IAAI;EAEf,KAAK,cAAc,CAAC,YAAY,IAAI,CAAC,CAAC;CACxC;;CAGA,KAAK,UAAwB;EAC3B,MAAM,SAAS,KAAK,cAAc,IAAI,QAAQ;EAC9C,IAAI,CAAC,QAAQ;EACb,KAAK,cAAc,OAAO,QAAQ;EAClC,KAAK,MAAM,QAAQ,QAAQ;GACzB,MAAM,QAAQ,KAAK,MAAM,IAAI,IAAI;GACjC,IAAI,CAAC,OAAO;GACZ,MAAM,QAAQ,OAAO,QAAQ;GAC7B,IAAI,MAAM,QAAQ,SAAS,GAAG,KAAK,MAAM,OAAO,IAAI;GACpD,KAAK,cAAc,CAAC,YAAY,IAAI,CAAC,CAAC;EACxC;CACF;CAEA,OAAO,MAAgC;EACrC,MAAM,QAAQ,KAAK,MAAM,IAAI,IAAI;EACjC,IAAI,CAAC,OAAO,OAAO,CAAC;EACpB,MAAM,cAAc,KAAK,IAAI,IAAI,KAAK;EACtC,OAAO,CAAC,GAAG,MAAM,QAAQ,QAAQ,CAAC,CAAC,CAChC,QAAQ,GAAG,YAAY,OAAO,YAAY,WAAW,CAAC,CACtD,KAAK,CAAC,IAAI,aAAa;GAAE;GAAI,MAAM,OAAO;GAAM,UAAU,OAAO;EAAS,EAAE;CACjF;AACF;AAKO,IAAA,mBAAA,MAAM,iBAAiB;CAC0B;CAAtD,YAAY,UAAqE;EAA3B,KAAA,WAAA;CAA4B;CAElF,OAUO,MAA0C;EAC/C,OAAO,KAAK,SAAS,OAAO,KAAK,IAAI;CACvC;AACF;;CAbG,UAAU,uBAAuB;EAChC,OAAO,SAA2B,CAAC,YAAY,KAAK,IAAI,CAAC;EACzD,QAAQ,SAAkB;GACxB,MAAM,OAAQ,MAAyC;GACvD,IAAI,OAAO,SAAS,YAAY,KAAK,WAAW,GAC9C,MAAM,IAAI,MAAM,wDAAwD;GAE1E,OAAO,EAAE,KAAK;EAChB;CACF,CAAC;;;;;;CAdF,aAAa;CACb,WAAW;oBAEG,OAAO,eAAe,CAAA;;;;;;;ACrCrC,MAAM,oBAAoB;;;;;;;;AAqB1B,MAAa,qBAAqB;;AAGlC,SAAgB,+BAA+B,QAAwC;CACrF,MAAM,MAAO,OAAO,OAA+C;CACnE,IAAI,CAAC,MAAM,QAAQ,GAAG,GAAG,OAAO,CAAC;CACjC,OAAO,IAAI,QACR,WACC,OAAO,WAAW,YAClB,WAAW,QACX,OAAQ,OAA8B,QAAQ,YAC9C,OAAQ,OAA8B,UAAU,YAChD,MAAM,QAAS,OAA8B,IAAI,CACrD;AACF;AAEA,MAAM,mBAAmB,WAA+C;CACtE,MAAM,OAAO,OAAO;CACpB,IAAI,CAAC,QAAQ,OAAO,KAAK,IAAI,CAAC,CAAC,WAAW,GAAG,OAAO,KAAA;CACpD,OAAO,EAAE,GAAG,KAAK;AACnB;AAEA,eAAe,QACb,OACA,MACA,KACe;CACf,MAAM,QAAQ,CAAC,GAAG,KAAK;CACvB,MAAM,UAAU,MAAM,KAAK,EAAE,QAAQ,KAAK,IAAI,MAAM,MAAM,MAAM,EAAE,GAAG,YAAY;EAC/E,KAAK,IAAI,OAAO,MAAM,MAAM,GAAG,SAAS,KAAA,GAAW,OAAO,MAAM,MAAM,GACpE,MAAM,IAAI,IAAI;CAElB,CAAC;CACD,MAAM,QAAQ,IAAI,OAAO;AAC3B;AA4BO,IAAA,aAAA,cAAA,MAAM,WAMb;CAQwC;CACO;CACD;CAEI;CACQ;CAZxD,0BAA2B,IAAI,IAA6B;CAC5D,8BAA+B,IAAI,IAA6B;CAChE,8BAA+B,IAAI,IAAY;CAC/C,aAAoC,QAAQ,QAAQ;CACpD,WAAmB;CAEnB,YACE,WACA,WACA,KACA,QACA,SACA,UACA;EANoC,KAAA,YAAA;EACO,KAAA,YAAA;EACD,KAAA,MAAA;EAEI,KAAA,UAAA;EACQ,KAAA,WAAA;EAEtD,OAAO,KAAK,IAAI;EAChB,KAAK,UAAU,iBAAiB,SAAS;GACvC,OAAY,SAAS,EAAE,KAAK,CAAC;EAC/B,CAAC;CACH;CAEA,MAAM,yBAAwC;EAC5C,KAAK,MAAM,SAAS,KAAK,UAAU,kBACjC,sBACF,GAAG;GACD,IAAI,CAAC,MAAM,UAAU;GACrB,KAAK,MAAM,YAAY,eAAe,MAAM,QAAQ,GAAG;IACrD,IAAI,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG;KACnC,MAAM,MACJ,gCAAgC,SAAS,KAAK,MAC1C,MAAM,SAAS,KAAK;KAC1B,IAAI,KAAK,UAAU,eAAe,MAAM,SAAS,MAAM,IAAI,MAAM,GAAG;KACpE,QAAQ,KAAK,GAAG;KAChB;IACF;IACA,KAAK,QAAQ,IAAI,SAAS,MAAM;KAC9B,OAAO,MAAM;KACb,YAAY,SAAS;KACrB,SAAS,SAAS;IACpB,CAAC;GACH;EACF;CACF;;CAGA,qBAAuD;EACrD,OAAO,CACL;GACE,MAAM;GACN,OAAA;GACA,UAAU;GACV,MAAM,EAAE,QAAQ,KAAK;EACvB,CACF;CACF;CAIA,MAAM,oBAAoB,MAAc,QAAkB,SAAmC;EAC3F,MAAM,QAAQ,QAAQ;EAEtB,IAAI,CAACC,oBAAkB,KAAK,GAAG;EAE/B,QAAQ,MAAM,GAAd;GACE,KAAK;IACH,MAAM,KAAK,YAAY,MAAM,QAAQ,KAAK;IAC1C;GACF,KAAK,SAAS;IACZ,MAAM,OAAO,KAAK,YAAY,IAAI,OAAO,EAAE;IAC3C,IAAI,CAAC,MAAM;IACX,KAAK,KAAK,OAAO,MAAM,GAAG;IAC1B,IAAI,KAAK,KAAK,SAAS,GAAG,KAAK,YAAY,OAAO,OAAO,EAAE;IAC3D,MAAM,KAAK,qBAAqB,IAAI;IACpC;GACF;GACA,KAAK;IACH,IAAI,KAAK,UAAU,SACjB,KAAK,SAAS,KAAK,MAAM,MAAM,OAAO,IAAI,MAAM,IAAI;IAEtD;EACJ;CACF;CAEA,MAAM,kBAAkB,OAAe,QAAiC;EACtE,KAAK,YAAY,OAAO,OAAO,EAAE;EACjC,KAAK,UAAU,KAAK,OAAO,EAAE;CAC/B;CAIA,MAAM,kBAAkB,KAAgD;EACtE,MAAM,QAAQ,MAAM,KAAK,IAAI,OAAO,IAAI,IAAI;EAC5C,KAAK,MAAM,OAAO,IAAI,MAAM,KAAK,YAAY,IAAI,GAAG;EACpD,KAAK,cAAc;EACnB,OAAO;CACT;;CAGA,MAAM,WAA0B;EAC9B;GACE,MAAM,KAAK;SACJ,KAAK,YAAY,KAAK,YAAY,OAAO;CACpD;;;;;;CAOA,oBAAoB,MAAc,QAAkB,QAAkC;EACpF,KAAK,iBAAiB,MAAM,MAAM,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,MAAM;CACjE;CAIA,MAAc,YACZ,MACA,QACA,OACe;EACf,IAAI,MAAM,MAAM,KAAA,KAAa,MAAM,IAAIC,iBAAe;GACpD,KAAK,UAAU,QAAQ;IACrB,GAAG;IACH,KAAK,MAAM;IACX,MAAMC,mBAAiB;IACvB,SAAS,gCAAgCD,gBAAc,sBAAsB,MAAM;IACnF,OAAO;GACT,CAAC;GACD;EACF;EAEA,MAAM,OAAO,KAAK,iBAAiB,MAAM,MAAM;EAC/C,IAAI,KAAK,KAAK,IAAI,MAAM,GAAG,GAAG;GAC5B,KAAK,UAAU,QAAQ;IACrB,GAAG;IACH,KAAK,MAAM;IACX,MAAMC,mBAAiB;IACvB,SAAS,oBAAoB,MAAM,IAAI;IACvC,OAAO;GACT,CAAC;GACD;EACF;EAEA,MAAM,aAAa,KAAK,QAAQ,IAAI,MAAM,KAAK;EAC/C,IAAI,CAAC,YAAY;GACf,KAAK,UAAU,QAAQ;IACrB,GAAG;IACH,KAAK,MAAM;IACX,MAAMA,mBAAiB;IACvB,SAAS,kBAAkB,MAAM,MAAM;IACvC,OAAO;GACT,CAAC;GACD;EACF;EAEA,IAAI,OAAgB,MAAM;EAC1B,IAAI,WAAW,QAAQ,OACrB,IAAI;GACF,OAAO,WAAW,QAAQ,MAAM,MAAM,IAAI;EAC5C,SAAS,KAAK;GACZ,KAAK,UAAU,QAAQ;IACrB,GAAG;IACH,KAAK,MAAM;IACX,MAAMA,mBAAiB;IACvB,SAAS,eAAe,QAAQ,IAAI,UAAU;IAC9C,OAAO;GACT,CAAC;GACD;EACF;EAMF,IAAI,CAAE,MAAM,KAAK,mBAAmB,YAAY,QAAQ,MAAM,OAAO,IAAI,GAAI;GAC3E,KAAK,UAAU,QAAQ;IACrB,GAAG;IACH,KAAK,MAAM;IACX,MAAMA,mBAAiB;IACvB,SAAS,oBAAoB,MAAM,MAAM;IACzC,OAAO;GACT,CAAC;GACD;EACF;EAEA,MAAM,YAAY,KAAK,QAAQ,YAAY,gBAAA,CAAiB,MAAM;EAClE,MAAM,OACJ,OAAO,WAAW,QAAQ,SAAS,aAC/B,WAAW,QAAQ,KAAK,IAAI,IAC5B,WAAW,QAAQ;EAEzB,MAAM,SAA6B;GACjC,KAAK,MAAM;GACX,OAAO,MAAM;GACb;GACA;GACA,KAAK,MAAM,OAAO,WAAW,QAAQ;GACrC;EACF;EACA,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM;EAC/B,MAAM,KAAK,qBAAqB,IAAI;EACpC,KAAK,UAAU,QAAQ;GAAE,GAAG;GAAO,KAAK,MAAM;EAAI,CAAC;EAMnD,IAAI,MAAM,gBAAgB,KAAA,KAAa,MAAM,eAAe,KAAA;OAEtD,MADkB,KAAK,IAAI,eAAe,MAAM,aAAa,MAAM,YAAY,IAAI,MACvE,UAAU;IACxB,MAAM,QAAQ,MAAM,KAAK,IAAI,QAAQ;IACrC,IACE,KAAK,UAAU,QAAQ;KACrB,GAAG;KACH,KAAK,MAAM;KACX,QAAQ,MAAM;KACd,OAAO,MAAM;IACf,CAAC,GAED,OAAO,aAAa,MAAM;IAE5B;GACF;;EAGF,MAAM,KAAK,KAAK,MAAM,QAAQ,MAAM,KAAK,IAAI,QAAQ,GAAG,EAAE,SAAS,KAAK,CAAC;CAC3E;CAEA,MAAc,mBACZ,YACA,QACA,OACA,MACkB;EAClB,MAAM,SAAS,wBACb,SACA,WAAW,OACX,WAAW,YACX,KAAK,SACP;EACA,IAAI,OAAO,WAAW,GAAG,OAAO;EAChC,MAAM,UAAU,gCACd,QACA,WAAW,OACX,WAAW,YACX;GACE;GACA;GACA;EACF,CACF;EACA,IAAI;GACF,KAAK,MAAM,SAAS,QAClB,IAAI,CAAE,MAAM,MAAM,YAAY,OAAO,GAAI,OAAO;GAElD,OAAO;EACT,QAAQ;GACN,OAAO;EACT;CACF;CAIA,gBAA8B;EAC5B,IAAI,KAAK,UAAU;EACnB,KAAK,WAAW;EAChB,KAAK,aAAa,KAAK,WACpB,WAAW,KAAK,UAAU,CAAC,CAAC,CAC5B,OAAO,QAAQ;GACd,IAAI,KAAK,UAAU,eAAe,MAAM,UACtC,QAAQ,KAAK,qCAAqC,GAAG;EAEzD,CAAC,CAAC,CACD,cAAc;GACb,KAAK,WAAW;GAChB,IAAI,KAAK,YAAY,OAAO,GAAG,KAAK,cAAc;EACpD,CAAC;CACL;CAEA,MAAc,YAA2B;EACvC,OAAO,KAAK,YAAY,OAAO,GAAG;GAChC,MAAM,UAAU,IAAI,IAAI,KAAK,WAAW;GACxC,KAAK,YAAY,MAAM;GAKvB,MAAM,QAAQ,MAAM,KAAK,IAAI,QAAQ;GAErC,MAAM,OAAqE,CAAC;GAC5E,KAAK,MAAM,QAAQ,KAAK,YAAY,OAAO,GACzC,KAAK,MAAM,UAAU,KAAK,KAAK,OAAO,GACpC,IAAI,OAAO,KAAK,MAAM,QAAQ,QAAQ,IAAI,GAAG,CAAC,GAAG,KAAK,KAAK;IAAE;IAAM;GAAO,CAAC;GAI/E,MAAM,QAAQ,MAAM,mBAAmB,OAAO,EAAE,MAAM,aAAa;IACjE,MAAM,KAAK,KAAK,MAAM,QAAQ,OAAO,EAAE,SAAS,MAAM,CAAC;GACzD,CAAC;EACH;CACF;;;;;;;CAQA,OAAe,cAAc,KAA6B;EACxD,IAAI,CAAC,YAAY,GAAG,GAAG,OAAOA,mBAAiB;EAC/C,IAAI,IAAI,WAAW,KAAK,OAAOA,mBAAiB;EAChD,IAAI,IAAI,WAAW,OAAO,IAAI,WAAW,KAAK,OAAOA,mBAAiB;EACtE,OAAOA,mBAAiB;CAC1B;CAEA,MAAc,KACZ,MACA,QACA,OACA,EAAE,WACa;EAGf,MAAM,YAAY,OAAO,UAAU;EACnC,IAAI,OAAO,cAAc,YAAY,aAAa,KAAK,IAAI,GAAG;GAC5D,KAAK,YAAY,OAAO,KAAK,OAAO,EAAE;GACtC,IAAI;IACF,KAAK,OAAO,MAAM,MAAM,kBAAkB;GAC5C,QAAQ,CAER;GACA;EACF;EAEA,IAAI;EACJ,IAAI;EACJ,IAAI;GACF,SAAS,MAAM,KAAK,SAAS,QAAQ,KAAK,MAAM;GAGhD,IAAI,WAAW,KAAA,GAAW,SAAS;GACnC,OAAO,KAAK,UAAU,MAAM;EAC9B,SAAS,KAAK;GACZ,IAAI,SAAS;IAKX,KAAK,KAAK,OAAO,OAAO,GAAG;IAC3B,MAAM,WAAW,qBAAqB,KAAK,SAAS;IACpD,SAAS,OAAO,KAAK;KAAE,MAAM;KAAQ,QAAQ,OAAO;IAAM,CAAC;IAC3D,MAAM,OAAO,YAAY,KAAK,EAAE,SAAS,SAAS,QAAQ,CAAC;IAC3D,KAAK,UAAU,KAAK,QAAQ;KAC1B,GAAG;KACH,KAAK,OAAO;KACZ,MAAA,YAAiB,cAAc,GAAG;KAClC,SAAS,KAAK,KAAK,MAAM;KACzB,OAAO;IACT,CAAC;GACH,OAAO,IAAI,KAAK,UAAU,eAAe,MAAM,UAE7C,QAAQ,KAAK,sBAAsB,OAAO,MAAM,gCAAgC,GAAG;GAErF;EACF;EAEA,MAAM,QAAQ,yBAAyB,QAAQ,MAAM,QAAQ,OAAO,OAAO;EAC3E,IAAI,KAAK,UAAU,KAAK,QAAQ,KAAK,GAAG;GACtC,OAAO,WAAW;GAClB,OAAO,aAAa,MAAM;EAC5B;CACF;CAEA,MAAc,SAAS,QAA4B,QAAoC;EACrF,MAAM,aAAa,KAAK,QAAQ,IAAI,OAAO,KAAK;EAChD,IAAI,CAAC,YAAY,MAAM,IAAI,MAAM,eAAe,OAAO,MAAM,gCAAgC;EAE7F,OAAO,qBAAqB,KAAK,WAAW,OAAO,UAAU;GAG3D,MAAM,WAAY,MAAM,MAAM,aAAa,WAAW,KAAK;GAI3D,MAAM,cAAgC;IACpC,UAAU,OAAO;IACjB,UAAU,OAAO;IACjB,OAAO,CAAC,GAAG,OAAO,KAAK;GACzB;GACA,MAAM,UAAU,gCACd,QACA,WAAW,OACX,WAAW,YACX;IACE,OAAO,OAAO;IACd,MAAM,OAAO;IACb;GACF,CACF;GACA,MAAM,eAAe,wBACnB,eACA,WAAW,OACX,WAAW,YACX,KACF;GACA,OAAO,eAAe,IAAI;IACxB;IACA,QAAQ,CAAC;IACT;IACA,aAAa,YAAY,CAAC,OAAO,MAAM,WAAW;IAClD,QAAQ,OAAO,SAAS;KAEtB,OADe,SAAS,WAAW,WACtB,CAAC,MAAM,UAAU,IAAI;IACpC;GACF,CAAC;EACH,CAAC;CACH;;;;;;;;CASA,MAAc,qBAAqB,MAAsC;EACvE,MAAM,UAAU,CAAC,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,KACrC,EAAE,UAAU,WAAW,YAAY,aAAa,GAAG,gBAAgB,SACtE;EACA,IAAI;GACF,KAAM,OAAO,KAAiC,sBAAsB;GACpE,MAAM,KAAK,OAAO,OAAO;EAC3B,SAAS,KAAK;GACZ,IAAI,KAAK,UAAU,eAAe,MAAM,UACtC,QAAQ,KACN,kFACA,GACF;EAEJ;CACF;CAEA,iBAAyB,MAAc,QAAmC;EACxE,IAAI,OAAO,KAAK,YAAY,IAAI,OAAO,EAAE;EACzC,IAAI,CAAC,MAAM;GACT,OAAO;IAAE;IAAQ;IAAM,sBAAM,IAAI,IAAI;GAAE;GACvC,KAAK,YAAY,IAAI,OAAO,IAAI,IAAI;EACtC;EACA,OAAO;CACT;CAEA,UAAkB,QAAkB,OAAiC;EACnE,IAAI;GACF,OAAO,QAAQC,qBAAmB,KAAK,CAAC;GACxC,OAAO;EACT,QAAQ;GACN,OAAO;EACT;CACF;AACF;;CAndC,gBAAgB,OAAO;CACvB,WAAW;oBAeP,OAAO,SAAS,CAAA;oBAChB,OAAO,gBAAgB,CAAA;oBACvB,OAAO,eAAe,CAAA;oBACtB,OAAO,WAAW,CAAA;oBAClB,OAAO,mBAAmB,CAAA;oBAC1B,SAAS,CAAA;oBAAG,OAAO,eAAe,CAAA;;;;;;;;;;;;;ACrJvC,SAAgB,YAAwB;CACtC,IAAI;CACJ,OAAO;EACL,MAAM;EACN,KAAK,GAAG;GACN,OAAO;EACT;EACA,SAAS,KAAK;GACZ,OAAO,MAAM,kBAAkB,GAAG;EACpC;CACF;AACF;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,iBAAiB,YAAoC;CACnE,IAAI;CACJ,IAAI,YAAY;CAChB,MAAM,UAAU;CAKhB,OAAO;EACL,IAAI,OAAO;GACT,OAAO,WAAW;EACpB;EACA,KAAK,MAAM;GACT,UAAU;GACV,WAAW,KAAK,IAAI;EACtB;EACA,SAAS,KAAK;GACZ,IAAI,aAAa,SAAS,OAAO,QAAQ,kBAAkB,GAAG;GAC9D,OAAO,WAAW,SAAS,GAAG;EAChC;EACA,OAAO,WAAW,cAAc,WAAW,QAAQ,IAAI,KAAA;EACvD,MAAM,WAAW,aAAa,WAAW,OAAO,IAAI,KAAA;EAEpD,gBAAgB;GACd,YAAY;EACd;EACA,eAAe,KAA8B;GAC3C,QAAQ,iBAAiB,GAAG;EAC9B;CACF;AACF;;;;;;;;;;;;;;;;AAiBA,IAAa,mBAAb,MAA8B;CACC;CAA7B,YAAY,QAAqC;EAApB,KAAA,SAAA;CAAqB;CAElD,MAAM,WAAW,KAA4D;EAC3E,MAAM,QAAQ,MAAM,KAAK,OAAO,SAAS,GAAG;EAC5C,IAAI,OAAO,0BAA0B,KAAK;EAC1C,OAAO;CACT;AACF;;AAGA,SAAgB,mBACd,GACA,OACM;CACN,EAAE,OAAOC,wBAAsB,OAAO,MAAM,MAAM,CAAC;CACnD,EAAE,OAAOC,uBAAqB,MAAM,KAAK;AAC3C;;;;;;;AAQA,SAAS,0BAA0B,OAA0B;CAC3D,IAAI;EACF,mBAAmB,WAAW,GAAG,KAAK;CACxC,QAAQ,CAGR;AACF;;;;;;;;;;;;;;;;;;;;;;;;AC1FA,MAAM,EAAE,4BAA4B,aAAgC;CAClE,MAAM;CACN,cAAc;CACd,MAAM,YAAY,QAAQ,SAAS,QAAQ,QAAQ;CACnD,QAAQ,EAAE,SAAS,eAAe;EAChC,WAAW;GACT;IACE,SAAS;IACT,aAAa,MAAyB,EAAE,OAAO,IAAI,kBAAkB;IACrE,QAAQ,CAAC,OAAO;GAClB;GACA;IACE,SAAS;IAKT,aAAa,MAAyB,iBAAiB,EAAE,UAAU,UAAU,CAAC;IAC9E,QAAQ,CAAC,OAAO;GAClB;GACA;IACE,SAAS;IACT,aAAa,MAAyB;KACpC,MAAM,WAAW,EAAE;KACnB,IAAI,aAAa,OAAO,OAAO,IAAI,gBAAgB,KAAA,GAAW,KAAK;KACnE,OAAO,IAAI,gBAAgB,UAAU,OAAO,IAAI;IAClD;IACA,QAAQ,CAAC,OAAO;GAClB;GACA;IACE,SAAS;IACT,aAAa,WAAuB,IAAI,iBAAiB,MAAM;IAC/D,QAAQ,CAAC,WAAW;GACtB;GACA;GAIA,GAAI,SAAS,aAAa,QAAQ,CAAC,IAAI,CAAC,gBAAgB;EAC1D;EACA,SAAS;GAAC;GAAY;GAAkB;GAAa;GAAiB;EAAe;CACvF;AACF,CAAC;AAED,IAAa,aAAb,cAAgC,wBAAwB,CAAC"}