@elaraai/e3-types 1.0.79 → 1.0.81

package/dist/src/stream.spec.js

@@ -1,60 +0,0 @@
-/**
- * Copyright (c) 2025 Elara AI Pty Ltd
- * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
- */
-/**
- * The stream and merge command builders (issue #770): the argv a stream
- * execution spawns for each merge mode and streamed-input choice, and the
- * argv a merge execution spawns over sorted partials within a key range.
- */
-import { describe, it } from 'node:test';
-import assert from 'node:assert/strict';
-import { variant } from '@elaraai/east';
-import { mergeCommandIr, streamCommandIr } from './stream.js';
-const EAST_C = variant('east_c', { platforms: ['east-c-std'] });
-/** The argv a stream command evaluates to for the staged `inputs`. */
-function argvOf(runner, spec, inputs) {
-    return streamCommandIr(runner, spec).compile([])(inputs, 'out.beast2');
-}
-/** The argv a merge command evaluates to for the staged `inputs`. */
-function mergeArgvOf(runner, mode, inputs) {
-    return mergeCommandIr(runner, mode).compile([])(inputs, 'out.beast2');
-}
-describe('streamCommandIr', () => {
-    it('builds a folding dict argv: the merge IR as --merge, the first input streamed', () => {
-        assert.deepEqual(argvOf(EAST_C, { emit: 'dict', merge: 'function', stream: 'first' }, ['body.beast2', 'merge.beast2', 'rows.beast2', 'other.beast2']), ['east-c', 'run', '-p', 'east-c-std', '--emit', 'dict', '--merge', 'merge.beast2', '--stream', '0',
-            '-i', 'rows.beast2', '-i', 'other.beast2', '-o', 'out.beast2', 'body.beast2']);
-    });
-    it('builds a union set argv streaming the first input', () => {
-        assert.deepEqual(argvOf(EAST_C, { emit: 'set', merge: 'union', stream: 'first' }, ['body.beast2', 'stream.beast2', 'other.beast2']), ['east-c', 'run', '-p', 'east-c-std', '--emit', 'set', '--union', '--stream', '0',
-            '-i', 'stream.beast2', '-i', 'other.beast2', '-o', 'out.beast2', 'body.beast2']);
-    });
-    it('builds a producer argv with no merge flag and no streamed input', () => {
-        assert.deepEqual(argvOf(EAST_C, { emit: 'array', merge: 'none', stream: 'none' }, ['body.beast2', 'config.beast2']), ['east-c', 'run', '-p', 'east-c-std', '--emit', 'array', '-i', 'config.beast2', '-o', 'out.beast2', 'body.beast2']);
-    });
-    it('starts from the runner argv of every stock runtime', () => {
-        const node = variant('east_node', { platforms: ['@elaraai/east-node-std'] });
-        const argv = argvOf(node, { emit: 'set', merge: 'none', stream: 'first' }, ['body.beast2', 'rows.beast2']);
-        assert.deepEqual(argv.slice(0, 6), ['east-node', 'run', '-p', '@elaraai/east-node-std', '--emit', 'set']);
-    });
-});
-describe('mergeCommandIr', () => {
-    it('builds a dict merge argv: the merge IR as --merge, the key range as --range, every other input a partial', () => {
-        assert.deepEqual(mergeArgvOf(EAST_C, 'function', ['merge.beast2', 'range.beast2', 'p0.beast2', 'p1.beast2', 'p2.beast2']), ['east-c', 'merge', '-p', 'east-c-std', '--merge', 'merge.beast2', '--range', 'range.beast2',
-            '-i', 'p0.beast2', '-i', 'p1.beast2', '-i', 'p2.beast2', '-o', 'out.beast2']);
-    });
-    it('builds a set union argv: the key range first, every other input a partial', () => {
-        assert.deepEqual(mergeArgvOf(EAST_C, 'union', ['range.beast2', 'p0.beast2', 'p1.beast2']), ['east-c', 'merge', '-p', 'east-c-std', '--union', '--range', 'range.beast2', '-i', 'p0.beast2', '-i', 'p1.beast2', '-o', 'out.beast2']);
-    });
-    it('runs the merge command of every stock runtime', () => {
-        const py = variant('east_py', { platforms: ['east-py-std'] });
-        assert.deepEqual(mergeArgvOf(py, 'union', ['range.beast2', 'p0.beast2']).slice(0, 4), ['east-py', 'merge', '-p', 'east-py-std']);
-        const node = variant('east_node', { platforms: [] });
-        assert.deepEqual(mergeArgvOf(node, 'function', ['merge.beast2', 'range.beast2', 'p0.beast2']).slice(0, 2), ['east-node', 'merge']);
-    });
-    it('refuses a custom runner, which has no merge command', () => {
-        const custom = variant('custom', { command: ['uv', 'run', 'east-py', 'run'] });
-        assert.throws(() => mergeCommandIr(custom, 'union'), { message: 'a custom runner has no merge command' });
-    });
-});
-//# sourceMappingURL=stream.spec.js.map

