@xoos/runtime 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,72 @@
1
+ import { XOOSRuntimeContext, XOOSRuntimeFeed } from '@xoos/contracts';
2
+ export { XOOSCapabilityRequest, XOOSCapabilityResponse, XOOSFeedMicroapp, XOOSMicroappManifest, XOOSRuntimeContext, XOOSRuntimeFeed } from '@xoos/contracts';
3
+
4
+ interface XOOSRuntimeOptions {
5
+ clientId: string;
6
+ apiBaseUrl: string;
7
+ getAccessToken: () => Promise<string | null>;
8
+ environment?: "development" | "staging" | "production";
9
+ requestTimeoutMs?: number;
10
+ onError?: (error: Error) => void;
11
+ }
12
+ interface XOOSMountOptions {
13
+ target: HTMLElement;
14
+ props?: Record<string, unknown>;
15
+ }
16
+ interface XOOSMountedMicroapp {
17
+ microappKey: string;
18
+ element: HTMLElement;
19
+ unmount: () => Promise<void>;
20
+ }
21
+ interface XOOSMicroappBridge {
22
+ context: XOOSRuntimeContext;
23
+ navigation: {
24
+ navigate: (microappKey: string, target?: HTMLElement) => Promise<void>;
25
+ };
26
+ events: {
27
+ emit: (event: string, payload?: unknown) => void;
28
+ on: (event: string, handler: (payload: unknown) => void) => () => void;
29
+ };
30
+ services: {
31
+ request: <T>(capability: string, input?: unknown, microappKey?: string) => Promise<T>;
32
+ };
33
+ }
34
+ interface XOOSRuntimeElement extends HTMLElement {
35
+ xoos?: XOOSMicroappBridge;
36
+ xoosProps?: Record<string, unknown>;
37
+ }
38
+
39
+ declare class XOOSRuntime {
40
+ private readonly options;
41
+ static readonly version = "0.1.0";
42
+ private initialized;
43
+ private context;
44
+ private feed;
45
+ private readonly mounted;
46
+ private readonly auth;
47
+ private readonly http;
48
+ private readonly events;
49
+ private readonly manifests;
50
+ private readonly modules;
51
+ constructor(options: XOOSRuntimeOptions);
52
+ initialize(): Promise<void>;
53
+ getContext(): XOOSRuntimeContext;
54
+ getFeed(): XOOSRuntimeFeed;
55
+ mount(microappKey: string, options: XOOSMountOptions): Promise<XOOSMountedMicroapp>;
56
+ unmount(microappKey: string): Promise<void>;
57
+ navigate(microappKey: string, target?: HTMLElement): Promise<void>;
58
+ requestCapability<T>(capability: string, input?: unknown, microappKey?: string): Promise<T>;
59
+ destroy(): Promise<void>;
60
+ private createBridge;
61
+ private firstMountedParent;
62
+ private ensureInitialized;
63
+ private report;
64
+ }
65
+
66
+ declare class XOOSRuntimeError extends Error {
67
+ readonly code: string;
68
+ readonly cause?: unknown | undefined;
69
+ constructor(code: string, message: string, cause?: unknown | undefined);
70
+ }
71
+
72
+ export { type XOOSMicroappBridge, type XOOSMountOptions, type XOOSMountedMicroapp, XOOSRuntime, type XOOSRuntimeElement, XOOSRuntimeError, type XOOSRuntimeOptions };
package/dist/index.js ADDED
@@ -0,0 +1,288 @@
1
+ // src/errors/XOOSRuntimeError.ts
2
+ var XOOSRuntimeError = class extends Error {
3
+ constructor(code, message, cause) {
4
+ super(message);
5
+ this.code = code;
6
+ this.cause = cause;
7
+ this.name = "XOOSRuntimeError";
8
+ }
9
+ code;
10
+ cause;
11
+ };
12
+
13
+ // src/managers/AuthManager.ts
14
+ var AuthManager = class {
15
+ constructor(provider) {
16
+ this.provider = provider;
17
+ }
18
+ provider;
19
+ async getAccessToken() {
20
+ const token = await this.provider();
21
+ if (!token) {
22
+ throw new XOOSRuntimeError("AUTH_TOKEN_MISSING", "XO access token is unavailable.");
23
+ }
24
+ return token;
25
+ }
26
+ };
27
+
28
+ // src/managers/EventManager.ts
29
+ var EventManager = class {
30
+ listeners = /* @__PURE__ */ new Map();
31
+ emit(event, payload) {
32
+ this.listeners.get(event)?.forEach((handler) => handler(payload));
33
+ }
34
+ on(event, handler) {
35
+ const set = this.listeners.get(event) ?? /* @__PURE__ */ new Set();
36
+ set.add(handler);
37
+ this.listeners.set(event, set);
38
+ return () => {
39
+ set.delete(handler);
40
+ if (set.size === 0) this.listeners.delete(event);
41
+ };
42
+ }
43
+ clear() {
44
+ this.listeners.clear();
45
+ }
46
+ };
47
+
48
+ // src/managers/HttpClient.ts
49
+ var HttpClient = class {
50
+ constructor(baseUrl, clientId, auth, timeoutMs = 15e3) {
51
+ this.baseUrl = baseUrl;
52
+ this.clientId = clientId;
53
+ this.auth = auth;
54
+ this.timeoutMs = timeoutMs;
55
+ }
56
+ baseUrl;
57
+ clientId;
58
+ auth;
59
+ timeoutMs;
60
+ async get(path) {
61
+ return this.request(path, { method: "GET" });
62
+ }
63
+ async post(path, body) {
64
+ return this.request(path, {
65
+ method: "POST",
66
+ headers: { "Content-Type": "application/json" },
67
+ body: JSON.stringify(body)
68
+ });
69
+ }
70
+ async request(path, init) {
71
+ const token = await this.auth.getAccessToken();
72
+ const controller = new AbortController();
73
+ const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
74
+ const traceId = crypto.randomUUID();
75
+ try {
76
+ const response = await fetch(`${this.baseUrl.replace(/\/$/, "")}${path}`, {
77
+ ...init,
78
+ signal: controller.signal,
79
+ headers: {
80
+ Accept: "application/json",
81
+ Authorization: `Bearer ${token}`,
82
+ "X-XO-Client-Id": this.clientId,
83
+ "X-XO-Trace-Id": traceId,
84
+ ...init.headers ?? {}
85
+ }
86
+ });
87
+ const text = await response.text();
88
+ const body = text ? JSON.parse(text) : null;
89
+ if (!response.ok) {
90
+ const code = body?.error?.code ?? body?.code ?? `HTTP_${response.status}`;
91
+ const message = body?.error?.message ?? body?.message ?? `XOOS request failed (${response.status}).`;
92
+ throw new XOOSRuntimeError(code, message);
93
+ }
94
+ return body;
95
+ } catch (error) {
96
+ if (error instanceof XOOSRuntimeError) throw error;
97
+ if (error instanceof DOMException && error.name === "AbortError") {
98
+ throw new XOOSRuntimeError("REQUEST_TIMEOUT", "XOOS request timed out.", error);
99
+ }
100
+ throw new XOOSRuntimeError("NETWORK_ERROR", "XOOS request failed.", error);
101
+ } finally {
102
+ clearTimeout(timeout);
103
+ }
104
+ }
105
+ };
106
+
107
+ // src/managers/ManifestManager.ts
108
+ var ManifestManager = class {
109
+ cache = /* @__PURE__ */ new Map();
110
+ resolve(url) {
111
+ const existing = this.cache.get(url);
112
+ if (existing) return existing;
113
+ const request = fetch(url).then(async (response) => {
114
+ if (!response.ok) {
115
+ throw new XOOSRuntimeError("MANIFEST_LOAD_FAILED", `Manifest request failed (${response.status}).`);
116
+ }
117
+ const manifest = await response.json();
118
+ this.validate(manifest);
119
+ return manifest;
120
+ }).catch((error) => {
121
+ this.cache.delete(url);
122
+ if (error instanceof XOOSRuntimeError) throw error;
123
+ throw new XOOSRuntimeError("MANIFEST_LOAD_FAILED", "Unable to load Microapp manifest.", error);
124
+ });
125
+ this.cache.set(url, request);
126
+ return request;
127
+ }
128
+ validate(manifest) {
129
+ if (manifest.schemaVersion !== "1" || !manifest.microappKey || !manifest.version || !manifest.elementName || !manifest.entry) {
130
+ throw new XOOSRuntimeError("MANIFEST_INVALID", "Microapp manifest is invalid.");
131
+ }
132
+ }
133
+ };
134
+
135
+ // src/managers/ModuleLoader.ts
136
+ var ModuleLoader = class {
137
+ cache = /* @__PURE__ */ new Map();
138
+ async load(entryUrl) {
139
+ const existing = this.cache.get(entryUrl);
140
+ if (existing) return existing;
141
+ const request = import(
142
+ /* @vite-ignore */
143
+ entryUrl
144
+ ).catch((error) => {
145
+ this.cache.delete(entryUrl);
146
+ throw new XOOSRuntimeError("MODULE_LOAD_FAILED", `Unable to load Microapp module: ${entryUrl}`, error);
147
+ });
148
+ this.cache.set(entryUrl, request);
149
+ return request;
150
+ }
151
+ };
152
+
153
+ // src/XOOSRuntime.ts
154
+ var XOOSRuntime = class {
155
+ constructor(options) {
156
+ this.options = options;
157
+ if (!options.clientId) throw new XOOSRuntimeError("CLIENT_ID_REQUIRED", "XOOS clientId is required.");
158
+ if (!options.apiBaseUrl) throw new XOOSRuntimeError("API_BASE_URL_REQUIRED", "XOOS apiBaseUrl is required.");
159
+ this.auth = new AuthManager(options.getAccessToken);
160
+ this.http = new HttpClient(
161
+ options.apiBaseUrl,
162
+ options.clientId,
163
+ this.auth,
164
+ options.requestTimeoutMs
165
+ );
166
+ }
167
+ options;
168
+ static version = "0.1.0";
169
+ initialized = false;
170
+ context = null;
171
+ feed = null;
172
+ mounted = /* @__PURE__ */ new Map();
173
+ auth;
174
+ http;
175
+ events = new EventManager();
176
+ manifests = new ManifestManager();
177
+ modules = new ModuleLoader();
178
+ async initialize() {
179
+ if (this.initialized) return;
180
+ try {
181
+ this.context = await this.http.get("/v1/runtime/context");
182
+ this.feed = await this.http.get("/v1/runtime/feed");
183
+ this.initialized = true;
184
+ } catch (error) {
185
+ this.report(error);
186
+ throw error;
187
+ }
188
+ }
189
+ getContext() {
190
+ this.ensureInitialized();
191
+ return this.context;
192
+ }
193
+ getFeed() {
194
+ this.ensureInitialized();
195
+ return this.feed;
196
+ }
197
+ async mount(microappKey, options) {
198
+ this.ensureInitialized();
199
+ if (!options.target) throw new XOOSRuntimeError("MOUNT_TARGET_INVALID", "A mount target is required.");
200
+ const feedEntry = this.feed.microapps.find((item) => item.microappKey === microappKey);
201
+ if (!feedEntry) {
202
+ throw new XOOSRuntimeError("MICROAPP_NOT_ENTITLED", `Microapp '${microappKey}' is not in this client feed.`);
203
+ }
204
+ if (feedEntry.deliveryType !== "native_esm") {
205
+ throw new XOOSRuntimeError("DELIVERY_TYPE_UNSUPPORTED", `Runtime V1 supports native_esm only: ${microappKey}`);
206
+ }
207
+ const manifest = await this.manifests.resolve(feedEntry.manifestUrl);
208
+ if (manifest.microappKey !== microappKey) {
209
+ throw new XOOSRuntimeError("MANIFEST_MISMATCH", "Feed and manifest Microapp keys do not match.");
210
+ }
211
+ await this.modules.load(manifest.entry);
212
+ if (!customElements.get(manifest.elementName)) {
213
+ throw new XOOSRuntimeError("ELEMENT_NOT_REGISTERED", `Custom element '${manifest.elementName}' was not registered.`);
214
+ }
215
+ const element = document.createElement(manifest.elementName);
216
+ element.xoos = this.createBridge();
217
+ element.xoosProps = options.props;
218
+ options.target.replaceChildren(element);
219
+ this.mounted.set(microappKey, element);
220
+ return {
221
+ microappKey,
222
+ element,
223
+ unmount: async () => this.unmount(microappKey)
224
+ };
225
+ }
226
+ async unmount(microappKey) {
227
+ this.mounted.get(microappKey)?.remove();
228
+ this.mounted.delete(microappKey);
229
+ }
230
+ async navigate(microappKey, target) {
231
+ const destination = target ?? this.firstMountedParent();
232
+ if (!destination) {
233
+ throw new XOOSRuntimeError("NAVIGATION_TARGET_MISSING", "No target is available for Runtime navigation.");
234
+ }
235
+ await this.mount(microappKey, { target: destination });
236
+ }
237
+ async requestCapability(capability, input = {}, microappKey) {
238
+ this.ensureInitialized();
239
+ const response = await this.http.post(
240
+ `/v1/capabilities/${encodeURIComponent(capability)}`,
241
+ { input, microappKey }
242
+ );
243
+ if (!response.ok) {
244
+ throw new XOOSRuntimeError(
245
+ response.error?.code ?? "CAPABILITY_FAILED",
246
+ response.error?.message ?? `Capability '${capability}' failed.`
247
+ );
248
+ }
249
+ return response.data;
250
+ }
251
+ async destroy() {
252
+ for (const key of [...this.mounted.keys()]) await this.unmount(key);
253
+ this.events.clear();
254
+ this.context = null;
255
+ this.feed = null;
256
+ this.initialized = false;
257
+ }
258
+ createBridge() {
259
+ return {
260
+ context: this.context,
261
+ navigation: { navigate: (microappKey, target) => this.navigate(microappKey, target) },
262
+ events: {
263
+ emit: (event, payload) => this.events.emit(event, payload),
264
+ on: (event, handler) => this.events.on(event, handler)
265
+ },
266
+ services: {
267
+ request: (capability, input, microappKey) => this.requestCapability(capability, input, microappKey)
268
+ }
269
+ };
270
+ }
271
+ firstMountedParent() {
272
+ const element = this.mounted.values().next().value;
273
+ return element?.parentElement ?? null;
274
+ }
275
+ ensureInitialized() {
276
+ if (!this.initialized || !this.context || !this.feed) {
277
+ throw new XOOSRuntimeError("RUNTIME_NOT_INITIALIZED", "Call runtime.initialize() before using the Runtime.");
278
+ }
279
+ }
280
+ report(error) {
281
+ if (error instanceof Error) this.options.onError?.(error);
282
+ }
283
+ };
284
+ export {
285
+ XOOSRuntime,
286
+ XOOSRuntimeError
287
+ };
288
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/errors/XOOSRuntimeError.ts","../src/managers/AuthManager.ts","../src/managers/EventManager.ts","../src/managers/HttpClient.ts","../src/managers/ManifestManager.ts","../src/managers/ModuleLoader.ts","../src/XOOSRuntime.ts"],"sourcesContent":["export class XOOSRuntimeError extends Error {\r\n constructor(\r\n public readonly code: string,\r\n message: string,\r\n public readonly cause?: unknown\r\n ) {\r\n super(message);\r\n this.name = \"XOOSRuntimeError\";\r\n }\r\n}\r\n","import { XOOSRuntimeError } from \"../errors/XOOSRuntimeError\";\r\n\r\nexport class AuthManager {\r\n constructor(private readonly provider: () => Promise<string | null>) {}\r\n\r\n async getAccessToken(): Promise<string> {\r\n const token = await this.provider();\r\n if (!token) {\r\n throw new XOOSRuntimeError(\"AUTH_TOKEN_MISSING\", \"XO access token is unavailable.\");\r\n }\r\n return token;\r\n }\r\n}\r\n","type Handler = (payload: unknown) => void;\r\n\r\nexport class EventManager {\r\n private readonly listeners = new Map<string, Set<Handler>>();\r\n\r\n emit(event: string, payload?: unknown): void {\r\n this.listeners.get(event)?.forEach((handler) => handler(payload));\r\n }\r\n\r\n on(event: string, handler: Handler): () => void {\r\n const set = this.listeners.get(event) ?? new Set<Handler>();\r\n set.add(handler);\r\n this.listeners.set(event, set);\r\n return () => {\r\n set.delete(handler);\r\n if (set.size === 0) this.listeners.delete(event);\r\n };\r\n }\r\n\r\n clear(): void {\r\n this.listeners.clear();\r\n }\r\n}\r\n","import { XOOSRuntimeError } from \"../errors/XOOSRuntimeError\";\r\nimport { AuthManager } from \"./AuthManager\";\r\n\r\nexport class HttpClient {\r\n constructor(\r\n private readonly baseUrl: string,\r\n private readonly clientId: string,\r\n private readonly auth: AuthManager,\r\n private readonly timeoutMs = 15000\r\n ) {}\r\n\r\n async get<T>(path: string): Promise<T> {\r\n return this.request<T>(path, { method: \"GET\" });\r\n }\r\n\r\n async post<T>(path: string, body: unknown): Promise<T> {\r\n return this.request<T>(path, {\r\n method: \"POST\",\r\n headers: { \"Content-Type\": \"application/json\" },\r\n body: JSON.stringify(body)\r\n });\r\n }\r\n\r\n private async request<T>(path: string, init: RequestInit): Promise<T> {\r\n const token = await this.auth.getAccessToken();\r\n const controller = new AbortController();\r\n const timeout = setTimeout(() => controller.abort(), this.timeoutMs);\r\n const traceId = crypto.randomUUID();\r\n\r\n try {\r\n const response = await fetch(`${this.baseUrl.replace(/\\/$/, \"\")}${path}`, {\r\n ...init,\r\n signal: controller.signal,\r\n headers: {\r\n Accept: \"application/json\",\r\n Authorization: `Bearer ${token}`,\r\n \"X-XO-Client-Id\": this.clientId,\r\n \"X-XO-Trace-Id\": traceId,\r\n ...(init.headers ?? {})\r\n }\r\n });\r\n\r\n const text = await response.text();\r\n const body = text ? JSON.parse(text) : null;\r\n\r\n if (!response.ok) {\r\n const code = body?.error?.code ?? body?.code ?? `HTTP_${response.status}`;\r\n const message = body?.error?.message ?? body?.message ?? `XOOS request failed (${response.status}).`;\r\n throw new XOOSRuntimeError(code, message);\r\n }\r\n\r\n return body as T;\r\n } catch (error) {\r\n if (error instanceof XOOSRuntimeError) throw error;\r\n if (error instanceof DOMException && error.name === \"AbortError\") {\r\n throw new XOOSRuntimeError(\"REQUEST_TIMEOUT\", \"XOOS request timed out.\", error);\r\n }\r\n throw new XOOSRuntimeError(\"NETWORK_ERROR\", \"XOOS request failed.\", error);\r\n } finally {\r\n clearTimeout(timeout);\r\n }\r\n }\r\n}\r\n","import type { XOOSMicroappManifest } from \"@xoos/contracts\";\r\nimport { XOOSRuntimeError } from \"../errors/XOOSRuntimeError\";\r\n\r\nexport class ManifestManager {\r\n private readonly cache = new Map<string, Promise<XOOSMicroappManifest>>();\r\n\r\n resolve(url: string): Promise<XOOSMicroappManifest> {\r\n const existing = this.cache.get(url);\r\n if (existing) return existing;\r\n\r\n const request = fetch(url)\r\n .then(async (response) => {\r\n if (!response.ok) {\r\n throw new XOOSRuntimeError(\"MANIFEST_LOAD_FAILED\", `Manifest request failed (${response.status}).`);\r\n }\r\n const manifest = (await response.json()) as XOOSMicroappManifest;\r\n this.validate(manifest);\r\n return manifest;\r\n })\r\n .catch((error) => {\r\n this.cache.delete(url);\r\n if (error instanceof XOOSRuntimeError) throw error;\r\n throw new XOOSRuntimeError(\"MANIFEST_LOAD_FAILED\", \"Unable to load Microapp manifest.\", error);\r\n });\r\n\r\n this.cache.set(url, request);\r\n return request;\r\n }\r\n\r\n private validate(manifest: XOOSMicroappManifest): void {\r\n if (\r\n manifest.schemaVersion !== \"1\" ||\r\n !manifest.microappKey ||\r\n !manifest.version ||\r\n !manifest.elementName ||\r\n !manifest.entry\r\n ) {\r\n throw new XOOSRuntimeError(\"MANIFEST_INVALID\", \"Microapp manifest is invalid.\");\r\n }\r\n }\r\n}\r\n","import { XOOSRuntimeError } from \"../errors/XOOSRuntimeError\";\r\n\r\nexport class ModuleLoader {\r\n private readonly cache = new Map<string, Promise<unknown>>();\r\n\r\n async load(entryUrl: string): Promise<unknown> {\r\n const existing = this.cache.get(entryUrl);\r\n if (existing) return existing;\r\n\r\n const request = import(/* @vite-ignore */ entryUrl).catch((error) => {\r\n this.cache.delete(entryUrl);\r\n throw new XOOSRuntimeError(\"MODULE_LOAD_FAILED\", `Unable to load Microapp module: ${entryUrl}`, error);\r\n });\r\n\r\n this.cache.set(entryUrl, request);\r\n return request;\r\n }\r\n}\r\n","import type {\r\n XOOSCapabilityResponse,\r\n XOOSRuntimeContext,\r\n XOOSRuntimeFeed\r\n} from \"@xoos/contracts\";\r\nimport { XOOSRuntimeError } from \"./errors/XOOSRuntimeError\";\r\nimport { AuthManager } from \"./managers/AuthManager\";\r\nimport { EventManager } from \"./managers/EventManager\";\r\nimport { HttpClient } from \"./managers/HttpClient\";\r\nimport { ManifestManager } from \"./managers/ManifestManager\";\r\nimport { ModuleLoader } from \"./managers/ModuleLoader\";\r\nimport type {\r\n XOOSMicroappBridge,\r\n XOOSMountedMicroapp,\r\n XOOSMountOptions,\r\n XOOSRuntimeElement,\r\n XOOSRuntimeOptions\r\n} from \"./types/runtime\";\r\n\r\nexport class XOOSRuntime {\r\n static readonly version = \"0.1.0\";\r\n\r\n private initialized = false;\r\n private context: XOOSRuntimeContext | null = null;\r\n private feed: XOOSRuntimeFeed | null = null;\r\n private readonly mounted = new Map<string, HTMLElement>();\r\n private readonly auth: AuthManager;\r\n private readonly http: HttpClient;\r\n private readonly events = new EventManager();\r\n private readonly manifests = new ManifestManager();\r\n private readonly modules = new ModuleLoader();\r\n\r\n constructor(private readonly options: XOOSRuntimeOptions) {\r\n if (!options.clientId) throw new XOOSRuntimeError(\"CLIENT_ID_REQUIRED\", \"XOOS clientId is required.\");\r\n if (!options.apiBaseUrl) throw new XOOSRuntimeError(\"API_BASE_URL_REQUIRED\", \"XOOS apiBaseUrl is required.\");\r\n this.auth = new AuthManager(options.getAccessToken);\r\n this.http = new HttpClient(\r\n options.apiBaseUrl,\r\n options.clientId,\r\n this.auth,\r\n options.requestTimeoutMs\r\n );\r\n }\r\n\r\n async initialize(): Promise<void> {\r\n if (this.initialized) return;\r\n try {\r\n this.context = await this.http.get<XOOSRuntimeContext>(\"/v1/runtime/context\");\r\n this.feed = await this.http.get<XOOSRuntimeFeed>(\"/v1/runtime/feed\");\r\n this.initialized = true;\r\n } catch (error) {\r\n this.report(error);\r\n throw error;\r\n }\r\n }\r\n\r\n getContext(): XOOSRuntimeContext {\r\n this.ensureInitialized();\r\n return this.context!;\r\n }\r\n\r\n getFeed(): XOOSRuntimeFeed {\r\n this.ensureInitialized();\r\n return this.feed!;\r\n }\r\n\r\n async mount(microappKey: string, options: XOOSMountOptions): Promise<XOOSMountedMicroapp> {\r\n this.ensureInitialized();\r\n if (!options.target) throw new XOOSRuntimeError(\"MOUNT_TARGET_INVALID\", \"A mount target is required.\");\r\n\r\n const feedEntry = this.feed!.microapps.find((item) => item.microappKey === microappKey);\r\n if (!feedEntry) {\r\n throw new XOOSRuntimeError(\"MICROAPP_NOT_ENTITLED\", `Microapp '${microappKey}' is not in this client feed.`);\r\n }\r\n if (feedEntry.deliveryType !== \"native_esm\") {\r\n throw new XOOSRuntimeError(\"DELIVERY_TYPE_UNSUPPORTED\", `Runtime V1 supports native_esm only: ${microappKey}`);\r\n }\r\n\r\n const manifest = await this.manifests.resolve(feedEntry.manifestUrl);\r\n if (manifest.microappKey !== microappKey) {\r\n throw new XOOSRuntimeError(\"MANIFEST_MISMATCH\", \"Feed and manifest Microapp keys do not match.\");\r\n }\r\n\r\n await this.modules.load(manifest.entry);\r\n if (!customElements.get(manifest.elementName)) {\r\n throw new XOOSRuntimeError(\"ELEMENT_NOT_REGISTERED\", `Custom element '${manifest.elementName}' was not registered.`);\r\n }\r\n\r\n const element = document.createElement(manifest.elementName) as XOOSRuntimeElement;\r\n element.xoos = this.createBridge();\r\n element.xoosProps = options.props;\r\n options.target.replaceChildren(element);\r\n this.mounted.set(microappKey, element);\r\n\r\n return {\r\n microappKey,\r\n element,\r\n unmount: async () => this.unmount(microappKey)\r\n };\r\n }\r\n\r\n async unmount(microappKey: string): Promise<void> {\r\n this.mounted.get(microappKey)?.remove();\r\n this.mounted.delete(microappKey);\r\n }\r\n\r\n async navigate(microappKey: string, target?: HTMLElement): Promise<void> {\r\n const destination = target ?? this.firstMountedParent();\r\n if (!destination) {\r\n throw new XOOSRuntimeError(\"NAVIGATION_TARGET_MISSING\", \"No target is available for Runtime navigation.\");\r\n }\r\n await this.mount(microappKey, { target: destination });\r\n }\r\n\r\n async requestCapability<T>(capability: string, input: unknown = {}, microappKey?: string): Promise<T> {\r\n this.ensureInitialized();\r\n const response = await this.http.post<XOOSCapabilityResponse<T>>(\r\n `/v1/capabilities/${encodeURIComponent(capability)}`,\r\n { input, microappKey }\r\n );\r\n if (!response.ok) {\r\n throw new XOOSRuntimeError(\r\n response.error?.code ?? \"CAPABILITY_FAILED\",\r\n response.error?.message ?? `Capability '${capability}' failed.`\r\n );\r\n }\r\n return response.data as T;\r\n }\r\n\r\n async destroy(): Promise<void> {\r\n for (const key of [...this.mounted.keys()]) await this.unmount(key);\r\n this.events.clear();\r\n this.context = null;\r\n this.feed = null;\r\n this.initialized = false;\r\n }\r\n\r\n private createBridge(): XOOSMicroappBridge {\r\n return {\r\n context: this.context!,\r\n navigation: { navigate: (microappKey, target) => this.navigate(microappKey, target) },\r\n events: {\r\n emit: (event, payload) => this.events.emit(event, payload),\r\n on: (event, handler) => this.events.on(event, handler)\r\n },\r\n services: {\r\n request: <T>(capability: string, input?: unknown, microappKey?: string) =>\r\n this.requestCapability<T>(capability, input, microappKey)\r\n }\r\n };\r\n }\r\n\r\n private firstMountedParent(): HTMLElement | null {\r\n const element = this.mounted.values().next().value as HTMLElement | undefined;\r\n return element?.parentElement ?? null;\r\n }\r\n\r\n private ensureInitialized(): void {\r\n if (!this.initialized || !this.context || !this.feed) {\r\n throw new XOOSRuntimeError(\"RUNTIME_NOT_INITIALIZED\", \"Call runtime.initialize() before using the Runtime.\");\r\n }\r\n }\r\n\r\n private report(error: unknown): void {\r\n if (error instanceof Error) this.options.onError?.(error);\r\n }\r\n}\r\n"],"mappings":"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","names":[]}
package/package.json ADDED
@@ -0,0 +1,37 @@
1
+ {
2
+ "name": "@xoos/runtime",
3
+ "version": "0.1.0",
4
+ "description": "XOOS Runtime SDK for loading and orchestrating XOOS Microapps",
5
+ "type": "module",
6
+ "main": "./dist/index.js",
7
+ "module": "./dist/index.js",
8
+ "types": "./dist/index.d.ts",
9
+ "exports": {
10
+ ".": {
11
+ "types": "./dist/index.d.ts",
12
+ "import": "./dist/index.js"
13
+ }
14
+ },
15
+ "files": [
16
+ "dist"
17
+ ],
18
+ "sideEffects": false,
19
+ "publishConfig": {
20
+ "access": "public"
21
+ },
22
+ "dependencies": {
23
+ "@xoos/contracts": "0.1.0"
24
+ },
25
+ "devDependencies": {
26
+ "rimraf": "^6.0.1",
27
+ "tsup": "^8.5.0",
28
+ "typescript": "^5.9.2",
29
+ "vitest": "^3.2.4"
30
+ },
31
+ "scripts": {
32
+ "build": "tsup",
33
+ "typecheck": "tsc --noEmit",
34
+ "test": "vitest run --passWithNoTests",
35
+ "clean": "rimraf dist"
36
+ }
37
+ }