@leancodepl/cyberware-contract 10.1.3

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { connectToHost, type ConnectToHostOptions, connectToRemote, type ConnectToRemoteOptions } from './lib/connect';
+export { useConnectToRemote, type UseConnectToRemoteOptions, type UseConnectToRemoteResult, } from './lib/useConnectToRemote';
+export { type ConnectToHostState, useConnectToHost, type UseConnectToHostOptions, type UseConnectToHostResult, } from './lib/useConnectToHost';
+export { createConnectToHostProvider } from './lib/ConnectToHostProvider';
+export { buildRemoteUrl, getUrlParams } from './lib/urlParams';
+export { createContract, type CreateContractOptions } from './lib/createContract';
+export { ConnectStatus } from './lib/enums';
+export type { HostProxy, RemoteProxy } from './lib/types';
+export { ContractSchema, type ContractSchemaType, type HostMethodsSchemaBase, type InferMethodsFromSchema, type InferParamsFromSchema, methodDef, type MethodDefInferred, MethodDefInferredSchema, type MethodDefOutput, type MethodParamsType, type MethodReturnType, type MethodType, mkZodContractSchema, type RemoteMethodsSchemaBase, type RemoteParamsSchemaBase, } from './lib/zod';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,eAAe,CAAA;AACtH,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAA;AACzE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,EACL,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,SAAS,EACT,KAAK,iBAAiB,EACtB,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,mBAAmB,EACnB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -0,0 +1,160 @@
+import { WindowMessenger as T, connect as b } from "penpal";
+import { jsx as E } from "react/jsx-runtime";
+import { useRef as R, useState as v, useEffect as O, createContext as I, useContext as L } from "react";
+import D from "semver";
+import { z as e } from "zod";
+function W(t, o) {
+  const { methods: n, allowedOrigins: s } = o, r = new URL(t.src).origin, i = t.contentWindow;
+  if (!i)
+    throw new Error("Iframe content window is not available");
+  const m = new T({
+    remoteWindow: i,
+    allowedOrigins: s ?? [r]
+  });
+  return b({
+    messenger: m,
+    methods: n
+  });
+}
+function x(t) {
+  const { methods: o, allowedOrigins: n } = t, s = document.referrer && document.referrer !== "" ? new URL(document.referrer).origin : globalThis.location.origin, r = new T({
+    remoteWindow: globalThis.window.parent,
+    allowedOrigins: n ?? [s]
+  });
+  return b({
+    messenger: r,
+    methods: o
+  });
+}
+var a = /* @__PURE__ */ ((t) => (t.IDLE = "idle", t.CONNECTED = "connected", t.ERROR = "error", t.INCOMPATIBLE = "incompatible", t))(a || {});
+function V(t, o) {
+  if (!o || Object.keys(o).length === 0)
+    return t;
+  const n = new URL(t, globalThis.location.origin);
+  for (const [s, r] of Object.entries(o))
+    r !== void 0 && r !== "" && n.searchParams.set(s, r);
+  return n.toString();
+}
+function j() {
+  const t = typeof globalThis.window < "u" ? globalThis.location.search : "";
+  return Object.fromEntries(new URLSearchParams(t).entries());
+}
+function M(t) {
+  const { remoteUrl: o, iframeProps: n, methods: s, allowedOrigins: r, params: i, contractVersion: m } = t, { title: c, ...l } = n, h = R(null), [f, u] = v({ status: a.IDLE }), H = {
+    ...i,
+    contractVersion: m
+  }, p = V(o, H);
+  return O(() => {
+    const w = h.current;
+    if (!w) return;
+    const g = W(w, {
+      methods: s,
+      allowedOrigins: r
+    });
+    return g.promise.then((d) => u({ status: a.CONNECTED, remote: d })).catch(
+      (d) => u({
+        status: a.ERROR,
+        error: d instanceof Error ? d : new Error(String(d))
+      })
+    ), () => {
+      u({ status: a.IDLE }), g.destroy();
+    };
+  }, [p, s, r]), {
+    iframe: /* @__PURE__ */ E("iframe", { ref: h, src: p, title: c, ...l }),
+    ...f
+  };
+}
+function P(t) {
+  const { methods: o, allowedOrigins: n, contractVersion: s, contractVersionRange: r } = t, i = R(j()), [m, c] = v({ status: a.IDLE });
+  return O(() => {
+    if (typeof globalThis.window.parent > "u" || globalThis.window.parent === globalThis.window)
+      return;
+    const l = i.current.contractVersion;
+    if (!D.satisfies(l, r)) {
+      c({ status: a.INCOMPATIBLE, hostVersion: l, remoteVersion: s });
+      return;
+    }
+    const f = x({
+      methods: o,
+      allowedOrigins: n
+    });
+    return f.promise.then((u) => c({ status: a.CONNECTED, host: u })).catch(
+      (u) => c({
+        status: a.ERROR,
+        error: u instanceof Error ? u : new Error(String(u))
+      })
+    ), () => {
+      c({ status: a.IDLE }), f.destroy();
+    };
+  }, [o, n, s, r]), m;
+}
+function N(t, o) {
+  const n = I(null);
+  function s({ children: i, methods: m, allowedOrigins: c }) {
+    const l = P({
+      methods: m,
+      allowedOrigins: c,
+      contractVersion: t,
+      contractVersionRange: o
+    });
+    return /* @__PURE__ */ E(n.Provider, { value: l, children: i });
+  }
+  function r() {
+    const i = L(n);
+    if (i === null)
+      throw new Error("useConnectToHostContext must be used within ConnectToHostProvider");
+    return i;
+  }
+  return { ConnectToHostProvider: s, useConnectToHostContext: r };
+}
+function z(t) {
+  const { contractVersion: o, contractVersionRange: n } = t, { ConnectToHostProvider: s, useConnectToHostContext: r } = N(o, n);
+  return {
+    useConnectToRemote: (c) => M({
+      ...c,
+      contractVersion: o
+    }),
+    useConnectToHost: (c) => P({
+      ...c,
+      contractVersion: o,
+      contractVersionRange: n
+    }),
+    ConnectToHostProvider: s,
+    useConnectToHostContext: r,
+    getUrlParams: j
+  };
+}
+function Z(t) {
+  return !t || t.params === void 0 && t.returns === void 0 ? e.object({}) : t.params === void 0 && t.returns !== void 0 ? e.object({ returns: t.returns }) : t.returns === void 0 && t.params !== void 0 ? e.object({ params: t.params }) : t.params !== void 0 && t.returns !== void 0 ? e.object({ params: t.params, returns: t.returns }) : e.object({});
+}
+const C = e.object({ params: e.unknown(), returns: e.unknown() }).partial(), q = e.object({
+  hostMethods: e.record(e.string(), C),
+  remoteMethods: e.record(e.string(), C),
+  remoteParams: e.record(e.string(), e.string())
+});
+function F({
+  hostMethods: t,
+  remoteMethods: o,
+  remoteParams: n
+}) {
+  return e.object({
+    hostMethods: e.object(t),
+    remoteMethods: e.object(o),
+    remoteParams: e.object(n)
+  });
+}
+export {
+  a as ConnectStatus,
+  q as ContractSchema,
+  C as MethodDefInferredSchema,
+  V as buildRemoteUrl,
+  x as connectToHost,
+  W as connectToRemote,
+  N as createConnectToHostProvider,
+  z as createContract,
+  j as getUrlParams,
+  Z as methodDef,
+  F as mkZodContractSchema,
+  P as useConnectToHost,
+  M as useConnectToRemote
+};

