@livestore/utils 0.5.0-dev.0 → 0.5.0-dev.1

package/src/effect/mod.ts

@@ -1,7 +1,7 @@
 import '../global.ts'
 
-export { Otlp } from 'effect/unstable/observability'
-export { Msgpack } from 'effect/unstable/encoding'
+export { Otlp } from 'effect/observability'
+export { Base64Url, SchemaBinary } from 'effect/encoding'
 export {
   FetchHttpClient,
   Headers,
@@ -16,12 +16,12 @@ export {
   HttpServerRequest,
   HttpServerResponse,
   UrlParams,
-} from 'effect/unstable/http'
-export { HttpApi, HttpApiClient, HttpApiEndpoint, HttpApiGroup } from 'effect/unstable/httpapi'
-export { KeyValueStore } from 'effect/unstable/persistence'
-export { ChildProcess, ChildProcessSpawner } from 'effect/unstable/process'
-export { Socket } from 'effect/unstable/socket'
-export { Transferable, Worker, WorkerError, WorkerRunner } from 'effect/unstable/workers'
+} from 'effect/http'
+export { HttpApi, HttpApiClient, HttpApiEndpoint, HttpApiGroup } from 'effect/http-api'
+export { KeyValueStore } from 'effect/persistence'
+export { ChildProcess, ChildProcessSpawner } from 'effect/process'
+export { Socket } from 'effect/socket'
+export { Transferable, Worker, WorkerError, WorkerRunner } from 'effect/workers'
 export {
   Rpc,
   RpcClientError,
@@ -33,7 +33,7 @@ export {
   RpcServer,
   RpcTest,
   RpcWorker,
-} from 'effect/unstable/rpc'
+} from 'effect/rpc'
 export * as StandardSchema from '@standard-schema/spec'
 export {
   Array as ReadonlyArray,
@@ -42,6 +42,7 @@ export {
   Cause,
   Channel,
   Chunk,
+  Clock,
   Config,
   ConfigProvider,
   Console,
@@ -83,6 +84,7 @@ export {
   PubSub,
   pipe,
   Queue,
+  Random,
   RcMap,
   RcRef,
   Record as ReadonlyRecord,
@@ -110,7 +112,7 @@ export {
   TxRef,
   Types,
 } from 'effect'
-export * as FastCheck from 'effect/testing/FastCheck'
+export * as Arbitrary from 'effect/Arbitrary'
 export * as TestClock from 'effect/testing/TestClock'
 export * as TestConsole from 'effect/testing/TestConsole'
 export * as Debug from './Debug.ts'

package/src/fast-deep-equal.ts

@@ -14,7 +14,7 @@ export const deepEqual = <T>(a: T, b: T): boolean => {
       length = a.length
       // @ts-expect-error ...
       if (length !== b.length) return false
-      for (i = length; i-- !== 0; )
+      for (i = length; i-- !== 0;)
         // @ts-expect-error ...
         if (deepEqual(a[i], b[i]) === false) return false
       return true
@@ -38,7 +38,7 @@ export const deepEqual = <T>(a: T, b: T): boolean => {
       length = a.length
       // @ts-expect-error ...
       if (length !== b.length) return false
-      for (i = length; i-- !== 0; )
+      for (i = length; i-- !== 0;)
         // @ts-expect-error ...
         if (a[i] !== b[i]) return false
       return true
@@ -53,9 +53,9 @@ export const deepEqual = <T>(a: T, b: T): boolean => {
     length = keys.length
     if (length !== Object.keys(b).length) return false
 
-    for (i = length; i-- !== 0; ) if (Object.hasOwn(b, keys[i]) === false) return false
+    for (i = length; i-- !== 0;) if (Object.hasOwn(b, keys[i]) === false) return false
 
-    for (i = length; i-- !== 0; ) {
+    for (i = length; i-- !== 0;) {
       const key = keys[i]
 
       // @ts-expect-error ...

package/src/misc.ts

@@ -57,7 +57,7 @@ export const envTruish = (env: string | undefined) =>
 export const shouldNeverHappen = (msg?: string, ...args: ReadonlyArray<unknown>): never => {
   console.error(msg, ...args)
   if (isDevEnv() === true) {
-    // oxlint-disable-next-line eslint(no-debugger) -- intentional breakpoint during development
+    // oxlint-disable-next-line no-debugger -- intentional breakpoint during development
     debugger
   }
 

package/src/mod.ts

@@ -92,7 +92,7 @@ export const debugCatch = <T>(try_: () => T): T => {
   try {
     return try_()
   } catch (e: any) {
-    // oxlint-disable-next-line eslint(no-debugger) -- intentional breakpoint for debugging exceptions
+    // oxlint-disable-next-line no-debugger -- intentional breakpoint for debugging exceptions
     debugger
     throw e
   }
@@ -144,7 +144,7 @@ export const capitalizeFirstLetter = (str: string): string => str.charAt(0).toUp
  */
 
 export const casesHandled = (unexpectedCase: never): never => {
-  // oxlint-disable-next-line eslint(no-debugger) -- intentional breakpoint for unhandled cases
+  // oxlint-disable-next-line no-debugger -- intentional breakpoint for unhandled cases
   debugger
   throw new Error(`A case was not handled for value: ${truncate(objectToString(unexpectedCase), 1000)}`)
 }
@@ -159,7 +159,7 @@ export const casesHandled = (unexpectedCase: never): never => {
  */
 export const assertNever = (failIfFalse: boolean, msg?: string): void => {
   if (failIfFalse === false) {
-    // oxlint-disable-next-line eslint(no-debugger) -- intentional breakpoint for impossible states
+    // oxlint-disable-next-line no-debugger -- intentional breakpoint for impossible states
     debugger
     throw new Error(`This should never happen: ${msg}`)
   }
@@ -174,7 +174,7 @@ export const assertNever = (failIfFalse: boolean, msg?: string): void => {
  * ```
  */
 export const debuggerPipe = <T>(val: T): T => {
-  // oxlint-disable-next-line eslint(no-debugger) -- intentional: this function's purpose is to trigger debugger
+  // oxlint-disable-next-line no-debugger -- intentional: this function's purpose is to trigger debugger
   debugger
   return val
 }
@@ -201,7 +201,7 @@ const truncate = (str: string, length: number): string => {
  * ```
  */
 export const notYetImplemented = (msg?: string): never => {
-  // oxlint-disable-next-line eslint(no-debugger) -- intentional breakpoint for unimplemented code paths
+  // oxlint-disable-next-line no-debugger -- intentional breakpoint for unimplemented code paths
   debugger
   throw new Error(`Not yet implemented: ${msg}`)
 }

package/src/node/mod.ts

@@ -6,8 +6,8 @@ import { Effect, FileSystem, Layer, Option } from 'effect'
 import { OtelTracer, Tracer, UnknownError } from '../effect/mod.ts'
 import { makeNoopTracer } from '../NoopTracer.ts'
 
-export * as Cli from 'effect/unstable/cli'
-export * as SocketServer from 'effect/unstable/socket/SocketServer'
+export * as Cli from 'effect/cli'
+export * as SocketServer from 'effect/socket/SocketServer'
 export * as PlatformNode from '@effect/platform-node'
 
 // Enable debug logging for OpenTelemetry
@@ -48,35 +48,12 @@ export const OtelLiveDummy: Layer.Layer<OtelTracer.OtelTracer> = Layer.suspend((
   return TracingLive
 })
 
+export { NodeFileSystem }
+
 /**
- * Compatibility layer for the old Effect v3 @parcel/watcher backend.
- *
- * Effect v4 removed `@effect/platform-node/NodeFileSystem/ParcelWatcher`; its
- * NodeFileSystem layer now performs recursive watching through Node's native
- * `fs.watch(path, { recursive: true })` fallback. This layer deliberately
- * registers no custom backend so existing `NodeRecursiveWatchLayer` consumers
- * continue to compile while the v4 NodeFileSystem implementation handles watch
- * events.
- *
- * This layer alone does NOT provide FileSystem - it only provides the watch backend.
- *
- * IMPORTANT: Layer ordering matters! When composing with NodeFileSystem.layer, use
- * `NodeFileSystemWithWatch` instead, or ensure WatchBackend is available when FileSystem
- * is constructed by using `Layer.provideMerge`:
- *
- * ```ts
- * // ✅ CORRECT: Use the pre-composed layer
- * Effect.provide(NodeFileSystemWithWatch)
- *
- * // ✅ CORRECT: Manual composition with Layer.provideMerge
- * const layer = PlatformNode.NodeFileSystem.layer.pipe(Layer.provideMerge(NodeRecursiveWatchLayer))
- * Effect.provide(layer)
- *
- * // ❌ WRONG: Chained Effect.provide - WatchBackend won't be used!
- * Effect.provide(NodeRecursiveWatchLayer).pipe(Effect.provide(PlatformNode.NodeFileSystem.layer))
- * ```
- *
- * @see https://github.com/Effect-TS/effect/issues/5913
+ * Effect 4 uses Node's native recursive watcher when no custom watch backend
+ * registers for the requested path. Keep the public Effect 3 compatibility
+ * layer while deliberately deferring to that native implementation.
  */
 export const NodeRecursiveWatchLayer: Layer.Layer<FileSystem.WatchBackend> = Layer.succeed(
   FileSystem.WatchBackend,
@@ -85,14 +62,5 @@ export const NodeRecursiveWatchLayer: Layer.Layer<FileSystem.WatchBackend> = Lay
   }),
 )
 
-/**
- * Pre-composed layer providing FileSystem with recursive file watching.
- * This is the recommended way to get a FileSystem that supports recursive watching.
- *
- * Use this layer when you need to watch files recursively (e.g., watching nested directories).
- * Effect v4's NodeFileSystem uses Node.js's native recursive `fs.watch` support
- * instead of the removed ParcelWatcher backend from Effect v3.
- */
-export { NodeFileSystem } from '@effect/platform-node'
-
+/** FileSystem layer retaining the public recursive-watch composition API. */
 export const NodeFileSystemWithWatch = NodeFileSystem.layer.pipe(Layer.provideMerge(NodeRecursiveWatchLayer))