@takaro/module-test 0.0.0-stage → 0.7.5

package/dist/fixtures.js

@@ -0,0 +1,152 @@
+import { randomUUID } from 'node:crypto';
+const EPOCH = '2024-01-01T00:00:00.000Z';
+/** @internal Exported for tests only. */
+export function createPlayerFixture(options, resolveModule) {
+    const playerId = options.playerId ?? randomUUID();
+    const gameId = options.gameId ?? randomUUID();
+    const name = options.name ?? 'Test player';
+    const roles = buildRoles(playerId, options.gameServerId, options.permissions ?? 'ROOT', resolveModule);
+    const position = options.position ?? { x: 1, y: 2, z: 3, dimension: 'overworld' };
+    const pog = {
+        id: randomUUID(),
+        playerId,
+        gameServerId: options.gameServerId,
+        gameId,
+        roles,
+        currency: options.currency ?? 0,
+        online: options.online ?? true,
+        inventory: [],
+        lastSeen: EPOCH,
+        playtimeSeconds: 0,
+        positionX: position.x,
+        positionY: position.y,
+        positionZ: position.z,
+        dimension: position.dimension ?? 'overworld',
+        ...(options.ping === undefined ? {} : { ping: options.ping }),
+        ...(options.ip === undefined ? {} : { ip: options.ip }),
+        createdAt: EPOCH,
+        updatedAt: EPOCH,
+    };
+    // `roleAssignments`, not `roles`: the two DTOs spell the same thing differently, and it is the
+    // POG's `roles` that `checkPermission` walks.
+    const player = {
+        id: playerId,
+        name,
+        roleAssignments: roles,
+        ...(options.steamId === undefined ? {} : { steamId: options.steamId }),
+        ...(options.epicOnlineServicesId === undefined ? {} : { epicOnlineServicesId: options.epicOnlineServicesId }),
+        ...(options.xboxLiveId === undefined ? {} : { xboxLiveId: options.xboxLiveId }),
+        ...(options.platformId === undefined ? {} : { platformId: options.platformId }),
+        playtimeSeconds: 0,
+        ipHistory: [],
+        nameHistory: [],
+        createdAt: EPOCH,
+        updatedAt: EPOCH,
+    };
+    return { player, pog };
+}
+// Absent by default: an unlinked player is the real default, so a module's "must link your
+// account" branch stays reachable. Only `id` is load-bearing today.
+/** @internal Exported for tests only. */
+export function createUserFixture(player, options = {}) {
+    const id = options.userId ?? randomUUID();
+    return {
+        id,
+        // Never empty: `UserService.extend` always pushes the system `User` role; `roles: []` is a
+        // shape production cannot produce.
+        roles: buildUserRoles(id),
+        name: `${player.name} (user)`,
+        email: `${id}@module-test.invalid`,
+        idpId: id,
+        lastSeen: EPOCH,
+        playerId: player.id,
+        player,
+        isDashboardUser: false,
+        isSupportAccount: false,
+        // A module's caller is always a real, player-linked human — never the Service Account behind
+        // a Domain Key, which has no player and cannot run a command.
+        isServiceAccount: false,
+        createdAt: EPOCH,
+        updatedAt: EPOCH,
+    };
+}
+// The system `User` role every user carries, matching `UserService.extend`. Holds no permissions:
+// the command gate walks `pog.roles`, not this, so only the shape matters.
+function buildUserRoles(userId) {
+    const roleId = randomUUID();
+    return [
+        {
+            // `id`/`createdAt`/`updatedAt` are noise `UserService.extend` never sets, but the generated
+            // DTO declares them required.
+            id: randomUUID(),
+            userId,
+            roleId,
+            createdAt: EPOCH,
+            updatedAt: EPOCH,
+            role: {
+                id: roleId,
+                name: 'User',
+                system: true,
+                createdAt: EPOCH,
+                updatedAt: EPOCH,
+                permissions: [],
+            },
+        },
+    ];
+}
+// One Role matching the shape `checkPermission` walks (`pog.roles[].role.permissions[].permission`),
+// with the count on the assignment record. ROOT is a system permission, so it carries no `module`.
+function buildRoles(playerId, gameServerId, fixture, resolveModule) {
+    const moduleOf = (entry) => {
+        if (entry.permission === 'ROOT') {
+            return {};
+        }
+        if (!resolveModule) {
+            if (entry.module) {
+                throw new Error(`Fixture grant '${entry.permission}' names module '${entry.module}' but no resolver was given`);
+            }
+            return {};
+        }
+        return { module: resolveModule(entry.module) };
+    };
+    const permissions = fixture === 'ROOT' ? [{ permission: 'ROOT' }] : fixture;
+    const roleId = randomUUID();
+    return [
+        {
+            id: randomUUID(),
+            playerId,
+            roleId,
+            gameServerId,
+            createdAt: EPOCH,
+            updatedAt: EPOCH,
+            role: {
+                id: roleId,
+                name: 'Test role',
+                system: false,
+                createdAt: EPOCH,
+                updatedAt: EPOCH,
+                permissions: permissions.map((entry) => {
+                    const permissionId = randomUUID();
+                    return {
+                        id: randomUUID(),
+                        permissionId,
+                        count: entry.count ?? 0,
+                        createdAt: EPOCH,
+                        updatedAt: EPOCH,
+                        permission: {
+                            id: permissionId,
+                            permission: entry.permission,
+                            friendlyName: entry.permission,
+                            description: entry.permission,
+                            canHaveCount: entry.count !== undefined,
+                            ...moduleOf(entry),
+                            createdAt: EPOCH,
+                            updatedAt: EPOCH,
+                        },
+                    };
+                }),
+            },
+        },
+    ];
+}
+//# sourceMappingURL=fixtures.js.map