package/dist/index.umd.cjs

@@ -0,0 +1 @@
+(function(t,f){typeof exports=="object"&&typeof module<"u"?f(exports,require("penpal"),require("react/jsx-runtime"),require("react"),require("semver"),require("zod")):typeof define=="function"&&define.amd?define(["exports","penpal","react/jsx-runtime","react","semver","zod"],f):(t=typeof globalThis<"u"?globalThis:t||self,f(t["@leancodepl/cyberware-contract"]={},t.penpal,t.jsxRuntime,t.react,t.semver,t.zod))})(this,(function(t,f,R,d,D,n){"use strict";function E(e,o){const{methods:r,allowedOrigins:c}=o,s=new URL(e.src).origin,i=e.contentWindow;if(!i)throw new Error("Iframe content window is not available");const l=new f.WindowMessenger({remoteWindow:i,allowedOrigins:c??[s]});return f.connect({messenger:l,methods:r})}function v(e){const{methods:o,allowedOrigins:r}=e,c=document.referrer&&document.referrer!==""?new URL(document.referrer).origin:globalThis.location.origin,s=new f.WindowMessenger({remoteWindow:globalThis.window.parent,allowedOrigins:r??[c]});return f.connect({messenger:s,methods:o})}var u=(e=>(e.IDLE="idle",e.CONNECTED="connected",e.ERROR="error",e.INCOMPATIBLE="incompatible",e))(u||{});function j(e,o){if(!o||Object.keys(o).length===0)return e;const r=new URL(e,globalThis.location.origin);for(const[c,s]of Object.entries(o))s!==void 0&&s!==""&&r.searchParams.set(c,s);return r.toString()}function T(){const e=typeof globalThis.window<"u"?globalThis.location.search:"";return Object.fromEntries(new URLSearchParams(e).entries())}function O(e){const{remoteUrl:o,iframeProps:r,methods:c,allowedOrigins:s,params:i,contractVersion:l}=e,{title:a,...h}=r,b=d.useRef(null),[C,m]=d.useState({status:u.IDLE}),V={...i,contractVersion:l},H=j(o,V);return d.useEffect(()=>{const S=b.current;if(!S)return;const I=E(S,{methods:c,allowedOrigins:s});return I.promise.then(w=>m({status:u.CONNECTED,remote:w})).catch(w=>m({status:u.ERROR,error:w instanceof Error?w:new Error(String(w))})),()=>{m({status:u.IDLE}),I.destroy()}},[H,c,s]),{iframe:R.jsx("iframe",{ref:b,src:H,title:a,...h}),...C}}function g(e){const{methods:o,allowedOrigins:r,contractVersion:c,contractVersionRange:s}=e,i=d.useRef(T()),[l,a]=d.useState({status:u.IDLE});return d.useEffect(()=>{if(typeof globalThis.window.parent>"u"||globalThis.window.parent===globalThis.window)return;const h=i.current.contractVersion;if(!D.satisfies(h,s)){a({status:u.INCOMPATIBLE,hostVersion:h,remoteVersion:c});return}const C=v({methods:o,allowedOrigins:r});return C.promise.then(m=>a({status:u.CONNECTED,host:m})).catch(m=>a({status:u.ERROR,error:m instanceof Error?m:new Error(String(m))})),()=>{a({status:u.IDLE}),C.destroy()}},[o,r,c,s]),l}function P(e,o){const r=d.createContext(null);function c({children:i,methods:l,allowedOrigins:a}){const h=g({methods:l,allowedOrigins:a,contractVersion:e,contractVersionRange:o});return R.jsx(r.Provider,{value:h,children:i})}function s(){const i=d.useContext(r);if(i===null)throw new Error("useConnectToHostContext must be used within ConnectToHostProvider");return i}return{ConnectToHostProvider:c,useConnectToHostContext:s}}function y(e){const{contractVersion:o,contractVersionRange:r}=e,{ConnectToHostProvider:c,useConnectToHostContext:s}=P(o,r);return{useConnectToRemote:a=>O({...a,contractVersion:o}),useConnectToHost:a=>g({...a,contractVersion:o,contractVersionRange:r}),ConnectToHostProvider:c,useConnectToHostContext:s,getUrlParams:T}}function L(e){return!e||e.params===void 0&&e.returns===void 0?n.z.object({}):e.params===void 0&&e.returns!==void 0?n.z.object({returns:e.returns}):e.returns===void 0&&e.params!==void 0?n.z.object({params:e.params}):e.params!==void 0&&e.returns!==void 0?n.z.object({params:e.params,returns:e.returns}):n.z.object({})}const p=n.z.object({params:n.z.unknown(),returns:n.z.unknown()}).partial(),M=n.z.object({hostMethods:n.z.record(n.z.string(),p),remoteMethods:n.z.record(n.z.string(),p),remoteParams:n.z.record(n.z.string(),n.z.string())});function W({hostMethods:e,remoteMethods:o,remoteParams:r}){return n.z.object({hostMethods:n.z.object(e),remoteMethods:n.z.object(o),remoteParams:n.z.object(r)})}t.ConnectStatus=u,t.ContractSchema=M,t.MethodDefInferredSchema=p,t.buildRemoteUrl=j,t.connectToHost=v,t.connectToRemote=E,t.createConnectToHostProvider=P,t.createContract=y,t.getUrlParams=T,t.methodDef=L,t.mkZodContractSchema=W,t.useConnectToHost=g,t.useConnectToRemote=O,Object.defineProperty(t,Symbol.toStringTag,{value:"Module"})}));

