@monimesl/dot-dash 0.1.0-alpha.21 → 0.1.0-alpha.24

package/dist/index.d.ts

@@ -1,4 +1,112 @@
-import { HostCallOptions, HostError, HostError as DashError, HostError as HostError$1, HostErrorCode, HostErrorCode as DashErrorCode, HostErrorCode as HostErrorCode$1, HostRequest } from "@monimesl/dot-core";
+import { HostCallOptions, HostError, HostError as DashError, HostErrorCode, HostErrorCode as DashErrorCode, HostRequest } from "@monimesl/dot-core";
+//#region src/contacts/pick-phone.d.ts
+interface PickedContact {
+  name: string;
+  phone: string;
+}
+interface PickPhoneMethods {
+  'dash.contacts.pickPhone': {
+    params: Record<string, never>;
+    result: PickedContact;
+  };
+}
+/**
+ * Shows the phone's contacts so the person chooses one phone number, such as who to send money to.
+ * Needs the `contacts` permission. The dot sees only the chosen contact. Rejects with `cancelled` if
+ * the person closes it.
+ * @since 1.0
+ */
+declare function pickPhone(callOptions?: CallOptions): DashRequest<PickedContact>;
+declare namespace index_d_exports$9 {
+  export { ContactsMethods, PickedContact, pickPhone };
+}
+type ContactsMethods = PickPhoneMethods;
+declare namespace index_d_exports$8 {
+  export { CryptoInput, CryptoMethods, CryptoOutputOptions, HmacAlgorithm, HmacOptions, hmac, randomBytes, randomUUID, sha256, sha512 };
+}
+type CryptoInput = string | {
+  base64: string;
+};
+interface CryptoOutputOptions {
+  as?: 'hex' | 'base64';
+}
+type HmacAlgorithm = 'sha256' | 'sha512';
+interface HmacOptions extends CryptoOutputOptions {
+  algorithm: HmacAlgorithm;
+  key: CryptoInput;
+  data: CryptoInput;
+}
+type InputEncoding = 'text' | 'base64';
+type OutputEncoding = 'hex' | 'base64';
+interface WireInput {
+  data: string;
+  dataEncoding: InputEncoding;
+  as: OutputEncoding;
+}
+interface CryptoMethods {
+  'dash.crypto.sha256': {
+    params: WireInput;
+    result: string;
+  };
+  'dash.crypto.sha512': {
+    params: WireInput;
+    result: string;
+  };
+  'dash.crypto.hmac': {
+    params: WireInput & {
+      algorithm: HmacAlgorithm;
+      key: string;
+      keyEncoding: InputEncoding;
+    };
+    result: string;
+  };
+  'dash.crypto.randomBytes': {
+    params: {
+      count: number;
+      as: OutputEncoding;
+    };
+    result: string;
+  };
+  'dash.crypto.randomUUID': {
+    params: Record<string, never>;
+    result: string;
+  };
+}
+/** @since 1.0 */
+declare function sha256(data: CryptoInput, options?: CryptoOutputOptions, callOptions?: CallOptions): DashRequest<string>;
+/** @since 1.0 */
+declare function sha512(data: CryptoInput, options?: CryptoOutputOptions, callOptions?: CallOptions): DashRequest<string>;
+/**
+ * Signs `data` with `key`, as HMAC-SHA256 or HMAC-SHA512, such as
+ * `hmac({ algorithm: 'sha256', key, data })`.
+ * @since 1.0
+ */
+declare function hmac(options: HmacOptions, callOptions?: CallOptions): DashRequest<string>;
+/**
+ * `count` secure random bytes, from 1 to 1024, such as for a nonce.
+ * @since 1.0
+ */
+declare function randomBytes(count: number, options?: CryptoOutputOptions, callOptions?: CallOptions): DashRequest<string>;
+/**
+ * A random version 4 UUID, such as "3f0e5c3a-6d1b-4c8e-9a2f-1b7d4e6a9c05".
+ * @since 1.0
+ */
+declare function randomUUID(callOptions?: CallOptions): DashRequest<string>;
+declare namespace index_d_exports$7 {
+  export { DotMethods, close };
+}
+interface DotMethods {
+  'dash.dot.close': {
+    params: Record<string, never>;
+    result: void;
+  };
+}
+/**
+ * Closes the dot, as going back from its first page does. Calls still running are cancelled.
+ * @since 1.0
+ */
+declare function close(callOptions?: CallOptions): DashRequest<void>;
+//#endregion
 //#region src/files.d.ts
 interface DotFile {
   id: string;
@@ -8,6 +116,26 @@ interface DotFile {
   url: string;
 }
 //#endregion
+//#region src/media/pick-file.d.ts
+interface PickFileOptions {
+  types?: string[];
+}
+interface PickFileMethods {
+  'dash.media.pickFile': {
+    params: {
+      types?: string[];
+    };
+    result: DotFile;
+  };
+}
+/**
+ * Lets the person choose a file from their phone, of at most 25 MB. Needs the `files` permission.
+ * Rejects with `cancelled` if they close the picker, and with `invalid` for a larger file. Like a
+ * download, it lasts until the dot closes, so `dash.storage.file.save` it to keep it.
+ * @since 1.0
+ */
+declare function pickFile(options?: PickFileOptions, callOptions?: CallOptions): DashRequest<DotFile>;
+//#endregion
 //#region src/media/pick-photo.d.ts
 type PhotoSource = 'library' | 'camera';
 interface PickPhotoOptions {
@@ -21,6 +149,13 @@ interface PickPhotoMethods {
     result: DotFile;
   };
 }
+/**
+ * Lets the person choose a photo or take one. Resolves with it as a JPEG of at most 2048 pixels on its
+ * longest side, without its location or other details. Rejects with `cancelled` if they close the
+ * picker, and with `unsupported` on a device without a camera. Save it with `dash.storage.file.save`
+ * to keep it after the dot closes.
+ * @since 1.0
+ */
 declare function pickPhoto(options: PickPhotoOptions, callOptions?: CallOptions): DashRequest<DotFile>;
 //#endregion
 //#region src/media/scan-code.d.ts
@@ -35,11 +170,16 @@ interface ScanCodeMethods {
     result: ScannedCode;
   };
 }
