@use-voltra/server 1.3.0

package/README.md

@@ -0,0 +1,30 @@
+![voltra-banner](https://use-voltra.dev/voltra-baner.jpg)
+
+### Voltra Server Foundation
+
+[![mit licence][license-badge]][license] [![npm downloads][npm-downloads-badge]][npm-downloads] [![PRs Welcome][prs-welcome-badge]][prs-welcome]
+
+`@use-voltra/server` contains the shared server rendering foundation for Voltra, including request adapters and platform-agnostic widget update handlers.
+
+> [!WARNING]
+> This package is not intended to be installed directly in your app. Most apps should install `voltra` instead.
+
+For installation and setup instructions, see the Voltra documentation: [use-voltra.dev](https://use-voltra.dev).
+
+## Authors
+
+`voltra` is an open source collaboration between [Saúl Sharma](https://github.com/saulsharma) and [Szymon Chmal](https://github.com/szymonchmal) at [Callstack][callstack-readme-with-love].
+
+If you think it's cool, please star it 🌟. This project will always remain free to use.
+
+[Callstack][callstack-readme-with-love] is a group of React and React Native geeks, contact us at [hello@callstack.com](mailto:hello@callstack.com) if you need any help with these or just want to say hi!
+
+Like the project? ⚛️ [Join the Callstack team](https://callstack.com/careers/?utm_campaign=Senior_RN&utm_source=github&utm_medium=readme) who does amazing stuff for clients and drives React Native Open Source! 🔥
+
+[callstack-readme-with-love]: https://callstack.com/?utm_source=github.com&utm_medium=referral&utm_campaign=voltra&utm_term=readme-with-love
+[license-badge]: https://img.shields.io/npm/l/voltra?style=for-the-badge
+[license]: https://github.com/callstackincubator/voltra/blob/main/LICENSE.txt
+[npm-downloads-badge]: https://img.shields.io/npm/dm/voltra?style=for-the-badge
+[npm-downloads]: https://www.npmjs.com/package/voltra
+[prs-welcome-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge
+[prs-welcome]: ./CONTRIBUTING.md

package/build/cjs/index.js

@@ -0,0 +1,139 @@
+"use strict";
+/// <reference types="node" />
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWidgetUpdateHandler = createWidgetUpdateHandler;
+exports.createWidgetUpdateNodeHandler = createWidgetUpdateNodeHandler;
+exports.createWidgetUpdateExpressHandler = createWidgetUpdateExpressHandler;
+function isWidgetPlatform(value) {
+    return value === 'ios' || value === 'android';
+}
+function isWidgetTheme(value) {
+    return value === 'light' || value === 'dark';
+}
+function jsonResponse(status, body) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: {
+            'Content-Type': 'application/json',
+        },
+    });
+}
+function normalizeHeaders(headers) {
+    const result = {};
+    headers.forEach((value, key) => {
+        result[key] = value;
+    });
+    return result;
+}
+function getNodeRequestUrl(req) {
+    const protocol = req.socket?.encrypted ? 'https' : 'http';
+    const host = req.headers.host || 'localhost';
+    return new URL(req.url || '/', `${protocol}://${host}`).toString();
+}
+function createFetchRequestFromNode(req) {
+    const headers = new Headers();
+    for (const [key, value] of Object.entries(req.headers)) {
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                headers.append(key, item);
+            }
+            continue;
+        }
+        if (typeof value === 'string') {
+            headers.set(key, value);
+        }
+    }
+    return new Request(getNodeRequestUrl(req), {
+        method: req.method || 'GET',
+        headers,
+    });
+}
+async function writeFetchResponseToNode(response, res) {
+    const headers = {};
+    response.headers.forEach((value, key) => {
+        headers[key] = value;
+    });
+    res.writeHead(response.status, headers);
+    res.end(await response.text());
+}
+/**
+ * Creates a Fetch API request handler for serving widget updates.
+ */
+function createWidgetUpdateHandler(options) {
+    const { renderIos, renderAndroid, validateToken } = options;
+    return async (request) => {
+        try {
+            const url = new URL(request.url);
+            const widgetId = url.searchParams.get('widgetId');
+            const family = url.searchParams.get('family') || undefined;
+            const platformParam = url.searchParams.get('platform');
+            if (!widgetId) {
+                return jsonResponse(400, { error: 'Missing required query parameter: widgetId' });
+            }
+            if (!isWidgetPlatform(platformParam)) {
+                return jsonResponse(400, { error: 'Missing or invalid required query parameter: platform' });
+            }
+            const platform = platformParam;
+            const themeParam = url.searchParams.get('theme');
+            const theme = isWidgetTheme(themeParam) ? themeParam : 'light';
+            const authHeader = request.headers.get('authorization');
+            const token = authHeader?.startsWith('Bearer ') ? authHeader.slice(7) : undefined;
+            if (validateToken) {
+                if (!token) {
+                    return jsonResponse(401, { error: 'Authorization required' });
+                }
+                const isValid = await validateToken(token);
+                if (!isValid) {
+                    return jsonResponse(401, { error: 'Invalid token' });
+                }
+            }
+            const renderRequest = {
+                widgetId,
+                platform,
+                theme,
+                family,
+                token,
+                headers: normalizeHeaders(request.headers),
+            };
+            const renderer = platform === 'android' ? renderAndroid : renderIos;
+            if (!renderer) {
+                const platformName = platform === 'android' ? 'Android' : 'iOS';
+                return jsonResponse(404, { error: `No ${platformName} render handler configured for widget: ${widgetId}` });
+            }
+            const jsonPayload = await renderer(renderRequest);
+            if (!jsonPayload) {
+                const errorMessage = platform === 'android' ? `No content for Android widget: ${widgetId}` : `No content for widget: ${widgetId}`;
+                return jsonResponse(404, { error: errorMessage });
+            }
+            return new Response(jsonPayload, {
+                status: 200,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Cache-Control': 'no-cache',
+                },
+            });
+        }
+        catch (error) {
+            console.error('[Voltra] Widget update handler error:', error);
+            return jsonResponse(500, { error: 'Internal server error' });
+        }
+    };
+}
+/**
+ * Creates a Node.js HTTP request handler for serving widget updates.
+ */
+function createWidgetUpdateNodeHandler(options) {
+    const handler = createWidgetUpdateHandler(options);
+    return async (req, res) => {
+        const request = createFetchRequestFromNode(req);
+        const response = await handler(request);
+        await writeFetchResponseToNode(response, res);
+    };
+}
+/**
+ * Creates an Express-compatible request handler for serving widget updates.
+ */
+function createWidgetUpdateExpressHandler(options) {
+    return createWidgetUpdateNodeHandler(options);
+}
+//# sourceMappingURL=index.js.map

