Extension API Reference

The @eidos.space/react package provides a set of React hooks and utilities for building Eidos extensions. It allows extensions to interact with Eidos data, UI, and system services in a type-safe manner across different rendering environments.

useEidos

React hook to access the Eidos SDK.

Usage

import { useEidos } from "@eidos.space/react"

function MyExtension() {
  const eidos = useEidos()

  // Example: Query table (tableId is a UUIDv7 without dashes)
  const Users = eidos.space.table("01935b4c9d2e7f8a0b1c2d3e4f5a6b7c")
  const users = await Users.findMany()

  // Example: Read file
  eidos.space.fs.readFile("/path/to/file", "utf8")
}

Signature

Property	Type	Description
currentSpace	DataSpace	Current space data access
space	DataSpace	Alias for currentSpace
AI	object	AI capabilities (text/object generation)

---

useExtensionContext

React hook to retrieve typed extension context.

Usage

import {
  useExtensionContext,
  type FileHandlerContext,
} from "@eidos.space/react"

function MyExtension() {
  const ctx = useExtensionContext<FileHandlerContext>()
  console.log(ctx.filePath)
}

Context Types

ExtNodeContext

Property	Type	Description
type	"extNode"	Discriminator
space	string	Current space name
nodeId	string	Unique node ID

TableViewContext

Property	Type	Description
type	"tableView"	Discriminator
space	string	Current space name
tableId	string	Target table ID
viewId	string	Target view ID

FileHandlerContext

Property	Type	Description
type	"fileHandler"	Discriminator
space	string	Current space name
filePath	string	Absolute file path

---

Utilities

Type Guards

import {
  isExtNodeContext,
  isFileHandlerContext,
  isTableViewContext,
} from "@eidos.space/react"

const ctx = useExtensionContext()

if (isExtNodeContext(ctx)) {
  // ctx.nodeId is available
}