@dxos/react-client 0.8.4-main.fffef41 → 0.9.0

package/dist/lib/node-esm/chunk-ZJMNF7GC.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/client/AgentHostingProvider.tsx", "../../../src/client/ClientProvider.tsx", "../../../src/banner.ts", "../../../src/client/context.ts", "../../../src/client/useClient.ts", "../../../src/client/useClientStatus.ts", "../../../src/client/useConfig.ts", "../../../src/client/useShell.ts", "../../../src/client/useStatus.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport React, { type PropsWithChildren, createContext, useContext, useState } from 'react';\n\nimport { type AgentHostingProviderClient, AgentManagerClient, FakeAgentHostingProvider } from '@dxos/client';\nimport { type Halo } from '@dxos/client/halo';\nimport { type Config } from '@dxos/config';\nimport { log } from '@dxos/log';\n\nimport { useClient } from '../client';\n\nexport type AgentHostingProviderProps = { config: Config; halo: Halo };\n\nexport const AgentHostingContext = createContext<AgentHostingProviderClient | null>(null);\n\n/**\n * Experimental agent hosting provider.\n * @param props\n * @constructor\n * @deprecated\n */\nexport const AgentHostingProvider = (props: PropsWithChildren) => {\n  const client = useClient();\n  const [agentHostingProviderClient] = useState(makeClient(client));\n  return (\n    <AgentHostingContext.Provider value={agentHostingProviderClient}> {props.children}</AgentHostingContext.Provider>\n  );\n};\n\nexport const useAgentHostingClient = () => {\n  return useContext(AgentHostingContext);\n};\n\nconst makeClient = ({ config, halo }: AgentHostingProviderProps) => {\n  const agentHostingConfig = config.get('runtime.services.agentHosting');\n  if (!agentHostingConfig) {\n    log('no agent hosting configured');\n    return null;\n  }\n\n  // TODO(nf): Dynamically discover based on runtime config.\n  let agentHostingProviderClient: AgentHostingProviderClient | null = null;\n  switch (agentHostingConfig.type) {\n    case 'LOCAL_TESTING': {\n      log('using FakeAgentHostingProvider');\n      return new FakeAgentHostingProvider();\n    }\n\n    case 'AGENTHOSTING_API': {\n      agentHostingProviderClient = new AgentManagerClient(config, halo);\n      if (agentHostingProviderClient.init()) {\n        return agentHostingProviderClient;\n      } else {\n        // Not authorized or error initializing.\n        return null;\n      }\n    }\n\n    default: {\n      log.error('Unknown agent hosting provider type: ' + agentHostingConfig.type);\n      return null;\n    }\n  }\n};\n", "//\n// Copyright 2020 DXOS.org\n//\n\nimport React, {\n  type FunctionComponent,\n  type PropsWithChildren,\n  forwardRef,\n  useEffect,\n  useImperativeHandle,\n  useState,\n} from 'react';\n\nimport { Client, type ClientOptions, type ClientServicesProvider, SystemStatus } from '@dxos/client';\nimport { type Config } from '@dxos/config';\nimport { registerSignalsRuntime } from '@dxos/echo-signals/react';\nimport { log } from '@dxos/log';\nimport { useAsyncEffect, useControlledState } from '@dxos/react-hooks';\nimport { type MaybePromise, type Provider, getAsyncProviderValue } from '@dxos/util';\n\nimport { printBanner } from '../banner';\n\nimport { ClientContext, type ClientContextProps } from './context';\n\n/**\n * Properties for the ClientProvider.\n */\nexport type ClientProviderProps = Omit<ClientOptions, 'config' | 'services'> &\n  Pick<ClientContextProps, 'status'> &\n  PropsWithChildren<{\n    /**\n     * Client object or async provider to enable to caller to do custom initialization.\n     *\n     * NOTE: For advanced use cases only.\n     */\n    client?: Client | Provider<Promise<Client>>;\n\n    /**\n     * Config object or async provider.\n     *\n     * NOTE: If a `client` is provided then `config` is ignored.\n     */\n    // TODO(burdon): Reconcile with ClientOptions.\n    config?: Config | Provider<Promise<Config>>;\n\n    /**\n     * Callback to enable the caller to create a custom ClientServicesProvider.\n     *\n     * NOTE: If a `client` is provided then `services` is ignored.\n     */\n    // TODO(burdon): Reconcile with ClientOptions.\n    services?: ClientServicesProvider | ((config?: Config) => MaybePromise<ClientServicesProvider>);\n\n    /**\n     * ReactNode to display until the client is available.\n     */\n    fallback?: FunctionComponent<Partial<ClientContextProps>>;\n\n    /**\n     * Enable (by default) registration of Preact signals runtime for reactive ECHO objects.\n     * @see https://www.npmjs.com/package/@preact/signals-react\n     */\n    signalsRuntime?: boolean;\n\n    /**\n     * Skip the DXOS banner.\n     */\n    noBanner?: boolean;\n\n    /**\n     * Post initialization hook to enable to caller to do custom initialization.\n     */\n    onInitialized?: (client: Client) => MaybePromise<void>;\n  }>;\n\n/**\n * Root component that provides the DXOS client instance to child components.\n * To be used with the `useClient` hook.\n */\nexport const ClientProvider = forwardRef<Client | undefined, ClientProviderProps>(\n  (\n    {\n      children,\n      config: configParam,\n      client: clientParam,\n      services: servicesParam,\n      status: statusParam,\n      fallback: Fallback = () => null,\n      signalsRuntime = true,\n      noBanner,\n      onInitialized,\n      ...options\n    },\n    forwardedRef,\n  ) => {\n    useEffect(() => {\n      // TODO(wittjosiah): Ideally this should be imported asynchronously because it is optional.\n      //   Unfortunately, async import seemed to break signals React instrumentation.\n      signalsRuntime && registerSignalsRuntime();\n    }, []);\n\n    // The client is initialized asynchronously.\n    // If an error occurs during initialization, it is caught and the state is set.\n    // This allows the error to be thrown in the render method.\n    // The assumption is that a client initialization error is fatal to the app.\n    // This error will be caught by the nearest error boundary.\n    const [error, setError] = useState();\n    if (error) {\n      throw error;\n    }\n\n    const [client, setClient] = useState(clientParam instanceof Client ? clientParam : undefined);\n\n    // Provide external access.\n    useImperativeHandle(forwardedRef, () => client, [client]);\n\n    // Client status subscription.\n    const [status, setStatus] = useControlledState(statusParam);\n    useEffect(() => {\n      if (!client) {\n        return;\n      }\n\n      const subscription = client.status.subscribe((status) => setStatus(status));\n      return () => subscription.unsubscribe();\n    }, [client]);\n\n    // Create and/or initialize client.\n    useAsyncEffect(async () => {\n      let disposed = false;\n      const initialize = async (client: Client) => {\n        if (!client.initialized) {\n          await client.initialize().catch((err) => {\n            if (!disposed) {\n              setError(err);\n            }\n          });\n          log('client ready');\n          await onInitialized?.(client);\n          log('initialization complete');\n        }\n\n        setClient(client);\n        if (!noBanner) {\n          printBanner(client);\n        }\n      };\n\n      let client: Client;\n      try {\n        if (clientParam) {\n          // Asynchronously request client.\n          client = await getAsyncProviderValue(clientParam);\n          await initialize(client);\n        } else {\n          // Asynchronously construct client (config may be undefined).\n          const config = await getAsyncProviderValue(configParam);\n          log('resolved config', { config });\n          const services = await getAsyncProviderValue(servicesParam, config);\n          log('created services', { services });\n          client = new Client({ config, services, ...options });\n          log('created client');\n          await initialize(client);\n        }\n      } catch (err) {\n        if (!disposed) {\n          log.catch(err);\n        }\n      }\n\n      return () => {\n        log('clean up');\n        disposed = true;\n        // Only destroy if the client is not provided by the parent.\n        if (!clientParam) {\n          void client\n            ?.destroy()\n            .then(() => {\n              log('destroyed');\n            })\n            .catch((err) => log.catch(err));\n        }\n      };\n    }, [configParam, clientParam, servicesParam, noBanner]);\n\n    if (!client?.initialized || status !== SystemStatus.ACTIVE) {\n      return <Fallback client={client} status={status} />;\n    }\n\n    return <ClientContext.Provider value={{ client, status }}>{children}</ClientContext.Provider>;\n  },\n);\n", "//\n// Copyright 2021 DXOS.org\n//\n\nimport { type Client } from '@dxos/client';\n\n// http://patorjk.com/software/taag/#p=testall&f=Patorjk-HeX&t=DXOS\nconst BANNER = (client: Client) => {\n  const commitHash = client.config.get('runtime.app.build.commitHash');\n  const hash = commitHash ? ` App Commit ${commitHash} \\n` : '';\n\n  return (\n    '\\n' +\n    '_/\\\\/\\\\/\\\\/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\/\\\\/\\\\______/\\\\/\\\\/\\\\/\\\\/\\\\_\\n' +\n    '_/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\__/\\\\/\\\\_________\\n' +\n    '_/\\\\/\\\\____/\\\\/\\\\______/\\\\/\\\\______/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\/\\\\/\\\\___\\n' +\n    '_/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\__________/\\\\/\\\\_\\n' +\n    '_/\\\\/\\\\/\\\\/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\____/\\\\/\\\\/\\\\/\\\\____/\\\\/\\\\/\\\\/\\\\/\\\\___\\n' +\n    `\\n DXOS Client ${client.version} \\n${hash}`\n  );\n};\n\nlet bannerPrinted = false;\n\nexport const printBanner = (client: Client) => {\n  if (bannerPrinted || window.location.hostname === 'localhost') {\n    return;\n  }\n\n  bannerPrinted = true;\n  // eslint-disable-next-line no-console\n  console.log(`%c${BANNER(client)}`, 'font-family: monospace;');\n};\n", "//\n// Copyright 2020 DXOS.org\n//\n\nimport { type Context, createContext } from 'react';\n\nimport { type Client, type SystemStatus } from '@dxos/client';\n\nexport type ClientContextProps = {\n  client: Client;\n  status?: SystemStatus | null;\n};\n\n/**\n * @internal Use ClientProvider to create or initialize the Client.\n */\nexport const ClientContext: Context<ClientContextProps | undefined> = createContext<ClientContextProps | undefined>(\n  undefined,\n);\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { useContext } from 'react';\n\nimport { raise } from '@dxos/debug';\n\nimport { ClientContext } from '../client/context';\n\n/**\n * Hook returning instance of DXOS client.\n * Requires ClientContext to be set via ClientProvider.\n */\nexport const useClient = () => {\n  const { client } = useContext(ClientContext) ?? raise(new Error('Missing ClientContext.'));\n  return client;\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { useEffect, useState } from 'react';\n\nimport { type Client, type SystemStatus } from '@dxos/client';\n\nexport const useClientStatus = (client: Client) => {\n  const [status, setStatus] = useState<SystemStatus | null>();\n  useEffect(() => {\n    if (!client) {\n      return;\n    }\n\n    const subscription = client.status.subscribe((status) => setStatus(status));\n    return () => subscription.unsubscribe();\n  }, [client, setStatus]);\n\n  return status;\n};\n", "//\n// Copyright 2020 DXOS.org\n//\n\nimport { useContext } from 'react';\n\nimport { raise } from '@dxos/debug';\n\nimport { ClientContext } from './context';\n\n/**\n * Hook returning config object used to initialize the DXOS client instance.\n * Requires ClientContext to be set via ClientProvider.\n */\nexport const useConfig = () => {\n  const { client } = useContext(ClientContext) ?? raise(new Error('Missing ClientContext.'));\n  return client.config;\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { useEffect, useState } from 'react';\n\nimport { type Shell, type ShellDisplay } from '@dxos/client';\n\nimport { useClient } from './useClient';\n\n/**\n * Helper hook to access the shell.\n */\nexport const useShell = (): Shell => {\n  const client = useClient();\n  return client.shell;\n};\n\n/**\n * Hook to access the shell’s display state.\n */\nexport const useShellDisplay = (): ShellDisplay => {\n  const client = useClient();\n  const [display, setDisplay] = useState(client.shell.display);\n  useEffect(() => client.shell.onDisplayChange(setDisplay), [client]);\n  return display;\n};\n", "//\n// Copyright 2022 DXOS.org\n//\n\nimport { useContext } from 'react';\n\nimport { type SystemStatus } from '@dxos/client';\nimport { raise } from '@dxos/debug';\n\nimport { ClientContext } from './context';\n\nexport const useStatus = (): SystemStatus | null | undefined => {\n  const { status } = useContext(ClientContext) ?? raise(new Error('Missing ClientContext.'));\n  return status;\n};\n"],
-  "mappings": "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",
-  "names": ["React", "createContext", "useContext", "useState", "AgentManagerClient", "FakeAgentHostingProvider", "log", "React", "forwardRef", "useEffect", "useImperativeHandle", "useState", "Client", "SystemStatus", "registerSignalsRuntime", "log", "useAsyncEffect", "useControlledState", "getAsyncProviderValue", "BANNER", "client", "commitHash", "config", "get", "hash", "version", "bannerPrinted", "printBanner", "window", "location", "hostname", "console", "log", "createContext", "ClientContext", "createContext", "undefined", "ClientProvider", "forwardRef", "children", "config", "configParam", "client", "clientParam", "services", "servicesParam", "status", "statusParam", "fallback", "Fallback", "signalsRuntime", "noBanner", "onInitialized", "options", "forwardedRef", "useEffect", "registerSignalsRuntime", "error", "setError", "useState", "setClient", "Client", "undefined", "useImperativeHandle", "setStatus", "useControlledState", "subscription", "subscribe", "unsubscribe", "useAsyncEffect", "disposed", "initialize", "initialized", "catch", "err", "log", "printBanner", "getAsyncProviderValue", "destroy", "then", "SystemStatus", "ACTIVE", "ClientContext", "Provider", "value", "useContext", "raise", "useClient", "client", "useContext", "ClientContext", "raise", "Error", "useEffect", "useState", "useClientStatus", "client", "status", "setStatus", "useState", "useEffect", "subscription", "subscribe", "unsubscribe", "useContext", "raise", "useConfig", "client", "useContext", "ClientContext", "raise", "Error", "config", "useEffect", "useState", "useShell", "client", "useClient", "shell", "useShellDisplay", "display", "setDisplay", "useState", "useEffect", "onDisplayChange", "useContext", "raise", "useStatus", "status", "useContext", "ClientContext", "raise", "Error", "AgentHostingContext", "createContext", "AgentHostingProvider", "props", "client", "useClient", "agentHostingProviderClient", "useState", "makeClient", "React", "Provider", "value", "children", "useAgentHostingClient", "useContext", "config", "halo", "agentHostingConfig", "get", "log", "type", "FakeAgentHostingProvider", "AgentManagerClient", "init", "error"]
-}

