@logixjs/core 0.0.1 → 1.0.0

package/dist/ExternalStore-DqJKKRJ4.d.ts

@@ -0,0 +1,61 @@
+import { ServiceMap, SubscriptionRef, Stream } from 'effect';
+import { a as ReadQueryInput } from './ReadQuery-C_or5nLC.js';
+import { V as ReadonlySubscriptionRef } from './module-Zd1Gn-Nj.js';
+
+type ExternalStore<T> = {
+    readonly getSnapshot: () => T;
+    readonly getServerSnapshot?: () => T;
+    readonly subscribe: (listener: () => void) => () => void;
+};
+interface ExternalStoreRuntimeError extends Error {
+    readonly _tag: 'ExternalStoreRuntimeError';
+    readonly code: 'external_store::unresolved' | 'external_store::missing_initial' | 'external_store::unresolvable_module_id' | 'external_store::unstable_selector_id';
+}
+/**
+ * Create an ExternalStore by resolving a service from the Effect Context.
+ *
+ * Notes:
+ * - This sugar is intended to be used via `StateTrait.externalStore` (resolved during install/runtime).
+ * - `map(service)` must return a sync `getSnapshot()` (no IO) and a `subscribe(listener)` that signals change.
+ */
+declare const fromService: <Id, Svc, T>(tag: ServiceMap.Key<Id, Svc>, map: (service: Svc) => ExternalStore<T>) => ExternalStore<T>;
+/**
+ * Create an ExternalStore from a SubscriptionRef.
+ *
+ * Notes:
+ * - `getSnapshot()` is implemented via `ref.get` (must be a synchronous pure read; do not hide IO inside).
+ * - change notifications are batched via microtask (multiple updates in the same microtask trigger a single notify).
+ */
+declare const fromSubscriptionRef: <T>(ref: ReadonlySubscriptionRef<T> | SubscriptionRef.SubscriptionRef<T>) => ExternalStore<T>;
+/**
+ * Create an ExternalStore from a Stream.
+ *
+ * Notes:
+ * - Stream has no synchronous "current" snapshot; you MUST provide `{ initial }` (or `{ current }`).
+ * - `{ initial }` may be stale if the stream already emitted before subscription; prefer `fromService/fromSubscriptionRef` for reliable current.
+ */
+declare const fromStream: <A, E>(stream: Stream.Stream<A, E, never>, options?: {
+    readonly initial?: A;
+    readonly current?: A;
+}) => ExternalStore<A>;
+/**
+ * Module-as-Source: treat a module selector as an ExternalStore source (IR-recognizable dependency).
+ *
+ * Notes:
+ * - `moduleId` must be resolvable; passing a read-only `ModuleHandle` is forbidden (fail-fast).
+ * - selectorId must be stable: `ReadQuery.compile(selector)` must NOT fall back to `fallbackReason="unstableSelectorId"` (fail-fast).
+ * - Value semantics: the runtime does not clone; writeback stores the selector return value as-is (keep selectors small and stable).
+ */
+declare const fromModule: <S, V>(module: unknown, selector: ReadQueryInput<S, V>) => ExternalStore<V>;
+
+type ExternalStore$1_ExternalStore<T> = ExternalStore<T>;
+type ExternalStore$1_ExternalStoreRuntimeError = ExternalStoreRuntimeError;
+declare const ExternalStore$1_fromModule: typeof fromModule;
+declare const ExternalStore$1_fromService: typeof fromService;
+declare const ExternalStore$1_fromStream: typeof fromStream;
+declare const ExternalStore$1_fromSubscriptionRef: typeof fromSubscriptionRef;
+declare namespace ExternalStore$1 {
+  export { type ExternalStore$1_ExternalStore as ExternalStore, type ExternalStore$1_ExternalStoreRuntimeError as ExternalStoreRuntimeError, ExternalStore$1_fromModule as fromModule, ExternalStore$1_fromService as fromService, ExternalStore$1_fromStream as fromStream, ExternalStore$1_fromSubscriptionRef as fromSubscriptionRef };
+}
+
+export { ExternalStore$1 as E, type ExternalStore as a, type ExternalStoreRuntimeError as b, fromSubscriptionRef as c, fromStream as d, fromModule as e, fromService as f };

