@vector-metis/browser-sdk 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+/** 平台注入浏览器能力的公开类型。 */
+export interface BrowserContext {
+    appId: string;
+    appType: "RUNTIME_APPLICATION_TYPE_WEB";
+    tenantId: string;
+    userId: string;
+    role: string;
+    actorType: "RUNTIME_ACTOR_TYPE_USER";
+}
+/** source 应用声明的 Web 依赖。 */
+export interface WebDependency {
+    appId: string;
+    alias: string;
+    required: boolean;
+    appType: "RUNTIME_APPLICATION_TYPE_WEB";
+    available: boolean;
+    webBasePath: string;
+}
+/** 平台注入脚本暴露的能力接口。 */
+export interface InjectedBrowserSDK {
+    appURL(path?: string): string;
+    getContext(): Promise<BrowserContext>;
+    listDependencies(): Promise<WebDependency[]>;
+    dependency(aliasOrAppId: string): Promise<WebDependency>;
+    dependencyURL(aliasOrAppId: string, path?: string): Promise<string>;
+    openAppPage(options: {
+        app: string;
+        path?: string;
+        query?: Record<string, string>;
+    }): Promise<void>;
+}
+declare global {
+    interface Window {
+        Metis?: InjectedBrowserSDK;
+    }
+}
+/** 返回平台已经注入的浏览器能力；脚本缺失时明确失败。 */
+export declare function injected(): InjectedBrowserSDK;
+/** 对平台注入能力做延迟解析的类型化代理。 */
+export declare const Metis: InjectedBrowserSDK;
+export type MetisBrowserContext = BrowserContext;
+export type MetisBrowserSDK = InjectedBrowserSDK;
+export type MetisWebDependency = WebDependency;

package/dist/index.js

@@ -0,0 +1,17 @@
+/** 返回平台已经注入的浏览器能力；脚本缺失时明确失败。 */
+export function injected() {
+    const sdk = globalThis.window?.Metis;
+    if (!sdk) {
+        throw new Error("Metis browser SDK is not injected; load /api/runtime/v1/browser-sdk.js first");
+    }
+    return sdk;
+}
+/** 对平台注入能力做延迟解析的类型化代理。 */
+export const Metis = Object.freeze({
+    appURL: (path) => injected().appURL(path),
+    getContext: () => injected().getContext(),
+    listDependencies: () => injected().listDependencies(),
+    dependency: (selector) => injected().dependency(selector),
+    dependencyURL: (selector, path) => injected().dependencyURL(selector, path),
+    openAppPage: (options) => injected().openAppPage(options),
+});

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@vector-metis/browser-sdk",
+  "version": "0.1.1",
+  "description": "Metis browser SDK for injected application capabilities",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vector-metis/metis-sdk-typescript.git"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "tsc -p tsconfig.json && node --test test/sdk.test.mjs",
+    "pack": "pnpm build && pnpm pack"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "typescript": "5.9.3"
+  }
+}