@unbound-app/api 0.3.0 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@unbound-app/api",
-	"version": "0.3.0",
+	"version": "0.4.0",
 	"author": {
 		"name": "Mario P.",
 		"email": "contact@marioparaschiv.com",

package/src/_internal.d.ts

@@ -138,7 +138,7 @@ export interface DesignModule {
 	showConfirmModal: Fn;
 	showSimpleActionSheet: Fn;
 	hideContextMenu: Fn<void>;
-	useNavigation: <T = any>() => Navigation$1<T>;
+	useNavigation: <T = any>() => Navigation<T>;
 	setColorOpacity: (color: string, opacity: number) => string;
 	darkenColor: (color: string, amount: number) => string;
 	brightenColor: (color: string, amount: number) => string;
@@ -188,6 +188,15 @@ export interface InternalToastOptions extends ToastOptions {
 	closing?: boolean;
 	date?: number;
 }
+export interface Navigation<T = any> {
+	push: (route: string, params?: T) => void;
+	pop: () => void;
+	navigate: (route: string, params?: T) => void;
+	goBack: () => void;
+	setOptions: (options: Record<string, any>) => void;
+	addListener: (event: string, callback: Fn) => Fn<void>;
+	[key: string]: any;
+}
 export interface RowButtonProps {
 	label?: ReactNode;
 	icon?: ReactNode;
@@ -264,6 +273,12 @@ export interface StackProps extends ViewProps {
 	justify?: 'start' | 'center' | 'end' | 'between' | 'around';
 	children?: ReactNode;
 }
+export interface SwitchProps {
+	value: boolean;
+	disabled?: boolean;
+	accessibilityLabel?: string;
+	onValueChange: (value: boolean) => void;
+}
 export interface TableCheckboxRowProps {
 	label?: ReactNode;
 	subLabel?: ReactNode;
@@ -604,15 +619,6 @@ export type UnboundAsset = DiscordAsset & {
 	iconPackScale?: number;
 };
 
-interface Navigation$1<T = any> {
-	push: (route: string, params?: T) => void;
-	pop: () => void;
-	navigate: (route: string, params?: T) => void;
-	goBack: () => void;
-	setOptions: (options: Record<string, any>) => void;
-	addListener: (event: string, callback: Fn) => Fn<void>;
-	[key: string]: any;
-}
 /** The lifecycle and settings contract implemented by a plugin. */
 interface Plugin$1 {
 	start?(): void;
@@ -620,4 +626,4 @@ interface Plugin$1 {
 	getSettingsPanel?(): ReactNode;
 }
 
-export { Navigation$1 as Navigation, Plugin$1 as Plugin };
+export { Plugin$1 as Plugin };

package/src/global.d.ts

@@ -41,6 +41,7 @@ export type {
 	StackProps,
 	StyleSheetSpec,
 	StyleSheetSpecOrFactory,
+	SwitchProps,
 	TableCheckboxRowProps,
 	TableRadioRowProps,
 	TableRowComponent,
@@ -69,49 +70,117 @@ export type {
 } from './_internal';
 import type { ColorString } from './utils';
 declare global {
-	/** The raw `UnboundNative` JSI bridge the tweak installs directly on the JS global. */
-	type UnboundNativeModule = {
-		// Utilities
-		getDeviceModel(): string;
+	/** A feature name published by the native module's capability table. */
+	type UnboundNativeFeature =
+		| 'device.info'
+		| 'device.entitlements'
+		| 'app.source'
+		| 'notifications'
+		| 'pip.video'
+		| 'chat.avatar'
+		| 'chat.messageBubbles'
+		| 'toolbox.menu'
+		| 'native.evaluateBytecode';
+	/**
+	 * The lifecycle status of a native feature on the running build. `unknown` and `unavailable`
+	 * both mean "do not call"; only `supported` and `deprecated` are safe.
+	 */
+	type UnboundNativeFeatureStatus =
+		| 'unknown'
+		| 'removed'
+		| 'deprecated'
+		| 'supported'
+		| 'unavailable';
+	/**
+	 * The full metadata record for a native feature. Everything but `name` and `known` is absent
+	 * when the feature is not in this build's table.
+	 */
+	type UnboundNativeFeatureInfo = {
+		name: string;
+		known: boolean;
+		status: UnboundNativeFeatureStatus;
+		supported?: boolean;
+		introducedIn?: string;
+		deprecatedIn?: string;
+		removedIn?: string;
+		replacement?: UnboundNativeFeature;
+	};
+	/** Hardware, OS, and install-integrity details for the device Unbound is running on. */
+	type UnboundNativeDevice = {
+		getModel(): string;
 		getiOSVersionString(): string;
 		isJailbroken(): boolean;
-		isSystemApp(): Promise<boolean>;
+		isSystemApp(): boolean;
 		isVerifiedBuild(): boolean;
-		isAppStoreApp(): boolean;
-		isTestFlightApp(): boolean;
-		isTrollStoreApp(): boolean;
-		isLiveContainerApp(): boolean;
-		getTrollStoreVariant(): string;
-		getApplicationEntitlements(): unknown;
-		getAppSource(): string;
+		getEntitlements(): Record<string, any>;
 		getEntitlementsAsPlist(): string;
-		showToolboxMenu(): void;
-		// Plugin API
-		showNotification(
-			title: string,
-			content: string,
-			scheduledTime: number,
-			sound: boolean,
-			notificationId: string,
-		): void;
-		playPiPVideo(videoURL: string): void;
-		// Chat UI
-		setAvatarCornerRadius(radius: number): void;
-		resetAvatarCornerRadius(): void;
+	};
+	/** How this copy of the app was installed. */
+	type UnboundNativeApp = {
+		getSource(): string;
+	};
+	/** Local notification scheduling. */
+	type UnboundNativeNotifications = {
+		show(
+			title?: string,
+			body?: string,
+			timeDelay?: number,
+			soundEnabled?: boolean,
+			identifier?: string,
+		): string;
+	};
+	/** Picture-in-picture video playback. */
+	type UnboundNativePiP = {
+		playVideo(url: string): string | null;
+	};
+	/**
+	 * Native chat appearance controls. The getters read synchronously; every setter hops to the
+	 * main queue and returns immediately, so a value read back on the next line may still be stale.
+	 */
+	type UnboundNativeChat = {
 		getAvatarCornerRadius(): number;
-		setMessageBubblesEnabled(
-			enabled: boolean,
-			lightColor: ColorString | null,
-			darkColor: ColorString | null,
-		): void;
-		setMessageBubbleColors(lightColor: ColorString, darkColor: ColorString): void;
+		setAvatarCornerRadius(radius?: number): void;
+		resetAvatarCornerRadius(): void;
+		getMessageBubblesEnabled(): boolean;
 		getMessageBubbleLightColor(): ColorString;
 		getMessageBubbleDarkColor(): ColorString;
-		getMessageBubblesEnabled(): boolean;
 		getMessageBubbleCornerRadius(): number;
-		setMessageBubbleCornerRadius(radius: number): void;
+		setMessageBubblesEnabled(
+			enabled: boolean,
+			lightColor?: ColorString,
+			darkColor?: ColorString,
+		): void;
+		setMessageBubbleColors(lightColor?: ColorString, darkColor?: ColorString): void;
+		setMessageBubbleCornerRadius(radius?: number): void;
 		resetMessageBubbles(): void;
 	};
+	/** The native toolbox menu, drawn natively so it survives a broken JS bundle. */
+	type UnboundNativeToolbox = {
+		showMenu(): void;
+	};
+	/** The raw `UnboundNative` JSI bridge the tweak installs directly on the JS global. */
+	type UnboundNativeModule = {
+		getNativeModuleVersion(): string;
+		supportsFeature(name: UnboundNativeFeature): boolean;
+		getFeatureInfo(name: UnboundNativeFeature): UnboundNativeFeatureInfo;
+		isFeatureDeprecated(name: UnboundNativeFeature): boolean;
+		isFeatureRemoved(name: UnboundNativeFeature): boolean;
+		getSupportedFeatures(): UnboundNativeFeature[];
+		getDeprecatedFeatures(): UnboundNativeFeature[];
+		getRemovedFeatures(): UnboundNativeFeature[];
+		/**
+		 * Runs Hermes bytecode in the app's JS runtime and returns whatever it evaluates to.
+		 * Throws when the buffer is not an `ArrayBuffer`, is empty, or is not Hermes bytecode;
+		 * anything the bytecode itself throws propagates too.
+		 */
+		evaluateBytecode(bytecode: ArrayBuffer, tag?: string): any;
+		device: UnboundNativeDevice;
+		app: UnboundNativeApp;
+		notifications: UnboundNativeNotifications;
+		pip: UnboundNativePiP;
+		chat: UnboundNativeChat;
+		toolbox: UnboundNativeToolbox;
+	};
 	/**
 	 * Build-time token, replaced with a boolean literal by the build's `transform.define`. Folds at
 	 * the module-graph level so `if ($$DEV$$)` branches (and any imports inside them) are dead-code

package/src/metro/components.d.ts

@@ -1,6 +1,6 @@
 // Auto-generated by generate-plugin-sdk.ts - DO NOT EDIT
 
-export type { DesignModule } from '../_internal';
+export type { DesignModule, SwitchProps } from '../_internal';
 import {
 	ImageStyle,
 	StyleProp,
@@ -11,7 +11,7 @@ import {
 } from 'react-native';
 import { ComponentType, ReactNode } from 'react';
 
-import type { DesignModule } from '../_internal';
+import type { DesignModule, SwitchProps } from '../_internal';
 export declare const BackdropFilters: any;
 export declare const Discord: DesignModule;
 export declare const FlashList: any;
@@ -20,3 +20,4 @@ export declare const HelpMessage: any;
 export declare const Media: any;
 export declare const Portal: any;
 export declare const SafeArea: any;
+export declare const Switch: ComponentType<SwitchProps>;