package/dist/types/src/echo/useQuery.d.ts

@@ -1,11 +0,0 @@
-import { type Echo, Filter, type Live, Query, type Queryable, type Space } from '@dxos/client/echo';
-interface UseQueryFn {
-    <Q extends Query.Any>(spaceOrEcho: Space | Echo | Queryable | undefined, query: Q, deps?: any[]): Live<Query.Type<Q>>[];
-    <F extends Filter.Any>(spaceOrEcho: Space | Echo | Queryable | undefined, filter: F, deps?: any[]): Live<Filter.Type<F>>[];
-}
-/**
- * Create subscription.
- */
-export declare const useQuery: UseQueryFn;
-export {};
-//# sourceMappingURL=useQuery.d.ts.map

package/dist/types/src/echo/useQuery.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useQuery.d.ts","sourceRoot":"","sources":["../../../../src/echo/useQuery.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,KAAK,KAAK,EAAW,MAAM,mBAAmB,CAAC;AAO7G,UAAU,UAAU;IAClB,CAAC,CAAC,SAAS,KAAK,CAAC,GAAG,EAClB,WAAW,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,EACjD,KAAK,EAAE,CAAC,EACR,IAAI,CAAC,EAAE,GAAG,EAAE,GACX,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEzB,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,EACnB,WAAW,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,EACjD,MAAM,EAAE,CAAC,EACT,IAAI,CAAC,EAAE,GAAG,EAAE,GACX,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;CAC3B;AAED;;GAEG;AAEH,eAAO,MAAM,QAAQ,EAAE,UAgCtB,CAAC"}

