JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 11236
  • Score
    100M100P100Q144720F
  • License MIT

Package Exports

  • @soda-gql/common
  • @soda-gql/common/canonical-id
  • @soda-gql/common/package.json
  • @soda-gql/common/portable
  • @soda-gql/common/test
  • @soda-gql/common/utils
  • @soda-gql/common/zod

Readme

@soda-gql/common

npm version License: MIT

Shared utilities and types for the soda-gql ecosystem.

Installation

bun add @soda-gql/common

Note: This package is primarily used internally by other soda-gql packages. Direct usage is only needed for advanced integration scenarios.

Overview

This package provides shared utilities used across the soda-gql ecosystem:

  • Portable utilities for cross-environment compatibility
  • Canonical ID generation and parsing
  • Path building utilities
  • Zod validation helpers

Exports

Main Entry (@soda-gql/common)

Common types and utilities:

import { ... } from "@soda-gql/common";

Portable (@soda-gql/common/portable)

Cross-environment utilities:

import { ... } from "@soda-gql/common/portable";

Canonical ID (@soda-gql/common/canonical-id)

Canonical ID generation and parsing:

import { createCanonicalId, parseCanonicalId } from "@soda-gql/common/canonical-id";

// Create a canonical ID
const id = createCanonicalId("/path/to/file.ts", "userQuery");
// Result: "/path/to/file.ts::userQuery"

// Parse a canonical ID
const parsed = parseCanonicalId(id);
// Result: { filePath: "/path/to/file.ts", astPath: "userQuery" }

Utils (@soda-gql/common/utils)

General utility functions:

import { ... } from "@soda-gql/common/utils";

Zod (@soda-gql/common/zod)

Zod validation helpers:

import { ... } from "@soda-gql/common/zod";

Scheduler (Effect System)

Generator-based effect system for scheduling sync and async operations:

import {
  createSyncScheduler,
  createAsyncScheduler,
  PureEffect,
  DeferEffect,
  ParallelEffect,
  YieldEffect,
} from "@soda-gql/common";

// Sync usage
const syncScheduler = createSyncScheduler();
const result = syncScheduler.run(function* () {
  const a = yield* new PureEffect(1).run();
  const b = yield* new PureEffect(2).run();
  return a + b;
});

// Async usage with parallel effects
const asyncScheduler = createAsyncScheduler();
const asyncResult = await asyncScheduler.run(function* () {
  const data = yield* new DeferEffect(fetchData()).run();
  yield* new YieldEffect().run(); // Yield to event loop
  return processData(data);
});

Test Utilities (@soda-gql/common/test)

Shared test utilities for soda-gql packages (internal use):

import { createTempDir, TestSuite } from "@soda-gql/common/test";

License

MIT