package/dist/lib/ConnectToHostProvider.d.ts

@@ -0,0 +1,17 @@
+import { ReactNode } from 'react';
+import { HostMethodsBase, RemoteMethodsBase, RemoteParamsWithContractVersion } from './types';
+import { UseConnectToHostResult } from './useConnectToHost';
+/**
+ * Create a typed ConnectToHostProvider and useConnectToHostContext pair.
+ * Each contract should call this to get a provider and hook that share the same context.
+ */
+export declare function createConnectToHostProvider<THost extends HostMethodsBase, TRemote extends RemoteMethodsBase, TParamsWithContractVersion extends RemoteParamsWithContractVersion>(contractVersion: string, contractVersionRange: string): {
+    ConnectToHostProvider: <T extends Omit<import('./connect').ConnectToHostOptions<TRemote> & {
+        contractVersion: string;
+        contractVersionRange: string;
+    } & {
+        children: ReactNode;
+    }, "contractVersion" | "contractVersionRange">>({ children, methods, allowedOrigins }: T) => import("react/jsx-runtime").JSX.Element;
+    useConnectToHostContext: () => UseConnectToHostResult<THost>;
+};
+//# sourceMappingURL=ConnectToHostProvider.d.ts.map

package/dist/lib/ConnectToHostProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectToHostProvider.d.ts","sourceRoot":"","sources":["../../src/lib/ConnectToHostProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAc,MAAM,OAAO,CAAA;AACjE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,MAAM,SAAS,CAAA;AAC7F,OAAO,EAAkD,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAEhH;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,SAAS,eAAe,EAC7B,OAAO,SAAS,iBAAiB,EACjC,0BAA0B,SAAS,+BAA+B,EAClE,eAAe,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM;4BAQnD,CAAC,SAAS,IAAI;;;;kBAJJ,SAAS;OAIwB,iBAAiB,GAAG,sBAAsB,CAAC,yCAC/C,CAAC;mCAWN,sBAAsB,CAAC,KAAK,CAAC;EASlE"}