package/dist/types/src/echo/useQuery.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=useQuery.test.d.ts.map

package/dist/types/src/echo/useQuery.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useQuery.test.d.ts","sourceRoot":"","sources":["../../../../src/echo/useQuery.test.tsx"],"names":[],"mappings":""}

package/dist/types/src/echo/useQueue.d.ts

@@ -1,11 +0,0 @@
-import { type Queue } from '@dxos/client/echo';
-import { type Obj, type Relation } from '@dxos/echo';
-import { type DXN } from '@dxos/keys';
-export type UseQueueOptions = {
-    pollInterval?: number;
-};
-/**
- * Polls the given Edge queue.
- */
-export declare const useQueue: <T extends Obj.Any | Relation.Any>(queueDxn?: DXN, options?: UseQueueOptions) => Queue<T> | undefined;
-//# sourceMappingURL=useQueue.d.ts.map

package/dist/types/src/echo/useQueue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useQueue.d.ts","sourceRoot":"","sources":["../../../../src/echo/useQueue.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAMtC,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AAKH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,GAAG,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,EACvD,WAAW,GAAG,EACd,UAAS,eAAoB,KAC5B,KAAK,CAAC,CAAC,CAAC,GAAG,SA4Cb,CAAC"}

package/dist/types/src/echo/useSchema.d.ts

