@treenity/core 1.0.48 → 3.0.0

package/dist/comp/needs.js

@@ -0,0 +1,101 @@
+import { getCompByKey, isComponent } from '#core';
+import { basename, dirname, join } from '#core/path';
+// ── Needs store ──
+// Local map keyed by type@action. Populated by registerActionNeeds (called from registerType).
+// Separate from registry meta because needs are registered before actions exist in the registry.
+const needsMap = new Map();
+export function registerActionNeeds(type, action, patterns) {
+    needsMap.set(`${type}@${action}`, patterns.map(parseNeedPattern));
+}
+export function getActionNeeds(type, action) {
+    return needsMap.get(`${type}@${action}`)
+        ?? needsMap.get(`${type}@*`)
+        ?? [];
+}
+// ── Pattern parsing ──
+export function parseNeedPattern(p) {
+    if (p.startsWith('@'))
+        return { kind: 'field-ref', field: p.slice(1), key: p.slice(1) };
+    if (p.endsWith('/*'))
+        return { kind: 'children', path: p.slice(0, -2), key: basename(p.slice(0, -2)) };
+    if (p[0] === '/' || p.startsWith('./') || p.startsWith('../'))
+        return { kind: 'path', path: p, key: basename(p) };
+    return { kind: 'sibling', name: p, key: p };
+}
+function resolvePath(base, rel) {
+    if (rel[0] === '/')
+        return rel;
+    if (rel.startsWith('./'))
+        return join(base, rel.slice(2));
+    if (!rel.startsWith('../'))
+        throw new Error(`Invalid relative path: ${rel}`);
+    const parent = dirname(base);
+    if (!parent)
+        throw new Error(`Cannot resolve "../" from root`);
+    return join(parent, rel.slice(3));
+}
+// ── Dependency collection ──
+export async function collectDeps(node, componentName, actionName, store) {
+    const cv = getCompByKey(node, componentName);
+    if (!cv)
+        throw new Error(`Component "${componentName}" not found on ${node.$path}`);
+    const specs = getActionNeeds(cv.$type, actionName);
+    if (!specs.length)
+        return {};
+    const deps = {};
+    const async_ = [];
+    for (const s of specs) {
+        if (deps[s.key] !== undefined)
+            throw new Error(`Duplicate dep key "${s.key}"`);
+        if (s.kind === 'sibling') {
+            const v = node[s.name];
+            if (!isComponent(v))
+                throw new Error(`Needed sibling "${s.name}" not found on ${node.$path}`);
+            deps[s.key] = v;
+            continue;
+        }
+        // cross-node: resolve target path, then fetch
+        let target;
+        if (s.kind === 'field-ref') {
+            target = cv[s.field];
+            if (typeof target !== 'string')
+                throw new Error(`Field "${s.field}" on ${componentName} is not a path string`);
+        }
+        else {
+            target = resolvePath(node.$path, s.path);
+        }
+        if (s.kind === 'children') {
+            async_.push(store.getChildren(target).then(({ items }) => { deps[s.key] = items; }));
+        }
+        else {
+            async_.push(store.get(target).then(n => {
+                if (!n)
+                    throw new Error(`Dep "${s.key}" → "${target}" not found`);
+                deps[s.key] = n;
+            }));
+        }
+    }
+    if (async_.length)
+        await Promise.all(async_);
+    return deps;
+}
+// ── Backward compat ──
+export function collectSiblings(node, componentName) {
+    const cv = getCompByKey(node, componentName);
+    if (!cv)
+        throw new Error(`Component "${componentName}" not found on ${node.$path}`);
+    const specs = getActionNeeds(cv.$type, '*');
+    if (!specs.length)
+        return {};
+    const out = {};
+    for (const s of specs) {
+        if (s.kind !== 'sibling')
+            continue;
+        const v = node[s.name];
+        if (!isComponent(v))
+            throw new Error(`Needed component "${s.name}" not found on ${node.$path}`);
+        out[s.key] = v;
+    }
+    return out;
+}
+//# sourceMappingURL=needs.js.map

