@opndev/react-native-events 0.0.10

package/lib/screens/news-list-screen.jsx

@@ -0,0 +1,196 @@
+// SPDX-FileCopyrightText: 2026 Wesley Schwengle <wesleys@opperschaap.net>
+//
+// SPDX-License-Identifier: GPL-3.0-or-later WITH LicenseRef-OPNDEV-exceptions
+
+import React, {
+  useEffect,
+  useState,
+} from 'react';
+import {
+  ActivityIndicator,
+  Pressable,
+  RefreshControl,
+  ScrollView,
+  StyleSheet,
+  Text,
+} from 'react-native';
+
+
+import { fetchNewsJson } from '../actions/news';
+import Markdown from 'react-native-markdown-display';
+
+const defaultStyle = StyleSheet.create({
+  container: {
+    flex: 1,
+  },
+  content: {
+    padding: 16,
+    gap: 12,
+  },
+  item: {
+    padding: 16,
+    borderRadius: 12,
+    gap: 8,
+  },
+});
+
+/**
+ * NewsListScreen
+ *
+ * Fetches and renders a vertically scrollable list of news items.
+ *
+ * @param {object} props
+ * @param {string} props.uri
+ * @param {string} [props.bearerToken]
+ * @param {React.ComponentType} [props.TextComponent]
+ * @param {Function} [props.onPressItem]
+ * @param {string} [props.backgroundColor]
+ * @param {string} [props.cardBackgroundColor]
+ * @param {object} [props.containerStyle]
+ * @param {object} [props.contentStyle]
+ * @param {object} [props.itemStyle]
+ * @param {object} [props.titleStyle]
+ * @param {object} [props.summaryStyle]
+ * @param {object} [props.refreshButtonStyle]
+ * @param {object} [props.refreshTextStyle]
+ * @param {object} [props.errorTextStyle]
+ * @param {string} [props.refreshLabel]
+ * @param {string} [props.emptyLabel]
+ * @param {string} [props.errorLabel]
+ * @param {boolean} [props.showRefresh]
+ *
+ * @returns {JSX.Element}
+ */
+export default function NewsListScreen({
+  uri,
+  bearerToken,
+  TextComponent = Text,
+  MarkdownComponent = Markdown,
+  onPressItem,
+
+  backgroundColor,
+  cardBackgroundColor,
+
+  containerStyle,
+  contentStyle,
+  itemStyle,
+  titleStyle,
+  summaryStyle,
+  refreshButtonStyle,
+  refreshTextStyle,
+  errorTextStyle,
+
+  refreshLabel = 'Refresh',
+  emptyLabel = 'No news items.',
+  errorLabel = 'Unable to load news.',
+  showRefresh = true,
+}) {
+  const [items, setItems] = useState([]);
+  const [loading, setLoading] = useState(true);
+  const [refreshing, setRefreshing] = useState(false);
+  const [error, setError] = useState(null);
+
+  useEffect(() => {
+    load();
+  }, [uri, bearerToken]);
+
+  /**
+   * Loads news items from the configured URI.
+   *
+   * @param {boolean} [force]
+   *
+   * @returns {Promise<void>}
+   */
+  async function load(force = false) {
+    setError(null);
+
+    if (force) {
+      setRefreshing(true);
+    }
+    else {
+      setLoading(true);
+    }
+
+    try {
+      const data = await fetchNewsJson({
+        uri,
+        bearerToken,
+        force,
+      });
+
+      setItems(data.items);
+    }
+    catch (e) {
+      setError(e.message || errorLabel);
+    }
+
+    if (force) {
+      setRefreshing(false);
+    }
+    else {
+      setLoading(false);
+    }
+  }
+
+  return (
+    <ScrollView
+      style={[
+        defaultStyle.container,
+        backgroundColor ? { backgroundColor } : null,
+        containerStyle,
+      ]}
+      contentContainerStyle={[
+        defaultStyle.content,
+        contentStyle,
+      ]}
+      refreshControl={
+        <RefreshControl
+          refreshing={refreshing}
+          onRefresh={() => load(true)}
+        />
+      }
+    >
+      {loading ? (
+        <ActivityIndicator />
+      ) : null}
+
+      {!loading && error ? (
+        <TextComponent style={errorTextStyle}>
+          {error}
+        </TextComponent>
+      ) : null}
+
+      {!loading && !error && !items.length ? (
+        <TextComponent style={errorTextStyle}>
+          {emptyLabel}
+        </TextComponent>
+      ) : null}
+
+      {!loading && !error && items.map((item) => {
+        return (
+          <Pressable
+            key={item.id}
+            style={[
+              defaultStyle.item,
+              cardBackgroundColor
+                ? { backgroundColor: cardBackgroundColor }
+                : null,
+              itemStyle,
+            ]}
+            onPress={() => onPressItem?.(item)}
+          >
+            <TextComponent style={titleStyle}>
+              {item.title}
+            </TextComponent>
+
+            {item.summary ? (
+              <MarkdownComponent style={summaryStyle}>
+                {item.summary}
+              </MarkdownComponent>
+            ) : null}
+          </Pressable>
+        );
+      })}
+    </ScrollView>
+  );
+}