package/dist/fixtures.js.map

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

package/dist/installation.d.ts

@@ -0,0 +1,23 @@
+import type { ModuleInstallationOutputDTO } from '@takaro/apiclient';
+import type { ModuleExport, ModuleExportVersion, ModuleSource } from './moduleExport.js';
+import type { SystemConfig, SystemConfigOverrides } from './config.js';
+/** The newest version of a module, which is what `latestVersion` resolves to in production. */
+export declare function latestVersionOf<M extends ModuleExport>(mod: M): M['versions'][number];
+export interface InstallationOptions {
+    gameServerId: string;
+    userConfig?: Record<string, unknown>;
+    systemConfig?: SystemConfigOverrides;
+    versionTag?: string;
+}
+export interface ModuleInstallation {
+    installation: ModuleInstallationOutputDTO;
+    /** The `{ name, code }` pairs `executeLocal` derives from `module.version.functions`. */
+    userModules: Array<{
+        name: string;
+        code: string;
+    }>;
+    transferVersion: ModuleExportVersion;
+}
+export declare function installModule(source: ModuleSource, options: InstallationOptions): ModuleInstallation;
+export declare function systemConfigOf(installation: ModuleInstallationOutputDTO): SystemConfig;
+//# sourceMappingURL=installation.d.ts.map

package/dist/installation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installation.d.ts","sourceRoot":"","sources":["../src/installation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAMV,2BAA2B,EAK5B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGzF,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIvE,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,CAAC,SAAS,YAAY,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAMrF;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,2BAA2B,CAAC;IAC1C,yFAAyF;IACzF,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,eAAe,EAAE,mBAAmB,CAAC;CACtC;AA2BD,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CAsCpG;AAED,wBAAgB,cAAc,CAAC,YAAY,EAAE,2BAA2B,GAAG,YAAY,CAEtF"}

package/dist/installation.js

