@innovatorstack/harness 0.0.0-stage → 0.1.1

package/dist/harness/configuration.js

@@ -0,0 +1,279 @@
+import { stat } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { clockSettings } from "../controls/clock.js";
+import { idSettings } from "../controls/ids.js";
+import { setOwn } from "../core/data.js";
+import { loadMocks, mockInputs } from "../mocks/configuration.js";
+import { resolvePackageFiles } from "../packages/files.js";
+import { AuthorizationMode } from "../platform/security/types.js";
+import { executorFactories, moduleFactories } from "./extensions.js";
+import { loadSetupModule } from "./setup-module.js";
+/** Managed paths follow the same config-directory semantics during execution and inspection. */
+export function resolveCSharpOptions(configuration) {
+    const options = configuration.settings.csharp === false ? {} : (configuration.settings.csharp ?? {});
+    const references = options.references?.map((path) => resolve(configuration.directory, path));
+    const cacheDirectory = options.cacheDirectory
+        ? resolve(configuration.directory, options.cacheDirectory)
+        : undefined;
+    return {
+        ...options,
+        ...(references ? { references } : {}),
+        ...(cacheDirectory ? { cacheDirectory } : {}),
+    };
+}
+export async function loadConfiguration(options) {
+    const resolved = await resolveSettings(options);
+    const { directory, configured, settings } = resolved;
+    const packages = await resolvePackages(resolved);
+    const fixtures = settings.fixtures ?? (await defaultFixtures(directory));
+    return {
+        harnessDirectory: resolved.harnessDirectory,
+        directory,
+        settings,
+        packages,
+        fixtures: fixtures.map((path) => resolve(directory, path)),
+        mocks: await loadMocks(directory, configured.mocks, options.mocks),
+    };
+}
+/** Package inspection shares configuration and discovery without starting world setup. */
+export async function loadPackageConfiguration(options, onError) {
+    return (await loadPackageSettings(options, onError)).packages;
+}
+/** Inspection reads shared settings without loading fixtures or constructing extensions. */
+export async function loadPackageSettings(options, onError) {
+    const resolved = await resolveSettings(options);
+    return { ...resolved, packages: await resolvePackages(resolved, onError) };
+}
+async function resolveSettings(options) {
+    const cwd = resolve(options.cwd ?? process.cwd());
+    const harnessDirectory = (await findHarnessDirectory(cwd)) ?? join(cwd, ".harness");
+    let directory = harnessDirectory;
+    let configured = {};
+    if (typeof options.config === "object") {
+        const candidate = options.config;
+        if (!isObject(candidate)) {
+            throw new Error("Harness config must be an object.");
+        }
+        configured = parseConfiguration(candidate, "inline configuration");
+    }
+    else {
+        const candidate = join(directory, "config.ts");
+        let path;
+        if (typeof options.config === "string") {
+            path = resolve(cwd, options.config);
+        }
+        else if (await Bun.file(candidate).exists()) {
+            path = candidate;
+        }
+        if (path) {
+            directory = dirname(path);
+            const imported = await loadSetupModule(path);
+            if (!isObject(imported) || !isObject(imported.default)) {
+                throw new Error(`${path} must default-export a Harness configuration object.`);
+            }
+            configured = parseConfiguration(imported.default, path);
+        }
+        else if (typeof options.config === "string") {
+            throw new TypeError(`Harness configuration '${options.config}' does not exist.`);
+        }
+    }
+    const overrides = Object.fromEntries(Object.entries(options).filter(([name]) => name !== "cwd" && name !== "config"));
+    const merged = { ...configured, ...overrides };
+    if (typeof configured.csharp === "object" && typeof options.csharp === "object") {
+        merged.csharp = { ...configured.csharp, ...options.csharp };
+    }
+    const settings = parseConfiguration(merged, "configuration overrides");
+    return { directory, harnessDirectory, configured, settings };
+}
+async function resolvePackages(resolved, onError) {
+    const { directory, harnessDirectory, settings } = resolved;
+    const automaticPackages = await defaultPackages(harnessDirectory, onError);
+    const additionalPackages = await resolvePackageFiles((settings.packages ?? []).map((path) => ({ path: resolve(directory, path) })), onError ? { onError } : {});
+    // An additional path may overlap the conventional directory; import each physical file once.
+    return [...new Set([...automaticPackages, ...additionalPackages])];
+}
+async function findHarnessDirectory(start) {
+    let directory = start;
+    while (true) {
+        const candidate = join(directory, ".harness");
+        if (await exists(candidate)) {
+            return candidate;
+        }
+        const parent = dirname(directory);
+        if (parent === directory) {
+            return undefined;
+        }
+        directory = parent;
+    }
+}
+async function defaultPackages(directory, onError) {
+    const path = join(directory, "packages");
+    if (!(await exists(path))) {
+        return [];
+    }
+    return await resolvePackageFiles([{ path }], {
+        allowEmptyDirectories: true,
+        ...(onError ? { onError } : {}),
+    });
+}
+async function defaultFixtures(directory) {
+    const paths = [];
+    for (const name of ["fixtures.ts", "fixtures"]) {
+        const path = join(directory, name);
+        if (await exists(path)) {
+            paths.push(path);
+        }
+    }
+    return paths;
+}
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function paths(value, name) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!Array.isArray(value) ||
+        value.length > 20_000 ||
+        !value.every((path) => typeof path === "string" && path.length > 0)) {
+        throw new Error(`Harness '${name}' must be an array of non-empty paths.`);
+    }
+    return value;
+}
+function parseConfiguration(value, path) {
+    validateConfigurationKeys(value, path);
+    const configuration = {};
+    const clock = clockSettings(value.clock);
+    const ids = idSettings(value.ids);
+    if (clock !== undefined) {
+        configuration.clock = clock;
+    }
+    if (ids !== undefined) {
+        configuration.ids = ids;
+    }
+    const packages = paths(value.packages, "packages");
+    const fixtures = paths(value.fixtures, "fixtures");
+    if (packages) {
+        configuration.packages = packages;
+    }
+    if (fixtures) {
+        configuration.fixtures = fixtures;
+    }
+    if (value.modules !== undefined) {
+        configuration.modules = moduleFactories(value.modules);
+    }
+    if (value.executors !== undefined) {
+        configuration.executors = executorFactories(value.executors);
+    }
+    if (value.mocks !== undefined) {
+        configuration.mocks = mockInputs(value.mocks);
+    }
+    if (value.csharp === false) {
+        configuration.csharp = false;
+    }
+    else if (value.csharp !== undefined) {
+        configuration.csharp = parseCSharp(value.csharp);
+    }
+    if (value.authorization === AuthorizationMode.Native) {
+        configuration.authorization = AuthorizationMode.Native;
+    }
+    else if (value.authorization === AuthorizationMode.Unchecked) {
+        configuration.authorization = AuthorizationMode.Unchecked;
+    }
+    else if (isAuthorization(value.authorization)) {
+        const authorize = value.authorization;
+        configuration.authorization = async (request) => {
+            await authorize(request);
+        };
+    }
+    else if (value.authorization !== undefined) {
+        throw new Error("Harness authorization must be an AuthorizationMode or a policy callback.");
+    }
+    const session = parseSession(value.session);
+    if (session) {
+        configuration.session = session;
+    }
+    return configuration;
+}
+function parseCSharp(value) {
+    if (!isObject(value)) {
+        throw new Error("Harness csharp must be an options object or false.");
+    }
+    const options = {};
+    for (const key of ["dotnet", "cacheDirectory"]) {
+        const entry = value[key];
+        if (entry !== undefined) {
+            if (typeof entry !== "string") {
+                throw new TypeError(`csharp.${key} must be a string.`);
+            }
+            options[key] = entry;
+        }
+    }
+    const references = paths(value.references, "csharp.references");
+    if (references) {
+        options.references = references;
+    }
+    if (value.timeoutMs !== undefined) {
+        if (typeof value.timeoutMs !== "number" ||
+            !Number.isSafeInteger(value.timeoutMs) ||
+            value.timeoutMs <= 0 ||
+            value.timeoutMs > 2_147_483_647) {
+            throw new Error("csharp.timeoutMs must be a positive number.");
+        }
+        options.timeoutMs = value.timeoutMs;
+    }
+    return options;
+}
+function parseSession(value) {
+    if (value !== undefined) {
+        if (!isObject(value) || !isObject(value.user)) {
+            throw new Error("Harness session.user must select an imported User record.");
+        }
+        const user = {};
+        for (const [key, entry] of Object.entries(value.user)) {
+            if (entry !== null &&
+                typeof entry !== "string" &&
+                (typeof entry !== "number" || !Number.isFinite(entry))) {
+                throw new Error(`Invalid User selector '${key}'.`);
+            }
+            setOwn(user, key, entry);
+        }
+        return { user };
+    }
+    return undefined;
+}
+function validateConfigurationKeys(value, path) {
+    const supported = new Set([
+        "clock",
+        "ids",
+        "packages",
+        "fixtures",
+        "csharp",
+        "authorization",
+        "session",
+        "modules",
+        "executors",
+        "mocks",
+    ]);
+    for (const key of Object.keys(value)) {
+        if (!supported.has(key)) {
+            throw new Error(`Unknown Harness configuration key '${key}' in ${path}.`);
+        }
+    }
+}
+function isAuthorization(value) {
+    return typeof value === "function";
+}
+//# sourceMappingURL=configuration.js.map

