@microverse.ts/host-surface 0.1.0 → 0.3.0

package/dist/infrastructure/builders/surfaceBuilder.d.ts

@@ -1,29 +1,34 @@
-import { SchemaValidationPort } from '../../application/ports/SchemaValidationPort.js';
-import { InferSurfaceCapabilities } from '../../domain/surfaceCapabilities.js';
-import { SurfaceMethodDef } from '../../domain/surfaceMethodDef.js';
-import { AnyHostSurfaceMethod, HostSurface, HostSurfaceSpec, HostWorkflowHooksSpec } from '../../domain/hostSurfaceTypes.js';
+import { SchemaValidationPort } from '../../application/ports/SchemaValidationPort';
+import { ComponentTypeDefInput } from '../../domain/componentTypeSpec';
+import { InferSurfaceCapabilities } from '../../domain/surfaceCapabilities';
+import { SurfaceMethodDef } from '../../domain/surfaceMethodDef';
+import { AnyHostSurfaceMethod, HostSurface, HostSurfaceSpec, HostComponentHooksSpec } from '../../domain/hostSurfaceTypes';
 type MutableHostSurfaceSpec = Record<string, Record<string, AnyHostSurfaceMethod>>;
+type MutableComponentTypeRegistry = Record<string, ComponentTypeDefInput>;
 /**
  * Fluent builder for a host surface. Created via {@link defineHostSurfaceFor} / {@link defineHostSurface} factory overloads.
  */