package/dist/lib/connect.d.ts

@@ -0,0 +1,46 @@
+import { HostMethodsBase, RemoteMethodsBase } from './types';
+export type ConnectToRemoteOptions<THost extends HostMethodsBase> = {
+    /** Methods the host exposes to the remote */
+    methods: THost;
+    /** Allowed origins for the remote iframe (defaults to iframe src origin) */
+    allowedOrigins?: string[];
+};
+export type ConnectToHostOptions<TRemote extends RemoteMethodsBase> = {
+    /** Methods the remote exposes to the host */
+    methods: TRemote;
+    /** Allowed origins for the parent window (defaults to document.referrer origin) */
+    allowedOrigins?: string[];
+};
+/**
+ * Connect host (parent) to remote (child iframe).
+ * Call this from the host app with the iframe element.
+ *
+ * @example
+ * const connection = connectToRemote<RemoteMethods, HostMethods>(iframeRef.current, {
+ *   methods: {
+ *     navigateTo: (path) => { router.navigate(path) },
+ *     showNotification: (msg, type) => { messageApi[type](msg) },
+ *     getCurrentUserId: () => Promise.resolve(userId),
+ *   },
+ * })
+ * const remote = await connection.promise
+ * await remote.navigateTo("/settings")
+ */
+export declare function connectToRemote<TRemote extends RemoteMethodsBase, THost extends HostMethodsBase>(iframe: HTMLIFrameElement, options: ConnectToRemoteOptions<THost>): import('penpal').Connection<TRemote>;
+/**
+ * Connect remote (child iframe) to host (parent window).
+ * Call this from the remote app.
+ *
+ * @example
+ * const connection = connectToHost<HostMethods, RemoteMethods>({
+ *   methods: {
+ *     navigateTo: (path) => { navigate(path) },
+ *     getCurrentPath: () => Promise.resolve(location.pathname),
+ *     refresh: () => refetch(),
+ *   },
+ * })
+ * const host = await connection.promise
+ * await host.showNotification("Settings saved", "success")
+ */
+export declare function connectToHost<THost extends HostMethodsBase, TRemote extends RemoteMethodsBase>(options: ConnectToHostOptions<TRemote>): import('penpal').Connection<THost>;
+//# sourceMappingURL=connect.d.ts.map

package/dist/lib/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/lib/connect.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAE5D,MAAM,MAAM,sBAAsB,CAAC,KAAK,SAAS,eAAe,IAAI;IAClE,6CAA6C;IAC7C,OAAO,EAAE,KAAK,CAAA;IACd,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,oBAAoB,CAAC,OAAO,SAAS,iBAAiB,IAAI;IACpE,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAA;IAChB,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,OAAO,SAAS,iBAAiB,EAAE,KAAK,SAAS,eAAe,EAC9F,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,sBAAsB,CAAC,KAAK,CAAC,wCAmBvC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,KAAK,SAAS,eAAe,EAAE,OAAO,SAAS,iBAAiB,EAC5F,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC,sCAevC"}

package/dist/lib/createContract.d.ts

