@unbound-app/api 0.1.0

package/src/native.d.ts

@@ -0,0 +1,95 @@
+// Auto-generated by generate-plugin-sdk.ts - DO NOT EDIT
+
+import type { Fn, PromiseFn } from './utils';
+/** The raw `UnboundNative` JSI bridge installed on the global by the platform loader. */
+declare const UnboundNative$1: UnboundNativeModule | undefined;
+/** The resolved native client info module, exposing build and release metadata. */
+export declare const BundleInfo: BundleInfoType;
+/** The resolved native bundle updater module, used to check for updates and reload the bundle. */
+export declare const BundleManager: DCDBundleManagerType;
+/** The resolved native device module, exposing hardware and OS details. */
+export declare const DeviceInfo: DeviceInfoType;
+/**
+ * @description Resolves the first available native module matching any of the given names, checking both `NativeModules` and the `TurboModuleRegistry`.
+ * @template T The type of the resolved native module.
+ * @param names The candidate native module names to look up, in priority order.
+ * @returns The first matching native module.
+ */
+export declare function getNativeModule<T = any>(...names: string[]): T;
+/**
+ * @description Reads Hermes' runtime metadata, such as the bytecode version, GC, and build channel.
+ * React Native types the global `HermesInternal` as `null | {}`, so this reads it via
+ * `window.HermesInternal` where our own typing wins.
+ * @returns The runtime property map, or an empty object when Hermes internals are unavailable.
+ */
+export declare function getRuntimeProperties(): Record<string, any>;
+/**
+ * @description Persists pending settings to storage, then reloads the native bundle.
+ */
+export declare function reload(): Promise<void>;
+/** Build and release metadata reported by the native client info module. */
+export interface BundleInfoType {
+	Version: string;
+	ReleaseChannel: string;
+	Manifest: string;
+	Build: string;
+	SentryDsn: string;
+	DeviceVendorID: string;
+	OTABuild: string;
+	SentryStaffDsn: string;
+	Identifier: string;
+	SentryAlphaBetaDsn: string;
+}
+/** The native `BundleUpdaterManager` module surface for OTA updates and reloading the bundle. */
+export interface DCDBundleManagerType {
+	getInitialBundleDownloaded: PromiseFn;
+	getInitialOtaUpdateChecked: PromiseFn;
+	checkForUpdateAndReload: Fn;
+	reload: Fn;
+	getOtaRootPath: PromiseFn;
+	getBuildOverrideCookieContents: PromiseFn;
+	setBuildOverrideCookieHeader: PromiseFn;
+	getManifestInfo: PromiseFn;
+	addListener: Fn;
+	removeListeners: Fn;
+}
+/** The constant directory paths exposed by the native `DCDFileManager`. */
+export interface DCDFileManagerConstants {
+	CacheDirPath: string;
+	DocumentsDirPath: string;
+}
+/** The native `DCDFileManager` module surface for reading, writing, and inspecting files. */
+export interface DCDFileManagerType extends DCDFileManagerConstants {
+	readFile(path: string, encoding: DCDFileManagerEncoding): Promise<string>;
+	writeFile(
+		type: 'documents' | 'cache',
+		path: string,
+		data: string,
+		encoding: DCDFileManagerEncoding,
+	): Promise<string>;
+	removeFile(type: 'documents' | 'cache', path: string): Promise<any>;
+	readAsset(): Promise<unknown>;
+	getSize(): Promise<unknown>;
+	getVideoDimensions(): Promise<unknown>;
+	fileExists(path: string): Promise<boolean>;
+	saveFileToGallery(): Promise<unknown>;
+	getConstants(): DCDFileManagerConstants;
+}
+/** Hardware and OS details reported by the native device module. */
+export interface DeviceInfoType {
+	isTaskBarEnabled: boolean;
+	maxCpuFreq: string;
+	socName: string;
+	deviceModel: string;
+	isTablet: boolean;
+	isGestureNavigationEnabled: boolean;
+	deviceProduct: string;
+	systemVersion: string;
+	deviceManufacturer: string;
+	deviceBrand: string;
+	ramSize: string;
+	device: string;
+}
+/** The text encodings accepted by the native `DCDFileManager` read/write operations. */
+export type DCDFileManagerEncoding = 'utf-8' | 'utf8' | 'base64';
+export { UnboundNative$1 as UnboundNative };