+/**
+ * Opens Dash's scanner until it reads a QR code. Needs the `camera` permission. Rejects with
+ * `cancelled` if the person closes it, and with `unsupported` where Dash has no scanner.
+ * @since 1.0
+ */
 declare function scanCode(callOptions?: CallOptions): DashRequest<ScannedCode>;
-declare namespace index_d_exports$5 {
-  export { CodeFormat, MediaMethods, PhotoSource, PickPhotoOptions, ScannedCode, pickPhoto, scanCode };
+declare namespace index_d_exports$6 {
+  export { CodeFormat, MediaMethods, PhotoSource, PickFileOptions, PickPhotoOptions, ScannedCode, pickFile, pickPhoto, scanCode };
 }
-type MediaMethods = PickPhotoMethods & ScanCodeMethods;
+type MediaMethods = PickFileMethods & PickPhotoMethods & ScanCodeMethods;
 declare namespace http_d_exports {
   export { HttpDownloadRequest, HttpDownloadResponse, HttpMethod, HttpMethods, HttpReadOptions, HttpRequest, HttpRequestBody, HttpResponse, HttpUploadFile, HttpUploadRequest, download, request, upload };
 }
@@ -74,7 +214,7 @@ type HttpDownloadResponse = (Omit<HttpResponse, 'ok' | 'body'> & {
 });
 interface HttpUploadFile {
   field: string;
-  file: DotFile | string;
+  file: DotFile;
   name?: string;
 }
 interface HttpUploadRequest {
@@ -108,8 +248,20 @@ interface HttpMethods {
     result: HttpResponse;
   };
 }
+/**
+ * Like fetch, resolves with any response, even a 404. An object body is sent as JSON.
+ * @since 1.0
+ */
 declare function request<ResponseBody = string, RequestBody extends HttpRequestBody = HttpRequestBody>(options: HttpRequest<RequestBody> & HttpReadOptions<ResponseBody>, callOptions?: CallOptions): DashRequest<HttpResponse<ResponseBody>>;
+/**
+ * Saves a 2xx response's body, up to 256 MB, to a temporary file.
+ * @since 1.0
+ */
 declare function download(options: HttpDownloadRequest, callOptions?: CallOptions): DashRequest<HttpDownloadResponse>;
+/**
+ * Sends the dot's files as a multipart form.
+ * @since 1.0
+ */
 declare function upload<ResponseBody = string>(options: HttpUploadRequest & HttpReadOptions<ResponseBody>, callOptions?: CallOptions): DashRequest<HttpResponse<ResponseBody>>;
 //#endregion
 //#region src/network/status.d.ts
@@ -124,8 +276,12 @@ interface StatusMethods {
     result: NetworkStatus;
   };
 }