package/dist/ExternalStore-JC-gAgEI.d.cts

@@ -0,0 +1,61 @@
+import { ServiceMap, SubscriptionRef, Stream } from 'effect';
+import { a as ReadQueryInput } from './ReadQuery-Yve1lmUo.cjs';
+import { V as ReadonlySubscriptionRef } from './module-Ds4tarcI.cjs';
+
+type ExternalStore<T> = {
+    readonly getSnapshot: () => T;
+    readonly getServerSnapshot?: () => T;
+    readonly subscribe: (listener: () => void) => () => void;
+};
+interface ExternalStoreRuntimeError extends Error {
+    readonly _tag: 'ExternalStoreRuntimeError';
+    readonly code: 'external_store::unresolved' | 'external_store::missing_initial' | 'external_store::unresolvable_module_id' | 'external_store::unstable_selector_id';
+}
+/**
+ * Create an ExternalStore by resolving a service from the Effect Context.
+ *
+ * Notes:
+ * - This sugar is intended to be used via `StateTrait.externalStore` (resolved during install/runtime).
+ * - `map(service)` must return a sync `getSnapshot()` (no IO) and a `subscribe(listener)` that signals change.
+ */
+declare const fromService: <Id, Svc, T>(tag: ServiceMap.Key<Id, Svc>, map: (service: Svc) => ExternalStore<T>) => ExternalStore<T>;
+/**
+ * Create an ExternalStore from a SubscriptionRef.
+ *
+ * Notes:
+ * - `getSnapshot()` is implemented via `ref.get` (must be a synchronous pure read; do not hide IO inside).
+ * - change notifications are batched via microtask (multiple updates in the same microtask trigger a single notify).
+ */
+declare const fromSubscriptionRef: <T>(ref: ReadonlySubscriptionRef<T> | SubscriptionRef.SubscriptionRef<T>) => ExternalStore<T>;
+/**
+ * Create an ExternalStore from a Stream.
+ *
+ * Notes:
+ * - Stream has no synchronous "current" snapshot; you MUST provide `{ initial }` (or `{ current }`).
+ * - `{ initial }` may be stale if the stream already emitted before subscription; prefer `fromService/fromSubscriptionRef` for reliable current.
+ */
+declare const fromStream: <A, E>(stream: Stream.Stream<A, E, never>, options?: {
+    readonly initial?: A;
+    readonly current?: A;
+}) => ExternalStore<A>;
+/**
+ * Module-as-Source: treat a module selector as an ExternalStore source (IR-recognizable dependency).
+ *
+ * Notes:
+ * - `moduleId` must be resolvable; passing a read-only `ModuleHandle` is forbidden (fail-fast).
+ * - selectorId must be stable: `ReadQuery.compile(selector)` must NOT fall back to `fallbackReason="unstableSelectorId"` (fail-fast).
+ * - Value semantics: the runtime does not clone; writeback stores the selector return value as-is (keep selectors small and stable).
+ */
+declare const fromModule: <S, V>(module: unknown, selector: ReadQueryInput<S, V>) => ExternalStore<V>;
+
+type ExternalStore$1_ExternalStore<T> = ExternalStore<T>;
+type ExternalStore$1_ExternalStoreRuntimeError = ExternalStoreRuntimeError;
+declare const ExternalStore$1_fromModule: typeof fromModule;
+declare const ExternalStore$1_fromService: typeof fromService;
+declare const ExternalStore$1_fromStream: typeof fromStream;
+declare const ExternalStore$1_fromSubscriptionRef: typeof fromSubscriptionRef;
+declare namespace ExternalStore$1 {
+  export { type ExternalStore$1_ExternalStore as ExternalStore, type ExternalStore$1_ExternalStoreRuntimeError as ExternalStoreRuntimeError, ExternalStore$1_fromModule as fromModule, ExternalStore$1_fromService as fromService, ExternalStore$1_fromStream as fromStream, ExternalStore$1_fromSubscriptionRef as fromSubscriptionRef };
+}
+
+export { ExternalStore$1 as E, type ExternalStore as a, type ExternalStoreRuntimeError as b, fromSubscriptionRef as c, fromStream as d, fromModule as e, fromService as f };