package/dist/src/stream.spec.js.map

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

package/src/stream.spec.ts

@@ -1,88 +0,0 @@
-/**
- * Copyright (c) 2025 Elara AI Pty Ltd
- * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
- */
-
-/**
- * The stream and merge command builders (issue #770): the argv a stream
- * execution spawns for each merge mode and streamed-input choice, and the
- * argv a merge execution spawns over sorted partials within a key range.
- */
-
-import { describe, it } from 'node:test';
-import assert from 'node:assert/strict';
-import { variant } from '@elaraai/east';
-import { mergeCommandIr, streamCommandIr, type StreamCommandSpec } from './stream.js';
-import type { RunnerValue } from './runner.js';
-
-const EAST_C: RunnerValue = variant('east_c', { platforms: ['east-c-std'] });
-
-/** The argv a stream command evaluates to for the staged `inputs`. */
-function argvOf(runner: RunnerValue, spec: StreamCommandSpec, inputs: string[]): string[] {
-  return streamCommandIr(runner, spec).compile([])(inputs, 'out.beast2');
-}
-
-/** The argv a merge command evaluates to for the staged `inputs`. */
-function mergeArgvOf(runner: RunnerValue, mode: 'function' | 'union', inputs: string[]): string[] {
-  return mergeCommandIr(runner, mode).compile([])(inputs, 'out.beast2');
-}
-
-describe('streamCommandIr', () => {
-  it('builds a folding dict argv: the merge IR as --merge, the first input streamed', () => {
-    assert.deepEqual(
-      argvOf(EAST_C, { emit: 'dict', merge: 'function', stream: 'first' }, ['body.beast2', 'merge.beast2', 'rows.beast2', 'other.beast2']),
-      ['east-c', 'run', '-p', 'east-c-std', '--emit', 'dict', '--merge', 'merge.beast2', '--stream', '0',
-        '-i', 'rows.beast2', '-i', 'other.beast2', '-o', 'out.beast2', 'body.beast2'],
-    );
-  });
-
-  it('builds a union set argv streaming the first input', () => {
-    assert.deepEqual(
-      argvOf(EAST_C, { emit: 'set', merge: 'union', stream: 'first' }, ['body.beast2', 'stream.beast2', 'other.beast2']),
-      ['east-c', 'run', '-p', 'east-c-std', '--emit', 'set', '--union', '--stream', '0',
-        '-i', 'stream.beast2', '-i', 'other.beast2', '-o', 'out.beast2', 'body.beast2'],
-    );
-  });
-
-  it('builds a producer argv with no merge flag and no streamed input', () => {
-    assert.deepEqual(
-      argvOf(EAST_C, { emit: 'array', merge: 'none', stream: 'none' }, ['body.beast2', 'config.beast2']),
-      ['east-c', 'run', '-p', 'east-c-std', '--emit', 'array', '-i', 'config.beast2', '-o', 'out.beast2', 'body.beast2'],
-    );
-  });
-
-  it('starts from the runner argv of every stock runtime', () => {
-    const node: RunnerValue = variant('east_node', { platforms: ['@elaraai/east-node-std'] });
-    const argv = argvOf(node, { emit: 'set', merge: 'none', stream: 'first' }, ['body.beast2', 'rows.beast2']);
-    assert.deepEqual(argv.slice(0, 6), ['east-node', 'run', '-p', '@elaraai/east-node-std', '--emit', 'set']);
-  });
-});
-
-describe('mergeCommandIr', () => {
-  it('builds a dict merge argv: the merge IR as --merge, the key range as --range, every other input a partial', () => {
-    assert.deepEqual(
-      mergeArgvOf(EAST_C, 'function', ['merge.beast2', 'range.beast2', 'p0.beast2', 'p1.beast2', 'p2.beast2']),
-      ['east-c', 'merge', '-p', 'east-c-std', '--merge', 'merge.beast2', '--range', 'range.beast2',
-        '-i', 'p0.beast2', '-i', 'p1.beast2', '-i', 'p2.beast2', '-o', 'out.beast2'],
-    );
-  });
-
-  it('builds a set union argv: the key range first, every other input a partial', () => {
-    assert.deepEqual(
-      mergeArgvOf(EAST_C, 'union', ['range.beast2', 'p0.beast2', 'p1.beast2']),
-      ['east-c', 'merge', '-p', 'east-c-std', '--union', '--range', 'range.beast2', '-i', 'p0.beast2', '-i', 'p1.beast2', '-o', 'out.beast2'],
-    );
-  });
-
-  it('runs the merge command of every stock runtime', () => {
-    const py: RunnerValue = variant('east_py', { platforms: ['east-py-std'] });
-    assert.deepEqual(mergeArgvOf(py, 'union', ['range.beast2', 'p0.beast2']).slice(0, 4), ['east-py', 'merge', '-p', 'east-py-std']);
-    const node: RunnerValue = variant('east_node', { platforms: [] });
-    assert.deepEqual(mergeArgvOf(node, 'function', ['merge.beast2', 'range.beast2', 'p0.beast2']).slice(0, 2), ['east-node', 'merge']);
-  });
-
-  it('refuses a custom runner, which has no merge command', () => {
-    const custom: RunnerValue = variant('custom', { command: ['uv', 'run', 'east-py', 'run'] });
-    assert.throws(() => mergeCommandIr(custom, 'union'), { message: 'a custom runner has no merge command' });
-  });
-});

