andysu-react-native 0.0.0-stage → 0.1.98

package/android/build.gradle

@@ -0,0 +1,24 @@
+// React Native autolinks this module. Inside the AndySU repo it compiles against :api; in an app it
+// uses the published API artifact (compileOnly: the host provides the one runtime copy).
+apply plugin: "com.android.library"
+
+def andysuVersion = project.findProperty("andysuVersion") ?: "0.1.98"
+
+android {
+    namespace "com.andysu.reactnative"
+    compileSdk 36
+    defaultConfig { minSdk 21 }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+}
+
+dependencies {
+    compileOnly "com.facebook.react:react-android:0.88.1"
+    if (findProject(":api") != null) {
+        compileOnly project(":api")
+    } else {
+        compileOnly "io.github.dixonsolutions.andysu:api:${andysuVersion}"
+    }
+}

package/android/src/main/java/com/andysu/reactnative/AndySUModule.java

@@ -0,0 +1,96 @@
+package com.andysu.reactnative;
+
+import com.andysu.api.Host;
+import com.andysu.api.HostApi;
+import com.facebook.react.bridge.Promise;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.bridge.ReactContextBaseJavaModule;
+import com.facebook.react.bridge.ReactMethod;
+import com.facebook.react.modules.core.DeviceEventManagerModule;
+
+import org.json.JSONObject;
+
+/** NativeModules.AndySU: a thin bridge to the AndySU host (com.andysu.api.Host). */
+public class AndySUModule extends ReactContextBaseJavaModule {
+    public AndySUModule(ReactApplicationContext ctx) {
+        super(ctx);
+    }
+
+    @Override
+    public String getName() {
+        return "AndySU";
+    }
+
+    @ReactMethod
+    public void info(Promise p) {
+        HostApi h = Host.current();
+        try {
+            JSONObject o = new JSONObject().put("present", h != null);
+            if (h != null) {
+                o.put("apiLevel", h.apiLevel()).put("version", h.version()).put("isFactory", h.isFactory())
+                        .put("slotDir", h.slotDir().getPath());
+            }
+            p.resolve(o.toString());
+        } catch (Exception e) {
+            p.reject("andysu", e);
+        }
+    }
+
+    @ReactMethod
+    public void status(Promise p) {
+        HostApi h = Host.current();
+        p.resolve(h == null ? "{\"state\":\"idle\"}" : h.updates().status());
+    }
+
+    @ReactMethod
+    public void checkNow() {
+        HostApi h = Host.current();
+        if (h != null) h.updates().checkNow();
+    }
+
+    @ReactMethod
+    public void applyNow() {
+        HostApi h = Host.current();
+        if (h != null) h.updates().applyNow();
+    }
+
+    @ReactMethod
+    public void restartNow() {
+        HostApi h = Host.current();
+        if (h != null) h.updates().restartNow();
+    }
+
+    @ReactMethod
+    public void setApplyPolicy(String policy) {
+        HostApi h = Host.current();
+        if (h != null) h.updates().setApplyPolicy(policy);
+    }
+
+    @ReactMethod
+    public void applyPolicy(Promise p) {
+        HostApi h = Host.current();
+        p.resolve(h == null ? "live" : h.updates().applyPolicy());
+    }
+
+    @ReactMethod
+    public void markHealthy() {
+        HostApi h = Host.current();
+        if (h != null) h.markHealthy();
+    }
+
+    @ReactMethod
+    public void listen() {
+        HostApi h = Host.current();
+        if (h == null) return;
+        h.updates().setListener(json -> getReactApplicationContext()
+                .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter.class)
+                .emit("AndySUStatus", json));
+    }
+
+    // Required by NativeEventEmitter on the JS side.
+    @ReactMethod
+    public void addListener(String eventName) {}
+
+    @ReactMethod
+    public void removeListeners(double count) {}
+}

package/android/src/main/java/com/andysu/reactnative/AndySUPackage.java