@@ -0,0 +1,170 @@
+import { randomUUID } from 'node:crypto';
+import { loadModuleDirectory } from './loadModule.js';
+import { getSystemConfigSchema } from './systemConfig.js';
+import { resolveSystemConfig, resolveUserConfig } from './config.js';
+const EPOCH = '2024-01-01T00:00:00.000Z';
+/** The newest version of a module, which is what `latestVersion` resolves to in production. */
+export function latestVersionOf(mod) {
+    const version = mod.versions.at(-1);
+    if (!version) {
+        throw new Error(`Module '${mod.name}' declares no versions`);
+    }
+    return version;
+}
+function resolveModuleSource(source) {
+    const mod = typeof source === 'string' || source instanceof URL ? loadModuleDirectory(source) : source;
+    if (typeof mod.name !== 'string' || mod.name === '') {
+        throw new Error('A module needs a non-empty string `name`');
+    }
+    if (!Array.isArray(mod.versions) || mod.versions.length === 0) {
+        throw new Error(`Module '${mod.name}' needs a non-empty \`versions\` array`);
+    }
+    return mod;
+}
+function selectVersion(mod, versionTag) {
+    if (!versionTag) {
+        return latestVersionOf(mod);
+    }
+    const found = mod.versions.find((candidate) => candidate.tag === versionTag);
+    if (!found) {
+        const tags = mod.versions.map((candidate) => candidate.tag).join(', ');
+        throw new Error(`Module '${mod.name}' has no version tagged '${versionTag}'. Available: ${tags}`);
+    }
+    return found;
+}
+// Ids are synthetic but stable within one installation, so an assertion on `moduleId` matches
+// what module code actually read.
+export function installModule(source, options) {
+    const mod = resolveModuleSource(source);
+    const transferVersion = selectVersion(mod, options.versionTag);
+    const moduleId = randomUUID();
+    const versionId = randomUUID();
+    const version = toVersionOutput(transferVersion, moduleId, versionId);
+    const module = {
+        id: moduleId,
+        name: mod.name,
+        author: mod.author,
+        supportedGames: mod.supportedGames ?? [],
+        latestVersion: version,
+        createdAt: EPOCH,
+        updatedAt: EPOCH,
+    };
+    const installation = {
+        id: randomUUID(),
+        gameserverId: options.gameServerId,
+        versionId,
+        moduleId,
+        version,
+        module,
+        userConfig: resolveUserConfig(transferVersion, options.userConfig),
+        systemConfig: resolveSystemConfig(transferVersion, options.systemConfig),
+        createdAt: EPOCH,
+        updatedAt: EPOCH,
+    };
+    return {
+        installation,
+        userModules: version.functions
+            .filter((fn) => Boolean(fn.name))
+            .map((fn) => ({ name: fn.name, code: fn.code })),
+        transferVersion,
+    };
+}
+export function systemConfigOf(installation) {
+    return installation.systemConfig;
+}
+function toFunction(code, versionId, name) {
+    return { id: randomUUID(), code, versionId, createdAt: EPOCH, updatedAt: EPOCH, ...(name ? { name } : {}) };
+}
+function toVersionOutput(version, moduleId, versionId) {
+    const commands = (version.commands ?? []).map((command) => {
+        const fn = toFunction(command.function, versionId);
+        return {
+            id: randomUUID(),
+            name: command.name,
+            trigger: command.trigger,
+            helpText: command.helpText ?? '',
+            description: command.description,
+            function: fn,
+            functionId: fn.id,
+            versionId,
+            requiredPermissions: command.requiredPermissions ?? [],
+            arguments: (command.arguments ?? []).map((argument, index) => ({
+                id: randomUUID(),
+                name: argument.name,
+                type: argument.type,
+                helpText: argument.helpText ?? '',
+                position: argument.position ?? index,
+                createdAt: EPOCH,
+                updatedAt: EPOCH,
+                // `defaultValue` is nullable in the export format and optional in the API DTO; a null
+                // default means "required", which is not the same as "defaults to the string 'null'".
+                ...(argument.defaultValue !== null && argument.defaultValue !== undefined
+                    ? { defaultValue: argument.defaultValue }
+                    : {}),
+            })),
+            createdAt: EPOCH,
+            updatedAt: EPOCH,
+        };
+    });
+    const hooks = (version.hooks ?? []).map((hook) => ({
+        id: randomUUID(),
+        name: hook.name,
+        description: hook.description,
+        regex: hook.regex ?? '',
+        eventType: hook.eventType,
+        function: toFunction(hook.function, versionId),
+        versionId,
+        createdAt: EPOCH,
+        updatedAt: EPOCH,
+    }));
+    const cronJobs = (version.cronJobs ?? []).map((cronJob) => ({
+        id: randomUUID(),
+        name: cronJob.name,
+        description: cronJob.description,
+        temporalValue: cronJob.temporalValue,
+        function: toFunction(cronJob.function, versionId),
+        versionId,
+        createdAt: EPOCH,
+        updatedAt: EPOCH,
+    }));
+    const shopActions = (version.shopActions ?? []).map((shopAction) => ({
+        id: randomUUID(),
+        name: shopAction.name,
+        description: shopAction.description,
+        function: toFunction(shopAction.function, versionId),
+        versionId,
+        createdAt: EPOCH,
+        updatedAt: EPOCH,
+    }));
+    const permissions = (version.permissions ?? []).map((permission) => ({
+        id: randomUUID(),
+        permission: permission.permission,
+        friendlyName: permission.friendlyName,
+        description: permission.description,
+        canHaveCount: permission.canHaveCount,
+        createdAt: EPOCH,
+        updatedAt: EPOCH,
+    }));
+    return {
+        id: versionId,
+        moduleId,
+        tag: version.tag,
+        description: version.description,
+        configSchema: version.configSchema,
+        uiSchema: version.uiSchema ?? '{}',
+        systemConfigSchema: getSystemConfigSchema(version),
+        defaultSystemConfig: version.defaultSystemConfig,
+        commands,
+        hooks,
+        cronJobs,
+        // Named functions are the linkable `./x.js` user-modules; commands and hooks carry their
+        // own code inline and are not importable.
+        functions: (version.functions ?? []).map((fn) => toFunction(fn.function, versionId, fn.name)),
+        permissions,
+        shopActions,
+        commandsWithUndeclaredPermissions: [],
+        createdAt: EPOCH,
+        updatedAt: EPOCH,
+    };
+}
+//# sourceMappingURL=installation.js.map

