@telorun/sdk 0.2.7 → 0.2.8

package/dist/module-context.js

@@ -1,177 +1 @@
-import { EvaluationContext } from "./evaluation-context.js";
-/** Wraps process.env so that missing keys return null instead of throwing in CEL.
- * cel-js uses Object.hasOwn(obj, key) before accessing obj[key], so we must
- * intercept getOwnPropertyDescriptor to report every string key as "own". */
-function lenientEnv(env) {
-    return new Proxy(env, {
-        get(target, key) {
-            if (typeof key !== "string")
-                return target[key];
-            return key in target ? (target[key] ?? null) : null;
-        },
-        has() {
-            return true;
-        },
-        getOwnPropertyDescriptor(target, key) {
-            if (typeof key !== "string")
-                return Object.getOwnPropertyDescriptor(target, key);
-            const value = key in target ? (target[key] ?? null) : null;
-            return { configurable: true, enumerable: true, writable: true, value };
-        },
-    });
-}
-function collectSecretValues(secrets) {
-    const values = new Set();
-    for (const value of Object.values(secrets)) {
-        if (typeof value === "string" && value.length > 0) {
-            values.add(value);
-        }
-    }
-    return values;
-}
-/**
- * Persistent, module-scoped context. Three reserved CEL namespaces:
- * variables, secrets, resources.
- *
- * Unlike the base EvaluationContext, ModuleContext is stateful and mutable:
- * variables/secrets/resources accumulate during multi-pass initialization and
- * the context record is rebuilt on each mutation. Import aliases are tracked
- * here for alias-prefixed kind resolution (e.g. MyImport.Http.Route).
- *
- * Imported modules are surfaced under resources.<alias> alongside local
- * resources — no separate imports namespace needed.
- */
-export class ModuleContext extends EvaluationContext {
-    targets;
-    _hostEnv;
-    _variables;
-    _secrets;
-    _resources;
-    /** Maps import alias → real module name for kind resolution. */
-    importAliases = new Map();
-    /** Maps import alias → allowed kind names. Absent entry = unrestricted (e.g. Kernel). */
-    importedKinds = new Map();
-    constructor(source, variables = {}, secrets = {}, resources = {}, targets = [], createInstance = async () => null, emit, _hostEnv) {
-        super(source, {}, createInstance, new Set(), emit);
-        this.targets = targets;
-        this._hostEnv = _hostEnv;
-        this._variables = variables;
-        this._secrets = secrets;
-        this._resources = resources;
-        this._rebuildContext();
-    }
-    get variables() {
-        return this._variables;
-    }
-    get secrets() {
-        return this._secrets;
-    }
-    get resources() {
-        return this._resources;
-    }
-    setVariables(vars) {
-        this._variables = vars;
-        this._rebuildContext();
-    }
-    setTargets(vars) {
-        this.targets = vars;
-    }
-    setSecrets(secrets) {
-        this._secrets = secrets;
-        this._rebuildContext();
-    }
-    setResource(name, props) {
-        this._resources = { ...this._resources, [name]: props };
-        this._rebuildContext();
-    }
-    onResourceSnapshotted(name, snap) {
-        this.setResource(name, snap);
-    }
-    /**
-     * Register an imported module under the given alias, with the list of kind names
-     * it exports. An empty kinds array means no restriction (used for built-ins like Kernel).
-     */
-    registerImport(alias, targetModule, kinds) {
-        this.importAliases.set(alias, targetModule);
-        if (kinds.length > 0) {
-            this.importedKinds.set(alias, new Set(kinds));
-        }
-    }
-    getInstance(name) {
-        const entry = this.resourceInstances.get(name);
-        if (!entry) {
-            throw new Error(`Resource '${name}' not found in module context. Available resources: ${[...this.resourceInstances.keys()].join(", ")}`);
-        }
-        return entry?.instance;
-    }
-    getInvocable(name) {
-        const instance = this.getInstance(name);
-        if (instance &&
-            typeof instance === "object" &&
-            "invoke" in instance &&
-            typeof instance.invoke !== "function") {
-            throw new Error(`Resource '${name}' does not have an invoke() method.`);
-        }
-        return instance;
-    }
-    /**
-     * Resolve a fully-qualified kind like "Http.Server" to its real kind "http-server.Server".
-     * Splits on the first dot, looks up the prefix in importAliases, validates against
-     * importedKinds (if set), and reconstructs the resolved kind.
-     * Throws with a clear message if the alias is unknown or the kind is not exported.
-     */
-    resolveKind(kind) {
-        const dot = kind.indexOf(".");
-        if (dot === -1) {
-            throw new Error(`Kind '${kind}' must be fully qualified (e.g. 'Module.KindName')`);
-        }
-        const prefix = kind.slice(0, dot);
-        const suffix = kind.slice(dot + 1);
-        const realModule = this.importAliases.get(prefix);
-        if (!realModule) {
-            const known = [...this.importAliases.keys()].join(", ") || "(none)";
-            throw new Error(`Kind '${kind}': no module imported with alias '${prefix}'. Known aliases: ${known}`);
-        }
-        const allowed = this.importedKinds.get(prefix);
-        if (allowed !== undefined && !allowed.has(suffix)) {
-            throw new Error(`Kind '${suffix}' is not exported by module '${realModule}' (imported as '${prefix}'). ` +
-                `Exported kinds: ${[...allowed].join(", ")}`);
-        }
-        return `${realModule}.${suffix}`;
-    }
-    _rebuildContext() {
-        this._context = {
-            variables: this._variables,
-            secrets: this._secrets,
-            resources: this._resources,
-            ...(this._hostEnv ? { env: lenientEnv(this._hostEnv) } : {}),
-        };
-        this._secretValues = collectSecretValues(this._secrets);
-    }
-    async invoke(kind, name, inputs) {
-        const result = await super.invoke(kind, name, inputs);
-        const entry = this.resourceInstances.get(name);
-        if (entry && typeof entry.instance.snapshot === "function") {
-            const snap = await Promise.resolve(entry.instance.snapshot());
-            this.setResource(name, snap);
-        }
-        return result;
-    }
-    async run(name) {
-        const resource = this.resourceInstances.get(name);
-        if (!resource) {
-            throw new Error(`Target resource ${name} not found in module context. Available resources: ${[...this.resourceInstances.keys()].join(", ")}`);
-        }
-        if (typeof resource.instance.run === "function") {
-            await resource.instance.run();
-        }
-        else {
-            throw new Error(`Target resource ${name} does not have a run() method.`);
-        }
-    }
-    async runTargets() {
-        for (const target of this.targets) {
-            await this.run(target);
-        }
-    }
-}
+export {};

package/package.json

@@ -1,6 +1,24 @@
 {
   "name": "@telorun/sdk",
-  "version": "0.2.7",
+  "version": "0.2.8",
+  "description": "Telo SDK - Public API for Telo module authors.",
+  "keywords": [
+    "telo",
+    "sdk",
+    "runtime",
+    "modules"
+  ],
+  "author": "Bartosz Pasiński <bartosz.pasinski@codenet.pl>",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/telorun/telo.git",
+    "directory": "sdk/nodejs"
+  },
+  "homepage": "https://github.com/telorun/telo#readme",
+  "bugs": {
+    "url": "https://github.com/telorun/telo/issues"
+  },
   "type": "module",
   "main": "./dist/index.js",
   "exports": {