@phalanx-engine/client 0.1.0

package/dist/StateHasher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateHasher.d.ts","sourceRoot":"","sources":["../src/StateHasher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAe;IACjD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAa;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAS;IAEhD,OAAO,CAAC,IAAI,CAAS;;IAMrB;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAiB3B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM7B;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAW9B;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAM7B;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAQnC;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAQrC;;;OAGG;IACH,QAAQ,IAAI,MAAM;IAMlB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,MAAM,CAAC,MAAM,IAAI,WAAW;CAG7B"}

package/dist/StateHasher.js

@@ -0,0 +1,129 @@
+/**
+ * StateHasher - Deterministic state hasher using FNV-1a algorithm
+ *
+ * Works only with primitives - game-agnostic by design.
+ * Games use this to hash their own state structure.
+ *
+ * @example
+ * ```typescript
+ * const hash = new StateHasher()
+ *   .addInt(tick)
+ *   .addInt(entityCount)
+ *   .addFloat(entity.x)
+ *   .addFloat(entity.y)
+ *   .addString(entity.state)
+ *   .finalize();
+ * ```
+ */
+export class StateHasher {
+    static FNV_OFFSET = 2166136261n;
+    static FNV_PRIME = 16777619n;
+    static FLOAT_PRECISION = 10000; // 4 decimal places
+    hash;
+    constructor() {
+        this.hash = StateHasher.FNV_OFFSET;
+    }
+    /**
+     * Add an integer to the hash
+     * @param value - Integer value to hash
+     * @returns this (for chaining)
+     */
+    addInt(value) {
+        // Ensure integer
+        const int = Math.floor(value) | 0;
+        // Hash each byte (32-bit integer = 4 bytes)
+        this.hash ^= BigInt(int & 0xff);
+        this.hash *= StateHasher.FNV_PRIME;
+        this.hash ^= BigInt((int >> 8) & 0xff);
+        this.hash *= StateHasher.FNV_PRIME;
+        this.hash ^= BigInt((int >> 16) & 0xff);
+        this.hash *= StateHasher.FNV_PRIME;
+        this.hash ^= BigInt((int >> 24) & 0xff);
+        this.hash *= StateHasher.FNV_PRIME;
+        return this;
+    }
+    /**
+     * Add a float to the hash (converted to fixed-point for determinism)
+     * @param value - Float value to hash
+     * @returns this (for chaining)
+     */
+    addFloat(value) {
+        // Convert to fixed-point integer for determinism across browsers
+        const fixed = Math.round(value * StateHasher.FLOAT_PRECISION);
+        return this.addInt(fixed);
+    }
+    /**
+     * Add a string to the hash
+     * @param value - String value to hash
+     * @returns this (for chaining)
+     */
+    addString(value) {
+        for (let i = 0; i < value.length; i++) {
+            this.hash ^= BigInt(value.charCodeAt(i));
+            this.hash *= StateHasher.FNV_PRIME;
+        }
+        // Add null terminator for safety
+        this.hash ^= 0n;
+        this.hash *= StateHasher.FNV_PRIME;
+        return this;
+    }
+    /**
+     * Add a boolean to the hash
+     * @param value - Boolean value to hash
+     * @returns this (for chaining)
+     */
+    addBool(value) {
+        this.hash ^= value ? 1n : 0n;
+        this.hash *= StateHasher.FNV_PRIME;
+        return this;
+    }
+    /**
+     * Add multiple integers (useful for arrays)
+     * @param values - Array of integers to hash
+     * @returns this (for chaining)
+     */
+    addIntArray(values) {
+        this.addInt(values.length);
+        for (const v of values) {
+            this.addInt(v);
+        }
+        return this;
+    }
+    /**
+     * Add multiple floats (useful for positions, etc.)
+     * @param values - Array of floats to hash
+     * @returns this (for chaining)
+     */
+    addFloatArray(values) {
+        this.addInt(values.length);
+        for (const v of values) {
+            this.addFloat(v);
+        }
+        return this;
+    }
+    /**
+     * Finalize and get the hash as a hex string
+     * @returns 8-character hex string (32-bit hash)
+     */
+    finalize() {
+        // Mask to 32 bits for consistent output
+        const masked = this.hash & 0xffffffffn;
+        return masked.toString(16).padStart(8, '0');
+    }
+    /**
+     * Reset hasher to initial state (for reuse)
+     * @returns this (for chaining)
+     */
+    reset() {
+        this.hash = StateHasher.FNV_OFFSET;
+        return this;
+    }
+    /**
+     * Create a new hasher (static factory)
+     * @returns New StateHasher instance
+     */
+    static create() {
+        return new StateHasher();
+    }
+}
+//# sourceMappingURL=StateHasher.js.map