package/src/patcher.d.ts

@@ -0,0 +1,92 @@
+// Auto-generated by generate-plugin-sdk.ts - DO NOT EDIT
+
+//#region src/patcher.d.ts
+export declare const PATCH_SYMBOL: unique symbol;
+export declare const patches: PatchedModule[];
+export declare enum PatchType {
+	Before = 0,
+	Instead = 1,
+	After = 2,
+}
+export declare function after<M extends PatchParent, P extends PropOf<M>>(
+	parent: M,
+	method: P,
+	callback: PatchCallback<
+		M[P] extends (...args: infer Args) => any ? Args : any[],
+		M[P] extends (...args: any[]) => infer Res ? Res : any,
+		unknown extends ThisParameterType<M[P]> ? M : ThisParameterType<M[P]>
+	>,
+	options?: PatchOptions,
+): () => void;
+export declare function before<M extends PatchParent, P extends PropOf<M>>(
+	parent: M,
+	method: P,
+	callback: PatchCallback<
+		M[P] extends (...args: infer Args) => any ? Args : any[],
+		M[P] extends (...args: any[]) => infer Res ? Res : any,
+		unknown extends ThisParameterType<M[P]> ? M : ThisParameterType<M[P]>
+	>,
+	options?: PatchOptions,
+): () => void;
+export declare function createPatcher(defaultOptions: string | PatchOptions): PatcherInstance;
+export declare function instead<M extends PatchParent, P extends PropOf<M>>(
+	parent: M,
+	method: P,
+	callback: PatchCallback<
+		M[P] extends (...args: infer Args) => any ? Args : any[],
+		M[P] extends (...args: any[]) => infer Res ? Res : any,
+		unknown extends ThisParameterType<M[P]> ? M : ThisParameterType<M[P]>
+	>,
+	options?: PatchOptions,
+): () => void;
+export declare function unpatchAll(): void;
+export declare function unpatchAllByCaller(caller: string): void;
+//#endregion
+//#region src/env.d.ts
+/**
+ * A reference to a {@link PatchParent} that does not, by itself, prevent the parent from being
+ * garbage collected. Mirrors the subset of the global {@link WeakRef} API that the patcher uses.
+ */
+export interface ParentRef {
+	deref(): PatchParent | undefined;
+}
+export interface Patch<Args extends any[] = any[], Res = any, Self = any> extends PatchOptions {
+	callback: PatchCallback<Args, Res, Self>;
+}
+export interface PatchCallback<Args extends any[] = any[], Res = any, Self = any> {
+	(ctx: PatchContext<Args, Res, Self>): any;
+}
+export interface PatchContext<Args extends any = any[], Res = any, Self = any> {
+	original: (...args: any[]) => Res;
+	this: Self;
+	result: Res | null;
+	args: Args;
+}
+export interface PatchOptions {
+	once?: boolean;
+	caller?: string;
+}
+//#endregion
+//#region src/types.d.ts
+export interface PatchedModule {
+	parent: ParentRef;
+	method: PatchMethod;
+	original: AnyFunction & AnyConstructor;
+	patches: Record<PatchType, Set<Patch<any, any, any>>>;
+}
+export interface PatcherInstance {
+	instead: typeof instead;
+	before: typeof before;
+	after: typeof after;
+	unpatchAll: () => void;
+}
+export type AnyConstructor = {
+	new (...args: any): any;
+};
+export type AnyFunction = (...args: any[]) => any;
+export type AnyObject = Record<any, any>;
+export type PatchMethod = string;
+export type PatchParent = AnyFunction | AnyObject;
+export type PropOf<M> = {
+	[K in keyof M]: M[K] extends AnyFunction | AnyConstructor ? Extract<K, string> : never;
+}[keyof M];

package/src/settings.d.ts

