@openora/core 0.4.1-canary.16 → 0.4.1-canary.160

package/dist/contracts/adapters/login-enforcement.js

@@ -1,9 +1,11 @@
-// Push port for Responsible-Gambling login enforcement. Owned + bound by the identity
-// module (it owns the `user` table); compliance depends only on this port to block or
-// unblock a player's login, never on the identity schema. `block` also revokes all of
-// the player's active sessions (the RG session-termination requirement). `until: null`
-// means an indefinite block (self-exclusion / permanent); a Date is the cooling-off
-// expiry the login gate auto-clears once elapsed. See ADR-0017.
+/**
+ * Push port for Responsible-Gambling login enforcement. Owned + bound by the identity
+ * module (it owns the `user` table); compliance depends only on this port to block or
+ * unblock a player's login, never on the identity schema. `block` also revokes all of
+ * the player's active sessions (the RG session-termination requirement). `until: null`
+ * means an indefinite block (self-exclusion / permanent); a Date is the cooling-off
+ * expiry the login gate auto-clears once elapsed. See ADR-0017.
+ */
 import { createToken } from './token.js';
 export const LOGIN_ENFORCEMENT = createToken('LOGIN_ENFORCEMENT');
 //# sourceMappingURL=login-enforcement.js.map

package/dist/contracts/adapters/login-enforcement.js.map