package/dist/comp/needs.js.map

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

package/dist/comp/validate.d.ts

@@ -0,0 +1,13 @@
+import { type ComponentData, type NodeData } from '#core';
+import type { PropertySchema, TypeSchema } from '#schema/types';
+export type ValidationError = {
+    path: string;
+    message: string;
+};
+type TypeValidator = (value: unknown, def: PropertySchema, path: string, errors: ValidationError[]) => void;
+export declare function addTypeValidator(type: string, fn: TypeValidator): void;
+export declare function validateValue(value: unknown, def: PropertySchema, path: string, errors: ValidationError[]): void;
+export declare function validateComponent(comp: ComponentData, schema: TypeSchema, field: string): ValidationError[];
+export declare function validateNode(node: NodeData): ValidationError[];
+export {};
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/comp/validate.ts"],"names":[],"mappings":"AAGA,OAAO,EAAW,KAAK,aAAa,EAAiB,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AAElF,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;AAoE5G,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,GAAG,IAAI,CAEtE;AAID,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,CAIhH;AAUD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,EAAE,CAM3G;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,eAAe,EAAE,CAc9D"}

package/dist/comp/validate.js

@@ -0,0 +1,117 @@
+// Component validation — shared between client and server
+// Type-dispatched validator tree: type check → dispatch → type-specific constraints + recurse
+import { AnyType, getComponents } from '#core';
+import { resolve } from '#core/registry';
+const typeValidators = {
+    string(value, def, path, errors) {
+        if (typeof value !== 'string') {
+            errors.push({ path, message: `expected string, got ${typeof value}` });
+            return;
+        }
+        const d = def;
+        if (typeof d.minLength === 'number' && value.length < d.minLength)
+            errors.push({ path, message: `min length ${d.minLength}, got ${value.length}` });
+        if (typeof d.maxLength === 'number' && value.length > d.maxLength)
+            errors.push({ path, message: `max length ${d.maxLength}, got ${value.length}` });
+        if (typeof d.pattern === 'string' && !new RegExp(d.pattern).test(value))
+            errors.push({ path, message: `must match /${d.pattern}/` });
+        if (def.enum && !def.enum.includes(value))
+            errors.push({ path, message: `must be one of: ${def.enum.join(', ')}` });
+    },
+    number(value, def, path, errors) {
+        if (typeof value !== 'number') {
+            errors.push({ path, message: `expected number, got ${typeof value}` });
+            return;
+        }
+        const d = def;
+        if (typeof d.minimum === 'number' && value < d.minimum)
+            errors.push({ path, message: `minimum ${d.minimum}, got ${value}` });
+        if (typeof d.maximum === 'number' && value > d.maximum)
+            errors.push({ path, message: `maximum ${d.maximum}, got ${value}` });
+    },
+    boolean(value, _def, path, errors) {
+        if (typeof value !== 'boolean')
+            errors.push({ path, message: `expected boolean, got ${typeof value}` });
+    },
+    array(value, def, path, errors) {
+        if (!Array.isArray(value)) {
+            errors.push({ path, message: `expected array, got ${typeof value}` });
+            return;
+        }
+        const d = def;
+        if (typeof d.minItems === 'number' && value.length < d.minItems)
+            errors.push({ path, message: `min items ${d.minItems}, got ${value.length}` });
+        if (typeof d.maxItems === 'number' && value.length > d.maxItems)
+            errors.push({ path, message: `max items ${d.maxItems}, got ${value.length}` });
+        if (!def.items)
+            return;
+        const items = def.items;
+        for (let i = 0; i < value.length; i++) {
+            if (value[i] === undefined || value[i] === null)
+                continue;
+            const ip = `${path}[${i}]`;
+            if (items.properties) {
+                if (typeof value[i] !== 'object' || value[i] === null) {
+                    errors.push({ path: ip, message: `expected object, got ${typeof value[i]}` });
+                }
+                else {
+                    validateObject(value[i], items.properties, ip, errors);
+                }
+            }
+            else if (items.type) {
+                validateValue(value[i], items, ip, errors);
+            }
+        }
+    },
+    object(value, def, path, errors) {
+        if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+            errors.push({ path, message: `expected object, got ${Array.isArray(value) ? 'array' : typeof value}` });
+            return;
+        }
+        const props = def.properties;
+        if (props)
+            validateObject(value, props, path, errors);
+    },
+};
+// ── Extension point ──
+export function addTypeValidator(type, fn) {
+    typeValidators[type] = fn;
+}
+// ── Core ──
+export function validateValue(value, def, path, errors) {
+    if (!def.type)
+        return;
+    const validator = typeValidators[def.type];
+    if (validator)
+        validator(value, def, path, errors);
+}
+function validateObject(obj, properties, basePath, errors) {
+    for (const [prop, propDef] of Object.entries(properties)) {
+        const val = obj[prop];
+        if (val === undefined || val === null)
+            continue;
+        validateValue(val, propDef, basePath ? `${basePath}.${prop}` : prop, errors);
+    }
+}
+export function validateComponent(comp, schema, field) {
+    if (!schema.properties)
+        return [];
+    const errors = [];
+    const basePath = field || comp.$type;
+    validateObject(comp, schema.properties, basePath, errors);
+    return errors;
+}
+export function validateNode(node) {
+    const errors = [];
+    for (const [name, comp] of getComponents(node, AnyType)) {
+        const schemaHandler = resolve(comp.$type, 'schema');
+        if (!schemaHandler)
+            continue;
+        const schema = schemaHandler();
+        if (!schema?.properties)
+            continue;
+        errors.push(...validateComponent(comp, schema, name));
+    }
+    return errors;
+}
+//# sourceMappingURL=validate.js.map