package/lib/screens/qr-code-screen.jsx

@@ -0,0 +1,56 @@
+// SPDX-FileCopyrightText: 2026 Wesley Schwengle <wesleys@opperschaap.net>
+//
+// SPDX-License-Identifier: GPL-3.0-or-later WITH LicenseRef-OPNDEV-exceptions
+
+import React, { useMemo } from 'react';
+
+import QRCodeForm from '../components/qr-code-form';
+import QRCodeAction from '../actions/qrcode';
+
+/**
+ * QRCodeScreen
+ *
+ * QR code feature content.
+ *
+ * @param {object} props
+ * @param {React.ComponentType} props.TextComponent
+ * @param {{url: string, method?: string, headers?: object}} props.endpoint
+ * @param {Array<object>} props.fields
+ * @param {string} [props.storageKey]
+ * @param {(values: object) => any} [props.buildPayload]
+ * @param {(response: any) => string} [props.extractToken]
+ *
+ * @returns {JSX.Element}
+ */
+export default function QRCodeScreen({
+  TextComponent,
+  endpoint,
+  fields,
+  storageKey,
+  buildPayload,
+  extractToken,
+  ...rest
+}) {
+  const action = useMemo(() => {
+    return new QRCodeAction({
+      endpoint,
+      storageKey,
+      buildPayload,
+      extractToken,
+    });
+  }, [
+    endpoint,
+    storageKey,
+    buildPayload,
+    extractToken,
+  ]);
+
+  return (
+    <QRCodeForm
+      action={action}
+      fields={fields}
+      TextComponent={TextComponent}
+      {...rest}
+    />
+  );
+}

package/lib/screens.js

@@ -0,0 +1,8 @@
+// SPDX-FileCopyrightText: 2026 Wesley Schwengle <wesleys@opperschaap.net>
+//
+// SPDX-License-Identifier: GPL-3.0-or-later WITH LicenseRef-OPNDEV-exceptions
+
+export { createScreens } from './globals.js';
+export { default as FoodVendorScreen } from './screens/food-vendor-screen.jsx';
+export { default as FoodMenuScreen } from './screens/food-menu-screen.jsx';
+export { default as QRCodeScreen } from './screens/qr-code-screen.jsx';

package/lib/testing/react-native.js

@@ -0,0 +1,94 @@
+// SPDX-FileCopyrightText: 2026 Wesley Schwengle <wesleys@opperschaap.net>
+//
+// SPDX-License-Identifier: GPL-3.0-or-later WITH LicenseRef-OPNDEV-exceptions
+
+import Module from 'module';
+
+const reactNativeMock = {
+  Linking: {
+    async openURL() {
+      return true;
+    },
+    async canOpenURL() {
+      return true;
+    },
+  },
+  Platform: {
+    OS: 'android',
+  },
+};
+
+let originalLoad;
+let isInstalled = false;
+
+/**
+ * Install a Node-level mock for `react-native`.
+ *
+ * This is intended for TAP / Node-based unit tests where React Native
+ * is not available as a runtime module.
+ *
+ * @returns {object}
+ * Returns the active mock object so tests can override behavior.
+ */
+export function mockReactNative() {
+  if (isInstalled) {
+    return reactNativeMock;
+  }
+
+  originalLoad = Module._load;
+
+  Module._load = function (request, parent, isMain) {
+    if (request === 'react-native') {
+      return reactNativeMock;
+    }
+
+    return originalLoad.call(this, request, parent, isMain);
+  };
+
+  isInstalled = true;
+
+  return reactNativeMock;
+}
+
+/**
+ * Restore the original Node module loader.
+ */
+export function unmockReactNative() {
+  if (!isInstalled) {
+    return;
+  }
+
+  Module._load = originalLoad;
+  originalLoad = null;
+  isInstalled = false;
+}
+
+/**
+ * Reset the mock back to defaults between tests.
+ *
+ * @returns {object}
+ * Returns the reset mock object.
+ */
+export function resetReactNativeMock() {
+  reactNativeMock.Linking.openURL = async function () {
+    return true;
+  };
+
+  reactNativeMock.Linking.canOpenURL = async function () {
+    return true;
+  };
+
+  reactNativeMock.Platform.OS = 'android';
+
+  return reactNativeMock;
+}
+
+/**
+ * Get the active mock object.
+ *
+ * @returns {object}
+ */
+export function getReactNativeMock() {
+  return reactNativeMock;
+}
+

