@omriashke/dynamico-core 0.1.0

package/dist/registry.js

@@ -0,0 +1,231 @@
+import { loadModule } from "./loader.js";
+/**
+ * In-memory, versioned registry of dynamic components.
+ *
+ * The registry is the single source of truth that runtime packages
+ * (@omriashke/dynamico-web, @omriashke/dynamico-native) subscribe to. It receives compiled
+ * modules from a Source, evaluates them via the loader using a host-provided
+ * Scope, and notifies subscribers when a component's version changes.
+ */
+export class Registry {
+    constructor(source, scope) {
+        this.source = source;
+        this.scope = scope;
+        this.entries = new Map();
+        this.listeners = new Map();
+        this.anyListeners = new Set();
+        this.inflight = new Map();
+        this.lazyProxies = new Map();
+        this.source.subscribe(({ module }) => {
+            this.ingest(module.name, module);
+        });
+    }
+    /** Replace or extend the current scope (rare; typically set once). */
+    setScope(scope) {
+        this.scope = scope;
+    }
+    /** Get the current entry for a name, if any. */
+    peek(name) {
+        return this.entries.get(name);
+    }
+    /**
+     * Ensure a component is loaded. Triggers an initial fetch if we don't yet
+     * have an entry for this name. Returns the latest known entry.
+     */
+    async ensure(name) {
+        const existing = this.entries.get(name);
+        if (existing)
+            return existing;
+        const pending = this.inflight.get(name);
+        if (pending)
+            return pending;
+        const p = this.source
+            .fetch(name)
+            .then((module) => this.ingest(name, module))
+            .finally(() => {
+            this.inflight.delete(name);
+        });
+        this.inflight.set(name, p);
+        return p;
+    }
+    /** Subscribe to changes for a specific component. */
+    subscribe(name, listener) {
+        let set = this.listeners.get(name);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(name, set);
+        }
+        set.add(listener);
+        return () => {
+            set.delete(listener);
+            if (set.size === 0)
+                this.listeners.delete(name);
+        };
+    }
+    /** Subscribe to all changes (used internally / for debugging). */
+    subscribeAll(listener) {
+        this.anyListeners.add(listener);
+        return () => {
+            this.anyListeners.delete(listener);
+        };
+    }
+    /**
+     * Resolve a relative-path require from inside a dynamic component.
+     * Cross-component imports look up other components by name in the registry.
+     * v1: we map "./Other" -> "Other" (basename, no extension).
+     *
+     * The returned value is a *lazy proxy module*: it has the same shape as
+     * a real CommonJS module (`{ default, ...rest }`), but every member is a
+     * React function component that re-resolves the target on each render.
+     * This means:
+     *   - Card can `require("./Hello")` at eval time even before Hello has
+     *     loaded — the proxy is returned immediately.
+     *   - When Hello actually arrives (or hot-swaps to a new version), Card's
+     *     next render automatically picks it up; no manual preload needed.
+     */
+    requireByPath(specifier) {
+        const base = specifier
+            .replace(/^\.+\//, "")
+            .replace(/\.[tj]sx?$/, "")
+            .split("/")
+            .pop();
+        if (!base) {
+            throw new Error(`dynamico: cannot resolve relative require '${specifier}'`);
+        }
+        if (!this.entries.has(base) && !this.inflight.has(base)) {
+            void this.ensure(base);
+        }
+        return this.makeLazyProxy(base);
+    }
+    makeLazyProxy(name) {
+        const cached = this.lazyProxies.get(name);
+        if (cached)
+            return cached;
+        const registry = this;
+        const proxy = {};
+        const make = (key) => {
+            const Comp = function LazyDynamic(props) {
+                const entry = registry.entries.get(name);
+                // Not loaded yet — render nothing. When the dependency arrives, the
+                // cross-dep notification in `notify()` refreshes our parent's entry,
+                // which causes useSyncExternalStore to re-render and we'll resolve
+                // for real on the next pass.
+                if (!entry || (!entry.factory && !entry.error))
+                    return null;
+                if (entry.error) {
+                    // Surface the dep error inline. Parent can wrap in errorFallback at
+                    // its own level if it wants; we don't have access to it here.
+                    return null;
+                }
+                const target = entry.factory?.[key];
+                if (typeof target !== "function")
+                    return null;
+                // The host-scope's React.createElement is what invoked us; we just
+                // call the real component function. props is what the parent passed.
+                return target(props);
+            };
+            Object.defineProperty(Comp, "name", { value: `Lazy(${name}.${key})` });
+            return Comp;
+        };
+        proxy.default = make("default");
+        // Allow named imports via Proxy: any key access returns a fresh lazy
+        // component bound to that key. Default is set above; everything else
+        // is created on demand.
+        const handler = {
+            get(target, prop) {
+                if (typeof prop !== "string")
+                    return undefined;
+                if (prop in target)
+                    return target[prop];
+                const c = make(prop);
+                target[prop] = c;
+                return c;
+            },
+        };
+        const wrapped = new Proxy(proxy, handler);
+        this.lazyProxies.set(name, wrapped);
+        return wrapped;
+    }
+    /**
+     * Take a CompiledModule from the source, evaluate it (or record a compile
+     * error), update the entry, and notify listeners.
+     */
+    ingest(name, module) {
+        if (module.removed) {
+            this.entries.delete(name);
+            this.lazyProxies.delete(name);
+            const removalEntry = {
+                name,
+                version: module.version,
+                error: {
+                    kind: "load",
+                    name,
+                    version: module.version,
+                    message: `'${name}' was removed from the registry`,
+                },
+            };
+            this.notify(name, removalEntry);
+            return removalEntry;
+        }
+        let entry;
+        if (module.error) {
+            entry = {
+                name,
+                version: module.version,
+                error: {
+                    kind: module.error.kind === "typecheck" ? "load" : "compile",
+                    name,
+                    version: module.version,
+                    message: module.error.message,
+                    stack: module.error.stack,
+                },
+            };
+        }
+        else {
+            try {
+                const factory = loadModule(module.code, this.scope, (rel) => this.requireByPath(rel));
+                entry = { name, version: module.version, factory };
+            }
+            catch (err) {
+                entry = {
+                    name,
+                    version: module.version,
+                    error: toLoadError(name, module.version, err),
+                };
+            }
+        }
+        this.entries.set(name, entry);
+        this.notify(name, entry);
+        return entry;
+    }
+    notify(name, entry) {
+        const set = this.listeners.get(name);
+        if (set)
+            for (const l of set)
+                l(entry);
+        for (const l of this.anyListeners)
+            l(entry);
+        // A new/updated component may be a dependency of others that are already
+        // mounted via lazy proxies. For v1 we don't track an explicit dep graph;
+        // instead we notify every other subscribed name with a *fresh entry
+        // object* (same content, new identity) so that useSyncExternalStore
+        // picks up the change and React re-renders, which causes the lazy
+        // proxy's render path to re-resolve the now-loaded dependency.
+        for (const [otherName, listeners] of this.listeners) {
+            if (otherName === name)
+                continue;
+            const other = this.entries.get(otherName);
+            if (!other)
+                continue;
+            const refreshed = { ...other };
+            this.entries.set(otherName, refreshed);
+            for (const l of listeners)
+                l(refreshed);
+        }
+    }
+}
+function toLoadError(name, version, err) {
+    const e = err instanceof Error ? err : new Error(String(err));
+    return { kind: "load", name, version, message: e.message, stack: e.stack };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/sources/remote.d.ts

@@ -0,0 +1,21 @@
+import type { Source } from "../types.js";
+export interface RemoteSourceOptions {
+    /** Base URL of the registry server, e.g. "http://localhost:4000" or "https://reg.example.com". */
+    url: string;
+    /** Optional WebSocket URL override. Defaults to `url` with http(s) -> ws(s). */
+    wsUrl?: string;
+    /** Custom fetch (for environments without a global fetch). */
+    fetch?: typeof fetch;
+    /** Custom WebSocket constructor (RN provides one globally; Node 18+ has it too). */
+    WebSocket?: typeof WebSocket;
+    /** Reconnection backoff in ms. Default: 1000. */
+    reconnectMs?: number;
+}
+/**
+ * Talks to @omriashke/dynamico-registry (or any compatible server).
+ *
+ *   GET  {url}/component/:name      -> CompiledModule (initial fetch)
+ *   WS   {wsUrl}/subscribe          -> stream of CompiledModule updates
+ */
+export declare function createRemoteSource(options: RemoteSourceOptions): Source;
+//# sourceMappingURL=remote.d.ts.map

package/dist/sources/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/sources/remote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,MAAM,EAAgB,MAAM,aAAa,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAClC,kGAAkG;IAClG,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,oFAAoF;IACpF,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;IAC7B,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAiGvE"}

package/dist/sources/remote.js

@@ -0,0 +1,102 @@
+/**
+ * Talks to @omriashke/dynamico-registry (or any compatible server).
+ *
+ *   GET  {url}/component/:name      -> CompiledModule (initial fetch)
+ *   WS   {wsUrl}/subscribe          -> stream of CompiledModule updates
+ */
+export function createRemoteSource(options) {
+    const fetchImpl = options.fetch ??
+        (typeof fetch !== "undefined"
+            ? fetch
+            : (() => {
+                throw new Error("dynamico: no fetch implementation available");
+            }));
+    const WSCtor = options.WebSocket ??
+        (typeof WebSocket !== "undefined"
+            ? WebSocket
+            : function MissingWS() {
+                throw new Error("dynamico: no WebSocket implementation available");
+            });
+    const httpUrl = options.url.replace(/\/$/, "");
+    const wsUrl = options.wsUrl ?? httpUrl.replace(/^http/, "ws") + "/subscribe";
+    const listeners = new Set();
+    let socket = null;
+    let disposed = false;
+    const reconnectMs = options.reconnectMs ?? 1000;
+    function connect() {
+        if (disposed)
+            return;
+        try {
+            socket = new WSCtor(wsUrl);
+        }
+        catch (err) {
+            scheduleReconnect();
+            return;
+        }
+        socket.onmessage = (ev) => {
+            try {
+                const data = typeof ev.data === "string"
+                    ? JSON.parse(ev.data)
+                    : JSON.parse(new TextDecoder().decode(ev.data));
+                if (data && typeof data.name === "string" && typeof data.version === "string") {
+                    const module = data;
+                    for (const l of listeners)
+                        l({ module });
+                }
+            }
+            catch {
+                /* ignore malformed frames */
+            }
+        };
+        socket.onclose = () => {
+            socket = null;
+            scheduleReconnect();
+        };
+        socket.onerror = () => {
+            try {
+                socket?.close();
+            }
+            catch {
+                /* noop */
+            }
+        };
+    }
+    function scheduleReconnect() {
+        if (disposed)
+            return;
+        setTimeout(connect, reconnectMs);
+    }
+    connect();
+    return {
+        async fetch(name) {
+            const res = await fetchImpl(`${httpUrl}/component/${encodeURIComponent(name)}`);
+            if (!res.ok) {
+                return {
+                    name,
+                    version: "0",
+                    error: {
+                        kind: "compile",
+                        message: `registry returned ${res.status} for ${name}`,
+                    },
+                };
+            }
+            return (await res.json());
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        dispose() {
+            disposed = true;
+            try {
+                socket?.close();
+            }
+            catch {
+                /* noop */
+            }
+        },
+    };
+}
+//# sourceMappingURL=remote.js.map

package/dist/sources/remote.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,80 @@
+export type Version = string;
+export type Scope = Record<string, unknown>;
+export interface PropsSchemaField {
+    type: "string" | "number" | "boolean" | "object" | "array" | "any";
+    required?: boolean;
+}
+export type PropsSchema = Record<string, PropsSchemaField>;
+export interface Diagnostic {
+    severity: "error" | "warning";
+    message: string;
+    /** 1-based line in the source. */
+    line?: number;
+    /** 1-based column. */
+    column?: number;
+    /** TypeScript or Babel diagnostic code, e.g. "TS2304". */
+    code?: string;
+    /** A short snippet of the offending line, when available. */
+    snippet?: string;
+}
+export interface CompiledModuleOk {
+    name: string;
+    version: Version;
+    code: string;
+    /** Type-check warnings that didn't block compilation. */
+    warnings?: Diagnostic[];
+    error?: undefined;
+    removed?: undefined;
+}
+export interface CompiledModuleError {
+    name: string;
+    version: Version;
+    code?: undefined;
+    error: {
+        kind: "compile" | "typecheck";
+        message: string;
+        stack?: string;
+        diagnostics?: Diagnostic[];
+    };
+    removed?: undefined;
+}
+/** A removal event broadcast over WS when DELETE /component/:name is called. */
+export interface CompiledModuleRemoved {
+    name: string;
+    version: Version;
+    removed: true;
+    code?: undefined;
+    error?: undefined;
+}
+export type CompiledModule = CompiledModuleOk | CompiledModuleError | CompiledModuleRemoved;
+export interface DynamicError {
+    kind: "compile" | "load" | "render";
+    name: string;
+    version: Version;
+    message: string;
+    stack?: string;
+}
+export type ComponentFactory = {
+    default?: unknown;
+    propsSchema?: PropsSchema;
+    [key: string]: unknown;
+};
+export interface RegistryEntry {
+    name: string;
+    version: Version;
+    factory?: ComponentFactory;
+    error?: DynamicError;
+}
+export type RegistryListener = (entry: RegistryEntry) => void;
+export interface SourceUpdate {
+    module: CompiledModule;
+}
+export interface Source {
+    /** Fetch the latest version of a single component (initial load). */
+    fetch(name: string): Promise<CompiledModule>;
+    /** Subscribe to updates for any component. Returns unsubscribe fn. */
+    subscribe(listener: (update: SourceUpdate) => void): () => void;
+    /** Optional disposal hook. */
+    dispose?(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@omriashke/dynamico-core",
+  "version": "0.1.0",
+  "description": "Renderer-agnostic core for dynamico: source adapters, module loader, versioned component registry.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/omriaskenazi/dynamico.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/omriaskenazi/dynamico#readme",
+  "keywords": [
+    "react",
+    "runtime",
+    "hot-swap",
+    "dynamic-components",
+    "dynamico"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "typescript": "^5.6.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "dev": "tsc -p tsconfig.json -w"
+  }
+}

package/src/index.ts

@@ -0,0 +1,28 @@
+export type {
+  Source,
+  SourceUpdate,
+  CompiledModule,
+  CompiledModuleOk,
+  CompiledModuleError,
+  CompiledModuleRemoved,
+  ComponentFactory,
+  RegistryEntry,
+  RegistryListener,
+  Scope,
+  PropsSchema,
+  PropsSchemaField,
+  DynamicError,
+  Diagnostic,
+  Version,
+} from "./types.js";
+
+export { Registry } from "./registry.js";
+export { loadModule } from "./loader.js";
+export { createRemoteSource, type RemoteSourceOptions } from "./sources/remote.js";
+export { validateProps, type PropsValidationResult } from "./propsSchema.js";
+export {
+  createRuntime,
+  type RuntimeAPI,
+  type DynamicoProviderProps,
+  type DynamicComponentProps,
+} from "./react/createRuntime.js";

package/src/loader.ts

@@ -0,0 +1,40 @@
+import type { Scope } from "./types.js";
+
+/**
+ * Execute a CommonJS-style code string in a controlled scope.
+ *
+ * The compiler (server-side Babel) emits code that uses `require(name)`,
+ * `module.exports`, and `exports`. We give it a `require` that:
+ *   - returns the host-registered binding for any bare specifier in `scope`
+ *   - delegates relative paths ("./Other", "../foo") to `requireRelative`,
+ *     which the registry implements by looking up other dynamic components
+ *   - throws otherwise (no arbitrary npm imports at runtime)
+ *
+ * This is the only place we call `new Function`. It runs in the same realm
+ * as the host app — v1 trusts the registry; sandboxing is a v2 concern.
+ */
+export function loadModule(
+  code: string,
+  scope: Scope,
+  requireRelative: (specifier: string) => unknown,
+): unknown {
+  const moduleObj = { exports: {} as Record<string, unknown> };
+  const requireFn = (name: string): unknown => {
+    if (name.startsWith("./") || name.startsWith("../") || name.startsWith("/")) {
+      return requireRelative(name);
+    }
+    if (Object.prototype.hasOwnProperty.call(scope, name)) {
+      return scope[name];
+    }
+    throw new Error(
+      `dynamico: '${name}' is not in host scope. Add it via <DynamicoProvider scope={{...}}>.`,
+    );
+  };
+
+  // The compiled body is just the function body; arguments are well-known.
+  // eslint-disable-next-line no-new-func
+  const fn = new Function("module", "exports", "require", code);
+  fn(moduleObj, moduleObj.exports, requireFn);
+
+  return moduleObj.exports;
+}

package/src/propsSchema.ts

@@ -0,0 +1,43 @@
+import type { PropsSchema } from "./types.js";
+
+export interface PropsValidationResult {
+  ok: boolean;
+  errors: string[];
+}
+
+const TYPE_CHECKS: Record<string, (v: unknown) => boolean> = {
+  string: (v) => typeof v === "string",
+  number: (v) => typeof v === "number" && !Number.isNaN(v),
+  boolean: (v) => typeof v === "boolean",
+  object: (v) => typeof v === "object" && v !== null && !Array.isArray(v),
+  array: (v) => Array.isArray(v),
+  any: () => true,
+};
+
+export function validateProps(
+  schema: PropsSchema | undefined,
+  props: Record<string, unknown>,
+): PropsValidationResult {
+  if (!schema) return { ok: true, errors: [] };
+  const errors: string[] = [];
+  for (const [key, field] of Object.entries(schema)) {
+    const present = Object.prototype.hasOwnProperty.call(props, key);
+    if (!present) {
+      if (field.required) errors.push(`missing required prop '${key}' (${field.type})`);
+      continue;
+    }
+    const checker = TYPE_CHECKS[field.type] ?? TYPE_CHECKS.any!;
+    if (!checker(props[key])) {
+      errors.push(
+        `prop '${key}' expected ${field.type}, got ${describe(props[key])}`,
+      );
+    }
+  }
+  return { ok: errors.length === 0, errors };
+}
+
+function describe(v: unknown): string {
+  if (v === null) return "null";
+  if (Array.isArray(v)) return "array";
+  return typeof v;
+}