web3bio-profile-kit 0.1.0

package/dist/index.js

@@ -0,0 +1,354 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var react = require('react');
+
+const API_ENDPOINT = "https://api.web3.bio";
+exports.ErrorMessages = void 0;
+(function (ErrorMessages) {
+    ErrorMessages["NOT_FOUND"] = "Not Found";
+    ErrorMessages["INVALID_RESOLVER"] = "Invalid Resolver Address";
+    ErrorMessages["INVALID_RESOLVED"] = "Invalid Resolved Address";
+    ErrorMessages["NOT_EXIST"] = "Does Not Exist";
+    ErrorMessages["INVALID_IDENTITY"] = "Invalid Identity or Domain";
+    ErrorMessages["INVALID_ADDRESS"] = "Invalid Address";
+    ErrorMessages["UNKNOWN_ERROR"] = "Unknown Error Occurred";
+    ErrorMessages["NETWORK_ERROR"] = "Network Error";
+})(exports.ErrorMessages || (exports.ErrorMessages = {}));
+exports.QueryEndpoint = void 0;
+(function (QueryEndpoint) {
+    QueryEndpoint["NS"] = "ns";
+    QueryEndpoint["PROFILE"] = "profile";
+    QueryEndpoint["DOMAIN"] = "domain";
+})(exports.QueryEndpoint || (exports.QueryEndpoint = {}));
+// Regular expressions for identity detection
+const REGEX = {
+    ENS: /^.+\.(eth|xyz|bio|app|luxe|kred|art|ceo|club|box)$/i,
+    BASENAMES: /^.+\.base(\.eth)?$/i,
+    LINEA: /^.+\.linea(\.eth)?$/i,
+    FARCASTER: /^(?:[A-Za-z0-9_-]{1,61}(?:(?:\.eth)?(?:\.farcaster|\.fcast\.id|\.farcaster\.eth)?)?|farcaster,#\d+)$/i,
+    LENS: /^(?:.+\.lens)$/i,
+    CLUSTER: /^[\w-]+\/[\w-]+$/,
+    SPACE_ID: /^.+\.(bnb|arb)$/i,
+    GENOME: /^.+\.gno$/i,
+    UNSTOPPABLE_DOMAINS: /^.+\.(crypto|888|nft|blockchain|bitcoin|dao|x|klever|hi|zil|kresus|polygon|wallet|binanceus|anime|go|manga|eth)$/i,
+    CROSSBELL: /^.+\.csb$/i,
+    DOTBIT: /^.+\.bit$/i,
+    SNS: /^.+\.sol$/i,
+    ETH_ADDRESS: /^0x[a-fA-F0-9]{40}$/i,
+    BTC_ADDRESS: /\b([13][a-km-zA-HJ-NP-Z1-9]{25,34}|bc1[qp][a-z0-9]{11,71})\b/,
+    SOLANA_ADDRESS: /^[1-9A-HJ-NP-Za-km-z]{32,44}$/,
+    LOWERCASE_EXEMPT: /\b(?:(?:[13][a-km-zA-HJ-NP-Z1-9]{25,34}|bc1[qp][a-z0-9]{11,71})|(?:[1-9A-HJ-NP-Za-km-z]{32,44}))\b/,
+    TWITTER: /^[A-Za-z0-9_]{1,15}(?:\.twitter)?$/i,
+    NEXT_ID: /^0x[a-f0-9]{66}(?:\.nextid)?$/i,
+};
+
+exports.PlatformType = void 0;
+(function (PlatformType) {
+    PlatformType["ens"] = "ens";
+    PlatformType["farcaster"] = "farcaster";
+    PlatformType["lens"] = "lens";
+    PlatformType["ethereum"] = "ethereum";
+    PlatformType["twitter"] = "twitter";
+    PlatformType["github"] = "github";
+    PlatformType["bitcoin"] = "bitcoin";
+    PlatformType["unstoppableDomains"] = "unstoppabledomains";
+    PlatformType["basenames"] = "basenames";
+    PlatformType["linea"] = "linea";
+    PlatformType["space_id"] = "space_id";
+    PlatformType["solana"] = "solana";
+    PlatformType["sns"] = "sns";
+    PlatformType["nextid"] = "nextid";
+    PlatformType["dotbit"] = "dotbit";
+})(exports.PlatformType || (exports.PlatformType = {}));
+exports.SourceType = void 0;
+(function (SourceType) {
+    SourceType["ethereum"] = "ethereum";
+    SourceType["ens"] = "ens";
+    SourceType["twitter"] = "twitter";
+    SourceType["nextid"] = "nextid";
+    SourceType["dotbit"] = "dotbit";
+    SourceType["unstoppabledomains"] = "unstoppabledomains";
+    SourceType["lens"] = "lens";
+    SourceType["farcaster"] = "farcaster";
+    SourceType["space_id"] = "space_id";
+    SourceType["solana"] = "solana";
+    SourceType["sns"] = "sns";
+})(exports.SourceType || (exports.SourceType = {}));
+
+/**
+ * Resolves an identity string to a platform and identifier
+ * @param input The identity to resolve
+ * @returns A formatted identity string or null if invalid
+ */
+const resolveIdentity = (input) => {
+    if (!input)
+        return null;
+    const parts = input.split(",");
+    let platform;
+    let identity;
+    if (parts.length === 2) {
+        // Format is already "platform,identity"
+        platform = parts[0];
+        identity = prettify(parts[1]);
+    }
+    else if (parts.length === 1) {
+        // Auto-detect platform from the identity string
+        platform = detectPlatform(input);
+        identity = prettify(input);
+    }
+    else {
+        return null;
+    }
+    if (!isSupportedPlatform(platform) || !identity)
+        return null;
+    // Normalize case except for case-sensitive identities
+    const normalizedIdentity = REGEX.LOWERCASE_EXEMPT.test(identity)
+        ? identity
+        : identity.toLowerCase();
+    return `${platform},${normalizedIdentity}`;
+};
+/**
+ * Clean up and standardize identity format
+ */
+const prettify = (input) => {
+    if (!input)
+        return "";
+    if (input.endsWith(".twitter"))
+        return input.replace(".twitter", "");
+    if (input.endsWith(".nextid"))
+        return input.replace(".nextid", "");
+    if (input.startsWith("farcaster,#"))
+        return input.replace(/^(farcaster),/, "");
+    if (input.endsWith(".farcaster") ||
+        input.endsWith(".fcast.id") ||
+        input.endsWith(".farcaster.eth")) {
+        return input.replace(/(\.farcaster|\.fcast\.id|\.farcaster\.eth)$/, "");
+    }
+    if (input.endsWith(".base") || input.endsWith(".linea")) {
+        return input.split(".")[0] + "." + input.split(".").pop() + ".eth";
+    }
+    return input;
+};
+/**
+ * Check if the platform is supported for API queries
+ */
+const isSupportedPlatform = (platform) => {
+    if (!platform)
+        return false;
+    return Object.values(exports.PlatformType).includes(platform);
+};
+/**
+ * Detect platform from identity string based on regex patterns
+ */
+const detectPlatform = (term) => {
+    if (term.endsWith(".farcaster.eth"))
+        return exports.PlatformType.farcaster;
+    const platformMap = [
+        [REGEX.BASENAMES, exports.PlatformType.basenames],
+        [REGEX.LINEA, exports.PlatformType.linea],
+        [REGEX.ENS, exports.PlatformType.ens],
+        [REGEX.ETH_ADDRESS, exports.PlatformType.ethereum],
+        [REGEX.LENS, exports.PlatformType.lens],
+        [REGEX.UNSTOPPABLE_DOMAINS, exports.PlatformType.unstoppableDomains],
+        [REGEX.SPACE_ID, exports.PlatformType.space_id],
+        [REGEX.DOTBIT, exports.PlatformType.dotbit],
+        [REGEX.SNS, exports.PlatformType.sns],
+        [REGEX.BTC_ADDRESS, exports.PlatformType.bitcoin],
+        [REGEX.SOLANA_ADDRESS, exports.PlatformType.solana],
+        [REGEX.FARCASTER, exports.PlatformType.farcaster],
+        [REGEX.TWITTER, exports.PlatformType.twitter],
+        [REGEX.NEXT_ID, exports.PlatformType.nextid],
+    ];
+    for (const [regex, platformType] of platformMap) {
+        if (regex.test(term)) {
+            return platformType;
+        }
+    }
+    // Default fallback
+    return term.includes(".") ? exports.PlatformType.ens : exports.PlatformType.farcaster;
+};
+/**
+ * Get API key from various environment sources or user provided value
+ */
+const getApiKey = (userProvidedKey) => {
+    return (userProvidedKey ||
+        process.env.WEB3BIO_API_KEY ||
+        process.env.REACT_APP_WEB3BIO_API_KEY ||
+        process.env.NEXT_PUBLIC_WEB3BIO_API_KEY ||
+        process.env.VITE_WEB3BIO_API_KEY);
+};
+
+/**
+ * Constructs the API URL based on query parameters
+ */
+const buildApiUrl = (identity, endpoint, universal) => {
+    // Handle batch queries (array of identities)
+    if (Array.isArray(identity)) {
+        return `${API_ENDPOINT}/${endpoint}/batch/${JSON.stringify(identity)}`;
+    }
+    // Handle single identity query
+    if (universal) {
+        return `${API_ENDPOINT}/${endpoint}/${identity}`;
+    }
+    else {
+        const resolvedId = resolveIdentity(identity);
+        if (!resolvedId)
+            return null;
+        const [platform, handle] = resolvedId.split(",");
+        return `${API_ENDPOINT}/${endpoint}/${platform}/${handle}`;
+    }
+};
+/**
+ * Core hook for querying Web3.bio Profile API
+ */
+function useBaseQuery(identity, endpoint, universal = false, options = {}) {
+    const { apiKey: userApiKey, enabled = true } = options;
+    const apiKey = getApiKey(userApiKey);
+    const [data, setData] = react.useState(null);
+    const [isLoading, setIsLoading] = react.useState(false);
+    const [error, setError] = react.useState(null);
+    react.useEffect(() => {
+        // Don't run the query if disabled or no identity
+        if (!enabled || !identity)
+            return;
+        const controller = new AbortController();
+        setIsLoading(true);
+        setError(null);
+        const fetchData = async () => {
+            try {
+                const url = buildApiUrl(identity, endpoint, universal);
+                if (!url) {
+                    throw new Error(exports.ErrorMessages.INVALID_IDENTITY);
+                }
+                const headers = apiKey ? { "x-api-key": apiKey } : {};
+                const response = await fetch(url, {
+                    method: "GET",
+                    headers,
+                    signal: controller.signal,
+                });
+                if (!response.ok) {
+                    throw new Error(`API error: ${response.status}`);
+                }
+                const responseData = await response.json();
+                if (responseData === null || responseData === void 0 ? void 0 : responseData.error) {
+                    throw new Error(responseData.error);
+                }
+                setData(responseData);
+            }
+            catch (err) {
+                if (err instanceof Error && err.name === "AbortError")
+                    return;
+                setError(err instanceof Error ? err : new Error(String(err)));
+            }
+            finally {
+                setIsLoading(false);
+            }
+        };
+        fetchData();
+        return () => {
+            controller.abort();
+        };
+    }, [identity, apiKey, enabled, endpoint, universal]);
+    return { data, isLoading, error };
+}
+
+/**
+ * Hook to query Web3.bio profile data by identity
+ *
+ * @param identity - Identity string or array of identities to query
+ * @param options - Optional configuration options
+ * @returns Object containing profile data, loading state, and any errors
+ *
+ * @example
+ * // Query by ENS name
+ * const { data, isLoading, error } = useProfile("vitalik.eth");
+ *
+ * // Query with platform specification
+ * const { data } = useProfile("farcaster,dwr");
+ */
+function useProfile(identity, options = {}) {
+    return useBaseQuery(identity, exports.QueryEndpoint.PROFILE, false, options);
+}
+
+/**
+ * Hook to query Web3.bio name service (NS) data by identity
+ *
+ * @param identity - Identity string or array of identities to query
+ * @param options - Optional configuration options
+ * @returns Object containing NS data, loading state, and any errors
+ *
+ * @example
+ * // Query by ENS name
+ * const { data, isLoading, error } = useNS("vitalik.eth");
+ *
+ * // Query by Ethereum address
+ * const { data } = useNS("0x123...");
+ */
+function useNS(identity, options = {}) {
+    return useBaseQuery(identity, exports.QueryEndpoint.NS, false, options);
+}
+
+/**
+ * Hook to query Web3.bio domain data by identity
+ *
+ * @param identity - Identity string or array of identities to query
+ * @param options - Optional configuration options
+ * @returns Object containing domain data, loading state, and any errors
+ *
+ * @example
+ * // Query by ENS name
+ * const { data, isLoading, error } = useDomain("vitalik.eth");
+ *
+ * // Query by domain name with platform
+ * const { data } = useDomain("ens,vitalik.eth");
+ */
+function useDomain(identity, options = {}) {
+    return useBaseQuery(identity, exports.QueryEndpoint.DOMAIN, false, options);
+}
+
+/**
+ * Hook to query Web3.bio profile data using universal identity lookup
+ *
+ * @param identity - Identity string or array of identities to query
+ * @param options - Optional configuration options
+ * @returns Object containing profile data, loading state, and any errors
+ *
+ * @example
+ * // Query by ENS name with universal lookup
+ * const { data, isLoading, error } = useUniversalProfile("vitalik.eth");
+ *
+ * // Query by any identity type with universal lookup
+ * const { data } = useUniversalProfile("dwr.farcaster");
+ */
+function useUniversalProfile(identity, options = {}) {
+    return useBaseQuery(identity, exports.QueryEndpoint.PROFILE, true, options);
+}
+
+/**
+ * Hook to query Web3.bio name service (NS) data using universal identity lookup
+ *
+ * @param identity - Identity string or array of identities to query
+ * @param options - Optional configuration options
+ * @returns Object containing NS data, loading state, and any errors
+ *
+ * @example
+ * // Query by ENS name with universal lookup
+ * const { data, isLoading, error } = useUniversalNS("vitalik.eth");
+ *
+ * // Query by any identity type with universal lookup
+ * const { data } = useUniversalNS("dwr.farcaster");
+ */
+function useUniversalNS(identity, options = {}) {
+    return useBaseQuery(identity, exports.QueryEndpoint.NS, true, options);
+}
+
+exports.API_ENDPOINT = API_ENDPOINT;
+exports.REGEX = REGEX;
+exports.useDomain = useDomain;
+exports.useNS = useNS;
+exports.useProfile = useProfile;
+exports.useUniversalNS = useUniversalNS;
+exports.useUniversalProfile = useUniversalProfile;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/utils/constants.ts","../src/utils/types.ts","../src/utils/helpers.ts","../src/hooks/useBaseQuery.ts","../src/hooks/useProfile.ts","../src/hooks/useNS.ts","../src/hooks/useDomain.ts","../src/hooks/useUniversalProfile.ts","../src/hooks/useUniversalNS.ts"],"sourcesContent":["export const API_ENDPOINT = \"https://api.web3.bio\";\n\nexport enum ErrorMessages {\n  NOT_FOUND = \"Not Found\",\n  INVALID_RESOLVER = \"Invalid Resolver Address\",\n  INVALID_RESOLVED = \"Invalid Resolved Address\",\n  NOT_EXIST = \"Does Not Exist\",\n  INVALID_IDENTITY = \"Invalid Identity or Domain\",\n  INVALID_ADDRESS = \"Invalid Address\",\n  UNKNOWN_ERROR = \"Unknown Error Occurred\",\n  NETWORK_ERROR = \"Network Error\",\n}\n\nexport enum QueryEndpoint {\n  NS = \"ns\",\n  PROFILE = \"profile\",\n  DOMAIN = \"domain\",\n}\n\n// Regular expressions for identity detection\nexport const REGEX = {\n  ENS: /^.+\\.(eth|xyz|bio|app|luxe|kred|art|ceo|club|box)$/i,\n  BASENAMES: /^.+\\.base(\\.eth)?$/i,\n  LINEA: /^.+\\.linea(\\.eth)?$/i,\n  FARCASTER: /^(?:[A-Za-z0-9_-]{1,61}(?:(?:\\.eth)?(?:\\.farcaster|\\.fcast\\.id|\\.farcaster\\.eth)?)?|farcaster,#\\d+)$/i,\n  LENS: /^(?:.+\\.lens)$/i,\n  CLUSTER: /^[\\w-]+\\/[\\w-]+$/,\n  SPACE_ID: /^.+\\.(bnb|arb)$/i,\n  GENOME: /^.+\\.gno$/i,\n  UNSTOPPABLE_DOMAINS: /^.+\\.(crypto|888|nft|blockchain|bitcoin|dao|x|klever|hi|zil|kresus|polygon|wallet|binanceus|anime|go|manga|eth)$/i,\n  CROSSBELL: /^.+\\.csb$/i,\n  DOTBIT: /^.+\\.bit$/i,\n  SNS: /^.+\\.sol$/i,\n  ETH_ADDRESS: /^0x[a-fA-F0-9]{40}$/i,\n  BTC_ADDRESS: /\\b([13][a-km-zA-HJ-NP-Z1-9]{25,34}|bc1[qp][a-z0-9]{11,71})\\b/,\n  SOLANA_ADDRESS: /^[1-9A-HJ-NP-Za-km-z]{32,44}$/,\n  LOWERCASE_EXEMPT: /\\b(?:(?:[13][a-km-zA-HJ-NP-Z1-9]{25,34}|bc1[qp][a-z0-9]{11,71})|(?:[1-9A-HJ-NP-Za-km-z]{32,44}))\\b/,\n  TWITTER: /^[A-Za-z0-9_]{1,15}(?:\\.twitter)?$/i,\n  NEXT_ID: /^0x[a-f0-9]{66}(?:\\.nextid)?$/i,\n};","export enum PlatformType {\n  ens = \"ens\",\n  farcaster = \"farcaster\",\n  lens = \"lens\",\n  ethereum = \"ethereum\",\n  twitter = \"twitter\",\n  github = \"github\",\n  bitcoin = \"bitcoin\",\n  unstoppableDomains = \"unstoppabledomains\",\n  basenames = \"basenames\",\n  linea = \"linea\",\n  space_id = \"space_id\",\n  solana = \"solana\",\n  sns = \"sns\",\n  nextid = \"nextid\",\n  dotbit = \"dotbit\",\n}\n\nexport enum SourceType {\n  ethereum = \"ethereum\",\n  ens = \"ens\",\n  twitter = \"twitter\",\n  nextid = \"nextid\",\n  dotbit = \"dotbit\",\n  unstoppabledomains = \"unstoppabledomains\",\n  lens = \"lens\",\n  farcaster = \"farcaster\",\n  space_id = \"space_id\",\n  solana = \"solana\",\n  sns = \"sns\",\n}\n\nexport type SocialLinksItem = {\n  link: string | null;\n  handle: string | null;\n  sources: SourceType[];\n};\n\nexport type SocialLinks = Record<string, SocialLinksItem>;\n\nexport interface ProfileResponse {\n  identity: string;\n  address: string | null;\n  avatar: string | null;\n  description: string | null;\n  platform: string;\n  displayName: string | null;\n  email: string | null;\n  contenthash: string | null;\n  header: string | null;\n  location: string | null;\n  createdAt: string | null;\n  status: string | null;\n  error?: string;\n  links: SocialLinks;\n  social:\n    | {\n        uid: number | null;\n        follower: number;\n        following: number;\n      }\n    | {};\n}\n\nexport interface NSResponse {\n  identity: string;\n  address: string | null;\n  avatar: string | null;\n  description: string | null;\n  platform: string;\n  displayName: string | null;\n}\n\nexport interface DomainResponse {\n  identity: string;\n  platform: PlatformType;\n  resolvedAddress: string | null;\n  ownerAddress: string | null;\n  managerAddress: string | null;\n  displayName: string | null;\n  isPrimary: boolean;\n  status: string;\n  createdAt: string | null;\n  updatedAt: string | null;\n  expiredAt: string | null;\n  contenthash: string | null;\n  texts: Record<string, string>;\n  addresses: Record<string, string>;\n}\n\nexport type QueryOptions = {\n  /** API Key for authentication */\n  apiKey?: string;\n  /** Whether the query should execute */\n  enabled?: boolean;\n};\n\nexport type IdentityString = string | `${PlatformType},${string}`;\nexport type Identity = IdentityString | IdentityString[];\n\nexport type QueryResult<T> = {\n  data: T | null;\n  isLoading: boolean;\n  error: Error | null;\n};\n\n// Query-specific result types for better type safety\nexport type ProfileQueryResult = QueryResult<ProfileResponse>;\nexport type NSQueryResult = QueryResult<NSResponse>;\nexport type DomainQueryResult = QueryResult<DomainResponse>;\n","import { REGEX } from \"./constants\";\nimport { PlatformType, Identity } from \"./types\";\n\n/**\n * Resolves an identity string to a platform and identifier\n * @param input The identity to resolve\n * @returns A formatted identity string or null if invalid\n */\nexport const resolveIdentity = (input: string): string | null => {\n  if (!input) return null;\n\n  const parts = input.split(\",\");\n\n  let platform: PlatformType;\n  let identity: string;\n\n  if (parts.length === 2) {\n    // Format is already \"platform,identity\"\n    platform = parts[0] as PlatformType;\n    identity = prettify(parts[1]);\n  } else if (parts.length === 1) {\n    // Auto-detect platform from the identity string\n    platform = detectPlatform(input);\n    identity = prettify(input);\n  } else {\n    return null;\n  }\n\n  if (!isSupportedPlatform(platform) || !identity) return null;\n\n  // Normalize case except for case-sensitive identities\n  const normalizedIdentity = REGEX.LOWERCASE_EXEMPT.test(identity)\n    ? identity\n    : identity.toLowerCase();\n\n  return `${platform},${normalizedIdentity}`;\n};\n\n/**\n * Clean up and standardize identity format\n */\nexport const prettify = (input: string): string => {\n  if (!input) return \"\";\n  if (input.endsWith(\".twitter\")) return input.replace(\".twitter\", \"\");\n  if (input.endsWith(\".nextid\")) return input.replace(\".nextid\", \"\");\n  if (input.startsWith(\"farcaster,#\"))\n    return input.replace(/^(farcaster),/, \"\");\n  if (\n    input.endsWith(\".farcaster\") ||\n    input.endsWith(\".fcast.id\") ||\n    input.endsWith(\".farcaster.eth\")\n  ) {\n    return input.replace(/(\\.farcaster|\\.fcast\\.id|\\.farcaster\\.eth)$/, \"\");\n  }\n  if (input.endsWith(\".base\") || input.endsWith(\".linea\")) {\n    return input.split(\".\")[0] + \".\" + input.split(\".\").pop() + \".eth\";\n  }\n  return input;\n};\n\n/**\n * Check if the platform is supported for API queries\n */\nexport const isSupportedPlatform = (\n  platform?: PlatformType | null,\n): boolean => {\n  if (!platform) return false;\n  return Object.values(PlatformType).includes(platform as PlatformType);\n};\n\n/**\n * Detect platform from identity string based on regex patterns\n */\nexport const detectPlatform = (term: string): PlatformType => {\n  if (term.endsWith(\".farcaster.eth\")) return PlatformType.farcaster;\n\n  const platformMap: [RegExp, PlatformType][] = [\n    [REGEX.BASENAMES, PlatformType.basenames],\n    [REGEX.LINEA, PlatformType.linea],\n    [REGEX.ENS, PlatformType.ens],\n    [REGEX.ETH_ADDRESS, PlatformType.ethereum],\n    [REGEX.LENS, PlatformType.lens],\n    [REGEX.UNSTOPPABLE_DOMAINS, PlatformType.unstoppableDomains],\n    [REGEX.SPACE_ID, PlatformType.space_id],\n    [REGEX.DOTBIT, PlatformType.dotbit],\n    [REGEX.SNS, PlatformType.sns],\n    [REGEX.BTC_ADDRESS, PlatformType.bitcoin],\n    [REGEX.SOLANA_ADDRESS, PlatformType.solana],\n    [REGEX.FARCASTER, PlatformType.farcaster],\n    [REGEX.TWITTER, PlatformType.twitter],\n    [REGEX.NEXT_ID, PlatformType.nextid],\n  ];\n\n  for (const [regex, platformType] of platformMap) {\n    if (regex.test(term)) {\n      return platformType;\n    }\n  }\n\n  // Default fallback\n  return term.includes(\".\") ? PlatformType.ens : PlatformType.farcaster;\n};\n\n/**\n * Get API key from various environment sources or user provided value\n */\nexport const getApiKey = (userProvidedKey?: string): string | undefined => {\n  return (\n    userProvidedKey ||\n    process.env.WEB3BIO_API_KEY ||\n    process.env.REACT_APP_WEB3BIO_API_KEY ||\n    process.env.NEXT_PUBLIC_WEB3BIO_API_KEY ||\n    process.env.VITE_WEB3BIO_API_KEY\n  );\n};\n","import { useState, useEffect } from \"react\";\nimport { API_ENDPOINT, ErrorMessages, QueryEndpoint } from \"../utils/constants\";\nimport { getApiKey, resolveIdentity } from \"../utils/helpers\";\nimport { Identity, QueryOptions, QueryResult } from \"../utils/types\";\n\n/**\n * Constructs the API URL based on query parameters\n */\nconst buildApiUrl = (\n  identity: Identity,\n  endpoint: QueryEndpoint,\n  universal: boolean,\n): string | null => {\n  // Handle batch queries (array of identities)\n  if (Array.isArray(identity)) {\n    return `${API_ENDPOINT}/${endpoint}/batch/${JSON.stringify(identity)}`;\n  }\n\n  // Handle single identity query\n  if (universal) {\n    return `${API_ENDPOINT}/${endpoint}/${identity}`;\n  } else {\n    const resolvedId = resolveIdentity(identity);\n    if (!resolvedId) return null;\n\n    const [platform, handle] = resolvedId.split(\",\");\n    return `${API_ENDPOINT}/${endpoint}/${platform}/${handle}`;\n  }\n};\n\n/**\n * Core hook for querying Web3.bio Profile API\n */\nexport function useBaseQuery<T>(\n  identity: Identity,\n  endpoint: QueryEndpoint,\n  universal: boolean = false,\n  options: QueryOptions = {},\n): QueryResult<T> {\n  const { apiKey: userApiKey, enabled = true } = options;\n  const apiKey = getApiKey(userApiKey);\n\n  const [data, setData] = useState<T | null>(null);\n  const [isLoading, setIsLoading] = useState<boolean>(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  useEffect(() => {\n    // Don't run the query if disabled or no identity\n    if (!enabled || !identity) return;\n\n    const controller = new AbortController();\n    setIsLoading(true);\n    setError(null);\n\n    const fetchData = async () => {\n      try {\n        const url = buildApiUrl(identity, endpoint, universal);\n\n        if (!url) {\n          throw new Error(ErrorMessages.INVALID_IDENTITY);\n        }\n\n        const headers: HeadersInit = apiKey ? { \"x-api-key\": apiKey } : {};\n\n        const response = await fetch(url, {\n          method: \"GET\",\n          headers,\n          signal: controller.signal,\n        });\n\n        if (!response.ok) {\n          throw new Error(`API error: ${response.status}`);\n        }\n\n        const responseData = await response.json();\n\n        if (responseData?.error) {\n          throw new Error(responseData.error);\n        }\n\n        setData(responseData as T);\n      } catch (err) {\n        if (err instanceof Error && err.name === \"AbortError\") return;\n        setError(err instanceof Error ? err : new Error(String(err)));\n      } finally {\n        setIsLoading(false);\n      }\n    };\n\n    fetchData();\n\n    return () => {\n      controller.abort();\n    };\n  }, [identity, apiKey, enabled, endpoint, universal]);\n\n  return { data, isLoading, error };\n}\n","import { QueryEndpoint } from \"../utils/constants\";\nimport { Identity, ProfileQueryResult, ProfileResponse, QueryOptions } from \"../utils/types\";\nimport { useBaseQuery } from \"./useBaseQuery\";\n\n/**\n * Hook to query Web3.bio profile data by identity\n * \n * @param identity - Identity string or array of identities to query\n * @param options - Optional configuration options\n * @returns Object containing profile data, loading state, and any errors\n * \n * @example\n * // Query by ENS name\n * const { data, isLoading, error } = useProfile(\"vitalik.eth\");\n * \n * // Query with platform specification\n * const { data } = useProfile(\"farcaster,dwr\");\n */\nexport function useProfile(\n  identity: Identity,\n  options: QueryOptions = {}\n): ProfileQueryResult {\n  return useBaseQuery<ProfileResponse>(identity, QueryEndpoint.PROFILE, false, options);\n}","import { QueryEndpoint } from \"../utils/constants\";\nimport { Identity, NSResponse, NSQueryResult, QueryOptions } from \"../utils/types\";\nimport { useBaseQuery } from \"./useBaseQuery\";\n\n/**\n * Hook to query Web3.bio name service (NS) data by identity\n * \n * @param identity - Identity string or array of identities to query\n * @param options - Optional configuration options\n * @returns Object containing NS data, loading state, and any errors\n * \n * @example\n * // Query by ENS name\n * const { data, isLoading, error } = useNS(\"vitalik.eth\");\n * \n * // Query by Ethereum address\n * const { data } = useNS(\"0x123...\");\n */\nexport function useNS(\n  identity: Identity,\n  options: QueryOptions = {}\n): NSQueryResult {\n  return useBaseQuery<NSResponse>(identity, QueryEndpoint.NS, false, options);\n}","import { QueryEndpoint } from \"../utils/constants\";\nimport { DomainQueryResult, DomainResponse, Identity, QueryOptions } from \"../utils/types\";\nimport { useBaseQuery } from \"./useBaseQuery\";\n\n/**\n * Hook to query Web3.bio domain data by identity\n * \n * @param identity - Identity string or array of identities to query\n * @param options - Optional configuration options\n * @returns Object containing domain data, loading state, and any errors\n * \n * @example\n * // Query by ENS name\n * const { data, isLoading, error } = useDomain(\"vitalik.eth\");\n * \n * // Query by domain name with platform\n * const { data } = useDomain(\"ens,vitalik.eth\");\n */\nexport function useDomain(\n  identity: Identity,\n  options: QueryOptions = {}\n): DomainQueryResult {\n  return useBaseQuery<DomainResponse>(identity, QueryEndpoint.DOMAIN, false, options);\n}","import { QueryEndpoint } from \"../utils/constants\";\nimport { Identity, ProfileQueryResult, ProfileResponse, QueryOptions } from \"../utils/types\";\nimport { useBaseQuery } from \"./useBaseQuery\";\n\n/**\n * Hook to query Web3.bio profile data using universal identity lookup\n * \n * @param identity - Identity string or array of identities to query\n * @param options - Optional configuration options\n * @returns Object containing profile data, loading state, and any errors\n * \n * @example\n * // Query by ENS name with universal lookup\n * const { data, isLoading, error } = useUniversalProfile(\"vitalik.eth\");\n * \n * // Query by any identity type with universal lookup\n * const { data } = useUniversalProfile(\"dwr.farcaster\");\n */\nexport function useUniversalProfile(\n  identity: Identity,\n  options: QueryOptions = {}\n): ProfileQueryResult {\n  return useBaseQuery<ProfileResponse>(identity, QueryEndpoint.PROFILE, true, options);\n}","import { QueryEndpoint } from \"../utils/constants\";\nimport { Identity, NSResponse, NSQueryResult, QueryOptions } from \"../utils/types\";\nimport { useBaseQuery } from \"./useBaseQuery\";\n\n/**\n * Hook to query Web3.bio name service (NS) data using universal identity lookup\n * \n * @param identity - Identity string or array of identities to query\n * @param options - Optional configuration options\n * @returns Object containing NS data, loading state, and any errors\n * \n * @example\n * // Query by ENS name with universal lookup\n * const { data, isLoading, error } = useUniversalNS(\"vitalik.eth\");\n * \n * // Query by any identity type with universal lookup\n * const { data } = useUniversalNS(\"dwr.farcaster\");\n */\nexport function useUniversalNS(\n  identity: Identity,\n  options: QueryOptions = {}\n): NSQueryResult {\n  return useBaseQuery<NSResponse>(identity, QueryEndpoint.NS, true, options);\n}"],"names":["ErrorMessages","QueryEndpoint","PlatformType","SourceType","useState","useEffect"],"mappings":"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"}