package/build/cjs/index.js.map

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

package/build/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/build/esm/index.js

@@ -0,0 +1,134 @@
+/// <reference types="node" />
+function isWidgetPlatform(value) {
+    return value === 'ios' || value === 'android';
+}
+function isWidgetTheme(value) {
+    return value === 'light' || value === 'dark';
+}
+function jsonResponse(status, body) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: {
+            'Content-Type': 'application/json',
+        },
+    });
+}
+function normalizeHeaders(headers) {
+    const result = {};
+    headers.forEach((value, key) => {
+        result[key] = value;
+    });
+    return result;
+}
+function getNodeRequestUrl(req) {
+    const protocol = req.socket?.encrypted ? 'https' : 'http';
+    const host = req.headers.host || 'localhost';
+    return new URL(req.url || '/', `${protocol}://${host}`).toString();
+}
+function createFetchRequestFromNode(req) {
+    const headers = new Headers();
+    for (const [key, value] of Object.entries(req.headers)) {
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                headers.append(key, item);
+            }
+            continue;
+        }
+        if (typeof value === 'string') {
+            headers.set(key, value);
+        }
+    }
+    return new Request(getNodeRequestUrl(req), {
+        method: req.method || 'GET',
+        headers,
+    });
+}
+async function writeFetchResponseToNode(response, res) {
+    const headers = {};
+    response.headers.forEach((value, key) => {
+        headers[key] = value;
+    });
+    res.writeHead(response.status, headers);
+    res.end(await response.text());
+}
+/**
+ * Creates a Fetch API request handler for serving widget updates.
+ */
+export function createWidgetUpdateHandler(options) {
+    const { renderIos, renderAndroid, validateToken } = options;
+    return async (request) => {
+        try {
+            const url = new URL(request.url);
+            const widgetId = url.searchParams.get('widgetId');
+            const family = url.searchParams.get('family') || undefined;
+            const platformParam = url.searchParams.get('platform');
+            if (!widgetId) {
+                return jsonResponse(400, { error: 'Missing required query parameter: widgetId' });
+            }
+            if (!isWidgetPlatform(platformParam)) {
+                return jsonResponse(400, { error: 'Missing or invalid required query parameter: platform' });
+            }
+            const platform = platformParam;
+            const themeParam = url.searchParams.get('theme');
+            const theme = isWidgetTheme(themeParam) ? themeParam : 'light';
+            const authHeader = request.headers.get('authorization');
+            const token = authHeader?.startsWith('Bearer ') ? authHeader.slice(7) : undefined;
+            if (validateToken) {
+                if (!token) {
+                    return jsonResponse(401, { error: 'Authorization required' });
+                }
+                const isValid = await validateToken(token);
+                if (!isValid) {
+                    return jsonResponse(401, { error: 'Invalid token' });
+                }
+            }
+            const renderRequest = {
+                widgetId,
+                platform,
+                theme,
+                family,
+                token,
+                headers: normalizeHeaders(request.headers),
+            };
+            const renderer = platform === 'android' ? renderAndroid : renderIos;
+            if (!renderer) {
+                const platformName = platform === 'android' ? 'Android' : 'iOS';
+                return jsonResponse(404, { error: `No ${platformName} render handler configured for widget: ${widgetId}` });
+            }
+            const jsonPayload = await renderer(renderRequest);
+            if (!jsonPayload) {
+                const errorMessage = platform === 'android' ? `No content for Android widget: ${widgetId}` : `No content for widget: ${widgetId}`;
+                return jsonResponse(404, { error: errorMessage });
+            }
+            return new Response(jsonPayload, {
+                status: 200,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Cache-Control': 'no-cache',
+                },
+            });
+        }
+        catch (error) {
+            console.error('[Voltra] Widget update handler error:', error);
+            return jsonResponse(500, { error: 'Internal server error' });
+        }
+    };
+}
+/**
+ * Creates a Node.js HTTP request handler for serving widget updates.
+ */
+export function createWidgetUpdateNodeHandler(options) {
+    const handler = createWidgetUpdateHandler(options);
+    return async (req, res) => {
+        const request = createFetchRequestFromNode(req);
+        const response = await handler(request);
+        await writeFetchResponseToNode(response, res);
+    };
+}
+/**
+ * Creates an Express-compatible request handler for serving widget updates.
+ */
+export function createWidgetUpdateExpressHandler(options) {
+    return createWidgetUpdateNodeHandler(options);
+}
+//# sourceMappingURL=index.js.map