package/dist/harness/configuration.js.map

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

package/dist/harness/create.d.ts

@@ -0,0 +1,5 @@
+import type { HarnessOptions } from "./configuration.js";
+import { Harness } from "./world.js";
+/** Open a world from shared .harness configuration, with optional local overrides. */
+export declare function createHarness(options?: HarnessOptions): Promise<Harness>;
+//# sourceMappingURL=create.d.ts.map

package/dist/harness/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/harness/create.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,oBAAoB,CAAC;AAMzE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,sFAAsF;AACtF,wBAAsB,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAqDlF"}

package/dist/harness/create.js

@@ -0,0 +1,156 @@
+import { join } from "node:path";
+import { captureEngine, openEngine } from "../engine/instance.js";
+import { loadFixtureRecords } from "../fixtures/module.js";
+import { csharp } from "../methods/csharp/index.js";
+import { loadAmlDocuments } from "../packages/files.js";
+import { PlatformError } from "../platform/errors.js";
+import { matches } from "../platform/query.js";
+import { SqliteStorage } from "../storage/sqlite/storage.js";
+import { loadConfiguration, resolveCSharpOptions } from "./configuration.js";
+import { loadTypeScriptFixtures, readTypeScriptFixtures, splitFixturePaths } from "./fixtures.js";
+import { runtimeIdentity } from "./runtime-identity.js";
+import { setupCache } from "./setup-cache.js";
+import { readSetupImage, writeSetupImage } from "./setup-image.js";
+import { parseSetupSources, readSetupSources, setupKey } from "./setup-inputs.js";
+import { Harness } from "./world.js";
+/** Open a world from shared .harness configuration, with optional local overrides. */
+export async function createHarness(options = {}) {
+    const configuration = await loadConfiguration(options);
+    const fixtures = await splitFixturePaths(configuration.fixtures);
+    if ((configuration.settings.modules?.length ?? 0) > 0 ||
+        typeof configuration.settings.authorization === "function") {
+        const packages = await loadAmlDocuments(configuration.packages.map((path) => ({ path })));
+        const records = await loadAmlDocuments(fixtures.aml.map((path) => ({ path })));
+        const engine = createConfiguredEngine(configuration, { packages, fixtures: records });
+        return await finishSetup(engine, async () => {
+            await loadTypeScriptFixtures(engine, fixtures.typescript);
+            engine.checkpoint();
+        });
+    }
+    const sources = await readSetupSources([...configuration.packages, ...fixtures.aml]);
+    const records = await readTypeScriptFixtures(fixtures.typescript);
+    const key = setupKey(configuration, sources, configuration.packages.length, records, await runtimeIdentity());
+    const path = join(configuration.harnessDirectory, "cache", "setup.bin");
+    const image = setupCache.get(key) ?? (await readSetupImage(path, key)) ?? setupCache.get(key);
+    if (image) {
+        setupCache.put(key, image);
+    }
+    const engine = createConfiguredEngine(configuration, image ?? {
+        packages: parseSetupSources(sources.slice(0, configuration.packages.length)),
+        fixtures: parseSetupSources(sources.slice(configuration.packages.length)),
+    });
+    return await finishSetup(engine, async () => {
+        if (!image) {
+            if (fixtures.typescript.length > 0) {
+                engine.runtime.executeSync(loadFixtureRecords, records);
+            }
+            engine.checkpoint();
+            setupCache.put(key, captureEngine(engine));
+            await writeSetupImage(path, key, captureEngine(engine));
+        }
+    });
+}
+async function finishSetup(engine, prepare) {
+    try {
+        await prepare();
+        return new Harness(engine);
+    }
+    catch (error) {
+        try {
+            engine.close();
+        }
+        catch (cleanup) {
+            throw new AggregateError([error, cleanup], "Harness setup and cleanup failed.", {
+                cause: cleanup,
+            });
+        }
+        throw error;
+    }
+}
+function createConfiguredEngine(configuration, setup) {
+    const storage = new SqliteStorage();
+    const executors = [];
+    const modules = [];
+    let engine;
+    let transferred = false;
+    try {
+        if (configuration.settings.csharp !== false) {
+            executors.push(csharp(resolveCSharpOptions(configuration)));
+        }
+        for (const createExecutor of configuration.settings.executors ?? []) {
+            executors.push(createExecutor());
+        }
+        for (const createModule of configuration.settings.modules ?? []) {
+            modules.push(createModule(storage));
+        }
+        transferred = true;
+        engine = openEngine({
+            storage,
+            ...(configuration.settings.clock ? { clock: configuration.settings.clock } : {}),
+            ...(configuration.settings.ids ? { ids: configuration.settings.ids } : {}),
+            executors,
+            mocks: configuration.mocks,
+            modules,
+            ...(configuration.settings.authorization !== undefined
+                ? { authorization: configuration.settings.authorization }
+                : {}),
+            userId: () => resolveUser(configuration, storage),
+        }, setup);
+        return engine;
+    }
+    catch (error) {
+        try {
+            if (engine) {
+                engine.close();
+            }
+            else {
+                closeUnattached(storage, transferred ? [] : modules, transferred ? [] : executors);
+            }
+        }
+        catch (cleanupError) {
+            throw new AggregateError([error, cleanupError], "Harness setup and cleanup failed.", {
+                cause: cleanupError,
+            });
+        }
+        throw error;
+    }
+}
+function resolveUser(configuration, storage) {
+    const selector = configuration.settings.session?.user;
+    if (!selector || Object.keys(selector).length === 0) {
+        throw new PlatformError("SessionRequired", "This Method requires session.user in .harness/config.ts.");
+    }
+    const definition = storage.getItemType("User");
+    if (!definition) {
+        throw new PlatformError("MissingItemType", "The User ItemType is not imported.");
+    }
+    const users = storage
+        .listItems("User")
+        .filter((user) => Object.entries(selector).every(([name, value]) => matches(storage, definition, user, { name, value })));
+    const user = users[0];
+    if (users.length !== 1 || !user) {
+        throw new PlatformError("SessionResolution", `session.user matched ${users.length} records; expected one.`);
+    }
+    return user.id;
+}
+function closeUnattached(storage, modules, executors) {
+    const failures = [];
+    for (const resource of [...modules, ...executors].reverse()) {
+        try {
+            resource.dispose?.();
+        }
+        catch (error) {
+            failures.push(error);
+        }
+    }
+    try {
+        storage.close();
+    }
+    catch (error) {
+        failures.push(error);
+    }
+    if (failures.length > 0) {
+        throw new AggregateError(failures, "Unattached setup resource cleanup failed.");
+    }
+}
+//# sourceMappingURL=create.js.map

