@openora/core 0.4.1-canary.13 → 0.4.1-canary.131

package/dist/contracts/adapters/admin-wallet-reporting.js

@@ -1,3 +1,12 @@
 import { createToken } from './token.js';
+export const ADMIN_TX_SORT_BY_VALUES = [
+    'createdAt',
+    'amount',
+    'type',
+    'status',
+    'currency',
+    'rail',
+    'reviewedAt',
+];
 export const ADMIN_WALLET_REPORTING = createToken('ADMIN_WALLET_REPORTING');
 //# sourceMappingURL=admin-wallet-reporting.js.map

package/dist/contracts/adapters/admin-wallet-reporting.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-wallet-reporting.js","sourceRoot":"","sources":["../../../src/contracts/adapters/admin-wallet-reporting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAmDrD,MAAM,CAAC,MAAM,sBAAsB,GACjC,WAAW,CAAC,wBAAwB,CAAC,CAAC"}
+{"version":3,"file":"admin-wallet-reporting.js","sourceRoot":"","sources":["../../../src/contracts/adapters/admin-wallet-reporting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAkCrD,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,WAAW;IACX,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,UAAU;IACV,MAAM;IACN,YAAY;CACJ,CAAC;AAyBX,MAAM,CAAC,MAAM,sBAAsB,GACjC,WAAW,CAAC,wBAAwB,CAAC,CAAC"}

package/dist/contracts/adapters/aggregator.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Igaming-aggregator seam. An aggregator fans out to many game providers'
+ * catalogues; bind a concrete adapter to AGGREGATOR_ADAPTER in the
+ * igaming-aggregator module's plugin.ts.
+ */
 import { type Token } from './token.js';
 export type AggregatorGame = {
     externalId: string;
@@ -14,6 +19,13 @@ export type AggregatorAdapter = {
     handleCallback(event: string, payload: unknown): Promise<void>;
 };
 export declare const AGGREGATOR_ADAPTER: Token<AggregatorAdapter>;
+/**
+ * Verifies the public M2M callback is genuinely from the aggregator. The default
+ * impl recomputes an HMAC-SHA256 over the raw request body and constant-time
+ * compares it against the `x-aggregator-signature` header; a vendor overlay can
+ * rebind it to match that vendor's scheme. Fails closed when the secret is unset,
+ * the signature header is absent, or the raw body was not captured.
+ */
 export type AggregatorWebhookVerifier = {
     verify(rawBody: string, signature: string | null): boolean;
 };

package/dist/contracts/adapters/aggregator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aggregator.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/aggregator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,eAAe,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAC;IACxD,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,iBAAiB,CAAqC,CAAC;AAO9F,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC;CAC5D,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,KAAK,CAAC,yBAAyB,CAExE,CAAC"}
+{"version":3,"file":"aggregator.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/aggregator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,eAAe,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAC;IACxD,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,iBAAiB,CAAqC,CAAC;AAE9F;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC;CAC5D,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,KAAK,CAAC,yBAAyB,CAExE,CAAC"}

package/dist/contracts/adapters/aggregator.js

@@ -1,6 +1,8 @@
-// Igaming-aggregator seam. An aggregator fans out to many game providers'
-// catalogues; bind a concrete adapter to AGGREGATOR_ADAPTER in the
-// igaming-aggregator module's plugin.ts.
+/**
+ * Igaming-aggregator seam. An aggregator fans out to many game providers'
+ * catalogues; bind a concrete adapter to AGGREGATOR_ADAPTER in the
+ * igaming-aggregator module's plugin.ts.
+ */
 import { createToken } from './token.js';
 export const AGGREGATOR_ADAPTER = createToken('AGGREGATOR_ADAPTER');
 export const AGGREGATOR_WEBHOOK_VERIFIER = createToken('AGGREGATOR_WEBHOOK_VERIFIER');

package/dist/contracts/adapters/aggregator.js.map

@@ -1 +1 @@
-{"version":3,"file":"aggregator.js","sourceRoot":"","sources":["../../../src/contracts/adapters/aggregator.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,mEAAmE;AACnE,yCAAyC;AACzC,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAgBrD,MAAM,CAAC,MAAM,kBAAkB,GAA6B,WAAW,CAAC,oBAAoB,CAAC,CAAC;AAW9F,MAAM,CAAC,MAAM,2BAA2B,GAAqC,WAAW,CACtF,6BAA6B,CAC9B,CAAC"}
+{"version":3,"file":"aggregator.js","sourceRoot":"","sources":["../../../src/contracts/adapters/aggregator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAgBrD,MAAM,CAAC,MAAM,kBAAkB,GAA6B,WAAW,CAAC,oBAAoB,CAAC,CAAC;AAa9F,MAAM,CAAC,MAAM,2BAA2B,GAAqC,WAAW,CACtF,6BAA6B,CAC9B,CAAC"}

package/dist/contracts/adapters/audit.d.ts

@@ -1,6 +1,24 @@
+/**
+ * Audit-write seam. AML/SAR audit writes are a regulator-mandated invariant under
+ * MGA/UKGC - the audit module binds the sole implementation via ctx.provideSealed()
+ * (bind-once, owner-only); no overlay can rebind it (ctx.provide() rejects any
+ * sealed token outright, and provideSealed() itself refuses a second bind). Other
+ * modules resolve this port read-only (container.get(AUDIT_WRITER)) to call it.
+ */
 import type { DomainEventName } from '../schemas/events.js';
+import type { ClientMeta } from '../schemas/common.js';
 import { type SealedToken } from './token.js';
-export type DirectAuditAction = 'admin.user.updated' | 'audit.export' | 'wallet.withdrawal.auto_approved' | 'wallet.auto_withdrawal_rule.set' | 'wallet.auto_withdrawal_rule.deleted';
+/**
+ * Admin actions that are recorded directly (not via a domain-event subscription)
+ * and so have no entry in `domainEventSchemas`. Add new direct actions here.
+ */
+export type DirectAuditAction = 'admin.user.updated' | 'admin.player.updated' | 'admin.player.removed' | 'admin.player_note.created' | 'audit.export' | 'mail.regulatory_delivery.sent' | 'mail.regulatory_delivery.failed' | 'chat.mute.expired' | 'chat.platform_ban.expired' | 'player.display_currency.set' | 'compliance.kyc.bulk_approve' | 'wallet.withdrawal.auto_approved' | 'wallet.auto_withdrawal_rule.set' | 'wallet.auto_withdrawal_rule.deleted' | 'wallet.auto_withdrawal_config.set' | 'wallet.bonus_credit.created' | 'wallet.bonus_credit.completed' | 'wallet.bonus_rollover_config.set' | 'wallet.manual_adjustment.created' | 'wallet.withdrawal_address.created' | 'wallet.withdrawal_address.deleted' | 'wallet.custody.sweep_cycle' | 'wallet.custody.sweep' | 'wallet.reconciliation_finding.recorded' | 'wallet.reconciliation_run.skipped' | 'wallet.reconciliation_run.completed' | 'wallet.reconciliation_run.failed' | 'wallet.reconciliation_finding.resolved' | 'wallet.wallet_asset.created' | 'wallet.wallet_asset.updated' | 'wallet.wallet_asset.deleted';
+/**
+ * Every value the audit `action` column legitimately holds: a cross-module domain
+ * event topic (recorded by the audit plugin's subscriptions) or a direct admin
+ * action. The `string & {}` arm keeps literal autocomplete while still accepting
+ * overlay-defined actions, so it constrains nothing at runtime - it just guides.
+ */
 export type AuditAction = DomainEventName | DirectAuditAction | (string & {});
 export type AuditWritePort = {
     record(entry: {
@@ -11,10 +29,18 @@ export type AuditWritePort = {
         resourceId?: string | null;
         before?: Record<string, unknown> | null;
         after?: Record<string, unknown> | null;
-        ip?: string | null;
-        userAgent?: string | null;
         correlationId?: string | null;
-    }): Promise<void>;
+    } & Partial<ClientMeta>): Promise<void>;
+    recordInTransaction(tx: unknown, entry: {
+        actorId?: string | null;
+        actorType: 'player' | 'admin' | 'system';
+        action: AuditAction;
+        resourceType: string;
+        resourceId?: string | null;
+        before?: Record<string, unknown> | null;
+        after?: Record<string, unknown> | null;
+        correlationId?: string | null;
+    } & Partial<ClientMeta>): Promise<void>;
 };
 export declare const AUDIT_WRITER: SealedToken<AuditWritePort>;
 //# sourceMappingURL=audit.d.ts.map

package/dist/contracts/adapters/audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/audit.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAIjE,MAAM,MAAM,iBAAiB,GACzB,oBAAoB,GACpB,cAAc,GACd,iCAAiC,GACjC,iCAAiC,GACjC,qCAAqC,CAAC;AAM1C,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,iBAAiB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE9E,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,KAAK,EAAE;QACZ,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,SAAS,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;QACzC,MAAM,EAAE,WAAW,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QACxC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QACvC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,cAAc,CACF,CAAC"}
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/audit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB,oBAAoB,GACpB,sBAAsB,GACtB,sBAAsB,GACtB,2BAA2B,GAC3B,cAAc,GACd,+BAA+B,GAC/B,iCAAiC,GACjC,mBAAmB,GACnB,2BAA2B,GAC3B,6BAA6B,GAC7B,6BAA6B,GAC7B,iCAAiC,GACjC,iCAAiC,GACjC,qCAAqC,GACrC,mCAAmC,GACnC,6BAA6B,GAC7B,+BAA+B,GAC/B,kCAAkC,GAClC,kCAAkC,GAClC,mCAAmC,GACnC,mCAAmC,GACnC,4BAA4B,GAC5B,sBAAsB,GACtB,wCAAwC,GACxC,mCAAmC,GACnC,qCAAqC,GACrC,kCAAkC,GAClC,wCAAwC,GACxC,6BAA6B,GAC7B,6BAA6B,GAC7B,6BAA6B,CAAC;AAElC;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,iBAAiB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE9E,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CACJ,KAAK,EAAE;QACL,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,SAAS,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;QACzC,MAAM,EAAE,WAAW,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QACxC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QACvC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,GAAG,OAAO,CAAC,UAAU,CAAC,GACtB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,mBAAmB,CACjB,EAAE,EAAE,OAAO,EACX,KAAK,EAAE;QACL,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,SAAS,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;QACzC,MAAM,EAAE,WAAW,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QACxC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QACvC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,GAAG,OAAO,CAAC,UAAU,CAAC,GACtB,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,cAAc,CACF,CAAC"}

package/dist/contracts/adapters/audit.js.map

@@ -1 +1 @@
-{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../../src/contracts/adapters/audit.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAoB,MAAM,YAAY,CAAC;AAgCjE,MAAM,CAAC,MAAM,YAAY,GACvB,iBAAiB,CAAiB,cAAc,CAAC,CAAC"}
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../../src/contracts/adapters/audit.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,iBAAiB,EAAoB,MAAM,YAAY,CAAC;AA2EjE,MAAM,CAAC,MAAM,YAAY,GACvB,iBAAiB,CAAiB,cAAc,CAAC,CAAC"}

package/dist/contracts/adapters/broker.d.ts

@@ -1,15 +1,38 @@
+/**
+ * Message-broker seam. The EventBus (@openora/core/server) publishes/subscribes through this
+ * adapter, so the inter-module transport is swappable: the default binding is an
+ * in-process broker; a downstream operator binds a durable driver (RabbitMQ,
+ * Redpanda / Kafka API, NATS JetStream) to MESSAGE_BROKER in an overlay and every
+ * event flows through it - no module change. Delivery is at-least-once once a real
+ * broker is bound, so consumers must be idempotent. See ADR-0010 and ADR-0016.
+ */
 import { type Token } from './token.js';
+/**
+ * On-the-wire envelope that every remote adapter serializes. The EventBus
+ * builds this internally; module code never sees it (only the typed payload).
+ */
 export type EventEnvelope<T = unknown> = {
+    /** Consumer-side idempotency/dedup key (UUID per emission). */
     eventId: string;
+    /** Domain event name (eg "wallet.deposit.completed"). */
     topic: string;
+    /** The validated event payload (matches domainEventSchemas). */
     payload: T;
+    /** ISO-8601 timestamp of the emission. */
     occurredAt: string;
+    /** Monotonic integer for forward-compat payload evolution. */
     schemaVersion: number;
+    /** Maps to Kafka partition key / RabbitMQ routing key for per-user ordering guarantees. */
     orderingKey?: string;
+    /** Distributed trace correlation ID. */
     traceId?: string;
 };
 export type BrokerHandler = (envelope: EventEnvelope) => void | Promise<void>;
 export type SubscribeOptions = {
+    /**
+     * Forward hint for grouped consumers: Kafka consumer group / RabbitMQ queue group.
+     * When omitted, the adapter creates an exclusive per-process queue (fan-out).
+     */
     consumerGroup?: string;
 };
 export type MessageBrokerAdapter = {

package/dist/contracts/adapters/broker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/broker.ts"],"names":[],"mappings":"AAMA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAarD,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,OAAO,IAAI;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAI9E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAAC;IACzF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,oBAAoB,CAAiC,CAAC"}
+{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/broker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,OAAO,IAAI;IACvC,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,OAAO,EAAE,CAAC,CAAC;IACX,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAAC;IACzF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,oBAAoB,CAAiC,CAAC"}

package/dist/contracts/adapters/broker.js

@@ -1,9 +1,11 @@
-// Message-broker seam. The EventBus (@openora/core/server) publishes/subscribes through this
-// adapter, so the inter-module transport is swappable: the default binding is an
-// in-process broker; a downstream operator binds a durable driver (RabbitMQ,
-// Redpanda / Kafka API, NATS JetStream) to MESSAGE_BROKER in an overlay and every
-// event flows through it - no module change. Delivery is at-least-once once a real
-// broker is bound, so consumers must be idempotent. See ADR-0010 and ADR-0016.
+/**
+ * Message-broker seam. The EventBus (@openora/core/server) publishes/subscribes through this
+ * adapter, so the inter-module transport is swappable: the default binding is an
+ * in-process broker; a downstream operator binds a durable driver (RabbitMQ,
+ * Redpanda / Kafka API, NATS JetStream) to MESSAGE_BROKER in an overlay and every
+ * event flows through it - no module change. Delivery is at-least-once once a real
+ * broker is bound, so consumers must be idempotent. See ADR-0010 and ADR-0016.
+ */
 import { createToken } from './token.js';
 export const MESSAGE_BROKER = createToken('MESSAGE_BROKER');
 //# sourceMappingURL=broker.js.map

package/dist/contracts/adapters/broker.js.map

@@ -1 +1 @@
-{"version":3,"file":"broker.js","sourceRoot":"","sources":["../../../src/contracts/adapters/broker.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,iFAAiF;AACjF,6EAA6E;AAC7E,kFAAkF;AAClF,mFAAmF;AACnF,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAqCrD,MAAM,CAAC,MAAM,cAAc,GAAgC,WAAW,CAAC,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"broker.js","sourceRoot":"","sources":["../../../src/contracts/adapters/broker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAuCrD,MAAM,CAAC,MAAM,cAAc,GAAgC,WAAW,CAAC,gBAAgB,CAAC,CAAC"}

package/dist/contracts/adapters/cache.d.ts

@@ -1,9 +1,20 @@
+/**
+ * Cache seam. Hot, non-personalized reads (public catalogue/content feeds) load
+ * through this adapter so the backend is swappable: the default binding is an
+ * in-process TTL cache (zero deps), process-local so invalidation does NOT
+ * propagate across replicas. Set REDIS_URL to bind the shipped Redis reference
+ * adapter (cross-replica invalidation) with zero consumer code; rebind CACHE via
+ * an overlay for any other backend.
+ */
 import { type Token } from './token.js';
 export type CacheAdapter = {
     get<T>(key: string): Promise<T | undefined>;
     set<T>(key: string, value: T, opts: {
         ttlMs: number;
     }): Promise<void>;
+    setIfAbsent<T>(key: string, value: T, opts: {
+        ttlMs: number;
+    }): Promise<boolean>;
     delete(key: string | string[]): Promise<void>;
 };
 export declare const CACHE: Token<CacheAdapter>;

package/dist/contracts/adapters/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/cache.ts"],"names":[],"mappings":"AAMA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC5C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,YAAY,CAAwB,CAAC"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC5C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,YAAY,CAAwB,CAAC"}

package/dist/contracts/adapters/cache.js

@@ -1,9 +1,11 @@
-// Cache seam. Hot, non-personalized reads (public catalogue/content feeds) load
-// through this adapter so the backend is swappable: the default binding is an
-// in-process TTL cache (zero deps), process-local so invalidation does NOT
-// propagate across replicas. Set REDIS_URL to bind the shipped Redis reference
-// adapter (cross-replica invalidation) with zero consumer code; rebind CACHE via
-// an overlay for any other backend.
+/**
+ * Cache seam. Hot, non-personalized reads (public catalogue/content feeds) load
+ * through this adapter so the backend is swappable: the default binding is an
+ * in-process TTL cache (zero deps), process-local so invalidation does NOT
+ * propagate across replicas. Set REDIS_URL to bind the shipped Redis reference
+ * adapter (cross-replica invalidation) with zero consumer code; rebind CACHE via
+ * an overlay for any other backend.
+ */
 import { createToken } from './token.js';
 export const CACHE = createToken('CACHE');
 //# sourceMappingURL=cache.js.map

package/dist/contracts/adapters/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/contracts/adapters/cache.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,8EAA8E;AAC9E,2EAA2E;AAC3E,+EAA+E;AAC/E,iFAAiF;AACjF,oCAAoC;AACpC,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAQrD,MAAM,CAAC,MAAM,KAAK,GAAwB,WAAW,CAAC,OAAO,CAAC,CAAC"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/contracts/adapters/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AASrD,MAAM,CAAC,MAAM,KAAK,GAAwB,WAAW,CAAC,OAAO,CAAC,CAAC"}

package/dist/contracts/adapters/chat-block-writer.d.ts

@@ -0,0 +1,18 @@
+import { type Token } from './token.js';
+import type { Uuid } from '../schemas/common.js';
+export type ChatBlockWriter = {
+    blockUser(blockerId: Uuid, blockedId: Uuid): Promise<unknown>;
+    ignoreUser(ignorerId: Uuid, ignoredId: Uuid): Promise<unknown>;
+    /**
+     * Union of blocked + ignored ids for a viewer - chat-commands uses this to keep
+     * blocked/ignored players out of player search results.
+     */
+    getExcludedUserIds(viewerId: string): Promise<string[]>;
+    /** Active block relationships only; ignores do not prevent money transfers. */
+    getBlockedUserIds(viewerId: string): Promise<string[]>;
+    /** Checks the relationship on the caller's transaction before a money mutation. */
+    isBlocked(tx: unknown, blockerId: string, blockedId: string): Promise<boolean>;
+};
+export declare function chatBlockLockKey(blockerId: string, blockedId: string): string;
+export declare const CHAT_BLOCK_WRITER: Token<ChatBlockWriter>;
+//# sourceMappingURL=chat-block-writer.d.ts.map

package/dist/contracts/adapters/chat-block-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-block-writer.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/chat-block-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D;;;OAGG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD,+EAA+E;IAC/E,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvD,mFAAmF;IACnF,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChF,CAAC;AAGF,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,eAAe,CAAoC,CAAC"}

package/dist/contracts/adapters/chat-block-writer.js

@@ -0,0 +1,7 @@
+import { createToken } from './token.js';
+// Shared by block mutations and money-transfer authorization checks.
+export function chatBlockLockKey(blockerId, blockedId) {
+    return `chat-block:${blockerId}:${blockedId}`;
+}
+export const CHAT_BLOCK_WRITER = createToken('CHAT_BLOCK_WRITER');
+//# sourceMappingURL=chat-block-writer.js.map

package/dist/contracts/adapters/chat-block-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-block-writer.js","sourceRoot":"","sources":["../../../src/contracts/adapters/chat-block-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAiBrD,qEAAqE;AACrE,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,SAAiB;IACnE,OAAO,cAAc,SAAS,IAAI,SAAS,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAA2B,WAAW,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/contracts/adapters/chat-moderation.d.ts

@@ -0,0 +1,75 @@
+import type { Uuid } from '../schemas/common.js';
+export type ChatModerationEntry = {
+    id: Uuid;
+    userId: Uuid;
+    roomId: Uuid | null;
+    scope: ChatModerationScope;
+    reason: string;
+    createdAt: string;
+    expiresAt: string | null;
+};
+export type ChatPlatformBan = {
+    id: Uuid;
+    userId: Uuid;
+    reason: string;
+    createdAt: string;
+    liftedAt: string | null;
+    bannedUntil: string | null;
+    roomId: Uuid | null;
+    scope: ChatModerationScope;
+};
+export type ChatModerationRoomId = Uuid | '__global' | '__all_public' | '__all';
+export type ChatModerationScope = '__global' | '__all_public' | '__all' | 'room';
+export type ChatModeration = {
+    assertCanSend(userId: Uuid, roomId: Uuid | null, isPublic?: boolean): Promise<void>;
+    deleteMessage(id: Uuid, actorId: Uuid, meta?: {
+        ip: string | null;
+        userAgent: string | null;
+    }, actorType?: 'admin' | 'player'): Promise<{
+        success: true;
+    }>;
+    mute(input: {
+        userId: Uuid;
+        roomId: ChatModerationRoomId;
+        durationSeconds?: number | null;
+        reason: string;
+        actorId: Uuid;
+        ip: string | null;
+        userAgent: string | null;
+    }): Promise<{
+        success: true;
+    }>;
+    unmute(input: {
+        userId: Uuid;
+        roomId: ChatModerationRoomId;
+        actorId: Uuid;
+        ip: string | null;
+        userAgent: string | null;
+    }): Promise<{
+        success: true;
+    }>;
+    listMutes(userId?: Uuid): Promise<ChatModerationEntry[]>;
+    ban(input: {
+        userId: Uuid;
+        roomId: ChatModerationRoomId;
+        durationSeconds: number | null;
+        reason: string;
+        actorId: Uuid;
+        ip: string | null;
+        userAgent: string | null;
+    }): Promise<{
+        success: true;
+    }>;
+    unban(input: {
+        userId: Uuid;
+        roomId: ChatModerationRoomId;
+        actorId: Uuid;
+        ip: string | null;
+        userAgent: string | null;
+    }): Promise<{
+        success: true;
+    }>;
+    listBans(userId?: Uuid): Promise<ChatPlatformBan[]>;
+};
+export declare const CHAT_MODERATION: import("./token.js").Token<ChatModeration, string>;
+//# sourceMappingURL=chat-moderation.d.ts.map

package/dist/contracts/adapters/chat-moderation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-moderation.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/chat-moderation.ts"],"names":[],"mappings":"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"}

package/dist/contracts/adapters/chat-moderation.js

@@ -0,0 +1,3 @@
+import { createToken } from './token.js';
+export const CHAT_MODERATION = createToken('ChatModeration');
+//# sourceMappingURL=chat-moderation.js.map

package/dist/contracts/adapters/chat-moderation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-moderation.js","sourceRoot":"","sources":["../../../src/contracts/adapters/chat-moderation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAuEzC,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAiB,gBAAgB,CAAC,CAAC"}

package/dist/contracts/adapters/chat-room-access.d.ts

@@ -0,0 +1,6 @@
+import { type Token } from './token.js';
+export type ChatRoomAccess = {
+    verifyRoomAccess(roomId: string, viewerId: string): Promise<void>;
+};
+export declare const CHAT_ROOM_ACCESS: Token<ChatRoomAccess>;
+//# sourceMappingURL=chat-room-access.d.ts.map

package/dist/contracts/adapters/chat-room-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-room-access.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/chat-room-access.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG;IAC3B,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,cAAc,CAAmC,CAAC"}

package/dist/contracts/adapters/chat-room-access.js

@@ -0,0 +1,3 @@
+import { createToken } from './token.js';
+export const CHAT_ROOM_ACCESS = createToken('CHAT_ROOM_ACCESS');
+//# sourceMappingURL=chat-room-access.js.map

package/dist/contracts/adapters/chat-room-access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-room-access.js","sourceRoot":"","sources":["../../../src/contracts/adapters/chat-room-access.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAMrD,MAAM,CAAC,MAAM,gBAAgB,GAA0B,WAAW,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/contracts/adapters/chat-system-writer.d.ts

@@ -0,0 +1,19 @@
+import type { SystemChatMessage, CommandChatMessage, CommandMetadata } from '../schemas/chat-command.js';
+export type { SystemChatMessage as ChatSystemMessage };
+export type { CommandChatMessage };
+export type ChatSystemWriter = {
+    postSystemMessage(args: {
+        roomId: string | null;
+        actorId: string;
+        username: string;
+        metadata: CommandMetadata;
+        tx?: unknown;
+    }): Promise<SystemChatMessage>;
+    updateSystemMessage(args: {
+        messageId: string;
+        metadata: CommandMetadata;
+        tx?: unknown;
+    }): Promise<CommandChatMessage>;
+};
+export declare const CHAT_SYSTEM_WRITER: import("./token.js").Token<ChatSystemWriter, string>;
+//# sourceMappingURL=chat-system-writer.d.ts.map

package/dist/contracts/adapters/chat-system-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-system-writer.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/chat-system-writer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EAChB,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iBAAiB,CAAC,IAAI,EAAE;QACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,eAAe,CAAC;QAC1B,EAAE,CAAC,EAAE,OAAO,CAAC;KACd,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC/B,mBAAmB,CAAC,IAAI,EAAE;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,eAAe,CAAC;QAC1B,EAAE,CAAC,EAAE,OAAO,CAAC;KACd,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,kBAAkB,sDAAoD,CAAC"}

package/dist/contracts/adapters/chat-system-writer.js

@@ -0,0 +1,3 @@
+import { createToken } from './token.js';
+export const CHAT_SYSTEM_WRITER = createToken('ChatSystemWriter');
+//# sourceMappingURL=chat-system-writer.js.map

package/dist/contracts/adapters/chat-system-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-system-writer.js","sourceRoot":"","sources":["../../../src/contracts/adapters/chat-system-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAyBzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAmB,kBAAkB,CAAC,CAAC"}

package/dist/contracts/adapters/email-template.d.ts

@@ -0,0 +1,12 @@
+import { type Token } from './token.js';
+import type { MailTemplate } from '../schemas/mail.js';
+export type RenderedEmail = {
+    subject: string;
+    html: string;
+    text: string;
+};
+export type EmailTemplateRenderer = {
+    render(template: MailTemplate, locale: string, recipientName?: string | null): Promise<RenderedEmail> | RenderedEmail;
+};
+export declare const EMAIL_TEMPLATE_RENDERER: Token<EmailTemplateRenderer>;
+//# sourceMappingURL=email-template.d.ts.map

package/dist/contracts/adapters/email-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-template.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/email-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,CACJ,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAC5B,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC;CAC3C,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,KAAK,CAAC,qBAAqB,CACF,CAAC"}

package/dist/contracts/adapters/email-template.js

@@ -0,0 +1,3 @@
+import { createToken } from './token.js';
+export const EMAIL_TEMPLATE_RENDERER = createToken('EMAIL_TEMPLATE_RENDERER');
+//# sourceMappingURL=email-template.js.map

package/dist/contracts/adapters/email-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-template.js","sourceRoot":"","sources":["../../../src/contracts/adapters/email-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAarD,MAAM,CAAC,MAAM,uBAAuB,GAClC,WAAW,CAAwB,yBAAyB,CAAC,CAAC"}

package/dist/contracts/adapters/error-tracking.d.ts

@@ -0,0 +1,12 @@
+import { type Token } from './token.js';
+export type ErrorContext = {
+    userId?: string;
+    traceId?: string;
+    tags?: Record<string, string>;
+    extra?: Record<string, unknown>;
+};
+export type ErrorTrackingAdapter = {
+    captureException(error: unknown, context?: ErrorContext): void;
+};
+export declare const ERROR_TRACKING: Token<ErrorTrackingAdapter>;
+//# sourceMappingURL=error-tracking.d.ts.map

package/dist/contracts/adapters/error-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-tracking.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/error-tracking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CAChE,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,oBAAoB,CACF,CAAC"}

package/dist/contracts/adapters/error-tracking.js

@@ -0,0 +1,3 @@
+import { createToken } from './token.js';
+export const ERROR_TRACKING = createToken('ERROR_TRACKING');
+//# sourceMappingURL=error-tracking.js.map

package/dist/contracts/adapters/error-tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-tracking.js","sourceRoot":"","sources":["../../../src/contracts/adapters/error-tracking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAarD,MAAM,CAAC,MAAM,cAAc,GACzB,WAAW,CAAuB,gBAAgB,CAAC,CAAC"}

package/dist/contracts/adapters/exchange-rate-provider.d.ts

@@ -0,0 +1,14 @@
+import { type Token } from './token.js';
+/** `rate` is a decimal string. `asOf` is the ISO timestamp the vendor attached to the quote, not when it was called. */
+export type ExchangeRateQuote = {
+    rate: string;
+    asOf: string;
+};
+/** Returns `null` when the vendor has no quote for the pair; a thrown error means the call itself failed. */
+export type ExchangeRateProvider = {
+    getRate(from: string, to: string): Promise<ExchangeRateQuote | null>;
+};
+/** Both bindings are optional; an operator who binds neither gets `EXCHANGE_RATE_READER` always resolving `null`. */
+export declare const CRYPTO_EXCHANGE_RATE_PROVIDER: Token<ExchangeRateProvider>;
+export declare const FIAT_EXCHANGE_RATE_PROVIDER: Token<ExchangeRateProvider>;
+//# sourceMappingURL=exchange-rate-provider.d.ts.map

package/dist/contracts/adapters/exchange-rate-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange-rate-provider.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/exchange-rate-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,wHAAwH;AACxH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,6GAA6G;AAC7G,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CACtE,CAAC;AAEF,qHAAqH;AACrH,eAAO,MAAM,6BAA6B,EAAE,KAAK,CAAC,oBAAoB,CAErE,CAAC;AACF,eAAO,MAAM,2BAA2B,EAAE,KAAK,CAAC,oBAAoB,CAEnE,CAAC"}

package/dist/contracts/adapters/exchange-rate-provider.js

@@ -0,0 +1,5 @@
+import { createToken } from './token.js';
+/** Both bindings are optional; an operator who binds neither gets `EXCHANGE_RATE_READER` always resolving `null`. */
+export const CRYPTO_EXCHANGE_RATE_PROVIDER = createToken('CRYPTO_EXCHANGE_RATE_PROVIDER');
+export const FIAT_EXCHANGE_RATE_PROVIDER = createToken('FIAT_EXCHANGE_RATE_PROVIDER');
+//# sourceMappingURL=exchange-rate-provider.js.map

package/dist/contracts/adapters/exchange-rate-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange-rate-provider.js","sourceRoot":"","sources":["../../../src/contracts/adapters/exchange-rate-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAarD,qHAAqH;AACrH,MAAM,CAAC,MAAM,6BAA6B,GAAgC,WAAW,CACnF,+BAA+B,CAChC,CAAC;AACF,MAAM,CAAC,MAAM,2BAA2B,GAAgC,WAAW,CACjF,6BAA6B,CAC9B,CAAC"}

package/dist/contracts/adapters/exchange-rate-reader.d.ts

@@ -0,0 +1,16 @@
+import { type Token } from './token.js';
+import type { ExchangeRateQuote } from './exchange-rate-provider.js';
+/**
+ * Read-through cache: a fresh stored quote answers with no vendor call; a soft-stale one
+ * answers immediately and refreshes in the background; a hard-stale or missing one is
+ * fetched from `CRYPTO_EXCHANGE_RATE_PROVIDER`/`FIAT_EXCHANGE_RATE_PROVIDER` synchronously,
+ * bounded by a timeout, before answering. Fails closed to `null` - never throws, never
+ * blocks past its configured timeout.
+ */
+export type ExchangeRateReader = {
+    getRate(from: string, to: string): Promise<ExchangeRateQuote | null>;
+    /** `amount * rate(from, to)`, or `null` when no rate is available. */
+    convert(amount: string, from: string, to: string): Promise<string | null>;
+};
+export declare const EXCHANGE_RATE_READER: Token<ExchangeRateReader>;
+//# sourceMappingURL=exchange-rate-reader.d.ts.map

package/dist/contracts/adapters/exchange-rate-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange-rate-reader.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/exchange-rate-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACrE,sEAAsE;IACtE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3E,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,kBAAkB,CAAuC,CAAC"}

package/dist/contracts/adapters/exchange-rate-reader.js

@@ -0,0 +1,3 @@
+import { createToken } from './token.js';
+export const EXCHANGE_RATE_READER = createToken('EXCHANGE_RATE_READER');
+//# sourceMappingURL=exchange-rate-reader.js.map

package/dist/contracts/adapters/exchange-rate-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange-rate-reader.js","sourceRoot":"","sources":["../../../src/contracts/adapters/exchange-rate-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAgBrD,MAAM,CAAC,MAAM,oBAAoB,GAA8B,WAAW,CAAC,sBAAsB,CAAC,CAAC"}

package/dist/contracts/adapters/game.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Gaming integration seam. A game studio/RGS implements GameAdapter; bind a
+ * concrete adapter to GAME_ADAPTER in the module's plugin.ts.
+ */
 import { type Token } from './token.js';
 export type GameAdapter = {
     launchGame(gameId: string, userId: string, currency: string): Promise<{

package/dist/contracts/adapters/game.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"game.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/game.ts"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,CACR,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,WAAW,CAA+B,CAAC"}
+{"version":3,"file":"game.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/game.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,CACR,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,WAAW,CAA+B,CAAC"}

package/dist/contracts/adapters/game.js

@@ -1,5 +1,7 @@
-// Gaming integration seam. A game studio/RGS implements GameAdapter; bind a
-// concrete adapter to GAME_ADAPTER in the module's plugin.ts.
+/**
+ * Gaming integration seam. A game studio/RGS implements GameAdapter; bind a
+ * concrete adapter to GAME_ADAPTER in the module's plugin.ts.
+ */
 import { createToken } from './token.js';
 export const GAME_ADAPTER = createToken('GAME_ADAPTER');
 //# sourceMappingURL=game.js.map

package/dist/contracts/adapters/game.js.map

@@ -1 +1 @@
-{"version":3,"file":"game.js","sourceRoot":"","sources":["../../../src/contracts/adapters/game.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8DAA8D;AAC9D,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAWrD,MAAM,CAAC,MAAM,YAAY,GAAuB,WAAW,CAAC,cAAc,CAAC,CAAC"}
+{"version":3,"file":"game.js","sourceRoot":"","sources":["../../../src/contracts/adapters/game.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAWrD,MAAM,CAAC,MAAM,YAAY,GAAuB,WAAW,CAAC,cAAc,CAAC,CAAC"}