@@ -0,0 +1,21 @@
+package com.andysu.reactnative;
+
+import com.facebook.react.ReactPackage;
+import com.facebook.react.bridge.NativeModule;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.uimanager.ViewManager;
+
+import java.util.Collections;
+import java.util.List;
+
+public class AndySUPackage implements ReactPackage {
+    @Override
+    public List<NativeModule> createNativeModules(ReactApplicationContext ctx) {
+        return Collections.singletonList(new AndySUModule(ctx));
+    }
+
+    @Override
+    public List<ViewManager> createViewManagers(ReactApplicationContext ctx) {
+        return Collections.emptyList();
+    }
+}

package/app.plugin.js

@@ -0,0 +1,13 @@
+// Expo config plugin. AndySU needs nothing in the app's own manifest: the frozen host is produced
+// from the finished APK by `andysu split --transparent` (or the Gradle plugin). The plugin records
+// the andysu.toml location in the Android app's gradle.properties so build scripts can find it.
+const { withGradleProperties } = require('@expo/config-plugins');
+
+module.exports = function withAndySU(config, props = {}) {
+  return withGradleProperties(config, (c) => {
+    const key = 'andysu.toml';
+    c.modResults = c.modResults.filter((p) => !(p.type === 'property' && p.key === key));
+    c.modResults.push({ type: 'property', key, value: props.toml || '../andysu.toml' });
+    return c;
+  });
+};

package/lib/index.d.ts

@@ -0,0 +1,40 @@
+/** Update status as reported by the AndySU host. */
+export interface Status {
+    state: 'idle' | 'checking' | 'up_to_date' | 'deferred' | 'available' | 'downloading' | 'staged' | 'applying' | 'shell_update' | 'error';
+    release?: string;
+    hot_only?: boolean;
+    mandatory?: boolean;
+    download_bytes?: number;
+    code?: string;
+    message?: string;
+    [k: string]: unknown;
+}
+export interface HostInfo {
+    /** False when the app is not running under an AndySU host (e.g. a debug build). */
+    present: boolean;
+    apiLevel?: number;
+    version?: string;
+    isFactory?: boolean;
+    slotDir?: string;
+}
+/** Information about the running payload. */
+export declare function info(): Promise<HostInfo>;
+/** The updater's current status. */
+export declare function status(): Promise<Status>;
+/** Check now (download and stage according to the configured mode). */
+export declare function checkNow(): void;
+/** Apply a staged update now (live if possible, otherwise by restarting). */
+export declare function applyNow(): void;
+/** Restart into the newest staged or committed payload. */
+export declare function restartNow(): void;
+export type ApplyPolicy = 'live' | 'restart' | 'next_start';
+/**
+ * How staged updates apply on this install: swap live (the default), restart the app, or wait for
+ * the next start. Pass null to return to the policy configured in andysu.toml.
+ */
+export declare function setApplyPolicy(policy: ApplyPolicy | null): void;
+export declare function applyPolicy(): Promise<ApplyPolicy>;
+/** Commit this payload generation (call once the app is known to work). */
+export declare function markHealthy(): void;
+/** Listen for status changes. Returns an unsubscribe function. */
+export declare function onStatus(cb: (s: Status) => void): () => void;

package/lib/index.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.info = info;
+exports.status = status;
+exports.checkNow = checkNow;
+exports.applyNow = applyNow;
+exports.restartNow = restartNow;
+exports.setApplyPolicy = setApplyPolicy;
+exports.applyPolicy = applyPolicy;
+exports.markHealthy = markHealthy;
+exports.onStatus = onStatus;
+const react_native_1 = require("react-native");
+const native = react_native_1.Platform.OS === 'android' ? react_native_1.NativeModules.AndySU : undefined;
+/** Information about the running payload. */
+async function info() {
+    if (!native)
+        return { present: false };
+    return JSON.parse(await native.info());
+}
+/** The updater's current status. */
+async function status() {
+    if (!native)
+        return { state: 'idle' };
+    return JSON.parse(await native.status());
+}
+/** Check now (download and stage according to the configured mode). */
+function checkNow() {
+    native === null || native === void 0 ? void 0 : native.checkNow();
+}
+/** Apply a staged update now (live if possible, otherwise by restarting). */
+function applyNow() {
+    native === null || native === void 0 ? void 0 : native.applyNow();
+}
+/** Restart into the newest staged or committed payload. */
+function restartNow() {
+    native === null || native === void 0 ? void 0 : native.restartNow();
+}
+/**
+ * How staged updates apply on this install: swap live (the default), restart the app, or wait for
+ * the next start. Pass null to return to the policy configured in andysu.toml.
+ */
+function setApplyPolicy(policy) {
+    native === null || native === void 0 ? void 0 : native.setApplyPolicy(policy);
+}
+async function applyPolicy() {
+    if (!native)
+        return 'live';
+    return native.applyPolicy();
+}
+/** Commit this payload generation (call once the app is known to work). */
+function markHealthy() {
+    native === null || native === void 0 ? void 0 : native.markHealthy();
+}
+/** Listen for status changes. Returns an unsubscribe function. */
+function onStatus(cb) {
+    if (!native)
+        return () => { };
+    const sub = new react_native_1.NativeEventEmitter(native).addListener('AndySUStatus', (json) => cb(JSON.parse(json)));
+    native.listen();
+    return () => sub.remove();
+}