-export declare class SurfaceBuilder<THost, const THooks extends HostWorkflowHooksSpec | undefined = undefined> {
+export declare class SurfaceBuilder<THost, const THooks extends HostComponentHooksSpec | undefined = undefined> {
     private readonly spec;
-    private workflowHooksSpec;
+    private readonly componentTypeRegistry;
+    private componentHooksSpec;
     private readonly ports;
-    constructor(ports: readonly [SchemaValidationPort], workflowHooks?: THooks, initialSpec?: MutableHostSurfaceSpec);
+    constructor(ports: readonly [SchemaValidationPort], componentHooks?: THooks, initialSpec?: MutableHostSurfaceSpec, initialComponentTypes?: MutableComponentTypeRegistry);
+    /** Declares a typed Lua component profile (props, state, capabilities, hooks). */
+    componentType<const N extends string>(name: N, def: ComponentTypeDefInput<`${string}:${string}`, THooks>): SurfaceBuilder<THost, THooks>;
     /** Opens a Lua bridge table (e.g. `orders`, `greet`). */
     bridge<const B extends string>(name: B): BridgeBuilder<THost, B, THooks>;
-    /** Attaches workflow hook Zod schemas (emitted into `.d.lua` as `on*` methods). */
-    workflowHooks<const H extends HostWorkflowHooksSpec>(hooks: H): SurfaceBuilder<THost, H>;
+    /** Attaches component domain-event Zod schemas (emitted into `.d.lua` as `on*` methods on component types). */
+    componentHooks<const H extends HostComponentHooksSpec>(hooks: H): SurfaceBuilder<THost, H>;
     /** Compiles the accumulated spec into a {@link HostSurface}. */
-    build(): THooks extends HostWorkflowHooksSpec ? HostSurface<THooks, InferSurfaceCapabilities<HostSurfaceSpec>> : HostSurface<undefined, InferSurfaceCapabilities<HostSurfaceSpec>>;
+    build(): THooks extends HostComponentHooksSpec ? HostSurface<THooks, InferSurfaceCapabilities<HostSurfaceSpec>> : HostSurface<undefined, InferSurfaceCapabilities<HostSurfaceSpec>>;
     /** @internal */
     addMethod<const B extends string, const M extends string>(bridgeName: B, methodName: M, entry: AnyHostSurfaceMethod): SurfaceBuilder<THost, THooks>;
 }
 /**
  * Per-bridge step in the fluent surface DSL. Return to {@link SurfaceBuilder} via `.method(…)`.
  */
-export declare class BridgeBuilder<THost, const B extends string, THooks extends HostWorkflowHooksSpec | undefined> {
+export declare class BridgeBuilder<THost, const B extends string, THooks extends HostComponentHooksSpec | undefined> {
     private readonly parent;
     private readonly bridgeName;
     constructor(parent: SurfaceBuilder<THost, THooks>, bridgeName: B);

package/dist/infrastructure/builders/surfaceBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"surfaceBuilder.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/builders/surfaceBuilder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAC5F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAE7F,OAAO,KAAK,EACV,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,qBAAqB,EACtB,MAAM,kCAAkC,CAAC;AAE1C,KAAK,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAEnF;;GAEG;AACH,qBAAa,cAAc,CACzB,KAAK,EACL,KAAK,CAAC,MAAM,SAAS,qBAAqB,GAAG,SAAS,GAAG,SAAS;IAElE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuD;IAE5E,OAAO,CAAC,iBAAiB,CAAS;IAElC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;gBAGtD,KAAK,EAAE,SAAS,CAAC,oBAAoB,CAAC,EACtC,aAAa,CAAC,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,sBAAsB;IAkBtC,yDAAyD;IACzD,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC;IAIxE,mFAAmF;IACnF,aAAa,CAAC,KAAK,CAAC,CAAC,SAAS,qBAAqB,EAAE,KAAK,EAAE,CAAC,GAAG,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;IAIxF,gEAAgE;IAChE,KAAK,IAAI,MAAM,SAAS,qBAAqB,GACzC,WAAW,CAAC,MAAM,EAAE,wBAAwB,CAAC,eAAe,CAAC,CAAC,GAC9D,WAAW,CAAC,SAAS,EAAE,wBAAwB,CAAC,eAAe,CAAC,CAAC;IAKrE,gBAAgB;IAChB,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,CAAC,CAAC,SAAS,MAAM,EACtD,UAAU,EAAE,CAAC,EACb,UAAU,EAAE,CAAC,EACb,KAAK,EAAE,oBAAoB,GAC1B,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC;CAWjC;AAED;;GAEG;AACH,qBAAa,aAAa,CACxB,KAAK,EACL,KAAK,CAAC,CAAC,SAAS,MAAM,EACtB,MAAM,SAAS,qBAAqB,GAAG,SAAS;IAG9C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,MAAM,EAAE,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,EACrC,UAAU,EAAE,CAAC;IAGhC,4FAA4F;IAC5F,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,SAAS,GAAG,MAAM,IAAI,MAAM,EAAE,EAC1E,IAAI,EAAE,CAAC,EACP,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,GAC5C,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC;CAGjC"}
+{"version":3,"file":"surfaceBuilder.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/builders/surfaceBuilder.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/components/hostScriptSession.d.ts

@@ -1,94 +1,64 @@
-import { CapabilityId, InMemoryCapabilityRegistry } from '@microverse.ts/runtime-capabilities';
 import { Result } from '@microverse.ts/shared';
 import { z } from 'zod';
-import { ExecutionFailure, RunScriptResult, MicroverseId, MicroverseRuntime, TimeoutPolicy } from '@microverse.ts/runtime-core';
-import { HostSurface, HostWorkflowHooksSpec } from '../../domain/hostSurfaceTypes.js';
-import { LuaGlobalHookName } from '../../domain/luaGlobalHook.js';
-/**
- * Tuple accepted by {@link HostScriptSession.invokeGlobalHookIfPresent} when the session is specialised with
- * the same Zod map as {@link HostSurface} `workflowHooks` on the surface you pass in.
- */
-export type WorkflowHookInvokeArgs<TH extends HostWorkflowHooksSpec> = {
+import { ExecutionFailure, RunScriptResult, MicroverseId, MicroverseRuntime, ScriptAuditEvent, ScriptInstanceContext, ScriptPropertyBag, ScriptPropertyValue, TimeoutPolicy } from '@microverse.ts/runtime-core';
+import { SchemaValidationPort } from '../../application/ports/SchemaValidationPort';
+import { ScriptReferenceResolverPort } from '../../application/ports/ScriptReferenceResolverPort';
+import { ResolvedScriptProfile } from '../../domain/scriptProfileSpec';
+import { HostSurface, HostComponentHooksSpec } from '../../domain/hostSurfaceTypes';
+import { LuaGlobalHookName } from '../../domain/luaGlobalHook';
+export type ComponentEventHookInvokeArgs<TH extends HostComponentHooksSpec> = {
     [K in keyof TH & string]: readonly [hook: LuaGlobalHookName<K>, payload: Readonly<z.infer<TH[K]>>];
 }[keyof TH & string];
-type InvokeGlobalHookIfPresentFn<THooks extends HostWorkflowHooksSpec | undefined> = THooks extends HostWorkflowHooksSpec ? (...args: WorkflowHookInvokeArgs<THooks>) => Promise<Result<RunScriptResult, ExecutionFailure>> : (globalName: string, payload: Readonly<Record<string, string | number | boolean>>) => Promise<Result<RunScriptResult, ExecutionFailure>>;
-/**
- * Options for {@link HostScriptSession}: one Wasm (or other) slot, a surface, host services, and a capability allowlist.
- *
- * @typeParam THost - Your engine context; must match the `THost` used in {@link defineHostSurfaceFor} (or {@link defineHostSurface}).
- * @typeParam THooks - When the surface was built with workflow hooks, pass the same `THooks` so {@link HostScriptSession.invokeGlobalHookIfPresent} narrows to those payloads (match `surface`’s `workflowHooks` typing).
- */
-export type HostScriptSessionOptions<THost, THooks extends HostWorkflowHooksSpec | undefined = undefined> = {
-    /** Shared runtime (typically one Wasmoon VM for many slots). */
+type InvokeComponentEventHookFn<THooks extends HostComponentHooksSpec | undefined> = THooks extends HostComponentHooksSpec ? (...args: ComponentEventHookInvokeArgs<THooks>) => Promise<Result<RunScriptResult, ExecutionFailure>> : (hookName: string, payload: Readonly<Record<string, string | number | boolean>>) => Promise<Result<RunScriptResult, ExecutionFailure>>;
+export type HostScriptSessionOptions<THost, THooks extends HostComponentHooksSpec | undefined = undefined> = {
     readonly runtime: MicroverseRuntime;
-    /** Surface produced by {@link defineHostSurface}. */
     readonly surface: HostSurface<THooks>;
-    /** Host services passed into bridge handlers (orders, clock, …). */
     readonly host: THost;
-    /** Stable sandbox id for this script / workflow / entity. */
     readonly slotKey: MicroverseId;
-    /** Exact capability ids this session may invoke on any bridge method. */
-    readonly allowedCapabilities: readonly CapabilityId[];
-    /** Optional default timeout forwarded to {@link MicroverseSlot.run}. */
     readonly defaultTimeout?: TimeoutPolicy | undefined;
+    readonly script: ScriptInstanceContext;
+    /** Host-selected script profile (surface component type name). Applied at openSession before the main chunk. */
+    readonly profileId?: string | undefined;
+    /** When set, used instead of {@link HostSurfaceCore.getComponentType} (inline catalog profiles). */
+    readonly resolvedProfile?: ResolvedScriptProfile | undefined;
+    /** Lua singleton global for `Type:extend()` (e.g. `SortingAlgorithm`). Defaults to `profileId`. */
+    readonly profileSingleton?: string | undefined;
+    readonly enableComponentRuntime?: boolean | undefined;
+    readonly schemaValidation?: SchemaValidationPort | undefined;
+    readonly referenceResolver?: ScriptReferenceResolverPort | undefined;
+    readonly onScriptAudit?: ((event: ScriptAuditEvent) => void) | undefined;
 };
-/**
- * Binds one **Lua slot** to a {@link HostSurface}: capability allowlist, Zod validation, and `mergeEnv` wiring.
- *
- * @remarks
- * - **Lua → host (bridges):** tables/methods from {@link defineHostSurface} on `_ENV` call into TypeScript with Zod validation.
- * - **Host → Lua (hooks):** when the surface defines `workflowHooks`, {@link HostScriptSession.openSession} installs
- *   a small `workflow` helper (`workflow:extend()` → handler table + slot registration) and
- *   {@link HostScriptSession.invokeGlobalHookIfPresent} dispatches `on…` methods on that table. Each session has its own
- *   slot env, so many workflows run concurrently without sharing Lua globals. Without `workflowHooks`, hooks are optional
- *   globals (`onSmoke`, …) invoked as plain functions.
- * - Call {@link HostScriptSession.openSession} once before running chunks or invocations; {@link HostScriptSession.dispose} when the slot is torn down.
- *
- * @typeParam THost - Same host type as your surface handlers.
- * @typeParam THooks - Align with {@link HostSurface} `workflowHooks` on the surface you pass in (or `undefined` when the surface has no workflow hooks).
- */
-export declare class HostScriptSession<THost, THooks extends HostWorkflowHooksSpec | undefined = undefined> {
+export declare class HostScriptSession<THost, THooks extends HostComponentHooksSpec | undefined = undefined> {
     private readonly opts;
     private sandbox;
-    private readonly registry;
+    private readonly hostProps;
+    private readonly schemaValidation;
+    private activeComponentType;
+    private hostProfileApplied;
+    readonly context: ScriptInstanceContext;
     constructor(opts: HostScriptSessionOptions<THost, THooks>);
-    /**
-     * Allocates the underlying {@link MicroverseSlot} for this `slotKey` on the shared runtime.
-     */
     readonly openSession: () => Promise<void>;
-    /**
-     * Exposes the in-memory registry (e.g. to mutate allowlists in advanced tests).
-     */
-    readonly getCapabilityRegistry: () => InMemoryCapabilityRegistry;
     private requireMicroverseSlot;
     private mergeEnv;
-    /**
-     * Executes Lua source in the slot environment with surface bridges on `_ENV`.
-     *
-     * @param source - Full Lua chunk (compiled with `load(..., "t", env)` in the Wasm adapter).
-     */
+    private wrapReference;
+    private emitAudit;
+    private getActiveProfileName;
+    private profileSingletonName;
+    private singletonTypeNames;
+    private tryGetActiveProfile;
+    private validatePropsBag;
+    readonly getProps: () => Readonly<ScriptPropertyBag>;
+    readonly setProps: (bag: ScriptPropertyBag) => Promise<void>;
+    readonly patchProps: (partial: ScriptPropertyBag) => Promise<void>;
+    readonly flushDirtyProps: () => Promise<ScriptPropertyBag | null>;
     readonly runChunk: (source: string) => Promise<Result<RunScriptResult, ExecutionFailure>>;
-    /**
-     * Host → Lua: when the surface has `workflowHooks`, invokes `impl:onHook(evt)` on the handler table registered by
-     * `workflow:extend()` in this slot. Otherwise invokes `_ENV[globalName](evt)` when that entry is a function.
-     *
-     * @param globalName - Hook method name, e.g. `onOrderPlaced` (same as {@link luaGlobalHookName}).
-     * @param payload - Table fields: only string, finite number, or boolean (Lua literals).
-     */
-    readonly invokeGlobalHookIfPresent: InvokeGlobalHookIfPresentFn<THooks>;
-    /**
-     * Host → Lua: invokes `_ENV[tableName][methodName](literalTable)` where `literalTable` is built only from
-     * string, finite number, or boolean fields in `payload`.
-     *
-     * @param tableName - Global table name in the slot env.
-     * @param methodName - Function field on that table.
-     * @param payload - Plain serializable fields for the Lua table literal.
-     */
+    readonly invokeComponentHook: (hookName: string, ...args: (string | ScriptPropertyValue | Readonly<Record<string, string | number | boolean>>)[]) => Promise<Result<RunScriptResult, ExecutionFailure>>;
+    readonly invokeComponentEventHook: InvokeComponentEventHookFn<THooks>;
     readonly call: (tableName: string, methodName: string, payload: Record<string, unknown>) => Promise<Result<RunScriptResult, ExecutionFailure>>;
-    /**
-     * Releases the slot in the runtime adapter and clears the session handle.
-     */
     readonly dispose: () => Promise<void>;
+    /** Seeds host props bag without Lua sync (call before setProps after mount). */
+    readonly seedHostProps: (bag: ScriptPropertyBag) => void;
+    readonly getHostProfileApplied: () => boolean;
 }
 export {};
 //# sourceMappingURL=hostScriptSession.d.ts.map

package/dist/infrastructure/components/hostScriptSession.d.ts.map

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

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@microverse.ts/host-surface",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "type": "module",
   "license": "MIT",
   "sideEffects": false,
-  "description": "Declarative host surface (Zod + capabilities) → bridge tables and LuaDefManifest for .d.lua.",
+  "description": "Fluent host surface DSL: Zod bridges, capability checks, component hooks, and LuaDefManifest for runtime + LuaLS stubs.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/QADRAX/Microverse.ts.git",
@@ -27,18 +27,19 @@
   ],
   "dependencies": {
     "zod": "^3.24.0",
-    "@microverse.ts/lua-defs": "0.1.0",
-    "@microverse.ts/runtime-capabilities": "0.1.0",
-    "@microverse.ts/runtime-bridge": "0.1.0",
-    "@microverse.ts/runtime-core": "0.1.0",
-    "@microverse.ts/shared": "0.1.0",
-    "@microverse.ts/runtime-zod": "0.1.0"
+    "@microverse.ts/lua-defs": "0.3.0",
+    "@microverse.ts/runtime-bridge": "0.3.0",
+    "@microverse.ts/runtime-capabilities": "0.3.0",
+    "@microverse.ts/runtime-core": "0.3.0",
+    "@microverse.ts/runtime-zod": "0.3.0",
+    "@microverse.ts/shared": "0.3.0"
   },
   "devDependencies": {
     "typescript": "^5.8.3",
     "vite": "^8.0.0",
     "vite-plugin-dts": "^4.5.4",
-    "vitest": "^3.1.4"
+    "vitest": "^3.1.4",
+    "@microverse.ts/runtime-wasm": "0.3.0"
   },
   "scripts": {
     "build": "vite build",