@fias/arche-sdk 1.0.0

package/dist/index.mjs

@@ -0,0 +1,323 @@
+// src/provider.tsx
+import { useEffect, useMemo, useState } from "react";
+
+// src/context.ts
+import { createContext } from "react";
+var FiasBridgeContext = createContext(null);
+
+// src/bridge.ts
+var messageCounter = 0;
+function generateMessageId() {
+  return `msg_${Date.now()}_${++messageCounter}`;
+}
+var DEFAULT_TIMEOUT_MS = 3e4;
+var FiasBridge = class {
+  constructor() {
+    this.pendingRequests = /* @__PURE__ */ new Map();
+    this.initialized = false;
+    this.initPromise = null;
+    this.initResolve = null;
+    this.archId = "";
+    this.permissions = [];
+    this.theme = null;
+    this.currentPath = "";
+    this.themeListeners = /* @__PURE__ */ new Set();
+    this.navigationListeners = /* @__PURE__ */ new Set();
+    this.handleMessage = (event) => {
+      const data = event.data;
+      if (!data || typeof data !== "object" || !data.type) return;
+      if (data.type === "init") {
+        const initMsg = data;
+        this.archId = initMsg.payload.archId;
+        this.permissions = initMsg.payload.permissions;
+        this.theme = initMsg.payload.theme;
+        this.currentPath = initMsg.payload.currentPath;
+        this.initialized = true;
+        this.initResolve?.();
+        return;
+      }
+      if (data.type === "theme_update") {
+        this.theme = data.payload;
+        for (const listener of this.themeListeners) {
+          listener(this.theme);
+        }
+        return;
+      }
+      if (data.type === "navigate_update") {
+        this.currentPath = data.payload;
+        for (const listener of this.navigationListeners) {
+          listener(this.currentPath);
+        }
+        return;
+      }
+      if (data.type === "response") {
+        const response = data;
+        const pending = this.pendingRequests.get(response.messageId);
+        if (!pending) return;
+        clearTimeout(pending.timer);
+        this.pendingRequests.delete(response.messageId);
+        if (response.error) {
+          pending.reject(new Error(response.error));
+        } else {
+          pending.resolve(response.payload);
+        }
+      }
+    };
+    this.initPromise = new Promise((resolve) => {
+      this.initResolve = resolve;
+    });
+    if (typeof window !== "undefined") {
+      window.addEventListener("message", this.handleMessage);
+    }
+  }
+  /**
+   * Wait for the host to send the init message.
+   */
+  async waitForInit() {
+    if (this.initialized) return;
+    return this.initPromise;
+  }
+  /**
+   * Signal to the host that the plugin is loaded and ready.
+   */
+  ready() {
+    this.send("ready", {});
+  }
+  /**
+   * Request the host to resize the plugin iframe.
+   */
+  resize(height) {
+    this.send("resize", { height });
+  }
+  /**
+   * Show a platform toast notification.
+   */
+  showToast(message, variant = "info") {
+    this.send("toast", { message, variant });
+  }
+  /**
+   * Send a request to the host and wait for a response.
+   */
+  async request(type, payload) {
+    await this.waitForInit();
+    return new Promise((resolve, reject) => {
+      const messageId = generateMessageId();
+      const timer = setTimeout(() => {
+        this.pendingRequests.delete(messageId);
+        reject(new Error(`Bridge request timed out: ${type}`));
+      }, DEFAULT_TIMEOUT_MS);
+      this.pendingRequests.set(messageId, {
+        resolve,
+        reject,
+        timer
+      });
+      this.send(type, payload, messageId);
+    });
+  }
+  getArchId() {
+    return this.archId;
+  }
+  getPermissions() {
+    return [...this.permissions];
+  }
+  getTheme() {
+    return this.theme;
+  }
+  getCurrentPath() {
+    return this.currentPath;
+  }
+  onThemeUpdate(listener) {
+    this.themeListeners.add(listener);
+    return () => this.themeListeners.delete(listener);
+  }
+  onNavigationUpdate(listener) {
+    this.navigationListeners.add(listener);
+    return () => this.navigationListeners.delete(listener);
+  }
+  /**
+   * Clean up event listeners. Called when FiasProvider unmounts.
+   */
+  destroy() {
+    if (typeof window !== "undefined") {
+      window.removeEventListener("message", this.handleMessage);
+    }
+    for (const pending of this.pendingRequests.values()) {
+      clearTimeout(pending.timer);
+      pending.reject(new Error("Bridge destroyed"));
+    }
+    this.pendingRequests.clear();
+    this.themeListeners.clear();
+    this.navigationListeners.clear();
+  }
+  send(type, payload, messageId) {
+    if (typeof window === "undefined") return;
+    const message = {
+      type,
+      messageId: messageId ?? generateMessageId(),
+      payload
+    };
+    window.parent.postMessage(message, "*");
+  }
+};
+var bridgeInstance = null;
+function getBridge() {
+  if (!bridgeInstance) {
+    bridgeInstance = new FiasBridge();
+  }
+  return bridgeInstance;
+}
+function resetBridge() {
+  bridgeInstance?.destroy();
+  bridgeInstance = null;
+}
+
+// src/provider.tsx
+import { jsx } from "react/jsx-runtime";
+function FiasProvider({ children }) {
+  const [ready, setReady] = useState(false);
+  const bridge = useMemo(() => new FiasBridge(), []);
+  useEffect(() => {
+    let mounted = true;
+    bridge.waitForInit().then(() => {
+      if (mounted) {
+        bridge.ready();
+        setReady(true);
+      }
+    });
+    return () => {
+      mounted = false;
+      bridge.destroy();
+    };
+  }, [bridge]);
+  if (!ready) {
+    return null;
+  }
+  return /* @__PURE__ */ jsx(FiasBridgeContext.Provider, { value: bridge, children });
+}
+
+// src/hooks.ts
+import { useCallback, useContext, useEffect as useEffect2, useState as useState2 } from "react";
+function useBridge() {
+  const bridge = useContext(FiasBridgeContext);
+  if (!bridge) {
+    throw new Error("useBridge must be used within a <FiasProvider>");
+  }
+  return bridge;
+}
+function useFiasUser() {
+  const bridge = useBridge();
+  const [user, setUser] = useState2(null);
+  useEffect2(() => {
+    let mounted = true;
+    bridge.request("get_user", {}).then((data) => {
+      if (mounted) setUser(data);
+    });
+    return () => {
+      mounted = false;
+    };
+  }, [bridge]);
+  return user;
+}
+function useFiasTheme() {
+  const bridge = useBridge();
+  const [theme, setTheme] = useState2(bridge.getTheme());
+  useEffect2(() => {
+    return bridge.onThemeUpdate(setTheme);
+  }, [bridge]);
+  return theme;
+}
+function useFiasStorage() {
+  const bridge = useBridge();
+  const readFile = useCallback(
+    (path) => bridge.request("storage_read", { path }),
+    [bridge]
+  );
+  const writeFile = useCallback(
+    (path, content) => bridge.request("storage_write", { path, content }),
+    [bridge]
+  );
+  const listFiles = useCallback(
+    (prefix) => bridge.request("storage_list", { prefix }),
+    [bridge]
+  );
+  const deleteFile = useCallback(
+    (path) => bridge.request("storage_delete", { path }),
+    [bridge]
+  );
+  return { readFile, writeFile, listFiles, deleteFile };
+}
+function useEntityInvocation() {
+  const bridge = useBridge();
+  const [isLoading, setIsLoading] = useState2(false);
+  const [result, setResult] = useState2(null);
+  const [error, setError] = useState2(null);
+  const invoke = useCallback(
+    async (params) => {
+      setIsLoading(true);
+      setError(null);
+      try {
+        const res = await bridge.request("entity_invoke", params);
+        setResult(res);
+        return res;
+      } catch (err) {
+        const e = err instanceof Error ? err : new Error(String(err));
+        setError(e);
+        throw e;
+      } finally {
+        setIsLoading(false);
+      }
+    },
+    [bridge]
+  );
+  return { invoke, isLoading, result, error };
+}
+function useFiasNavigation() {
+  const bridge = useBridge();
+  const [currentPath, setCurrentPath] = useState2(bridge.getCurrentPath());
+  useEffect2(() => {
+    return bridge.onNavigationUpdate(setCurrentPath);
+  }, [bridge]);
+  const navigateTo = useCallback(
+    (path) => {
+      bridge.request("navigate", { path });
+    },
+    [bridge]
+  );
+  return { navigateTo, currentPath };
+}
+
+// src/fias.ts
+var fias = {
+  /**
+   * Signal to the host that the plugin is loaded and ready.
+   * Called automatically by FiasProvider — only use manually
+   * if not using React.
+   */
+  ready() {
+    getBridge().ready();
+  },
+  /**
+   * Request the host to resize the plugin iframe to the given height.
+   */
+  resize(height) {
+    getBridge().resize(height);
+  },
+  /**
+   * Show a platform toast notification.
+   */
+  showToast(message, variant = "info") {
+    getBridge().showToast(message, variant);
+  }
+};
+export {
+  FiasBridge,
+  FiasProvider,
+  fias,
+  getBridge,
+  resetBridge,
+  useEntityInvocation,
+  useFiasNavigation,
+  useFiasStorage,
+  useFiasTheme,
+  useFiasUser
+};