package/package.json

@@ -1,6 +1,31 @@
 {
   "name": "andysu-react-native",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.98",
+  "description": "AndySU self-updates for React Native and Expo apps on Android (status, check, apply)",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dixonSolutions/AndySU",
+    "directory": "bindings/react-native"
+  },
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "src",
+    "android/build.gradle",
+    "android/src",
+    "app.plugin.js",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "node test/smoke.js"
+  },
+  "peerDependencies": {
+    "react-native": ">=0.70"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,80 @@
+import { NativeEventEmitter, NativeModules, Platform } from 'react-native';
+
+/** Update status as reported by the AndySU host. */
+export interface Status {
+  state: 'idle' | 'checking' | 'up_to_date' | 'deferred' | 'available' | 'downloading' | 'staged' |
+    'applying' | 'shell_update' | 'error';
+  release?: string;
+  hot_only?: boolean;
+  mandatory?: boolean;
+  download_bytes?: number;
+  code?: string;
+  message?: string;
+  [k: string]: unknown;
+}
+
+export interface HostInfo {
+  /** False when the app is not running under an AndySU host (e.g. a debug build). */
+  present: boolean;
+  apiLevel?: number;
+  version?: string;
+  isFactory?: boolean;
+  slotDir?: string;
+}
+
+const native = Platform.OS === 'android' ? NativeModules.AndySU : undefined;
+
+/** Information about the running payload. */
+export async function info(): Promise<HostInfo> {
+  if (!native) return { present: false };
+  return JSON.parse(await native.info());
+}
+
+/** The updater's current status. */
+export async function status(): Promise<Status> {
+  if (!native) return { state: 'idle' };
+  return JSON.parse(await native.status());
+}
+
+/** Check now (download and stage according to the configured mode). */
+export function checkNow(): void {
+  native?.checkNow();
+}
+
+/** Apply a staged update now (live if possible, otherwise by restarting). */
+export function applyNow(): void {
+  native?.applyNow();
+}
+
+/** Restart into the newest staged or committed payload. */
+export function restartNow(): void {
+  native?.restartNow();
+}
+
+export type ApplyPolicy = 'live' | 'restart' | 'next_start';
+
+/**
+ * How staged updates apply on this install: swap live (the default), restart the app, or wait for
+ * the next start. Pass null to return to the policy configured in andysu.toml.
+ */
+export function setApplyPolicy(policy: ApplyPolicy | null): void {
+  native?.setApplyPolicy(policy);
+}
+
+export async function applyPolicy(): Promise<ApplyPolicy> {
+  if (!native) return 'live';
+  return native.applyPolicy();
+}
+
+/** Commit this payload generation (call once the app is known to work). */
+export function markHealthy(): void {
+  native?.markHealthy();
+}
+
+/** Listen for status changes. Returns an unsubscribe function. */
+export function onStatus(cb: (s: Status) => void): () => void {
+  if (!native) return () => {};
+  const sub = new NativeEventEmitter(native).addListener('AndySUStatus', (json: string) => cb(JSON.parse(json)));
+  native.listen();
+  return () => sub.remove();
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.