package/dist/setupTests.d.ts

@@ -0,0 +1 @@
+import "@testing-library/jest-dom";

package/dist/utils/constants.d.ts

@@ -0,0 +1,36 @@
+export declare const API_ENDPOINT = "https://api.web3.bio";
+export declare enum ErrorMessages {
+    NOT_FOUND = "Not Found",
+    INVALID_RESOLVER = "Invalid Resolver Address",
+    INVALID_RESOLVED = "Invalid Resolved Address",
+    NOT_EXIST = "Does Not Exist",
+    INVALID_IDENTITY = "Invalid Identity or Domain",
+    INVALID_ADDRESS = "Invalid Address",
+    UNKNOWN_ERROR = "Unknown Error Occurred",
+    NETWORK_ERROR = "Network Error"
+}
+export declare enum QueryEndpoint {
+    NS = "ns",
+    PROFILE = "profile",
+    DOMAIN = "domain"
+}
+export declare const REGEX: {
+    ENS: RegExp;
+    BASENAMES: RegExp;
+    LINEA: RegExp;
+    FARCASTER: RegExp;
+    LENS: RegExp;
+    CLUSTER: RegExp;
+    SPACE_ID: RegExp;
+    GENOME: RegExp;
+    UNSTOPPABLE_DOMAINS: RegExp;
+    CROSSBELL: RegExp;
+    DOTBIT: RegExp;
+    SNS: RegExp;
+    ETH_ADDRESS: RegExp;
+    BTC_ADDRESS: RegExp;
+    SOLANA_ADDRESS: RegExp;
+    LOWERCASE_EXEMPT: RegExp;
+    TWITTER: RegExp;
+    NEXT_ID: RegExp;
+};