package/dist/StateHasher.js.map

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

package/dist/auth/AuthManager.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Phalanx Auth Manager
+ *
+ * Central manager for OAuth authentication.
+ * Handles auth state lifecycle, coordinates adapters, manages token refresh,
+ * and persists sessions to storage.
+ */
+import type { AuthResult, AuthState, AuthUser, CallbackParams, DiscordOAuthConfig, GoogleOAuthConfig, LoginOptions, SteamAuthConfig } from './types.js';
+import type { AuthStorage } from './storage.js';
+/**
+ * Configuration for AuthManager.
+ */
+export interface AuthManagerConfig {
+    /** OAuth provider to use */
+    provider: 'google' | 'discord' | 'steam';
+    /** Google OAuth configuration (required if provider is 'google') */
+    google?: GoogleOAuthConfig;
+    /** Discord OAuth configuration (required if provider is 'discord') */
+    discord?: DiscordOAuthConfig;
+    /** Steam auth configuration (required if provider is 'steam') */
+    steam?: SteamAuthConfig;
+    /** Auto-refresh tokens before expiry (default: true) */
+    autoRefresh?: boolean;
+    /** Refresh tokens this many ms before expiry (default: 60000 = 1 minute) */
+    refreshBeforeExpiryMs?: number;
+    /** Storage key prefix (default: 'phalanx_auth') */
+    storageKey?: string;
+    /** Custom storage implementation */
+    storage?: AuthStorage;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Callback when auth state changes */
+    onAuthStateChange?: (state: AuthState) => void;
+    /** Callback when token is refreshed */
+    onTokenRefresh?: (newToken: string) => void;
+    /** Callback when auth error occurs */
+    onAuthError?: (error: Error) => void;
+}
+/**
+ * Main authentication manager.
+ *
+ * Provides a simple API for OAuth authentication with automatic
+ * token refresh, session persistence, and state management.
+ *
+ * @example
+ * ```typescript
+ * const auth = new AuthManager({
+ *   provider: 'google',
+ *   google: {
+ *     clientId: 'your-client-id.apps.googleusercontent.com'
+ *   },
+ *   onAuthStateChange: (state) => {
+ *     console.log('Auth state changed:', state);
+ *   }
+ * });
+ *
+ * // Check for existing session on app startup
+ * const hasSession = await auth.checkSession();
+ *
+ * if (!hasSession) {
+ *   // Redirect to login
+ *   auth.login();
+ *   // Or use popup
+ *   const result = await auth.loginWithPopup();
+ * }
+ *
+ * // Get token for Phalanx client
+ * const token = auth.getToken();
+ * ```
+ */
+export declare class AuthManager {
+    private adapter;
+    private storage;
+    private config;
+    private state;
+    private refreshTimer?;
+    /**
+     * Create a new AuthManager.
+     * @param config - Auth manager configuration
+     */
+    constructor(config: AuthManagerConfig);
+    /**
+     * Check for existing session and restore it.
+     * Call this on app startup to restore user session.
+     *
+     * @returns True if a valid session was restored
+     */
+    checkSession(): Promise<boolean>;
+    /**
+     * Start login flow using redirect.
+     * User will be redirected to the OAuth provider.
+     *
+     * @param options - Optional login options
+     */
+    login(options?: LoginOptions): void;
+    /**
+     * Prepare PKCE and redirect to OAuth provider.
+     */
+    private prepareAndRedirect;
+    /**
+     * Start login flow using popup.
+     * Better UX as user stays on the game page.
+     *
+     * @param options - Optional login options
+     * @returns Auth result after popup flow completes
+     */
+    loginWithPopup(options?: LoginOptions): Promise<AuthResult>;
+    /**
+     * Handle OAuth callback.
+     * Call this on your callback page.
+     *
+     * @param params - Callback parameters (parsed from URL if not provided)
+     * @returns Auth result
+     */
+    handleCallback(params?: CallbackParams): Promise<AuthResult>;
+    /**
+     * Logout and clear session.
+     * Optionally revokes the token with the provider.
+     */
+    logout(): Promise<void>;
+    /**
+     * Get current auth state.
+     * @returns Copy of current auth state
+     */
+    getState(): AuthState;
+    /**
+     * Get current token (for Phalanx client).
+     * @returns Current auth token or null
+     */
+    getToken(): string | null;
+    /**
+     * Check if user is authenticated.
+     * @returns True if user is authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Get current user info.
+     * @returns User info or null
+     */
+    getUser(): AuthUser | null;
+    /**
+     * Get the OAuth provider name.
+     * @returns Provider name
+     */
+    getProvider(): string;
+    /**
+     * Manually refresh the current token.
+     * @returns True if refresh was successful
+     */
+    refreshToken(): Promise<boolean>;
+    /**
+     * Get the login URL without redirecting.
+     * Useful for custom login UI.
+     *
+     * @param options - Optional login options
+     * @returns Authorization URL
+     */
+    getLoginUrl(options?: LoginOptions): string;
+    /**
+     * Create the appropriate adapter based on configuration.
+     */
+    private createAdapter;
+    /**
+     * Handle successful authentication.
+     */
+    private handleAuthSuccess;
+    /**
+     * Schedule automatic token refresh.
+     */
+    private scheduleTokenRefresh;
+    /**
+     * Update state and notify listeners.
+     */
+    private updateState;
+    /**
+     * Get initial auth state.
+     */
+    private getInitialState;
+    /**
+     * Parse OAuth callback parameters from current URL.
+     */
+    private parseCallbackFromUrl;
+    /**
+     * Log debug message if debug mode is enabled.
+     */
+    private log;
+}
+//# sourceMappingURL=AuthManager.d.ts.map