package/dist/installation.js.map

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

package/dist/intrinsics.d.ts

@@ -0,0 +1,9 @@
+export interface IntrinsicsOptions {
+    /** Freeze the VM's clock here. `Date.now()` and `new Date()` both report it. */
+    now?: Date;
+    /** What `Math.random()` returns, in order; the last value repeats once the list is exhausted. */
+    random?: number | number[];
+}
+/** @internal Exported for tests only. */
+export declare function buildContextOverride(options: IntrinsicsOptions): Record<string, unknown>;
+//# sourceMappingURL=intrinsics.d.ts.map

package/dist/intrinsics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intrinsics.d.ts","sourceRoot":"","sources":["../src/intrinsics.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,iGAAiG;IACjG,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC5B;AAED,yCAAyC;AACzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgCxF"}

package/dist/intrinsics.js

@@ -0,0 +1,33 @@
+/** @internal Exported for tests only. */
+export function buildContextOverride(options) {
+    const context = {};
+    if (options.now) {
+        const fixed = options.now.getTime();
+        context.Date = class FrozenDate extends Date {
+            constructor(...args) {
+                // Only the zero-argument form is the clock; `new Date(iso)` must keep parsing.
+                if (args.length === 0) {
+                    super(fixed);
+                }
+                else {
+                    super(...args);
+                }
+            }
+            static now() {
+                return fixed;
+            }
+        };
+    }
+    if (options.random !== undefined) {
+        const sequence = Array.isArray(options.random) ? options.random : [options.random];
+        if (sequence.length === 0) {
+            throw new Error('random must not be an empty sequence');
+        }
+        let index = 0;
+        const draw = () => sequence[Math.min(index++, sequence.length - 1)];
+        // A copy, not a mutation: `Math` here is the HOST's, and stubbing it would leak into later tests.
+        context.Math = Object.create(Math, { random: { value: draw, enumerable: true } });
+    }
+    return context;
+}
+//# sourceMappingURL=intrinsics.js.map

package/dist/intrinsics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intrinsics.js","sourceRoot":"","sources":["../src/intrinsics.ts"],"names":[],"mappings":"AAQA,yCAAyC;AACzC,MAAM,UAAU,oBAAoB,CAAC,OAA0B;IAC7D,MAAM,OAAO,GAA4B,EAAE,CAAC;IAE5C,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACpC,OAAO,CAAC,IAAI,GAAG,MAAM,UAAW,SAAQ,IAAI;YAC1C,YAAY,GAAG,IAAe;gBAC5B,+EAA+E;gBAC/E,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACtB,KAAK,CAAC,KAAK,CAAC,CAAC;gBACf,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,GAAI,IAA2C,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC;YACD,MAAM,CAAU,GAAG;gBACjB,OAAO,KAAK,CAAC;YACf,CAAC;SACF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QACpE,kGAAkG;QAClG,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/loadModule.d.ts

@@ -0,0 +1,11 @@
+import type { ModuleExport } from './moduleExport.js';
+export declare class ModuleLoadError extends Error {
+    constructor(moduleJsonPath: string, problem: string);
+}
+/**
+ * Reads a module directory in the registry source layout: a `module.json` whose components point
+ * at JS files by relative path. Returns the single-version export Takaro would import.
+ * Unknown `module.json` keys are ignored.
+ */
+export declare function loadModuleDirectory(dir: string | URL): ModuleExport;
+//# sourceMappingURL=loadModule.d.ts.map

package/dist/loadModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadModule.d.ts","sourceRoot":"","sources":["../src/loadModule.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EAQb,MAAM,mBAAmB,CAAC;AA2C3B,qBAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAGlD;CACF;AAsFD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,YAAY,CA0FnE"}