@@ -0,0 +1,43 @@
+import { HostMethodsBase, RemoteMethodsBase, RemoteParamsBase, RemoteParamsWithContractVersion } from './types';
+import { getUrlParams } from './urlParams';
+import { UseConnectToHostOptions } from './useConnectToHost';
+import { UseConnectToRemoteOptions } from './useConnectToRemote';
+export type CreateContractOptions = {
+    /** Semver version of the contract */
+    contractVersion: `${number}.${number}.${number}`;
+    /** Semver range the host contract version must satisfy (e.g. ">=1.0.0", "^2.0.0", "~2.1.0") */
+    contractVersionRange: string;
+};
+/**
+ * Create a type-safe contract shared between host and remote.
+ * Use the same contract type on both sides to ensure method signatures match.
+ *
+ * @example
+ * // Define contract in a shared package or file
+ * type HostMethods = { navigateTo: (path: string) => Promise<void>; ... }
+ * type RemoteMethods = { getCurrentPath: () => Promise<string>; ... }
+ * type RemoteParams = { userId?: string; tenantId?: string }
+ *
+ * export const contract = createContract<
+ *   HostMethods,
+ *   RemoteMethods,
+ *   RemoteParams
+ * >({ contractVersion: '1.0.0', contractVersionRange: '>=1.0.0 <2.0.0' })
+ *
+ * // Host: contract.useConnectToRemote({ remoteUrl, params: { userId: '123' }, methods })
+ * // Remote: contract.useConnectToHost({ methods })
+ * // Remote: contract.getUrlParams() // { userId?: string; tenantId?: string }
+ */
+export declare function createContract<THost extends HostMethodsBase, TRemote extends RemoteMethodsBase, TParams extends RemoteParamsBase>(options: CreateContractOptions): {
+    useConnectToRemote: (options: Omit<UseConnectToRemoteOptions<THost, TParams>, "contractVersion">) => import('./useConnectToRemote').UseConnectToRemoteResult<TRemote>;
+    useConnectToHost: (options: Omit<UseConnectToHostOptions<TRemote>, "contractVersion" | "contractVersionRange">) => import('./useConnectToHost').UseConnectToHostResult<THost>;
+    ConnectToHostProvider: <T extends Omit<import('./connect').ConnectToHostOptions<TRemote> & {
+        contractVersion: string;
+        contractVersionRange: string;
+    } & {
+        children: import('react').ReactNode;
+    }, "contractVersion" | "contractVersionRange">>({ children, methods, allowedOrigins }: T) => import("react/jsx-runtime").JSX.Element;
+    useConnectToHostContext: () => import('./useConnectToHost').UseConnectToHostResult<THost>;
+    getUrlParams: typeof getUrlParams<RemoteParamsWithContractVersion<TParams>>;
+};
+//# sourceMappingURL=createContract.d.ts.map

package/dist/lib/createContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createContract.d.ts","sourceRoot":"","sources":["../../src/lib/createContract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,+BAA+B,EAAE,MAAM,SAAS,CAAA;AAC/G,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAoB,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAC9E,OAAO,EAAsB,yBAAyB,EAAE,MAAM,sBAAsB,CAAA;AAEpF,MAAM,MAAM,qBAAqB,GAAG;IAClC,qCAAqC;IACrC,eAAe,EAAE,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAA;IAChD,+FAA+F;IAC/F,oBAAoB,EAAE,MAAM,CAAA;CAC7B,CAAA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,SAAS,eAAe,EAC7B,OAAO,SAAS,iBAAiB,EACjC,OAAO,SAAS,gBAAgB,EAChC,OAAO,EAAE,qBAAqB;kCAWc,IAAI,CAAC,yBAAyB,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,iBAAiB,CAAC;gCAOnG,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,sBAAsB,CAAC;;;;;;;;kBAa7D,OAAO,YAAY,0CAA4B;EAEhF"}

package/dist/lib/enums.d.ts

@@ -0,0 +1,7 @@
+export declare enum ConnectStatus {
+    IDLE = "idle",
+    CONNECTED = "connected",
+    ERROR = "error",
+    INCOMPATIBLE = "incompatible"
+}
+//# sourceMappingURL=enums.d.ts.map

package/dist/lib/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/lib/enums.ts"],"names":[],"mappings":"AAAA,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,YAAY,iBAAiB;CAC9B"}

package/dist/lib/types.d.ts