@@ -0,0 +1,28 @@
+// Auto-generated by generate-plugin-sdk.ts - DO NOT EDIT
+
+export type { SettingsEntry } from './_internal';
+import { ComponentType } from 'react';
+
+import type { SettingsEntry } from './_internal';
+
+declare const _default: {
+	registerSettings: typeof registerSettings;
+	removeSettings: typeof removeSettings;
+	sections: typeof sections;
+};
+/**
+ * @description Registers one or more settings entries into the section registry, warning on key collisions.
+ * @param entries The settings entries to register.
+ */
+export declare function registerSettings(...entries: SettingsEntry[]): void;
+/**
+ * @description Removes one or more settings entries from the section registry by key.
+ * @param keys The entry keys to remove.
+ */
+export declare function removeSettings(...keys: string[]): void;
+/**
+ * @description Returns the current registry of settings entries.
+ * @returns A record of entry key to its {@link SettingsEntry}.
+ */
+export declare function sections(): Record<string, SettingsEntry>;
+export { _default as default };

package/src/storage.d.ts

@@ -0,0 +1,155 @@
+// Auto-generated by generate-plugin-sdk.ts - DO NOT EDIT
+
+import type { PredicateResult, Widen } from './utils';
+import type { EventEmitter } from './tseep';
+declare const _default: {
+	addListener: typeof addListener;
+	get: typeof get;
+	getStore: typeof getStore;
+	off: <EventKey extends keyof EventMap = string>(
+		event: EventKey,
+		listener: EventMap[EventKey],
+	) => EventEmitter<EventMap>;
+	on: <EventKey extends keyof EventMap = string>(
+		event: EventKey,
+		listener: EventMap[EventKey],
+	) => EventEmitter<EventMap>;
+	persist: typeof persist;
+	remove: typeof remove;
+	removeListener: typeof removeListener;
+	set: typeof set;
+	useSettingsStore: typeof useSettingsStore;
+};
+/**
+ * @description Removes an entire store and all of its keys, and emits `changed` and `cleared`.
+ * @param store The store to clear.
+ */
+declare function clear$1(store: string): void;
+export declare const off: <EventKey extends keyof EventMap = string>(
+	event: EventKey,
+	listener: EventMap[EventKey],
+) => EventEmitter<EventMap>;
+export declare const on: <EventKey extends keyof EventMap = string>(
+	event: EventKey,
+	listener: EventMap[EventKey],
+) => EventEmitter<EventMap>;
+/**
+ * @description Registers a callback invoked on every settings change matching the predicate.
+ * @param predicate Decides whether a given change should fire the callback.
+ * @param callback Invoked with the payload of each matching change.
+ * @returns A function that removes the listener.
+ */
+export declare function addListener(
+	predicate: (payload: SettingsPayload) => PredicateResult,
+	callback: (payload: SettingsPayload) => void,
+): () => void;
+/**
+ * @description Reads a value from a store by dot-separated key path, falling back to a default when absent.
+ * @template T The type of the default value.
+ * @param store The store to read from.
+ * @param key The dot-separated key path within the store.
+ * @param def The value to return when the key is not set.
+ * @returns The stored value, or `def` if the key path is not present.
+ */
+export declare function get<T>(store: string, key: string, def: T): Widen<T>;
+/**
+ * @description Builds a store-scoped facade binding every settings operation to a single store name.
+ * @param store The store name to scope every operation to.
+ * @returns An object exposing `get`, `set`, `toggle`, `remove`, `clear`, `useSettingsStore`, and `addListener` bound to the store.
+ */
+export declare function getStore(store: string): {
+	set: (key: string, value: any) => void;
+	get: <T>(key: string, def: T) => Widen<T>;
+	toggle: (key: string, def: any) => void;
+	remove: (key: string) => void;
+	clear: () => void;
+	useSettingsStore: (predicate?: (payload: SettingsPayload) => PredicateResult) => {
+		set: (key: string, value: any) => void;
+		get: <T>(key: string, def: T) => Widen<T>;
+		toggle: (key: string, def: any) => void;
+		remove: (key: string) => void;
+	};
+	addListener: (
+		predicate: (payload: SettingsPayload) => PredicateResult,
+		callback: (payload: SettingsPayload) => void,
+	) => () => EventEmitter<EventMap>;
+};
+/**
+ * @description Serialises the current settings and writes them to disk.
+ * @returns A promise that resolves once the settings file has been written.
+ */
+export declare function persist(): Promise<void>;
+/**
+ * @description Deletes a top-level key from a store, dropping the store entirely if it becomes empty, and emits `changed` and `removed`.
+ * @param store The store to remove the key from.
+ * @param key The key to delete.
+ */
+export declare function remove(store: string, key: string): void;
+/**
+ * @description Removes a previously registered settings change listener.
+ * @param callback The listener to remove.
+ */
+export declare function removeListener(callback: (payload: SettingsPayload) => void): void;
+/**
+ * @description Writes a value into a store at a dot-separated key path, creating intermediate objects, and emits `changed` and `set`.
+ * @param store The store to write to.
+ * @param key The dot-separated key path within the store.
+ * @param value The value to store.
+ */
+export declare function set(store: string, key: string, value: any): void;
+/**
+ * @description Flips a boolean value at a key path against its current (or default) value, and emits `toggled`.
+ * @param store The store to write to.
+ * @param key The dot-separated key path within the store.
+ * @param def The value to assume when the key is not yet set.
+ */
+export declare function toggle(store: string, key: string, def: any): void;
+/**
+ * @description React hook that re-renders the component whenever a matching change occurs in the store.
+ * @param store The store to subscribe to.
+ * @param predicate Optional filter deciding which changes trigger a re-render.
+ * @returns An object exposing `get`, `set`, `toggle`, and `remove` bound to the store.
+ */
+export declare function useSettingsStore(
+	store: string,
+	predicate?: (payload: SettingsPayload) => PredicateResult,
+): {
+	set: (key: string, value: any) => void;
+	get: <T>(key: string, def: T) => Widen<T>;
+	toggle: (key: string, def: any) => void;
+	remove: (key: string) => void;
+};
+
+/** Payload describing a settings change, passed to `changed` listeners and predicates. */
+export interface SettingsPayload {
+	store: string;
+	key: string | null;
+	value: any;
+}
+
+export type ClearedPayload = {
+	store: string;
+};
+export type EventMap = {
+	set: (payload: SetPayload) => void;
+	changed: (payload: SettingsPayload) => void;
+	cleared: (payload: ClearedPayload) => void;
+	removed: (payload: RemovedPayload) => void;
+	toggled: (payload: ToggledPayload) => void;
+};
+export type RemovedPayload = {
+	store: string;
+	key: string;
+};
+export type SetPayload = {
+	store: string;
+	key: string;
+	value: any;
+};
+export type ToggledPayload = {
+	store: string;
+	key: string;
+	prev: any;
+	value: any;
+};
+export { _default as default, clear$1 as clear };

