@moneypot/hub 1.19.16 → 1.20.0-dev.1

package/dist/src/liability/public/db.js

@@ -0,0 +1,53 @@
+import { exactlyOneRow } from "../../db/util.js";
+export async function dbCreateLiability(pgClient, { lockedBankrollId, casinoId, experienceId, userId, currencyKey, refId, refType, maxPayout, deadline, }) {
+    const row = await pgClient
+        .query({
+        text: `
+        WITH inserted AS (
+          INSERT INTO hub.liability (bankroll_id, casino_id, experience_id, user_id, currency_key, ref_id, ref_type, max_payout, deadline)
+          VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9)
+          RETURNING *
+        ),
+        bankroll_update AS (
+          UPDATE hub.bankroll
+          SET liability = liability + $8
+          WHERE id = $1
+        )
+        SELECT * FROM inserted
+        `,
+        values: [
+            lockedBankrollId,
+            casinoId,
+            experienceId,
+            userId,
+            currencyKey,
+            refId,
+            refType,
+            maxPayout,
+            deadline,
+        ],
+    })
+        .then(exactlyOneRow);
+    return row;
+}
+export async function dbResolveLiabilityByRef(pgClient, { refType, refId, lockedBankrollId, }) {
+    const _proofOfGoodBehavior = lockedBankrollId;
+    const result = await pgClient.query({
+        text: `
+      WITH resolved AS (
+        UPDATE hub.liability
+        SET resolved_at = now()
+        WHERE ref_type = $1
+          AND ref_id = $2
+          AND resolved_at IS NULL
+        RETURNING bankroll_id, max_payout
+      )
+      UPDATE hub.bankroll
+      SET liability = liability - resolved.max_payout
+      FROM resolved
+      WHERE hub.bankroll.id = resolved.bankroll_id
+    `,
+        values: [refType, refId],
+    });
+    return result.rowCount === 1;
+}

package/dist/src/liability/public/index.d.ts

@@ -0,0 +1,2 @@
+export type { DbLiability, NewLiability } from "../types.js";
+export { type LiabilityConfig, type LiabilityRefTypeConfig as LiabilityHandler, type LiabilityResolved, type DbLockedLiability, LIABILITY_RESOLVED, createLiabilityConfig, } from "./config.js";

package/dist/src/liability/public/index.js

@@ -0,0 +1 @@
+export { LIABILITY_RESOLVED, createLiabilityConfig, } from "./config.js";

package/dist/src/liability/types.d.ts

@@ -0,0 +1,24 @@
+export type DbLiability = {
+    id: string;
+    bankroll_id: string;
+    casino_id: string;
+    experience_id: string;
+    user_id: string;
+    currency_key: string;
+    ref_id: string;
+    ref_type: string;
+    max_payout: number;
+    deadline: Date;
+    resolved_at: Date | null;
+};
+export type NewLiability<RefType extends string = string> = {
+    lockedBankrollId: string;
+    casinoId: string;
+    experienceId: string;
+    userId: string;
+    currencyKey: string;
+    refId: string;
+    refType: RefType;
+    maxPayout: number;
+    deadline: Date;
+};

package/dist/src/liability/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/migrations.js