+/**
+ * Whether the phone is online now, and how. It can still be online without reaching a server.
+ * @since 1.0
+ */
 declare function status(callOptions?: CallOptions): DashRequest<NetworkStatus>;
-declare namespace index_d_exports$4 {
+declare namespace index_d_exports$5 {
   export { ConnectionType, HttpDownloadRequest, HttpDownloadResponse, HttpMethod, HttpReadOptions, HttpRequest, HttpRequestBody, HttpResponse, HttpUploadFile, HttpUploadRequest, NetworkMethods, NetworkStatus, http_d_exports as http, status };
 }
 type NetworkMethods = HttpMethods & StatusMethods;
@@ -174,14 +330,26 @@ interface CacheMethods {
 interface CacheSetOptions {
   ttl?: number | undefined;
 }
+/**
+ * Resolves with null for a missing or expired key.
+ * @since 1.0
+ */
 declare function get$1<Value extends CacheValue = CacheValue>(key: string, callOptions?: CallOptions): DashRequest<Value | null>;
+/** @since 1.0 */
 declare function set$1(key: string, value: CacheValue, options?: CacheSetOptions, callOptions?: CallOptions): DashRequest<void>;
+/** @since 1.0 */
 declare function remove$2(key: string, callOptions?: CallOptions): DashRequest<void>;
+/** @since 1.0 */
 declare function exists(key: string, callOptions?: CallOptions): DashRequest<boolean>;
+/**
+ * The keys, sorted.
+ * @since 1.0
+ */
 declare function keys(callOptions?: CallOptions): DashRequest<string[]>;
+/** @since 1.0 */
 declare function clear$1(callOptions?: CallOptions): DashRequest<void>;
 declare namespace file_d_exports {
-  export { FileEncoding, FileEntry, FileMethods, PickFileOptions, ReadOptions, ReplaceOptions, StorageUsage, WriteOptions, copy, createFolder, list, move, open, pick, read, remove$1 as remove, save, stat, usage, write };
+  export { FileEncoding, FileEntry, FileMethods, ReadOptions, ReplaceOptions, StorageUsage, WriteOptions, copy, createFolder, list, move, open, read, remove$1 as remove, save, stat, usage, write };
 }
 interface FileEntry {
   name: string;
@@ -273,15 +441,6 @@ interface FileMethods {
     params: Record<string, never>;
     result: StorageUsage;
   };
-  'dash.storage.file.pick': {
-    params: {
-      types?: string[];
-    };
-    result: DotFile;
-  };
-}
-interface PickFileOptions {
-  types?: string[];
 }
 interface ReadOptions {
   as?: FileEncoding;
@@ -293,22 +452,50 @@ interface WriteOptions {
 interface ReplaceOptions {
   overwrite?: boolean;
 }
+/**
+ * Reads a file of up to 5 MB.
+ * @since 1.0
+ */
 declare function read(path: string, options?: ReadOptions, callOptions?: CallOptions): DashRequest<string>;
+/**
+ * Creates any missing folders above the file.
+ * @since 1.0
+ */
 declare function write(path: string, data: string, options?: WriteOptions, callOptions?: CallOptions): DashRequest<FileEntry>;
+/** @since 1.0 */
 declare function stat(path: string, callOptions?: CallOptions): DashRequest<FileEntry | null>;
+/**
+ * Sorted by path.
+ * @since 1.0
+ */
 declare function list(path?: string, options?: {
   recursive?: boolean;
 }, callOptions?: CallOptions): DashRequest<FileEntry[]>;
+/** @since 1.0 */
 declare function createFolder(path: string, callOptions?: CallOptions): DashRequest<FileEntry>;
+/** @since 1.0 */
 declare function move(from: string, to: string, options?: ReplaceOptions, callOptions?: CallOptions): DashRequest<FileEntry>;
+/** @since 1.0 */
 declare function copy(from: string, to: string, options?: ReplaceOptions, callOptions?: CallOptions): DashRequest<FileEntry>;
+/**
+ * Removing a folder that isn't empty needs `recursive`.
+ * @since 1.0
+ */
 declare function remove$1(path: string, options?: {
   recursive?: boolean;
 }, callOptions?: CallOptions): DashRequest<void>;
-declare function save(file: DotFile | string, path: string, options?: ReplaceOptions, callOptions?: CallOptions): DashRequest<FileEntry>;
+/**
+ * Keeps a temporary file, such as a download, at `path`.
+ * @since 1.0
+ */
+declare function save(file: DotFile, path: string, options?: ReplaceOptions, callOptions?: CallOptions): DashRequest<FileEntry>;
+/**
+ * A stored file as a DotFile, to show with its `url` or send with `http.upload`.
+ * @since 1.0
+ */
 declare function open(path: string, callOptions?: CallOptions): DashRequest<DotFile>;
+/** @since 1.0 */
 declare function usage(callOptions?: CallOptions): DashRequest<StorageUsage>;
-declare function pick(options?: PickFileOptions, callOptions?: CallOptions): DashRequest<DotFile>;
 declare namespace secret_d_exports {
   export { SecretMethods, clear, get, remove, set };
 }
@@ -337,12 +524,16 @@ interface SecretMethods {
     result: void;
   };
 }
+/** @since 1.0 */
 declare function get(key: string, callOptions?: CallOptions): DashRequest<string | null>;
+/** @since 1.0 */
 declare function set(key: string, value: string, callOptions?: CallOptions): DashRequest<void>;
+/** @since 1.0 */
 declare function remove(key: string, callOptions?: CallOptions): DashRequest<void>;
+/** @since 1.0 */
 declare function clear(callOptions?: CallOptions): DashRequest<void>;
-declare namespace index_d_exports$3 {
-  export { CacheSetOptions, CacheValue, FileEncoding, FileEntry, PickFileOptions, ReadOptions, ReplaceOptions, StorageMethods, StorageUsage, WriteOptions, cache_d_exports as cache, file_d_exports as file, secret_d_exports as secret };
+declare namespace index_d_exports$4 {
+  export { CacheSetOptions, CacheValue, FileEncoding, FileEntry, ReadOptions, ReplaceOptions, StorageMethods, StorageUsage, WriteOptions, cache_d_exports as cache, file_d_exports as file, secret_d_exports as secret };
 }
 type StorageMethods = FileMethods & CacheMethods & SecretMethods;
 //#endregion
@@ -355,6 +546,7 @@ interface ClipboardMethods {
     result: void;
   };
 }
+/** @since 1.0 */
 declare function copyText(text: string, callOptions?: CallOptions): DashRequest<void>;
 //#endregion
 //#region src/system/delay.d.ts
@@ -366,6 +558,10 @@ interface DelayMethods {
     result: void;
   };
 }
+/**
+ * Resolves after `milliseconds`. The host keeps the time, since a dot's logic has no timers.
+ * @since 1.0
+ */
 declare function delay(milliseconds: number, callOptions?: CallOptions): DashRequest<void>;
 //#endregion
 //#region src/system/dial.d.ts
@@ -377,6 +573,12 @@ interface DialMethods {
     result: void;
   };
 }
+/**
+ * Opens the phone's dialer with `number` ready, such as "+232 76 123456" or a USSD code such as
+ * "*715#". The person taps Call. Spaces and dashes are fine; anything else but digits, +, * and #
+ * rejects with `invalid`.
+ * @since 1.0
+ */
 declare function dial(number: string, callOptions?: CallOptions): DashRequest<void>;
 //#endregion
 //#region src/system/haptics.d.ts
@@ -390,6 +592,10 @@ interface HapticsMethods {
     result: void;
   };
 }
