@dipansrimany/mlink-sdk 0.4.1 → 0.4.2

package/dist/react/index.d.ts

@@ -2,13 +2,29 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { E as EVMTransaction, C as ChainConfig, A as ActionMetadata } from '../types-DD9rJ58Y.js';
 import React from 'react';
 
-type MlinkStatus = 'idle' | 'loading' | 'ready' | 'executing' | 'success' | 'error';
+type MlinkStatus = 'idle' | 'loading' | 'validating' | 'ready' | 'executing' | 'success' | 'error' | 'unregistered' | 'blocked';
+type RegistrationStatus = 'pending' | 'approved' | 'blocked' | null;
+interface RegistrationResult {
+    isRegistered: boolean;
+    status: RegistrationStatus;
+    error?: string;
+    warning?: string;
+    mlink?: {
+        mlinkId: string;
+        name: string;
+        description: string;
+        icon: string;
+        status: RegistrationStatus;
+    };
+}
 interface MlinkInstance {
     status: MlinkStatus;
     metadata: ActionMetadata | null;
     error: string | null;
     url: string;
     refresh: () => Promise<void>;
+    registration: RegistrationResult | null;
+    isRegistered: boolean;
 }
 interface MlinkAdapter {
     connect: () => Promise<string>;
@@ -78,6 +94,14 @@ interface MlinkProps {
     onError?: (error: string) => void;
     className?: string;
     stylePreset?: 'default' | 'compact' | 'minimal';
+    /** Registry URL for validation (defaults to https://mlinks-fe.vercel.app) */
+    registryUrl?: string;
+    /** Whether to require registration for the mlink to work (defaults to true) */
+    requireRegistration?: boolean;
+    /** Whether to allow pending mlinks (defaults to true) */
+    allowPending?: boolean;
+    /** Whether to allow blocked mlinks (defaults to false) */
+    allowBlocked?: boolean;
 }
 interface ActionButtonProps {
     label: string;
@@ -97,6 +121,14 @@ interface ExecutionResult {
 interface UseMlinkOptions {
     refreshInterval?: number;
     enabled?: boolean;
+    /** Registry URL for validation (defaults to https://mlinks-fe.vercel.app) */
+    registryUrl?: string;
+    /** Whether to require registration for the mlink to work (defaults to true) */
+    requireRegistration?: boolean;
+    /** Whether to allow pending mlinks (defaults to true) */
+    allowPending?: boolean;
+    /** Whether to allow blocked mlinks (defaults to false) */
+    allowBlocked?: boolean;
 }
 interface UseExecuteMlinkReturn {
     execute: (action: string, input?: string) => Promise<ExecutionResult>;
@@ -106,7 +138,7 @@ interface UseExecuteMlinkReturn {
     reset: () => void;
 }
 
-declare function Mlink({ url, adapter, theme: themeProp, onSuccess, onError, className, stylePreset, }: MlinkProps): react_jsx_runtime.JSX.Element;
+declare function Mlink({ url, adapter, theme: themeProp, onSuccess, onError, className, stylePreset, registryUrl, requireRegistration, allowPending, allowBlocked, }: MlinkProps): react_jsx_runtime.JSX.Element;
 
 interface MlinkContextValue {
     theme: MlinkTheme;
@@ -211,4 +243,4 @@ declare const mantleTheme: MlinkTheme;
 declare const themePresets: Record<MlinkThemePreset, MlinkTheme>;
 declare function resolveTheme(theme?: Partial<MlinkTheme> | MlinkThemePreset): MlinkTheme;
 
-export { type ActionButtonProps, type EthersAdapterConfig, type ExecutionResult, Mlink, type MlinkAdapter, Mlink as MlinkComponent, type MlinkInstance, type MlinkProps, MlinkProvider, type MlinkProviderConfig, type MlinkStatus, type MlinkTheme, type MlinkThemePreset, type UseExecuteMlinkReturn, type UseExecuteMlinkReturnEnhanced, type UseMlinkOptions, type WagmiAdapterConfig, createMlinkAdapter, darkTheme, lightTheme, mantleTheme, resolveTheme, themePresets, useExecuteMlink, useMlink, useMlinkContext, useMlinkEthersAdapter, useMlinkWagmiAdapter };
+export { type ActionButtonProps, type EthersAdapterConfig, type ExecutionResult, Mlink, type MlinkAdapter, Mlink as MlinkComponent, type MlinkInstance, type MlinkProps, MlinkProvider, type MlinkProviderConfig, type MlinkStatus, type MlinkTheme, type MlinkThemePreset, type RegistrationResult, type RegistrationStatus, type UseExecuteMlinkReturn, type UseExecuteMlinkReturnEnhanced, type UseMlinkOptions, type WagmiAdapterConfig, createMlinkAdapter, darkTheme, lightTheme, mantleTheme, resolveTheme, themePresets, useExecuteMlink, useMlink, useMlinkContext, useMlinkEthersAdapter, useMlinkWagmiAdapter };

package/dist/react/index.js

@@ -18,6 +18,8 @@ var MANTLE_SEPOLIA = {
 };
 var DEFAULT_CHAIN = MANTLE_SEPOLIA;
 var ACTION_QUERY_PARAM = "action";
+var REGISTRY_URL = "https://mlinks-fe.vercel.app";
+var REGISTRY_VALIDATE_ENDPOINT = "/api/registry/validate";
 
 // src/utils.ts
 function parseBlinkUrl(blinkUrl) {
@@ -182,22 +184,73 @@ function validateActionMetadata(data) {
 // src/react/useMlink.ts
 var DEFAULT_REFRESH_INTERVAL = 10 * 60 * 1e3;
 function useMlink(url, options = {}) {
-  const { refreshInterval = DEFAULT_REFRESH_INTERVAL, enabled = true } = options;
+  const {
+    refreshInterval = DEFAULT_REFRESH_INTERVAL,
+    enabled = true,
+    registryUrl = REGISTRY_URL,
+    requireRegistration = true,
+    allowPending = true,
+    allowBlocked = false
+  } = options;
   const [status, setStatus] = react.useState("idle");
   const [metadata, setMetadata] = react.useState(null);
   const [error, setError] = react.useState(null);
+  const [registration, setRegistration] = react.useState(null);
   const abortControllerRef = react.useRef(null);
   const intervalRef = react.useRef(null);
   const actionUrl = parseBlinkUrl(url) || url;
+  const validateRegistration = react.useCallback(async () => {
+    if (!actionUrl || !requireRegistration) return null;
+    try {
+      const validateUrl = `${registryUrl}${REGISTRY_VALIDATE_ENDPOINT}?url=${encodeURIComponent(actionUrl)}`;
+      const response = await fetch(validateUrl, {
+        method: "GET",
+        headers: {
+          Accept: "application/json"
+        }
+      });
+      const data = await response.json();
+      return data;
+    } catch (err) {
+      console.error("Registry validation error:", err);
+      return {
+        isRegistered: false,
+        status: null,
+        error: "Unable to validate against registry. Please try again later."
+      };
+    }
+  }, [actionUrl, registryUrl, requireRegistration]);
   const fetchMetadata = react.useCallback(async () => {
     if (!actionUrl || !enabled) return;
     if (abortControllerRef.current) {
       abortControllerRef.current.abort();
     }
     abortControllerRef.current = new AbortController();
-    setStatus("loading");
+    setStatus("validating");
     setError(null);
     try {
+      if (requireRegistration) {
+        const registrationResult = await validateRegistration();
+        setRegistration(registrationResult);
+        if (registrationResult) {
+          if (!registrationResult.isRegistered) {
+            setError(registrationResult.error || "This MLink is not registered.");
+            setStatus("unregistered");
+            return;
+          }
+          if (registrationResult.status === "blocked" && !allowBlocked) {
+            setError("This MLink has been blocked for policy violations.");
+            setStatus("blocked");
+            return;
+          }
+          if (registrationResult.status === "pending" && !allowPending) {
+            setError("This MLink is pending review and not yet available.");
+            setStatus("error");
+            return;
+          }
+        }
+      }
+      setStatus("loading");
       const response = await fetch(actionUrl, {
         method: "GET",
         headers: {
@@ -223,7 +276,7 @@ function useMlink(url, options = {}) {
       setError(errorMessage);
       setStatus("error");
     }
-  }, [actionUrl, enabled]);
+  }, [actionUrl, enabled, requireRegistration, validateRegistration, allowBlocked, allowPending]);
   react.useEffect(() => {
     if (enabled) {
       fetchMetadata();
@@ -250,7 +303,9 @@ function useMlink(url, options = {}) {
     metadata,
     error,
     url: actionUrl,
-    refresh: fetchMetadata
+    refresh: fetchMetadata,
+    registration,
+    isRegistered: registration?.isRegistered ?? false
   };
 }
 function useExecuteMlink(options) {
@@ -477,11 +532,20 @@ function Mlink({
   onSuccess,
   onError,
   className = "",
-  stylePreset = "default"
+  stylePreset = "default",
+  registryUrl,
+  requireRegistration = true,
+  allowPending = true,
+  allowBlocked = false
 }) {
   const context = useMlinkContext();
   const resolvedTheme = themeProp ? resolveTheme(themeProp) : context.theme;
-  const { status: fetchStatus, metadata, error: fetchError } = useMlink(url);
+  const { status: fetchStatus, metadata, error: fetchError, registration } = useMlink(url, {
+    registryUrl,
+    requireRegistration,
+    allowPending,
+    allowBlocked
+  });
   const {
     execute,
     status: execStatus,
@@ -544,9 +608,21 @@ function Mlink({
   const hasLinkedActions = react.useMemo(() => {
     return metadata?.links?.actions && metadata.links.actions.length > 0;
   }, [metadata]);
-  if (fetchStatus === "loading") {
+  if (fetchStatus === "loading" || fetchStatus === "validating") {
     return /* @__PURE__ */ jsxRuntime.jsx(MlinkContainer, { theme: resolvedTheme, className, preset: stylePreset, children: /* @__PURE__ */ jsxRuntime.jsx(MlinkSkeleton, {}) });
   }
+  if (fetchStatus === "unregistered") {
+    return /* @__PURE__ */ jsxRuntime.jsx(MlinkContainer, { theme: resolvedTheme, className, preset: stylePreset, children: /* @__PURE__ */ jsxRuntime.jsx(
+      MlinkUnregistered,
+      {
+        message: fetchError || "This MLink is not registered.",
+        registryUrl
+      }
+    ) });
+  }
+  if (fetchStatus === "blocked") {
+    return /* @__PURE__ */ jsxRuntime.jsx(MlinkContainer, { theme: resolvedTheme, className, preset: stylePreset, children: /* @__PURE__ */ jsxRuntime.jsx(MlinkBlocked, { message: fetchError || "This MLink has been blocked." }) });
+  }
   if (fetchStatus === "error" || !metadata) {
     return /* @__PURE__ */ jsxRuntime.jsx(MlinkContainer, { theme: resolvedTheme, className, preset: stylePreset, children: /* @__PURE__ */ jsxRuntime.jsx(MlinkError, { message: fetchError || "Failed to load action" }) });
   }
@@ -823,6 +899,38 @@ function MlinkError({ message }) {
     /* @__PURE__ */ jsxRuntime.jsx("p", { className: "mlink-error-message", children: message })
   ] });
 }
+function MlinkUnregistered({ message, registryUrl }) {
+  const registerUrl = registryUrl ? `${registryUrl}/dashboard/register` : "https://mlinks-fe.vercel.app/dashboard/register";
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "mlink-unregistered", children: [
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "mlink-unregistered-icon", children: /* @__PURE__ */ jsxRuntime.jsxs("svg", { width: "48", height: "48", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: [
+      /* @__PURE__ */ jsxRuntime.jsx("circle", { cx: "12", cy: "12", r: "10" }),
+      /* @__PURE__ */ jsxRuntime.jsx("line", { x1: "12", y1: "8", x2: "12", y2: "12" }),
+      /* @__PURE__ */ jsxRuntime.jsx("line", { x1: "12", y1: "16", x2: "12.01", y2: "16" })
+    ] }) }),
+    /* @__PURE__ */ jsxRuntime.jsx("h3", { className: "mlink-unregistered-title", children: "Unregistered MLink" }),
+    /* @__PURE__ */ jsxRuntime.jsx("p", { className: "mlink-unregistered-message", children: message }),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      "a",
+      {
+        href: registerUrl,
+        target: "_blank",
+        rel: "noopener noreferrer",
+        className: "mlink-button",
+        children: "Register MLink"
+      }
+    )
+  ] });
+}
+function MlinkBlocked({ message }) {
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "mlink-blocked", children: [
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "mlink-blocked-icon", children: /* @__PURE__ */ jsxRuntime.jsxs("svg", { width: "48", height: "48", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", children: [
+      /* @__PURE__ */ jsxRuntime.jsx("circle", { cx: "12", cy: "12", r: "10" }),
+      /* @__PURE__ */ jsxRuntime.jsx("line", { x1: "4.93", y1: "4.93", x2: "19.07", y2: "19.07" })
+    ] }) }),
+    /* @__PURE__ */ jsxRuntime.jsx("h3", { className: "mlink-blocked-title", children: "Blocked MLink" }),
+    /* @__PURE__ */ jsxRuntime.jsx("p", { className: "mlink-blocked-message", children: message })
+  ] });
+}
 function MlinkSuccess({ message, txHash, onReset }) {
   const shortHash = `${txHash.slice(0, 10)}...${txHash.slice(-8)}`;
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "mlink-success", children: [