@livestore/livestore 0.0.58-dev.9 → 0.1.0-dev.0

package/src/react/useTemporaryQuery.ts

@@ -1,131 +0,0 @@
-import type { QueryInfo } from '@livestore/common'
-import * as otel from '@opentelemetry/api'
-import React from 'react'
-
-import type { LiveQuery } from '../reactiveQueries/base-class.js'
-import { useStore } from './LiveStoreContext.js'
-import { useQueryRef } from './useQuery.js'
-
-// NOTE Given `useMemo` will be called multiple times (e.g. when using React Strict mode or Fast Refresh),
-// we are using this cache to avoid starting multiple queries/spans for the same component.
-// This is somewhat against some recommended React best practices, but it should be fine in our case below.
-// Please definitely open an issue if you see or run into any problems with this approach!
-const cache = new Map<
-  string,
-  | {
-      _tag: 'active'
-      rc: number
-      query$: LiveQuery<any, any>
-      span: otel.Span
-      otelContext: otel.Context
-    }
-  | {
-      _tag: 'destroyed'
-    }
->()
-
-export type DepKey = string | number | ReadonlyArray<string | number>
-
-/**
- * Creates a query, subscribes and destroys it when the component unmounts.
- *
- * The `key` is used to determine whether the a new query should be created or if the existing one should be reused.
- */
-export const useTemporaryQuery = <TResult>(makeQuery: () => LiveQuery<TResult>, key: DepKey): TResult =>
-  useTemporaryQueryRef(makeQuery, key).current
-
-export const useTemporaryQueryRef = <TResult>(
-  makeQuery: () => LiveQuery<TResult>,
-  key: DepKey,
-): React.MutableRefObject<TResult> => {
-  const { query$ } = useMakeTemporaryQuery(makeQuery, key)
-
-  return useQueryRef(query$)
-}
-
-export const useMakeTemporaryQuery = <TResult, TQueryInfo extends QueryInfo>(
-  makeQuery: (otelContext: otel.Context) => LiveQuery<TResult, TQueryInfo>,
-  key: DepKey,
-  options?: {
-    otel?: {
-      spanName?: string
-      attributes?: otel.Attributes
-    }
-  },
-): { query$: LiveQuery<TResult, TQueryInfo>; otelContext: otel.Context } => {
-  const { store } = useStore()
-  const fullKey = React.useMemo(
-    // NOTE We're using the `makeQuery` function body string to make sure the key is unique across the app
-    // TODO we should figure out whether this could cause some problems and/or if there's a better way to do this
-    () => (Array.isArray(key) ? key.join('-') : key) + '-' + store.reactivityGraph.id + '-' + makeQuery.toString(),
-    [key, makeQuery, store.reactivityGraph.id],
-  )
-  const fullKeyRef = React.useRef<string>()
-
-  const { query$, otelContext } = React.useMemo(() => {
-    if (fullKeyRef.current !== undefined && fullKeyRef.current !== fullKey) {
-      // console.debug('fullKey changed', 'prev', fullKeyRef.current.split('-')[0]!, '-> new', fullKey.split('-')[0]!)
-
-      const cachedItem = cache.get(fullKeyRef.current)
-      if (cachedItem !== undefined && cachedItem._tag === 'active') {
-        cachedItem.rc--
-
-        if (cachedItem.rc === 0) {
-          // console.debug('rc=0-changed', cachedItem.query$.id, cachedItem.query$.label)
-          cachedItem.query$.destroy()
-          cachedItem.span.end()
-          cache.set(fullKeyRef.current, { _tag: 'destroyed' })
-        }
-      }
-    }
-
-    const cachedItem = cache.get(fullKey)
-    if (cachedItem !== undefined && cachedItem._tag === 'active') {
-      // console.debug('rc++', cachedItem.query$.id, cachedItem.query$.label)
-      cachedItem.rc++
-
-      return cachedItem
-    }
-
-    const spanName = options?.otel?.spanName ?? `LiveStore:useTemporaryQuery:${key}`
-
-    const span = store.otel.tracer.startSpan(
-      spanName,
-      { attributes: options?.otel?.attributes },
-      store.otel.queriesSpanContext,
-    )
-
-    const otelContext = otel.trace.setSpan(otel.context.active(), span)
-
-    const query$ = makeQuery(otelContext)
-
-    cache.set(fullKey, { _tag: 'active', rc: 1, query$, span, otelContext })
-
-    return { query$, otelContext }
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [fullKey])
-
-  fullKeyRef.current = fullKey
-
-  React.useEffect(() => {
-    return () => {
-      const fullKey = fullKeyRef.current!
-      const cachedItem = cache.get(fullKey)
-      // NOTE in case the fullKey changed then the query was already destroyed in the useMemo above
-      if (cachedItem === undefined || cachedItem._tag === 'destroyed') return
-
-      // console.debug('rc--', cachedItem.query$.id, cachedItem.query$.label)
-
-      cachedItem.rc--
-
-      if (cachedItem.rc === 0) {
-        // console.debug('rc=0', cachedItem.query$.id, cachedItem.query$.label)
-        cachedItem.query$.destroy()
-        cachedItem.span.end()
-        cache.delete(fullKey)
-      }
-    }
-  }, [])
-
-  return { query$, otelContext }
-}

package/src/react/utils/useStateRefWithReactiveInput.ts

@@ -1,51 +0,0 @@
-import React from 'react'
-
-/**
- * A variant of `React.useState` which allows the `inputState` to change over time as well.
- * Important: This hook is synchronous / single-render-pass (i.e. doesn't use `useEffect` or `setState` directly).
- *
- * Notes:
- * - The output state is always reset to the input state in case the input state changes (i.e. the previous "external" `setStateAndRerender` call is forgotten)
- * - This hook might not work properly with React Suspense
- * - Also see this Tweet for more potential problems: https://twitter.com/schickling/status/1677317711104278528
- *
- */
-export const useStateRefWithReactiveInput = <T>(
-  inputState: T,
-): [React.MutableRefObject<T>, (newState: T | ((prev: T) => T)) => void] => {
-  const [_, rerender] = React.useState(0)
-
-  const lastKnownInputStateRef = React.useRef<T>(inputState)
-  const stateRef = React.useRef<T>(inputState)
-
-  if (lastKnownInputStateRef.current !== inputState) {
-    lastKnownInputStateRef.current = inputState
-
-    // NOTE we don't need to re-render here, because the component is already re-rendering due to the `inputState` change
-    stateRef.current = inputState
-  }
-
-  const setStateAndRerender = React.useCallback(
-    (newState: ((prev: T) => T) | T) => {
-      // @ts-expect-error https://github.com/microsoft/TypeScript/issues/37663
-      const val = typeof newState === 'function' ? newState(stateRef.current) : newState
-      stateRef.current = val
-      rerender((c) => c + 1)
-    },
-    [rerender],
-  )
-
-  return [stateRef, setStateAndRerender]
-}
-
-// Down-side of this implementation: Double render pass due to `setState` call (which forces a re-render)
-// Keeping around for now in case `useStateRefWithReactiveInput` doesn't work out
-// const _useStateWithReactiveInput = <T>(inputState: T): [T, (newState: T | ((prev: T) => T)) => void] => {
-//   const [externalState, setExternalState] = React.useState(inputState)
-
-//   if (externalState !== inputState) {
-//     setExternalState(inputState)
-//   }
-
-//   return [externalState, setExternalState]
-// }

package/src/store-context.ts

@@ -1,23 +0,0 @@
-import type { IntentionalShutdownCause, UnexpectedError } from '@livestore/common'
-import { Schema } from '@livestore/utils/effect'
-
-import type { Store } from './store.js'
-
-export type LiveStoreContext =
-  | LiveStoreContextRunning
-  | {
-      stage: 'error'
-      error: UnexpectedError | unknown
-    }
-  | {
-      stage: 'shutdown'
-      cause: IntentionalShutdownCause | StoreAbort
-    }
-
-export class StoreAbort extends Schema.TaggedError<StoreAbort>()('LiveStore.StoreAbort', {}) {}
-export class StoreInterrupted extends Schema.TaggedError<StoreInterrupted>()('LiveStore.StoreInterrupted', {}) {}
-
-export type LiveStoreContextRunning = {
-  stage: 'running'
-  store: Store
-}