+/**
+ * Plays a short vibration. Resolves once it's done.
+ * @since 1.0
+ */
 declare function vibrate(options?: VibrateOptions, callOptions?: CallOptions): DashRequest<void>;
 //#endregion
 //#region src/system/info.d.ts
@@ -401,7 +607,7 @@ interface SystemInfo {
   region: string | null;
   timeZone: string;
   dashVersion: string;
-  hostVersion: string;
+  apiVersions: string[];
 }
 interface InfoMethods {
   'dash.system.info': {
@@ -409,6 +615,10 @@ interface InfoMethods {
     result: SystemInfo;
   };
 }
+/**
+ * The phone and the Dash the dot runs in. It has nothing that identifies the person or the phone.
+ * @since 1.0
+ */
 declare function info(callOptions?: CallOptions): DashRequest<SystemInfo>;
 //#endregion
 //#region src/system/open-url.d.ts
@@ -420,6 +630,10 @@ interface OpenUrlMethods {
     result: void;
   };
 }
+/**
+ * Opens an https address in the device's browser. Any other address rejects with `invalid`.
+ * @since 1.0
+ */
 declare function openUrl(url: string, callOptions?: CallOptions): DashRequest<void>;
 //#endregion
 //#region src/system/screen.d.ts
@@ -438,7 +652,17 @@ interface ScreenMethods {
     result: void;
   };
 }
