@series-inc/rundot-game-sdk 5.0.0

package/dist/vite/index.css

@@ -0,0 +1,19 @@
+/* raw-loader:/home/cooper/venus-sdk/packages/api/src/vite/sandboxToolbarStyle.css */
+input[style*="background: rgba(0, 0, 0, 0.2)"],
+select[style*="background: rgba(0, 0, 0, 0.2)"] {
+  box-sizing: border-box;
+}
+input[style*="background: rgba(0, 0, 0, 0.2)"]:focus,
+select[style*="background: rgba(0, 0, 0, 0.2)"]:focus {
+  outline: none;
+  border-color: rgba(59, 130, 246, 0.5) !important;
+  box-shadow: 0 0 0 2px rgba(59, 130, 246, 0.1);
+}
+button[style*="background: #3B82F6"]:hover {
+  background: #2563EB !important;
+}
+button[style*="background: #3B82F6"]:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+/*# sourceMappingURL=index.css.map */

package/dist/vite/index.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["raw-loader:/home/cooper/venus-sdk/packages/api/src/vite/sandboxToolbarStyle.css"],"sourcesContent":["/* Minimal CSS - FAB uses inline styles only for guaranteed floating behavior */\n\n/* Optional: Override input styling for modal if needed */\ninput[style*=\"background: rgba(0, 0, 0, 0.2)\"],\nselect[style*=\"background: rgba(0, 0, 0, 0.2)\"] {\n  box-sizing: border-box;\n}\n\ninput[style*=\"background: rgba(0, 0, 0, 0.2)\"]:focus,\nselect[style*=\"background: rgba(0, 0, 0, 0.2)\"]:focus {\n  outline: none;\n  border-color: rgba(59, 130, 246, 0.5) !important;\n  box-shadow: 0 0 0 2px rgba(59, 130, 246, 0.1);\n}\n\nbutton[style*=\"background: #3B82F6\"]:hover {\n  background: #2563EB !important;\n}\n\nbutton[style*=\"background: #3B82F6\"]:disabled {\n  opacity: 0.5;\n  cursor: not-allowed;\n}\n"],"mappings":";AAGA,KAAK,CAAC;AACN,MAAM,CAAC;AACL,cAAY;AACd;AAEA,KAAK,CAAC,wCAAwC;AAC9C,MAAM,CAAC,wCAAwC;AAC7C,WAAS;AACT,gBAAc,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE;AACjC,cAAY,EAAE,EAAE,EAAE,IAAI,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE;AAC3C;AAEA,MAAM,CAAC,6BAA6B;AAClC,cAAY;AACd;AAEA,MAAM,CAAC,6BAA6B;AAClC,WAAS;AACT,UAAQ;AACV;","names":[]}

package/dist/vite/index.d.ts