@@ -1 +1 @@
-{"version":3,"file":"login-enforcement.js","sourceRoot":"","sources":["../../../src/contracts/adapters/login-enforcement.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,sFAAsF;AACtF,sFAAsF;AACtF,uFAAuF;AACvF,oFAAoF;AACpF,gEAAgE;AAChE,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAOrD,MAAM,CAAC,MAAM,iBAAiB,GAAgC,WAAW,CAAC,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"login-enforcement.js","sourceRoot":"","sources":["../../../src/contracts/adapters/login-enforcement.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAOrD,MAAM,CAAC,MAAM,iBAAiB,GAAgC,WAAW,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/contracts/adapters/mail-recipient-directory.d.ts

@@ -0,0 +1,17 @@
+import type { User } from '../schemas/identity.js';
+import { type Token } from './token.js';
+/**
+ * Mail-only recipient lookup. The anti-phishing code is deliberately available
+ * through no broader directory port: only delivery needs to read it.
+ */
+export type MailRecipient = {
+    email: string;
+    language: string | null;
+    name: string | null;
+    antiPhishingCode: string | null;
+};
+export type MailRecipientDirectory = {
+    getMailRecipient(userId: User['id']): Promise<MailRecipient | null>;
+};
+export declare const MAIL_RECIPIENT_DIRECTORY: Token<MailRecipientDirectory>;
+//# sourceMappingURL=mail-recipient-directory.d.ts.map

package/dist/contracts/adapters/mail-recipient-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-recipient-directory.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/mail-recipient-directory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;CACrE,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,sBAAsB,CAElE,CAAC"}

package/dist/contracts/adapters/mail-recipient-directory.js

@@ -0,0 +1,3 @@
+import { createToken } from './token.js';
+export const MAIL_RECIPIENT_DIRECTORY = createToken('MAIL_RECIPIENT_DIRECTORY');
+//# sourceMappingURL=mail-recipient-directory.js.map

package/dist/contracts/adapters/mail-recipient-directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-recipient-directory.js","sourceRoot":"","sources":["../../../src/contracts/adapters/mail-recipient-directory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAiBrD,MAAM,CAAC,MAAM,wBAAwB,GAAkC,WAAW,CAChF,0BAA0B,CAC3B,CAAC"}

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

@@ -0,0 +1,30 @@
+import { type Token } from './token.js';
+import type { MailTemplate } from '../schemas/mail.js';
+export type EmailMessage = {
+    to: string;
+    subject: string;
+    html: string;
+    text: string;
+};
+export type EmailSenderPort = {
+    send(message: EmailMessage): Promise<void>;
+};
+export type EmailSender = EmailSenderPort;
+export declare const EMAIL_SENDER: Token<EmailSenderPort>;
+export type MailToUserInput = {
+    userId: string;
+    template: MailTemplate;
+    idempotencyKey: string;
+};
+export type MailToAddressInput = {
+    email: string;
+    locale?: string;
+    template: MailTemplate;
+    idempotencyKey: string;
+};
+export type MailDispatchPort = {
+    toUser(input: MailToUserInput): Promise<void>;
+    toAddress(input: MailToAddressInput): Promise<void>;
+};
+export declare const MAIL_DISPATCH: Token<MailDispatchPort>;
+//# sourceMappingURL=mail.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/mail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,eAAe,CAAC;AAE1C,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,eAAe,CAAgD,CAAC;AAEjG,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,gBAAgB,CACF,CAAC"}

package/dist/contracts/adapters/mail.js

@@ -0,0 +1,4 @@
+import { createToken } from './token.js';
+export const EMAIL_SENDER = createToken('EMAIL_SENDER');
+export const MAIL_DISPATCH = createToken('MAIL_DISPATCH');
+//# sourceMappingURL=mail.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mail.js","sourceRoot":"","sources":["../../../src/contracts/adapters/mail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAgBrD,MAAM,CAAC,MAAM,YAAY,GAA2B,WAAW,CAAkB,cAAc,CAAC,CAAC;AAoBjG,MAAM,CAAC,MAAM,aAAa,GACxB,WAAW,CAAmB,eAAe,CAAC,CAAC"}

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

@@ -1,3 +1,17 @@
+/**
+ * Transactional-outbox seam. A money/critical service, INSIDE its db.transaction,
+ * records the event through this port; the row commits atomically with the state
+ * change. A relay then publishes it to the MESSAGE_BROKER after commit, closing
+ * the gap where a crash between "state committed" and "event published" would
+ * otherwise lose the event. This is the primitive that makes cross-service,
+ * at-least-once domain events reliable - and the reason a module can be extracted
+ * to its own process without dropping events. See ADR-0016.
+ *
+ * `tx` is the active transaction handle, typed `unknown` here to keep @openora/core/contracts
+ * ORM-free; the Drizzle implementation in @openora/core/server narrows it. Services never touch
+ * this port directly - they call EventBus.emitInTransaction(tx, ...), which builds
+ * the envelope and delegates here.
+ */
 import { type Token } from './token.js';
 import type { EventEnvelope } from './broker.js';
 export type OutboxWriter = {

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

@@ -1 +1 @@
-{"version":3,"file":"outbox.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/outbox.ts"],"names":[],"mappings":"AAYA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC,YAAY,CAAyB,CAAC"}
+{"version":3,"file":"outbox.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/outbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC,YAAY,CAAyB,CAAC"}

package/dist/contracts/adapters/outbox.js

@@ -1,15 +1,17 @@
-// Transactional-outbox seam. A money/critical service, INSIDE its db.transaction,
-// records the event through this port; the row commits atomically with the state
-// change. A relay then publishes it to the MESSAGE_BROKER after commit, closing
-// the gap where a crash between "state committed" and "event published" would
-// otherwise lose the event. This is the primitive that makes cross-service,
-// at-least-once domain events reliable - and the reason a module can be extracted
-// to its own process without dropping events. See ADR-0016.
-//
-// `tx` is the active transaction handle, typed `unknown` here to keep @openora/core/contracts
-// ORM-free; the Drizzle implementation in @openora/core/server narrows it. Services never touch
-// this port directly - they call EventBus.emitInTransaction(tx, ...), which builds
-// the envelope and delegates here.
+/**
+ * Transactional-outbox seam. A money/critical service, INSIDE its db.transaction,
+ * records the event through this port; the row commits atomically with the state
+ * change. A relay then publishes it to the MESSAGE_BROKER after commit, closing
+ * the gap where a crash between "state committed" and "event published" would
+ * otherwise lose the event. This is the primitive that makes cross-service,
+ * at-least-once domain events reliable - and the reason a module can be extracted
+ * to its own process without dropping events. See ADR-0016.
+ *
+ * `tx` is the active transaction handle, typed `unknown` here to keep @openora/core/contracts
+ * ORM-free; the Drizzle implementation in @openora/core/server narrows it. Services never touch
+ * this port directly - they call EventBus.emitInTransaction(tx, ...), which builds
+ * the envelope and delegates here.
+ */
 import { createToken } from './token.js';
 export const OUTBOX = createToken('OUTBOX');
 //# sourceMappingURL=outbox.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"outbox.js","sourceRoot":"","sources":["../../../src/contracts/adapters/outbox.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,iFAAiF;AACjF,gFAAgF;AAChF,8EAA8E;AAC9E,4EAA4E;AAC5E,kFAAkF;AAClF,4DAA4D;AAC5D,EAAE;AACF,8FAA8F;AAC9F,gGAAgG;AAChG,mFAAmF;AACnF,mCAAmC;AACnC,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAOrD,MAAM,CAAC,MAAM,MAAM,GAAwB,WAAW,CAAC,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"outbox.js","sourceRoot":"","sources":["../../../src/contracts/adapters/outbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAOrD,MAAM,CAAC,MAAM,MAAM,GAAwB,WAAW,CAAC,QAAQ,CAAC,CAAC"}

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

@@ -1,3 +1,8 @@
+/**
+ * Payment seam. A PSP (card/bank/e-wallet) or a custody/address-issuing crypto vendor
+ * implements PaymentAdapter; bind a concrete adapter to PAYMENT_ADAPTER in the wallet
+ * module's plugin.ts. See docs/adapters/payment.md for the full binding guide.
+ */
 import { type Token } from './token.js';
 /**
  * Normalized shape of an inbound payment-vendor webhook, produced by a
@@ -6,10 +11,17 @@ import { type Token } from './token.js';
  * event reports a status transition for a withdrawal already sent to the vendor via
  * `processWithdrawal`. `externalId` is the vendor's reference id for the underlying
  * settlement - the dedup key the wallet module reconciles against.
+ *
+ * A deposit carries `network` because an address does not identify a chain: an EVM vault
+ * hands out one address that is shared across every EVM chain AND every token on them, so
+ * `address` alone maps to many issued rows. Omitting it falls back to address-only lookup,
+ * which is safe only for a vendor that issues a distinct address per currency.
  */
 export type PaymentWebhookEvent = {
     kind: 'deposit';
     address: string;
+    network?: string;
+    tag?: string;
     amount: string;
     currency: string;
     txHash: string;
@@ -20,6 +32,46 @@ export type PaymentWebhookEvent = {
     status: 'processing' | 'completed' | 'failed';
     txHash?: string;
 };
+/**
+ * A balance sitting in a per-player custody container that is not yet in the pooled
+ * account withdrawals are paid from. Produced by `PaymentAdapter.listSweepableBalances`
+ * and handed back to `sweepToPool` unchanged.
+ */
+export type CustodyBalance = {
+    userId: string;
+    currency: string;
+    network: string;
+    amount: string;
+    /** Current network cost to move it, same units as `amount`. */
+    estimatedFee: string;
+};
+/**
+ * Name of the single default `PaymentAdapter`/`PaymentWebhookVerifier` binding, wrapped
+ * as one `PaymentProviderRegistry` entry so an operator with one vendor changes nothing.
+ */
+export declare const DEFAULT_PAYMENT_PROVIDER = "default";
+/** One named vendor binding: the adapter it settles through and the verifier for its webhooks. */
+export type PaymentProvider = {
+    adapter: PaymentAdapter;
+    webhookVerifier: PaymentWebhookVerifier;
+};
+/**
+ * Looks up a named vendor's adapter/verifier pair. `wallet_asset.providerName` is the
+ * key; a webhook route resolves both the verifier AND the adapter from the SAME entry so
+ * a request can never be verified against one vendor's key and parsed by another's
+ * format (signature confusion).
+ *
+ * Core only looks a name up here - it never discovers or enumerates vendors itself. The
+ * operator composes this map in their own plugin because `Container.register` is
+ * last-wins: two overlays each binding the single `PAYMENT_ADAPTER`/`PAYMENT_WEBHOOK_VERIFIER`
+ * tokens would clobber each other, so running a fiat PSP and a crypto custodian at once
+ * needs an operator-owned map from provider name to pair, not a second core-discovered
+ * binding slot.
+ */
+export type PaymentProviderRegistry = {
+    get(providerName: string): PaymentProvider | null;
+    names(): readonly string[];
+};
 export type PaymentAdapter = {
     processDeposit(amount: string, currency: string, metadata: Record<string, unknown>): Promise<{
         externalId: string;
@@ -42,11 +94,37 @@ export type PaymentAdapter = {
      * Issue (or return) a deposit address for this user/asset. Only implemented by
      * address-based deposit vendors (eg a custody/MPC crypto rail) - a synchronous PSP
      * or `MockPaymentAdapter` omits it. The wallet module persists the returned address
-     * so re-requesting the same (userId, currency) is idempotent without a second
+     * so re-requesting the same (userId, currency, network) is idempotent without a second
      * vendor call.
      */
-    issueDepositAddress?(userId: string, currency: string): Promise<{
+    issueDepositAddress?(userId: string, currency: string, network?: string): Promise<{
         address: string;
+        tag?: string;
+    }>;
+    /**
+     * Register a player's payout address with the vendor and return the id a withdrawal names as
+     * its destination. Implemented by a custody vendor that requires destinations to be approved
+     * before funds can reach them; a synchronous PSP, which pays to an address it is handed,
+     * omits it and the wallet module stores no provider id.
+     *
+     * Called on the address-book write path rather than at payout time on purpose: approval can
+     * need a human quorum, which must not sit inside a withdrawal that is already holding a
+     * player's funds. Implementations must be idempotent on
+     * (userId, currency, network, address, destinationTag) - a retried registration has to return
+     * the original id instead of creating a second destination that then needs its own approval.
+     *
+     * `destinationTag` is part of the destination, not a detail of it: on a tag/memo chain one
+     * address serves many accounts and the tag picks which, so two tags on the same address are
+     * two different beneficiaries and must whitelist as two different destinations.
+     */
+    whitelistWithdrawalAddress?(input: {
+        userId: string;
+        currency: string;
+        network: string;
+        address: string;
+        destinationTag?: string;
+    }): Promise<{
+        providerWalletId: string;
     }>;
     /**
      * Vendor-specific normalization of a raw webhook into a reconcilable event, or
@@ -54,6 +132,65 @@ export type PaymentAdapter = {
      * `MockPaymentAdapter` omits it; an address-based/async vendor overlay implements it.
      */
     parseWebhook?(rawBody: string, headers: Record<string, string | string[] | undefined>): PaymentWebhookEvent | null;
+    /**
+     * Whether this adapter can actually serve the given asset. The asset catalog is
+     * operator-editable at runtime, so an admin can name a (currency, network) pair the
+     * bound vendor has never heard of; the catalog's write path calls this first and
+     * rejects rather than letting the pair reach a player's deposit screen. Optional -
+     * an adapter that omits it is assumed to accept anything the operator configures.
+     */
+    supportsAsset?(currency: string, network: string): boolean;
+    /**
+     * Per-player balances the vendor holds that are not yet in the pooled account.
+     * Only meaningful for a custody vendor whose per-player deposit containers are
+     * distinct from the account withdrawals are paid out of - a synchronous PSP, which
+     * never holds a per-player balance, omits it.
+     */
+    listSweepableBalances?(): Promise<CustodyBalance[]>;
+    /**
+     * Move one player's balance into the pooled account. Implemented alongside
+     * `listSweepableBalances`; the caller owns the policy (dust floor, fee thresholds)
+     * and this only performs the transfer it is handed.
+     *
+     * `idempotencyKey` exists because a thrown call cannot be distinguished from a lost
+     * response - the vendor must dedupe the retry on this key rather than double-move
+     * funds. `poolRef` is an opaque vendor-side identifier for the destination pool,
+     * recorded so the ledger can evidence that player funds landed in the player pool and
+     * not an operator account - a regulator asks this.
+     */
+    sweepToPool?(balance: CustodyBalance, opts: {
+        idempotencyKey: string;
+        treasuryRef?: string;
+    }): Promise<{
+        externalId: string;
+        poolRef?: string;
+    }>;
+    /**
+     * Balance currently in the pooled account for this asset. Consulted only when a sweep
+     * is blocked by the fee ceiling, to decide whether paying a high fee beats running the
+     * pool dry. Omit it and the ceiling is absolute.
+     */
+    getPoolBalance?(currency: string, network: string): Promise<string>;
+    /**
+     * Vendor transactions in a window, normalized into the same events `parseWebhook`
+     * produces - reconciliation is that same normalization, polled instead of pushed.
+     * Implemented by a vendor whose ledger can be listed after the fact; a PSP that only
+     * pushes webhooks omits it.
+     */
+    listTransactions?(range: {
+        since: Date;
+        until: Date;
+    }): Promise<PaymentWebhookEvent[]>;
+    /**
+     * Targeted status lookup for a single withdrawal, or null when the vendor has no
+     * record of it. Not redundant with `listTransactions`: a withdrawal stuck in
+     * `processing` for days falls outside any sane reconciliation window, so finalizing
+     * it needs a direct lookup by `externalId`.
+     */
+    getWithdrawalStatus?(externalId: string): Promise<{
+        status: 'processing' | 'completed' | 'failed';
+        txHash?: string;
+    } | null>;
 };
 export declare const PAYMENT_ADAPTER: Token<PaymentAdapter>;
 /**
@@ -64,7 +201,8 @@ export declare const PAYMENT_ADAPTER: Token<PaymentAdapter>;
  * absent, or the raw body was not captured.
  */
 export type PaymentWebhookVerifier = {
-    verify(rawBody: string, headers: Record<string, string | string[] | undefined>): boolean;
+    verify(rawBody: string, headers: Record<string, string | string[] | undefined>): boolean | Promise<boolean>;
 };
 export declare const PAYMENT_WEBHOOK_VERIFIER: Token<PaymentWebhookVerifier>;
+export declare const PAYMENT_PROVIDERS: Token<PaymentProviderRegistry>;
 //# sourceMappingURL=payment.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/payment.ts"],"names":[],"mappings":"AAGA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,CACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEnD;;;;;;;;OAQG;IACH,iBAAiB,CACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEnD;;;;;;OAMG;IACH,mBAAmB,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAErF;;;;OAIG;IACH,YAAY,CAAC,CACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,mBAAmB,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,cAAc,CAAkC,CAAC;AAErF;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC;CAC1F,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,sBAAsB,CAElE,CAAC"}
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/payment.ts"],"names":[],"mappings":"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"}

package/dist/contracts/adapters/payment.js

@@ -1,7 +1,15 @@
-// Payment seam. A PSP (card/bank/e-wallet) or a custody/address-issuing crypto vendor
-// implements PaymentAdapter; bind a concrete adapter to PAYMENT_ADAPTER in the wallet
-// module's plugin.ts. See docs/adapters/payment.md for the full binding guide.
+/**
+ * Payment seam. A PSP (card/bank/e-wallet) or a custody/address-issuing crypto vendor
+ * implements PaymentAdapter; bind a concrete adapter to PAYMENT_ADAPTER in the wallet
+ * module's plugin.ts. See docs/adapters/payment.md for the full binding guide.
+ */
 import { createToken } from './token.js';
+/**
+ * Name of the single default `PaymentAdapter`/`PaymentWebhookVerifier` binding, wrapped
+ * as one `PaymentProviderRegistry` entry so an operator with one vendor changes nothing.
+ */
+export const DEFAULT_PAYMENT_PROVIDER = 'default';
 export const PAYMENT_ADAPTER = createToken('PAYMENT_ADAPTER');
 export const PAYMENT_WEBHOOK_VERIFIER = createToken('PAYMENT_WEBHOOK_VERIFIER');
+export const PAYMENT_PROVIDERS = createToken('PAYMENT_PROVIDERS');
 //# sourceMappingURL=payment.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../../src/contracts/adapters/payment.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,sFAAsF;AACtF,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAoErD,MAAM,CAAC,MAAM,eAAe,GAA0B,WAAW,CAAC,iBAAiB,CAAC,CAAC;AAarF,MAAM,CAAC,MAAM,wBAAwB,GAAkC,WAAW,CAChF,0BAA0B,CAC3B,CAAC"}
+{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../../src/contracts/adapters/payment.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AA+CrD;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAAC;AA2JlD,MAAM,CAAC,MAAM,eAAe,GAA0B,WAAW,CAAC,iBAAiB,CAAC,CAAC;AAgBrF,MAAM,CAAC,MAAM,wBAAwB,GAAkC,WAAW,CAChF,0BAA0B,CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAmC,WAAW,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/contracts/adapters/play-eligibility.d.ts

@@ -0,0 +1,15 @@
+import { type Token } from './token.js';
+/**
+ * Read port for Responsible-Gambling play enforcement. Owned + bound by the identity
+ * module (it owns the `user` table and the `rgBlocked`/`rgBlockedUntil` projection that
+ * `LOGIN_ENFORCEMENT` writes). Gaming and wallet depend only on this port to refuse a
+ * wager, never on the identity schema.
+ *
+ * A cooling-off whose `rgBlockedUntil` has elapsed reports `false` without waiting for
+ * the expiry sweep, matching the login gate's lazy-expiry behaviour.
+ */
+export type PlayEligibilityPort = {
+    isRestricted(userId: string): Promise<boolean>;
+};
+export declare const PLAY_ELIGIBILITY: Token<PlayEligibilityPort>;
+//# sourceMappingURL=play-eligibility.d.ts.map

package/dist/contracts/adapters/play-eligibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"play-eligibility.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/play-eligibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,mBAAmB,CACF,CAAC"}

package/dist/contracts/adapters/play-eligibility.js

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

package/dist/contracts/adapters/play-eligibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"play-eligibility.js","sourceRoot":"","sources":["../../../src/contracts/adapters/play-eligibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAerD,MAAM,CAAC,MAAM,gBAAgB,GAC3B,WAAW,CAAsB,kBAAkB,CAAC,CAAC"}

package/dist/contracts/adapters/player-activity.d.ts

@@ -0,0 +1,6 @@
+import { type Token } from './token.js';
+export type PlayerActivityTracker = {
+    touchLastSeen(userId: string): Promise<void>;
+};
+export declare const PLAYER_ACTIVITY_TRACKER: Token<PlayerActivityTracker>;
+//# sourceMappingURL=player-activity.d.ts.map

package/dist/contracts/adapters/player-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"player-activity.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/player-activity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,qBAAqB,GAAG;IAClC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,KAAK,CAAC,qBAAqB,CACzB,CAAC"}

package/dist/contracts/adapters/player-activity.js

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

package/dist/contracts/adapters/player-activity.js.map

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

package/dist/contracts/adapters/player-provisioning.d.ts

@@ -0,0 +1,29 @@
+import { type Token } from './token.js';
+export type PlayerProvisioning = {
+    /**
+     * `created: false` means a player row already existed, so this consent record was
+     * NOT stored. Callers must surface that - it is a compliance record, not a no-op.
+     */
+    createForRegistration(record: PlayerRegistrationRecord): Promise<{
+        created: boolean;
+        playerId?: string;
+    }>;
+    /**
+     * Stores the IANA zone a browser reported. Display metadata - it never gates anything and
+     * never reaches an RG window or an audit record. Best-effort by contract: an unrecognised
+     * zone, or a player with no row yet, is a silent no-op. Call only after authentication.
+     * Optional: an operator's own provisioning adapter predating this method still satisfies
+     * the port, and a caller that skips the write costs the player nothing.
+     */
+    recordTimezone?(userId: string, timezone: string): Promise<void>;
+};
+export type PlayerRegistrationRecord = {
+    userId: string;
+    termsVersion: string;
+    termsAcceptedAt: Date;
+    ageAcceptedAt: Date;
+    registrationIp: string | null;
+    registrationUserAgent: string | null;
+};
+export declare const PLAYER_PROVISIONING: Token<PlayerProvisioning>;
+//# sourceMappingURL=player-provisioning.d.ts.map

package/dist/contracts/adapters/player-provisioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"player-provisioning.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/player-provisioning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;OAGG;IACH,qBAAqB,CACnB,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEpD;;;;;;OAMG;IACH,cAAc,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,IAAI,CAAC;IACtB,aAAa,EAAE,IAAI,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,kBAAkB,CAAsC,CAAC"}

package/dist/contracts/adapters/player-provisioning.js

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

package/dist/contracts/adapters/player-provisioning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"player-provisioning.js","sourceRoot":"","sources":["../../../src/contracts/adapters/player-provisioning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AA8BrD,MAAM,CAAC,MAAM,mBAAmB,GAA8B,WAAW,CAAC,qBAAqB,CAAC,CAAC"}

package/dist/contracts/adapters/player-tags.d.ts

@@ -1,5 +1,9 @@
 import { type Token } from './token.js';
 import type { TagKey } from '../schemas/tag.js';
+/**
+ * Read-only seam letting the wallet auto-withdrawal evaluator query a player's tags
+ * without importing the tag module's schema (module isolation). Absent from the map == no active tags.
+ */
 export type PlayerTags = {
     getActiveTagKeys(userIds: readonly string[]): Promise<Map<string, TagKey[]>>;
 };

package/dist/contracts/adapters/player-tags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"player-tags.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/player-tags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAIhD,MAAM,MAAM,UAAU,GAAG;IACvB,gBAAgB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;CAC9E,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,UAAU,CAA8B,CAAC"}
+{"version":3,"file":"player-tags.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/player-tags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,gBAAgB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;CAC9E,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,UAAU,CAA8B,CAAC"}

package/dist/contracts/adapters/player-tags.js.map

@@ -1 +1 @@
-{"version":3,"file":"player-tags.js","sourceRoot":"","sources":["../../../src/contracts/adapters/player-tags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AASrD,MAAM,CAAC,MAAM,WAAW,GAAsB,WAAW,CAAC,aAAa,CAAC,CAAC"}
+{"version":3,"file":"player-tags.js","sourceRoot":"","sources":["../../../src/contracts/adapters/player-tags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAWrD,MAAM,CAAC,MAAM,WAAW,GAAsB,WAAW,CAAC,aAAa,CAAC,CAAC"}

package/dist/contracts/adapters/rate-limit.d.ts

@@ -1,15 +1,55 @@
+/**
+ * Rate-limiter seam. Abuse-prone routes (auth flows, money mutations) consume
+ * from this adapter so the throttling backend is swappable: the default binding
+ * is an in-process fixed-window limiter (zero deps - good for `pnpm dev`, seed
+ * and tests), process-local so it does NOT coordinate across replicas. Set
+ * REDIS_URL to bind the shipped Redis reference adapter (distributed fixed-window)
+ * with zero consumer code; rebind RATE_LIMITER via an overlay for any other backend.
+ */
 import { type Token } from './token.js';
+export declare const RATE_LIMIT_KEYS: {
+    readonly REGISTER: "register";
+    readonly LOGIN: "login";
+    readonly ENABLE_2FA: "enable2fa";
+    readonly VERIFY_2FA: "verify2fa";
+    readonly DISABLE_2FA: "disable2fa";
+    readonly PASSWORD_RESET_REQUEST: "pwreset-req";
+    readonly PASSWORD_RESET_VERIFY: "pwreset-verify";
+    readonly PASSWORD_RESET: "pwreset";
+    readonly CHANGE_PASSWORD: "change-password";
+    readonly WITHDRAWAL_PIN_MUTATION: "withdrawal-pin-mutation";
+    readonly ANTI_PHISHING_CODE_MUTATION: "anti-phishing-code-mutation";
+    readonly EMAIL_VERIFICATION: "email-verify";
+    readonly VERIFY_EMAIL: "verify-email";
+    readonly WALLET_MUTATION: "wallet-mutation";
+    readonly WALLET_WEBHOOK: "wallet-webhook";
+    readonly CHAT_ROOM_JOIN: "chat-room-join";
+    readonly CHAT_SEND: "chat-send";
+    readonly REPORT_ACCESS_DENIED: "report-access-denied";
+};
+export type RateLimitKeyPrefix = (typeof RATE_LIMIT_KEYS)[keyof typeof RATE_LIMIT_KEYS];
+export type RateLimitKey = `${RateLimitKeyPrefix}:${string}`;
+export declare function makeRateLimitKey(prefix: RateLimitKeyPrefix, id: string): RateLimitKey;
 export type RateLimitOptions = {
+    /** Max allowed consumptions per window per key. */
     limit: number;
     windowMs: number;
+    /**
+     * What to do when the backing store is unreachable: 'allow' keeps availability
+     * (throttling pauses during an outage); 'deny' fails closed for keys where an
+     * unthrottled window is worse than a 429 (credential guessing). Default 'allow'.
+     * The in-process default is never unavailable, so it ignores this.
+     */
     onUnavailable?: 'allow' | 'deny';
 };
 export type RateLimitResult = {
     allowed: boolean;
+    /** Milliseconds until the window resets. 0 when allowed. */
     retryAfterMs: number;
 };
-export type RateLimiterAdapter = {
-    consume(key: string, opts: RateLimitOptions): Promise<RateLimitResult>;
+export type RateLimiterAdapter<Key extends string = string> = {
+    consume(key: Key, opts: RateLimitOptions): Promise<RateLimitResult>;
+    reset(key: Key): Promise<void>;
 };
-export declare const RATE_LIMITER: Token<RateLimiterAdapter>;
+export declare const RATE_LIMITER: Token<RateLimiterAdapter<RateLimitKey>>;
 //# sourceMappingURL=rate-limit.d.ts.map

package/dist/contracts/adapters/rate-limit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/rate-limit.ts"],"names":[],"mappings":"AAMA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,gBAAgB,GAAG;IAE7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IAKjB,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,OAAO,CAAC;IAEjB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACxE,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,kBAAkB,CAA+B,CAAC"}
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/rate-limit.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;CAmBlB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAExF,MAAM,MAAM,YAAY,GAAG,GAAG,kBAAkB,IAAI,MAAM,EAAE,CAAC;AAE7D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM,GAAG,YAAY,CAErF;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,IAAI;IAC5D,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACpE,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAA+B,CAAC"}