feat: export createApi from main module

[taras]

Summary

Export the createApi function from the main effection module so users can create APIs with middleware support without importing from experimental.ts.

Changes

• Add comprehensive JSDoc documentation with examples for createApi
• Export createApi from lib/mod.ts
• Update test to import createApi from main module instead of experimental

Why

The createApi function enables:

• Dependency injection: Swap implementations based on context
• Test mocking: Replace real operations with test doubles
• Instrumentation: Add logging, metrics, or tracing middleware

This is now stable enough to be part of the public API.

Usage

import { createApi, run } from "effection";

const myApi = createApi("myApi", {
  *fetch(url: string) {
    return yield* until(globalThis.fetch(url));
  }
});

// Use the API
await run(function*() {
  let response = yield* myApi.operations.fetch("/api/data");
});

// With middleware for testing
await run(function*() {
  yield* myApi.around({
    *fetch() {
      return { ok: true, json: () => ({ mocked: true }) };
    }
  });
  // All fetch calls now return mocked data
});

Notes

Once this PR is merged and the preview package is published, we can update the @effectionx/* packages to use createApi.

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/thefrontside/effection@1116

commit: fb9d41d