@openora/core 0.4.1-canary.18 → 0.4.1-canary.181

package/dist/contracts/adapters/kyc.js

@@ -5,7 +5,30 @@
  * Load your overlay AFTER the identity plugin in extensions.config.ts (last registration wins).
  * See docs/adapters/kyc.md for the full binding guide.
  */
+import * as z from 'zod';
 import { createToken } from './token.js';
+export const KYC_VENDOR_STATUSES = ['pending', 'approved', 'rejected', 'not_started'];
+/**
+ * Vendor-neutral outcome of a single workflow step (eg an ID check, a liveness check,
+ * an AML screen). `approved` is the only terminal-successful value; every other value
+ * (including `unknown`, used when a vendor reports a step status this platform does
+ * not recognize) means the step has not reached a successful state.
+ */
+export const KYC_CHECK_STATUSES = [
+    'not_started',
+    'in_progress',
+    'in_review',
+    'approved',
+    'declined',
+    'expired',
+    'unknown',
+];
+export const KycCheckStatusSchema = z.enum(KYC_CHECK_STATUSES);
+/** One workflow step's outcome. `step` is a free-form, vendor-supplied label (eg Didit's `ID_VERIFICATION`). */
+export const KycCheckResultSchema = z.object({
+    step: z.string(),
+    status: KycCheckStatusSchema,
+});
 export const KYC_ADAPTER = createToken('KYC_ADAPTER');
 export const KYC_STATUS_WRITER = createToken('KYC_STATUS_WRITER');
 export const KYC_WEBHOOK_VERIFIER = createToken('KYC_WEBHOOK_VERIFIER');

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