package/dist/comp/validate.js.map

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

package/dist/comp.d.ts

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

package/dist/comp.d.ts.map

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

package/dist/comp.js

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

package/dist/comp.js.map

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

package/dist/contexts/schema/index.d.ts

@@ -0,0 +1,7 @@
+export type SchemaHandler = () => Record<string, unknown>;
+declare module '#core/context' {
+    interface ContextHandlers {
+        schema: SchemaHandler;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/contexts/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/contexts/schema/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1D,OAAO,QAAQ,eAAe,CAAC;IAC7B,UAAU,eAAe;QACvB,MAAM,EAAE,aAAa,CAAC;KACvB;CACF"}

package/dist/contexts/schema/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/contexts/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contexts/schema/index.ts"],"names":[],"mappings":""}

package/dist/contexts/schema.d.ts

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

package/dist/contexts/schema.d.ts.map

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

package/dist/contexts/schema.js

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

package/dist/contexts/schema.js.map

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

package/dist/contexts/service/index.d.ts

@@ -0,0 +1,31 @@
+import { type NodeData } from '#core';
+import { type Tree } from '#tree';
+export type ServiceHandle = {
+    stop(): Promise<void>;
+};
+export type StoreEvent = {
+    type: 'set';
+    path: string;
+} | {
+    type: 'patch';
+    path: string;
+} | {
+    type: 'remove';
+    path: string;
+};
+export type StoreListener = (event: StoreEvent) => void;
+export type SubscribeOpts = {
+    children?: boolean;
+};
+export type ServiceCtx = {
+    store: Tree;
+    subscribe: (path: string, cb: StoreListener, opts?: SubscribeOpts) => () => void;
+};
+export type ServiceHandler = (node: NodeData, ctx: ServiceCtx) => Promise<ServiceHandle>;
+declare module '#core/context' {
+    interface ContextHandlers {
+        service: ServiceHandler;
+    }
+}
+export declare function startServices(store: Tree, subscribe: ServiceCtx['subscribe'], path?: string): Promise<ServiceHandle | null>;
+//# sourceMappingURL=index.d.ts.map

package/dist/contexts/service/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/contexts/service/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,QAAQ,EAAyB,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,OAAO,CAAC;AAIlC,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AACtD,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AACrC,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;AACxD,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AACnD,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,IAAI,CAAC;IACZ,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,aAAa,KAAK,MAAM,IAAI,CAAC;CAClF,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAEzF,OAAO,QAAQ,eAAe,CAAC;IAC7B,UAAU,eAAe;QACvB,OAAO,EAAE,cAAc,CAAC;KACzB;CACF;AAID,wBAAsB,aAAa,CACjC,KAAK,EAAE,IAAI,EACX,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,EAClC,IAAI,SAAmB,GACtB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAS/B"}

package/dist/contexts/service/index.js

@@ -0,0 +1,16 @@
+// Treenity Service Context — Layer 2
+// Service = register(type, "service", handler) → returns { stop() }
+import { resolve as resolveCtx } from '#core';
+// ── Bootstrap ──
+export async function startServices(store, subscribe, path = '/sys/autostart') {
+    const node = await store.get(path);
+    if (!node)
+        return null;
+    const handler = resolveCtx(node.$type, 'service');
+    if (!handler) {
+        console.error(`[service] no handler for ${node.$type}`);
+        return null;
+    }
+    return await handler(node, { store, subscribe });
+}
+//# sourceMappingURL=index.js.map

package/dist/contexts/service/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contexts/service/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,oEAAoE;AAEpE,OAAO,EAAiB,OAAO,IAAI,UAAU,EAAE,MAAM,OAAO,CAAC;AAwB7D,kBAAkB;AAElB,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAW,EACX,SAAkC,EAClC,IAAI,GAAG,gBAAgB;IAEvB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/contexts/service.d.ts

@@ -1,15 +1,2 @@
-import { Context, ContextImpl } from '../context';
-import { Node } from '../node';
-export interface Service<M = any> {
-    setup(params: {
-        meta: M;
-        node: Node;
-    }): Promise<void>;
-}
-export interface ServiceContextOptions {
-}
-export interface ServiceTypeContext extends Context<Service, ServiceContextOptions> {
-}
-export declare class ServiceTypeContextImpl extends ContextImpl<Service, ServiceContextOptions> implements ServiceTypeContext {
-}
+export * from './service/index';
 //# sourceMappingURL=service.d.ts.map

package/dist/contexts/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/contexts/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,MAAM,WAAW,OAAO,CAAC,CAAC,GAAG,GAAG;IAC9B,KAAK,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,qBAAqB;CAAG;AAEzC,MAAM,WAAW,kBAAmB,SAAQ,OAAO,CAAC,OAAO,EAAE,qBAAqB,CAAC;CAAG;AAEtF,qBAAa,sBACX,SAAQ,WAAW,CAAC,OAAO,EAAE,qBAAqB,CAClD,YAAW,kBAAkB;CAAG"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/contexts/service.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/contexts/service.js

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

package/dist/contexts/service.js.map

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

package/dist/contexts/telegram/index.d.ts

@@ -0,0 +1,19 @@
+import { type NodeData } from '#core';
+import { type Tree } from '#tree';
+import { Bot, type Context } from 'grammy';
+export type TgCtx = {
+    ctx: Context;
+    store: Tree;
+    node: NodeData;
+    params: string;
+    [key: string]: unknown;
+};
+export type TgHandler = (node: NodeData, tgCtx: TgCtx) => Promise<void>;
+export type TgMiddleware = (tgCtx: TgCtx, next: () => Promise<void>) => Promise<void>;
+declare module '#core/context' {
+    interface ContextHandlers {
+        telegram: TgHandler;
+    }
+}
+export declare function startBot(store: Tree, botPath: string, middlewares?: TgMiddleware[]): Promise<Bot<Context, import("grammy").Api<import("grammy").RawApi>>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/contexts/telegram/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/contexts/telegram/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmC,KAAK,QAAQ,EAAW,MAAM,OAAO,CAAC;AAEhF,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,GAAG,EAAE,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAI3C,MAAM,MAAM,KAAK,GAAG;IAClB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AACxE,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtF,OAAO,QAAQ,eAAe,CAAC;IAC7B,UAAU,eAAe;QACvB,QAAQ,EAAE,SAAS,CAAC;KACrB;CACF;AAiBD,wBAAsB,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,YAAY,EAAO,wEAuE5F"}

package/dist/contexts/telegram/index.js

@@ -0,0 +1,89 @@
+// Treenity Telegram Binding — Layer 2
+// Connects Grammy bot to Treenity tree.
+// Supports middleware pipelines, event routing, callback params.
+import { isComponent, resolve } from '#core';
+import { basename } from '#core/path';
+import { Bot } from 'grammy';
+// ── Middleware runner ──
+function runHandler(middlewares, tgCtx, handler) {
+    let i = 0;
+    const next = () => {
+        if (i < middlewares.length)
+            return middlewares[i++](tgCtx, next);
+        return handler(tgCtx.node, tgCtx);
+    };
+    return next();
+}
+// ── Start bot from tree ──
+export async function startBot(store, botPath, middlewares = []) {
+    const botNode = await store.get(botPath);
+    if (!botNode)
+        throw new Error(`Bot node not found: ${botPath}`);
+    const cfgVal = botNode['config'];
+    if (!isComponent(cfgVal))
+        throw new Error(`Bot node missing config component`);
+    const config = cfgVal;
+    const bot = new Bot(config.token);
+    const commandsPath = botPath + '/commands';
+    const onPath = botPath + '/on';
+    // event handlers from /bot/on/ children
+    const { items: eventNodes } = await store.getChildren(onPath);
+    for (const eventNode of eventNodes) {
+        const onVal = eventNode['on'];
+        if (!isComponent(onVal))
+            throw new Error(`Event node ${eventNode.$path} missing "on" component`);
+        const on = onVal;
+        bot.on(on.filter, async (ctx) => {
+            const handler = resolve(eventNode.$type, 'telegram');
+            if (!handler)
+                throw new Error(`No handler for event type "${eventNode.$type}"`);
+            const tgCtx = { ctx, store, node: eventNode, params: '' };
+            await runHandler(middlewares, tgCtx, handler);
+        });
+    }
+    // commands from /bot/commands/ children
+    const { items: commandNodes } = await store.getChildren(commandsPath);
+    for (const cmdNode of commandNodes) {
+        const cmd = basename(cmdNode.$path);
+        bot.command(cmd, async (ctx) => {
+            const handler = resolve(cmdNode.$type, 'telegram');
+            if (!handler)
+                throw new Error(`No handler for command "${cmd}"`);
+            const tgCtx = { ctx, store, node: cmdNode, params: '' };
+            await runHandler(middlewares, tgCtx, handler);
+        });
+    }
+    // callback queries: "action" or "action:param1:param2"
+    bot.on('callback_query:data', async (ctx) => {
+        const raw = ctx.callbackQuery.data;
+        const sep = raw.indexOf(':');
+        const action = sep === -1 ? raw : raw.slice(0, sep);
+        const params = sep === -1 ? '' : raw.slice(sep + 1);
+        const targetNode = await store.get(`${commandsPath}/${action}`);
+        if (!targetNode)
+            return ctx.answerCallbackQuery('Unknown action');
+        const handler = resolve(targetNode.$type, 'telegram');
+        if (!handler)
+            return ctx.answerCallbackQuery('No handler');
+        const tgCtx = { ctx, store, node: targetNode, params };
+        await runHandler(middlewares, tgCtx, handler);
+        await ctx.answerCallbackQuery();
+    });
+    bot.catch((err) => console.error('[bot]', err.message ?? err));
+    // text fallback
+    bot.on('message:text', async (ctx) => {
+        const startNode = await store.get(`${commandsPath}/start`);
+        if (startNode) {
+            const handler = resolve(startNode.$type, 'telegram');
+            if (handler) {
+                const tgCtx = { ctx, store, node: startNode, params: '' };
+                await runHandler(middlewares, tgCtx, handler);
+            }
+        }
+        else {
+            await ctx.reply('Try /start');
+        }
+    });
+    return bot;
+}
+//# sourceMappingURL=index.js.map

package/dist/contexts/telegram/index.js.map

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

package/dist/contexts/text/index.d.ts

@@ -0,0 +1,7 @@
+export type TextHandler = (data: Record<string, unknown>) => string;
+declare module '#core/context' {
+    interface ContextHandlers {
+        text: TextHandler;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/contexts/text/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/contexts/text/index.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;AAEpE,OAAO,QAAQ,eAAe,CAAC;IAC7B,UAAU,eAAe;QACvB,IAAI,EAAE,WAAW,CAAC;KACnB;CACF"}

package/dist/contexts/text/index.js

@@ -0,0 +1,9 @@
+// Text context — plain text rendering for CLI/server
+// Layer 2 binding. Registers "text" context handlers for primitive types.
+// Block-type text handlers belong in their mods
+import { register } from '#core';
+// Primitives
+register('string', 'text', (data) => String(data.value ?? ''));
+register('number', 'text', (data) => String(data.value ?? 0));
+register('boolean', 'text', (data) => data.value ? 'yes' : 'no');
+//# sourceMappingURL=index.js.map

package/dist/contexts/text/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contexts/text/index.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,0EAA0E;AAC1E,gDAAgD;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAUjC,aAAa;AACb,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;AAC/D,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;AAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC"}

package/dist/contexts/text.d.ts

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

package/dist/contexts/text.d.ts.map

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

package/dist/contexts/text.js

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

package/dist/contexts/text.js.map

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

package/dist/core/component.d.ts

@@ -0,0 +1,41 @@
+export type GroupPerm = {
+    g: string;
+    p: number;
+};
+export declare const R = 1, W = 2, A = 4, S = 8;
+export type ComponentData<T = Record<string, unknown>> = T & {
+    $type: string;
+    $acl?: GroupPerm[];
+};
+export type NodeData<T = Record<string, unknown>> = ComponentData<T> & {
+    $path: string;
+    $owner?: string;
+    $rev?: number;
+};
+export type Class<T = unknown> = new (...args: any[]) => T;
+export type TypeId<T = unknown> = string | {
+    $type: string;
+} | Class<T>;
+export declare function normalizeType(type: TypeId): string;
+export declare function isComponent(value: unknown): value is ComponentData;
+export declare function getCompByKey(node: NodeData, key: string): ComponentData | undefined;
+export declare const AnyType: {
+    $type: string;
+};
+export declare function isOfType<T>(value: unknown, type: TypeId): value is ComponentData<T>;
+export type Ref = {
+    $type?: string;
+    $ref: string;
+    $map?: string;
+};
+export declare function ref(path: string): Ref;
+export declare function isRef(value: unknown): value is Ref;
+export declare function assertNonSystemName(name: string): void;
+export declare function createNode<T = any, C = Record<string, ComponentData<any>>>(path: string, type: TypeId, data?: T, components?: C): NodeData<T & C>;
+export declare function getComponentField<T = unknown>(node: NodeData, type: TypeId<T>, field?: string): [ComponentData<T>, string] | undefined;
+export declare function getComponent<T = unknown>(node: NodeData, type: TypeId<T>, field?: string): ComponentData<T> | undefined;
+export declare function getComponents<T = unknown>(node: NodeData, type: TypeId<T>): [string, ComponentData<T>][];
+export declare function toStorageKeys(node: Record<string, unknown>): Record<string, unknown>;
+export declare function fromStorageKeys(doc: Record<string, unknown>): Record<string, unknown>;
+export declare function removeComponent(node: NodeData, name: string): boolean;
+//# sourceMappingURL=component.d.ts.map

package/dist/core/component.d.ts.map

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