@fntio/infra-client 0.0.0-stage → 0.5.0

package/node_modules/@fntio/infra-client-plugin-sdk/dist/host/host.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPluginHost = createPluginHost;
+const messages_1 = require("../contracts/messages");
+/** Exactly the documented keys, whatever else the host keeps on its state object. */
+const initPayloadOf = (s) => ({
+    session: (0, messages_1.pluginSessionOf)(s.session), user: s.user, plugin: s.plugin, entry: s.entry, accounts: s.accounts, theme: s.theme,
+});
+function createPluginHost(options) {
+    let state = "waiting";
+    let current = null;
+    let refreshing = null;
+    /** The frame the in-flight renewal belongs to, and the latest request awaiting its one answer. */
+    let refreshFor = null;
+    let replyTo;
+    let replyPending = false;
+    const timeoutMs = options.handshakeTimeoutMs ?? messages_1.PLUGIN_HANDSHAKE_TIMEOUT_MS;
+    const handshakeTimer = timeoutMs > 0
+        ? setTimeout(() => {
+            if (state === "waiting")
+                options.onHandshakeTimeout?.();
+        }, timeoutMs)
+        : undefined;
+    const post = (type, payload, requestId) => {
+        const target = options.frame.contentWindow;
+        if (state !== "connected" || !current || !target)
+            return;
+        target.postMessage((0, messages_1.createPluginMessage)(type, current, payload, requestId), options.origin);
+    };
+    const end = (reason) => {
+        if (state === "ended")
+            return;
+        post("sessionEnded", { reason });
+        state = "ended";
+        replyPending = false;
+        clearTimeout(handshakeTimer);
+        options.listenOn.removeEventListener("message", listener);
+        options.onEnded?.(reason);
+    };
+    const onReady = (message) => {
+        const duplicate = current === message.instanceId;
+        const reconnect = current !== null && !duplicate;
+        if (reconnect)
+            replyPending = false; // the new frame never asked for the old one's renewal
+        current = message.instanceId;
+        state = "connected";
+        clearTimeout(handshakeTimer);
+        post("init", initPayloadOf(options.initialState()));
+        if (!duplicate)
+            options.onReady?.({ instanceId: current, sdkVersion: message.payload.sdkVersion, reconnect });
+    };
+    /** One renewal at a time, one answer per renewal: a frame that asks repeatedly while it runs
+     *  gets a single `sessionChanged`, and a frame replaced mid-flight gets nothing (its answer must
+     *  not end the session of the frame that took its place). */
+    const refresh = (instanceId, requestId) => {
+        replyPending = true;
+        replyTo = requestId;
+        if (refreshing)
+            return;
+        refreshFor = instanceId;
+        refreshing = Promise.resolve()
+            .then(() => options.refreshSession())
+            .catch(() => null);
+        void refreshing.then((session) => {
+            refreshing = null;
+            const startedFor = refreshFor;
+            const answered = replyPending;
+            const id = replyTo;
+            refreshFor = null;
+            replyPending = false;
+            replyTo = undefined;
+            if (state === "ended" || !answered || startedFor !== current)
+                return;
+            if (!session) {
+                end("expired");
+                return;
+            }
+            post("sessionChanged", (0, messages_1.pluginSessionOf)(session), id);
+        });
+    };
+    const listener = (event) => {
+        if (state === "ended")
+            return;
+        if (event.source !== options.frame.contentWindow || event.origin !== options.origin)
+            return;
+        const seen = (0, messages_1.inspectPluginMessage)(event.data);
+        if (seen.kind === "incompatible") {
+            options.onIncompatible?.({ version: seen.version });
+            return;
+        }
+        if (seen.kind !== "message" || !(0, messages_1.isPluginToHostMessage)(seen.message))
+            return;
+        const message = seen.message;
+        if (message.type === "ready") {
+            onReady(message);
+            return;
+        }
+        if (message.instanceId !== current)
+            return; // a frame that was replaced or reloaded
+        switch (message.type) {
+            case "requestSessionRefresh":
+                refresh(message.instanceId, message.requestId);
+                return;
+            case "requestAccessRefresh":
+                options.onRequestAccessRefresh?.(message.payload.reason);
+                return;
+            default:
+                return;
+        }
+    };
+    options.listenOn.addEventListener("message", listener);
+    return {
+        state: () => state,
+        instanceId: () => current,
+        sendSession: (session) => post("sessionChanged", (0, messages_1.pluginSessionOf)(session)),
+        sendAccess: (payload) => post("accessChanged", payload),
+        sendTheme: (theme) => post("themeChanged", theme),
+        end,
+        dispose: () => end("unloaded"),
+    };
+}

