@forgeax/engine-host 0.1.27

package/dist/transport.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocol.ts","../src/transport.ts"],"names":["removeError"],"mappings":"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","file":"transport.mjs","sourcesContent":["import type { EntryOptions } from '@deepseek-ai/cordis-plugin-loader';\nimport type {\n  GamePluginEntry,\n  PluginCatalog,\n  PluginCatalogRecord,\n  PluginRealm,\n} from '@forgeax/engine-plugin/loader';\n\ndeclare module '@forgeax/engine-plugin' {\n  interface EngineContextServices {\n    hostAssembly:\n      | import('./backend.js').BackendAssemblyAuthority\n      | import('./frontend.js').FrontendAssemblyState;\n    hostTransport:\n      | import('./transport.js').HostTransportServer\n      | import('./transport.js').HostTransportClient;\n  }\n}\n\n/** Wire version for the backend-derived browser assembly. */\nexport const HOST_ASSEMBLY_SCHEMA_VERSION = 1 as const;\n\nexport type HostAssemblySchemaVersion = typeof HOST_ASSEMBLY_SCHEMA_VERSION;\n\nexport interface HostModuleDescriptor {\n  /** The exact module name used by a Cordis Entry. */\n  readonly name: string;\n  /** Physical ForgeaX realm expected by the CatalogLoader. */\n  readonly realm: PluginRealm;\n  /** Code identity. The backend and browser must agree on this value. */\n  readonly version: string;\n  /** Optional content identity for a static or generated catalog. */\n  readonly digest?: string;\n  /** URL used by a live browser host. Static builds omit it and use a Catalog. */\n  readonly url?: string;\n}\n\n/** One package's explicitly paired backend/frontend Entry projections. */\nexport interface HostPluginPair {\n  readonly id: string;\n  readonly backend?: HostPluginEndpoint;\n  readonly frontend?: HostPluginEndpoint;\n}\n\nexport interface HostPluginEndpoint {\n  readonly entry: GamePluginEntry;\n  readonly module: HostModuleDescriptor;\n}\n\n/** Safe identity projection; backend Entry configuration never crosses the wire. */\nexport interface HostAssemblyPair {\n  readonly id: string;\n  readonly entryId: string;\n  readonly module: HostModuleDescriptor;\n}\n\n/**\n * A serializable projection of the entries that a frontend may activate.\n * `EntryOptions` is intentionally retained so nested Groups and repeated Entry\n * instances keep native Loader identity and reconciliation semantics.\n */\nexport interface HostAssembly {\n  readonly schemaVersion: HostAssemblySchemaVersion;\n  /** Digest of entries, modules and explicitly projected configuration. */\n  readonly revision: string;\n  readonly entries: readonly GamePluginEntry[];\n  readonly modules: readonly HostModuleDescriptor[];\n  readonly pairs: readonly HostAssemblyPair[];\n  /** Safe, frontend-visible configuration only. */\n  readonly config?: unknown;\n}\n\nexport interface HostAssemblyInput {\n  /** Backend Entries are local authority and are never serialized. */\n  readonly backendEntries?: readonly GamePluginEntry[];\n  readonly entries?: readonly GamePluginEntry[];\n  readonly modules?: readonly HostModuleDescriptor[];\n  readonly pairs?: readonly HostPluginPair[];\n  readonly config?: unknown;\n}\n\nexport interface HostActivationEntry {\n  readonly entryId: string;\n  readonly fiberState: string;\n  readonly failure?: HostErrorSummary;\n}\n\nexport interface HostErrorSummary {\n  readonly code: string;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: Readonly<Record<string, unknown>>;\n}\n\nexport interface HostActivationReport {\n  readonly state: 'created' | 'loading' | 'active' | 'failed' | 'disposed';\n  readonly revision: string;\n  readonly entries?: readonly HostActivationEntry[];\n  readonly error?: HostErrorSummary;\n}\n\nexport interface HostAssemblyErrorDetailByCode {\n  'host-assembly-invalid': { readonly reason: string };\n  'host-assembly-revision-mismatch': { readonly actual: string; readonly expected: string };\n  'host-assembly-module-missing': { readonly name: string };\n  'host-assembly-module-version-mismatch': {\n    readonly name: string;\n    readonly actual: string;\n    readonly expected: string;\n  };\n  'host-assembly-reload-required': {\n    readonly module: string;\n    readonly actual: string;\n    readonly expected: string;\n  };\n  'host-assembly-service-unavailable': { readonly service: string };\n  'host-assembly-stale-request': { readonly service: string; readonly generation: number };\n  'host-assembly-request-aborted': { readonly service: string };\n  'host-transport-failure': { readonly service: string; readonly reason: string };\n  'host-assembly-not-ready': {\n    readonly entryId: string;\n    readonly fiberState: string;\n    readonly failure?: HostErrorSummary;\n  };\n}\n\nexport type HostAssemblyErrorCode = keyof HostAssemblyErrorDetailByCode;\n\nexport class HostAssemblyError<\n  C extends HostAssemblyErrorCode = HostAssemblyErrorCode,\n> extends Error {\n  readonly code: C;\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: HostAssemblyErrorDetailByCode[C];\n\n  constructor(code: C, expected: string, hint: string, detail: HostAssemblyErrorDetailByCode[C]) {\n    super(`${code}: ${expected}`);\n    this.name = 'HostAssemblyError';\n    this.code = code;\n    this.expected = expected;\n    this.hint = hint;\n    this.detail = detail;\n  }\n}\n\n/**\n * Prove that the code selected by a local Catalog is the code named by an\n * assembly descriptor. An optional digest is still checked whenever either\n * side supplies one; an unrelated digest must never stand in for a version.\n */\nexport function assertHostModuleCatalogIdentity(\n  module: HostModuleDescriptor,\n  record: PluginCatalogRecord,\n): void {\n  if (record.version !== undefined && record.version !== module.version) {\n    throw new HostAssemblyError(\n      'host-assembly-module-version-mismatch',\n      `module ${module.name} to load catalog version ${module.version}`,\n      'Regenerate the static Catalog from the same backend package revision.',\n      { name: module.name, actual: record.version, expected: module.version },\n    );\n  }\n  if (\n    record.digest !== undefined &&\n    module.digest !== undefined &&\n    record.digest !== module.digest\n  ) {\n    throw new HostAssemblyError(\n      'host-assembly-module-version-mismatch',\n      `module ${module.name} to load catalog digest ${module.digest ?? 'none'}`,\n      'Regenerate the static Catalog from the same backend package bytes.',\n      { name: module.name, actual: record.digest, expected: module.digest ?? 'none' },\n    );\n  }\n  const versionMatches = record.version !== undefined && record.version === module.version;\n  const digestMatches =\n    module.digest !== undefined && record.digest !== undefined && record.digest === module.digest;\n  const staticWithoutIdentity =\n    module.version === 'static' &&\n    module.digest === undefined &&\n    record.version === undefined &&\n    record.digest === undefined;\n  if (!versionMatches && !digestMatches && !staticWithoutIdentity) {\n    throw new HostAssemblyError(\n      'host-assembly-module-version-mismatch',\n      `module ${module.name} to have a matching catalog code identity for ${module.version}`,\n      'Add the generated module version or digest to the static Catalog.',\n      {\n        name: module.name,\n        actual: record.version ?? record.digest ?? 'unknown',\n        expected: module.version,\n      },\n    );\n  }\n}\n\nexport interface HostAssemblyResult {\n  readonly ok: true;\n  readonly value: HostAssembly;\n}\n\nexport interface HostAssemblyFailure {\n  readonly ok: false;\n  readonly error: HostAssemblyError;\n}\n\nexport type HostAssemblyValidation = HostAssemblyResult | HostAssemblyFailure;\n\n/** JSON-stable projection used for revision identity and diagnostics. */\nexport function canonicalHostJson(value: unknown): string {\n  if (value === undefined) return 'undefined';\n  if (value === null || typeof value !== 'object') return JSON.stringify(value);\n  if (Array.isArray(value)) return `[${value.map(canonicalHostJson).join(',')}]`;\n  return `{${Object.entries(value as Record<string, unknown>)\n    .sort(([left], [right]) => left.localeCompare(right))\n    .map(([key, item]) => `${JSON.stringify(key)}:${canonicalHostJson(item)}`)\n    .join(',')}}`;\n}\n\n/** Small deterministic digest; it is an identity check, not a security hash. */\nexport function hostRevision(value: unknown): string {\n  let hash = 2166136261;\n  for (const char of canonicalHostJson(value)) {\n    hash ^= char.codePointAt(0) ?? 0;\n    hash = Math.imul(hash, 16777619);\n  }\n  return `fnv1a:${(hash >>> 0).toString(16).padStart(8, '0')}`;\n}\n\nfunction cloneEntry(entry: GamePluginEntry): GamePluginEntry {\n  const config = entry.group\n    ? (entry.config as readonly GamePluginEntry[] | undefined)?.map(cloneEntry)\n    : entry.config;\n  return {\n    id: entry.id,\n    name: entry.name,\n    ...(config === undefined ? {} : { config }),\n    ...(entry.group === undefined ? {} : { group: entry.group }),\n    ...(entry.disabled === undefined ? {} : { disabled: entry.disabled }),\n    ...(entry.inject === undefined ? {} : { inject: entry.inject }),\n    ...(entry.realm === undefined ? {} : { realm: entry.realm }),\n  };\n}\n\nfunction projectPairs(pairs: readonly HostPluginPair[]): {\n  readonly entries: readonly GamePluginEntry[];\n  readonly modules: readonly HostModuleDescriptor[];\n  readonly projections: readonly HostAssemblyPair[];\n} {\n  const entries: GamePluginEntry[] = [];\n  const modules: HostModuleDescriptor[] = [];\n  const projections: HostAssemblyPair[] = [];\n  for (const pair of pairs) {\n    if (\n      pair.backend !== undefined &&\n      pair.frontend !== undefined &&\n      pair.backend.module.version !== pair.frontend.module.version\n    ) {\n      throw new HostAssemblyError(\n        'host-assembly-module-version-mismatch',\n        `paired module ${pair.id} to use one code version on both hosts`,\n        'Resolve backend and frontend package entries from the same locked package revision.',\n        {\n          name: pair.id,\n          actual: pair.backend.module.version,\n          expected: pair.frontend.module.version,\n        },\n      );\n    }\n    if (pair.frontend === undefined) continue;\n    entries.push(pair.frontend.entry);\n    modules.push(pair.frontend.module);\n    projections.push({\n      id: pair.id,\n      entryId: pair.frontend.entry.id,\n      module: pair.frontend.module,\n    });\n  }\n  return { entries, modules, projections };\n}\n\nfunction assemblyPairsFromInput(input: HostAssemblyInput): {\n  readonly entries: readonly GamePluginEntry[];\n  readonly modules: readonly HostModuleDescriptor[];\n  readonly pairs: readonly HostAssemblyPair[];\n} {\n  if (input.pairs !== undefined) {\n    const projected = projectPairs(input.pairs);\n    return {\n      entries: input.entries ?? projected.entries,\n      modules: input.modules ?? projected.modules,\n      pairs: projected.projections,\n    };\n  }\n  const entries = input.entries ?? [];\n  const modules = [...(input.modules ?? [])];\n  for (const [index, entry] of entries.entries()) {\n    if (modules[index] !== undefined || modules.some((module) => module.name === entry.name))\n      continue;\n    modules.push({\n      name: entry.name,\n      realm: entry.realm ?? 'engine',\n      version: 'unknown',\n    });\n  }\n  return {\n    entries,\n    modules,\n    pairs: entries.map((entry, index) => ({\n      id: entry.id,\n      entryId: entry.id,\n      module:\n        modules[index]?.name === entry.name\n          ? modules[index]\n          : (modules.find((module) => module.name === entry.name) ?? {\n              name: entry.name,\n              realm: entry.realm ?? 'engine',\n              version: 'unknown',\n            }),\n    })),\n  };\n}\n\n/** Build one disposable assembly projection from effective backend inputs. */\nexport function createHostAssembly(input: HostAssemblyInput): HostAssembly {\n  const projected = assemblyPairsFromInput(input);\n  const entries = projected.entries.map(cloneEntry);\n  const modules = projected.modules.map((module) => ({ ...module }));\n  const pairs = projected.pairs.map((pair) => ({ ...pair, module: { ...pair.module } }));\n  const identity = {\n    schemaVersion: HOST_ASSEMBLY_SCHEMA_VERSION,\n    entries,\n    modules,\n    pairs,\n    ...(input.config === undefined ? {} : { config: input.config }),\n  };\n  return {\n    ...identity,\n    revision: hostRevision(identity),\n  };\n}\n\nfunction validateEntry(entry: EntryOptions, path: string): string | undefined {\n  if (entry === null || typeof entry !== 'object') return `${path} must be an Entry object`;\n  if (typeof entry.id !== 'string' || entry.id.length === 0) return `${path}.id must be non-empty`;\n  if (typeof entry.name !== 'string' || entry.name.length === 0)\n    return `${path}.name must be non-empty`;\n  if (entry.group === true) {\n    if (!Array.isArray(entry.config)) return `${path}.config must be an Entry array for a Group`;\n    for (const [index, child] of entry.config.entries()) {\n      const reason = validateEntry(child as EntryOptions, `${path}.config[${index}]`);\n      if (reason !== undefined) return reason;\n    }\n  }\n  return undefined;\n}\n\n/** Validate a received assembly before touching the native Loader. */\nexport function validateHostAssembly(assembly: HostAssembly): HostAssemblyValidation {\n  if (assembly === null || typeof assembly !== 'object') {\n    return {\n      ok: false,\n      error: new HostAssemblyError(\n        'host-assembly-invalid',\n        'assembly to be an object',\n        'Regenerate the frontend assembly from the active backend authority.',\n        { reason: 'assembly is not an object' },\n      ),\n    };\n  }\n  if (assembly.schemaVersion !== HOST_ASSEMBLY_SCHEMA_VERSION) {\n    return {\n      ok: false,\n      error: new HostAssemblyError(\n        'host-assembly-invalid',\n        `assembly schema ${HOST_ASSEMBLY_SCHEMA_VERSION}`,\n        'Regenerate the frontend assembly with the matching Engine host package.',\n        { reason: `unsupported schema ${String(assembly.schemaVersion)}` },\n      ),\n    };\n  }\n  if (!Array.isArray(assembly.entries) || !Array.isArray(assembly.modules)) {\n    return {\n      ok: false,\n      error: new HostAssemblyError(\n        'host-assembly-invalid',\n        'assembly entries and modules to be arrays',\n        'Regenerate the frontend assembly from the active backend authority.',\n        { reason: 'entries or modules is not an array' },\n      ),\n    };\n  }\n  if (!Array.isArray(assembly.pairs)) {\n    return {\n      ok: false,\n      error: new HostAssemblyError(\n        'host-assembly-invalid',\n        'assembly pairs to be an array',\n        'Regenerate the assembly from the backend host using the matching host package.',\n        { reason: 'pairs is not an array' },\n      ),\n    };\n  }\n  const seen = new Set<string>();\n  for (const [index, entry] of assembly.entries.entries()) {\n    const reason = validateEntry(entry, `entries[${index}]`);\n    if (reason !== undefined) {\n      return {\n        ok: false,\n        error: new HostAssemblyError(\n          'host-assembly-invalid',\n          'all assembly entries to be valid native EntryOptions',\n          'Repair the backend Entry projection before publishing it to a browser.',\n          { reason },\n        ),\n      };\n    }\n    if (seen.has(entry.id)) {\n      return {\n        ok: false,\n        error: new HostAssemblyError(\n          'host-assembly-invalid',\n          'assembly Entry ids to be unique',\n          'Give repeated plugin instances independent stable ids.',\n          { reason: `duplicate Entry id ${entry.id}` },\n        ),\n      };\n    }\n    seen.add(entry.id);\n  }\n  const seenModules = new Map<string, HostModuleDescriptor>();\n  for (const [index, module] of assembly.modules.entries()) {\n    if (\n      module === null ||\n      typeof module !== 'object' ||\n      typeof module.name !== 'string' ||\n      typeof module.realm !== 'string' ||\n      typeof module.version !== 'string' ||\n      module.name.length === 0 ||\n      module.version.length === 0 ||\n      (module.url !== undefined && typeof module.url !== 'string') ||\n      (module.digest !== undefined &&\n        (typeof module.digest !== 'string' || module.digest.length === 0))\n    ) {\n      return {\n        ok: false,\n        error: new HostAssemblyError(\n          'host-assembly-invalid',\n          'module names and versions to be non-empty',\n          'Regenerate the module projection from the resolved package metadata.',\n          { reason: `invalid module at index ${index}` },\n        ),\n      };\n    }\n    const previousModule = seenModules.get(module.name);\n    if (\n      previousModule !== undefined &&\n      (previousModule.realm !== module.realm ||\n        previousModule.version !== module.version ||\n        previousModule.url !== module.url ||\n        previousModule.digest !== module.digest)\n    ) {\n      return {\n        ok: false,\n        error: new HostAssemblyError(\n          'host-assembly-invalid',\n          'assembly module identity to be consistent for repeated Entries',\n          'Reuse one resolved module identity when a package has multiple Entry instances.',\n          { reason: `module ${module.name} has conflicting identities` },\n        ),\n      };\n    }\n    seenModules.set(module.name, module);\n  }\n  const seenPairIds = new Set<string>();\n  for (const [index, pair] of assembly.pairs.entries()) {\n    const pairModule = pair?.module;\n    if (\n      pair === null ||\n      typeof pair !== 'object' ||\n      typeof pair.id !== 'string' ||\n      pair.id.length === 0 ||\n      typeof pair.entryId !== 'string' ||\n      pair.entryId.length === 0 ||\n      pairModule === null ||\n      pairModule === undefined ||\n      typeof pairModule !== 'object' ||\n      typeof pairModule.name !== 'string' ||\n      typeof pairModule.realm !== 'string' ||\n      typeof pairModule.version !== 'string' ||\n      pairModule.name.length === 0 ||\n      pairModule.version.length === 0 ||\n      (pairModule.url !== undefined && typeof pairModule.url !== 'string') ||\n      (pairModule.digest !== undefined &&\n        (typeof pairModule.digest !== 'string' || pairModule.digest.length === 0))\n    ) {\n      return {\n        ok: false,\n        error: new HostAssemblyError(\n          'host-assembly-invalid',\n          'assembly pair identities and modules to be valid',\n          'Regenerate paired frontend entries from the backend package manifest.',\n          { reason: `invalid pair at index ${index}` },\n        ),\n      };\n    }\n    if (seenPairIds.has(pair.id)) {\n      return {\n        ok: false,\n        error: new HostAssemblyError(\n          'host-assembly-invalid',\n          'assembly pair ids to be unique',\n          'Give each paired package instance an independent stable id.',\n          { reason: `duplicate pair ${pair.id}` },\n        ),\n      };\n    }\n    seenPairIds.add(pair.id);\n    if (!assembly.entries.some((entry) => entry.id === pair.entryId)) {\n      return {\n        ok: false,\n        error: new HostAssemblyError(\n          'host-assembly-invalid',\n          `pair ${pair.id} to reference an assembly Entry`,\n          'Keep paired identity and frontend Entry projection under one backend authority.',\n          { reason: `missing frontend Entry ${pair.entryId}` },\n        ),\n      };\n    }\n    const module = assembly.modules.find(\n      (candidate) =>\n        candidate.name === pairModule.name &&\n        candidate.realm === pairModule.realm &&\n        candidate.version === pairModule.version &&\n        candidate.url === pairModule.url &&\n        candidate.digest === pairModule.digest,\n    );\n    if (module === undefined) {\n      return {\n        ok: false,\n        error: new HostAssemblyError(\n          'host-assembly-invalid',\n          `pair ${pair.id} to reference a resolved frontend module`,\n          'Keep module/code identity in the backend-derived assembly projection.',\n          { reason: `missing frontend module ${pairModule.name}` },\n        ),\n      };\n    }\n  }\n  const expected = hostRevision({\n    schemaVersion: assembly.schemaVersion,\n    entries: assembly.entries,\n    modules: assembly.modules,\n    pairs: assembly.pairs,\n    ...(assembly.config === undefined ? {} : { config: assembly.config }),\n  });\n  if (expected !== assembly.revision) {\n    return {\n      ok: false,\n      error: new HostAssemblyError(\n        'host-assembly-revision-mismatch',\n        'assembly revision to match its entries and modules',\n        'Discard the stale response and request the current backend assembly again.',\n        { actual: assembly.revision, expected },\n      ),\n    };\n  }\n  return { ok: true, value: assembly };\n}\n\n/** Derive a static module descriptor set from an existing native Catalog. */\nexport function modulesFromCatalog(\n  catalog: PluginCatalog,\n  realm: PluginRealm,\n  version = 'static',\n): HostModuleDescriptor[] {\n  return [...catalog.entries()]\n    .filter(([, record]) => record.realm === realm)\n    .map(([name, record]) => ({\n      name,\n      realm,\n      version: record.version ?? version,\n      ...(record.digest === undefined ? {} : { digest: record.digest }),\n    }));\n}\n","import { HostAssemblyError, type HostErrorSummary } from './protocol.js';\n\nexport const HOST_ASSEMBLY_SERVICE = 'host/assembly.get' as const;\nexport const HOST_ACTIVATION_REPORT_SERVICE = 'host/assembly.report' as const;\nexport const HOST_ASSEMBLY_CHANGED_TOPIC = 'host/assembly.changed' as const;\n\nexport interface HostRequestOptions {\n  readonly signal?: AbortSignal;\n  /** The service generation observed by the caller. */\n  readonly generation?: number;\n}\n\nexport interface HostServiceRequest<T = unknown> {\n  readonly service: string;\n  readonly payload: T;\n  readonly generation: number;\n  readonly signal: AbortSignal;\n}\n\nexport type HostServiceHandler<TPayload = unknown, TResult = unknown> = (\n  request: HostServiceRequest<TPayload>,\n) => Promise<TResult> | TResult;\n\nexport interface HostServiceSnapshot {\n  readonly service: string;\n  readonly generation: number;\n}\n\nexport interface HostTransportClient {\n  readonly connected: boolean;\n  readonly generation: number;\n  request<TPayload, TResult>(\n    service: string,\n    payload: TPayload,\n    options?: HostRequestOptions,\n  ): Promise<TResult>;\n  subscribe<T>(topic: string, listener: (payload: T) => void): () => void;\n  /** Observe a terminal connection loss without issuing another request. */\n  onDisconnect(listener: (error: HostAssemblyError) => void): () => void;\n  close(reason?: unknown): void;\n}\n\nexport interface HostTransportServer {\n  readonly connectedClients: number;\n  register<TPayload, TResult>(\n    service: string,\n    handler: HostServiceHandler<TPayload, TResult>,\n  ): () => void;\n  invalidate(service: string): void;\n  snapshot(service: string): HostServiceSnapshot | undefined;\n  publish<T>(topic: string, payload: T): void;\n  connect(): HostTransportClient;\n  close(reason?: unknown): void;\n}\n\ninterface ServiceRecord {\n  readonly identity: symbol;\n  generation: number;\n  handler: (request: HostServiceRequest<unknown>) => Promise<unknown> | unknown;\n  pending: Set<AbortController>;\n}\n\ninterface ClientState {\n  connected: boolean;\n  readonly subscriptions: Map<string, Set<(payload: unknown) => void>>;\n  readonly pending: Set<AbortController>;\n  readonly disconnectListeners: Set<(error: HostAssemblyError) => void>;\n}\n\n/**\n * Create the small typed transport seam used by host plugins.\n *\n * This implementation is deliberately transport-neutral: the same request,\n * subscription, cancellation, and generation semantics can be adapted to a\n * WebSocket or MessagePort without moving business objects across the wire.\n * It is also useful for deterministic host and lifecycle tests.\n */\nexport function createHostTransport(): HostTransportServer {\n  const services = new Map<string, ServiceRecord>();\n  const generations = new Map<string, number>();\n  const clients = new Set<ClientState>();\n  let closed = false;\n\n  const closeClient = (state: ClientState, reason?: unknown): void => {\n    if (!state.connected) return;\n    state.connected = false;\n    for (const controller of state.pending) controller.abort();\n    state.pending.clear();\n    for (const callbacks of state.subscriptions.values()) callbacks.clear();\n    state.subscriptions.clear();\n    clients.delete(state);\n    const error = new HostAssemblyError(\n      'host-transport-failure',\n      'the host connection to remain available',\n      'Reconnect the frontend host before issuing another request.',\n      { service: 'host/socket', reason: String(reason ?? 'host connection closed') },\n    );\n    for (const listener of state.disconnectListeners) listener(error);\n    state.disconnectListeners.clear();\n  };\n\n  const server: HostTransportServer = {\n    get connectedClients() {\n      return clients.size;\n    },\n    register(service, handler) {\n      if (closed) throw new Error('host transport is closed');\n      const previous = services.get(service);\n      const generation = (generations.get(service) ?? 0) + 1;\n      generations.set(service, generation);\n      for (const controller of previous?.pending ?? []) controller.abort();\n      const identity = Symbol(service);\n      services.set(service, {\n        identity,\n        generation,\n        handler: handler as unknown as (\n          request: HostServiceRequest<unknown>,\n        ) => Promise<unknown> | unknown,\n        pending: new Set(),\n      });\n      return () => {\n        const current = services.get(service);\n        if (current?.identity !== identity) return;\n        for (const controller of current.pending) controller.abort();\n        generations.set(service, current.generation + 1);\n        services.delete(service);\n      };\n    },\n    invalidate(service) {\n      const current = services.get(service);\n      if (current === undefined) return;\n      for (const controller of current.pending) controller.abort();\n      generations.set(service, current.generation + 1);\n      services.delete(service);\n    },\n    snapshot(service) {\n      const current = services.get(service);\n      return current === undefined ? undefined : { service, generation: current.generation };\n    },\n    publish(topic, payload) {\n      for (const state of clients) {\n        for (const listener of state.subscriptions.get(topic) ?? []) listener(payload);\n      }\n    },\n    connect() {\n      if (closed) throw new Error('host transport is closed');\n      const state: ClientState = {\n        connected: true,\n        subscriptions: new Map(),\n        pending: new Set(),\n        disconnectListeners: new Set(),\n      };\n      clients.add(state);\n      const client: HostTransportClient = {\n        get connected() {\n          return state.connected;\n        },\n        get generation() {\n          let current = 0;\n          for (const service of services.values()) current = Math.max(current, service.generation);\n          return current;\n        },\n        async request(service, payload, options = {}) {\n          if (!state.connected) {\n            throw new HostAssemblyError(\n              'host-assembly-service-unavailable',\n              `service ${service} to be available on the current connection`,\n              'Reconnect the frontend host before issuing another request.',\n              { service },\n            );\n          }\n          if (options.signal?.aborted) {\n            throw new HostAssemblyError(\n              'host-assembly-request-aborted',\n              `request ${service} to start with a live AbortSignal`,\n              'Start a fresh request with a live AbortSignal.',\n              { service },\n            );\n          }\n          const record = services.get(service);\n          if (record === undefined) {\n            const invalidatedGeneration = generations.get(service);\n            if (\n              options.generation !== undefined &&\n              invalidatedGeneration !== undefined &&\n              options.generation < invalidatedGeneration\n            ) {\n              throw new HostAssemblyError(\n                'host-assembly-stale-request',\n                `request generation ${options.generation} to match the invalidated service ${service}`,\n                'Refresh the client capability after the backend service is enabled again.',\n                { service, generation: options.generation },\n              );\n            }\n            throw new HostAssemblyError(\n              'host-assembly-service-unavailable',\n              `service ${service} to be registered`,\n              'Wait for the backend plugin to activate before using this capability.',\n              { service },\n            );\n          }\n          const generation = options.generation ?? record.generation;\n          if (generation !== record.generation) {\n            throw new HostAssemblyError(\n              'host-assembly-stale-request',\n              `request generation ${generation} to match service ${service}`,\n              'Refresh the client capability and retry only when the owning business contract permits it.',\n              { service, generation },\n            );\n          }\n          const controller = new AbortController();\n          const abortFromCaller = (): void => controller.abort();\n          options.signal?.addEventListener('abort', abortFromCaller, { once: true });\n          record.pending.add(controller);\n          state.pending.add(controller);\n          let removeAbortRequest: (() => void) | undefined;\n          try {\n            if (controller.signal.aborted) {\n              throw new HostAssemblyError(\n                'host-assembly-request-aborted',\n                `request ${service} not to be aborted before execution`,\n                'Start a fresh request with a live AbortSignal.',\n                { service },\n              );\n            }\n            let abortReject: ((reason: unknown) => void) | undefined;\n            const aborted = new Promise<never>((_, reject) => {\n              abortReject = reject;\n            });\n            const abortRequest = (): void => {\n              abortReject?.(\n                new HostAssemblyError(\n                  'host-assembly-request-aborted',\n                  `request ${service} to finish before its service is closed or invalidated`,\n                  'Treat the capability as withdrawn and refresh the service before retrying.',\n                  { service },\n                ),\n              );\n            };\n            controller.signal.addEventListener('abort', abortRequest, { once: true });\n            removeAbortRequest = () => controller.signal.removeEventListener('abort', abortRequest);\n            const result = await Promise.race([\n              Promise.resolve(\n                record.handler({\n                  service,\n                  payload,\n                  generation,\n                  signal: controller.signal,\n                }),\n              ),\n              aborted,\n            ]);\n            if (controller.signal.aborted) {\n              throw new HostAssemblyError(\n                'host-assembly-request-aborted',\n                `request ${service} to finish before its service is invalidated`,\n                'Treat the capability as withdrawn and refresh the service before retrying.',\n                { service },\n              );\n            }\n            return result as never;\n          } finally {\n            removeAbortRequest?.();\n            record.pending.delete(controller);\n            state.pending.delete(controller);\n            options.signal?.removeEventListener('abort', abortFromCaller);\n          }\n        },\n        subscribe(topic, listener) {\n          if (!state.connected) return () => {};\n          const callbacks = state.subscriptions.get(topic) ?? new Set();\n          callbacks.add(listener as (payload: unknown) => void);\n          state.subscriptions.set(topic, callbacks);\n          return () => {\n            callbacks.delete(listener as (payload: unknown) => void);\n            if (callbacks.size === 0) state.subscriptions.delete(topic);\n          };\n        },\n        onDisconnect(listener) {\n          if (!state.connected) {\n            listener(\n              new HostAssemblyError(\n                'host-transport-failure',\n                'the host connection to remain available',\n                'Reconnect the frontend host before issuing another request.',\n                { service: 'host/socket', reason: 'host connection is already closed' },\n              ),\n            );\n            return () => {};\n          }\n          state.disconnectListeners.add(listener);\n          return () => state.disconnectListeners.delete(listener);\n        },\n        close(reason) {\n          closeClient(state, reason);\n        },\n      };\n      return client;\n    },\n    close(reason) {\n      if (closed) return;\n      closed = true;\n      for (const service of services.values())\n        for (const controller of service.pending) controller.abort();\n      services.clear();\n      for (const client of [...clients]) closeClient(client, reason);\n      generations.clear();\n    },\n  };\n\n  return server;\n}\n\n/** Minimal socket shape shared by browser WebSocket and Node `ws` instances. */\nexport interface HostSocketLike {\n  readonly readyState?: number;\n  send(data: string): void;\n  close(code?: number, reason?: string): void;\n  addEventListener?(type: string, listener: (...args: unknown[]) => void): void;\n  removeEventListener?(type: string, listener: (...args: unknown[]) => void): void;\n  on?(type: string, listener: (...args: unknown[]) => void): void;\n  off?(type: string, listener: (...args: unknown[]) => void): void;\n}\n\ntype HostWireMessage =\n  | {\n      readonly kind: 'request';\n      readonly id: string;\n      readonly service: string;\n      readonly payload: unknown;\n      readonly generation?: number;\n    }\n  | { readonly kind: 'cancel'; readonly id: string }\n  | { readonly kind: 'subscribe'; readonly topic: string }\n  | { readonly kind: 'unsubscribe'; readonly topic: string }\n  | {\n      readonly kind: 'response';\n      readonly id: string;\n      readonly ok: boolean;\n      readonly value?: unknown;\n      readonly error?: HostErrorSummary;\n      readonly generation?: number;\n    }\n  | { readonly kind: 'event'; readonly topic: string; readonly payload: unknown };\n\nfunction addSocketListener(\n  socket: HostSocketLike,\n  type: string,\n  listener: (...args: unknown[]) => void,\n): () => void {\n  if (socket.addEventListener !== undefined) {\n    socket.addEventListener(type, listener);\n    return () => socket.removeEventListener?.(type, listener);\n  }\n  socket.on?.(type, listener);\n  return () => socket.off?.(type, listener);\n}\n\nfunction socketPayload(value: unknown): string | undefined {\n  const data = Array.isArray(value) ? value[0] : value;\n  if (typeof data === 'string') return data;\n  if (data instanceof ArrayBuffer) return new TextDecoder().decode(data);\n  if (data instanceof Uint8Array) return new TextDecoder().decode(data);\n  if (data !== null && typeof data === 'object' && 'data' in data)\n    return socketPayload((data as { readonly data?: unknown }).data);\n  return undefined;\n}\n\nfunction parseWire(value: unknown): HostWireMessage | undefined {\n  const source = socketPayload(value);\n  if (source === undefined) return undefined;\n  try {\n    const parsed = JSON.parse(source) as unknown;\n    return parsed !== null &&\n      typeof parsed === 'object' &&\n      typeof (parsed as { kind?: unknown }).kind === 'string'\n      ? (parsed as HostWireMessage)\n      : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction serializeError(service: string, error: unknown): HostErrorSummary {\n  if (\n    error !== null &&\n    typeof error === 'object' &&\n    typeof (error as { code?: unknown }).code === 'string' &&\n    typeof (error as { expected?: unknown }).expected === 'string' &&\n    typeof (error as { hint?: unknown }).hint === 'string'\n  ) {\n    const detail = (error as { readonly detail?: unknown }).detail;\n    return {\n      code: (error as { readonly code: string }).code,\n      expected: (error as { readonly expected: string }).expected,\n      hint: (error as { readonly hint: string }).hint,\n      detail:\n        detail !== null && typeof detail === 'object'\n          ? (detail as Readonly<Record<string, unknown>>)\n          : { reason: String(detail ?? 'unknown failure') },\n    };\n  }\n  return {\n    code: 'host-transport-failure',\n    expected: `service ${service} to complete without an exception`,\n    hint: 'Inspect the backend host process and reconnect before retrying.',\n    detail: { service, reason: error instanceof Error ? error.message : String(error) },\n  };\n}\n\nfunction errorFromSummary(service: string, summary: HostErrorSummary): HostAssemblyError {\n  const detail = summary.detail as Record<string, unknown>;\n  const supported = new Set([\n    'host-assembly-invalid',\n    'host-assembly-revision-mismatch',\n    'host-assembly-module-missing',\n    'host-assembly-module-version-mismatch',\n    'host-assembly-reload-required',\n    'host-assembly-service-unavailable',\n    'host-assembly-stale-request',\n    'host-assembly-request-aborted',\n    'host-assembly-not-ready',\n    'host-transport-failure',\n  ]);\n  if (supported.has(summary.code)) {\n    return new HostAssemblyError(\n      summary.code as never,\n      summary.expected,\n      summary.hint,\n      detail as never,\n    );\n  }\n  return new HostAssemblyError('host-transport-failure', summary.expected, summary.hint, {\n    service,\n    reason: summary.detail.reason ? String(summary.detail.reason) : summary.code,\n  });\n}\n\nfunction transportFailure(service: string, reason: string): HostAssemblyError {\n  return new HostAssemblyError(\n    'host-transport-failure',\n    `service ${service} to remain connected`,\n    'Reconnect the frontend host and inspect the backend transport diagnostics.',\n    { service, reason },\n  );\n}\n\nfunction sendWire(socket: HostSocketLike, message: HostWireMessage): void {\n  socket.send(JSON.stringify(message));\n}\n\n/** Connect one browser WebSocket (or an already-open Node `ws`) to a host server. */\nexport async function createHostWebSocketClient(\n  socket: HostSocketLike,\n): Promise<HostTransportClient> {\n  if (socket.readyState !== undefined && socket.readyState !== 1) {\n    await new Promise<void>((resolve, reject) => {\n      const removeOpen = addSocketListener(socket, 'open', () => {\n        removeOpen();\n        removeError();\n        resolve();\n      });\n      const removeError = addSocketListener(socket, 'error', (cause) => {\n        removeOpen();\n        removeError();\n        reject(transportFailure('host/connect', String(cause ?? 'socket error')));\n      });\n    });\n  }\n  const pending = new Map<\n    string,\n    {\n      readonly resolve: (value: unknown) => void;\n      readonly reject: (reason: unknown) => void;\n      readonly cleanup: () => void;\n    }\n  >();\n  const subscriptions = new Map<string, Set<(payload: unknown) => void>>();\n  const disconnectListeners = new Set<(error: HostAssemblyError) => void>();\n  let connected = true;\n  let generation = 0;\n  let sequence = 0;\n  const disconnectError = (reason: unknown): HostAssemblyError =>\n    transportFailure('host/socket', reason instanceof Error ? reason.message : String(reason));\n  const failPending = (reason: unknown): void => {\n    if (!connected) return;\n    connected = false;\n    for (const request of pending.values()) {\n      request.cleanup();\n      request.reject(reason);\n    }\n    pending.clear();\n    subscriptions.clear();\n    const error = disconnectError(reason);\n    for (const listener of disconnectListeners) listener(error);\n    disconnectListeners.clear();\n  };\n  const removeMessage = addSocketListener(socket, 'message', (event) => {\n    const message = parseWire(event);\n    if (message === undefined) return;\n    if (message.kind === 'event') {\n      for (const listener of subscriptions.get(message.topic) ?? []) listener(message.payload);\n      return;\n    }\n    if (message.kind !== 'response') return;\n    if (message.generation !== undefined) generation = Math.max(generation, message.generation);\n    const request = pending.get(message.id);\n    if (request === undefined) return;\n    pending.delete(message.id);\n    request.cleanup();\n    if (message.ok) request.resolve(message.value);\n    else\n      request.reject(\n        errorFromSummary(\n          'host/socket',\n          message.error ?? serializeError('host/socket', 'unknown response failure'),\n        ),\n      );\n  });\n  const removeClose = addSocketListener(socket, 'close', (reason) => {\n    removeMessage();\n    removeClose();\n    removeError();\n    failPending(disconnectError(reason));\n  });\n  const removeError = addSocketListener(socket, 'error', (reason) => {\n    failPending(disconnectError(reason));\n  });\n  const client: HostTransportClient = {\n    get connected() {\n      return connected;\n    },\n    get generation() {\n      return generation;\n    },\n    request<TPayload, TResult>(\n      service: string,\n      payload: TPayload,\n      options: HostRequestOptions = {},\n    ): Promise<TResult> {\n      if (!connected) return Promise.reject(disconnectError('socket is closed'));\n      if (options.signal?.aborted)\n        return Promise.reject(\n          new HostAssemblyError(\n            'host-assembly-request-aborted',\n            `request ${service} to start with a live AbortSignal`,\n            'Start a fresh request with a live AbortSignal.',\n            { service },\n          ),\n        );\n      sequence += 1;\n      const id = `${Date.now().toString(36)}-${sequence.toString(36)}`;\n      return new Promise<TResult>((resolve, reject) => {\n        const abort = (): void => {\n          const request = pending.get(id);\n          if (request === undefined) return;\n          pending.delete(id);\n          request.cleanup();\n          try {\n            sendWire(socket, { kind: 'cancel', id });\n          } catch {\n            // The close/error listener reports the transport failure separately.\n          }\n          reject(\n            new HostAssemblyError(\n              'host-assembly-request-aborted',\n              `request ${service} to finish before cancellation`,\n              'Start a fresh request with a live AbortSignal.',\n              { service },\n            ),\n          );\n        };\n        const cleanup = (): void => options.signal?.removeEventListener('abort', abort);\n        pending.set(id, {\n          resolve: resolve as unknown as (value: unknown) => void,\n          reject,\n          cleanup,\n        });\n        options.signal?.addEventListener('abort', abort, { once: true });\n        if (options.signal?.aborted) {\n          abort();\n          return;\n        }\n        try {\n          sendWire(socket, {\n            kind: 'request',\n            id,\n            service,\n            payload,\n            ...(options.generation === undefined ? {} : { generation: options.generation }),\n          });\n        } catch (cause) {\n          const request = pending.get(id);\n          request?.cleanup();\n          pending.delete(id);\n          reject(disconnectError(cause));\n        }\n      });\n    },\n    subscribe(topic, listener) {\n      if (!connected) return () => {};\n      const listeners = subscriptions.get(topic) ?? new Set();\n      listeners.add(listener as (payload: unknown) => void);\n      subscriptions.set(topic, listeners);\n      sendWire(socket, { kind: 'subscribe', topic });\n      return () => {\n        listeners.delete(listener as (payload: unknown) => void);\n        if (listeners.size !== 0) return;\n        subscriptions.delete(topic);\n        sendWire(socket, { kind: 'unsubscribe', topic });\n      };\n    },\n    onDisconnect(listener) {\n      if (!connected) {\n        listener(disconnectError('socket is already closed'));\n        return () => {};\n      }\n      disconnectListeners.add(listener);\n      return () => disconnectListeners.delete(listener);\n    },\n    close(reason) {\n      if (!connected) return;\n      failPending(disconnectError(reason ?? 'client closed the host connection'));\n      removeMessage();\n      removeClose();\n      removeError();\n      socket.close();\n    },\n  };\n  return client;\n}\n\n/** Open a browser-native WebSocket and install the typed host client. */\nexport async function connectHostWebSocket(url: string): Promise<HostTransportClient> {\n  const Constructor = globalThis.WebSocket;\n  if (typeof Constructor !== 'function')\n    throw transportFailure('host/connect', 'the current runtime does not provide WebSocket');\n  return createHostWebSocketClient(new Constructor(url) as unknown as HostSocketLike);\n}\n\n/** Attach one accepted process-side socket to an Engine host transport server. */\nexport function attachHostWebSocketServer(\n  socket: HostSocketLike,\n  server: HostTransportServer,\n): () => void {\n  const client = server.connect();\n  const pending = new Map<string, AbortController>();\n  const subscriptions = new Map<string, () => void>();\n  let disposed = false;\n  const removeMessage = addSocketListener(socket, 'message', (event) => {\n    const message = parseWire(event);\n    if (message === undefined || disposed) return;\n    if (message.kind === 'cancel') {\n      pending.get(message.id)?.abort();\n      return;\n    }\n    if (message.kind === 'subscribe') {\n      subscriptions.get(message.topic)?.();\n      subscriptions.set(\n        message.topic,\n        client.subscribe(message.topic, (payload) => {\n          if (!disposed) sendWire(socket, { kind: 'event', topic: message.topic, payload });\n        }),\n      );\n      return;\n    }\n    if (message.kind === 'unsubscribe') {\n      subscriptions.get(message.topic)?.();\n      subscriptions.delete(message.topic);\n      return;\n    }\n    if (message.kind !== 'request') return;\n    const controller = new AbortController();\n    pending.set(message.id, controller);\n    void client\n      .request(message.service, message.payload, {\n        signal: controller.signal,\n        ...(message.generation === undefined ? {} : { generation: message.generation }),\n      })\n      .then((value) => {\n        if (!disposed)\n          sendWire(socket, {\n            kind: 'response',\n            id: message.id,\n            ok: true,\n            value,\n            generation: client.generation,\n          });\n      })\n      .catch((error) => {\n        if (!disposed)\n          sendWire(socket, {\n            kind: 'response',\n            id: message.id,\n            ok: false,\n            error: serializeError(message.service, error),\n            generation: client.generation,\n          });\n      })\n      .finally(() => pending.delete(message.id));\n  });\n  const removeClose = addSocketListener(socket, 'close', () => dispose());\n  const removeError = addSocketListener(socket, 'error', () => dispose());\n  function dispose(): void {\n    if (disposed) return;\n    disposed = true;\n    removeMessage();\n    removeClose();\n    removeError();\n    for (const controller of pending.values()) controller.abort();\n    pending.clear();\n    for (const unsubscribe of subscriptions.values()) unsubscribe();\n    subscriptions.clear();\n    client.close('host socket disconnected');\n  }\n  return dispose;\n}\n"]}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@forgeax/engine-host",
+  "version": "0.1.27",
+  "private": false,
+  "type": "module",
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "description": "Engine-owned thin frontend/backend plugin hosts and backend-derived assembly protocol.",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/index.mjs",
+      "import": "./dist/index.mjs"
+    },
+    "./frontend": {
+      "types": "./dist/frontend.d.ts",
+      "browser": "./dist/frontend.mjs",
+      "import": "./dist/frontend.mjs"
+    },
+    "./backend": {
+      "types": "./dist/backend.d.ts",
+      "node": "./dist/backend.mjs",
+      "import": "./dist/backend.mjs",
+      "default": null
+    },
+    "./protocol": {
+      "types": "./dist/protocol.d.ts",
+      "browser": "./dist/protocol.mjs",
+      "import": "./dist/protocol.mjs"
+    },
+    "./transport": {
+      "types": "./dist/transport.d.ts",
+      "browser": "./dist/transport.mjs",
+      "import": "./dist/transport.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@deepseek-ai/cordis-plugin-loader": "1.0.2",
+    "@forgeax/engine-plugin": "0.1.27"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "@types/ws": "^8.18.1",
+    "tsup": "^8.3.5",
+    "typescript": "^5.8.3",
+    "vitest": "4.1.11",
+    "ws": "^8.21.0"
+  },
+  "forgeax": {
+    "metrics": {
+      "bundle-size": {
+        "enabled": true,
+        "path": "dist/index.mjs",
+        "compression": "gzip"
+      },
+      "fps": {
+        "enabled": false,
+        "reason": "host control plane has no frame loop"
+      },
+      "bench": {
+        "enabled": false,
+        "reason": "host control plane is not a benchmark surface"
+      },
+      "gate": {
+        "enabled": true,
+        "command": "pnpm -F @forgeax/engine-host test"
+      },
+      "spike-report": {
+        "enabled": false,
+        "reason": "production host package"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc -b",
+    "test": "vitest run --config ./vitest.config.ts"
+  }
+}