@treenity/core 1.0.48 → 3.0.1

package/README.md

@@ -1,18 +1,78 @@
-# @treenity/core docs
-### Installation
-Create token with "api" **scope** [here](https://gitlab.com/-/profile/personal_access_tokens).
-Add private registry info to .npmrc file in root of project
-```
-@cluster:registry=https://gitlab.com/api/v4/projects/35830151/packages/npm/
-//gitlab.com/api/v4/projects/35830151/packages/npm/:_authToken=${TOKEN}
+# @treenity/core
+
+**A spatial protocol for typed data. Three primitives. Everything else composes.**
+
+A single business concept — say, an Order — lives in five places: database schema, ORM, API DTO, frontend state, validation rules. Each copy drifts. Each sync layer adds bugs. Meanwhile, AI agents drown in infinite code grammar with no structural guardrails.
+
+Treenity solves this with three primitives:
+
 ```
-Install:
+Node      = { $path, $type, ...components }
+Component = { $type, ...data }
+Context   = (Type, Context) → Handler
 ```
-TOKEN=<access_token> npm i @cluster/protocol
+
+## Install
+
+```bash
+npm install @treenity/core
 ```
 
-### Publish new version
-To publish new version you need gilab api access key:
+Or scaffold a full project:
+
 ```bash
-MY_TOKEN=<access_token> npm publish
+npx create-treenity my-app
+```
+
+## Quick Example
+
+```typescript
+import { registerType } from '@treenity/core/comp';
+
+class TodoItem {
+  title = '';
+  done = false;
+
+  toggle() {
+    this.done = !this.done;
+  }
+}
+
+registerType('todo.item', TodoItem);
 ```
+
+Fields = data schema. Methods = server-side actions. `toggle()` runs inside an Immer draft — mutate `this` freely, patches are generated and broadcast to subscribers.
+
+```typescript
+// React — one hook, fully typed
+const item = usePath('/todo/list/1', TodoItem);
+item.title;          // reactive read
+await item.toggle(); // tRPC mutation → Immer patch → SSE broadcast
+```
+
+## What You Get for Free
+
+| Feature | How |
+|---|---|
+| **Persistence** | Memory, filesystem, or MongoDB — composable store wrappers |
+| **Real-time sync** | SSE subscriptions, open two tabs and changes sync |
+| **Type validation** | JSON schemas auto-generated from classes |
+| **ACL** | Per-node bitmask permissions inherited down the tree |
+| **AI access** | Every node readable via MCP — Claude can query and mutate your data |
+| **Multi-surface** | Same type renders in React, Telegram, CLI — register context handlers |
+| **Mounts** | Mount MongoDB, REST APIs, other Treenity instances into one namespace |
+
+## Packages
+
+- **@treenity/core** — primitives, store, server, schema, actions
+- **@treenity/react** — hooks, admin UI, reactive cache
+
+## Links
+
+- [Quickstart — Todo App in 5 Minutes](https://github.com/treenity-ai/treenity/blob/main/docs/quickstart.md)
+- [Architecture & Decisions](https://github.com/treenity-ai/treenity/blob/main/CLAUDE.md)
+- [GitHub](https://github.com/treenity-ai/treenity)
+
+## License
+
+AGPL-3.0

package/dist/chain.d.ts

@@ -0,0 +1,19 @@
+import { type Ref } from '#core';
+export type PathSection = string | unknown[];
+type Primitive = undefined | null | boolean | string | number | symbol | bigint | void;
+type ValuePromise<T> = T extends Primitive ? Promise<T> : T extends Promise<any> ? T : Chain<T>;
+export type Chain<T> = Promise<T> & {
+    [K in keyof T]: T[K] extends TypedRef<infer U> ? Chain<U> : T[K] extends (...args: infer A) => infer R ? (...args: A) => ValuePromise<Awaited<NonNullable<R>>> : ValuePromise<Awaited<NonNullable<T[K]>>>;
+};
+export interface TypedRef<_T> {
+    readonly $type: 'ref';
+    $ref: string;
+}
+export declare function refVal<T>(Comp: (new () => T) & {
+    $type?: string;
+}, defaultPath?: string): TypedRef<T>;
+export declare function runPath(target: any, path: PathSection[]): Promise<any>;
+export declare function runPathWithRefs(target: any, path: PathSection[], resolveRef: (ref: Ref) => Promise<any>): Promise<any>;
+export declare const chain: <T>(target: T) => Chain<T>;
+export {};
+//# sourceMappingURL=chain.d.ts.map

package/dist/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../src/chain.ts"],"names":[],"mappings":"AAGA,OAAO,EAAS,KAAK,GAAG,EAAE,MAAM,OAAO,CAAC;AAExC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,EAAE,CAAA;AAI5C,KAAK,SAAS,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;AAEtF,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,GACtC,OAAO,CAAC,CAAC,CAAC,GACV,CAAC,SAAS,OAAO,CAAC,GAAG,CAAC,GACtB,CAAC,GACD,KAAK,CAAC,CAAC,CAAC,CAAA;AAEZ,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG;KACjC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,CAAC,GAC1C,KAAK,CAAC,CAAC,CAAC,GACR,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,GACxC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,GACrD,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/C,CAAA;AAID,MAAM,WAAW,QAAQ,CAAC,EAAE;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;CACb;AAID,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,WAAW,SAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAGjG;AAID,wBAAsB,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAS5E;AAGD,wBAAsB,eAAe,CACnC,MAAM,EAAE,GAAG,EACX,IAAI,EAAE,WAAW,EAAE,EACnB,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GACrC,OAAO,CAAC,GAAG,CAAC,CAcd;AAYD,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,QAAQ,CAAC,KAAG,KAAK,CAAC,CAAC,CAAiC,CAAA"}

package/dist/chain.js

@@ -0,0 +1,59 @@
+// Minimal call-chain: records property/call path, resolves lazily on await.
+// Ref resolution is opt-in via runPathWithRefs — chain itself is pure.
+import { isRef } from '#core';
+// Pass registered class (has .$type stamped by registerType) for TypeScript type inference.
+// Runtime only stores $ref — no class reference kept.
+export function refVal(Comp, defaultPath = '') {
+    void Comp; // type-only at runtime; $type from registerType could be stored if needed
+    return { $type: 'ref', $ref: defaultPath };
+}
+// ── Core ──
+export async function runPath(target, path) {
+    let cur = target, prev = target;
+    for (const step of path) {
+        if (cur == null)
+            throw new Error(`null at step: ${JSON.stringify(step)}`);
+        if (typeof step === 'string') {
+            prev = cur;
+            cur = cur[step];
+        }
+        else {
+            cur = cur.apply(prev, step);
+        }
+        if (cur?.then)
+            cur = await cur;
+    }
+    return cur;
+}
+// Server executor: same as runPath but auto-follows TypedRef fields
+export async function runPathWithRefs(target, path, resolveRef) {
+    let cur = target, prev = target;
+    for (const step of path) {
+        if (cur == null)
+            throw new Error(`null at step: ${JSON.stringify(step)}`);
+        if (typeof step === 'string') {
+            prev = cur;
+            cur = cur[step];
+            if (isRef(cur))
+                cur = await resolveRef(cur);
+        }
+        else {
+            cur = cur.apply(prev, step);
+        }
+        if (cur?.then)
+            cur = await cur;
+    }
+    return cur;
+}
+const make = (target, path) => new Proxy((() => { }), {
+    get: (_, p) => {
+        if (p === 'then')
+            return (res, rej) => runPath(target, path).then(res, rej);
+        if (typeof p === 'symbol')
+            return undefined;
+        return make(target, [...path, p]);
+    },
+    apply: (_, __, args) => make(target, [...path, args]),
+});
+export const chain = (target) => make(target, []);
+//# sourceMappingURL=chain.js.map

package/dist/chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../src/chain.ts"],"names":[],"mappings":"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"}

package/dist/client/handle.d.ts

@@ -0,0 +1,13 @@
+import { type Class, type TypeProxy } from '#comp';
+import type { TreenityClient } from './index';
+export declare function createNodeClient(client: TreenityClient): (path: string) => {
+    /** Typed actions proxy — calls execute over network, no fetch needed */
+    get<T extends object>(cls: Class<T>, key?: string): TypeProxy<T>;
+    /** Fetch node + typed proxy (data fields + action methods) */
+    fetch<T extends object>(cls: Class<T>, key?: string): Promise<TypeProxy<T>>;
+    /** Subscribe — callback with typed proxy on each change */
+    sub<T extends object>(cls: Class<T>, cb: (data: TypeProxy<T>) => void, key?: string): Promise<{
+        unsubscribe: () => void;
+    }>;
+};
+//# sourceMappingURL=handle.d.ts.map

package/dist/client/handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../../src/client/handle.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,IAI7C,MAAM,MAAM;IAClB,wEAAwE;QACpE,CAAC,SAAS,MAAM,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAIhE,8DAA8D;UAClD,CAAC,SAAS,MAAM,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAKjF,2DAA2D;QACjD,CAAC,SAAS,MAAM,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,QAAQ,MAAM;;;EAyB5F"}

package/dist/client/handle.js

@@ -0,0 +1,46 @@
+// Client node handle — typed access to remote nodes.
+// nc(path).get(Type).method() — actions, no fetch needed.
+// nc(path).fetch(Type) — async fetch + typed proxy.
+// nc(path).sub(Type, cb) — reactive subscription with typed data.
+import { makeTypedProxy } from '#comp/handle';
+export function createNodeClient(client) {
+    const execute = (input) => client.execute(input.path, input.action, input.data, { type: input.type, key: input.key });
+    return (path) => ({
+        /** Typed actions proxy — calls execute over network, no fetch needed */
+        get(cls, key) {
+            return makeTypedProxy(undefined, cls, path, execute, undefined, key);
+        },
+        /** Fetch node + typed proxy (data fields + action methods) */
+        async fetch(cls, key) {
+            const node = await client.tree.get(path);
+            return makeTypedProxy(node, cls, path, execute, undefined, key);
+        },
+        /** Subscribe — callback with typed proxy on each change */
+        async sub(cls, cb, key) {
+            let cached;
+            function notify() {
+                cb(makeTypedProxy(cached, cls, path, execute, undefined, key));
+            }
+            const { node, unsubscribe } = await client.watchPath(path, (event) => {
+                if (event.type === 'set') {
+                    cached = { $path: event.path, ...event.node };
+                    notify();
+                }
+                if (event.type === 'patch' && cached) {
+                    // Re-fetch on patch (optimize with applyPatch later)
+                    client.tree.get(path).then(fresh => {
+                        if (fresh) {
+                            cached = fresh;
+                            notify();
+                        }
+                    });
+                }
+            });
+            cached = node;
+            if (cached)
+                notify();
+            return { unsubscribe };
+        },
+    });
+}
+//# sourceMappingURL=handle.js.map

package/dist/client/handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle.js","sourceRoot":"","sources":["../../src/client/handle.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,0DAA0D;AAC1D,oDAAoD;AACpD,kEAAkE;AAGlE,OAAO,EAAE,cAAc,EAAkB,MAAM,cAAc,CAAC;AAI9D,MAAM,UAAU,gBAAgB,CAAC,MAAsB;IACrD,MAAM,OAAO,GAAc,CAAC,KAAK,EAAE,EAAE,CACnC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IAE7F,OAAO,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;QACxB,wEAAwE;QACxE,GAAG,CAAmB,GAAa,EAAE,GAAY;YAC/C,OAAO,cAAc,CAAI,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QAC1E,CAAC;QAED,8DAA8D;QAC9D,KAAK,CAAC,KAAK,CAAmB,GAAa,EAAE,GAAY;YACvD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzC,OAAO,cAAc,CAAI,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QACrE,CAAC;QAED,2DAA2D;QAC3D,KAAK,CAAC,GAAG,CAAmB,GAAa,EAAE,EAAgC,EAAE,GAAY;YACvF,IAAI,MAA4B,CAAC;YAEjC,SAAS,MAAM;gBACb,EAAE,CAAC,cAAc,CAAI,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;YACpE,CAAC;YAED,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;gBACnE,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;oBACzB,MAAM,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,EAAc,CAAC;oBAC1D,MAAM,EAAE,CAAC;gBACX,CAAC;gBACD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,EAAE,CAAC;oBACrC,qDAAqD;oBACrD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;wBACjC,IAAI,KAAK,EAAE,CAAC;4BAAC,MAAM,GAAG,KAAK,CAAC;4BAAC,MAAM,EAAE,CAAC;wBAAC,CAAC;oBAC1C,CAAC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,MAAM,GAAG,IAA4B,CAAC;YACtC,IAAI,MAAM;gBAAE,MAAM,EAAE,CAAC;YACrB,OAAO,EAAE,WAAW,EAAE,CAAC;QACzB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/client/index.d.ts

@@ -0,0 +1,21 @@
+import type { Tree } from '#tree';
+export type WatchSub = {
+    unsubscribe(): void;
+};
+export type TreenityClient = {
+    tree: Tree;
+    execute(path: string, action: string, data?: unknown, opts?: {
+        type?: string;
+        key?: string;
+    }): Promise<unknown>;
+    /** Global SSE stream — all events for this user */
+    watch(onEvent: (e: any) => void): WatchSub;
+    /** Watch specific path — registers watch + filters events. Returns initial node + subscription. */
+    watchPath(path: string, onEvent: (e: any) => void): Promise<{
+        node: any;
+        unsubscribe(): void;
+    }>;
+};
+export { createTrpcTransport } from './trpc';
+export { createNodeClient } from './handle';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAElC,MAAM,MAAM,QAAQ,GAAG;IAAE,WAAW,IAAI,IAAI,CAAA;CAAE,CAAC;AAE/C,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChH,mDAAmD;IACnD,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,GAAG,QAAQ,CAAC;IAC3C,mGAAmG;IACnG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,WAAW,IAAI,IAAI,CAAA;KAAE,CAAC,CAAC;CACjG,CAAC;AAEF,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,5 @@
+// Treenity Client SDK — transport-agnostic tree client interface.
+// Transports: trpc (now), ws (future), http (future).
+export { createTrpcTransport } from './trpc';
+export { createNodeClient } from './handle';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,sDAAsD;AAetD,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/dist/client/trpc.d.ts

@@ -0,0 +1,13 @@
+import type { TreeRouter } from '#server/trpc';
+import { createTRPCClient } from '@trpc/client';
+import type { TreenityClient } from './index';
+export type TrpcTransportOpts = {
+    url: string;
+    getToken?: () => string | null;
+    token?: string;
+    fetch?: (input: any, init?: any) => Promise<Response>;
+};
+export declare function createTrpcTransport(opts: TrpcTransportOpts): TreenityClient & {
+    trpc: ReturnType<typeof createTRPCClient<TreeRouter>>;
+};
+//# sourceMappingURL=trpc.d.ts.map

package/dist/client/trpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trpc.d.ts","sourceRoot":"","sources":["../../src/client/trpc.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAkD,MAAM,cAAc,CAAC;AAChG,OAAO,KAAK,EAAE,cAAc,EAAY,MAAM,SAAS,CAAC;AAExD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CACvD,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,cAAc,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAA;CAAE,CA2EvI"}

package/dist/client/trpc.js

@@ -0,0 +1,79 @@
+// tRPC transport for Treenity Client.
+// HTTP batch for queries/mutations, SSE for subscriptions.
+import { defaultPatch } from '#tree/patch';
+import { createTRPCClient, httpBatchLink, httpSubscriptionLink, splitLink } from '@trpc/client';
+export function createTrpcTransport(opts) {
+    const getToken = opts.getToken ?? (() => opts.token ?? null);
+    const trpc = createTRPCClient({
+        links: [
+            splitLink({
+                condition: (op) => op.type === 'subscription',
+                true: httpSubscriptionLink({
+                    url: `${opts.url}/trpc/`,
+                    connectionParams: () => {
+                        const t = getToken();
+                        return t ? { token: t } : {};
+                    },
+                }),
+                false: httpBatchLink({
+                    url: `${opts.url}/trpc/`,
+                    maxURLLength: 2048,
+                    headers: () => {
+                        const t = getToken();
+                        return t ? { Authorization: `Bearer ${t}` } : {};
+                    },
+                    ...(opts.fetch && { fetch: opts.fetch }),
+                }),
+            }),
+        ],
+    });
+    // Shared SSE connection for watchPath — lazy, one per transport
+    let eventSub = null;
+    const pathCbs = new Map();
+    function ensureSSE() {
+        if (eventSub)
+            return;
+        eventSub = trpc.events.subscribe(undefined, {
+            onData: (event) => {
+                if ('path' in event)
+                    pathCbs.get(event.path)?.forEach(cb => cb(event));
+            },
+        });
+    }
+    return {
+        tree: {
+            get: (path) => trpc.get.query({ path }),
+            getChildren: (path, opts) => trpc.getChildren.query({ path, ...opts }),
+            set: (node) => trpc.set.mutate({ node: node }),
+            remove: (path) => trpc.remove.mutate({ path }).then(() => true),
+            // TODO: add tRPC patch endpoint for single-RPC atomic patch
+            patch: (path, ops) => defaultPatch((p) => trpc.get.query({ path: p }), (n) => trpc.set.mutate({ node: n }).then(() => { }), path, ops),
+        },
+        execute: (path, action, data, o) => trpc.execute.mutate({ path, action, data, type: o?.type, key: o?.key }),
+        watch: (onEvent) => trpc.events.subscribe(undefined, { onData: onEvent }),
+        watchPath: async (path, onEvent) => {
+            const node = await trpc.get.query({ path, watch: true });
+            ensureSSE();
+            if (!pathCbs.has(path))
+                pathCbs.set(path, new Set());
+            pathCbs.get(path).add(onEvent);
+            return {
+                node,
+                unsubscribe() {
+                    const set = pathCbs.get(path);
+                    if (set) {
+                        set.delete(onEvent);
+                        if (!set.size)
+                            pathCbs.delete(path);
+                    }
+                    if (!pathCbs.size && eventSub) {
+                        eventSub.unsubscribe();
+                        eventSub = null;
+                    }
+                },
+            };
+        },
+        trpc,
+    };
+}
+//# sourceMappingURL=trpc.js.map

package/dist/client/trpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trpc.js","sourceRoot":"","sources":["../../src/client/trpc.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,2 @@
+export * from './client/index.ts';
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/client.js

@@ -0,0 +1,2 @@
+export * from "./client/index.js";
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/comp/handle.d.ts

@@ -0,0 +1,14 @@
+import { type Class, type TypeProxy } from './index';
+import { type NodeData } from '#core';
+export type ExecuteInput = {
+    path: string;
+    type?: string;
+    key?: string;
+    action: string;
+    data?: unknown;
+};
+export type ExecuteFn = (input: ExecuteInput) => Promise<unknown>;
+export type StreamFn = (input: ExecuteInput) => AsyncIterable<unknown>;
+/** Create TypeProxy from node data + class. Actions call execute/stream, fields read from comp. */
+export declare function makeTypedProxy<T extends object>(node: NodeData | undefined, cls: Class<T>, path: string, execute: ExecuteFn, stream?: StreamFn, key?: string): TypeProxy<T>;
+//# sourceMappingURL=handle.d.ts.map

package/dist/comp/handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../../src/comp/handle.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAgB,KAAK,QAAQ,EAAiB,MAAM,OAAO,CAAC;AAEnE,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AACzG,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAClE,MAAM,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,aAAa,CAAC,OAAO,CAAC,CAAC;AAIvE,mGAAmG;AACnG,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC7C,IAAI,EAAE,QAAQ,GAAG,SAAS,EAC1B,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,EAClB,MAAM,CAAC,EAAE,QAAQ,EACjB,GAAG,CAAC,EAAE,MAAM,GACX,SAAS,CAAC,CAAC,CAAC,CAed"}

package/dist/comp/handle.js

@@ -0,0 +1,21 @@
+// Shared typed proxy factory — L0, no server deps.
+// Used by: server (serverNodeHandle), client (createNodeClient), React (hooks).
+import { getComponent, normalizeType } from '#core';
+const AsyncGenFn = Object.getPrototypeOf(async function* () { }).constructor;
+/** Create TypeProxy from node data + class. Actions call execute/stream, fields read from comp. */
+export function makeTypedProxy(node, cls, path, execute, stream, key) {
+    const type = normalizeType(cls);
+    const comp = node ? getComponent(node, cls, key) : undefined;
+    return new Proxy(comp ?? {}, {
+        get: (_t, prop) => {
+            const fn = cls.prototype[prop];
+            if (typeof fn === 'function') {
+                if (stream && fn instanceof AsyncGenFn)
+                    return (data) => stream({ path, type, key, action: prop, data });
+                return (data) => execute({ path, type, key, action: prop, data });
+            }
+            return comp?.[prop];
+        },
+    });
+}
+//# sourceMappingURL=handle.js.map

package/dist/comp/handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle.js","sourceRoot":"","sources":["../../src/comp/handle.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,gFAAgF;AAGhF,OAAO,EAAE,YAAY,EAAiB,aAAa,EAAE,MAAM,OAAO,CAAC;AAMnE,MAAM,UAAU,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,SAAS,CAAC,MAAK,CAAC,CAAC,CAAC,WAAW,CAAC;AAE5E,mGAAmG;AACnG,MAAM,UAAU,cAAc,CAC5B,IAA0B,EAC1B,GAAa,EACb,IAAY,EACZ,OAAkB,EAClB,MAAiB,EACjB,GAAY;IAEZ,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE7D,OAAO,IAAI,KAAK,CAAC,IAAI,IAAI,EAAO,EAAE;QAChC,GAAG,EAAE,CAAC,EAAE,EAAE,IAAY,EAAE,EAAE;YACxB,MAAM,EAAE,GAAI,GAAG,CAAC,SAAiB,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;gBAC7B,IAAI,MAAM,IAAI,EAAE,YAAY,UAAU;oBACpC,OAAO,CAAC,IAAc,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC7E,OAAO,CAAC,IAAc,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9E,CAAC;YACD,OAAQ,IAAY,EAAE,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;KACF,CAAiB,CAAC;AACrB,CAAC"}

package/dist/comp/index.d.ts

@@ -0,0 +1,41 @@
+import { type Class, ComponentData, NodeData, type TypeId } from '#core';
+import { type Tree } from '#tree';
+export type { Class };
+export type TypeClass<T> = Class<T> & {
+    $type: string;
+};
+export type Raw<T> = {
+    [K in keyof T as T[K] extends Function ? never : K]: T[K] extends (infer U)[] ? U extends object ? Raw<U>[] : T[K] : T[K] extends object ? Raw<T[K]> : T[K];
+};
+type _AnyFn = (...args: any[]) => any;
+type _ToFn<T> = T extends _AnyFn ? T : never;
+export type Actions<T> = {
+    [K in keyof T as T[K] extends Function ? K : never]: ReturnType<_ToFn<T[K]>> extends AsyncGenerator<infer Y, any, any> ? Parameters<_ToFn<T[K]>> extends [infer D, ...any[]] ? (data: D) => AsyncIterable<Y> : () => AsyncIterable<Y> : Parameters<_ToFn<T[K]>> extends [infer D, ...any[]] ? (data: D) => Promise<Awaited<ReturnType<_ToFn<T[K]>>>> : () => Promise<Awaited<ReturnType<_ToFn<T[K]>>>>;
+};
+export type TypeProxy<T> = Raw<T> & Actions<T>;
+declare module '#core/context' {
+    interface ContextHandlers {
+        class: Class<object>;
+    }
+}
+export type ExecCtx = {
+    node: NodeData;
+    store: Tree;
+    signal: AbortSignal;
+    [k: string]: unknown;
+};
+export declare function getCtx(): ExecCtx;
+export type PortDecl = {
+    pre?: string[];
+    post?: string[];
+};
+type CompOptions = {
+    needs?: string[];
+    ports?: Record<string, PortDecl>;
+};
+export declare function registerType<T extends object>(type: string, cls: Class<T>, opts?: CompOptions): TypeClass<T>;
+export declare function registerActions<T>(type: TypeId, cls: Class<T>, opts?: CompOptions): void;
+export declare function setComp<T>(node: NodeData, cls: Class<T>, data: Partial<Raw<T>>, field?: string): void;
+export declare function newComp<T>(cls: Class<T>, data: Partial<Raw<T>>): ComponentData<T>;
+export declare function getDefaults<T = any>(type: TypeId<T>): Partial<Raw<T>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/comp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/comp/index.ts"],"names":[],"mappings":"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"}

package/dist/comp/index.js

@@ -0,0 +1,127 @@
+// Treenity Component Registration — between core and server
+// registerType(type, cls) → stamps $type, registers class, auto-registers actions from methods
+import { registerActionNeeds } from '#comp/needs';
+import { getComponent, normalizeType, register, resolve, } from '#core';
+// Wire ExecCtx into logger — safe (returns null outside action context)
+import { setCtxProvider } from '#log';
+import { trackType } from '#mod/tracking';
+// ── Action context for class methods ──
+// Node.js: AsyncLocalStorage (survives await, concurrent-safe)
+// Browser: global _ctx fallback (NOT safe with concurrent async actions — needs polyfill)
+let _als = null;
+let _ctx = null;
+// Async init — resolves before any action can fire (server boot is async).
+// Browser: import fails → _als stays null → falls back to _ctx global.
+import('node:async_hooks')
+    .then(m => { _als = new m.AsyncLocalStorage(); })
+    .catch(() => { });
+setCtxProvider(() => _als?.getStore() ?? _ctx);
+export function getCtx() {
+    const ctx = _als?.getStore() ?? _ctx;
+    if (!ctx)
+        throw new Error('getCtx(): called outside action context');
+    return ctx;
+}
+export function registerType(type, cls, opts) {
+    const compClass = cls;
+    compClass.$type = normalizeType(type);
+    // Bracket access in treeChain: proxy[Counter] → Proxy.get(_, "§app.counter")
+    cls[Symbol.toPrimitive] = () => `§${compClass.$type}`;
+    register(type, 'class', cls, opts);
+    trackType(compClass.$type);
+    // Per-action needs from static property on class
+    const staticNeeds = cls.needs;
+    if (staticNeeds) {
+        for (const [action, patterns] of Object.entries(staticNeeds)) {
+            registerActionNeeds(type, action, patterns);
+        }
+    }
+    // opts.needs = global fallback ('*') for all actions
+    if (opts?.needs)
+        registerActionNeeds(type, '*', opts.needs);
+    const proto = cls.prototype;
+    for (const name of Object.getOwnPropertyNames(proto)) {
+        if (name === 'constructor')
+            continue;
+        if (typeof proto[name] === 'function') {
+            register(type, `action:${name}`, (ctx, data) => {
+                const target = ctx.comp ?? ctx.node;
+                if (_als)
+                    return _als.run(ctx, () => proto[name].call(target, data, ctx.deps));
+                _ctx = ctx;
+                try {
+                    return proto[name].call(target, data, ctx.deps);
+                }
+                finally {
+                    _ctx = null;
+                }
+            }, opts?.ports?.[name]);
+        }
+    }
+    return compClass;
+}
+// Register server-only actions from a class. _ prefixed = internal (hidden from clients).
+export function registerActions(type, cls, opts) {
+    const t = normalizeType(type);
+    const proto = cls.prototype;
+    for (const name of Object.getOwnPropertyNames(proto)) {
+        if (name === 'constructor')
+            continue;
+        if (typeof proto[name] === 'function') {
+            register(t, `action:${name}`, (ctx, data) => {
+                const target = ctx.comp ?? ctx.node;
+                if (_als)
+                    return _als.run(ctx, () => proto[name].call(target, data, ctx.deps));
+                _ctx = ctx;
+                try {
+                    return proto[name].call(target, data, ctx.deps);
+                }
+                finally {
+                    _ctx = null;
+                }
+            }, opts?.ports?.[name]);
+        }
+    }
+}
+// ── Type-safe component access ──
+export function setComp(node, cls, data, field) {
+    const comp = getComponent(node, cls, field);
+    if (comp) {
+        Object.assign(comp, data);
+    }
+    else {
+        const $type = normalizeType(cls);
+        const name = field ?? $type.split('.').at(-1);
+        if (node[name])
+            throw new Error(`Component ${name} already exists on ${node.$path}`);
+        node[name] = newComp(cls, data);
+    }
+}
+export function newComp(cls, data) {
+    const $type = normalizeType(cls);
+    return Object.assign({ $type }, data, { $type });
+}
+// Get default field values for a type: class instance fields → schema defaults → {}
+export function getDefaults(type) {
+    // 1. Try registered class — new Class() gives field initializers
+    const cls = resolve(type, 'class');
+    if (cls) {
+        const inst = new cls();
+        return Object.assign({}, inst);
+    }
+    // 2. Fall back to JSON schema defaults
+    const schemaHandler = resolve(type, 'schema');
+    if (schemaHandler) {
+        const schema = schemaHandler();
+        if (schema?.properties) {
+            const out = {};
+            for (const [k, prop] of Object.entries(schema.properties)) {
+                if ('default' in prop)
+                    out[k] = prop.default;
+            }
+            return out;
+        }
+    }
+    return {};
+}
+//# sourceMappingURL=index.js.map