package/dist/loadModule.js

@@ -0,0 +1,173 @@
+import { existsSync, readFileSync, realpathSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const EMPTY_CONFIG_SCHEMA = '{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{},"required":[],"additionalProperties":false}';
+export class ModuleLoadError extends Error {
+    constructor(moduleJsonPath, problem) {
+        super(`${moduleJsonPath}: ${problem}`);
+        this.name = 'ModuleLoadError';
+    }
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isInside(parent, candidate) {
+    return candidate === parent || candidate.startsWith(parent + path.sep);
+}
+class ModuleDirectory {
+    constructor(dir) {
+        this.root = path.resolve(dir instanceof URL ? fileURLToPath(dir) : dir);
+        this.moduleJsonPath = path.join(this.root, 'module.json');
+    }
+    fail(problem) {
+        throw new ModuleLoadError(this.moduleJsonPath, problem);
+    }
+    readModuleJson() {
+        if (!existsSync(this.root) || !statSync(this.root).isDirectory()) {
+            this.fail(`${this.root} is not a directory`);
+        }
+        if (!existsSync(this.moduleJsonPath)) {
+            this.fail('module.json not found');
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(readFileSync(this.moduleJsonPath, 'utf-8'));
+        }
+        catch (error) {
+            return this.fail(`not valid JSON: ${error.message}`);
+        }
+        if (!isPlainObject(parsed)) {
+            this.fail('must contain a JSON object');
+        }
+        return parsed;
+    }
+    readCode(relativePath, label) {
+        const absolute = path.resolve(this.root, relativePath);
+        if (!isInside(this.root, absolute)) {
+            this.fail(`path '${relativePath}' escapes the module directory (for ${label})`);
+        }
+        if (!existsSync(absolute)) {
+            this.fail(`file '${relativePath}' not found (for ${label}); expected at ${absolute}`);
+        }
+        const real = realpathSync(absolute);
+        if (!isInside(realpathSync(this.root), real)) {
+            this.fail(`path '${relativePath}' escapes the module directory via a symlink (for ${label})`);
+        }
+        return readFileSync(real, 'utf-8');
+    }
+    requireObjectField(mod, field) {
+        const value = mod[field];
+        if (value === undefined) {
+            return [];
+        }
+        if (!isPlainObject(value)) {
+            this.fail(`field '${field}' must be a plain object keyed by name`);
+        }
+        return Object.entries(value);
+    }
+    requireFunctionPath(def, label) {
+        if (!def.function) {
+            this.fail(`${label} is missing required field 'function' (path to a JS file)`);
+        }
+        return def.function;
+    }
+}
+function serialiseSchema(directory, value, field, fallback) {
+    if (value === undefined) {
+        return fallback;
+    }
+    if (!isPlainObject(value)) {
+        directory.fail(`field '${field}' must be a plain object`);
+    }
+    return Object.keys(value).length > 0 ? JSON.stringify(value) : fallback;
+}
+/**
+ * Reads a module directory in the registry source layout: a `module.json` whose components point
+ * at JS files by relative path. Returns the single-version export Takaro would import.
+ * Unknown `module.json` keys are ignored.
+ */
+export function loadModuleDirectory(dir) {
+    const directory = new ModuleDirectory(dir);
+    const mod = directory.readModuleJson();
+    if (typeof mod.name !== 'string' || mod.name === '') {
+        directory.fail("field 'name' is required");
+    }
+    const commands = directory.requireObjectField(mod, 'commands').map(([name, def]) => {
+        const label = `command '${name}'`;
+        return {
+            name,
+            trigger: def.trigger ?? name,
+            description: def.description ?? undefined,
+            helpText: def.helpText ?? 'No help text available',
+            function: directory.readCode(directory.requireFunctionPath(def, label), label),
+            arguments: def.arguments ?? [],
+            ...(def.requiredPermissions ? { requiredPermissions: def.requiredPermissions } : {}),
+        };
+    });
+    const hooks = directory.requireObjectField(mod, 'hooks').map(([name, def]) => {
+        const label = `hook '${name}'`;
+        if (!def.eventType) {
+            directory.fail(`${label} is missing required field 'eventType'`);
+        }
+        return {
+            name,
+            eventType: def.eventType,
+            description: def.description ?? undefined,
+            regex: def.regex ?? undefined,
+            function: directory.readCode(directory.requireFunctionPath(def, label), label),
+        };
+    });
+    const cronJobs = directory.requireObjectField(mod, 'cronJobs').map(([name, def]) => {
+        const label = `cronJob '${name}'`;
+        if (!def.temporalValue) {
+            directory.fail(`${label} is missing required field 'temporalValue'`);
+        }
+        return {
+            name,
+            temporalValue: def.temporalValue,
+            description: def.description ?? undefined,
+            function: directory.readCode(directory.requireFunctionPath(def, label), label),
+        };
+    });
+    const functions = directory
+        .requireObjectField(mod, 'functions')
+        .map(([name, def]) => {
+        const label = `function '${name}'`;
+        return { name, function: directory.readCode(directory.requireFunctionPath(def, label), label) };
+    });
+    const shopActions = directory
+        .requireObjectField(mod, 'shopActions')
+        .map(([name, def]) => {
+        const label = `shopAction '${name}'`;
+        return {
+            name,
+            description: def.description ?? undefined,
+            function: directory.readCode(directory.requireFunctionPath(def, label), label),
+        };
+    });
+    const defaultSystemConfig = mod.defaultSystemConfig;
+    if (defaultSystemConfig !== undefined && !isPlainObject(defaultSystemConfig)) {
+        directory.fail("field 'defaultSystemConfig' must be a plain object");
+    }
+    return {
+        name: mod.name,
+        author: mod.author ?? 'Unknown',
+        supportedGames: mod.supportedGames ?? ['all'],
+        versions: [
+            {
+                tag: mod.version ?? 'latest',
+                description: mod.description ?? 'No description',
+                configSchema: serialiseSchema(directory, mod.config, 'config', EMPTY_CONFIG_SCHEMA),
+                uiSchema: serialiseSchema(directory, mod.uiSchema, 'uiSchema', '{}'),
+                ...(defaultSystemConfig ? { defaultSystemConfig: JSON.stringify(defaultSystemConfig) } : {}),
+                commands,
+                hooks,
+                cronJobs,
+                functions,
+                permissions: mod.permissions ?? [],
+                shopActions,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=loadModule.js.map

package/dist/loadModule.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,22 @@
+export { createModuleTest, ModuleTest } from './moduleTest.js';
+export type { IModuleTest, ModuleInstallSpec, CommandRunOptions, HookRunOptions, PlayerSpec } from './moduleTest.js';
+export { createFakeClient, ok, paginated, single, MissingFixtureError, UnsupportedQueryError } from './fakeClient.js';
+export { UnstubbedMethodError } from './stubbedClient.js';
+export type { ClientStubs, ControllerKey } from './stubbedClient.js';
+export type { FakeClient, FakeClientOptions, PageMeta, RecordedMessage } from './fakeClient.js';
+export { VariableStore, VariableConflictError, VariableNotFoundError } from './variableStore.js';
+export type { VariableSeed } from './variableStore.js';
+export { CurrencyLedger, InsufficientFundsError } from './currencyLedger.js';
+export { createPlayerFixture, createUserFixture } from './fixtures.js';
+export type { PermissionFixture, PlatformIds, PlayerFixture, PlayerFixtureOptions, PlayerPermission, UserFixtureOptions, } from './fixtures.js';
+export { installModule, latestVersionOf, systemConfigOf } from './installation.js';
+export type { InstallationOptions, ModuleInstallation } from './installation.js';
+export { loadModuleDirectory, ModuleLoadError } from './loadModule.js';
+export type { ModuleExport, ModuleExportCommand, ModuleExportCommandArgument, ModuleExportCronJob, ModuleExportFunction, ModuleExportHook, ModuleExportPermission, ModuleExportShopAction, ModuleExportVersion, ModuleSource, } from './moduleExport.js';
+export { InvalidSystemConfigError, InvalidUserConfigError, resolveSystemConfig, resolveUserConfig } from './config.js';
+export type { SystemConfig, SystemConfigOverrides } from './config.js';
+export { applyArgumentDefaults, buildCommandData, buildCronJobData, buildHookData, buildShopActionData, classifyTriggerData, matchingTriggerKinds, toJobPayload, } from './triggers.js';
+export type { CommandArguments, TriggerContext, TriggerData, TriggerKind } from './triggers.js';
+export { buildContextOverride } from './intrinsics.js';
+export type { IntrinsicsOptions } from './intrinsics.js';
+//# sourceMappingURL=main.d.ts.map