pulse-js-framework 1.10.4 → 1.11.1

package/loader/webpack-loader-server-components.js

@@ -0,0 +1,356 @@
+/**
+ * Pulse Server Components - Webpack Loader Extension
+ *
+ * Extends webpack-loader.js with Server Components support:
+ * - Detects Client Components via __directive metadata
+ * - Generates client manifest (component ID → chunk URL mapping)
+ * - Writes manifest to filesystem
+ *
+ * Usage in webpack.config.js:
+ * ```js
+ * const { addServerComponentsSupport } = require('pulse-js-framework/loader/webpack-loader-server-components');
+ *
+ * module.exports = {
+ *   module: {
+ *     rules: [
+ *       {
+ *         test: /\.pulse$/,
+ *         use: [
+ *           'style-loader',
+ *           'css-loader',
+ *           'pulse-js-framework/loader/webpack-loader'
+ *         ]
+ *       }
+ *     ]
+ *   },
+ *   plugins: [
+ *     addServerComponentsSupport({
+ *       manifestPath: 'dist/.pulse-manifest.json'
+ *     })
+ *   ]
+ * };
+ * ```
+ *
+ * @module pulse-js-framework/loader/webpack-loader-server-components
+ */
+
+import { writeFileSync, mkdirSync } from 'fs';
+import { dirname, posix, relative } from 'path';
+import { getComponentTypeFromSource } from '../compiler/directives.js';
+
+/**
+ * Default options for Server Components Webpack plugin
+ */
+const DEFAULT_OPTIONS = {
+  // Output directory for client manifest
+  manifestPath: 'dist/.pulse-manifest.json',
+
+  // Public base path for chunk URLs (empty for relative paths)
+  base: '',
+
+  // Custom manifest filename
+  manifestFilename: '.pulse-manifest.json'
+};
+
+/**
+ * Storage for Client Components per compilation
+ * WeakMap<Compilation, Map<componentId, { file, chunk }>>
+ */
+const compilationClientComponents = new WeakMap();
+
+/**
+ * Get or create Client Components map for a compilation
+ */
+function getClientComponentsMap(compilation) {
+  if (!compilationClientComponents.has(compilation)) {
+    compilationClientComponents.set(compilation, new Map());
+  }
+  return compilationClientComponents.get(compilation);
+}
+
+/**
+ * Webpack plugin for Pulse Server Components support
+ */
+class PulseServerComponentsPlugin {
+  constructor(options = {}) {
+    this.options = { ...DEFAULT_OPTIONS, ...options };
+  }
+
+  apply(compiler) {
+    const pluginName = 'PulseServerComponentsPlugin';
+
+    compiler.hooks.thisCompilation.tap(pluginName, (compilation) => {
+      const clientComponents = getClientComponentsMap(compilation);
+      const componentTypes = new Map(); // module.resource → 'client' | 'server' | 'shared'
+
+      // Hook into module processing to detect Client Components and track types
+      compilation.hooks.succeedModule.tap(pluginName, (module) => {
+        if (!module.resource) return;
+
+        // Get the compiled source
+        const source = module._source?.source?.();
+        if (!source || typeof source !== 'string') {
+          return;
+        }
+
+        // Determine component type for all JS/TS files
+        if (/\.(js|ts|jsx|tsx|pulse)$/.test(module.resource)) {
+          const componentType = getComponentTypeFromSource(source, module.resource);
+          componentTypes.set(module.resource, componentType);
+        }
+
+        // Only process .pulse files for Client Component detection
+        if (!module.resource.endsWith('.pulse')) {
+          return;
+        }
+
+        // Check if this module exports a Client Component
+        // Look for: __directive: "use client"
+        const directiveMatch = source.match(/__directive:\s*["']use client["']/);
+
+        if (directiveMatch) {
+          // Extract component ID
+          const componentIdMatch = source.match(/__componentId:\s*["'](\w+)["']/);
+          const exportMatch = source.match(/export const (\w+) = \{/);
+
+          const componentId = componentIdMatch ? componentIdMatch[1] : (exportMatch ? exportMatch[1] : null);
+
+          if (componentId) {
+            // Store this as a Client Component
+            clientComponents.set(componentId, {
+              file: module.resource,
+              chunk: null, // Will be filled later
+              moduleId: module.id
+            });
+
+            const relativePath = relative(process.cwd(), module.resource);
+            console.log(`[Pulse Server Components] Detected Client Component: ${componentId} (${relativePath})`);
+          }
+        }
+      });
+
+      // Validate imports after module graph is built
+      compilation.hooks.finishModules.tap(pluginName, (modules) => {
+        for (const module of modules) {
+          if (!module.resource) continue;
+
+          const moduleType = componentTypes.get(module.resource);
+          if (moduleType !== 'client') continue;
+
+          // Check all dependencies
+          for (const dependency of module.dependencies || []) {
+            const depModule = compilation.moduleGraph?.getModule?.(dependency);
+            if (!depModule || !depModule.resource) continue;
+
+            const depType = componentTypes.get(depModule.resource);
+
+            // Client → Server violation
+            if (depType === 'server') {
+              const error = new Error(createImportViolationError(
+                module.resource,
+                depModule.resource,
+                dependency.userRequest || depModule.resource
+              ));
+              compilation.errors.push(error);
+            }
+          }
+        }
+      });
+
+      // Generate manifest after all assets are processed
+      compilation.hooks.processAssets.tap(
+        {
+          name: pluginName,
+          stage: compilation.PROCESS_ASSETS_STAGE_OPTIMIZE_INLINE
+        },
+        (assets) => {
+          // Skip if no Client Components detected
+          if (clientComponents.size === 0) {
+            return;
+          }
+
+          // Map modules to their chunks
+          for (const [componentId, info] of clientComponents.entries()) {
+            // Find chunk(s) containing this module
+            for (const chunk of compilation.chunks) {
+              for (const module of compilation.chunkGraph.getChunkModulesIterable(chunk)) {
+                if (module.resource === info.file) {
+                  // Get chunk filename
+                  const chunkFiles = Array.from(chunk.files);
+                  const jsFile = chunkFiles.find(f => f.endsWith('.js'));
+
+                  if (jsFile) {
+                    info.chunk = jsFile;
+                    console.log(`[Pulse Server Components] Mapped ${componentId} → ${jsFile}`);
+                  }
+                  break;
+                }
+              }
+            }
+          }
+
+          // Build client manifest
+          const manifest = {
+            version: '1.0',
+            components: {}
+          };
+
+          for (const [componentId, info] of clientComponents.entries()) {
+            if (info.chunk) {
+              const base = this.options.base || '';
+              const chunkUrl = posix.join(base, info.chunk);
+
+              manifest.components[componentId] = {
+                id: componentId,
+                chunk: chunkUrl,
+                exports: ['default', componentId]
+              };
+            }
+          }
+
+          // Emit manifest as asset
+          const manifestJson = JSON.stringify(manifest, null, 2);
+          const { RawSource } = compilation.compiler.webpack.sources;
+
+          compilation.emitAsset(
+            this.options.manifestFilename,
+            new RawSource(manifestJson)
+          );
+
+          console.log(`[Pulse Server Components] Generated client manifest with ${clientComponents.size} components`);
+        }
+      );
+
+      // Write manifest to filesystem after emit
+      compilation.hooks.afterProcessAssets.tap(pluginName, () => {
+        if (clientComponents.size === 0) {
+          return;
+        }
+
+        // Build manifest object
+        const manifest = {
+          version: '1.0',
+          components: {}
+        };
+
+        for (const [componentId, info] of clientComponents.entries()) {
+          if (info.chunk) {
+            const base = this.options.base || '';
+            const chunkUrl = posix.join(base, info.chunk);
+
+            manifest.components[componentId] = {
+              id: componentId,
+              chunk: chunkUrl,
+              exports: ['default', componentId]
+            };
+          }
+        }
+
+        // Write to file system
+        if (this.options.manifestPath) {
+          try {
+            const manifestDir = dirname(this.options.manifestPath);
+            mkdirSync(manifestDir, { recursive: true });
+            writeFileSync(this.options.manifestPath, JSON.stringify(manifest, null, 2), 'utf-8');
+            console.log(`[Pulse Server Components] Manifest written to ${this.options.manifestPath}`);
+          } catch (error) {
+            console.warn(`[Pulse Server Components] Failed to write manifest: ${error.message}`);
+          }
+        }
+      });
+    });
+  }
+}
+
+// ============================================================================
+// Helper Functions
+// ============================================================================
+
+/**
+ * Create import violation error message
+ * @param {string} clientPath - Client Component path
+ * @param {string} serverPath - Server Component path
+ * @param {string} importSource - Import statement source
+ * @returns {string} Error message
+ */
+function createImportViolationError(clientPath, serverPath, importSource) {
+  const clientRelative = relative(process.cwd(), clientPath);
+  const serverRelative = relative(process.cwd(), serverPath);
+
+  return `
+[Pulse] Import Violation: Client Component cannot import Server Component
+  at ${clientRelative}
+  importing ${importSource}
+  resolved to ${serverRelative}
+
+  Client Components can only import:
+  • Other Client Components ('use client')
+  • Shared utilities (no directive)
+  • Third-party packages
+
+  → Move shared logic to a Client Component
+  → Use Server Actions for server-side operations
+  → Create a wrapper Client Component that calls Server Actions
+
+  See: https://pulse-js.fr/server-components#import-rules
+  `.trim();
+}
+
+/**
+ * Helper function to add Server Components support to Webpack config
+ *
+ * @param {Object} options - Plugin options
+ * @returns {PulseServerComponentsPlugin} Webpack plugin instance
+ *
+ * @example
+ * const { addServerComponentsSupport } = require('pulse-js-framework/loader/webpack-loader-server-components');
+ *
+ * module.exports = {
+ *   plugins: [
+ *     addServerComponentsSupport({ manifestPath: 'dist/.pulse-manifest.json' })
+ *   ]
+ * };
+ */
+export function addServerComponentsSupport(options = {}) {
+  return new PulseServerComponentsPlugin(options);
+}
+
+/**
+ * Helper function to load client manifest (for SSR)
+ *
+ * @param {string} manifestPath - Path to manifest file
+ * @returns {Object} Client manifest
+ */
+export function loadClientManifest(manifestPath) {
+  try {
+    const { readFileSync } = require('fs');
+    const content = readFileSync(manifestPath, 'utf-8');
+    return JSON.parse(content);
+  } catch (error) {
+    console.warn(`Failed to load client manifest from ${manifestPath}:`, error.message);
+    return { version: '1.0', components: {} };
+  }
+}
+
+/**
+ * Helper function to get client component chunk URL
+ *
+ * @param {Object} manifest - Client manifest
+ * @param {string} componentId - Component ID
+ * @returns {string|null} Chunk URL or null if not found
+ */
+export function getComponentChunk(manifest, componentId) {
+  return manifest.components[componentId]?.chunk || null;
+}
+
+/**
+ * Helper function to get all client component IDs
+ *
+ * @param {Object} manifest - Client manifest
+ * @returns {Set<string>} Set of component IDs
+ */
+export function getClientComponentIds(manifest) {
+  return new Set(Object.keys(manifest.components));
+}
+
+export default PulseServerComponentsPlugin;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pulse-js-framework",
-  "version": "1.10.4",
+  "version": "1.11.1",
   "description": "A declarative DOM framework with CSS selector-based structure and reactive pulsations",
   "type": "module",
   "sideEffects": false,
@@ -90,13 +90,24 @@
     "./compiler/parser": "./compiler/parser.js",
     "./compiler/transformer": "./compiler/transformer.js",
     "./compiler/preprocessor": "./compiler/preprocessor.js",
+    "./runtime/context": {
+      "types": "./types/context.d.ts",
+      "default": "./runtime/context.js"
+    },
+    "./runtime/errors": {
+      "types": "./types/errors.d.ts",
+      "default": "./runtime/errors.js"
+    },
     "./core/errors": "./runtime/errors.js",
     "./vite": {
       "types": "./types/index.d.ts",
       "default": "./loader/vite-plugin.js"
     },
+    "./vite/server-components": "./loader/vite-plugin-server-components.js",
     "./webpack": "./loader/webpack-loader.js",
+    "./webpack/server-components": "./loader/webpack-loader-server-components.js",
     "./rollup": "./loader/rollup-plugin.js",
+    "./rollup/server-components": "./loader/rollup-plugin-server-components.js",
     "./esbuild": "./loader/esbuild-plugin.js",
     "./parcel": "./loader/parcel-plugin.js",
     "./swc": "./loader/swc-plugin.js",
@@ -105,6 +116,7 @@
     "./runtime/ssr-stream": "./runtime/ssr-stream.js",
     "./runtime/ssr-mismatch": "./runtime/ssr-mismatch.js",
     "./runtime/ssr-preload": "./runtime/ssr-preload.js",
+    "./runtime/server-components": "./runtime/server-components/index.js",
     "./server": "./server/index.js",
     "./server/express": "./server/express.js",
     "./server/hono": "./server/hono.js",
@@ -135,7 +147,6 @@
   "files": [
     "index.js",
     "cli/",
-    "core/",
     "runtime/",
     "compiler/",
     "loader/",
@@ -147,108 +158,139 @@
     "LICENSE"
   ],
   "scripts": {
-    "test": "node scripts/run-all-tests.js",
+    "bench": "node benchmarks/index.js",
+    "bench:json": "node benchmarks/index.js --json",
+    "build:netlify": "node scripts/build-netlify.js",
+    "docs": "node cli/index.js dev docs",
+    "test": "node scripts/sync-tests.js --fix && node scripts/run-all-tests.js",
+    "test:a11y": "node test/a11y.test.js",
+    "test:a11y-enhanced": "node test/a11y-enhanced.test.js",
+    "test:a11y-focus-coverage-boost": "node --test test/a11y-focus-coverage-boost.test.js",
+    "test:a11y-widgets-coverage-boost": "node --test test/a11y-widgets-coverage-boost.test.js",
+    "test:analyze": "node test/analyze.test.js",
+    "test:animation": "node --test test/animation.test.js",
+    "test:async": "node test/async.test.js",
+    "test:async-coverage": "node test/async-coverage.test.js",
+    "test:benchmarks": "node test/benchmarks.test.js",
+    "test:build": "node test/build.test.js",
+    "test:build-extended": "node --test test/build-extended.test.js",
+    "test:cli": "node test/cli.test.js",
+    "test:cli-create": "node test/cli-create.test.js",
+    "test:cli-help": "node --test test/cli-help.test.js",
+    "test:cli-logger": "node --test test/cli-logger.test.js",
+    "test:cli-mobile": "node --test test/cli-mobile.test.js",
+    "test:cli-release": "node --test test/cli-release.test.js",
+    "test:cli-ui": "node test/cli-ui.test.js",
     "test:compiler": "node test/compiler.test.js",
-    "test:parser-coverage": "node test/parser-coverage.test.js",
-    "test:sourcemap": "node test/sourcemap.test.js",
-    "test:sourcemap-coverage-boost": "node --test test/sourcemap-coverage-boost.test.js",
+    "test:context": "node test/context.test.js",
+    "test:context-stress": "node test/context-stress.test.js",
     "test:css-parsing": "node test/css-parsing.test.js",
-    "test:preprocessor": "node test/preprocessor.test.js",
-    "test:pulse": "node test/pulse.test.js",
+    "test:dev-server": "node --test test/dev-server.test.js",
+    "test:devtools": "node test/devtools.test.js",
+    "test:docs": "node test/docs.test.js",
+    "test:docs-nav": "node test/docs-navigation.test.js",
+    "test:docs-navigation": "node test/docs-navigation.test.js",
+    "test:doctor": "node test/doctor.test.js",
     "test:dom": "node test/dom.test.js",
+    "test:dom-adapter": "node test/dom-adapter.test.js",
+    "test:dom-advanced": "node test/dom-advanced.test.js",
+    "test:dom-binding": "node test/dom-binding.test.js",
+    "test:dom-conditional": "node test/dom-conditional.test.js",
     "test:dom-element": "node test/dom-element.test.js",
     "test:dom-element-coverage-boost": "node --test test/dom-element-coverage-boost.test.js",
-    "test:dom-list": "node test/dom-list.test.js",
-    "test:dom-conditional": "node test/dom-conditional.test.js",
+    "test:dom-event-delegate": "node test/dom-event-delegate.test.js",
     "test:dom-lifecycle": "node test/dom-lifecycle.test.js",
+    "test:dom-list": "node test/dom-list.test.js",
+    "test:dom-recycle": "node test/dom-recycle.test.js",
     "test:dom-selector": "node test/dom-selector.test.js",
-    "test:dom-adapter": "node test/dom-adapter.test.js",
-    "test:dom-advanced": "node test/dom-advanced.test.js",
+    "test:dom-virtual-list": "node test/dom-virtual-list.test.js",
     "test:enhanced-mock-adapter": "node test/enhanced-mock-adapter.test.js",
-    "test:router": "node test/router.test.js",
-    "test:store": "node test/store.test.js",
-    "test:context": "node test/context.test.js",
-    "test:hmr": "node test/hmr.test.js",
-    "test:hmr-coverage-boost": "node --test test/hmr-coverage-boost.test.js",
-    "test:lint": "node test/lint.test.js",
-    "test:format": "node test/format.test.js",
-    "test:analyze": "node test/analyze.test.js",
-    "test:cli": "node test/cli.test.js",
-    "test:cli-ui": "node test/cli-ui.test.js",
-    "test:cli-create": "node test/cli-create.test.js",
-    "test:lru-cache": "node test/lru-cache.test.js",
-    "test:utils": "node test/utils.test.js",
-    "test:utils-coverage": "node test/utils-coverage.test.js",
-    "test:docs": "node test/docs.test.js",
-    "test:docs-nav": "node test/docs-navigation.test.js",
-    "test:async": "node test/async.test.js",
-    "test:async-coverage": "node test/async-coverage.test.js",
+    "test:error-sanitizer": "node --test test/error-sanitizer.test.js",
+    "test:errors": "node test/errors.test.js",
+    "test:esbuild-plugin": "node test/esbuild-plugin.test.js",
     "test:form": "node test/form.test.js",
+    "test:form-coverage": "node test/form-coverage.test.js",
+    "test:form-edge-cases": "node test/form-edge-cases.test.js",
     "test:form-v2": "node test/form-v2.test.js",
-    "test:http": "node test/http.test.js",
-    "test:devtools": "node test/devtools.test.js",
-    "test:native": "node test/native.test.js",
-    "test:native-coverage-boost": "node --test test/native-coverage-boost.test.js",
-    "test:a11y": "node test/a11y.test.js",
-    "test:a11y-enhanced": "node test/a11y-enhanced.test.js",
-    "test:a11y-widgets-coverage-boost": "node --test test/a11y-widgets-coverage-boost.test.js",
-    "test:a11y-focus-coverage-boost": "node --test test/a11y-focus-coverage-boost.test.js",
-    "test:logger": "node test/logger.test.js",
-    "test:logger-prod": "node test/logger-prod.test.js",
-    "test:logger-coverage-boost": "node --test test/logger-coverage-boost.test.js",
-    "test:errors": "node test/errors.test.js",
-    "test:security": "node test/security.test.js",
-    "test:security-coverage-boost": "node --test test/security-coverage-boost.test.js",
-    "test:websocket": "node test/websocket.test.js",
-    "test:websocket-coverage-boost": "node --test test/websocket-coverage-boost.test.js",
+    "test:format": "node test/format.test.js",
     "test:graphql": "node test/graphql.test.js",
     "test:graphql-coverage": "node test/graphql-coverage.test.js",
-    "test:doctor": "node test/doctor.test.js",
-    "test:scaffold": "node test/scaffold.test.js",
-    "test:test-runner": "node test/test-runner.test.js",
-    "test:build": "node test/build.test.js",
-    "test:integration": "node test/integration.test.js",
-    "test:context-stress": "node test/context-stress.test.js",
-    "test:form-edge-cases": "node test/form-edge-cases.test.js",
-    "test:form-coverage": "node test/form-coverage.test.js",
     "test:graphql-subscriptions": "node test/graphql-subscriptions.test.js",
     "test:graphql-subscriptions-coverage-boost": "node --test test/graphql-subscriptions-coverage-boost.test.js",
+    "test:hmr": "node test/hmr.test.js",
+    "test:hmr-coverage-boost": "node --test test/hmr-coverage-boost.test.js",
+    "test:http": "node test/http.test.js",
     "test:http-edge-cases": "node test/http-edge-cases.test.js",
+    "test:i18n": "node --test test/i18n.test.js",
+    "test:integration": "node test/integration.test.js",
     "test:integration-advanced": "node test/integration-advanced.test.js",
-    "test:websocket-stress": "node test/websocket-stress.test.js",
-    "test:ssr": "node test/ssr.test.js",
-    "test:ssr-hydrator": "node test/ssr-hydrator.test.js",
-    "test:webpack-loader": "node test/webpack-loader.test.js",
-    "test:rollup-plugin": "node test/rollup-plugin.test.js",
-    "test:esbuild-plugin": "node test/esbuild-plugin.test.js",
-    "test:parcel-plugin": "node test/parcel-plugin.test.js",
-    "test:swc-plugin": "node test/swc-plugin.test.js",
-    "test:dom-recycle": "node test/dom-recycle.test.js",
-    "test:dom-virtual-list": "node test/dom-virtual-list.test.js",
-    "test:dom-event-delegate": "node test/dom-event-delegate.test.js",
-    "test:dom-binding": "node test/dom-binding.test.js",
     "test:interceptor-manager": "node test/interceptor-manager.test.js",
-    "test:vite-plugin": "node --test test/vite-plugin.test.js",
+    "test:lint": "node test/lint.test.js",
+    "test:lite": "node test/lite.test.js",
+    "test:logger": "node test/logger.test.js",
+    "test:logger-coverage-boost": "node --test test/logger-coverage-boost.test.js",
+    "test:logger-prod": "node test/logger-prod.test.js",
+    "test:lru-cache": "node test/lru-cache.test.js",
     "test:memory-cleanup": "node --test test/memory-cleanup.test.js",
-    "test:sse": "node --test test/sse.test.js",
+    "test:mutex": "node --test test/mutex.test.js",
+    "test:native": "node test/native.test.js",
+    "test:native-coverage-boost": "node --test test/native-coverage-boost.test.js",
+    "test:parcel-plugin": "node test/parcel-plugin.test.js",
+    "test:path-sanitizer": "node --test test/path-sanitizer.test.js",
+    "test:parser-coverage": "node test/parser-coverage.test.js",
     "test:persistence": "node --test test/persistence.test.js",
     "test:persistence-coverage-boost": "node --test test/persistence-coverage-boost.test.js",
-    "test:i18n": "node --test test/i18n.test.js",
     "test:portal": "node --test test/portal.test.js",
-    "test:animation": "node --test test/animation.test.js",
-    "test:sw": "node --test test/sw.test.js",
-    "test:dev-server": "node --test test/dev-server.test.js",
-    "test:ssr-stream": "node --test test/ssr-stream.test.js",
+    "test:preprocessor": "node test/preprocessor.test.js",
+    "test:pulse": "node test/pulse.test.js",
+    "test:rollup-plugin": "node test/rollup-plugin.test.js",
+    "test:router": "node test/router.test.js",
+    "test:router-psc": "node --test test/router-psc-integration.test.js",
+    "test:router-psc-integration": "node test/router-psc-integration.test.js",
+    "test:scaffold": "node test/scaffold.test.js",
+    "test:security": "node test/security.test.js",
+    "test:security-coverage-boost": "node --test test/security-coverage-boost.test.js",
+    "test:security-regression": "node test/security-regression.test.js",
+    "test:server-utils": "node --test test/server-utils.test.js",
+    "test:server-actions": "node --test test/server-actions.test.js",
+    "test:server-actions-client": "node --test test/server-actions-client.test.js",
+    "test:server-actions-server-extended": "node --test test/server-actions-server-extended.test.js",
+    "test:server-adapters": "node --test test/server-adapters.test.js",
+    "test:server-components-build-tools": "node --test test/server-components-build-tools.test.js",
+    "test:server-components-client": "node --test test/server-components-client.test.js",
+    "test:server-components-compiler": "node --test test/server-components-compiler.test.js",
+    "test:server-components-core": "node --test test/server-components-core.test.js",
+    "test:server-components-csrf": "node --test test/server-components-csrf.test.js",
+    "test:server-components-ratelimit": "node --test test/server-components-ratelimit.test.js",
+    "test:server-components-ratelimit-extended": "node --test test/server-components-ratelimit-extended.test.js",
+    "test:server-components-security": "node --test test/server-components-security.test.js",
+    "test:server-components-security-comprehensive": "node --test test/server-components-security-comprehensive.test.js",
+    "test:server-components-serializer": "node --test test/server-components-serializer.test.js",
+    "test:server-components-validation": "node --test test/server-components-validation.test.js",
+    "test:sourcemap": "node test/sourcemap.test.js",
+    "test:sourcemap-coverage-boost": "node --test test/sourcemap-coverage-boost.test.js",
+    "test:sse": "node --test test/sse.test.js",
+    "test:ssg": "node --test test/ssg.test.js",
+    "test:ssr": "node test/ssr.test.js",
+    "test:ssr-directives": "node --test test/ssr-directives.test.js",
+    "test:ssr-hydrator": "node test/ssr-hydrator.test.js",
     "test:ssr-mismatch": "node --test test/ssr-mismatch.test.js",
     "test:ssr-preload": "node --test test/ssr-preload.test.js",
-    "test:ssr-directives": "node --test test/ssr-directives.test.js",
-    "test:ssg": "node --test test/ssg.test.js",
-    "test:server-adapters": "node --test test/server-adapters.test.js",
-    "bench": "node benchmarks/index.js",
-    "bench:json": "node benchmarks/index.js --json",
-    "build:netlify": "node scripts/build-netlify.js",
-    "version": "node scripts/sync-version.js",
-    "docs": "node cli/index.js dev docs"
+    "test:ssr-stream": "node --test test/ssr-stream.test.js",
+    "test:store": "node test/store.test.js",
+    "test:sw": "node --test test/sw.test.js",
+    "test:swc-plugin": "node test/swc-plugin.test.js",
+    "test:sync": "node scripts/sync-tests.js",
+    "test:sync:fix": "node scripts/sync-tests.js --fix",
+    "test:test-runner": "node test/test-runner.test.js",
+    "test:utils": "node test/utils.test.js",
+    "test:utils-coverage": "node test/utils-coverage.test.js",
+    "test:vite-plugin": "node --test test/vite-plugin.test.js",
+    "test:webpack-loader": "node test/webpack-loader.test.js",
+    "test:websocket": "node test/websocket.test.js",
+    "test:websocket-coverage-boost": "node --test test/websocket-coverage-boost.test.js",
+    "test:websocket-stress": "node test/websocket-stress.test.js",
+    "version": "node scripts/sync-version.js"
   },
   "keywords": [
     "framework",
@@ -275,7 +317,7 @@
     "url": "https://github.com/vincenthirtz/pulse-js-framework/issues"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "dependencies": {},
   "devDependencies": {}

package/runtime/async.js

@@ -795,6 +795,10 @@ export function usePolling(asyncFn, options) {
     onError
   } = options;
 
+  if (!interval || typeof interval !== 'number' || interval <= 0) {
+    throw new Error('usePolling: options.interval must be a positive number (milliseconds)');
+  }
+
   const data = pulse(null);
   const error = pulse(null);
   const isPolling = pulse(false);