@fuzionx/bridge 0.1.0

package/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @fuzionx/bridge — FuzionX Native Bridge N-API bindings
+ *
+ * High-performance Rust native module for Node.js.
+ * libuv Fusion architecture: 167K RPS (×1), 594K RPS (×4 cluster)
+ */
+
+// ── Boot & Config ──
+export function bootSystem(options: { configPath?: string; port?: number; workers?: number }): void;
+export function reloadConfig(): void;
+export function reloadFusionConfig(): void;
+export function getConfig(): Record<string, any>;
+export function getAppConfig(): string;
+export function getAspConfig(): string;
+export function getWorkerCount(): number;
+
+// ── Fusion Server ──
+export function startFusionServer(port: number, handler: (req: any) => any): void;
+export function stopFusionServer(): void;
+export function cleanupIdleConnections(timeoutMs: number): number;
+
+// ── Routing ──
+export function registerRoute(method: string, path: string): number;
+export function buildRoutes(): void;
+
+// ── WebSocket ──
+export function wsRegisterOnConnect(callback: (namespace: string, sessionId: string) => void): void;
+export function wsRegisterOnMessage(callback: (namespace: string, sessionId: string, data: string) => void): void;
+export function wsRegisterOnDisconnect(callback: (namespace: string, sessionId: string) => void): void;
+export function wsBroadcastAll(data: string): void;
+export function wsBroadcastExcluding(excludeId: string, data: string): void;
+export function wsSendTo(sessionId: string, data: string): boolean;
+export function wsSendToMany(sessionIds: string[], data: string): number;
+export function wsSendToMetadataMatch(key: string, value: string, data: string): number;
+export function wsSetMetadata(sessionId: string, key: string, value: string): void;
+export function wsGetMetadata(sessionId: string, key: string): string | null;
+export function wsRemoveInactive(timeoutMs: number): number;
+export function wsGetAllSessionIds(): string[];
+export function wsGetOnlineCount(): number;
+
+// ── Session ──
+export function sessionLoad(sessionId: string): string | null;
+export function sessionGet(sessionId: string): string | null;
+export function sessionSet(sessionId: string, data: string, ttl: number): void;
+export function sessionRenew(sessionId: string): void;
+export function sessionDestroy(sessionId: string): boolean;
+export function sessionCleanup(): number;
+export function sessionGenerateId(): string;
+
+// ── Crypto ──
+export function encrypt(plaintext: string, key: string): string;
+export function decrypt(ciphertext: string, key: string): string;
+export function encryptTransport(plaintext: string, rawKey: string): string;
+export function decryptTransport(ciphertext: string, rawKey: string): string;
+export function sha256(input: string): string;
+export function md5(input: string): string;
+export function uuid(): string;
+export function deriveKey(secret: string, domain: string, ua: string, ts: string): string;
+export function getUaSlice(ua: string, ts: string): string;
+
+// ── SSR / I18n ──
+export function renderTemplateFile(filePath: string, context: string): string;
+export function renderString(template: string, context: string): string;
+export function translate(key: string, locale: string, params?: string): string;
+
+// ── Logging ──
+export function logInfo(msg: string): void;
+export function logWarn(msg: string): void;
+export function logError(msg: string): void;
+export function logDebug(msg: string): void;

package/index.js

@@ -0,0 +1,44 @@
+/* eslint-disable no-console */
+/**
+ * @fuzionx/bridge — 플랫폼별 네이티브 모듈 로더
+ *
+ * napi-rs 표준 패턴: OS/arch를 감지하여 올바른 플랫폼 패키지의 .node 파일을 로드.
+ */
+
+const { platform, arch } = process;
+
+function getBinding() {
+    const platformMap = {
+        'linux-x64': { pkg: '@fuzionx/bridge-linux-x64-gnu', file: 'fuzionx-bridge.linux-x64-gnu.node' },
+        'darwin-arm64': { pkg: '@fuzionx/bridge-darwin-arm64', file: 'fuzionx-bridge.darwin-arm64.node' },
+        'win32-x64': { pkg: '@fuzionx/bridge-win32-x64-msvc', file: 'fuzionx-bridge.win32-x64-msvc.node' },
+    };
+
+    const key = `${platform}-${arch}`;
+    const target = platformMap[key];
+
+    if (!target) {
+        throw new Error(
+            `@fuzionx/bridge: 지원하지 않는 플랫폼입니다: ${key}\n` +
+            `지원 플랫폼: ${Object.keys(platformMap).join(', ')}`
+        );
+    }
+
+    try {
+        return require(target.pkg);
+    } catch (loadError) {
+        // fallback: 같은 디렉터리에서 .node 파일 직접 로드 (개발 환경)
+        try {
+            return require(`./${target.file}`);
+        } catch (_) {
+            throw new Error(
+                `@fuzionx/bridge: 네이티브 모듈을 로드할 수 없습니다.\n` +
+                `패키지 '${target.pkg}'가 설치되어 있지 않습니다.\n` +
+                `'npm install @fuzionx/bridge'를 다시 실행해 주세요.\n` +
+                `원인: ${loadError.message}`
+            );
+        }
+    }
+}
+
+module.exports = getBinding();

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@fuzionx/bridge",
+  "version": "0.1.0",
+  "description": "FuzionX native bridge — high-performance N-API addon for Node.js",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": ["index.js", "index.d.ts"],
+  "napi": {
+    "binaryName": "fuzionx-bridge",
+    "targets": [
+      "x86_64-unknown-linux-gnu",
+      "aarch64-apple-darwin",
+      "x86_64-pc-windows-msvc"
+    ]
+  },
+  "optionalDependencies": {
+    "@fuzionx/bridge-linux-x64-gnu": "0.1.0",
+    "@fuzionx/bridge-darwin-arm64": "0.1.0",
+    "@fuzionx/bridge-win32-x64-msvc": "0.1.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/saytohenry/fuzionx"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}