@moneypot/hub 1.19.8 → 1.19.10

package/README.md

@@ -17,7 +17,7 @@ View our docs: <https://docs.moneypot.com>
 ## Install
 
 ```sh
-$ npm install @moneypot/hub
+$ pnpm install @moneypot/hub
 ```
 
 ## Usage
@@ -80,7 +80,8 @@ You should always keep your hub server up to date as soon as possible. Never ins
 ### 1.19.x
 
 - All of hub's internal graphql-schema-modifying plugins have been moved to hub's set of required plugins.
-- Added `FAILED` take request auto-handling
+- Added `FAILED` take request auto-handling.
+- Exposed a `@moneypot/hub/test` module for end-user server testing.
 
 ### 1.18.x
 

package/dist/src/index.d.ts

@@ -35,6 +35,8 @@ export type ServerOptions = {
     enableChat?: boolean;
     enablePlayground?: boolean;
     port?: number;
+    superuserDatabaseUrl?: string;
+    postgraphileDatabaseUrl?: string;
 };
 export declare function startAndListen(options: ServerOptions): Promise<{
     port: number;

package/dist/src/index.js

@@ -1,4 +1,4 @@
-import * as config from "./config.js";
+import { NODE_ENV, PORT, SUPERUSER_DATABASE_URL, DATABASE_URL, } from "./config.js";
 import { logger } from "./logger.js";
 import { createHubServer } from "./server/index.js";
 export { HubGameConfigPlugin, } from "./plugins/hub-game-config-plugin.js";
@@ -25,14 +25,16 @@ export async function startAndListen(options) {
         userDatabaseMigrationsPath: options.userDatabaseMigrationsPath,
     });
     const hubServer = createHubServer({
+        superuserDatabaseUrl: options.superuserDatabaseUrl ?? SUPERUSER_DATABASE_URL,
+        postgraphileDatabaseUrl: options.postgraphileDatabaseUrl ?? DATABASE_URL,
         configureApp: options.configureApp,
         plugins: options.plugins,
         exportSchemaSDLPath: options.exportSchemaSDLPath,
         extraPgSchemas: options.extraPgSchemas,
         enableChat: options.enableChat ?? true,
         enablePlayground: options.enablePlayground ?? true,
-        port: options.port ?? config.PORT,
-        runProcessors: process.env.NODE_ENV !== "test",
+        port: options.port ?? PORT,
+        runProcessors: NODE_ENV !== "test",
     });
     if (process.env.NODE_ENV !== "test") {
         const handler = () => {

package/dist/src/migrations.d.ts

@@ -1,3 +1,4 @@
 export declare function runMigrations(options: {
     userDatabaseMigrationsPath?: string;
+    superuserDatabaseUrl?: string;
 }): Promise<void>;

package/dist/src/migrations.js

@@ -14,7 +14,10 @@ export async function runMigrations(options) {
             throw new Error(`userDatabaseMigrationsPath is not a directory: ${options.userDatabaseMigrationsPath}`);
         }
     }
-    const pgClient = db.getPgClient(config.SUPERUSER_DATABASE_URL);
+    const superuserDatabaseUrl = options.superuserDatabaseUrl ??
+        process.env.SUPERUSER_DATABASE_URL ??
+        config.SUPERUSER_DATABASE_URL;
+    const pgClient = db.getPgClient(superuserDatabaseUrl);
     await pgClient.connect();
     try {
         try {

package/dist/src/server/graphile.config.d.ts

@@ -29,7 +29,7 @@ export declare const requiredPlugins: readonly GraphileConfig.Plugin[];
 export declare const defaultPlugins: readonly GraphileConfig.Plugin[];
 import { HubGameConfigPlugin } from "../plugins/hub-game-config-plugin.js";
 export type HubPlugin = GraphileConfig.Plugin | HubGameConfigPlugin;
-export declare function createPreset({ plugins, exportSchemaSDLPath, extraPgSchemas, abortSignal, context, enableChat, enablePlayground, }: {
+export declare function createPreset({ plugins, exportSchemaSDLPath, extraPgSchemas, abortSignal, context, enableChat, enablePlayground, postgraphileDatabaseUrl, }: {
     plugins: readonly HubPlugin[];
     exportSchemaSDLPath?: string;
     extraPgSchemas: string[];
@@ -37,6 +37,7 @@ export declare function createPreset({ plugins, exportSchemaSDLPath, extraPgSche
     context: ServerContext;
     enableChat: boolean;
     enablePlayground: boolean;
+    postgraphileDatabaseUrl: string;
 }): {
     preset: GraphileConfig.Preset;
     pgService: GraphileConfig.PgServiceConfiguration<"@dataplan/pg/adaptors/pg">;

package/dist/src/server/graphile.config.js

@@ -2,7 +2,7 @@ import "graphile-config";
 import "postgraphile";
 import { makePgService } from "postgraphile/adaptors/pg";
 import { PostGraphileAmberPreset } from "postgraphile/presets/amber";
-import * as config from "../config.js";
+import { NODE_ENV } from "../config.js";
 import { maskError } from "./handle-errors.js";
 import * as db from "../db/index.js";
 import { SmartTagsPlugin } from "../smart-tags.js";
@@ -53,11 +53,11 @@ export const requiredPlugins = [
     customPgOmitArchivedPlugin("deleted"),
 ];
 export const defaultPlugins = [
-    ...(config.NODE_ENV === "development" ? [DebugPlugin] : []),
+    ...(NODE_ENV === "development" ? [DebugPlugin] : []),
     ...requiredPlugins,
 ];
 import { HubGameConfigPlugin, isHubGameConfigPlugin, expandHubGameConfigPlugin, } from "../plugins/hub-game-config-plugin.js";
-export function createPreset({ plugins, exportSchemaSDLPath, extraPgSchemas, abortSignal, context, enableChat, enablePlayground, }) {
+export function createPreset({ plugins, exportSchemaSDLPath, extraPgSchemas, abortSignal, context, enableChat, enablePlayground, postgraphileDatabaseUrl, }) {
     if (exportSchemaSDLPath) {
         if (!exportSchemaSDLPath.startsWith("/")) {
             throw new Error("exportSchemaSDLPath must be an absolute path");
@@ -79,11 +79,12 @@ export function createPreset({ plugins, exportSchemaSDLPath, extraPgSchemas, abo
             mutablePlugins.push(p);
         }
     }
-    for (const requiredPlugin of requiredPlugins) {
-        if (!mutablePlugins.some((plugin) => plugin === requiredPlugin)) {
-            logger.warn(`Adding required plugin "${requiredPlugin.name}"`);
-            mutablePlugins.unshift(requiredPlugin);
-        }
+    const missingPlugins = requiredPlugins.filter((rp) => !mutablePlugins.some((p) => p === rp));
+    for (const p of missingPlugins) {
+        logger.warn(`Adding required plugin "${p.name}"`);
+    }
+    if (missingPlugins.length > 0) {
+        mutablePlugins.unshift(...missingPlugins);
     }
     if (enablePlayground) {
         mutablePlugins.push(HubCreatePlaygroundSessionPlugin);
@@ -92,7 +93,7 @@ export function createPreset({ plugins, exportSchemaSDLPath, extraPgSchemas, abo
         mutablePlugins.push(HubChatCreateUserMessagePlugin, HubChatCreateSystemMessagePlugin, HubChatSubscriptionPlugin, HubChatMuteUserPlugin, HubChatUnmuteUserPlugin, HubChatAfterIdConditionPlugin, HubChatModManagementPlugin);
     }
     const pgService = makePgService({
-        connectionString: config.DATABASE_URL,
+        connectionString: postgraphileDatabaseUrl,
         schemas: [...extraPgSchemas, "hub"],
     });
     const preset = {

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

@@ -20,5 +20,7 @@ export type CreateHubServerOptions = {
     enablePlayground: boolean;
     port: number;
     runProcessors: boolean;
+    superuserDatabaseUrl: string;
+    postgraphileDatabaseUrl: string;
 };
-export declare function createHubServer({ configureApp, plugins, exportSchemaSDLPath, extraPgSchemas, enableChat, enablePlayground, port, runProcessors, }: CreateHubServerOptions): HubServer;
+export declare function createHubServer({ configureApp, plugins, exportSchemaSDLPath, extraPgSchemas, enableChat, enablePlayground, port, runProcessors, superuserDatabaseUrl, postgraphileDatabaseUrl, }: CreateHubServerOptions): HubServer;

package/dist/src/server/index.js

@@ -46,11 +46,15 @@ function createExpressServer(context) {
     });
     return app;
 }
-export function createHubServer({ configureApp, plugins, exportSchemaSDLPath, extraPgSchemas, enableChat, enablePlayground, port, runProcessors, }) {
+export function createHubServer({ configureApp, plugins, exportSchemaSDLPath, extraPgSchemas, enableChat, enablePlayground, port, runProcessors, superuserDatabaseUrl, postgraphileDatabaseUrl, }) {
     const abortController = new AbortController();
-    const context = createServerContext();
+    const context = createServerContext({
+        superuserDatabaseUrl,
+        postgraphileDatabaseUrl,
+    });
     const expressServer = createExpressServer(context);
     const { preset, pgService } = createPreset({
+        postgraphileDatabaseUrl,
         plugins: plugins ?? defaultPlugins,
         exportSchemaSDLPath,
         extraPgSchemas: extraPgSchemas ?? [],

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

@@ -0,0 +1,62 @@
+import { Pool, PoolClient } from "pg";
+import { DbUser, DbBalance, DbHashChain, DbCasino, DbExperience, DbCurrency, DbBankroll } from "../db/types.js";
+import { GraphQLClient } from "graphql-request";
+import { ServerOptions } from "../index.js";
+export type HubTestServer = {
+    port: number;
+    stop: () => Promise<void>;
+    dbPool: Pool;
+    playgroundCasinoId: string;
+    authenticate: (userId: DbUser["id"], experienceId: DbExperience["id"]) => Promise<{
+        sessionKey: string;
+        graphqlClient: GraphQLClient;
+    }>;
+};
+export type TestServerConfig = {
+    plugins?: ServerOptions["plugins"];
+    userDatabaseMigrationsPath?: string;
+    databaseName?: string;
+    extraPgSchemas?: string[];
+};
+export declare function startTestServer({ plugins, userDatabaseMigrationsPath, databaseName, extraPgSchemas, }?: TestServerConfig): Promise<HubTestServer>;
+type PgClient = Pool | PoolClient;
+export declare function createUser(pgClient: PgClient, { casinoId, uname, }: {
+    casinoId: DbCasino["id"];
+    uname: string;
+}): Promise<DbUser>;
+export declare function createPlayerBalance(pgClient: PgClient, { userId, experienceId, currencyKey, amount, }: {
+    userId: DbUser["id"];
+    experienceId: DbExperience["id"];
+    currencyKey: DbCurrency["key"];
+    amount: number;
+}): Promise<DbBalance>;
+export declare function createHashChain(pgClient: PgClient, { userId, experienceId, casinoId, maxIterations, }: {
+    userId: DbUser["id"];
+    experienceId: DbExperience["id"];
+    casinoId: DbCasino["id"];
+    maxIterations?: number;
+}): Promise<DbHashChain>;
+export declare function createExperience(pgClient: PgClient, options: {
+    casinoId: DbCasino["id"];
+} | {
+    casinoId: DbCasino["id"];
+    mpExperienceId: string;
+    name: string;
+}): Promise<DbExperience>;
+export declare function createCurrency(pgClient: PgClient, { key, casinoId, displayUnitName, displayUnitScale, }: {
+    key: DbCurrency["key"];
+    casinoId: DbCasino["id"];
+    displayUnitName: string;
+    displayUnitScale: number;
+}): Promise<DbCurrency>;
+export declare function createHouseBankroll(pgClient: PgClient, { casinoId, currencyKey, amount, }: {
+    casinoId: DbCasino["id"];
+    currencyKey: DbCurrency["key"];
+    amount: number;
+}): Promise<DbBankroll>;
+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>;

package/dist/src/test/index.js

@@ -0,0 +1,156 @@
+import { Pool } from "pg";
+import { randomBytes, randomUUID } from "node:crypto";
+import { execSync } from "node:child_process";
+import { DbHashKind, } from "../db/types.js";
+import { exactlyOneRow, maybeOneRow, } from "../db/index.js";
+import { GraphQLClient } from "graphql-request";
+import { defaultPlugins, runMigrations } from "../index.js";
+import { createHubServer } from "../server/index.js";
+const createdDatabases = new Set();
+export async function startTestServer({ plugins = [...defaultPlugins], userDatabaseMigrationsPath, databaseName, extraPgSchemas = [], } = {}) {
+    const dbName = databaseName ?? `hub-test-${randomUUID().slice(0, 8)}`;
+    const connectionString = `postgres://postgres@localhost/${dbName}`;
+    try {
+        execSync(`psql -U postgres -c "CREATE DATABASE \\"${dbName}\\""`, {
+            stdio: "pipe",
+        });
+        createdDatabases.add(dbName);
+    }
+    catch (_e) {
+        const pool = new Pool({ connectionString });
+        try {
+            await pool.query(`
+        DROP SCHEMA IF EXISTS hub CASCADE;
+        DROP SCHEMA IF EXISTS hub_hidden CASCADE;
+        DROP SCHEMA IF EXISTS hub_secret CASCADE;
+        DROP SCHEMA IF EXISTS hub_core_versions CASCADE;
+        DROP SCHEMA IF EXISTS hub_user_versions CASCADE;
+      `);
+        }
+        finally {
+            await pool.end();
+        }
+    }
+    process.env.NODE_ENV = "test";
+    process.env.LOG_LEVEL = process.env.LOG_LEVEL ?? "error";
+    process.env.HASHCHAINSERVER_URL = "mock-server";
+    process.env.HASHCHAINSERVER_APPLICATION_SECRET = "test-secret";
+    await runMigrations({
+        userDatabaseMigrationsPath,
+        superuserDatabaseUrl: connectionString,
+    });
+    const hubServer = createHubServer({
+        port: 0,
+        plugins,
+        extraPgSchemas,
+        exportSchemaSDLPath: undefined,
+        enableChat: false,
+        enablePlayground: false,
+        runProcessors: false,
+        superuserDatabaseUrl: connectionString,
+        postgraphileDatabaseUrl: connectionString,
+    });
+    const { port } = await hubServer.listen();
+    const dbPool = new Pool({ connectionString });
+    const url = `http://localhost:${port}`;
+    const graphqlUrl = `${url}/graphql`;
+    const { rows } = await dbPool.query("SELECT id FROM hub.casino WHERE is_playground = true LIMIT 1");
+    const playgroundCasinoId = rows[0]?.id;
+    if (!playgroundCasinoId) {
+        throw new Error("Playground casino not found - migrations may have failed");
+    }
+    return {
+        port,
+        dbPool,
+        playgroundCasinoId,
+        stop: async () => {
+            await dbPool.end();
+            await hubServer.shutdown();
+        },
+        authenticate: async (userId, experienceId) => {
+            const user = await dbPool
+                .query(`SELECT casino_id FROM hub.user WHERE id = $1`, [userId])
+                .then(exactlyOneRow);
+            const userToken = randomUUID();
+            const sessionKey = randomUUID();
+            await dbPool.query(`INSERT INTO hub.session (user_id, casino_id, experience_id, user_token, key)
+         VALUES ($1, $2, $3, $4, $5)`, [userId, user.casino_id, experienceId, userToken, sessionKey]);
+            const graphqlClient = new GraphQLClient(graphqlUrl, {
+                headers: {
+                    Authorization: `session:${sessionKey}`,
+                },
+            });
+            return { sessionKey, graphqlClient };
+        },
+    };
+}
+export async function createUser(pgClient, { casinoId, uname, }) {
+    const mpUserId = randomUUID();
+    return pgClient
+        .query(`INSERT INTO hub.user (mp_user_id, casino_id, uname)
+       VALUES ($1, $2, $3)
+       RETURNING *`, [mpUserId, casinoId, uname])
+        .then(exactlyOneRow);
+}
+export async function createPlayerBalance(pgClient, { userId, experienceId, currencyKey, amount, }) {
+    return pgClient
+        .query(`INSERT INTO hub.balance (user_id, experience_id, currency_key, amount, casino_id)
+       VALUES ($1, $2, $3, $4, (SELECT casino_id FROM hub.user WHERE id = $1) )
+       RETURNING *`, [userId, experienceId, currencyKey, amount])
+        .then(exactlyOneRow);
+}
+export async function createHashChain(pgClient, { userId, experienceId, casinoId, maxIterations = 10, }) {
+    const hashChain = await pgClient
+        .query(`INSERT INTO hub.hash_chain (user_id, experience_id, casino_id, max_iteration, current_iteration, active)
+       VALUES ($1, $2, $3, $4, $4, TRUE)
+       RETURNING *`, [userId, experienceId, casinoId, maxIterations])
+        .then(exactlyOneRow);
+    const terminalHash = randomBytes(32);
+    await pgClient.query(`INSERT INTO hub.hash (hash_chain_id, kind, digest, iteration, metadata)
+     VALUES ($1, $2, $3, $4, '{}')`, [hashChain.id, DbHashKind.TERMINAL, terminalHash, maxIterations]);
+    return hashChain;
+}
+export async function createExperience(pgClient, options) {
+    const casinoId = options.casinoId;
+    let mpExperienceId;
+    let name;
+    if ("mpExperienceId" in options) {
+        ({ mpExperienceId, name } = options);
+    }
+    else {
+        name = "experience-" + randomUUID();
+        mpExperienceId = randomUUID();
+    }
+    return pgClient
+        .query(`INSERT INTO hub.experience (mp_experience_id, casino_id, name)
+       VALUES ($1, $2, $3)
+       RETURNING *`, [mpExperienceId, casinoId, name])
+        .then(exactlyOneRow);
+}
+export async function createCurrency(pgClient, { key, casinoId, displayUnitName, displayUnitScale, }) {
+    return pgClient
+        .query(`
+      INSERT INTO hub.currency (key, casino_id, display_unit_name, display_unit_scale)
+      VALUES ($1, $2, $3, $4)
+      RETURNING *
+     `, [key, casinoId, displayUnitName, displayUnitScale])
+        .then(exactlyOneRow);
+}
+export async function createHouseBankroll(pgClient, { casinoId, currencyKey, amount, }) {
+    return pgClient
+        .query(`INSERT INTO hub.bankroll (casino_id, currency_key, amount)
+       VALUES ($1, $2, $3)
+       ON CONFLICT (casino_id, currency_key) DO UPDATE SET amount = $3
+       RETURNING *`, [casinoId, currencyKey, amount])
+        .then(exactlyOneRow);
+}
+export { createUser as createPlayer };
+export async function getPlayerBalance(pgClient, { userId, experienceId, currencyKey, }) {
+    return pgClient
+        .query(`
+    SELECT * FROM hub.balance
+    WHERE experience_id = $1 AND user_id = $2 AND currency_key = $3
+    `, [experienceId, userId, currencyKey])
+        .then(maybeOneRow)
+        .then((row) => row ?? null);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moneypot/hub",
-  "version": "1.19.8",
+  "version": "1.19.10",
   "author": "moneypot.com",
   "homepage": "https://moneypot.com/hub",
   "keywords": [
@@ -25,7 +25,8 @@
     "./pg-sql2": "./dist/src/pg-sql2.js",
     "./hash-chain": "./dist/src/hash-chain/index.js",
     "./logger": "./dist/src/logger.js",
-    "./audit-log": "./dist/src/audit-log.js"
+    "./audit-log": "./dist/src/audit-log.js",
+    "./test": "./dist/src/test/index.js"
   },
   "files": [
     "/dist"
@@ -35,7 +36,8 @@
     "db-migrate": "./dist/cli/db-migrate.js"
   },
   "scripts": {
-    "build": "rm -rf dist && tsc && cp -R src/pg-versions dist/src/ && ./scripts/strip-sql.sh && pnpm run build-dashboard",
+    "build:hub": "tsc && cp -R src/pg-versions dist/src/ && ./scripts/strip-sql.sh",
+    "build": "pnpm run build:hub && 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",