package/src/stream.ts

@@ -1,170 +0,0 @@
-/**
- * Copyright (c) 2025 Elara AI Pty Ltd
- * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
- */
-
-/**
- * The stream and merge commands (issue #770) — the builders of every argv a
- * stream execution spawns (an authored `streamTask`'s) and of the merge
- * command a partitioned task's keyed fan-in runs per key range, both built
- * at export time and carried in the package like any other command IR.
- */
-
-import { ArrayType, East, EastIR, StringType } from '@elaraai/east';
-import { runnerToArgv, type RunnerValue } from './runner.js';
-
-/**
- * How a stream execution's emit sink treats equal keys: `none` — a duplicate
- * is an error; `function` — the merge IR (wire input 1) folds adjacent equal
- * Dict keys, passed to the runner as `--merge`; `union` — adjacent equal Set
- * elements collapse to the first, `--union`.
- */
-export type StreamMergeMode = 'none' | 'function' | 'union';
-
-/**
- * The shape of a stream command.
- *
- * @remarks
- * The wire inputs a stream execution stages are laid out `[body IR, merge IR
- * (function mode only), ...-i inputs]`; `stream` names whether the first of
- * the `-i` inputs is the one the runner opens lazily.
- */
-export interface StreamCommandSpec {
-  /** The output collection kind the emit sink writes. */
-  emit: 'array' | 'set' | 'dict';
-  /** How equal keys fold — see {@link StreamMergeMode}. */
-  merge: StreamMergeMode;
-  /** The `-i` input the runner feeds lazily: none, or the first. */
-  stream: 'none' | 'first';
-}
-
-/**
- * Builds the command IR of a stream execution: `(input_paths, output_path)
- * -> argv`.
- *
- * The argv is `[...runner, '--emit', <emit>, '--merge' <merge IR path> |
- * '--union', '--stream' '0' when the first -i input streams, '-i' <path> for
- * each -i input, '-o', <output>, <body IR path>]` — the body IR is wire
- * input 0, the merge IR wire input 1 in function mode, and the `-i` inputs
- * follow. Built with `East.function` exactly as a task command is.
- *
- * @param runner - the stock runner the execution spawns
- * @param spec - the emit kind, the merge mode and the streamed input
- * @returns the command IR
- *
- * @example
- * ```ts
- * import { variant } from '@elaraai/east';
- *
- * const command = streamCommandIr(variant('east_c', { platforms: [] }), { emit: 'dict', merge: 'function', stream: 'first' });
- * command.compile([])(['body.beast2', 'merge.beast2', 'a.beast2'], 'out.beast2');
- * // ['east-c', 'run', '--emit', 'dict', '--merge', 'merge.beast2', '--stream', '0',
- * //  '-i', 'a.beast2', '-o', 'out.beast2', 'body.beast2']
- * ```
- */
-export function streamCommandIr(runner: RunnerValue, spec: StreamCommandSpec): EastIR<[string[], string], string[]> {
-  const prefix = [
-    ...runnerToArgv(runner),
-    '--emit', spec.emit,
-    ...(spec.merge === 'union' ? ['--union'] : []),
-  ];
-  // The merge mode and the streamed input are known here, so the flags they
-  // add are emitted by branching at build time — only the merge IR's PATH is
-  // a run-time value, and only the -i inputs need a loop.
-  const mergeInput = spec.merge === 'function' ? 1n : null;
-  const firstInput = mergeInput === null ? 1n : 2n;
-  const command = East.function(
-    [ArrayType(StringType), StringType],
-    ArrayType(StringType),
-    ($, input_paths, output_path) => {
-      const argv = $.let(prefix, ArrayType(StringType));
-      if (mergeInput !== null) {
-        $(argv.pushLast('--merge'));
-        $(argv.pushLast(input_paths.get(mergeInput)));
-      }
-      if (spec.stream === 'first') {
-        $(argv.pushLast('--stream'));
-        $(argv.pushLast('0'));
-      }
-      const i = $.let(firstInput);
-      $.while(East.less(i, input_paths.size()), $ => {
-        $(argv.pushLast('-i'));
-        $(argv.pushLast(input_paths.get(i)));
-        $.assign(i, i.add(1n));
-      });
-      $(argv.pushLast('-o'));
-      $(argv.pushLast(output_path));
-      $(argv.pushLast(input_paths.get(0n)));
-      $.return(argv);
-    },
-  );
-  return command.toIR();
-}
-
-/**
- * Builds the command IR of a merge execution — the runner's `merge` command
- * over sorted partials of one Set or Dict type, within a key range:
- * `(input_paths, output_path) -> argv`.
- *
- * The argv is `[...runner merge, '--merge' <merge IR path> | '--union',
- * '--range' <range path>, '-i' <path> for each partial, '-o', <output>]`. In
- * `function` mode wire input 0 is the merge IR `(K, V, V) -> V`, wire input
- * 1 the key range and the partials follow; in `union` mode wire input 0 is
- * the key range and every other wire input is a partial. The key range is a
- * blob of `Struct{from: Option<K>, to: Option<K>}` over the output's key
- * type: only the keys in `[from, to)` merge, each partial sought to the
- * segment owning `from`, and an absent bound is open — a component that
- * merges whole takes the open range. Equal keys across partials fold in
- * input order, and the output is byte-identical to what the runner's emit
- * sink writes for the same entries emitted ascending. A partitioned task's
- * SDK writes this IR into its metadata at export, and the orchestrator runs
- * it as an ordinary execution per key range of a group of partials.
- *
- * @param runner - the stock runner whose `merge` command runs
- * @param mode - `function` (a Dict output, folded with the merge IR) or
- *   `union` (a Set output, the first of equal elements standing)
- * @returns the command IR
- * @throws {Error} When the runner is `custom` — it has no merge command.
- *
- * @example
- * ```ts
- * import { variant } from '@elaraai/east';
- *
- * const command = mergeCommandIr(variant('east_c', { platforms: [] }), 'function');
- * command.compile([])(['merge.beast2', 'range.beast2', 'p0.beast2', 'p1.beast2'], 'out.beast2');
- * // ['east-c', 'merge', '--merge', 'merge.beast2', '--range', 'range.beast2',
- * //  '-i', 'p0.beast2', '-i', 'p1.beast2', '-o', 'out.beast2']
- * ```
- */
-export function mergeCommandIr(runner: RunnerValue, mode: 'function' | 'union'): EastIR<[string[], string], string[]> {
-  const prefix = [
-    ...runnerToArgv(runner, 'merge'),
-    ...(mode === 'union' ? ['--union'] : []),
-  ];
-  const mergeInput = mode === 'function' ? 0n : null;
-  const rangeInput = mergeInput === null ? 0n : 1n;
-  const firstInput = rangeInput + 1n;
-  const command = East.function(
-    [ArrayType(StringType), StringType],
-    ArrayType(StringType),
-    ($, input_paths, output_path) => {
-      const argv = $.let(prefix, ArrayType(StringType));
-      if (mergeInput !== null) {
-        $(argv.pushLast('--merge'));
-        $(argv.pushLast(input_paths.get(mergeInput)));
-      }
-      $(argv.pushLast('--range'));
-      $(argv.pushLast(input_paths.get(rangeInput)));
-      const i = $.let(firstInput);
-      $.while(East.less(i, input_paths.size()), $ => {
-        $(argv.pushLast('-i'));
-        $(argv.pushLast(input_paths.get(i)));
-        $.assign(i, i.add(1n));
-      });
-      $(argv.pushLast('-o'));
-      $(argv.pushLast(output_path));
-      $.return(argv);
-    },
-  );
-  return command.toIR();
-}