@@ -1,8 +0,0 @@
-import type * as Schema from 'effect/Schema';
-import { type Client } from '@dxos/client';
-import { type Space } from '@dxos/client/echo';
-/**
- * Subscribe to and retrieve schema changes from a space's schema registry.
- */
-export declare const useSchema: (client: Client, space: Space | undefined, typename: string | undefined) => Schema.Schema.AnyNoContext | undefined;
-//# sourceMappingURL=useSchema.d.ts.map

package/dist/types/src/echo/useSchema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useSchema.d.ts","sourceRoot":"","sources":["../../../../src/echo/useSchema.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAG7C,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG/C;;GAEG;AACH,eAAO,MAAM,SAAS,GACpB,QAAQ,MAAM,EACd,OAAO,KAAK,GAAG,SAAS,EACxB,UAAU,MAAM,GAAG,SAAS,KAC3B,MAAM,CAAC,MAAM,CAAC,YAAY,GAAG,SAmC/B,CAAC"}

package/dist/types/src/playwright/playwright.config.d.ts

@@ -1,3 +0,0 @@
-declare const _default: import("@playwright/test").PlaywrightTestConfig<{}, {}>;
-export default _default;
-//# sourceMappingURL=playwright.config.d.ts.map

package/dist/types/src/playwright/playwright.config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"playwright.config.d.ts","sourceRoot":"","sources":["../../../../src/playwright/playwright.config.ts"],"names":[],"mappings":";AAQA,wBAQG"}

