@soda-gql/common 0.0.9 → 0.2.0

package/dist/index.d.cts

@@ -2,4 +2,219 @@ import { a as createCanonicalTracker, c as CanonicalId, i as buildAstPath, l as
 import { a as resetPortableForTests, c as HashAlgorithm, d as createPortableHasher, f as getPortableHasher, g as getPortableFS, h as createPortableFS, i as once, l as PortableHasher, m as __resetPortableFSForTests, n as SpawnResult, o as runtime, p as PortableFS, r as spawn, s as generateId, t as SpawnOptions, u as __resetPortableHasherForTests } from "./index-DaAp2rNj.cjs";
 import { a as resolveRelativeImportWithExistenceCheck, i as normalizePath, n as isExternalSpecifier, o as resolveRelativeImportWithReferences, r as isRelativeSpecifier, s as cachedFn, t as MODULE_EXTENSION_CANDIDATES } from "./index-LaXfl_e_.cjs";
 import { n as ShapeFor, r as defineSchemaFor, t as SchemaFor } from "./index-LHYortIn.cjs";
-export { CanonicalId, CanonicalIdSchema, CanonicalPathTracker, HashAlgorithm, MODULE_EXTENSION_CANDIDATES, PortableFS, PortableHasher, SchemaFor, ScopeFrame, ScopeHandle, ShapeFor, SpawnOptions, SpawnResult, __resetPortableFSForTests, __resetPortableHasherForTests, buildAstPath, cachedFn, createCanonicalId, createCanonicalTracker, createOccurrenceTracker, createPathTracker, createPortableFS, createPortableHasher, defineSchemaFor, generateId, getPortableFS, getPortableHasher, isExternalSpecifier, isRelativeSpecifier, normalizePath, once, resetPortableForTests, resolveRelativeImportWithExistenceCheck, resolveRelativeImportWithReferences, runtime, spawn };
+import { Result } from "neverthrow";
+
+//#region packages/common/src/scheduler/types.d.ts
+
+/**
+ * Abstract base class for all effects.
+ * Effects encapsulate both the data and the execution logic.
+ *
+ * @template TResult - The type of value this effect produces when executed
+ *
+ * @example
+ * ```typescript
+ * function* myGenerator() {
+ *   const value = yield* new PureEffect(42).run();
+ *   return value; // 42
+ * }
+ * ```
+ */
+declare abstract class Effect<TResult = unknown> {
+  /**
+   * Execute the effect synchronously and return the result.
+   */
+  executeSync(): TResult;
+  /**
+   * Execute the effect asynchronously and return the result.
+   */
+  executeAsync(): Promise<TResult>;
+  /**
+   * Returns a generator that yields this effect and returns the result.
+   * Enables the `yield*` pattern for cleaner effect handling.
+   *
+   * @example
+   * ```typescript
+   * const value = yield* effect.run();
+   * ```
+   */
+  run(): Generator<Effect<TResult>, TResult, EffectReturn>;
+  /**
+   * Internal synchronous execution logic.
+   * Subclasses must implement this method.
+   */
+  protected abstract _executeSync(): TResult;
+  /**
+   * Internal asynchronous execution logic.
+   * Subclasses must implement this method.
+   */
+  protected abstract _executeAsync(): Promise<TResult>;
+}
+declare const EFFECT_RETURN: unique symbol;
+declare class EffectReturn<TResult = unknown> {
+  private readonly [EFFECT_RETURN];
+  private constructor();
+  static wrap<TResult>(value: TResult): EffectReturn<TResult>;
+  static unwrap<TResult>(value: EffectReturn<TResult>): TResult;
+}
+/**
+ * Extract the result type from an Effect.
+ */
+type EffectResult<E> = E extends Effect<infer T> ? T : never;
+/**
+ * Generator type that yields Effects.
+ */
+type EffectGenerator<TReturn> = Generator<Effect, TReturn, EffectReturn>;
+/**
+ * Generator function type that creates an EffectGenerator.
+ */
+type EffectGeneratorFn<TReturn> = () => EffectGenerator<TReturn>;
+/**
+ * Error type for scheduler operations.
+ */
+type SchedulerError = {
+  readonly kind: "scheduler-error";
+  readonly message: string;
+  readonly cause?: unknown;
+};
+/**
+ * Create a SchedulerError.
+ */
+declare const createSchedulerError: (message: string, cause?: unknown) => SchedulerError;
+/**
+ * Synchronous scheduler interface.
+ * Throws if an async-only effect (defer, yield) is encountered.
+ */
+interface SyncScheduler {
+  run<TReturn>(generatorFn: EffectGeneratorFn<TReturn>): Result<TReturn, SchedulerError>;
+}
+/**
+ * Asynchronous scheduler interface.
+ * Handles all effect types including defer, yield, and parallel.
+ */
+interface AsyncScheduler {
+  run<TReturn>(generatorFn: EffectGeneratorFn<TReturn>): Promise<Result<TReturn, SchedulerError>>;
+}
+//#endregion
+//#region packages/common/src/scheduler/async-scheduler.d.ts
+/**
+ * Create an asynchronous scheduler.
+ *
+ * This scheduler can handle all effect types including defer and yield.
+ * Parallel effects are executed concurrently using Promise.all.
+ *
+ * @returns An AsyncScheduler instance
+ *
+ * @example
+ * const scheduler = createAsyncScheduler();
+ * const result = await scheduler.run(function* () {
+ *   const data = yield* new DeferEffect(fetch('/api/data').then(r => r.json())).run();
+ *   yield* new YieldEffect().run(); // Yield to event loop
+ *   return data;
+ * });
+ */
+declare const createAsyncScheduler: () => AsyncScheduler;
+//#endregion
+//#region packages/common/src/scheduler/effect.d.ts
+/**
+ * Pure effect - returns a value immediately.
+ * Works in both sync and async schedulers.
+ *
+ * @example
+ * const result = yield* new PureEffect(42).run(); // 42
+ */
+declare class PureEffect<T> extends Effect<T> {
+  readonly pureValue: T;
+  constructor(pureValue: T);
+  protected _executeSync(): T;
+  protected _executeAsync(): Promise<T>;
+}
+/**
+ * Defer effect - wraps a Promise for async execution.
+ * Only works in async schedulers; throws in sync schedulers.
+ *
+ * @example
+ * const data = yield* new DeferEffect(fetch('/api/data').then(r => r.json())).run();
+ */
+declare class DeferEffect<T> extends Effect<T> {
+  readonly promise: Promise<T>;
+  constructor(promise: Promise<T>);
+  protected _executeSync(): T;
+  protected _executeAsync(): Promise<T>;
+}
+/**
+ * Parallel effect - executes multiple effects concurrently.
+ * In sync schedulers, effects are executed sequentially.
+ * In async schedulers, effects are executed with Promise.all.
+ *
+ * @example
+ * const results = yield* new ParallelEffect([new PureEffect(1), new PureEffect(2)]).run(); // [1, 2]
+ */
+declare class ParallelEffect extends Effect<readonly unknown[]> {
+  readonly effects: readonly Effect<unknown>[];
+  constructor(effects: readonly Effect<unknown>[]);
+  protected _executeSync(): readonly unknown[];
+  protected _executeAsync(): Promise<readonly unknown[]>;
+}
+/**
+ * Yield effect - yields control back to the event loop.
+ * This helps prevent blocking the event loop in long-running operations.
+ * Only works in async schedulers; throws in sync schedulers.
+ *
+ * @example
+ * for (let i = 0; i < 10000; i++) {
+ *   doWork(i);
+ *   if (i % 100 === 0) {
+ *     yield* new YieldEffect().run();
+ *   }
+ * }
+ */
+declare class YieldEffect extends Effect<void> {
+  protected _executeSync(): void;
+  protected _executeAsync(): Promise<void>;
+}
+/**
+ * Effect factory namespace for convenience.
+ * Provides static methods to create effects.
+ */
+declare const Effects: {
+  /**
+   * Create a pure effect that returns a value immediately.
+   */
+  readonly pure: <T>(value: T) => PureEffect<T>;
+  /**
+   * Create a defer effect that wraps a Promise.
+   */
+  readonly defer: <T>(promise: Promise<T>) => DeferEffect<T>;
+  /**
+   * Create a parallel effect that executes multiple effects concurrently.
+   */
+  readonly parallel: (effects: readonly Effect<unknown>[]) => ParallelEffect;
+  /**
+   * Create a yield effect that returns control to the event loop.
+   */
+  readonly yield: () => YieldEffect;
+};
+//#endregion
+//#region packages/common/src/scheduler/sync-scheduler.d.ts
+/**
+ * Create a synchronous scheduler.
+ *
+ * This scheduler executes generators synchronously.
+ * It throws an error if an async-only effect (defer, yield) is encountered.
+ *
+ * @returns A SyncScheduler instance
+ *
+ * @example
+ * const scheduler = createSyncScheduler();
+ * const result = scheduler.run(function* () {
+ *   const a = yield* new PureEffect(1).run();
+ *   const b = yield* new PureEffect(2).run();
+ *   return a + b;
+ * });
+ * // result = ok(3)
+ */
+declare const createSyncScheduler: () => SyncScheduler;
+//#endregion
+export { type AsyncScheduler, CanonicalId, CanonicalIdSchema, CanonicalPathTracker, DeferEffect, Effect, type EffectGenerator, type EffectGeneratorFn, type EffectResult, Effects, HashAlgorithm, MODULE_EXTENSION_CANDIDATES, ParallelEffect, PortableFS, PortableHasher, PureEffect, type SchedulerError, SchemaFor, ScopeFrame, ScopeHandle, ShapeFor, SpawnOptions, SpawnResult, type SyncScheduler, YieldEffect, __resetPortableFSForTests, __resetPortableHasherForTests, buildAstPath, cachedFn, createAsyncScheduler, createCanonicalId, createCanonicalTracker, createOccurrenceTracker, createPathTracker, createPortableFS, createPortableHasher, createSchedulerError, createSyncScheduler, defineSchemaFor, generateId, getPortableFS, getPortableHasher, isExternalSpecifier, isRelativeSpecifier, normalizePath, once, resetPortableForTests, resolveRelativeImportWithExistenceCheck, resolveRelativeImportWithReferences, runtime, spawn };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/scheduler/types.ts","../src/scheduler/async-scheduler.ts","../src/scheduler/effect.ts","../src/scheduler/sync-scheduler.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.d.mts

@@ -2,4 +2,219 @@ import { a as createCanonicalTracker, c as CanonicalId, i as buildAstPath, l as
 import { a as resetPortableForTests, c as HashAlgorithm, d as createPortableHasher, f as getPortableHasher, g as getPortableFS, h as createPortableFS, i as once, l as PortableHasher, m as __resetPortableFSForTests, n as SpawnResult, o as runtime, p as PortableFS, r as spawn, s as generateId, t as SpawnOptions, u as __resetPortableHasherForTests } from "./index-BedBpKbv.mjs";
 import { a as resolveRelativeImportWithExistenceCheck, i as normalizePath, n as isExternalSpecifier, o as resolveRelativeImportWithReferences, r as isRelativeSpecifier, s as cachedFn, t as MODULE_EXTENSION_CANDIDATES } from "./index-Dv8spPt0.mjs";
 import { n as ShapeFor, r as defineSchemaFor, t as SchemaFor } from "./index-Dit86qkX.mjs";
-export { CanonicalId, CanonicalIdSchema, CanonicalPathTracker, HashAlgorithm, MODULE_EXTENSION_CANDIDATES, PortableFS, PortableHasher, SchemaFor, ScopeFrame, ScopeHandle, ShapeFor, SpawnOptions, SpawnResult, __resetPortableFSForTests, __resetPortableHasherForTests, buildAstPath, cachedFn, createCanonicalId, createCanonicalTracker, createOccurrenceTracker, createPathTracker, createPortableFS, createPortableHasher, defineSchemaFor, generateId, getPortableFS, getPortableHasher, isExternalSpecifier, isRelativeSpecifier, normalizePath, once, resetPortableForTests, resolveRelativeImportWithExistenceCheck, resolveRelativeImportWithReferences, runtime, spawn };
+import { Result } from "neverthrow";
+
+//#region packages/common/src/scheduler/types.d.ts
+
+/**
+ * Abstract base class for all effects.
+ * Effects encapsulate both the data and the execution logic.
+ *
+ * @template TResult - The type of value this effect produces when executed
+ *
+ * @example
+ * ```typescript
+ * function* myGenerator() {
+ *   const value = yield* new PureEffect(42).run();
+ *   return value; // 42
+ * }
+ * ```
+ */
+declare abstract class Effect<TResult = unknown> {
+  /**
+   * Execute the effect synchronously and return the result.
+   */
+  executeSync(): TResult;
+  /**
+   * Execute the effect asynchronously and return the result.
+   */
+  executeAsync(): Promise<TResult>;
+  /**
+   * Returns a generator that yields this effect and returns the result.
+   * Enables the `yield*` pattern for cleaner effect handling.
+   *
+   * @example
+   * ```typescript
+   * const value = yield* effect.run();
+   * ```
+   */
+  run(): Generator<Effect<TResult>, TResult, EffectReturn>;
+  /**
+   * Internal synchronous execution logic.
+   * Subclasses must implement this method.
+   */
+  protected abstract _executeSync(): TResult;
+  /**
+   * Internal asynchronous execution logic.
+   * Subclasses must implement this method.
+   */
+  protected abstract _executeAsync(): Promise<TResult>;
+}
+declare const EFFECT_RETURN: unique symbol;
+declare class EffectReturn<TResult = unknown> {
+  private readonly [EFFECT_RETURN];
+  private constructor();
+  static wrap<TResult>(value: TResult): EffectReturn<TResult>;
+  static unwrap<TResult>(value: EffectReturn<TResult>): TResult;
+}
+/**
+ * Extract the result type from an Effect.
+ */
+type EffectResult<E> = E extends Effect<infer T> ? T : never;
+/**
+ * Generator type that yields Effects.
+ */
+type EffectGenerator<TReturn> = Generator<Effect, TReturn, EffectReturn>;
+/**
+ * Generator function type that creates an EffectGenerator.
+ */
+type EffectGeneratorFn<TReturn> = () => EffectGenerator<TReturn>;
+/**
+ * Error type for scheduler operations.
+ */
+type SchedulerError = {
+  readonly kind: "scheduler-error";
+  readonly message: string;
+  readonly cause?: unknown;
+};
+/**
+ * Create a SchedulerError.
+ */
+declare const createSchedulerError: (message: string, cause?: unknown) => SchedulerError;
+/**
+ * Synchronous scheduler interface.
+ * Throws if an async-only effect (defer, yield) is encountered.
+ */
+interface SyncScheduler {
+  run<TReturn>(generatorFn: EffectGeneratorFn<TReturn>): Result<TReturn, SchedulerError>;
+}
+/**
+ * Asynchronous scheduler interface.
+ * Handles all effect types including defer, yield, and parallel.
+ */
+interface AsyncScheduler {
+  run<TReturn>(generatorFn: EffectGeneratorFn<TReturn>): Promise<Result<TReturn, SchedulerError>>;
+}
+//#endregion
+//#region packages/common/src/scheduler/async-scheduler.d.ts
+/**
+ * Create an asynchronous scheduler.
+ *
+ * This scheduler can handle all effect types including defer and yield.
+ * Parallel effects are executed concurrently using Promise.all.
+ *
+ * @returns An AsyncScheduler instance
+ *
+ * @example
+ * const scheduler = createAsyncScheduler();
+ * const result = await scheduler.run(function* () {
+ *   const data = yield* new DeferEffect(fetch('/api/data').then(r => r.json())).run();
+ *   yield* new YieldEffect().run(); // Yield to event loop
+ *   return data;
+ * });
+ */
+declare const createAsyncScheduler: () => AsyncScheduler;
+//#endregion
+//#region packages/common/src/scheduler/effect.d.ts
+/**
+ * Pure effect - returns a value immediately.
+ * Works in both sync and async schedulers.
+ *
+ * @example
+ * const result = yield* new PureEffect(42).run(); // 42
+ */
+declare class PureEffect<T> extends Effect<T> {
+  readonly pureValue: T;
+  constructor(pureValue: T);
+  protected _executeSync(): T;
+  protected _executeAsync(): Promise<T>;
+}
+/**
+ * Defer effect - wraps a Promise for async execution.
+ * Only works in async schedulers; throws in sync schedulers.
+ *
+ * @example
+ * const data = yield* new DeferEffect(fetch('/api/data').then(r => r.json())).run();
+ */
+declare class DeferEffect<T> extends Effect<T> {
+  readonly promise: Promise<T>;
+  constructor(promise: Promise<T>);
+  protected _executeSync(): T;
+  protected _executeAsync(): Promise<T>;
+}
+/**
+ * Parallel effect - executes multiple effects concurrently.
+ * In sync schedulers, effects are executed sequentially.
+ * In async schedulers, effects are executed with Promise.all.
+ *
+ * @example
+ * const results = yield* new ParallelEffect([new PureEffect(1), new PureEffect(2)]).run(); // [1, 2]
+ */
+declare class ParallelEffect extends Effect<readonly unknown[]> {
+  readonly effects: readonly Effect<unknown>[];
+  constructor(effects: readonly Effect<unknown>[]);
+  protected _executeSync(): readonly unknown[];
+  protected _executeAsync(): Promise<readonly unknown[]>;
+}
+/**
+ * Yield effect - yields control back to the event loop.
+ * This helps prevent blocking the event loop in long-running operations.
+ * Only works in async schedulers; throws in sync schedulers.
+ *
+ * @example
+ * for (let i = 0; i < 10000; i++) {
+ *   doWork(i);
+ *   if (i % 100 === 0) {
+ *     yield* new YieldEffect().run();
+ *   }
+ * }
+ */
+declare class YieldEffect extends Effect<void> {
+  protected _executeSync(): void;
+  protected _executeAsync(): Promise<void>;
+}
+/**
+ * Effect factory namespace for convenience.
+ * Provides static methods to create effects.
+ */
+declare const Effects: {
+  /**
+   * Create a pure effect that returns a value immediately.
+   */
+  readonly pure: <T>(value: T) => PureEffect<T>;
+  /**
+   * Create a defer effect that wraps a Promise.
+   */
+  readonly defer: <T>(promise: Promise<T>) => DeferEffect<T>;
+  /**
+   * Create a parallel effect that executes multiple effects concurrently.
+   */
+  readonly parallel: (effects: readonly Effect<unknown>[]) => ParallelEffect;
+  /**
+   * Create a yield effect that returns control to the event loop.
+   */
+  readonly yield: () => YieldEffect;
+};
+//#endregion
+//#region packages/common/src/scheduler/sync-scheduler.d.ts
+/**
+ * Create a synchronous scheduler.
+ *
+ * This scheduler executes generators synchronously.
+ * It throws an error if an async-only effect (defer, yield) is encountered.
+ *
+ * @returns A SyncScheduler instance
+ *
+ * @example
+ * const scheduler = createSyncScheduler();
+ * const result = scheduler.run(function* () {
+ *   const a = yield* new PureEffect(1).run();
+ *   const b = yield* new PureEffect(2).run();
+ *   return a + b;
+ * });
+ * // result = ok(3)
+ */
+declare const createSyncScheduler: () => SyncScheduler;
+//#endregion
+export { type AsyncScheduler, CanonicalId, CanonicalIdSchema, CanonicalPathTracker, DeferEffect, Effect, type EffectGenerator, type EffectGeneratorFn, type EffectResult, Effects, HashAlgorithm, MODULE_EXTENSION_CANDIDATES, ParallelEffect, PortableFS, PortableHasher, PureEffect, type SchedulerError, SchemaFor, ScopeFrame, ScopeHandle, ShapeFor, SpawnOptions, SpawnResult, type SyncScheduler, YieldEffect, __resetPortableFSForTests, __resetPortableHasherForTests, buildAstPath, cachedFn, createAsyncScheduler, createCanonicalId, createCanonicalTracker, createOccurrenceTracker, createPathTracker, createPortableFS, createPortableHasher, createSchedulerError, createSyncScheduler, defineSchemaFor, generateId, getPortableFS, getPortableHasher, isExternalSpecifier, isRelativeSpecifier, normalizePath, once, resetPortableForTests, resolveRelativeImportWithExistenceCheck, resolveRelativeImportWithReferences, runtime, spawn };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/scheduler/types.ts","../src/scheduler/async-scheduler.ts","../src/scheduler/effect.ts","../src/scheduler/sync-scheduler.ts"],"sourcesContent":[],"mappings":"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"}