@hive-ng/web-sdk 0.1.0

package/dist/react/index.js

@@ -0,0 +1,105 @@
+import { createHiveNg } from '../chunk-NWQONJK2.js';
+import { createContext, useRef, useState, useEffect, useMemo, useContext, useCallback } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+var HiveContext = createContext(null);
+function HiveProvider({ config, children }) {
+  const hiveRef = useRef(null);
+  if (hiveRef.current === null) {
+    hiveRef.current = createHiveNg(config);
+  }
+  const hive = hiveRef.current;
+  const [ready, setReady] = useState(false);
+  const [initError, setInitError] = useState(null);
+  useEffect(() => {
+    let cancelled = false;
+    hive.init().then(() => hive.auth.restoreSession()).then(() => {
+      if (!cancelled) setReady(true);
+    }).catch((err) => {
+      if (!cancelled) setInitError(err);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [hive]);
+  const value = useMemo(
+    () => ({ hive, ready, initError }),
+    [hive, ready, initError]
+  );
+  return /* @__PURE__ */ jsx(HiveContext.Provider, { value, children });
+}
+function useHiveNg() {
+  const ctx = useContext(HiveContext);
+  if (ctx === null) {
+    throw new Error("useHiveNg must be used within <HiveProvider>");
+  }
+  return ctx;
+}
+function useAuth() {
+  const { hive, ready, initError } = useHiveNg();
+  const [player, setPlayer] = useState(() => hive.auth.currentPlayer());
+  const [pending, setPending] = useState(false);
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    if (ready) {
+      setPlayer(hive.auth.currentPlayer());
+    }
+  }, [ready, hive]);
+  const getLoginProviders = useCallback(
+    async (countryOverride) => hive.auth.getLoginProviders(countryOverride),
+    [hive]
+  );
+  const loginWithGoogle = useCallback(
+    async (idToken) => {
+      setPending(true);
+      setError(null);
+      try {
+        const loggedIn = await hive.auth.loginWithGoogle(idToken);
+        setPlayer(loggedIn);
+        return loggedIn;
+      } catch (err) {
+        setError(err);
+        throw err;
+      } finally {
+        setPending(false);
+      }
+    },
+    [hive]
+  );
+  const loginAsGuest = useCallback(
+    async (deviceId) => {
+      setPending(true);
+      setError(null);
+      try {
+        const loggedIn = await hive.auth.loginAsGuest(deviceId);
+        setPlayer(loggedIn);
+        return loggedIn;
+      } catch (err) {
+        setError(err);
+        throw err;
+      } finally {
+        setPending(false);
+      }
+    },
+    [hive]
+  );
+  const logout = useCallback(async () => {
+    await hive.auth.logout();
+    setPlayer(null);
+  }, [hive]);
+  return {
+    ready,
+    initError,
+    player,
+    pending,
+    error,
+    getLoginProviders,
+    loginWithGoogle,
+    loginAsGuest,
+    logout
+  };
+}
+
+export { HiveProvider, useAuth, useHiveNg };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/index.tsx"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport {\n  createHiveNg,\n  type HiveNgClient,\n  type HiveNgConfig,\n  type LoginProviders,\n  type Player,\n} from \"../index\";\n\ninterface HiveContextValue {\n  hive: HiveNgClient;\n  ready: boolean;\n  initError: Error | null;\n}\n\nconst HiveContext = createContext<HiveContextValue | null>(null);\n\nexport interface HiveProviderProps {\n  config: HiveNgConfig;\n  children: ReactNode;\n}\n\nexport function HiveProvider({ config, children }: HiveProviderProps) {\n  // config는 마운트 시점 값으로 1회 생성한다(런타임 재구성은 재마운트로).\n  const hiveRef = useRef<HiveNgClient | null>(null);\n  if (hiveRef.current === null) {\n    hiveRef.current = createHiveNg(config);\n  }\n  const hive = hiveRef.current;\n\n  const [ready, setReady] = useState(false);\n  const [initError, setInitError] = useState<Error | null>(null);\n\n  useEffect(() => {\n    let cancelled = false;\n    hive\n      .init()\n      .then(() => hive.auth.restoreSession())\n      .then(() => {\n        if (!cancelled) setReady(true);\n      })\n      .catch((err: unknown) => {\n        if (!cancelled) setInitError(err as Error);\n      });\n    return () => {\n      cancelled = true;\n    };\n  }, [hive]);\n\n  const value = useMemo<HiveContextValue>(\n    () => ({ hive, ready, initError }),\n    [hive, ready, initError],\n  );\n\n  return <HiveContext.Provider value={value}>{children}</HiveContext.Provider>;\n}\n\nexport function useHiveNg(): HiveContextValue {\n  const ctx = useContext(HiveContext);\n  if (ctx === null) {\n    throw new Error(\"useHiveNg must be used within <HiveProvider>\");\n  }\n  return ctx;\n}\n\nexport interface UseAuthResult {\n  ready: boolean;\n  initError: Error | null;\n  player: Player | null;\n  pending: boolean;\n  error: Error | null;\n  getLoginProviders: (countryOverride?: string) => Promise<LoginProviders>;\n  loginWithGoogle: (idToken: string) => Promise<Player>;\n  loginAsGuest: (deviceId: string) => Promise<Player>;\n  logout: () => Promise<void>;\n}\n\nexport function useAuth(): UseAuthResult {\n  const { hive, ready, initError } = useHiveNg();\n  const [player, setPlayer] = useState<Player | null>(() => hive.auth.currentPlayer());\n  const [pending, setPending] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  // init+restoreSession 완료(ready) 시점에 복원된 player를 반영한다.\n  useEffect(() => {\n    if (ready) {\n      setPlayer(hive.auth.currentPlayer());\n    }\n  }, [ready, hive]);\n\n  const getLoginProviders = useCallback(\n    async (countryOverride?: string): Promise<LoginProviders> =>\n      hive.auth.getLoginProviders(countryOverride),\n    [hive],\n  );\n\n  const loginWithGoogle = useCallback(\n    async (idToken: string): Promise<Player> => {\n      setPending(true);\n      setError(null);\n      try {\n        const loggedIn = await hive.auth.loginWithGoogle(idToken);\n        setPlayer(loggedIn);\n        return loggedIn;\n      } catch (err) {\n        setError(err as Error);\n        throw err;\n      } finally {\n        setPending(false);\n      }\n    },\n    [hive],\n  );\n\n  const loginAsGuest = useCallback(\n    async (deviceId: string): Promise<Player> => {\n      setPending(true);\n      setError(null);\n      try {\n        const loggedIn = await hive.auth.loginAsGuest(deviceId);\n        setPlayer(loggedIn);\n        return loggedIn;\n      } catch (err) {\n        setError(err as Error);\n        throw err;\n      } finally {\n        setPending(false);\n      }\n    },\n    [hive],\n  );\n\n  const logout = useCallback(async (): Promise<void> => {\n    await hive.auth.logout();\n    setPlayer(null);\n  }, [hive]);\n\n  return {\n    ready,\n    initError,\n    player,\n    pending,\n    error,\n    getLoginProviders,\n    loginWithGoogle,\n    loginAsGuest,\n    logout,\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@hive-ng/web-sdk",
+  "version": "0.1.0",
+  "description": "HIVE-NG browser SDK for game clients.",
+  "license": "UNLICENSED",
+  "author": "HIVE-NG",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "unpkg": "./dist/hive-ng.global.js",
+  "jsdelivr": "./dist/hive-ng.global.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js",
+      "require": "./dist/react/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "prepack": "pnpm run build",
+    "build": "tsc --noEmit && tsup",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "hive-ng",
+    "hiveng",
+    "sdk",
+    "game",
+    "auth",
+    "browser",
+    "web"
+  ],
+  "dependencies": {
+    "@bufbuild/protobuf": "^2.12.0",
+    "@connectrpc/connect": "^2.1.0",
+    "@connectrpc/connect-web": "^2.1.0"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "^18.3.0",
+    "jsdom": "^26.1.0",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.2.0"
+  }
+}