package/dist/auth/AuthManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthManager.d.ts","sourceRoot":"","sources":["../../src/auth/AuthManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAEV,UAAU,EACV,SAAS,EACT,QAAQ,EACR,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EAEhB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQhD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IAEzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAE3B,sEAAsE;IACtE,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAE7B,iEAAiE;IACjE,KAAK,CAAC,EAAE,eAAe,CAAC;IAExB,wDAAwD;IACxD,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,4EAA4E;IAC5E,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,oCAAoC;IACpC,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAE/C,uCAAuC;IACvC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5C,sCAAsC;IACtC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACtC;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,YAAY,CAAC,CAAgC;IAErD;;;OAGG;gBACS,MAAM,EAAE,iBAAiB;IAoBrC;;;;;OAKG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAgDtC;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAOnC;;OAEG;YACW,kBAAkB;IAgBhC;;;;;;OAMG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAuEjE;;;;;;OAMG;IACG,cAAc,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAyBlE;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B7B;;;OAGG;IACH,QAAQ,IAAI,SAAS;IAIrB;;;OAGG;IACH,QAAQ,IAAI,MAAM,GAAG,IAAI;IAIzB;;;OAGG;IACH,eAAe,IAAI,OAAO;IAI1B;;;OAGG;IACH,OAAO,IAAI,QAAQ,GAAG,IAAI;IAI1B;;;OAGG;IACH,WAAW,IAAI,MAAM;IAIrB;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAmBtC;;;;;;OAMG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM;IAQ3C;;OAEG;IACH,OAAO,CAAC,aAAa;IA6BrB;;OAEG;YACW,iBAAiB;IAsC/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA+B5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ"}