package/dist/harness/create.js.map

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

package/dist/harness/extensions.d.ts

@@ -0,0 +1,8 @@
+import type { HarnessModule } from "../core/types.js";
+import type { MethodExecutor } from "../methods/types.js";
+import type { HarnessStorage } from "../storage/types.js";
+export type ModuleFactory = (storage: HarnessStorage) => HarnessModule;
+export type ExecutorFactory = () => MethodExecutor;
+export declare function moduleFactories(value: unknown): readonly ModuleFactory[];
+export declare function executorFactories(value: unknown): readonly ExecutorFactory[];
+//# sourceMappingURL=extensions.d.ts.map

package/dist/harness/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../src/harness/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,aAAa,CAAC;AAEvE,MAAM,MAAM,eAAe,GAAG,MAAM,cAAc,CAAC;AAEnD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,aAAa,EAAE,CAUxE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,eAAe,EAAE,CAU5E"}

package/dist/harness/extensions.js

@@ -0,0 +1,58 @@
+export function moduleFactories(value) {
+    return factories(value, "modules").map((create) => (storage) => {
+        const module = create(storage);
+        if (!isModule(module)) {
+            throw new Error("A Harness module factory must return a valid module.");
+        }
+        return module;
+    });
+}
+export function executorFactories(value) {
+    return factories(value, "executors").map((create) => () => {
+        const executor = create();
+        if (!isMethodExecutor(executor)) {
+            throw new Error("A Harness executor factory must return a language executor.");
+        }
+        return executor;
+    });
+}
+function factories(value, name) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value) || value.length > 1000) {
+        throw new TypeError(`Harness '${name}' must be an array of factories.`);
+    }
+    return value.map((factory) => {
+        if (!isFactory(factory)) {
+            throw new TypeError(`Each Harness '${name}' entry must create a fresh instance.`);
+        }
+        return (...arguments_) => factory(...arguments_);
+    });
+}
+function isMethodExecutor(value) {
+    return (isObject(value) &&
+        typeof value.language === "string" &&
+        typeof value.execute === "function" &&
+        optionalFunction(value.reset) &&
+        optionalFunction(value.dispose));
+}
+function isModule(value) {
+    return (isObject(value) &&
+        typeof value.id === "string" &&
+        typeof value.setup === "function" &&
+        optionalFunction(value.reset) &&
+        optionalFunction(value.dispose) &&
+        (value.requires === undefined ||
+            (Array.isArray(value.requires) && value.requires.every((id) => typeof id === "string"))));
+}
+function optionalFunction(value) {
+    return value === undefined || typeof value === "function";
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null;
+}
+function isFactory(value) {
+    return typeof value === "function";
+}
+//# sourceMappingURL=extensions.js.map

package/dist/harness/extensions.js.map

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

package/dist/harness/fixtures.d.ts

@@ -0,0 +1,9 @@
+import type { Engine } from "../engine.js";
+import type { Fixtures } from "../fixtures/types.js";
+export declare function splitFixturePaths(paths: readonly string[]): Promise<{
+    readonly aml: readonly string[];
+    readonly typescript: readonly string[];
+}>;
+export declare function loadTypeScriptFixtures(engine: Engine, paths: readonly string[]): Promise<void>;
+export declare function readTypeScriptFixtures(paths: readonly string[]): Promise<Fixtures>;
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/harness/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/harness/fixtures.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAiB,QAAQ,EAAgB,MAAM,sBAAsB,CAAC;AAGlF,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC;IACvE,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C,CAAC,CAyDD;AAED,wBAAsB,sBAAsB,CACxC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkCxF"}