@synap-core/hydration

Hydration-style onboarding shared between Studio (Next.js) and Relay (Expo). The user lands workspace-less, greets the Orchestrator in a personal channel, dumps data (markdown folder, LinkedIn archive, Apple Notes, raw paste, files, ZIPs), the AI structures each item into entity proposals, and the user reviews before approving.

This package owns the types, state machine, importer registry, and pipeline orchestration for that flow. It is platform-agnostic: no React, no UI, no fetch. Studio and Relay each plug in their own HydrationClient (tRPC wrapper in Studio, HTTP wrapper in Relay) and render their own UI.

Install

{
  "dependencies": { "@synap-core/hydration": "workspace:*" }
}

Architecture

• flow/ — HydrationState, pure hydrationReducer, stage transitions + guards.
• importers/ — Importer interface, ImporterRegistry, seven built-ins: markdown, raw-text, file-upload, telegram, linkedin, apple-notes (stub), file-upload.
• pipeline/ — runItem and runBatch glue importers to the HydrationClient.
• proposals/ — BulkReviewState + reducer for the grouped approval UI (selection, per-item edits).

The consumer (Studio or Relay) is responsible for:

1. Providing a HydrationClient implementation.
2. Reading files off disk / user input into ImporterInput shapes.
3. Driving the reducer from UI events.
4. Rendering. Everything visual lands in Phase 3.

Quick tour

import {
  ImporterRegistry,
  registerDefaultImporters,
  initialHydrationState,
  hydrationReducer,
  runBatch,
} from '@synap-core/hydration';

const registry = new ImporterRegistry();
registerDefaultImporters(registry);

const importer = registry.get('markdown');
const payloads = await importer!.parse({ name: 'note.md', type: 'text/markdown', bytes }, ctx);