@@ -14,7 +14,7 @@ export async function runMigrations(options) {
         }
     }
     try {
-        await PgUpgradeSchema.default({
+        await PgUpgradeSchema({
             pgClient,
             dirname: join(import.meta.dirname, "pg-versions"),
             schemaName: "hub_core_versions",
@@ -30,7 +30,7 @@ export async function runMigrations(options) {
         throw e;
     }
     if (options.userDatabaseMigrationsPath) {
-        await PgUpgradeSchema.default({
+        await PgUpgradeSchema({
             pgClient,
             dirname: options.userDatabaseMigrationsPath,
             schemaName: "hub_user_versions",

package/dist/src/pg-versions/017-liability.sql

@@ -0,0 +1,48 @@
+DROP TABLE IF EXISTS hub.liability CASCADE;
+DROP FUNCTION IF EXISTS hub.update_bankroll_liability() CASCADE;
+DROP FUNCTION IF EXISTS hub.liability_is_active(timestamptz, timestamptz) CASCADE;
+DROP TRIGGER IF EXISTS liability_trigger ON hub.liability;
+ALTER TABLE hub.bankroll DROP COLUMN IF EXISTS liability;
+
+CREATE TABLE hub.liability (
+  id            uuid PRIMARY KEY DEFAULT hub_hidden.uuid_generate_v7(),
+
+  bankroll_id   uuid NOT NULL REFERENCES hub.bankroll,
+
+  casino_id     uuid NOT NULL REFERENCES hub.casino,
+  experience_id uuid NOT NULL REFERENCES hub.experience,
+  user_id       uuid NOT NULL REFERENCES hub.user,
+
+  currency_key  text NOT NULL,
+  foreign key (currency_key, casino_id) references hub.currency(key, casino_id),
+
+  ref_id     uuid NOT NULL,
+  ref_type   text NOT NULL,
+
+  CONSTRAINT hub_liability_unique_ref UNIQUE (ref_type, ref_id),
+
+  max_payout   float NOT NULL CHECK (max_payout >= 0),
+
+  deadline      timestamptz NOT NULL,
+  resolved_at   timestamptz NULL
+);
+
+CREATE INDEX liability_active_idx ON hub.liability(bankroll_id)
+    WHERE resolved_at IS NULL;
+
+CREATE INDEX liability_needs_expiration_idx ON hub.liability(deadline)
+    WHERE resolved_at IS NULL;
+
+ALTER TABLE hub.bankroll ADD COLUMN liability float NOT NULL DEFAULT 0;
+
+ALTER TABLE hub.bankroll ADD CONSTRAINT bankroll_liability_bounds CHECK (liability >= 0 AND liability <= amount);
+
+
+ALTER TABLE hub.liability ENABLE ROW LEVEL SECURITY;
+
+GRANT SELECT ON hub.liability TO app_postgraphile;
+
+CREATE POLICY select_liability ON hub.liability FOR SELECT
+USING (
+    hub_hidden.is_operator()
+);

package/dist/src/plugins/hub-make-outcome-bet.js

@@ -293,13 +293,13 @@ export function MakeOutcomeBetPlugin({ outcomeBetConfigs, }) {
                                     const riskLimits = betConfig.riskPolicy({
                                         type: "get-limits",
                                         currency: input.currency,
-                                        bankroll: dbHouseBankroll.amount,
+                                        availableBankroll: dbHouseBankroll.available,
                                     });
                                     const riskResult = validateRisk({
                                         type: "validate-bet",
                                         currency: input.currency,
                                         wager: input.wager,
-                                        bankroll: dbHouseBankroll.amount,
+                                        availableBankroll: dbHouseBankroll.available,
                                         maxPotentialPayout,
                                         riskLimits,
                                         displayUnitName: dbCurrency.display_unit_name,
@@ -406,8 +406,8 @@ export function MakeOutcomeBetPlugin({ outcomeBetConfigs, }) {
                                         balanceNew: dbPlayerBalance.amount + netPlayerAmount,
                                         balanceDelta: netPlayerAmount,
                                         bankrollId: dbHouseBankroll.id,
-                                        bankrollOld: dbHouseBankroll.amount,
-                                        bankrollNew: dbHouseBankroll.amount + houseBankrollDelta,
+                                        bankrollOld: dbHouseBankroll.grossAmount,
+                                        bankrollNew: dbHouseBankroll.grossAmount + houseBankrollDelta,
                                         bankrollDelta: houseBankrollDelta,
                                         action: "hub:outcome_bet",
                                         refType: "hub.outcome_bet",

package/dist/src/plugins/hub-risk-limits.js

@@ -87,7 +87,7 @@ export function HubRiskLimitsPlugin({ outcomeBetConfigs, customGameConfigs, }) {
                                         const riskLimits = config.riskPolicy({
                                             type: "get-limits",
                                             currency: bankroll.currency_key,
-                                            bankroll: bankroll.amount,
+                                            availableBankroll: bankroll.available,
                                         });
                                         return {
                                             gameKind,

package/dist/src/risk-policy.d.ts

@@ -4,14 +4,14 @@ export type RiskPolicyArgs = {
     type: "validate-bet";
     currency: string;
     wager: number;
-    bankroll: number;
+    availableBankroll: number;
     maxPotentialPayout: number;
     outcomes: DbOutcome[];
 };
 export type BetLimitPolicyArgs = {
     type: "get-limits";
     currency: string;
-    bankroll: number;
+    availableBankroll: number;
 };
 export type RiskLimits = {
     maxPayout: number;

package/dist/src/risk-policy.js

@@ -6,7 +6,7 @@ const _RiskLimitsSchema = z
 })
     .strict();
 export function validateRisk(options) {
-    const { bankroll, maxPotentialPayout } = options;
+    const { availableBankroll, maxPotentialPayout } = options;
     if (maxPotentialPayout > options.riskLimits.maxPayout) {
         const message = `Payout (${formatCurrency(maxPotentialPayout, {
             displayUnitName: options.displayUnitName,
@@ -20,11 +20,11 @@ export function validateRisk(options) {
             error: { message, riskLimits: options.riskLimits },
         };
     }
-    if (maxPotentialPayout > bankroll) {
+    if (maxPotentialPayout > availableBankroll) {
         const message = `House cannot cover potential payout (${formatCurrency(maxPotentialPayout, {
             displayUnitName: options.displayUnitName,
             displayUnitScale: options.displayUnitScale,
-        })}). Bankroll: ${formatCurrency(bankroll, {
+        })}). Bankroll: ${formatCurrency(availableBankroll, {
             displayUnitName: options.displayUnitName,
             displayUnitScale: options.displayUnitScale,
         })}`;

package/dist/src/server/index.d.ts

@@ -1,4 +1,5 @@
 import { ServerContext } from "../context.js";
+import type { LiabilityConfig } from "../liability/public/index.js";
 export type HubServer = {
     listen: () => Promise<{
         port: number;
@@ -11,7 +12,7 @@ export type ConfigureAppArgs = {
     app: Express;
     superuserPool: ServerContext["superuserPool"];
 };
-export type CreateHubServerOptions = {
+export type CreateHubServerOptions<LiabilityRefType extends string = string> = {
     configureApp?: (args: ConfigureAppArgs) => void;
     plugins?: readonly HubPlugin[];
     extraPgSchemas?: string[];
@@ -23,5 +24,6 @@ export type CreateHubServerOptions = {
     superuserDatabaseUrl: string;
     postgraphileDatabaseUrl: string;
     poolMax?: number;
+    liabilityConfig?: LiabilityConfig<LiabilityRefType>;
 };
-export declare function createHubServer({ configureApp, plugins, exportSchemaSDLPath, extraPgSchemas, enableChat, enablePlayground, port, runProcessors, superuserDatabaseUrl, postgraphileDatabaseUrl, poolMax, }: CreateHubServerOptions): HubServer;
+export declare function createHubServer<LiabilityRefType extends string = string>({ configureApp, plugins, exportSchemaSDLPath, extraPgSchemas, enableChat, enablePlayground, port, runProcessors, superuserDatabaseUrl, postgraphileDatabaseUrl, poolMax, liabilityConfig, }: CreateHubServerOptions<LiabilityRefType>): HubServer;

package/dist/src/server/index.js

@@ -1,9 +1,13 @@
 import { createServer as createNodeServer } from "node:http";
 import { grafserv } from "postgraphile/grafserv/express/v4";
-import postgraphile from "postgraphile";
+import postgraphileImport from "postgraphile";
+const postgraphile = typeof postgraphileImport === "function"
+    ? postgraphileImport
+    : postgraphileImport.default;
 import { createPreset, defaultPlugins } from "./graphile.config.js";
 import { createServerContext, closeServerContext, } from "../context.js";
 import { initializeTransferProcessors } from "../process-transfers/index.js";
+import { startLiabilityExpirationProcessor } from "../liability/internal/index.js";
 import express from "express";
 import { logger } from "../logger.js";
 import cors from "./middleware/cors.js";
@@ -46,7 +50,7 @@ function createExpressServer(context) {
     });
     return app;
 }
-export function createHubServer({ configureApp, plugins, exportSchemaSDLPath, extraPgSchemas, enableChat, enablePlayground, port, runProcessors, superuserDatabaseUrl, postgraphileDatabaseUrl, poolMax, }) {
+export function createHubServer({ configureApp, plugins, exportSchemaSDLPath, extraPgSchemas, enableChat, enablePlayground, port, runProcessors, superuserDatabaseUrl, postgraphileDatabaseUrl, poolMax, liabilityConfig, }) {
     const abortController = new AbortController();
     const context = createServerContext({
         superuserDatabaseUrl,
@@ -65,7 +69,7 @@ export function createHubServer({ configureApp, plugins, exportSchemaSDLPath, ex
         enablePlayground,
         poolMax,
     });
-    const pgl = postgraphile.default(preset);
+    const pgl = postgraphile(preset);
     const serv = pgl.createServ(grafserv);
     if (configureApp) {
         configureApp({ app: expressServer, superuserPool: context.superuserPool });
@@ -82,6 +86,13 @@ export function createHubServer({ configureApp, plugins, exportSchemaSDLPath, ex
                     signal: abortController.signal,
                     pool: context.superuserPool,
                 });
+                if (liabilityConfig) {
+                    startLiabilityExpirationProcessor({
+                        signal: abortController.signal,
+                        pool: context.superuserPool,
+                        liabilityConfig: liabilityConfig,
+                    });
+                }
             }
             await serv.addTo(expressServer, nodeServer);
             await pgl.getSchema();

package/dist/src/test/index.d.ts

@@ -1,7 +1,8 @@
 import { Pool, PoolClient } from "pg";
-import { DbUser, DbBalance, DbHashChain, DbCasino, DbExperience, DbCurrency, DbBankroll } from "../db/types.js";
+import { DbUser, DbPlayerBalance, DbHashChain, DbCasino, DbExperience, DbCurrency, DbHouseBankroll } from "../db/types.js";
 import { GraphQLClient } from "graphql-request";
 import { ServerOptions } from "../index.js";
+export declare function uniqueTestId(): string;
 export type HubTestServer = {
     port: number;
     stop: () => Promise<void>;
@@ -16,10 +17,10 @@ export type HubTestServer = {
 export type TestServerConfig = {
     plugins?: ServerOptions["plugins"];
     userDatabaseMigrationsPath?: string;
-    databaseName?: string;
+    testId: string;
     extraPgSchemas?: string[];
 };
-export declare function startTestServer({ plugins, userDatabaseMigrationsPath, databaseName, extraPgSchemas, }?: TestServerConfig): Promise<HubTestServer>;
+export declare function startTestServer({ plugins, userDatabaseMigrationsPath, testId, extraPgSchemas, }: TestServerConfig): Promise<HubTestServer>;
 type PgClient = Pool | PoolClient;
 export declare function createUser(pgClient: PgClient, { casinoId, uname, }: {
     casinoId: DbCasino["id"];
@@ -30,7 +31,7 @@ export declare function createPlayerBalance(pgClient: PgClient, { userId, experi
     experienceId: DbExperience["id"];
     currencyKey: DbCurrency["key"];
     amount: number;
-}): Promise<DbBalance>;
+}): Promise<DbPlayerBalance>;
 export declare function createHashChain(pgClient: PgClient, { userId, experienceId, casinoId, maxIterations, }: {
     userId: DbUser["id"];
     experienceId: DbExperience["id"];
@@ -54,10 +55,10 @@ export declare function createHouseBankroll(pgClient: PgClient, { casinoId, curr
     casinoId: DbCasino["id"];
     currencyKey: DbCurrency["key"];
     amount: number;
-}): Promise<DbBankroll>;
+}): Promise<DbHouseBankroll>;
 export { createUser as createPlayer };
 export declare function getPlayerBalance(pgClient: PgClient, { userId, experienceId, currencyKey, }: {
     userId: DbUser["id"];
     experienceId: DbExperience["id"];
     currencyKey: DbCurrency["key"];
-}): Promise<DbBalance | null>;
+}): Promise<DbPlayerBalance | null>;

package/dist/src/test/index.js

@@ -8,8 +8,13 @@ import { exactlyOneRow, maybeOneRow } from "../db/index.js";
 import { GraphQLClient } from "graphql-request";
 import { defaultPlugins, runMigrations } from "../index.js";
 import { createHubServer } from "../server/index.js";
-export async function startTestServer({ plugins = [...defaultPlugins], userDatabaseMigrationsPath, databaseName, extraPgSchemas = [], } = {}) {
-    const dbName = databaseName ?? `hub-test-${randomUUID().slice(0, 8)}`;
+let testCounter = 0;
+export function uniqueTestId() {
+    const workerId = process.env.VITEST_POOL_ID ?? "0";
+    return `${workerId}-${testCounter++}`;
+}
+export async function startTestServer({ plugins = [...defaultPlugins], userDatabaseMigrationsPath, testId, extraPgSchemas = [], }) {
+    const dbName = `hub-test-${testId}`;
     const connectionString = `postgres://postgres@localhost/${dbName}`;
     try {
         await execAsync(`psql -U postgres -c "CREATE DATABASE \\"${dbName}\\""`);

package/dist/src/util.d.ts

@@ -1,4 +1,8 @@
 import z from "zod/v4";
+declare const BRAND: unique symbol;
+export type Branded<Brand, T> = T & {
+    readonly [BRAND]: Brand;
+};
 export declare function isUuid(input: any): boolean;
 export type Result<V, E> = {
     ok: true;
@@ -9,3 +13,4 @@ export type Result<V, E> = {
 };
 export declare function extractFirstZodErrorMessage(e: z.ZodError): string;
 export declare function uuidEqual(a: string, b: string): boolean;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moneypot/hub",
-  "version": "1.19.16",
+  "version": "1.20.0-dev.1",
   "author": "moneypot.com",
   "homepage": "https://moneypot.com/hub",
   "keywords": [
@@ -14,8 +14,6 @@
   "exports": {
     ".": "./dist/src/index.js",
     "./db": "./dist/src/db/index.js",
-    "./db/types": "./dist/src/db/types.js",
-    "./db/util": "./dist/src/db/util.js",
     "./config": "./dist/src/config.js",
     "./graphile": "./dist/src/graphile.js",
     "./graphql": "./dist/src/graphql.js",
@@ -26,6 +24,7 @@
     "./hash-chain": "./dist/src/hash-chain/index.js",
     "./logger": "./dist/src/logger.js",
     "./audit-log": "./dist/src/audit-log.js",
+    "./liability": "./dist/src/liability/public/index.js",
     "./test": "./dist/src/test/index.js"
   },
   "files": [
@@ -36,8 +35,8 @@
     "db-migrate": "./dist/cli/db-migrate.js"
   },
   "scripts": {
-    "build:hub": "tsc && cp -R src/pg-versions dist/src/ && ./scripts/strip-sql.sh",
-    "build": "pnpm run build:hub && pnpm run build-dashboard",
+    "build:hub": "rm -rf dist/src && tsc && cp -R src/pg-versions dist/src/ && ./scripts/strip-sql.sh",
+    "build": "pnpm run build:hub && rm -rf dist/dashboard && pnpm run build-dashboard",
     "check": "tsc --noEmit && pnpm run check-dashboard",
     "check-tests": "tsc -p tests/tsconfig.json --noEmit",
     "check-dashboard": "cd ./dashboard && pnpm run check",
@@ -56,7 +55,7 @@
   "dependencies": {
     "@graphile-contrib/pg-omit-archived": "4.0.0-rc.1",
     "@moneypot/hash-herald": "^1.0.0",
-    "@moneypot/pg-upgrade-schema": "^2.1.0",
+    "@moneypot/pg-upgrade-schema": "^2.2.1",
     "dotenv": "^17.2.3",
     "express": "^5.2.1",
     "graphql": "^16.12.0",
@@ -68,15 +67,15 @@
     "pino": "^10.1.0",
     "postgraphile": "5.0.0-rc.3",
     "tsafe": "^1.8.12",
-    "zod": "^4.1.13"
+    "zod": "^4.2.1"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
     "@graphql-codegen/cli": "^6.1.0",
-    "@graphql-codegen/client-preset": "^5.2.1",
+    "@graphql-codegen/client-preset": "^5.2.2",
     "@graphql-typed-document-node/core": "^3.2.0",
     "@types/express": "^5.0.6",
-    "@types/node": "^25.0.1",
+    "@types/node": "^25.0.3",
     "@types/pg": "^8.16.0",
     "@types/supertest": "^6.0.3",
     "eslint": "^9.39.2",
@@ -86,8 +85,8 @@
     "supertest": "^7.1.4",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.49.0",
-    "vitest": "^4.0.15"
+    "typescript-eslint": "^8.50.1",
+    "vitest": "^4.0.16"
   },
   "peerDependencies": {
     "graphile-config": "^1.0.0-rc.2"