package/src/toasts.d.ts

@@ -0,0 +1,18 @@
+// Auto-generated by generate-plugin-sdk.ts - DO NOT EDIT
+
+export type { ToastHandle, ToastOptions } from './_internal';
+import { ImageSourcePropType } from 'react-native';
+import { ComponentType } from 'react';
+
+import type { ToastHandle, ToastOptions } from './_internal';
+
+declare const _default: {
+	showToast: typeof showToast;
+};
+/**
+ * @description Shows a toast, generating an id when one is not supplied.
+ * @param options The toast options, optionally including a custom `id`.
+ * @returns A {@link ToastHandle} for controlling the shown toast.
+ */
+export declare function showToast(options: ToastOptions): ToastHandle;
+export { _default as default };

package/src/tseep.d.ts

@@ -0,0 +1,175 @@
+// Auto-generated by generate-plugin-sdk.ts - DO NOT EDIT
+
+declare class TaskCollection<
+	Func extends (...args: any) => void,
+	AwaitTasks extends true | false = false,
+> {
+	readonly awaitTasks: AwaitTasks;
+	constructor(
+		argsNum: ArgsNum<Func>,
+		autoRebuild?: boolean,
+		initialTasks?: Func[] | Func | null,
+		awaitTasks?: AwaitTasks,
+	);
+	/** DO NOT CHANGE DIRECTLY */
+	_tasks: Func[] | Func | null;
+	/** cached */
+	length: number;
+	/** auto rebuild on first emit call; otherwise autorebuild on every change */
+	firstEmitBuildStrategy: boolean;
+	readonly argsNum: ArgsNum<Func>;
+	autoRebuild: boolean;
+	readonly growArgsNum: typeof growArgsNum;
+	setAutoRebuild: typeof setAutoRebuild;
+	call: (...args: Parameters<Func>) => AwaitTasks extends true ? Promise<void> : void;
+	rebuild: () => void;
+	push: (...func: Func[]) => void;
+	/** remove last matched task from tasks */
+	removeLast: (func: Func) => void;
+	insert: (index: number, ...func: Func[]) => void;
+	setTasks: (tasks: Func[]) => void;
+	tasksAsArray: () => Func[];
+	/** this autorebuilds */
+	readonly clear: typeof clear;
+	/** this autorebuilds */
+	readonly fastClear: typeof fastClear;
+}
+declare function clear<
+	Func extends (...args: any) => void,
+	AwaitTasks extends true | false = false,
+>(this: TaskCollection<Func, AwaitTasks>): void;
+declare function fastClear<
+	Func extends (...args: any) => void,
+	AwaitTasks extends true | false = false,
+>(this: TaskCollection<Func, AwaitTasks>): void;
+declare function growArgsNum<
+	Func extends (...args: any) => void,
+	AwaitTasks extends true | false = false,
+>(this: TaskCollection<Func, AwaitTasks>, argsNum: number): void;
+declare function setAutoRebuild<
+	Func extends (...args: any) => void,
+	AwaitTasks extends true | false = false,
+>(this: TaskCollection<Func, AwaitTasks>, newVal: boolean): void;
+
+/** Implemented event emitter */
+export declare class EventEmitter<
+	EventMap extends DefaultEventMap = DefaultEventMap,
+> implements IEventEmitter<EventMap> {
+	events: {
+		[eventName in keyof EventMap]?: TaskCollection<EventMap[eventName]>;
+	};
+	onceEvents: {
+		[eventName in keyof EventMap]?: EventMap[eventName][] | EventMap[eventName];
+	};
+	boundFuncs: undefined | Map<Function, Function>;
+	_symbolKeys: Set<symbol>;
+	maxListeners: number;
+	get _eventsCount(): number;
+	emit: <EventKey extends keyof EventMap>(
+		event: EventKey,
+		...args: Parameters<EventMap[EventKey]>
+	) => boolean;
+	on: <EventKey extends keyof EventMap = string>(
+		event: EventKey,
+		listener: EventMap[EventKey],
+	) => this;
+	once: <EventKey extends keyof EventMap = string>(
+		event: EventKey,
+		listener: EventMap[EventKey],
+	) => this;
+	addListener: <EventKey extends keyof EventMap = string>(
+		event: EventKey,
+		listener: EventMap[EventKey],
+		argsNum?: ArgsNum<EventMap[EventKey]>,
+	) => this;
+	removeListener: <EventKey extends keyof EventMap = string>(
+		event: EventKey,
+		listener: EventMap[EventKey],
+	) => this;
+	hasListeners: <EventKey extends keyof EventMap = string>(event: EventKey) => boolean;
+	prependListener: <EventKey extends keyof EventMap = string>(
+		event: EventKey,
+		listener: EventMap[EventKey],
+	) => this;
+	prependOnceListener: <EventKey extends keyof EventMap = string>(
+		event: EventKey,
+		listener: EventMap[EventKey],
+	) => this;
+	off: <EventKey extends keyof EventMap = string>(
+		event: EventKey,
+		listener: EventMap[EventKey],
+	) => this;
+	removeAllListeners: <EventKey extends keyof EventMap = string>(event?: EventKey) => this;
+	setMaxListeners: (n: number) => this;
+	getMaxListeners: () => number;
+	listeners: <EventKey extends keyof EventMap = string>(event: EventKey) => EventMap[EventKey][];
+	rawListeners: <EventKey extends keyof EventMap = string>(
+		event: EventKey,
+	) => EventMap[EventKey][];
+	eventNames: () => Array<string | symbol>;
+	listenerCount: <EventKey extends keyof EventMap = string>(type: EventKey) => number;
+	addListenerBound: <EventKey extends keyof EventMap = string>(
+		event: EventKey,
+		listener: EventMap[EventKey],
+		bindTo?: any,
+		argsNum?: ArgsNum<EventMap[EventKey]>,
+	) => this;
+	removeListenerBound: <EventKey extends keyof EventMap = string>(
+		event: EventKey,
+		listener: EventMap[EventKey],
+	) => this;
+}
+export interface IEventEmitter<EventMap extends DefaultEventMap = DefaultEventMap> {
+	emit<EventKey extends keyof EventMap>(
+		event: EventKey,
+		...args: Parameters<EventMap[EventKey]>
+	): boolean;
+	on<EventKey extends keyof EventMap = string>(
+		event: EventKey,
+		listener: EventMap[EventKey],
+	): this;
+	once<EventKey extends keyof EventMap = string>(
+		event: EventKey,
+		listener: EventMap[EventKey],
+	): this;
+	addListener<EventKey extends keyof EventMap = string>(
+		event: EventKey,
+		listener: EventMap[EventKey],
+	): this;
+	removeListener<EventKey extends keyof EventMap = string>(
+		event: EventKey,
+		listener: EventMap[EventKey],
+	): this;
+	prependListener<EventKey extends keyof EventMap = string>(
+		event: EventKey,
+		listener: EventMap[EventKey],
+	): this;
+	prependOnceListener<EventKey extends keyof EventMap = string>(
+		event: EventKey,
+		listener: EventMap[EventKey],
+	): this;
+	off<EventKey extends keyof EventMap = string>(
+		event: EventKey,
+		listener: EventMap[EventKey],
+	): this;
+	removeAllListeners<EventKey extends keyof EventMap = string>(event?: EventKey): this;
+	setMaxListeners(n: number): this;
+	getMaxListeners(): number;
+	listeners<EventKey extends keyof EventMap = string>(event: EventKey): EventMap[EventKey][];
+	rawListeners<EventKey extends keyof EventMap = string>(event: EventKey): EventMap[EventKey][];
+	eventNames(): Array<string | symbol>;
+	listenerCount<EventKey extends keyof EventMap = string>(type: EventKey): number;
+}
+export type ArgsNum<T extends (...args: any[]) => any> = T extends (...args: infer K) => any
+	? K['length']
+	: never;
+export type DefaultEventMap = {
+	[event in string | symbol]: Listener;
+} & {
+	/**
+	 * __proto__ key not allowed due to implementation
+	 * add prefix, if you want to use this keyword
+	 */
+	__proto__?: never;
+};
+export type Listener = (...args: any[]) => Promise<any> | void;