@@ -0,0 +1,10 @@
+import { Methods, RemoteProxy as PenpalRemoteProxy } from 'penpal';
+export type HostMethodsBase = Methods;
+export type RemoteMethodsBase = Methods;
+export type RemoteParamsBase = Record<string, string>;
+export type RemoteParamsWithContractVersion<TParams extends RemoteParamsBase = RemoteParamsBase> = TParams & {
+    contractVersion: string;
+};
+export type HostProxy<THost extends HostMethodsBase> = PenpalRemoteProxy<THost>;
+export type RemoteProxy<TRemote extends RemoteMethodsBase> = PenpalRemoteProxy<TRemote>;
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,IAAI,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAElE,MAAM,MAAM,eAAe,GAAG,OAAO,CAAA;AACrC,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAA;AACvC,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AACrD,MAAM,MAAM,+BAA+B,CAAC,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,IAAI,OAAO,GAAG;IAC3G,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,SAAS,CAAC,KAAK,SAAS,eAAe,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAA;AAC/E,MAAM,MAAM,WAAW,CAAC,OAAO,SAAS,iBAAiB,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAA"}

package/dist/lib/urlParams.d.ts

@@ -0,0 +1,12 @@
+import { RemoteParamsWithContractVersion } from './types';
+/**
+ * Build remote URL with query parameters.
+ * Merges params into the URL, preserving existing search params.
+ */
+export declare function buildRemoteUrl(baseUrl: string, params?: RemoteParamsWithContractVersion): string;
+/**
+ * Read URL search params as a typed object. No validation is performed.
+ * Call from the remote (iframe) to read params passed by the host.
+ */
+export declare function getUrlParams<TParamsWithContractVersion extends RemoteParamsWithContractVersion>(): TParamsWithContractVersion;
+//# sourceMappingURL=urlParams.d.ts.map

package/dist/lib/urlParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlParams.d.ts","sourceRoot":"","sources":["../../src/lib/urlParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,SAAS,CAAA;AAEzD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,+BAA+B,GAAG,MAAM,CAYhG;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,0BAA0B,SAAS,+BAA+B,KAC/D,0BAA0B,CAG9B"}

package/dist/lib/useConnectToHost.d.ts

@@ -0,0 +1,29 @@
+import { ConnectToHostOptions } from './connect';
+import { ConnectStatus } from './enums';
+import { HostMethodsBase, HostProxy, RemoteMethodsBase, RemoteParamsWithContractVersion } from './types';
+export type UseConnectToHostOptions<TRemote extends RemoteMethodsBase> = ConnectToHostOptions<TRemote> & {
+    /** Remote's semver contract version */
+    contractVersion: string;
+    /** Semver range the host contract version must satisfy (e.g. ">=1.0.0", "^2.0.0", "~2.1.0") */
+    contractVersionRange: string;
+};
+export type ConnectToHostState<THost extends HostMethodsBase> = {
+    status: ConnectStatus.CONNECTED;
+    host: HostProxy<THost>;
+} | {
+    status: ConnectStatus.ERROR;
+    error: Error;
+} | {
+    status: ConnectStatus.IDLE;
+} | {
+    status: ConnectStatus.INCOMPATIBLE;
+    hostVersion: string;
+    remoteVersion: string;
+};
+export type UseConnectToHostResult<THost extends HostMethodsBase> = ConnectToHostState<THost>;
+/**
+ * Connect remote (child iframe) to host (parent window).
+ * Call this from the remote app. Does nothing when not embedded in an iframe.
+ */
+export declare function useConnectToHost<THost extends HostMethodsBase, TRemote extends RemoteMethodsBase, TParamsWithContractVersion extends RemoteParamsWithContractVersion>(options: UseConnectToHostOptions<TRemote>): UseConnectToHostResult<THost>;
+//# sourceMappingURL=useConnectToHost.d.ts.map

package/dist/lib/useConnectToHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConnectToHost.d.ts","sourceRoot":"","sources":["../../src/lib/useConnectToHost.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,MAAM,SAAS,CAAA;AAGxG,MAAM,MAAM,uBAAuB,CAAC,OAAO,SAAS,iBAAiB,IAAI,oBAAoB,CAAC,OAAO,CAAC,GAAG;IACvG,uCAAuC;IACvC,eAAe,EAAE,MAAM,CAAA;IACvB,+FAA+F;IAC/F,oBAAoB,EAAE,MAAM,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,eAAe,IACxD;IAAE,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,CAAA;CAAE,GAC3D;IAAE,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAC7C;IAAE,MAAM,EAAE,aAAa,CAAC,IAAI,CAAA;CAAE,GAC9B;IAAE,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtF,MAAM,MAAM,sBAAsB,CAAC,KAAK,SAAS,eAAe,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAA;AAE7F;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,SAAS,eAAe,EAC7B,OAAO,SAAS,iBAAiB,EACjC,0BAA0B,SAAS,+BAA+B,EAClE,OAAO,EAAE,uBAAuB,CAAC,OAAO,CAAC,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAyC1E"}