@@ -0,0 +1,159 @@
+import { Plugin, ResolvedConfig } from 'vite';
+
+interface RundotGameLibrariesPluginOptions {
+    /**
+     * Your app name (used for CDN asset serving in dev mode)
+     * Optional - only needed if you have game assets in cdn/ folder
+     * Example: 'block-breakers', 'fortunes-22'
+     */
+    appName?: string;
+    /**
+     * Path to local cdn/ folder (relative to vite.config.ts)
+     * Defaults to './cdn'
+     */
+    cdnDir?: string;
+    /**
+     * Enable debug logging
+     * Defaults to false
+     */
+    debug?: boolean;
+}
+/**
+ * Vite plugin for RUN.game embedded libraries system.
+ *
+ * This plugin externalizes supported libraries (Phaser, React, Three.js, etc.)
+ * and loads them from the RUN.game host on mobile or CDN on web.
+ *
+ * By default, libraries are embedded for optimal bundle size.
+ * Set RUN.game_DISABLE_EMBEDDED_LIBS=true to bundle libraries for standalone export.
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import { rundotGameLibrariesPlugin } from '@series-inc/rundot-game-sdk/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     rundotGameLibrariesPlugin({
+ *       appName: 'my-game',
+ *       cdnDir: './cdn',
+ *     }),
+ *   ],
+ * });
+ * ```
+ *
+ * Default build: npm run build (embedded libraries)
+ * Standalone export: RUN.game_DISABLE_EMBEDDED_LIBS=true npm run build
+ */
+declare function rundotGameLibrariesPlugin(options?: RundotGameLibrariesPluginOptions): Plugin;
+
+declare function cdnPlugin(): {
+    name: string;
+    apply: string;
+    configResolved(resolvedConfig: ResolvedConfig): void;
+    closeBundle(): void;
+};
+
+/**
+ * Sandbox configuration helpers.
+ *
+ * Sandbox mode enables H5 apps to run in browser (via Vite) while communicating
+ * with the real Firebase backend.
+ *
+ * Authentication flow:
+ * 1. Vite plugin reads game.config.json and CLI config for environment
+ * 2. Firebase config is injected into page via window.__RUNDOT_GAME_SANDBOX__
+ * 3. User signs in with Google once (persisted in IndexedDB)
+ * 4. All API calls use Firebase Auth session automatically
+ */
+type SandboxTarget = 'local' | 'dev' | 'staging';
+/**
+ * Firebase configuration for a specific environment.
+ */
+interface SandboxFirebaseConfig {
+    apiKey: string;
+    authDomain: string;
+    projectId: string;
+    appId?: string;
+    storageBucket?: string;
+    messagingSenderId?: string;
+    measurementId?: string;
+}
+/**
+ * Configuration injected by the Vite dev server for sandbox mode.
+ */
+interface SandboxConfig {
+    /** Whether sandbox mode is enabled */
+    enabled: boolean;
+    /** Target environment: local (emulator), dev, or staging */
+    target: SandboxTarget;
+    /** Game/App ID from game.config.json */
+    gameId: string;
+    /** Firebase configuration for the target environment */
+    firebaseConfig?: SandboxFirebaseConfig;
+    /** Cloud Functions region */
+    functionsRegion?: string;
+    /**
+     * Base URL for backend RPC calls.
+     * For local: http://localhost:5001/{projectId}/{region}
+     * For dev/staging: Cloud Run proxy URL from CLI config
+     */
+    backendUrl?: string;
+    /** Emulator hosts for local development */
+    functionsEmulatorHost?: string;
+    firestoreEmulatorHost?: string;
+    authEmulatorHost?: string;
+    /** RPC configuration */
+    pollingInterval?: number;
+    rpcMaxRetries?: number;
+    rpcRetryDelayMs?: number;
+}
+/**
+ * Global interface for sandbox config injected by Vite
+ */
+declare global {
+    interface Window {
+        __RUNDOT_GAME_SANDBOX__?: SandboxConfig;
+        __RUNDOT_GAME_SANDBOX_SIGN_IN__?: () => Promise<void>;
+        __RUNDOT_GAME_SANDBOX_SIGN_OUT__?: () => Promise<void>;
+        __RUNDOT_GAME_SANDBOX_SIGN_IN_AS__?: (playerId: string) => Promise<void>;
+    }
+}
+
+/**
+ * Vite plugin for RUN.game sandbox mode.
+ *
+ * This plugin enables H5 apps to communicate with the real Firebase backend
+ * during local development. It:
+ * 1. Reads game.config.json for gameId
+ * 2. Reads ~/.rundot-game/config.json for target environment
+ * 3. Injects Firebase config and toolbar into the page
+ *
+ * Authentication is handled by the browser via Google sign-in (one-time,
+ * persisted in IndexedDB).
+ *
+ * Usage:
+ * ```typescript
+ * // vite.config.ts
+ * import { defineConfig } from 'vite'
+ * import { rundotGameSandboxPlugin } from '@series-inc/rundot-game-sdk/vite'
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     rundotGameSandboxPlugin(),
+ *   ],
+ * })
+ * ```
+ */
+
+interface RundotGameSandboxPluginOptions {
+    /** Override the target environment (default: 'staging', or reads from ~/.rundot-game/config.json) */
+    target?: SandboxTarget;
+    /** Game/App ID - required if game.config.json doesn't exist */
+    gameId?: string;
+    /** Disable sandbox even if configured */
+    disabled?: boolean;
+}
+declare function rundotGameSandboxPlugin(options?: RundotGameSandboxPluginOptions): Plugin;
+
+export { type RundotGameLibrariesPluginOptions, type RundotGameSandboxPluginOptions, cdnPlugin, rundotGameLibrariesPlugin, rundotGameSandboxPlugin };