package/dist/utils/helpers.d.ts

@@ -0,0 +1,23 @@
+import { PlatformType } from "./types";
+/**
+ * Resolves an identity string to a platform and identifier
+ * @param input The identity to resolve
+ * @returns A formatted identity string or null if invalid
+ */
+export declare const resolveIdentity: (input: string) => string | null;
+/**
+ * Clean up and standardize identity format
+ */
+export declare const prettify: (input: string) => string;
+/**
+ * Check if the platform is supported for API queries
+ */
+export declare const isSupportedPlatform: (platform?: PlatformType | null) => boolean;
+/**
+ * Detect platform from identity string based on regex patterns
+ */
+export declare const detectPlatform: (term: string) => PlatformType;
+/**
+ * Get API key from various environment sources or user provided value
+ */
+export declare const getApiKey: (userProvidedKey?: string) => string | undefined;

package/dist/utils/types.d.ts

@@ -0,0 +1,97 @@
+export declare enum PlatformType {
+    ens = "ens",
+    farcaster = "farcaster",
+    lens = "lens",
+    ethereum = "ethereum",
+    twitter = "twitter",
+    github = "github",
+    bitcoin = "bitcoin",
+    unstoppableDomains = "unstoppabledomains",
+    basenames = "basenames",
+    linea = "linea",
+    space_id = "space_id",
+    solana = "solana",
+    sns = "sns",
+    nextid = "nextid",
+    dotbit = "dotbit"
+}
+export declare enum SourceType {
+    ethereum = "ethereum",
+    ens = "ens",
+    twitter = "twitter",
+    nextid = "nextid",
+    dotbit = "dotbit",
+    unstoppabledomains = "unstoppabledomains",
+    lens = "lens",
+    farcaster = "farcaster",
+    space_id = "space_id",
+    solana = "solana",
+    sns = "sns"
+}
+export type SocialLinksItem = {
+    link: string | null;
+    handle: string | null;
+    sources: SourceType[];
+};
+export type SocialLinks = Record<string, SocialLinksItem>;
+export interface ProfileResponse {
+    identity: string;
+    address: string | null;
+    avatar: string | null;
+    description: string | null;
+    platform: string;
+    displayName: string | null;
+    email: string | null;
+    contenthash: string | null;
+    header: string | null;
+    location: string | null;
+    createdAt: string | null;
+    status: string | null;
+    error?: string;
+    links: SocialLinks;
+    social: {
+        uid: number | null;
+        follower: number;
+        following: number;
+    } | {};
+}
+export interface NSResponse {
+    identity: string;
+    address: string | null;
+    avatar: string | null;
+    description: string | null;
+    platform: string;
+    displayName: string | null;
+}
+export interface DomainResponse {
+    identity: string;
+    platform: PlatformType;
+    resolvedAddress: string | null;
+    ownerAddress: string | null;
+    managerAddress: string | null;
+    displayName: string | null;
+    isPrimary: boolean;
+    status: string;
+    createdAt: string | null;
+    updatedAt: string | null;
+    expiredAt: string | null;
+    contenthash: string | null;
+    texts: Record<string, string>;
+    addresses: Record<string, string>;
+}
+export type QueryOptions = {
+    /** API Key for authentication */
+    apiKey?: string;
+    /** Whether the query should execute */
+    enabled?: boolean;
+};
+export type IdentityString = string | `${PlatformType},${string}`;
+export type Identity = IdentityString | IdentityString[];
+export type QueryResult<T> = {
+    data: T | null;
+    isLoading: boolean;
+    error: Error | null;
+};
+export type ProfileQueryResult = QueryResult<ProfileResponse>;
+export type NSQueryResult = QueryResult<NSResponse>;
+export type DomainQueryResult = QueryResult<DomainResponse>;

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "web3bio-profile-kit",
+  "version": "0.1.0",
+  "description": "React hooks for querying Web3.bio profiles",
+  "author": "web3bio",
+  "license": "MIT",
+  "private": false,
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "web3",
+    "profile",
+    "react",
+    "hooks",
+    "web3bio",
+    "ens",
+    "farcaster",
+    "lens"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/web3bio/web3bio-profile-kit"
+  },
+  "homepage": "https://github.com/web3bio/web3bio-profile-kit#readme",
+  "bugs": {
+    "url": "https://github.com/web3bio/web3bio-profile-kit/issues"
+  },
+  "scripts": {
+    "build": "rimraf dist && rollup -c",
+    "test": "react-scripts test",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "react-dom": ">=16.8.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.0",
+    "@rollup/plugin-node-resolve": "^15.0.0",
+    "@rollup/plugin-typescript": "^11.0.0",
+    "@testing-library/react": "^14.0.0",
+    "@types/react": "^18.0.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "rimraf": "^5.0.5",
+    "rollup": "^3.25.0",
+    "rollup-plugin-dts": "^5.3.0",
+    "rollup-plugin-peer-deps-external": "^2.2.4",
+    "typescript": "^5.0.0"
+  }
+}