@sanoma-ai/workflows 0.8.2 → 0.9.0

package/src/worker.ts

@@ -93,12 +93,6 @@ export interface WorkerOptions {
    * it off, on a database of its own, so no schedule is applied there to start a live run.
    */
   schedules?: boolean;
-  /**
-   * The config as the caller resolved it (`resolveConfig(config, options)`), for a worker that
-   * shares its drivers with the caller: the instance fakes of `fakes: "instance"`, which a demo's
-   * client and reseed call too. The caller closes its `dataStore`, as it made it.
-   */
-  resolved?: ResolvedConfig;
 }
 
 /**
@@ -110,7 +104,7 @@ export interface WorkerOptions {
  */
 export async function startWorker(config: SanomaConfig, options: WorkerOptions = {}): Promise<Worker> {
   // Check everything before touching the state a running worker reads.
-  const resolved = options.resolved ?? resolveConfig(config);
+  const resolved = resolveConfig(config);
   setLogLevel(options.logLevel);
   // Read once, when it matters: a worker stops itself, registering its next deadline there, only
   // when its caller hears it stop (`onStopped`).
@@ -132,7 +126,6 @@ export async function startWorker(config: SanomaConfig, options: WorkerOptions =
     ops: resolved.ops,
     drivers: resolved.drivers,
     fakes: resolved.fakes,
-    ...(resolved.instanceFakes && { instanceFakes: resolved.instanceFakes }),
     ...(resolved.scenarios && { scenarios: resolved.scenarios }),
     ...(options.source && { source: options.source }),
     types: resolved.types,
@@ -174,7 +167,7 @@ export async function startWorker(config: SanomaConfig, options: WorkerOptions =
           () => credentials.close(),
           () => secrets.close(),
           () => ledger.close(),
-          async () => (options.resolved ? undefined : resolved.dataStore?.close()),
+          async () => resolved.dataStore?.close(),
         ]) {
           await close().catch((error: unknown) => (failed ??= { error }));
         }

package/dist/demo.d.ts

@@ -1,39 +0,0 @@
-import type { SanomaClient } from "./client.ts";
-import type { ResolvedConfig } from "./config.ts";
-import { type Moment } from "./scenario.ts";
-/** What the last `reseed` of an instance did: what the demo's banner shows. */
-export interface DemoState {
-    /** When it was seeded, as an ISO timestamp. */
-    seededAt: string;
-    /** The worlds applied, by scenario name. */
-    worlds: string[];
-    /** Each moment started and left waiting: who it is for, where they land, its scenario and its run. */
-    moments: (Moment & {
-        scenario: string;
-        runId: string;
-    })[];
-    /** What could not be done, one line each: a feature file that did not load, a world or a moment that failed. */
-    problems: string[];
-}
-/**
- * A half of a demo's seed (`reseed`'s `only`): what goes into its `database` (the runs cancelled,
- * `sanoma_data` emptied, the worlds' collection records, the moments' runs), or into its `memory`
- * (the instance's fakes reset, the worlds' vendor objects and calls). A copy of a seeded database
- * holds the first half but not the second, which a process over it applies to its own fakes.
- */
-export type SeedHalf = "database" | "memory";
-/**
- * Seeds the demo instance afresh: cancels the app's unfinished runs (`cancelUnfinished`: the last
- * seed's moments among them), empties the collections' table, resets the instance's fakes,
- * applies every world (a scenario with no `When`) to the instance (`applyGivens`: its records
- * saved through the collections' driver, its vendor objects put in the fakes), then starts each
- * moment as a sandbox run by its person, left undriven, so its first approval waits for them.
- * `only` seeds one half (`SeedHalf`). `resolved` is the resolution the worker and `client` run
- * on, made with `fakes: "instance"`. A world or a moment that fails is a problem in the state it
- * returns, and the rest go on.
- */
-export declare function reseed(client: SanomaClient, resolved: ResolvedConfig, { only }?: {
-    only?: SeedHalf;
-}): Promise<DemoState>;
-/** What the instance's last `reseed` did, or undefined before its first. */
-export declare const demoState: (resolved: ResolvedConfig) => DemoState | undefined;

package/dist/demo.js

@@ -1,87 +0,0 @@
-import { DATA_TABLE } from "./db.js";
-import { applyGivens } from "./sandbox.js";
-import { loadScenarios } from "./scenario.js";
-import { memorySecrets } from "./secret.js";
-import { DATA_VENDOR, errorMessage } from "./shared.js";
-/** Each instance's last reseed, by its resolution. */
-const states = new WeakMap();
-/** Which half a world's `Given` goes to: a collection's operation the database, anything else memory; a fault both, each refusing it. */
-const halfOf = (g, resolved) => "fault" in g ? undefined : "op" in g && resolved.ops.get(g.op)?.vendor === DATA_VENDOR ? "database" : "memory";
-/**
- * Seeds the demo instance afresh: cancels the app's unfinished runs (`cancelUnfinished`: the last
- * seed's moments among them), empties the collections' table, resets the instance's fakes,
- * applies every world (a scenario with no `When`) to the instance (`applyGivens`: its records
- * saved through the collections' driver, its vendor objects put in the fakes), then starts each
- * moment as a sandbox run by its person, left undriven, so its first approval waits for them.
- * `only` seeds one half (`SeedHalf`). `resolved` is the resolution the worker and `client` run
- * on, made with `fakes: "instance"`. A world or a moment that fails is a problem in the state it
- * returns, and the rest go on.
- */
-export async function reseed(client, resolved, { only } = {}) {
-    const fakes = resolved.instanceFakes;
-    if (!fakes)
-        throw new Error('reseed seeds an instance on fakes: resolve its config with `fakes: "instance"`');
-    const into = (half) => only === undefined || only === half;
-    // Read first, so scenarios that cannot be read at all leave the instance as it was.
-    const { scenarios, errors } = await loadScenarios(resolved);
-    if (into("database")) {
-        // The last seed's moments, and whatever a visitor started since, end here: nothing is kept.
-        await client.cancelUnfinished();
-        if (resolved.dataStore)
-            await (await resolved.dataStore.db()).query(`TRUNCATE ${DATA_TABLE}`);
-    }
-    if (into("memory"))
-        for (const fake of fakes.values())
-            fake.reset();
-    const state = {
-        seededAt: new Date().toISOString(),
-        worlds: [],
-        moments: [],
-        problems: errors.map((e) => e.message),
-    };
-    const secrets = memorySecrets();
-    for (const world of scenarios.filter((s) => s.workflow === undefined)) {
-        // Each Given keeps its place in the world, so its call's idempotency key is the same in either half.
-        const kept = [...world.given.entries()].filter(([, g]) => {
-            const half = halfOf(g, resolved);
-            return half === undefined || into(half);
-        });
-        try {
-            await applyGivens({ name: world.name, given: kept.map(([, g]) => g) }, {
-                kind: "instance",
-                drivers: resolved.drivers,
-                fakes,
-                ops: resolved.ops,
-                call: (i, opId) => ({
-                    idempotencyKey: `world:${world.name}:${kept[i][0]}`,
-                    runId: `world:${world.name}`,
-                    opId,
-                    attempt: 1,
-                    secrets,
-                    // Who its records are by: whoever it says is acting, else the runtime's own agent.
-                    by: world.startedBy ?? "scenarios",
-                }),
-            });
-            state.worlds.push(world.name);
-        }
-        catch (err) {
-            state.problems.push(`world "${world.name}": ${errorMessage(err)}`);
-        }
-    }
-    for (const s of into("database") ? scenarios : []) {
-        if (!s.moment || s.workflow === undefined)
-            continue;
-        try {
-            const runId = await client.start(s.workflow, s.input, { sandbox: s.name, startedBy: s.moment.person });
-            state.moments.push({ ...s.moment, scenario: s.name, runId });
-        }
-        catch (err) {
-            state.problems.push(`moment "${s.name}": ${errorMessage(err)}`);
-        }
-    }
-    states.set(resolved, state);
-    return state;
-}
-/** What the instance's last `reseed` did, or undefined before its first. */
-export const demoState = (resolved) => states.get(resolved);
-//# sourceMappingURL=demo.js.map

package/dist/demo.js.map

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

package/src/demo.ts

@@ -1,118 +0,0 @@
-import type { SanomaClient } from "./client.ts";
-import type { ResolvedConfig } from "./config.ts";
-import { DATA_TABLE } from "./db.ts";
-import { applyGivens } from "./sandbox.ts";
-import { type Given, loadScenarios, type Moment } from "./scenario.ts";
-import { memorySecrets } from "./secret.ts";
-import { DATA_VENDOR, errorMessage } from "./shared.ts";
-
-/*
- * A demo: a company repo run on its connectors' fakes, with the world its scenarios describe.
- * Re-exported from `@sanoma-ai/workflows/scenarios`, server-side, since it loads Cucumber.
- */
-
-/** What the last `reseed` of an instance did: what the demo's banner shows. */
-export interface DemoState {
-  /** When it was seeded, as an ISO timestamp. */
-  seededAt: string;
-  /** The worlds applied, by scenario name. */
-  worlds: string[];
-  /** Each moment started and left waiting: who it is for, where they land, its scenario and its run. */
-  moments: (Moment & { scenario: string; runId: string })[];
-  /** What could not be done, one line each: a feature file that did not load, a world or a moment that failed. */
-  problems: string[];
-}
-
-/** Each instance's last reseed, by its resolution. */
-const states = new WeakMap<ResolvedConfig, DemoState>();
-
-/**
- * A half of a demo's seed (`reseed`'s `only`): what goes into its `database` (the runs cancelled,
- * `sanoma_data` emptied, the worlds' collection records, the moments' runs), or into its `memory`
- * (the instance's fakes reset, the worlds' vendor objects and calls). A copy of a seeded database
- * holds the first half but not the second, which a process over it applies to its own fakes.
- */
-export type SeedHalf = "database" | "memory";
-
-/** Which half a world's `Given` goes to: a collection's operation the database, anything else memory; a fault both, each refusing it. */
-const halfOf = (g: Given, resolved: ResolvedConfig): SeedHalf | undefined =>
-  "fault" in g ? undefined : "op" in g && resolved.ops.get(g.op)?.vendor === DATA_VENDOR ? "database" : "memory";
-
-/**
- * Seeds the demo instance afresh: cancels the app's unfinished runs (`cancelUnfinished`: the last
- * seed's moments among them), empties the collections' table, resets the instance's fakes,
- * applies every world (a scenario with no `When`) to the instance (`applyGivens`: its records
- * saved through the collections' driver, its vendor objects put in the fakes), then starts each
- * moment as a sandbox run by its person, left undriven, so its first approval waits for them.
- * `only` seeds one half (`SeedHalf`). `resolved` is the resolution the worker and `client` run
- * on, made with `fakes: "instance"`. A world or a moment that fails is a problem in the state it
- * returns, and the rest go on.
- */
-export async function reseed(
-  client: SanomaClient,
-  resolved: ResolvedConfig,
-  { only }: { only?: SeedHalf } = {},
-): Promise<DemoState> {
-  const fakes = resolved.instanceFakes;
-  if (!fakes) throw new Error('reseed seeds an instance on fakes: resolve its config with `fakes: "instance"`');
-  const into = (half: SeedHalf) => only === undefined || only === half;
-  // Read first, so scenarios that cannot be read at all leave the instance as it was.
-  const { scenarios, errors } = await loadScenarios(resolved);
-  if (into("database")) {
-    // The last seed's moments, and whatever a visitor started since, end here: nothing is kept.
-    await client.cancelUnfinished();
-    if (resolved.dataStore) await (await resolved.dataStore.db()).query(`TRUNCATE ${DATA_TABLE}`);
-  }
-  if (into("memory")) for (const fake of fakes.values()) fake.reset();
-  const state: DemoState = {
-    seededAt: new Date().toISOString(),
-    worlds: [],
-    moments: [],
-    problems: errors.map((e) => e.message),
-  };
-  const secrets = memorySecrets();
-  for (const world of scenarios.filter((s) => s.workflow === undefined)) {
-    // Each Given keeps its place in the world, so its call's idempotency key is the same in either half.
-    const kept = [...world.given.entries()].filter(([, g]) => {
-      const half = halfOf(g, resolved);
-      return half === undefined || into(half);
-    });
-    try {
-      await applyGivens(
-        { name: world.name, given: kept.map(([, g]) => g) },
-        {
-          kind: "instance",
-          drivers: resolved.drivers,
-          fakes,
-          ops: resolved.ops,
-          call: (i, opId) => ({
-            idempotencyKey: `world:${world.name}:${kept[i]![0]}`,
-            runId: `world:${world.name}`,
-            opId,
-            attempt: 1,
-            secrets,
-            // Who its records are by: whoever it says is acting, else the runtime's own agent.
-            by: world.startedBy ?? "scenarios",
-          }),
-        },
-      );
-      state.worlds.push(world.name);
-    } catch (err) {
-      state.problems.push(`world "${world.name}": ${errorMessage(err)}`);
-    }
-  }
-  for (const s of into("database") ? scenarios : []) {
-    if (!s.moment || s.workflow === undefined) continue;
-    try {
-      const runId = await client.start(s.workflow, s.input, { sandbox: s.name, startedBy: s.moment.person });
-      state.moments.push({ ...s.moment, scenario: s.name, runId });
-    } catch (err) {
-      state.problems.push(`moment "${s.name}": ${errorMessage(err)}`);
-    }
-  }
-  states.set(resolved, state);
-  return state;
-}
-
-/** What the instance's last `reseed` did, or undefined before its first. */
-export const demoState = (resolved: ResolvedConfig): DemoState | undefined => states.get(resolved);