package/dist/types/src/playwright/smoke.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=smoke.spec.d.ts.map

package/dist/types/src/playwright/smoke.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"smoke.spec.d.ts","sourceRoot":"","sources":["../../../../src/playwright/smoke.spec.ts"],"names":[],"mappings":""}

package/src/echo/useQuery.test.tsx

@@ -1,129 +0,0 @@
-//
-// Copyright 2022 DXOS.org
-//
-
-import { renderHook } from '@testing-library/react';
-import { describe, expect, test } from 'vitest';
-
-import { Expando, Filter } from '@dxos/client/echo';
-import { Obj, Type } from '@dxos/echo';
-
-import { createClient, createClientContextProvider } from '../testing/util';
-
-import { useQuery } from './useQuery';
-
-describe('useQuery', () => {
-  // TODO(dmaretskyi): Fix this test.
-  test.skip('deleting an element should result in correct render sequence', async () => {
-    // Setup: Create client and space.
-    const { client, space } = await createClient({ createIdentity: true, createSpace: true });
-    const wrapper = await createClientContextProvider(client);
-
-    // Create 3 test objects: Alice, Bob, Charlie.
-    const alice = Obj.make(Type.Expando, { name: 'Alice' });
-    const bob = Obj.make(Type.Expando, { name: 'Bob' });
-    const charlie = Obj.make(Type.Expando, { name: 'Charlie' });
-
-    space!.db.add(alice);
-    space!.db.add(bob);
-    space!.db.add(charlie);
-    await space!.db.flush();
-
-    // Track all renders to observe the bug.
-    const allRenders: string[][] = [];
-
-    // Setup useQuery hook that captures every render.
-    renderHook(
-      () => {
-        const objects = useQuery(space, Filter.type(Expando));
-
-        // Capture the names in this render.
-        const namesInThisRender = objects.map((obj) => obj.name);
-        allRenders.push([...namesInThisRender]);
-
-        return objects;
-      },
-      { wrapper },
-    );
-
-    // Wait for initial renders to complete.
-    await new Promise((resolve) => setTimeout(resolve, 100));
-
-    // THE BUG REPRODUCTION: Delete Bob.
-    space!.db.remove(bob);
-
-    // Wait for all reactive updates to complete.
-    await new Promise((resolve) => setTimeout(resolve, 500));
-
-    // TODO(ZaymonFC): Remove this comment once the flash bug is resolved.
-    /*
-     * NOTE(ZaymonFC):
-     *   Expected: 3 renders
-     *   1. [] (empty)
-     *   2. ['Alice', 'Bob', 'Charlie'] (all loaded)
-     *   3. ['Alice', 'Charlie'] (Bob removed, no flash)
-     *
-     *   Actual: 4 renders
-     *   1. [] (empty)
-     *   2. ['Alice', 'Bob', 'Charlie'] (all loaded)
-     *   3. ['Alice', 'Charlie', 'Bob'] (FLASH BUG - Bob moves to end!)x
-     *   4. ['Alice', 'Charlie'] (Bob finally removed)
-     */
-
-    expect(allRenders).toEqual([
-      [], // Initial loading state.
-      ['Alice', 'Bob', 'Charlie'], // All objects loaded.
-      ['Alice', 'Charlie'], // Bob removed (no flash).
-    ]);
-  });
-
-  test('bulk deleting multiple items should remove them from query results', async () => {
-    // Setup: Create client and space.
-    const { client, space } = await createClient({ createIdentity: true, createSpace: true });
-    const wrapper = await createClientContextProvider(client);
-
-    // Create 10 test objects: 1, 2, 3, ..., 10.
-    const objects = Array.from({ length: 10 }, (_, i) => Obj.make(Type.Expando, { value: i + 1 }));
-
-    objects.forEach((obj) => space!.db.add(obj));
-    await space!.db.flush();
-
-    // Track all renders to observe the bug.
-    const allRenders: number[][] = [];
-
-    // Setup useQuery hook that captures every render.
-    renderHook(
-      () => {
-        const queryObjects = useQuery(space, Filter.type(Expando));
-
-        // Capture the values in this render.
-        const valuesInThisRender = queryObjects.map((obj) => obj.value);
-        allRenders.push([...valuesInThisRender]);
-
-        return queryObjects;
-      },
-      { wrapper },
-    );
-
-    // Wait for initial renders to complete.
-    await new Promise((resolve) => setTimeout(resolve, 100));
-
-    // THE BUG REPRODUCTION: Delete all items in a loop.
-    for (const item of objects) {
-      space!.db.remove(item);
-    }
-
-    // Wait for all reactive updates to complete.
-    await new Promise((resolve) => setTimeout(resolve, 500));
-
-    // Convert to sets for order-independent comparison.
-    const renderSets = allRenders.map((render) => new Set(render));
-
-    expect(renderSets).toEqual([
-      new Set([]), // Initial loading state.
-      new Set([1, 2, 3, 4, 5, 6, 7, 8, 9, 10]), // All objects loaded.
-      // TODO(dmaretskyi): Fix this with query ordering.
-      new Set([]), // All items deleted.
-    ]);
-  });
-});