package/node_modules/@fntio/infra-client-plugin-sdk/dist/host/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./host";
+export * from "../contracts/messages";
+export * from "../contracts/theme";
+export * from "../contracts/transport";
+export type { PluginPermission } from "../contracts/manifest";

package/node_modules/@fntio/infra-client-plugin-sdk/dist/host/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Entry point for the portal shell and the local development host: the host side of the iframe
+// protocol. Browser code; must stay free of Node, CDK, AWS and Angular imports.
+__exportStar(require("./host"), exports);
+__exportStar(require("../contracts/messages"), exports);
+__exportStar(require("../contracts/theme"), exports);
+__exportStar(require("../contracts/transport"), exports);

package/node_modules/@fntio/infra-client-plugin-sdk/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./contracts/manifest";
+export * from "./contracts/validate";
+export * from "./contracts/canonical";
+export * from "./contracts/paths";
+export * from "./contracts/access";
+export * from "./contracts/catalog";
+export * from "./contracts/discovery";
+export * from "./contracts/theme";
+export * from "./contracts/messages";
+export * from "./contracts/authorizer";

package/node_modules/@fntio/infra-client-plugin-sdk/dist/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// The shared contract: what deployment (CDK), the core backend, the authorizer, the portal
+// shell and plugin frames all agree on. Browser-safe: no Node, CDK or AWS imports here.
+__exportStar(require("./contracts/manifest"), exports);
+__exportStar(require("./contracts/validate"), exports);
+__exportStar(require("./contracts/canonical"), exports);
+__exportStar(require("./contracts/paths"), exports);
+__exportStar(require("./contracts/access"), exports);
+__exportStar(require("./contracts/catalog"), exports);
+__exportStar(require("./contracts/discovery"), exports);
+__exportStar(require("./contracts/theme"), exports);
+__exportStar(require("./contracts/messages"), exports);
+__exportStar(require("./contracts/authorizer"), exports);

package/node_modules/@fntio/infra-client-plugin-sdk/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@fntio/infra-client-plugin-sdk",
+  "version": "0.2.0",
+  "description": "Contracts and runtime for infra-client customer plugins: manifest, catalog, discovery, the iframe SDK and host adapter, authorizer context, validators and test fixtures.",
+  "license": "Elastic-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/FNTIO/aws-infrastructure-client.git",
+    "directory": "packages/infra-client-plugin-sdk"
+  },
+  "homepage": "https://github.com/FNTIO/aws-infrastructure-client/wiki",
+  "bugs": {
+    "url": "https://github.com/FNTIO/aws-infrastructure-client/issues"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser/index.d.ts",
+      "default": "./dist/browser/index.js"
+    },
+    "./host": {
+      "types": "./dist/host/index.d.ts",
+      "default": "./dist/host/index.js"
+    },
+    "./backend": {
+      "types": "./dist/backend/index.d.ts",
+      "default": "./dist/backend/index.js"
+    },
+    "./fixtures": {
+      "types": "./dist/fixtures/index.d.ts",
+      "default": "./dist/fixtures/index.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "browser": [
+        "dist/browser/index.d.ts"
+      ],
+      "host": [
+        "dist/host/index.d.ts"
+      ],
+      "backend": [
+        "dist/backend/index.d.ts"
+      ],
+      "fixtures": [
+        "dist/fixtures/index.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist",
+    "skills",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepack": "npm run build",
+    "test": "jest"
+  },
+  "jest": {
+    "testEnvironment": "node",
+    "roots": [
+      "<rootDir>/src"
+    ],
+    "testMatch": [
+      "**/*.test.ts"
+    ],
+    "transform": {
+      "^.+\\.tsx?$": [
+        "ts-jest",
+        {
+          "tsconfig": "<rootDir>/tsconfig.jest.json"
+        }
+      ]
+    },
+    "maxWorkers": "50%",
+    "workerIdleMemoryLimit": "2GB"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.19.43",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.0",
+    "typescript": "^5.5.0"
+  }
+}