package/lib/utils/colors.js

@@ -0,0 +1,82 @@
+// SPDX-FileCopyrightText: 2026 Wesley Schwengle <wesleys@opperschaap.net>
+//
+// SPDX-License-Identifier: GPL-3.0-or-later WITH LicenseRef-OPNDEV-exceptions
+
+/**
+ * Mix two hex colors.
+ *
+ * @param {string} a
+ *   First hex color, like "#ff0000".
+ * @param {string} b
+ *   Second hex color, like "#0000ff".
+ * @param {number} amount
+ *   Amount of b to mix in, from 0 to 1.
+ *
+ * @returns {string}
+ *   Mixed hex color.
+ */
+export function mixHexColors(a, b, amount = 0.5) {
+  const ah = a.replace('#', '');
+  const bh = b.replace('#', '');
+
+  const ar = parseInt(ah.slice(0, 2), 16);
+  const ag = parseInt(ah.slice(2, 4), 16);
+  const ab = parseInt(ah.slice(4, 6), 16);
+
+  const br = parseInt(bh.slice(0, 2), 16);
+  const bg = parseInt(bh.slice(2, 4), 16);
+  const bb = parseInt(bh.slice(4, 6), 16);
+
+  const r = Math.round(ar + (br - ar) * amount);
+  const g = Math.round(ag + (bg - ag) * amount);
+  const b2 = Math.round(ab + (bb - ab) * amount);
+
+  return (
+    '#' +
+    r.toString(16).padStart(2, '0') +
+    g.toString(16).padStart(2, '0') +
+    b2.toString(16).padStart(2, '0')
+  );
+}
+
+/**
+ * Return black or white depending on which has better contrast.
+ *
+ * @param {string} hex
+ *   Background color as "#rrggbb".
+ *
+ * @returns {string}
+ *   "#000000" or "#ffffff".
+ */
+export function contrastColor(hex) {
+  const value = hex.replace('#', '');
+
+  const r = parseInt(value.slice(0, 2), 16) / 255;
+  const g = parseInt(value.slice(2, 4), 16) / 255;
+  const b = parseInt(value.slice(4, 6), 16) / 255;
+
+  const luminance =
+    0.2126 * toLinear(r) +
+    0.7152 * toLinear(g) +
+    0.0722 * toLinear(b);
+
+  return luminance > 0.179 ? '#000000' : '#ffffff';
+}
+
+/**
+ * Convert sRGB channel to linear RGB.
+ *
+ * @param {number} channel
+ *   sRGB channel from 0 to 1.
+ *
+ * @returns {number}
+ *   Linear RGB channel.
+ */
+export function toLinear(channel) {
+  if (channel <= 0.03928) {
+    return channel / 12.92;
+  }
+
+  return ((channel + 0.055) / 1.055) ** 2.4;
+}
+

package/lib/utils/format-price.js

@@ -0,0 +1,19 @@
+// SPDX-FileCopyrightText: 2026 Wesley Schwengle <wesleys@opperschaap.net>
+//
+// SPDX-License-Identifier: GPL-3.0-or-later WITH LicenseRef-OPNDEV-exceptions
+
+/**
+ * Format a numeric price for display.
+ *
+ * @param {number|string} price
+ * @returns {string}
+ */
+export function formatPrice(price) {
+  const num = parseFloat(price);
+
+  if (Number.isNaN(num)) {
+    return '';
+  }
+
+  return num % 1 === 0 ? num.toString() : num.toFixed(2);
+}

package/lib/utils/header-picker.js