package/src/echo/useQuery.ts

@@ -1,64 +0,0 @@
-//
-// Copyright 2022 DXOS.org
-//
-
-import { useMemo, useSyncExternalStore } from 'react';
-
-import { type Echo, Filter, type Live, Query, type Queryable, type Space, isSpace } from '@dxos/client/echo';
-
-const EMPTY_ARRAY: never[] = [];
-
-const noop = () => {};
-
-// TODO(dmaretskyi): Queries are fully serializable, so we can remove `deps` argument.
-interface UseQueryFn {
-  <Q extends Query.Any>(
-    spaceOrEcho: Space | Echo | Queryable | undefined,
-    query: Q,
-    deps?: any[],
-  ): Live<Query.Type<Q>>[];
-
-  <F extends Filter.Any>(
-    spaceOrEcho: Space | Echo | Queryable | undefined,
-    filter: F,
-    deps?: any[],
-  ): Live<Filter.Type<F>>[];
-}
-
-/**
- * Create subscription.
- */
-// TODO(burdon): Sort?
-export const useQuery: UseQueryFn = (
-  // TODO(burdon): CRITICAL: Remove Space and just requre Queryable.
-  resource: Space | Echo | Queryable | undefined,
-  queryOrFilter: Query.Any | Filter.Any,
-  deps?: any[],
-): Live<unknown>[] => {
-  const query = Filter.is(queryOrFilter) ? Query.select(queryOrFilter) : queryOrFilter;
-
-  const { getObjects, subscribe } = useMemo(() => {
-    let queryResult = undefined;
-    if (resource) {
-      queryResult = isSpace(resource) ? resource.db.query(query) : resource.query(query);
-    }
-
-    let subscribed = false;
-    return {
-      getObjects: () => (subscribed && queryResult ? queryResult.objects : EMPTY_ARRAY),
-      subscribe: (cb: () => void) => {
-        subscribed = true;
-        const unsubscribe = queryResult?.subscribe(cb) ?? noop;
-        return () => {
-          unsubscribe?.();
-          subscribed = false;
-        };
-      },
-    };
-  }, [resource, JSON.stringify(query.ast), ...(deps ?? [])]);
-
-  // https://beta.reactjs.org/reference/react/useSyncExternalStore
-  // NOTE: This hook will resubscribe whenever the callback passed to the first argument changes; make sure it is stable.
-  const objects = useSyncExternalStore<Live<unknown>[] | undefined>(subscribe, getObjects);
-  return objects ?? [];
-};