@@ -1 +1 @@
-{"version":3,"file":"kyc.js","sourceRoot":"","sources":["../../../src/contracts/adapters/kyc.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AA4CrD,MAAM,CAAC,MAAM,WAAW,GAAsB,WAAW,CAAC,aAAa,CAAC,CAAC;AAuBzE,MAAM,CAAC,MAAM,iBAAiB,GAA2B,WAAW,CAAC,mBAAmB,CAAC,CAAC;AAe1F,MAAM,CAAC,MAAM,oBAAoB,GAA8B,WAAW,CAAC,sBAAsB,CAAC,CAAC"}
+{"version":3,"file":"kyc.js","sourceRoot":"","sources":["../../../src/contracts/adapters/kyc.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AASrD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,CAAU,CAAC;AAG/F;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,aAAa;IACb,aAAa;IACb,WAAW;IACX,UAAU;IACV,UAAU;IACV,SAAS;IACT,SAAS;CACD,CAAC;AACX,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;AAG/D,gHAAgH;AAChH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,oBAAoB;CAC7B,CAAC,CAAC;AA6FH,MAAM,CAAC,MAAM,WAAW,GAAsB,WAAW,CAAC,aAAa,CAAC,CAAC;AA6BzE,MAAM,CAAC,MAAM,iBAAiB,GAA2B,WAAW,CAAC,mBAAmB,CAAC,CAAC;AAsB1F,MAAM,CAAC,MAAM,oBAAoB,GAA8B,WAAW,CAAC,sBAAsB,CAAC,CAAC"}

package/dist/contracts/adapters/lobby-section-catalog.d.ts

@@ -0,0 +1,39 @@
+import { type LobbySectionConfig, type LobbySectionData, type LobbySectionType } from '../schemas/lobby.js';
+import { type Token } from './token.js';
+export type LobbySectionDefinitionInput = {
+    id: string;
+    config: LobbySectionConfig;
+};
+export type LobbySectionValidationResult = {
+    valid: true;
+} | {
+    valid: false;
+    message: string;
+};
+export type LobbySectionDefinition = {
+    type: LobbySectionType;
+    parseConfig(config: LobbySectionConfig): LobbySectionConfig;
+    validate?(sections: LobbySectionDefinitionInput[]): Promise<LobbySectionValidationResult>;
+    resolve(sections: LobbySectionDefinitionInput[]): Promise<Map<string, LobbySectionData>>;
+};
+export type LobbySectionCatalog = {
+    get(type: string): LobbySectionDefinition | undefined;
+    list(): LobbySectionDefinition[];
+};
+export declare function defineLobbySection<const Type extends string, Config extends LobbySectionConfig, Data extends LobbySectionData>(definition: {
+    type: Type;
+    configSchema: {
+        parse(input: unknown): Config;
+    };
+    validate?(sections: Array<{
+        id: string;
+        config: Config;
+    }>): Promise<LobbySectionValidationResult>;
+    resolve(sections: Array<{
+        id: string;
+        config: Config;
+    }>): Promise<Map<string, Data>>;
+}): LobbySectionDefinition;
+export declare function createLobbySectionCatalog(definitions: readonly LobbySectionDefinition[]): LobbySectionCatalog;
+export declare const LOBBY_SECTION_CATALOG: Token<LobbySectionCatalog>;
+//# sourceMappingURL=lobby-section-catalog.d.ts.map

package/dist/contracts/adapters/lobby-section-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lobby-section-catalog.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/lobby-section-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,2BAA2B,GAAG;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,kBAAkB,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/F,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,gBAAgB,CAAC;IACvB,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAAC;IAC5D,QAAQ,CAAC,CAAC,QAAQ,EAAE,2BAA2B,EAAE,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC1F,OAAO,CAAC,QAAQ,EAAE,2BAA2B,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;CAC1F,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAAC;IACtD,IAAI,IAAI,sBAAsB,EAAE,CAAC;CAClC,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,MAAM,SAAS,kBAAkB,EACjC,IAAI,SAAS,gBAAgB,EAC7B,UAAU,EAAE;IACZ,IAAI,EAAE,IAAI,CAAC;IACX,YAAY,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAA;KAAE,CAAC;IAChD,QAAQ,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAClG,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;CACtF,GAAG,sBAAsB,CAgBzB;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,SAAS,sBAAsB,EAAE,GAC7C,mBAAmB,CAarB;AAED,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,mBAAmB,CACF,CAAC"}

package/dist/contracts/adapters/lobby-section-catalog.js

@@ -0,0 +1,34 @@
+import { LobbySectionTypeSchema, } from '../schemas/lobby.js';
+import { createToken } from './token.js';
+export function defineLobbySection(definition) {
+    const validate = definition.validate;
+    const parseSections = (sections) => sections.map((section) => ({
+        id: section.id,
+        config: definition.configSchema.parse(section.config),
+    }));
+    return {
+        type: LobbySectionTypeSchema.parse(definition.type),
+        parseConfig: (config) => definition.configSchema.parse(config),
+        validate: validate ? (sections) => validate(parseSections(sections)) : undefined,
+        async resolve(sections) {
+            const resolved = await definition.resolve(parseSections(sections));
+            return new Map(resolved);
+        },
+    };
+}
+export function createLobbySectionCatalog(definitions) {
+    const byType = new Map();
+    for (const definition of definitions) {
+        const type = LobbySectionTypeSchema.parse(definition.type);
+        if (byType.has(type)) {
+            throw new Error(`Duplicate lobby section definition: ${type}`);
+        }
+        byType.set(type, definition);
+    }
+    return {
+        get: (type) => byType.get(type),
+        list: () => [...byType.values()],
+    };
+}
+export const LOBBY_SECTION_CATALOG = createToken('LOBBY_SECTION_CATALOG');
+//# sourceMappingURL=lobby-section-catalog.js.map

package/dist/contracts/adapters/lobby-section-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lobby-section-catalog.js","sourceRoot":"","sources":["../../../src/contracts/adapters/lobby-section-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,GAIvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAqBrD,MAAM,UAAU,kBAAkB,CAIhC,UAKD;IACC,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;IACrC,MAAM,aAAa,GAAG,CAAC,QAAuC,EAAE,EAAE,CAChE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACzB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,MAAM,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;KACtD,CAAC,CAAC,CAAC;IACN,OAAO;QACL,IAAI,EAAE,sBAAsB,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QACnD,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC;QAC9D,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QAChF,KAAK,CAAC,OAAO,CAAC,QAAQ;YACpB,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;YACnE,OAAO,IAAI,GAAG,CAA2B,QAAQ,CAAC,CAAC;QACrD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,WAA8C;IAE9C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkC,CAAC;IACzD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,sBAAsB,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC3D,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO;QACL,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QAC/B,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAChC,WAAW,CAAsB,uBAAuB,CAAC,CAAC"}

package/dist/contracts/adapters/login-enforcement.d.ts

@@ -1,3 +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.
+ */
 import { type Token } from './token.js';
 export type LoginEnforcementPort = {
     block(userId: string, opts: {

package/dist/contracts/adapters/login-enforcement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"login-enforcement.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/login-enforcement.ts"],"names":[],"mappings":"AAMA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,IAAI,GAAG,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,oBAAoB,CAAoC,CAAC"}
+{"version":3,"file":"login-enforcement.d.ts","sourceRoot":"","sources":["../../../src/contracts/adapters/login-enforcement.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,IAAI,GAAG,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,oBAAoB,CAAoC,CAAC"}

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,32 @@
+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;
+    antiPhishingCode?: string | null;
+    recipientName?: string | null;
+    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,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,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;AAsBjG,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,58 @@ export type PaymentWebhookEvent = {
     status: 'processing' | 'completed' | 'failed';
     txHash?: string;
 };
+/**
+ * Thrown by `PaymentAdapter.processWithdrawal` when the vendor definitely did not accept
+ * the payout - refused before sending, or rejected with a validation error. It is the only
+ * failure the wallet refunds on the spot.
+ *
+ * Any other throw (timeout, network error, 5xx) cannot be told apart from a lost response
+ * to a payout the vendor accepted and will broadcast, so the wallet holds the withdrawal
+ * in `processing` and leaves it to reconciliation instead of refunding into a double payout.
+ */
+export declare class PaymentRejectedError extends Error {
+    constructor(message: 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 +106,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 +144,77 @@ 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>;
+    /**
+     * Find a withdrawal by our own transaction id (the `transactionId` handed to
+     * `processWithdrawal`), or null when the vendor has no record of it. This is how a payout
+     * whose response was lost gets its vendor reference back: reconciliation calls it for a
+     * `processing` withdrawal that never stored a `providerRefId`. Implemented by a vendor that
+     * keeps the caller's reference on the transaction.
+     */
+    findWithdrawalByReference?(transactionId: string): Promise<{
+        externalId: string;
+        status: 'processing' | 'completed' | 'failed';
+        txHash?: string;
+    } | null>;
 };
 export declare const PAYMENT_ADAPTER: Token<PaymentAdapter>;
 /**
@@ -64,7 +225,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,30 @@
-// 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';
+/**
+ * Thrown by `PaymentAdapter.processWithdrawal` when the vendor definitely did not accept
+ * the payout - refused before sending, or rejected with a validation error. It is the only
+ * failure the wallet refunds on the spot.
+ *
+ * Any other throw (timeout, network error, 5xx) cannot be told apart from a lost response
+ * to a payout the vendor accepted and will broadcast, so the wallet holds the withdrawal
+ * in `processing` and leaves it to reconciliation instead of refunding into a double payout.
+ */
+export class PaymentRejectedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PaymentRejectedError';
+    }
+}
+/**
+ * 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;AAiCrD;;;;;;;;GAQG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAgBD;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAAC;AAwKlD,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"}