package/build/esm/index.js.map

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

package/build/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/build/types/index.d.ts

@@ -0,0 +1,78 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+/**
+ * The platform that sent the widget update request.
+ * Read from the `platform` query parameter.
+ */
+export type WidgetPlatform = 'ios' | 'android';
+/**
+ * The system color scheme reported by the native widget.
+ * Read from the `theme` query parameter.
+ */
+export type WidgetTheme = 'light' | 'dark';
+type NodeLikeRequest = IncomingMessage & {
+    url?: string;
+    method?: string;
+    headers: Record<string, string | string[] | undefined>;
+    socket?: {
+        encrypted?: boolean;
+    };
+};
+type NodeLikeResponse = ServerResponse;
+export type WidgetUpdateHandler = (request: Request) => Promise<Response>;
+export type WidgetUpdateNodeHandler = (req: NodeLikeRequest, res: NodeLikeResponse) => Promise<void>;
+export type WidgetUpdateExpressHandler = WidgetUpdateNodeHandler;
+export type WidgetRenderResult = Promise<string | null> | string | null;
+export type WidgetRenderer = (request: WidgetRenderRequest) => WidgetRenderResult;
+/**
+ * Request context provided to the widget render handler.
+ * Contains the widget ID, family, and any auth headers from the request.
+ */
+export interface WidgetRenderRequest {
+    /** The widget ID requesting an update */
+    widgetId: string;
+    /** The platform the request is coming from */
+    platform: WidgetPlatform;
+    /** The system color scheme (`light` or `dark`). Defaults to `light` when not provided. */
+    theme: WidgetTheme;
+    /** The widget family/size (iOS only: "systemSmall", "systemMedium", etc.) */
+    family?: string;
+    /** The authorization token from the request (if present) */
+    token?: string;
+    /** All request headers */
+    headers: Record<string, string | string[] | undefined>;
+}
+/**
+ * Options for creating the widget update handler.
+ */
+export interface WidgetUpdateHandlerOptions {
+    /**
+     * Render function that returns a serialized iOS widget payload for a given request.
+     * If not provided, iOS requests will receive a 404 response.
+     */
+    renderIos?: WidgetRenderer;
+    /**
+     * Render function that returns a serialized Android widget payload for a given request.
+     * If not provided, Android requests will receive a 404 response.
+     */
+    renderAndroid?: WidgetRenderer;
+    /**
+     * Optional validation function for auth tokens.
+     * Return true if the token is valid, false to reject with 401.
+     * If not provided, all requests are accepted.
+     */
+    validateToken?: (token: string) => Promise<boolean> | boolean;
+}
+/**
+ * Creates a Fetch API request handler for serving widget updates.
+ */
+export declare function createWidgetUpdateHandler(options: WidgetUpdateHandlerOptions): WidgetUpdateHandler;
+/**
+ * Creates a Node.js HTTP request handler for serving widget updates.
+ */
+export declare function createWidgetUpdateNodeHandler(options: WidgetUpdateHandlerOptions): WidgetUpdateNodeHandler;
+/**
+ * Creates an Express-compatible request handler for serving widget updates.
+ */
+export declare function createWidgetUpdateExpressHandler(options: WidgetUpdateHandlerOptions): WidgetUpdateExpressHandler;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEhE;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,SAAS,CAAA;AAE9C;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAA;AAE1C,KAAK,eAAe,GAAG,eAAe,GAAG;IACvC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;IACtD,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,OAAO,CAAA;KACpB,CAAA;CACF,CAAA;AAED,KAAK,gBAAgB,GAAG,cAAc,CAAA;AAEtC,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AACzE,MAAM,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AACpG,MAAM,MAAM,0BAA0B,GAAG,uBAAuB,CAAA;AAChE,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAA;AACvE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,mBAAmB,KAAK,kBAAkB,CAAA;AAEjF;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,8CAA8C;IAC9C,QAAQ,EAAE,cAAc,CAAA;IACxB,0FAA0F;IAC1F,KAAK,EAAE,WAAW,CAAA;IAClB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,SAAS,CAAC,EAAE,cAAc,CAAA;IAE1B;;;OAGG;IACH,aAAa,CAAC,EAAE,cAAc,CAAA;IAE9B;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;CAC9D;AAoED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,mBAAmB,CAuElG;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,0BAA0B,GAAG,uBAAuB,CAQ1G;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,0BAA0B,GAAG,0BAA0B,CAEhH"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@use-voltra/server",
+  "version": "1.3.0",
+  "description": "Shared server rendering foundation for Voltra",
+  "main": "build/cjs/index.js",
+  "module": "build/esm/index.js",
+  "types": "build/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/types/index.d.ts",
+      "require": "./build/cjs/index.js",
+      "import": "./build/esm/index.js",
+      "default": "./build/esm/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "build",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs packages/server",
+    "clean": "rm -rf build",
+    "lint": "oxlint src",
+    "typecheck": "tsc -p tsconfig.typecheck.json --noEmit"
+  },
+  "keywords": [
+    "voltra",
+    "server",
+    "widget",
+    "rendering"
+  ],
+  "author": "Saúl Sharma (https://x.com/saul_sharma), Szymon Chmal (https://x.com/chmalszymon)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/callstackincubator/voltra.git",
+    "directory": "packages/server"
+  },
+  "bugs": {
+    "url": "https://github.com/callstackincubator/voltra/issues"
+  },
+  "license": "MIT",
+  "homepage": "https://use-voltra.dev"
+}