package/src/echo/useQueue.ts

@@ -1,74 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { useEffect, useMemo, useRef } from 'react';
-
-import { type Queue } from '@dxos/client/echo';
-import { raise } from '@dxos/debug';
-import { type Obj, type Relation } from '@dxos/echo';
-import { type DXN } from '@dxos/keys';
-
-import { useClient } from '../client';
-
-const MIN_POLL_INTERVAL = 1_000;
-
-export type UseQueueOptions = {
-  pollInterval?: number;
-};
-
-/**
- * Polls the given Edge queue.
- */
-// TODO(burdon): Replace polling with socket?
-// TODO(dmaretskyi): Move into client package.
-// TODO(dmaretskyi): Consider passing the space into the hook to support queue DXNs without space id.
-// TODO(ZaymonFC): If queue is unchanged returned object should be refferentially stable on poll.
-export const useQueue = <T extends Obj.Any | Relation.Any>(
-  queueDxn?: DXN,
-  options: UseQueueOptions = {},
-): Queue<T> | undefined => {
-  const client = useClient();
-  const mountedRef = useRef(true);
-
-  const queue = useMemo<Queue<T> | undefined>(() => {
-    if (!queueDxn) {
-      return undefined;
-    }
-
-    const { spaceId } = queueDxn.asQueueDXN() ?? raise(new TypeError('Invalid queue DXN'));
-    return client.spaces.get(spaceId)?.queues.get<T>(queueDxn);
-  }, [client, queueDxn?.toString()]);
-
-  useEffect(() => {
-    void queue?.refresh();
-  }, [queue]);
-
-  useEffect(() => {
-    let timeout: NodeJS.Timeout;
-    mountedRef.current = true;
-
-    const poll = () => {
-      if (!mountedRef.current) {
-        return;
-      }
-
-      void queue?.refresh().finally(() => {
-        if (mountedRef.current && options.pollInterval) {
-          timeout = setTimeout(poll, Math.max(options.pollInterval ?? 0, MIN_POLL_INTERVAL));
-        }
-      });
-    };
-
-    if (options.pollInterval) {
-      poll();
-    }
-
-    return () => {
-      mountedRef.current = false;
-      clearTimeout(timeout);
-    };
-  }, [queue, options.pollInterval]);
-
-  return queue;
-};