package/dist/lib/useConnectToRemote.d.ts

@@ -0,0 +1,47 @@
+import { HTMLAttributes, ReactNode } from 'react';
+import { ConnectToRemoteOptions } from './connect';
+import { ConnectStatus } from './enums';
+import { HostMethodsBase, RemoteMethodsBase, RemoteParamsBase, RemoteProxy } from './types';
+export type ConnectToRemoteState<TRemote extends RemoteMethodsBase> = {
+    status: ConnectStatus.CONNECTED;
+    remote: RemoteProxy<TRemote>;
+} | {
+    status: ConnectStatus.ERROR;
+    error: Error;
+} | {
+    status: ConnectStatus.IDLE;
+};
+export type UseConnectToRemoteOptions<THost extends HostMethodsBase, TParams extends RemoteParamsBase> = ConnectToRemoteOptions<THost> & {
+    /** URL for the remote iframe src (base URL without params) */
+    remoteUrl: string;
+    /** Params to pass to the remote via URL query string */
+    params?: TParams;
+    /** Host's semver contract version */
+    contractVersion: string;
+    /** Props for the iframe element */
+    iframeProps: Omit<HTMLAttributes<HTMLIFrameElement>, "src" | "title"> & {
+        title: string;
+    };
+};
+export type UseConnectToRemoteResult<TRemote extends RemoteMethodsBase> = ConnectToRemoteState<TRemote> & {
+    /** The iframe element to render */
+    iframe: ReactNode;
+};
+/**
+ * Connects host (parent) to remote (child iframe) and renders the iframe.
+ * Call from the host app.
+ *
+ * @param options - Connection options including remote URL, host methods, and params
+ * @returns Object with `iframe` element, `remote` proxy, `isConnected` flag, and `error`
+ * @example
+ * ```tsx
+ * const { iframe, remote, isConnected } = useConnectToRemote({
+ *   remoteUrl: "https://remote.example.com",
+ *   methods: { navigateTo: (path) => router.navigate(path), ... },
+ *   params: { userId: "123", theme: "dark" },
+ * })
+ * return <div>{iframe}</div>
+ * ```
+ */
+export declare function useConnectToRemote<TRemote extends RemoteMethodsBase, THost extends HostMethodsBase, TParams extends RemoteParamsBase>(options: UseConnectToRemoteOptions<THost, TParams>): UseConnectToRemoteResult<TRemote>;
+//# sourceMappingURL=useConnectToRemote.d.ts.map

package/dist/lib/useConnectToRemote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConnectToRemote.d.ts","sourceRoot":"","sources":["../../src/lib/useConnectToRemote.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAEhB,WAAW,EACZ,MAAM,SAAS,CAAA;AAGhB,MAAM,MAAM,oBAAoB,CAAC,OAAO,SAAS,iBAAiB,IAC9D;IAAE,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;CAAE,GACjE;IAAE,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAC7C;IAAE,MAAM,EAAE,aAAa,CAAC,IAAI,CAAA;CAAE,CAAA;AAElC,MAAM,MAAM,yBAAyB,CACnC,KAAK,SAAS,eAAe,EAC7B,OAAO,SAAS,gBAAgB,IAC9B,sBAAsB,CAAC,KAAK,CAAC,GAAG;IAClC,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAA;IACjB,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAA;IACvB,mCAAmC;IACnC,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1F,CAAA;AAED,MAAM,MAAM,wBAAwB,CAAC,OAAO,SAAS,iBAAiB,IAAI,oBAAoB,CAAC,OAAO,CAAC,GAAG;IACxG,mCAAmC;IACnC,MAAM,EAAE,SAAS,CAAA;CAClB,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,SAAS,iBAAiB,EACjC,KAAK,SAAS,eAAe,EAC7B,OAAO,SAAS,gBAAgB,EAChC,OAAO,EAAE,yBAAyB,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,wBAAwB,CAAC,OAAO,CAAC,CA4CvF"}