package/src/utils.d.ts

@@ -0,0 +1,35 @@
+// Auto-generated by generate-plugin-sdk.ts - DO NOT EDIT
+
+/** An object of shape `T` widened with an arbitrary string/number/symbol index. */
+export type AnyProps<T extends Record<PropertyKey, any> = Record<PropertyKey, any>> = T &
+	Record<PropertyKey, any>;
+/** Any supported colour string: a {@link HexColor} or {@link RgbaColor}. */
+export type ColorString = HexColor | RgbaColor;
+/** The set of all falsy values. */
+export type Falsy = false | 0 | '' | null | undefined;
+/** Any function: accepts any arguments and returns `T`. */
+export type Fn<T = any> = (...args: any) => T;
+/** A hexadecimal colour string prefixed with `#`. */
+export type HexColor = `#${string}`;
+/**
+ * A string union that keeps `T`'s literals for autocomplete while still accepting any other string.
+ * Use this for Discord's open-ended enums (typography variants, colour tokens, sizes) so newly added
+ * values keep type-checking without an update here.
+ */
+export type LiteralUnion<T extends string> = T | (string & {});
+/** The result of a predicate: any {@link Truthy} or {@link Falsy} value. */
+export type PredicateResult = Truthy | Falsy;
+/** Any function returning a promise (`T` defaults to `Promise<any>`). */
+export type PromiseFn<T = Promise<any>> = (...args: any) => T;
+/** An `rgba(...)` colour string. */
+export type RgbaColor = `rgba(${string})`;
+/** The set of all truthy values. */
+export type Truthy = true | number | string | object | symbol | bigint;
+/** Widens a literal type to its primitive base (e.g. `'a'` to `string`, `1` to `number`). */
+export type Widen<T> = T extends number
+	? number
+	: T extends string
+		? string
+		: T extends boolean
+			? boolean
+			: T;