package/dist/provider.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+interface FiasProviderProps {
+    children: React.ReactNode;
+}
+/**
+ * Root wrapper component for FIAS plugins.
+ * Must wrap the entire plugin component tree.
+ * Establishes the postMessage bridge with the host platform.
+ *
+ * @example
+ * ```tsx
+ * import { FiasProvider } from '@fias/arche-sdk';
+ *
+ * export default function Plugin() {
+ *   return (
+ *     <FiasProvider>
+ *       <App />
+ *     </FiasProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function FiasProvider({ children }: FiasProviderProps): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuC,MAAM,OAAO,CAAC;AAI5D,UAAU,iBAAiB;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE,iBAAiB,kDA0B3D"}

package/dist/provider.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FiasProvider = FiasProvider;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const context_1 = require("./context");
+const bridge_1 = require("./bridge");
+/**
+ * Root wrapper component for FIAS plugins.
+ * Must wrap the entire plugin component tree.
+ * Establishes the postMessage bridge with the host platform.
+ *
+ * @example
+ * ```tsx
+ * import { FiasProvider } from '@fias/arche-sdk';
+ *
+ * export default function Plugin() {
+ *   return (
+ *     <FiasProvider>
+ *       <App />
+ *     </FiasProvider>
+ *   );
+ * }
+ * ```
+ */
+function FiasProvider({ children }) {
+    const [ready, setReady] = (0, react_1.useState)(false);
+    const bridge = (0, react_1.useMemo)(() => new bridge_1.FiasBridge(), []);
+    (0, react_1.useEffect)(() => {
+        let mounted = true;
+        bridge.waitForInit().then(() => {
+            if (mounted) {
+                bridge.ready();
+                setReady(true);
+            }
+        });
+        return () => {
+            mounted = false;
+            bridge.destroy();
+        };
+    }, [bridge]);
+    if (!ready) {
+        return null;
+    }
+    return (0, jsx_runtime_1.jsx)(context_1.FiasBridgeContext.Provider, { value: bridge, children: children });
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":";;AA0BA,oCA0BC;;AApDD,iCAA4D;AAC5D,uCAA8C;AAC9C,qCAAsC;AAMtC;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,YAAY,CAAC,EAAE,QAAQ,EAAqB;IAC1D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAC;IAE1C,MAAM,MAAM,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE,CAAC,IAAI,mBAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IAEnD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,OAAO,GAAG,IAAI,CAAC;QAEnB,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;YAC7B,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,CAAC,KAAK,EAAE,CAAC;gBACf,QAAQ,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,OAAO,GAAG,KAAK,CAAC;YAChB,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,uBAAC,2BAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,MAAM,YAAG,QAAQ,GAA8B,CAAC;AAC5F,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Permission scopes that plugins can request in their manifest.
+ */
+export type PluginPermission = 'user:profile:read' | 'entities:invoke' | 'storage:sandbox' | 'theme:read';
+/**
+ * User profile data available via useFiasUser() hook.
+ */
+export interface FiasUser {
+    userId: string;
+    displayName: string;
+    avatar: string | null;
+}
+/**
+ * Platform theme tokens available via useFiasTheme() hook.
+ */
+export interface FiasTheme {
+    colors: {
+        primary: string;
+        secondary: string;
+        background: string;
+        surface: string;
+        text: string;
+        textSecondary: string;
+        border: string;
+        error: string;
+        warning: string;
+        success: string;
+    };
+    spacing: {
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+    };
+    fonts: {
+        body: string;
+        heading: string;
+        mono: string;
+    };
+    mode: 'light' | 'dark';
+}
+/**
+ * Storage API available via useFiasStorage() hook.
+ */
+export interface FiasStorageApi {
+    readFile: (path: string) => Promise<string | null>;
+    writeFile: (path: string, content: string) => Promise<void>;
+    listFiles: (prefix?: string) => Promise<string[]>;
+    deleteFile: (path: string) => Promise<void>;
+}
+/**
+ * Entity invocation result.
+ */
+export interface EntityInvocationResult {
+    output: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Entity invocation API available via useEntityInvocation() hook.
+ */
+export interface EntityInvocationApi {
+    invoke: (params: EntityInvocationParams) => Promise<EntityInvocationResult>;
+    isLoading: boolean;
+    result: EntityInvocationResult | null;
+    error: Error | null;
+}
+export interface EntityInvocationParams {
+    entityId: string;
+    input: string;
+    parameters?: Record<string, unknown>;
+}
+/**
+ * Navigation API available via useFiasNavigation() hook.
+ */
+export interface FiasNavigationApi {
+    navigateTo: (path: string) => void;
+    currentPath: string;
+}
+/**
+ * Message types sent from the plugin iframe to the parent frame.
+ */
+export type PluginToHostMessageType = 'ready' | 'resize' | 'toast' | 'get_user' | 'get_theme' | 'storage_read' | 'storage_write' | 'storage_list' | 'storage_delete' | 'entity_invoke' | 'navigate';
+/**
+ * Message types sent from the parent frame to the plugin iframe.
+ */
+export type HostToPluginMessageType = 'init' | 'response' | 'theme_update' | 'navigate_update';
+/**
+ * Base message structure for all bridge communication.
+ */
+export interface BridgeMessage<T = unknown> {
+    type: PluginToHostMessageType | HostToPluginMessageType;
+    messageId: string;
+    payload: T;
+}
+/**
+ * Response message from the host to a plugin request.
+ */
+export interface BridgeResponse<T = unknown> {
+    type: 'response';
+    messageId: string;
+    payload: T;
+    error?: string;
+}
+/**
+ * Init message sent by the host to the plugin on load.
+ */
+export interface BridgeInitMessage {
+    type: 'init';
+    messageId: string;
+    payload: {
+        archId: string;
+        permissions: PluginPermission[];
+        theme: FiasTheme;
+        currentPath: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@fias/arche-sdk",
+  "version": "1.0.0",
+  "description": "SDK for building FIAS platform plugin arches",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "module": "dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "create-fias-plugin": "dist/cli/create-plugin.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc && esbuild src/index.ts --bundle --format=esm --outfile=dist/index.mjs --external:react --external:react-dom --jsx=automatic --target=es2020",
+    "clean": "rm -rf dist",
+    "watch": "tsc -w",
+    "typecheck": "tsc --noEmit",
+    "test": "jest",
+    "test:coverage": "jest --coverage"
+  },
+  "keywords": [
+    "fias",
+    "plugin",
+    "arche",
+    "sdk"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.0.0",
+    "@types/react": "^19.0.0",
+    "esbuild": "^0.24.0",
+    "jest": "^29.7.0",
+    "react": "^19.0.0",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.3.3"
+  }
+}

package/templates/default/fias-plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "{{name}}",
+  "version": "1.0.0",
+  "description": "A FIAS plugin arche",
+  "main": "src/index.tsx",
+  "archeType": "tool",
+  "tags": [],
+  "pricing": { "model": "free", "currency": "usd" },
+  "permissions": ["theme:read"],
+  "sdk": "^1.0.0"
+}

package/templates/default/index.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>FIAS Plugin</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/index.tsx"></script>
+  </body>
+</html>

package/templates/default/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "{{name}}",
+  "version": "1.0.0",
+  "private": true,
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "validate": "tsc --noEmit",
+    "submit": "echo 'Submission CLI not yet available'"
+  },
+  "dependencies": {
+    "@fias/arche-sdk": "^1.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.0.0",
+    "typescript": "^5.3.3",
+    "vite": "^6.0.0"
+  }
+}

package/templates/default/src/App.tsx

@@ -0,0 +1,12 @@
+import { useFiasTheme } from '@fias/arche-sdk';
+
+export function App() {
+  const theme = useFiasTheme();
+
+  return (
+    <div style={{ padding: theme?.spacing.md, fontFamily: theme?.fonts.body }}>
+      <h1>My FIAS Plugin</h1>
+      <p>Edit src/App.tsx to get started.</p>
+    </div>
+  );
+}

package/templates/default/src/index.tsx

@@ -0,0 +1,12 @@
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import { FiasProvider } from '@fias/arche-sdk';
+import { App } from './App';
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <FiasProvider>
+      <App />
+    </FiasProvider>
+  </React.StrictMode>,
+);

package/templates/default/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "jsx": "react-jsx",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true
+  },
+  "include": ["src"]
+}