@ripple-ts/vite-plugin 0.3.92 → 0.3.93

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @ripple-ts/vite-plugin
 
+## 0.3.93
+
+### Patch Changes
+
+- [`9db5a49`](https://github.com/Ripple-TS/ripple/commit/9db5a49e45c2eb3bb4f6b46c65c0aaf9016633ad)
+  Thanks [@leonidaz](https://github.com/leonidaz)! - Rename the `ripple/server`
+  helper exports to camelCase: `create_ssr_stream` is now `createStream` and
+  `get_css_for_hashes` is now `getCss` (returning the CSS text for the scoped
+  style hashes collected by `render()`). The old snake_case exports are removed;
+  update imports accordingly. The vite plugin consumes the new names internally.
+- Updated dependencies []:
+  - @ripple-ts/adapter@0.3.93
+
 ## 0.3.92
 
 ### Patch Changes

package/package.json

@@ -3,7 +3,7 @@
   "description": "Vite plugin for Ripple",
   "license": "MIT",
   "author": "Dominic Gannaway",
-  "version": "0.3.92",
+  "version": "0.3.93",
   "type": "module",
   "module": "src/index.js",
   "main": "src/index.js",
@@ -32,14 +32,14 @@
     "url": "https://github.com/Ripple-TS/ripple/issues"
   },
   "dependencies": {
-    "@ripple-ts/adapter": "0.3.92",
+    "@ripple-ts/adapter": "0.3.93",
     "@tsrx/ripple": "0.1.38"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
     "type-fest": "^5.6.0",
     "vite": "^8.0.12",
-    "ripple": "0.3.92"
+    "ripple": "0.3.93"
   },
   "publishConfig": {
     "access": "public"

package/src/server/render-route.js

@@ -41,8 +41,7 @@ export async function handleRenderRoute(route, context, vite, rippleConfig) {
 		}
 
 		// Load ripple server utilities
-		const { render, get_css_for_hashes, create_ssr_stream } =
-			await vite.ssrLoadModule('ripple/server');
+		const { render, getCss, createStream } = await vite.ssrLoadModule('ripple/server');
 
 		// Load the page component
 		const entryPath = get_route_entry_path(route.entry);
@@ -102,7 +101,7 @@ export async function handleRenderRoute(route, context, vite, rippleConfig) {
 			if (streamTemplate) {
 				return createStreamingResponse({
 					render,
-					createSsrStream: create_ssr_stream,
+					createSsrStream: createStream,
 					component: RootComponent,
 					rootBoundary: rippleConfig?.rootBoundary,
 					streamTemplate,
@@ -122,7 +121,7 @@ export async function handleRenderRoute(route, context, vite, rippleConfig) {
 		// Generate CSS tags
 		let cssContent = '';
 		if (css.size > 0) {
-			const cssString = get_css_for_hashes(css);
+			const cssString = getCss(css);
 			if (cssString) {
 				cssContent = `<style data-ripple-ssr>${cssString}</style>`;
 			}

package/src/server/stream-response.js

@@ -3,7 +3,7 @@
  * (render-route.js) and the production runtime (production.js).
  *
  * Platform-agnostic: relies only on the Web `Response`/`ReadableStream`
- * globals and the `render`/`create_ssr_stream` functions injected by the
+ * globals and the `render`/`createStream` functions injected by the
  * caller.
  */
 

package/src/server/virtual-entry.js

@@ -35,7 +35,7 @@ import {
  * Generate the virtual server entry module source code.
  *
  * The generated module:
- * 1. Imports ripple SSR utilities (render, get_css_for_hashes, executeServerFunction)
+ * 1. Imports ripple SSR utilities (render, getCss, executeServerFunction)
  * 2. Imports createHandler from @ripple-ts/vite-plugin/production
  * 3. Imports ripple.config.ts to get adapter, middlewares, and routes
  * 4. Imports each RenderRoute's entry (and layout) as SSR components
@@ -144,7 +144,7 @@ export function generateServerEntry(options) {
 // Auto-generated server entry for production build
 // Do not edit — regenerated on each build
 
-import { render, get_css_for_hashes, create_ssr_stream, executeServerFunction } from 'ripple/server';
+import { render, getCss, createStream, executeServerFunction } from 'ripple/server';
 import { createHandler, resolveRippleConfig } from '@ripple-ts/vite-plugin/production';
 import { readFileSync, existsSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
@@ -206,10 +206,10 @@ const handler = createHandler(
   },
   {
     render,
-    getCss: get_css_for_hashes,
+    getCss,
     htmlTemplate,
     executeServerFunction,
-    createSsrStream: create_ssr_stream,
+    createSsrStream: createStream,
   },
 );
 

package/tests/render-route-props.test.js

@@ -217,7 +217,7 @@ describe('render route SSR props', () => {
 					const { render } = createHandlerOptions();
 					return {
 						render,
-						get_css_for_hashes: () => '',
+						getCss: () => '',
 					};
 				}
 				if (id === '/src/ToolPage.tsrx') {
@@ -277,7 +277,7 @@ describe('render route SSR props', () => {
 					const { render } = createHandlerOptions();
 					return {
 						render,
-						get_css_for_hashes: () => '',
+						getCss: () => '',
 					};
 				}
 				if (id === '/src/ToolPage.tsrx') {
@@ -349,7 +349,7 @@ describe('render route SSR props', () => {
 							Component({ fromRender: true });
 							return { head: '', body: '<div>ok</div>', css: new Set() };
 						},
-						get_css_for_hashes: () => '',
+						getCss: () => '',
 					};
 				}
 				if (id === '/src/ToolPage.tsrx') {

package/tests/stream-response.test.js

@@ -1,4 +1,4 @@
-import { describe, it, expect } from 'vitest';
+import { describe, it, expect, vi } from 'vitest';
 import { buildStreamTemplate, createStreamingResponse } from '../src/server/stream-response.js';
 
 describe('buildStreamTemplate', () => {
@@ -70,6 +70,8 @@ describe('createStreamingResponse', () => {
 	});
 
 	it('propagates render failures to the sink', async () => {
+		// createStreamingResponse logs the failure — keep it out of test output
+		const error_log = vi.spyOn(console, 'error').mockImplementation(() => {});
 		/** @type {unknown} */
 		let errored = null;
 		const response = createStreamingResponse({
@@ -92,5 +94,10 @@ describe('createStreamingResponse', () => {
 		expect(response).toBeInstanceOf(Response);
 		await new Promise((resolve) => setTimeout(resolve, 0));
 		expect(errored).toBeInstanceOf(Error);
+		expect(error_log).toHaveBeenCalledWith(
+			'[ripple] SSR streaming error:',
+			expect.objectContaining({ message: 'render exploded' }),
+		);
+		error_log.mockRestore();
 	});
 });

package/types/production.d.ts

@@ -90,7 +90,7 @@ export interface HandlerOptions {
 	getCss: (css: Set<string>) => string;
 	htmlTemplate: string;
 	executeServerFunction: (fn: Function, body: string) => Promise<string>;
-	/** `create_ssr_stream` from 'ripple/server' — required when streaming is enabled */
+	/** `createStream` from 'ripple/server' — required when streaming is enabled */
 	createSsrStream?: () => {
 		stream: ReadableStream<Uint8Array>;
 		sink: StreamSink;