package/src/echo/useSchema.ts

@@ -1,54 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import type * as Schema from 'effect/Schema';
-import { useMemo, useSyncExternalStore } from 'react';
-
-import { type Client } from '@dxos/client';
-import { type Space } from '@dxos/client/echo';
-import { type BaseSchema } from '@dxos/echo/internal';
-
-/**
- * Subscribe to and retrieve schema changes from a space's schema registry.
- */
-export const useSchema = (
-  client: Client,
-  space: Space | undefined,
-  typename: string | undefined,
-): Schema.Schema.AnyNoContext | undefined => {
-  const { subscribe, getSchema } = useMemo(() => {
-    if (!typename || !space) {
-      return {
-        subscribe: () => () => {},
-        getSchema: () => undefined,
-      };
-    }
-
-    const staticSchema = client.graph.schemaRegistry.getSchema(typename);
-    if (staticSchema) {
-      return {
-        subscribe: () => () => {},
-        getSchema: () => staticSchema,
-      };
-    }
-
-    const query = space.db.schemaRegistry.query({ typename });
-    const initialResult: BaseSchema = query.runSync()[0];
-    let currentSchema = initialResult;
-
-    return {
-      subscribe: (onStoreChange: () => void) => {
-        const unsubscribe = query.subscribe(() => {
-          currentSchema = query.results[0];
-          onStoreChange();
-        });
-
-        return unsubscribe;
-      },
-      getSchema: () => currentSchema,
-    };
-  }, [typename, space]);
-
-  return useSyncExternalStore(subscribe, getSchema);
-};

package/src/playwright/playwright.config.ts

@@ -1,17 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import { defineConfig } from '@playwright/test';
-
-import { e2ePreset } from '@dxos/test-utils/playwright';
-
-export default defineConfig({
-  ...e2ePreset(import.meta.dirname),
-  // TODO(wittjosiah): Avoid hard-coding ports.
-  webServer: {
-    command: 'moon run storybook:serve-e2e -- --port=9000',
-    port: 9000,
-    reuseExistingServer: false,
-  },
-});

package/src/playwright/smoke.spec.ts

@@ -1,24 +0,0 @@
-//
-// Copyright 2021 DXOS.org
-//
-
-import { type Page, expect, test } from '@playwright/test';
-
-import { setupPage, storybookUrl } from '@dxos/test-utils/playwright';
-
-test.describe('Smoke test', () => {
-  let page: Page;
-
-  test.beforeAll(async ({ browser }) => {
-    const result = await setupPage(browser, {
-      url: storybookUrl('sdk-react-client-withclientprovider--default', 9000),
-    });
-    page = result.page;
-    await page.locator(':text("initialized")').waitFor({ state: 'visible' });
-  });
-
-  // NOTE: This test depends on connecting to the default production deployed HALO vault.
-  test('Renders remote client info', async () => {
-    await expect(page.locator(':text("initialized")')).toBeVisible();
-  });
-});