npm.io
1.0.26 • Published 4d ago

@elaraai/e3-api-tests

Licence
BUSL-1.1
Version
1.0.26
Deps
7
Size
449 kB
Vulns
0
Weekly
1.3K
SummaryDependencyVersions

@elaraai/e3-api-tests

Compliance test suite for e3 API servers, used for integration tests in the e3 monorepo. Intended to verify the reference server (@elaraai/e3-api-server), and ensure any alternative e3 server implementations conform to the same API contract.

Installation

npm install @elaraai/e3-api-tests

Usage

Each test receives a fresh, isolated context via a TestSetup<T> factory, enabling concurrent execution:

import { describe, after } from 'node:test';
import { createServer } from '@elaraai/e3-api-server';
import { allApiTests, createTestContext, type TestSetup, type TestContext } from '@elaraai/e3-api-tests';

// Shared server (one per test run)
const server = await createServer({ reposDir: tempDir, port: 0 });
await server.start();

// Per-test setup: creates a fresh repo + context
const setup: TestSetup<TestContext> = async (t) => {
  const ctx = await createTestContext({
    baseUrl: `http://localhost:${server.port}`,
    getToken: async () => '',
    cleanup: true,
  });
  t.after(() => ctx.cleanup());
  return ctx;
};

describe('API compliance', { concurrency: true }, () => {
  after(() => server.stop());
  allApiTests(setup);
});

Exports

Export Description
TestSetup<T> Type for per-test context factory: (t: TestContext) => Promise<T>
createTestContext Create test context with helpers for setup/teardown
allApiTests Register all API test suites (repository, packages, workspaces, datasets, dataflow)
allTests Register all tests including CLI tests (requires credentials env)
repositoryTests Repository CRUD tests
packageTests Package import/export tests
workspaceTests Workspace management tests
datasetTests Dataset read/write tests
dataflowTests Dataflow execution tests
platformTests Platform capability tests
cliTests CLI integration tests
transferTests Cross-repository transfer tests
createPackageZip Create a test package zip file
runE3Command Run an e3 CLI command

Claude Code plugin

The East ecosystem also ships a Claude Code plugin — East language skills, example search, and preemptive diagnostics for East code — installed separately from the elaraai marketplace:

# Inside Claude Code
/plugin marketplace add elaraai/east-workspace
/plugin install east@elaraai
# From a terminal
claude plugin marketplace add elaraai/east-workspace
claude plugin install east@elaraai

License

BSL 1.1. See LICENSE.md.

Ecosystem

  • East: Statically typed, expression-based language with serializable IR. Run portable logic across TypeScript, Python, C, and other runtimes.

    • @elaraai/east: Core language SDK with type system, expressions, and reference JS compiler

  • East Node: Node.js platform functions for I/O, databases, and system operations.

  • East C: C11 native runtime for executing East IR. Distributed via npm (launcher + per-platform optional dependencies) and as tarballs on each GitHub Release.

    • @elaraai/east-c-cli: npm launcher — installs the matching native binary as an optional dependency
    • east-c: Core runtime — type system, IR interpreter, builtins, serialization (Beast2, JSON, CSV, East text)
    • east-c-std: Console, FileSystem, Fetch, Crypto, Time, Path, Random
    • east-c-cli: CLI for running East IR programs natively

  • East Python: Python runtime, standard platform, I/O, and data-science platform functions. Published to PyPI.

    • east-py: Core Python runtime — type system, IR compiler, 212+ builtins, Cython-accelerated hot paths
    • east-py-std: Console, FileSystem, Fetch, Crypto, Time, Path, Random
    • east-py-io: SQLite, PostgreSQL, MySQL, MongoDB, Redis, S3, FTP, SFTP, XLSX, XML, compression
    • east-py-cli: CLI for running East IR programs in Python
    • east-py-datascience (PyPI) + @elaraai/east-py-datascience (npm): Optimization (MADS, Optuna, ALNS, GoogleOR), ML (XGBoost, LightGBM, NGBoost, PyTorch, Lightning, GP), Bayesian inference (PyMC), explainability (SHAP), conformal prediction (MAPIE)

  • East UI: Typed UI component definitions and React renderer, plus VS Code preview.

  • e3 — East Execution Engine: Durable execution engine for running East pipelines at scale. Git-like content-addressable storage, automatic memoization, reactive dataflow, real-time monitoring.

Links

About Elara

East is developed by Elara AI Pty Ltd, an AI-powered platform that creates economic digital twins of businesses that optimize performance. Elara combines business objectives, decisions and data to help organizations make data-driven decisions across operations, purchasing, sales and customer engagement, and project and investment planning. East powers the computational layer of Elara solutions, enabling the expression of complex business logic and data in a simple, type-safe and portable language.

Developed by Elara AI Pty Ltd.

Developed by Elara AI Pty Ltd

Keywords

easte3apitestscompliance