+/**
+ * Keeps the screen from dimming and locking while the dot shows, such as while a ticket's QR code is
+ * up. Dash undoes it when the dot closes.
+ * @since 1.0
+ */
 declare function keepAwake(on: boolean, callOptions?: CallOptions): DashRequest<void>;
+/**
+ * `max` makes the screen as bright as it goes, so a scanner can read a QR code on it, and `normal`
+ * puts it back. Dash puts it back too when the dot closes or the person leaves the app.
+ * @since 1.0
+ */
 declare function brightness(level: BrightnessLevel, callOptions?: CallOptions): DashRequest<void>;
 //#endregion
 //#region src/system/share.d.ts
@@ -446,7 +670,7 @@ interface ShareOptions {
   title?: string;
   text?: string;
   url?: string;
-  file?: DotFile | string;
+  file?: DotFile;
 }
 interface ShareMethods {
   'dash.system.share': {
@@ -459,21 +683,28 @@ interface ShareMethods {
     result: void;
   };
 }
+/**
+ * Opens the device's share sheet. Resolves once it shows.
+ * @since 1.0
+ */
 declare function share(options: ShareOptions, callOptions?: CallOptions): DashRequest<void>;
 //#endregion
 //#region src/system/torch.d.ts
-type TorchState = 'on' | 'off';
 interface TorchMethods {
   'dash.system.torch': {
     params: {
-      state: TorchState;
+      on: boolean;
     };
     result: void;
   };
 }
-declare function torch(state: TorchState, callOptions?: CallOptions): DashRequest<void>;
-declare namespace index_d_exports$2 {
-  export { BrightnessLevel, Platform, ShareOptions, SystemInfo, SystemMethods, TorchState, VibrateOptions, VibrationStyle, brightness, copyText, delay, dial, info, keepAwake, openUrl, share, torch, vibrate };
+/**
+ * Turns the torch on or off. Rejects with `unsupported` on a device without one.
+ * @since 1.0
+ */
+declare function torch(on: boolean, callOptions?: CallOptions): DashRequest<void>;
+declare namespace index_d_exports$3 {
+  export { BrightnessLevel, Platform, ShareOptions, SystemInfo, SystemMethods, VibrateOptions, VibrationStyle, brightness, copyText, delay, dial, info, keepAwake, openUrl, share, torch, vibrate };
 }
 type SystemMethods = ClipboardMethods & DelayMethods & DialMethods & HapticsMethods & InfoMethods & OpenUrlMethods & ScreenMethods & ShareMethods & TorchMethods;
 //#endregion
@@ -497,6 +728,10 @@ interface DialogMethods {
     result: AlertResult;
   };
 }
+/**
+ * Shows a native alert. Resolves with the action the person chose.
+ * @since 1.0
+ */
 declare function alert(options: AlertOptions, callOptions?: CallOptions): DashRequest<AlertResult>;
 //#endregion
 //#region src/ui/pickers.d.ts
@@ -520,52 +755,140 @@ interface PickerMethods {
     result: string;
   };
 }
