@handofclient/embed-js 0.0.0-stage → 0.1.0

package/dist/protocol.js

@@ -0,0 +1,36 @@
+/**
+ * Wire types for the postMessage embed protocol - see docs/postmessage-protocol.md (task C1) for the
+ * normative spec. Shared verbatim between the host-side and plugin-side halves of this package so both
+ * sides can never drift on envelope/message shape.
+ */
+export const PROTOCOL_VERSION = 1;
+export const MessageType = {
+    Hello: "hoc:hello",
+    Init: "hoc:init",
+    Ready: "hoc:ready",
+    Error: "hoc:error",
+    Resize: "hoc:resize",
+    Navigate: "hoc:navigate",
+    TokenRefresh: "hoc:token-refresh",
+    ContextChanged: "hoc:context-changed",
+    Telemetry: "hoc:telemetry",
+    Ui: "hoc:ui",
+};
+export function isEnvelope(data) {
+    if (typeof data !== "object" || data === null)
+        return false;
+    const candidate = data;
+    return (candidate.v === PROTOCOL_VERSION &&
+        typeof candidate.type === "string" &&
+        typeof candidate.msgId === "string" &&
+        typeof candidate.payload === "object" &&
+        candidate.payload !== null);
+}
+export function makeMsgId() {
+    return crypto.randomUUID();
+}
+export function makeEnvelope(type, payload, replyTo) {
+    return replyTo === undefined
+        ? { v: PROTOCOL_VERSION, type, msgId: makeMsgId(), payload }
+        : { v: PROTOCOL_VERSION, type, msgId: makeMsgId(), replyTo, payload };
+}

package/package.json

@@ -1,6 +1,39 @@
 {
   "name": "@handofclient/embed-js",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/PanglossTechnologies/HandOfClientSDK.git",
+    "directory": "sdk/embed-js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "HandOfClient postMessage embed protocol SDK (task C1 spec at docs/postmessage-protocol.md): host-side embed.js (drop-in <script> or npm import) plus the plugin-side SDK a plugin author imports inside their own bundle.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "exports": {
+    "./host": {
+      "types": "./dist/host/index.d.ts",
+      "import": "./dist/host/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin/index.d.ts",
+      "import": "./dist/plugin/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node build.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@handofclient/api": "^0.1.0"
+  },
+  "devDependencies": {
+    "esbuild": "^0.28.2",
+    "typescript": "^5.9.3"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.