package/dist/lib/zod.d.ts

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+export declare function methodDef(): z.ZodObject<Record<string, never>>;
+export declare function methodDef<R extends z.ZodTypeAny>(def: {
+    returns: R;
+}): z.ZodObject<{
+    returns: R;
+}>;
+export declare function methodDef<P extends z.ZodRawShape>(def: {
+    params: z.ZodObject<P>;
+}): z.ZodObject<{
+    params: z.ZodObject<P>;
+}>;
+export declare function methodDef<P extends z.ZodRawShape, R extends z.ZodTypeAny>(def: {
+    params: z.ZodObject<P>;
+    returns: R;
+}): z.ZodObject<{
+    params: z.ZodObject<P>;
+    returns: R;
+}>;
+export declare const MethodDefInferredSchema: z.ZodObject<{
+    params: z.ZodOptional<z.ZodUnknown>;
+    returns: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export type MethodDefInferred = z.infer<typeof MethodDefInferredSchema>;
+export type MethodDefOutput<S extends z.ZodTypeAny> = z.infer<S>;
+export type MethodParamsType<S extends z.ZodTypeAny> = MethodDefOutput<S> extends {
+    params: infer P;
+} ? P : never;
+export type MethodReturnType<S extends z.ZodTypeAny> = MethodDefOutput<S> extends {
+    returns: infer R;
+} ? Promise<R> : Promise<void>;
+export type MethodType<S extends z.ZodTypeAny> = MethodParamsType<S> extends never ? () => MethodReturnType<S> : (params: MethodParamsType<S>) => MethodReturnType<S>;
+export type InferMethodsFromSchema<T extends Record<string, z.ZodTypeAny>> = {
+    [K in keyof T]: MethodType<T[K]>;
+};
+export type InferParamsFromSchema<T extends Record<string, z.ZodType<string>>> = {
+    [K in keyof T]: z.infer<T[K]>;
+};
+export type HostMethodsSchemaBase = Record<string, z.ZodType<MethodDefInferred>>;
+export type RemoteMethodsSchemaBase = Record<string, z.ZodType<MethodDefInferred>>;
+export type RemoteParamsSchemaBase = Record<string, z.ZodType<string>>;
+export declare const ContractSchema: z.ZodObject<{
+    hostMethods: z.ZodRecord<z.ZodString, z.ZodObject<{
+        params: z.ZodOptional<z.ZodUnknown>;
+        returns: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>>;
+    remoteMethods: z.ZodRecord<z.ZodString, z.ZodObject<{
+        params: z.ZodOptional<z.ZodUnknown>;
+        returns: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>>;
+    remoteParams: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
+export type ContractSchemaType = z.infer<typeof ContractSchema>;
+export declare function mkZodContractSchema({ hostMethods, remoteMethods, remoteParams, }: {
+    hostMethods: HostMethodsSchemaBase;
+    remoteMethods: RemoteMethodsSchemaBase;
+    remoteParams: RemoteParamsSchemaBase;
+}): z.ZodObject<{
+    hostMethods: z.ZodObject<{
+        [x: string]: z.ZodType<{
+            params?: unknown;
+            returns?: unknown;
+        }, unknown, z.core.$ZodTypeInternals<{
+            params?: unknown;
+            returns?: unknown;
+        }, unknown>>;
+    }, z.core.$strip>;
+    remoteMethods: z.ZodObject<{
+        [x: string]: z.ZodType<{
+            params?: unknown;
+            returns?: unknown;
+        }, unknown, z.core.$ZodTypeInternals<{
+            params?: unknown;
+            returns?: unknown;
+        }, unknown>>;
+    }, z.core.$strip>;
+    remoteParams: z.ZodObject<{
+        [x: string]: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+//# sourceMappingURL=zod.d.ts.map

package/dist/lib/zod.d.ts.map

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

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@leancodepl/cyberware-contract",
+  "version": "10.1.3",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "penpal": "^7.0.0",
+    "semver": "^7.0.0",
+    "zod": "^4.0.5"
+  },
+  "peerDependencies": {
+    "@testing-library/react": "*",
+    "react": "*",
+    "react-dom": "*",
+    "vitest": "*"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/leancodepl/js_corelibrary.git",
+    "directory": "packages/cyberware/cyberware-contract"
+  },
+  "homepage": "https://github.com/leancodepl/js_corelibrary",
+  "bugs": {
+    "url": "https://github.com/leancodepl/js_corelibrary/issues"
+  },
+  "description": "Creates type-safe contracts between a host app and a remote iframe app (e.g., Replit embed). Uses `postMessage` via Penpal for secure cross-origin communication.",
+  "keywords": [
+    "iframe",
+    "contract",
+    "embed",
+    "penpal",
+    "typescript",
+    "javascript",
+    "leancode",
+    "react"
+  ],
+  "author": {
+    "name": "LeanCode",
+    "url": "https://leancode.co"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "!**/*.tsbuildinfo"
+  ]
+}