@@ -0,0 +1,38 @@
+// SPDX-FileCopyrightText: 2026 Wesley Schwengle <wesleys@opperschaap.net>
+//
+// SPDX-License-Identifier: GPL-3.0-or-later WITH LicenseRef-OPNDEV-exceptions
+
+/**
+ * Pick a different header image every day
+ *
+ * 
+ * const headerImages = [
+ *   require('@/assets/images/main.webp'),
+ *   require('@/assets/images/main-2.webp'),
+ *   require('@/assets/images/main-3.webp'),
+ * ];
+ *
+ * @param {images} price
+ * @returns {image}
+ */
+export function pickDailyImage(images) {
+  const now = new Date();
+  const start = new Date(now.getFullYear(), 0, 0);
+  const day = Math.floor((now - start) / 86400000);
+
+  return images[day % images.length];
+}
+
+
+/**
+ * Pick a random image.
+ *
+ * @param {Array} images
+ *   List of static require() image values.
+ *
+ * @returns {*}
+ *   Selected image.
+ */
+export function pickRandomImage(images) {
+  return images[Math.floor(Math.random() * images.length)];
+}

package/lib/utils/launch.js

@@ -0,0 +1,94 @@
+// SPDX-FileCopyrightText: 2026 Wesley Schwengle <wesleys@opperschaap.net>
+//
+// SPDX-License-Identifier: GPL-3.0-or-later WITH LicenseRef-OPNDEV-exceptions
+
+import { Linking, Platform } from 'react-native';
+
+/**
+ * Open a plain URL.
+ */
+export async function openUrl(url) {
+  if (!url) return false;
+
+  try {
+    await Linking.openURL(url);
+    return true;
+  }
+  catch (e) {
+    console.error('openUrl failed:', e);
+    return false;
+  }
+}
+
+/**
+ * Open an app via deep link with fallback to store.
+ *
+ * @param {object} opts
+ * @param {string} [opts.url]           Deep link (optional)
+ * @param {string} [opts.packageName]   Android package
+ * @param {string} [opts.appStoreUrl]   iOS fallback
+ */
+export async function openApp({
+  url,
+  packageName,
+  appStoreUrl,
+}) {
+  try {
+    if (Platform.OS === 'android') {
+      if (!packageName) {
+        if (url) return openUrl(url);
+        return false;
+      }
+
+      const appUrl = url || `${packageName}://`;
+
+      try {
+        const canOpen = await Linking.canOpenURL(appUrl);
+
+        if (canOpen) {
+          await Linking.openURL(appUrl);
+          return true;
+        }
+      }
+      catch (_) {
+      }
+
+      // fallback → Play Store
+      await Linking.openURL(
+        `market://details?id=${packageName}`
+      );
+      return true;
+    }
+
+    if (Platform.OS === 'ios') {
+      if (url) {
+        await Linking.openURL(url);
+        return true;
+      }
+
+      if (appStoreUrl) {
+        await Linking.openURL(appStoreUrl);
+        return true;
+      }
+    }
+
+    return false;
+  }
+  catch (e) {
+    console.error('openApp failed:', e);
+    return false;
+  }
+}
+
+/**
+ * Resolve + open whatever makes sense.
+ *
+ * Use this as your "one call".
+ */
+export async function openExternal(opts) {
+  if (opts.packageName || opts.appStoreUrl) {
+    return openApp(opts);
+  }
+
+  return openUrl(opts.url);
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "author": {
+    "email": "wesley@opndev.io",
+    "name": "Wesley Schwengle"
+  },
+  "description": "React Native code for events",
+  "devDependencies": {
+    "jsdoc": "latest",
+    "tap": "latest"
+  },
+  "exports": {
+    ".": "./lib/index.js",
+    "./components": "./lib/components.js",
+    "./globals": "./lib/screen-registery.js",
+    "./hero-screen-registry": "./lib/hero-screen-registery.js",
+    "./lite": "./lib/hero-screen-registery.js",
+    "./notifications": "./lib/notifications.js",
+    "./notifications-fcm": "./lib/notifications/fcm.js",
+    "./screen-registery": "./lib/screen-registery.js",
+    "./screens": "./lib/screens.js"
+  },
+  "keywords": [],
+  "license": "GPL-3.0-or-later WITH LicenseRef-OPNDEV-exceptions",
+  "main": "lib/index.js",
+  "name": "@opndev/react-native-events",
+  "private": false,
+  "scripts": {
+    "build": "rzil build",
+    "jsdoc": "jsdoc -c .jsdoc.json",
+    "pkg": "rzil pkg",
+    "release": "rzil release",
+    "test": "tap"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "version": "0.0.10"
+}