@openora/core 0.4.0 → 0.4.1-canary.100

package/dist/testing/mock.d.ts

@@ -1,28 +1,62 @@
 import { type Mock } from 'vitest';
-import type { DrizzleService } from '@openora/core/server';
+import type { AdminCaller, AdminGuard, DrizzleService, EventBus, OssContext } from '@openora/core/server';
+import { type AuditWritePort, type ClientMeta, type IdentityReader, type JobQueueAdapter, type PaymentAdapter, type PaymentProviderRegistry, type PaymentWebhookVerifier } from '@openora/core/contracts';
 /** Build a typed test double from a partial shape. */
 export declare const mock: <T>(partial?: object) => T;
-/** Wrap a fake `db` handle (usually a chainable Proxy) as a DrizzleService. */
-export declare const mockDb: (db: unknown) => DrizzleService;
-/** Read a private field off an instance without widening the class's public API. */
-export declare const readPrivate: <V = unknown>(obj: object, key: string) => V;
+export declare const NO_CLIENT_META: ClientMeta;
+export declare const adminCaller: (over?: Partial<AdminCaller>) => AdminCaller;
+export declare const testContext: (over?: Partial<OssContext>) => OssContext;
 type Row = Record<string, unknown>;
-export declare function makeQueryBuilder(results: {
-    select: Row[][];
-    returning: Row[][];
-}): Record<string, unknown>;
-export declare function makeDrizzle(results?: {
+/** Fake `DrizzleService` for tests asserting call order/shape rather than committed state -
+ * reach for `createTestDb` when a real unique index, lock or transaction outcome matters. */
+export declare const makeDrizzle: (results?: {
     select?: Row[][];
     returning?: Row[][];
-}): DrizzleService;
-export declare const makeEvents: () => {
+    execute?: Row[][];
+}) => DrizzleService;
+type MockedEventBus = EventBus & {
     emit: Mock;
     on: Mock;
     emitInTransaction: Mock;
 };
-export declare const makePayment: () => {
-    processDeposit: Mock;
-    processWithdrawal: Mock;
+/**
+ * EventBus double whose three methods are vitest mocks, so a test can both pass it
+ * to a service and assert on `events.emit` without a second `mock<EventBus>()` wrap.
+ */
+export declare const makeEventBus: () => MockedEventBus;
+export declare const makeAuditWriter: () => AuditWritePort & {
+    record: Mock;
 };
+/**
+ * PaymentProviderRegistry double wrapping a single adapter/verifier pair under
+ * DEFAULT_PAYMENT_PROVIDER - mirrors wallet/plugin.ts's default binding, so a test with
+ * one vendor changes nothing about how it builds a WalletService/router. Pass `names` to
+ * simulate an operator with more than one bound vendor (eg for providerName validation).
+ */
+export declare const makePaymentProviderRegistry: (options?: {
+    adapter?: PaymentAdapter;
+    webhookVerifier?: PaymentWebhookVerifier;
+    names?: readonly string[];
+}) => PaymentProviderRegistry;
+/** JobQueueAdapter double whose `enqueue` is a vitest mock, for a router test that only
+ * needs to assert a job was enqueued, never that it actually ran. */
+export declare const makeJobQueue: () => JobQueueAdapter & {
+    enqueue: Mock;
+};
+export declare const makeIdentityReader: () => IdentityReader;
+/**
+ * AdminGuard double driven by permission lists rather than a hand-rolled `assert`.
+ *
+ * Pass `allow` for an allowlist (anything unlisted throws FORBIDDEN, so `allow: []`
+ * denies every guarded route) or `deny` for a denylist. Each entry is a bare
+ * resource (`'admin'`, matching any action on it) or a full `resource:action`.
+ * With neither list every check passes. An unguarded `assert(ctx)` - no resource -
+ * always passes, mirroring the real guard's plain admin check.
+ */
+export declare const makeAdminGuard: (options?: {
+    allow?: readonly string[];
+    deny?: readonly string[];
+    caller?: Partial<AdminCaller>;
+}) => AdminGuard;
 export {};
 //# sourceMappingURL=mock.d.ts.map

package/dist/testing/mock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/testing/mock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,IAAI,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQ3D,sDAAsD;AACtD,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,UAAS,MAAW,KAAG,CAA4B,CAAC;AAE5E,+EAA+E;AAC/E,eAAO,MAAM,MAAM,GAAI,IAAI,OAAO,KAAG,cAAuD,CAAC;AAE7F,oFAAoF;AACpF,eAAO,MAAM,WAAW,GAAI,CAAC,GAAG,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG,CACnC,CAAC;AAElC,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAInC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;IAAC,SAAS,EAAE,GAAG,EAAE,EAAE,CAAA;CAAE,2BA6BhF;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,GAAG,EAAE,EAAE,CAAA;CAAO,kBAQlF;AAED,eAAO,MAAM,UAAU,QAAO;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,iBAAiB,EAAE,IAAI,CAAA;CAI3E,CAAC;AAEH,eAAO,MAAM,WAAW,QAAO;IAAE,cAAc,EAAE,IAAI,CAAC;IAAC,iBAAiB,EAAE,IAAI,CAAA;CAG5E,CAAC"}
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/testing/mock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,QAAQ,EACR,UAAU,EACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAC;AAQjC,sDAAsD;AACtD,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,UAAS,MAAW,KAAG,CAA4B,CAAC;AAE5E,eAAO,MAAM,cAAc,EAAE,UAA0C,CAAC;AAExE,eAAO,MAAM,WAAW,GAAI,OAAM,OAAO,CAAC,WAAW,CAAM,KAAG,WAK5D,CAAC;AAEH,eAAO,MAAM,WAAW,GAAI,OAAM,OAAO,CAAC,UAAU,CAAM,KAAG,UAI3D,CAAC;AAEH,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAsCnC;6FAC6F;AAC7F,eAAO,MAAM,WAAW,GACtB,UAAS;IAAE,MAAM,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,GAAG,EAAE,EAAE,CAAA;CAAO,KAY9C,cAC7B,CAAC;AAEF,KAAK,cAAc,GAAG,QAAQ,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,iBAAiB,EAAE,IAAI,CAAA;CAAE,CAAC;AAEnF;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAO,cACkD,CAAC;AAEnF,eAAO,MAAM,eAAe,QAAO,cAAc,GAAG;IAAE,MAAM,EAAE,IAAI,CAAA;CAGhE,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,GACtC,UAAS;IACP,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtB,KACL,uBASF,CAAC;AAEF;qEACqE;AACrE,eAAO,MAAM,YAAY,QAAO,eAAe,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAO7D,CAAC;AAEL,eAAO,MAAM,kBAAkB,QAAO,cASlC,CAAC;AAcL;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GACzB,UAAS;IACP,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC1B,KACL,UAQC,CAAC"}

package/dist/testing/mock.js

@@ -1,4 +1,6 @@
 import { vi } from 'vitest';
+import { ORPCError } from '@orpc/server';
+import { DEFAULT_PAYMENT_PROVIDER, } from '@openora/core/contracts';
 // The one sanctioned home for test-double type assertions. A unit test standing in
 // for a collaborator is inherently partial, so the cast lives here - documented and
 // in one place - instead of scattered `as unknown as` across every test body.
@@ -6,58 +8,128 @@ import { vi } from 'vitest';
 // funnelled through these helpers.
 /** Build a typed test double from a partial shape. */
 export const mock = (partial = {}) => partial;
-/** Wrap a fake `db` handle (usually a chainable Proxy) as a DrizzleService. */
-export const mockDb = (db) => ({ db });
-/** Read a private field off an instance without widening the class's public API. */
-export const readPrivate = (obj, key) => obj[key];
-// Chainable, awaitable Drizzle double: awaiting the builder pops the next `select` queue entry,
-// `.returning()` pops the `returning` queue - a test supplies per-statement results in call order.
-export function makeQueryBuilder(results) {
+export const NO_CLIENT_META = { ip: null, userAgent: null };
+export const adminCaller = (over = {}) => ({
+    userId: 'admin-1',
+    role: 'admin',
+    ...NO_CLIENT_META,
+    ...over,
+});
+export const testContext = (over = {}) => ({
+    request: { headers: {} },
+    clientMeta: NO_CLIENT_META,
+    ...over,
+});
+const CHAIN_METHODS = [
+    'select',
+    'from',
+    'innerJoin',
+    'leftJoin',
+    'orderBy',
+    'groupBy',
+    'limit',
+    'offset',
+    'for',
+    'insert',
+    'values',
+    'onConflictDoNothing',
+    'onConflictDoUpdate',
+    'update',
+    'set',
+    'delete',
+    'where',
+];
+/** Chainable, awaitable Drizzle double: awaiting the builder pops the next `select` queue
+ * entry, `.returning()` pops the `returning` queue - a test supplies per-statement results
+ * in call order. */
+const makeQueryBuilder = (results) => {
     const builder = {};
     const chain = () => builder;
-    for (const m of [
-        'select',
-        'from',
-        'innerJoin',
-        'leftJoin',
-        'orderBy',
-        'groupBy',
-        'limit',
-        'offset',
-        'for',
-        'insert',
-        'values',
-        'onConflictDoNothing',
-        'onConflictDoUpdate',
-        'update',
-        'set',
-        'delete',
-        'where',
-    ]) {
+    for (const m of CHAIN_METHODS) {
         builder[m] = vi.fn(chain);
     }
     builder['returning'] = vi.fn(() => Promise.resolve(results.returning.shift() ?? []));
-    builder['execute'] = vi.fn(() => Promise.resolve({ rows: [] }));
+    builder['execute'] = vi.fn(() => Promise.resolve({ rows: results.execute?.shift() ?? [] }));
     // oxlint-disable-next-line unicorn/no-thenable -- the builder must be awaitable to mimic Drizzle.
     builder['then'] = (resolve) => resolve(results.select.shift() ?? []);
     return builder;
-}
-export function makeDrizzle(results = {}) {
-    const state = { select: results.select ?? [], returning: results.returning ?? [] };
+};
+/** Fake `DrizzleService` for tests asserting call order/shape rather than committed state -
+ * reach for `createTestDb` when a real unique index, lock or transaction outcome matters. */
+export const makeDrizzle = (results = {}) => {
+    const state = {
+        select: results.select ?? [],
+        returning: results.returning ?? [],
+        execute: results.execute ?? [],
+    };
     const builder = makeQueryBuilder(state);
     const db = {
         ...builder,
         transaction: vi.fn(async (fn) => fn(builder)),
     };
-    return mockDb(db);
-}
-export const makeEvents = () => ({
-    emit: vi.fn(),
-    on: vi.fn(),
-    emitInTransaction: vi.fn(),
+    return { db };
+};
+/**
+ * EventBus double whose three methods are vitest mocks, so a test can both pass it
+ * to a service and assert on `events.emit` without a second `mock<EventBus>()` wrap.
+ */
+export const makeEventBus = () => mock({ emit: vi.fn(), on: vi.fn(), emitInTransaction: vi.fn() });
+export const makeAuditWriter = () => ({
+    record: vi.fn(async () => undefined),
+    recordInTransaction: vi.fn(async () => undefined),
+});
+/**
+ * PaymentProviderRegistry double wrapping a single adapter/verifier pair under
+ * DEFAULT_PAYMENT_PROVIDER - mirrors wallet/plugin.ts's default binding, so a test with
+ * one vendor changes nothing about how it builds a WalletService/router. Pass `names` to
+ * simulate an operator with more than one bound vendor (eg for providerName validation).
+ */
+export const makePaymentProviderRegistry = (options = {}) => {
+    const adapter = options.adapter ?? mock({});
+    const webhookVerifier = options.webhookVerifier ?? mock({ verify: vi.fn(() => false) });
+    const names = options.names ?? [DEFAULT_PAYMENT_PROVIDER];
+    return {
+        get: (name) => (name === DEFAULT_PAYMENT_PROVIDER ? { adapter, webhookVerifier } : null),
+        names: () => names,
+    };
+};
+/** JobQueueAdapter double whose `enqueue` is a vitest mock, for a router test that only
+ * needs to assert a job was enqueued, never that it actually ran. */
+export const makeJobQueue = () => mock({
+    enqueue: vi.fn(async () => ({ id: 'test-job' })),
+    schedule: vi.fn(async () => undefined),
+    unschedule: vi.fn(async () => undefined),
+    registerWorker: vi.fn(),
+    close: vi.fn(async () => undefined),
+});
+export const makeIdentityReader = () => mock({
+    getLastLoginAt: vi.fn().mockResolvedValue(null),
+    getPlayerIdsInactiveSince: vi.fn().mockResolvedValue([]),
+    getPlayerIdByUserId: vi.fn().mockResolvedValue(null),
+    getPlayerIdByUserIdSafe: vi.fn().mockResolvedValue(null),
+    getPlayerIdsByUserIdsSafe: vi.fn().mockResolvedValue(new Map()),
+    getPlayerKycStatusByUserId: vi.fn().mockResolvedValue(null),
+    getPlayerUserIdsSharingLoginIp: vi.fn().mockResolvedValue([]),
 });
-export const makePayment = () => ({
-    processDeposit: vi.fn().mockResolvedValue({ externalId: 'ext-1', status: 'completed' }),
-    processWithdrawal: vi.fn().mockResolvedValue({ externalId: 'ext-2', status: 'completed' }),
+const matches = (refs, resource, action) => refs.includes(resource) || refs.includes(`${resource}:${action}`);
+const isPermitted = (options, resource, action) => options.allow
+    ? matches(options.allow, resource, action)
+    : !matches(options.deny ?? [], resource, action);
+/**
+ * AdminGuard double driven by permission lists rather than a hand-rolled `assert`.
+ *
+ * Pass `allow` for an allowlist (anything unlisted throws FORBIDDEN, so `allow: []`
+ * denies every guarded route) or `deny` for a denylist. Each entry is a bare
+ * resource (`'admin'`, matching any action on it) or a full `resource:action`.
+ * With neither list every check passes. An unguarded `assert(ctx)` - no resource -
+ * always passes, mirroring the real guard's plain admin check.
+ */
+export const makeAdminGuard = (options = {}) => mock({
+    assert: vi.fn(async (_ctx, resource, action) => {
+        if (resource && action && !isPermitted(options, resource, action)) {
+            throw new ORPCError('FORBIDDEN', { message: `Missing permission: ${resource}:${action}` });
+        }
+        return adminCaller(options.caller);
+    }),
 });
 //# sourceMappingURL=mock.js.map

package/dist/testing/mock.js.map

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

package/dist/testing/real-infra.d.ts

@@ -0,0 +1,47 @@
+import { createClient } from 'redis';
+import { DrizzleService } from '@openora/core/server';
+/**
+ * The Redis URL for THIS worker's logical DB, in the `redis://host:port/db` form that
+ * ioredis-based drivers (BullMQ) parse. Keeps BullMQ on the same per-worker DB as
+ * `createTestRedis`, so a `flush()` tears both down together.
+ */
+export declare function redisUrlForWorker(): string;
+/**
+ * Poll until a Redis Streams consumer group exists on `stream`. The broker creates its
+ * group lazily inside the read loop (at `$`), so a publish issued before the group
+ * exists would be missed - tests await this after subscribing, before publishing.
+ */
+export declare function waitForConsumerGroup(client: ReturnType<typeof createClient>, { stream, group, timeoutMs }: {
+    stream: string;
+    group: string;
+    timeoutMs?: number;
+}): Promise<void>;
+/** A per-module migration entrypoint (`packages/core/src/<module>/migrate.ts`). */
+export type Migration = (databaseUrl: string) => Promise<unknown>;
+export type TestDb = {
+    url: string;
+    drizzle: DrizzleService;
+    drop: () => Promise<void>;
+};
+/**
+ * Create a throwaway `test_<random>` database, apply the given per-module migrations
+ * against it, and return a `DrizzleService` bound to it. `drop()` disposes the pool
+ * and drops the database with FORCE (terminating any lingering backends).
+ *
+ * `DrizzleService` reads `DATABASE_URL` in its constructor, so this points the env at
+ * the ephemeral url just before constructing it - safe because a test file owns one db.
+ */
+export declare function createTestDb(migrations: Migration[]): Promise<TestDb>;
+export type TestRedis = {
+    client: ReturnType<typeof createClient>;
+    flush: () => Promise<void>;
+    quit: () => Promise<void>;
+};
+/**
+ * Connect a node-redis client selected to a per-worker logical DB (VITEST_POOL_ID % 16),
+ * so parallel vitest workers never collide on keys. `flush()` is a `flushDb` (safe - it
+ * only clears this worker's logical DB), for tearing down between tests. `reconnectStrategy`
+ * is off: node-redis otherwise retries a down server forever and hangs the run.
+ */
+export declare function createTestRedis(): Promise<TestRedis>;
+//# sourceMappingURL=real-infra.d.ts.map

package/dist/testing/real-infra.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"real-infra.d.ts","sourceRoot":"","sources":["../../src/testing/real-infra.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAqBtD;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,EACvC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAgB,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACzF,OAAO,CAAC,IAAI,CAAC,CAgBf;AAeD,mFAAmF;AACnF,MAAM,MAAM,SAAS,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAElE,MAAM,MAAM,MAAM,GAAG;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA8B3E;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACxC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,SAAS,CAAC,CAqB1D"}

package/dist/testing/real-infra.js

@@ -0,0 +1,125 @@
+import { randomUUID } from 'node:crypto';
+import { Pool } from 'pg';
+import { createClient } from 'redis';
+import { DrizzleService } from '@openora/core/server';
+const INFRA_HINT = 'real-infra tests need postgres+redis - run `docker compose up -d`';
+const ADMIN_DATABASE_URL = process.env['TEST_ADMIN_DATABASE_URL'] ??
+    'postgresql://postgres:postgres@localhost:5432/postgres';
+const REDIS_URL = process.env['TEST_REDIS_URL'] ?? 'redis://localhost:6379';
+// Databases 0-7 belong to this tier; `@openora/testing` claims 8-15 (see its redis.ts).
+// The split is what lets both integration suites run concurrently without flushing
+// each other's keys - do not widen it without moving the other tier too.
+const REDIS_LOGICAL_DATABASE_COUNT = 8;
+const REDIS_DATABASE = Number(process.env['VITEST_POOL_ID'] ?? 1) % REDIS_LOGICAL_DATABASE_COUNT;
+function withRedisDatabase(baseUrl, database) {
+    const url = new URL(baseUrl);
+    url.pathname = `/${database}`;
+    return url.toString();
+}
+/**
+ * The Redis URL for THIS worker's logical DB, in the `redis://host:port/db` form that
+ * ioredis-based drivers (BullMQ) parse. Keeps BullMQ on the same per-worker DB as
+ * `createTestRedis`, so a `flush()` tears both down together.
+ */
+export function redisUrlForWorker() {
+    return withRedisDatabase(REDIS_URL, REDIS_DATABASE);
+}
+/**
+ * Poll until a Redis Streams consumer group exists on `stream`. The broker creates its
+ * group lazily inside the read loop (at `$`), so a publish issued before the group
+ * exists would be missed - tests await this after subscribing, before publishing.
+ */
+export async function waitForConsumerGroup(client, { stream, group, timeoutMs = 3000 }) {
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        try {
+            const groups = await client.xInfoGroups(stream);
+            if (groups.some((g) => g.name === group)) {
+                return;
+            }
+        }
+        catch {
+            // stream not created yet (MKSTREAM happens with the group) - keep polling
+        }
+        if (Date.now() > deadline) {
+            throw new Error(`consumer group '${group}' on '${stream}' not ready within ${timeoutMs}ms`);
+        }
+        await new Promise((resolve) => setTimeout(resolve, 10));
+    }
+}
+function isConnectionError(err) {
+    const code = err.code;
+    return (code === 'ECONNREFUSED' || code === 'ENOTFOUND' || code === 'ETIMEDOUT' || code === 'EAI_AGAIN');
+}
+function withDatabase(adminUrl, database) {
+    const url = new URL(adminUrl);
+    url.pathname = `/${database}`;
+    return url.toString();
+}
+/**
+ * Create a throwaway `test_<random>` database, apply the given per-module migrations
+ * against it, and return a `DrizzleService` bound to it. `drop()` disposes the pool
+ * and drops the database with FORCE (terminating any lingering backends).
+ *
+ * `DrizzleService` reads `DATABASE_URL` in its constructor, so this points the env at
+ * the ephemeral url just before constructing it - safe because a test file owns one db.
+ */
+export async function createTestDb(migrations) {
+    const database = `test_${randomUUID().replaceAll('-', '')}`;
+    const admin = new Pool({ connectionString: ADMIN_DATABASE_URL, connectionTimeoutMillis: 5000 });
+    try {
+        await admin.query(`CREATE DATABASE "${database}"`);
+    }
+    catch (err) {
+        await admin.end();
+        if (isConnectionError(err)) {
+            throw new Error(INFRA_HINT, { cause: err });
+        }
+        throw err;
+    }
+    const url = withDatabase(ADMIN_DATABASE_URL, database);
+    for (const migrate of migrations) {
+        await migrate(url);
+    }
+    process.env['DATABASE_URL'] = url;
+    const drizzle = new DrizzleService();
+    return {
+        url,
+        drizzle,
+        async drop() {
+            await drizzle.dispose();
+            await admin.query(`DROP DATABASE IF EXISTS "${database}" WITH (FORCE)`);
+            await admin.end();
+        },
+    };
+}
+/**
+ * Connect a node-redis client selected to a per-worker logical DB (VITEST_POOL_ID % 16),
+ * so parallel vitest workers never collide on keys. `flush()` is a `flushDb` (safe - it
+ * only clears this worker's logical DB), for tearing down between tests. `reconnectStrategy`
+ * is off: node-redis otherwise retries a down server forever and hangs the run.
+ */
+export async function createTestRedis() {
+    const client = createClient({
+        url: REDIS_URL,
+        database: REDIS_DATABASE,
+        socket: { reconnectStrategy: false, connectTimeout: 3000 },
+    });
+    client.on('error', () => undefined);
+    try {
+        await client.connect();
+    }
+    catch (err) {
+        throw new Error(INFRA_HINT, { cause: err });
+    }
+    return {
+        client,
+        async flush() {
+            await client.flushDb();
+        },
+        async quit() {
+            await client.quit();
+        },
+    };
+}
+//# sourceMappingURL=real-infra.js.map

package/dist/testing/real-infra.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"real-infra.js","sourceRoot":"","sources":["../../src/testing/real-infra.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,UAAU,GAAG,mEAAmE,CAAC;AAEvF,MAAM,kBAAkB,GACtB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;IACtC,wDAAwD,CAAC;AAC3D,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,wBAAwB,CAAC;AAE5E,wFAAwF;AACxF,mFAAmF;AACnF,yEAAyE;AACzE,MAAM,4BAA4B,GAAG,CAAC,CAAC;AACvC,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,GAAG,4BAA4B,CAAC;AAEjG,SAAS,iBAAiB,CAAC,OAAe,EAAE,QAAgB;IAC1D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,GAAG,CAAC,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC9B,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,iBAAiB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAuC,EACvC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,EAAyD;IAE1F,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,SAAS,CAAC;QACR,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAChD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBACzC,OAAO;YACT,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0EAA0E;QAC5E,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,SAAS,MAAM,sBAAsB,SAAS,IAAI,CAAC,CAAC;QAC9F,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAY;IACrC,MAAM,IAAI,GAAI,GAAyB,CAAC,IAAI,CAAC;IAC7C,OAAO,CACL,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,CAChG,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB,EAAE,QAAgB;IACtD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,GAAG,CAAC,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC9B,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAWD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAuB;IACxD,MAAM,QAAQ,GAAG,QAAQ,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;IAC5D,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,IAAI,EAAE,CAAC,CAAC;IAChG,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,KAAK,CAAC,oBAAoB,QAAQ,GAAG,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC;QAClB,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,MAAM,GAAG,GAAG,YAAY,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;IACvD,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;QACjC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;IAErC,OAAO;QACL,GAAG;QACH,OAAO;QACP,KAAK,CAAC,IAAI;YACR,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;YACxB,MAAM,KAAK,CAAC,KAAK,CAAC,4BAA4B,QAAQ,gBAAgB,CAAC,CAAC;YACxE,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC;AAQD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,GAAG,EAAE,SAAS;QACd,QAAQ,EAAE,cAAc;QACxB,MAAM,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE;KAC3D,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO;QACL,MAAM;QACN,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACzB,CAAC;QACD,KAAK,CAAC,IAAI;YACR,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/testing/realtime-transport-conformance.d.ts

@@ -0,0 +1,35 @@
+import type { RealtimeTransport } from '@openora/core/contracts';
+export type RealtimeTransportHarness = {
+    /** Used only in describe() block naming for readable output. */
+    name: string;
+    create: () => RealtimeTransport;
+    /**
+     * False for a transport whose subscribe() is a server-side no-op because
+     * clients connect directly to a managed vendor's edge (eg AblyRealtimeTransport).
+     * Gates the publish/subscribe fan-out assertions.
+     */
+    supportsServerSideSubscribe: boolean;
+    /**
+     * Seeds the harness's notion of "these users are online in this channel" so
+     * getOnlineUserIds() can be asserted the same way across a transport that
+     * tracks join/leave itself (in-process) and one that reads a vendor-side
+     * presence set instead (Ably) - the entries stand in for real connections
+     * regardless of how the transport backs them.
+     */
+    addPresence?: (transport: RealtimeTransport, channel: string, entries: {
+        userId: string;
+        connectionId: string;
+    }[]) => void | Promise<void>;
+    /**
+     * Forces the harness's next presence/online-user call to fail, to assert
+     * graceful degradation (never throws/rejects, returns a safe default).
+     */
+    simulateFailure?: (transport: RealtimeTransport) => void;
+};
+/**
+ * Shared behavioral spec for every RealtimeTransport implementation. Run this
+ * against each adapter alongside its own adapter-specific tests (this suite
+ * doesn't replace those) - it only proves the two satisfy the SAME contract.
+ */
+export declare function runRealtimeTransportConformanceSuite(harness: RealtimeTransportHarness): void;
+//# sourceMappingURL=realtime-transport-conformance.d.ts.map

package/dist/testing/realtime-transport-conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-transport-conformance.d.ts","sourceRoot":"","sources":["../../src/testing/realtime-transport-conformance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,MAAM,wBAAwB,GAAG;IACrC,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,iBAAiB,CAAC;IAChC;;;;OAIG;IACH,2BAA2B,EAAE,OAAO,CAAC;IACrC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,CACZ,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EAAE,KAChD,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC1D,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAqF5F"}

package/dist/testing/realtime-transport-conformance.js

@@ -0,0 +1,81 @@
+import { describe, expect, it } from 'vitest';
+/**
+ * Shared behavioral spec for every RealtimeTransport implementation. Run this
+ * against each adapter alongside its own adapter-specific tests (this suite
+ * doesn't replace those) - it only proves the two satisfy the SAME contract.
+ */
+export function runRealtimeTransportConformanceSuite(harness) {
+    describe(`RealtimeTransport conformance: ${harness.name}`, () => {
+        it('publish never throws or rejects, even to a channel with no subscribers', async () => {
+            const transport = harness.create();
+            await expect(Promise.resolve(transport.publish('nobody-listening', { x: 1 }))).resolves.toBeUndefined();
+        });
+        it('remove never throws or rejects, even to a channel with no subscribers', async () => {
+            const transport = harness.create();
+            await expect(Promise.resolve(transport.remove('nobody-listening', { id: 'message-1', isDeleted: true }))).resolves.toBeUndefined();
+        });
+        it('subscribe returns an unsubscribe function that is idempotent', () => {
+            const transport = harness.create();
+            const unsubscribe = transport.subscribe('c', () => { });
+            expect(typeof unsubscribe).toBe('function');
+            expect(() => unsubscribe()).not.toThrow();
+            expect(() => unsubscribe()).not.toThrow();
+        });
+        if (harness.supportsServerSideSubscribe) {
+            it('fans a published event out to every subscriber of the channel', () => {
+                const transport = harness.create();
+                const a = [];
+                const b = [];
+                transport.subscribe('c', (event) => a.push(event));
+                transport.subscribe('c', (event) => b.push(event));
+                transport.publish('c', 1);
+                expect(a).toEqual([1]);
+                expect(b).toEqual([1]);
+            });
+            it('does not deliver across channels', () => {
+                const transport = harness.create();
+                const got = [];
+                transport.subscribe('one', (event) => got.push(event));
+                transport.publish('two', 99);
+                expect(got).toEqual([]);
+            });
+            it('stops delivering after unsubscribe', () => {
+                const transport = harness.create();
+                const got = [];
+                const unsubscribe = transport.subscribe('c', (event) => got.push(event));
+                transport.publish('c', 1);
+                unsubscribe();
+                transport.publish('c', 2);
+                expect(got).toEqual([1]);
+            });
+        }
+        if (harness.addPresence) {
+            it('getOnlineUserIds excludes anonymous:* connections', async () => {
+                const transport = harness.create();
+                await harness.addPresence?.(transport, 'room', [
+                    { userId: 'player-1', connectionId: 'tab-1' },
+                    { userId: 'anonymous:conn-1', connectionId: 'tab-2' },
+                ]);
+                const ids = await transport.getOnlineUserIds('room');
+                expect(ids).toEqual(['player-1']);
+            });
+            it('getOnlineUserIds deduplicates concurrent connections for the same user', async () => {
+                const transport = harness.create();
+                await harness.addPresence?.(transport, 'room', [
+                    { userId: 'player-1', connectionId: 'tab-1' },
+                    { userId: 'player-1', connectionId: 'tab-2' },
+                ]);
+                const ids = await transport.getOnlineUserIds('room');
+                expect(ids).toEqual(['player-1']);
+            });
+        }
+        if (harness.simulateFailure) {
+            it('getOnlineUserIds degrades to an empty array instead of throwing when unhealthy', async () => {
+                const transport = harness.create();
+                harness.simulateFailure?.(transport);
+                await expect(transport.getOnlineUserIds('room')).resolves.toEqual([]);
+            });
+        }
+    });
+}
+//# sourceMappingURL=realtime-transport-conformance.js.map

package/dist/testing/realtime-transport-conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-transport-conformance.js","sourceRoot":"","sources":["../../src/testing/realtime-transport-conformance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAgC9C;;;;GAIG;AACH,MAAM,UAAU,oCAAoC,CAAC,OAAiC;IACpF,QAAQ,CAAC,kCAAkC,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE;QAC9D,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;YACtF,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,MAAM,CACV,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CACjE,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;YACrF,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,MAAM,CACV,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,kBAAkB,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAC5F,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;YACtE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,WAAW,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACvD,MAAM,CAAC,OAAO,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC5C,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAC1C,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,2BAA2B,EAAE,CAAC;YACxC,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;gBACvE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnC,MAAM,CAAC,GAAa,EAAE,CAAC;gBACvB,MAAM,CAAC,GAAa,EAAE,CAAC;gBACvB,SAAS,CAAC,SAAS,CAAS,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC3D,SAAS,CAAC,SAAS,CAAS,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC3D,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAC1B,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACvB,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACzB,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;gBAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnC,MAAM,GAAG,GAAa,EAAE,CAAC;gBACzB,SAAS,CAAC,SAAS,CAAS,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC/D,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC7B,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC1B,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;gBAC5C,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnC,MAAM,GAAG,GAAa,EAAE,CAAC;gBACzB,MAAM,WAAW,GAAG,SAAS,CAAC,SAAS,CAAS,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;gBACjF,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAC1B,WAAW,EAAE,CAAC;gBACd,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;gBACjE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnC,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE;oBAC7C,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE;oBAC7C,EAAE,MAAM,EAAE,kBAAkB,EAAE,YAAY,EAAE,OAAO,EAAE;iBACtD,CAAC,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;gBACrD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;YACpC,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;gBACtF,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnC,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE;oBAC7C,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE;oBAC7C,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE;iBAC9C,CAAC,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;gBACrD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;YACpC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5B,EAAE,CAAC,gFAAgF,EAAE,KAAK,IAAI,EAAE;gBAC9F,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnC,OAAO,CAAC,eAAe,EAAE,CAAC,SAAS,CAAC,CAAC;gBACrC,MAAM,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACxE,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}