+/**
+ * Opens the phone's own calendar. Resolves with the chosen date, such as "2026-10-24", or rejects
+ * with `cancelled` if the person closes it.
+ * @since 1.0
+ */
 declare function pickDate(options?: PickDateOptions, callOptions?: CallOptions): DashRequest<string>;
+/**
+ * Opens the phone's own clock. Resolves with the chosen time in 24 hours, such as "19:30", or
+ * rejects with `cancelled` if the person closes it.
+ * @since 1.0
+ */
 declare function pickTime(options?: PickTimeOptions, callOptions?: CallOptions): DashRequest<string>;
-declare namespace index_d_exports$1 {
+declare namespace index_d_exports$2 {
   export { AlertAction, AlertOptions, AlertResult, PickDateOptions, PickTimeOptions, UIMethods, alert, pickDate, pickTime };
 }
 type UIMethods = DialogMethods & PickerMethods;
 //#endregion
 //#region src/methods.d.ts
-type DashMethods = UIMethods & SystemMethods & NetworkMethods & StorageMethods & MediaMethods & ContactsMethods;
+type DashMethods = UIMethods & SystemMethods & NetworkMethods & StorageMethods & MediaMethods & ContactsMethods & DotMethods & AccountMethods & CryptoMethods;
 type DashMethod = keyof DashMethods;
 //#endregion
 //#region src/call.d.ts
 type CallOptions = HostCallOptions;
 type DashRequest<Result> = HostRequest<Result>;
-//#endregion
-//#region src/contacts/pick-phone.d.ts
-interface PickedContact {
-  name: string;
-  phone: string;
+declare namespace index_d_exports$1 {
+  export { AccountMethods, AccountProfile, ReadProfileOptions, readProfile };
 }
-interface PickPhoneMethods {
-  'dash.contacts.pickPhone': {
-    params: Record<string, never>;
-    result: PickedContact;
+interface ReadProfileOptions {
+  nonce: string;
+}
+interface AccountProfile {
+  accountIdToken: string;
+  fullName: string;
+}
+interface AccountMethods {
+  'dash.account.readProfile': {
+    params: {
+      nonce: string;
+    };
+    result: AccountProfile;
   };
 }
-declare function pickPhone(callOptions?: CallOptions): DashRequest<PickedContact>;
+/**
+ * The person signed in to Dash: their full name, and a token that names them in this dot. Needs the
+ * `account` permission. Rejects with `invalid` for a nonce that's empty or longer than 128
+ * characters, and with `failed` when no one is signed in.
+ * @since 1.0
+ */
+declare function readProfile(options: ReadProfileOptions, callOptions?: CallOptions): DashRequest<AccountProfile>;
+//#endregion
+//#region src/api-versions.d.ts
+export declare const DASH_API_VERSION = "1.0";
+export declare const DASH_API_SINCE: {
+  readonly 'account.readProfile': "1.0";
+  readonly 'contacts.pickPhone': "1.0";
+  readonly 'crypto.hmac': "1.0";
+  readonly 'crypto.randomBytes': "1.0";
+  readonly 'crypto.randomUUID': "1.0";
+  readonly 'crypto.sha256': "1.0";
+  readonly 'crypto.sha512': "1.0";
+  readonly 'dot.close': "1.0";
+  readonly 'media.pickFile': "1.0";
+  readonly 'media.pickPhoto': "1.0";
+  readonly 'media.scanCode': "1.0";
+  readonly 'network.http.download': "1.0";
+  readonly 'network.http.request': "1.0";
+  readonly 'network.http.upload': "1.0";
+  readonly 'network.status': "1.0";
+  readonly 'storage.cache.clear': "1.0";
+  readonly 'storage.cache.exists': "1.0";
+  readonly 'storage.cache.get': "1.0";
+  readonly 'storage.cache.keys': "1.0";
+  readonly 'storage.cache.remove': "1.0";
+  readonly 'storage.cache.set': "1.0";
+  readonly 'storage.file.copy': "1.0";
+  readonly 'storage.file.createFolder': "1.0";
+  readonly 'storage.file.list': "1.0";
+  readonly 'storage.file.move': "1.0";
+  readonly 'storage.file.open': "1.0";
+  readonly 'storage.file.read': "1.0";
+  readonly 'storage.file.remove': "1.0";
+  readonly 'storage.file.save': "1.0";
+  readonly 'storage.file.stat': "1.0";
+  readonly 'storage.file.usage': "1.0";
+  readonly 'storage.file.write': "1.0";
+  readonly 'storage.secret.clear': "1.0";
+  readonly 'storage.secret.get': "1.0";
+  readonly 'storage.secret.remove': "1.0";
+  readonly 'storage.secret.set': "1.0";
+  readonly 'system.brightness': "1.0";
+  readonly 'system.copyText': "1.0";
+  readonly 'system.delay': "1.0";
+  readonly 'system.dial': "1.0";
+  readonly 'system.info': "1.0";
+  readonly 'system.keepAwake': "1.0";
+  readonly 'system.openUrl': "1.0";
+  readonly 'system.share': "1.0";
+  readonly 'system.torch': "1.0";
+  readonly 'system.vibrate': "1.0";
+  readonly 'ui.alert': "1.0";
+  readonly 'ui.pickDate': "1.0";
+  readonly 'ui.pickTime': "1.0";
+};
+type DashFeature = keyof typeof DASH_API_SINCE;
+export declare function useHostDashApiVersions(versions: readonly string[]): void;
+export declare function warnAboveDashApiVersion(minApiVersion: string | undefined): void;
+/**
+ * Whether the Dash the dot runs in has `feature`: a call, such as "contacts.pickPhone", or a field
+ * added to a call later. Check it before using one that's newer than the dot's minApiVersion.
+ * @since 1.0
+ */
+declare function supports(feature: DashFeature): boolean;
+//#endregion
+//#region src/utils/encoding.d.ts
+declare const base64: {
+  encode(text: string): string;
+  decode(encoded: string): string;
+};
+declare const hex: {
+  encode(text: string): string;
+  decode(encoded: string): string;
+};
 declare namespace index_d_exports {
-  export { ContactsMethods, PickedContact, pickPhone };
+  export { base64, hex };
 }
-type ContactsMethods = PickPhoneMethods;
 //#endregion
 //#region src/tracked.d.ts
 export declare function tracked<Group extends object>(group: Group, track: (request: DashRequest<unknown>) => void): Group;
 //#endregion
 //#region src/errors.d.ts
-type DashErrorWith<Code extends HostErrorCode$1> = HostError$1 & {
+type DashErrorWith<Code extends HostErrorCode> = HostError & {
   readonly code: Code;
 };
-export declare function isDashError<Code extends HostErrorCode$1>(error: unknown, ...codes: Code[]): error is DashErrorWith<Code>;
-export declare function isDashCancelled(error: unknown): error is DashErrorWith<'cancelled'>;
-export declare function isDashTimeout(error: unknown): error is DashErrorWith<'timeout'>;
-export declare function isDashDenied(error: unknown): error is DashErrorWith<'denied'>;
-export declare function isDashInvalid(error: unknown): error is DashErrorWith<'invalid'>;
-export declare function isDashUnsupported(error: unknown): error is DashErrorWith<'unsupported'>;
-export declare function isDashFailed(error: unknown): error is DashErrorWith<'failed'>;
+export declare function isDashError<Code extends HostErrorCode>(error: unknown, ...codes: Code[]): error is DashErrorWith<Code>;
 export declare function errorMessage(error: unknown): string;
 export declare function unlessCancelled<Result>(call: PromiseLike<Result>): Promise<Result | undefined>;
 //#endregion
@@ -575,14 +898,19 @@ export declare function debounce(milliseconds: number): (dash: Dash) => Promise<
 //#endregion
 //#region src/index.d.ts
 export declare const dash: {
-  ui: typeof index_d_exports$1;
-  system: typeof index_d_exports$2;
-  network: typeof index_d_exports$4;
-  storage: typeof index_d_exports$3;
-  media: typeof index_d_exports$5;
-  contacts: typeof index_d_exports;
+  ui: typeof index_d_exports$2;
+  system: typeof index_d_exports$3;
+  network: typeof index_d_exports$5;
+  storage: typeof index_d_exports$4;
+  media: typeof index_d_exports$6;
+  contacts: typeof index_d_exports$9;
+  dot: typeof index_d_exports$7;
+  account: typeof index_d_exports$1;
+  crypto: typeof index_d_exports$8;
+  utils: typeof index_d_exports;
+  supports: typeof supports;
 };
 export type Dash = typeof dash;
 //#endregion
-export { type AlertAction, type AlertOptions, type AlertResult, type BrightnessLevel, type CacheSetOptions, type CacheValue, type CallOptions, type CodeFormat, type ConnectionType, type ContactsMethods, DashError, type DashErrorCode, type DashMethod, type DashMethods, type DashRequest, type DotFile, type FileEncoding, type FileEntry, HostError, type HostErrorCode, type HttpDownloadRequest, type HttpDownloadResponse, type HttpMethod, type HttpReadOptions, type HttpRequest, type HttpRequestBody, type HttpResponse, type HttpUploadFile, type HttpUploadRequest, type MediaMethods, type NetworkMethods, type NetworkStatus, type PhotoSource, type PickDateOptions, type PickFileOptions, type PickPhotoOptions, type PickTimeOptions, type PickedContact, type Platform, type ReadOptions, type ReplaceOptions, type ScannedCode, type ShareOptions, type StorageMethods, type StorageUsage, type SystemInfo, type SystemMethods, type TorchState, type UIMethods, type VibrateOptions, type VibrationStyle, type WriteOptions };
+export { type AccountProfile, type AlertAction, type AlertOptions, type AlertResult, type BrightnessLevel, type CacheSetOptions, type CacheValue, type CallOptions, type CodeFormat, type ConnectionType, type ContactsMethods, type CryptoInput, type CryptoOutputOptions, DashError, type DashErrorCode, type DashFeature, type DashMethod, type DashMethods, type DashRequest, type DotFile, type FileEncoding, type FileEntry, type HmacAlgorithm, type HmacOptions, type HttpDownloadRequest, type HttpDownloadResponse, type HttpMethod, type HttpReadOptions, type HttpRequest, type HttpRequestBody, type HttpResponse, type HttpUploadFile, type HttpUploadRequest, type MediaMethods, type NetworkMethods, type NetworkStatus, type PhotoSource, type PickDateOptions, type PickFileOptions, type PickPhotoOptions, type PickTimeOptions, type PickedContact, type Platform, type ReadOptions, type ReadProfileOptions, type ReplaceOptions, type ScannedCode, type ShareOptions, type StorageMethods, type StorageUsage, type SystemInfo, type SystemMethods, type UIMethods, type VibrateOptions, type VibrationStyle, type WriteOptions };
 //# sourceMappingURL=index.d.ts.map