@nx.js/runtime 0.0.58 → 0.0.60

package/dist/index.d.ts

@@ -1763,6 +1763,125 @@ interface GamepadEffectParameters {
     strongMagnitude?: number;
     weakMagnitude?: number;
 }
+interface AesCbcParams {
+    name: "AES-CBC";
+    iv: BufferSource;
+}
+interface AesCtrParams extends Algorithm {
+    counter: BufferSource;
+    length: number;
+}
+interface AesXtsParams {
+    name: "AES-XTS";
+    sectorSize: number;
+    sector?: number;
+    isNintendo?: boolean;
+}
+interface AesDerivedKeyParams extends Algorithm {
+    length: number;
+}
+interface AesGcmParams extends Algorithm {
+    additionalData?: BufferSource;
+    iv: BufferSource;
+    tagLength?: number;
+}
+interface AesKeyAlgorithm extends KeyAlgorithm {
+    length: number;
+}
+interface AesKeyGenParams extends Algorithm {
+    length: number;
+}
+interface Algorithm {
+    name: string;
+}
+interface EcKeyAlgorithm extends KeyAlgorithm {
+    namedCurve: NamedCurve;
+}
+interface EcKeyGenParams extends Algorithm {
+    namedCurve: NamedCurve;
+}
+interface EcKeyImportParams extends Algorithm {
+    namedCurve: NamedCurve;
+}
+interface EcdhKeyDeriveParams extends Algorithm {
+    public: CryptoKey;
+}
+interface EcdsaParams extends Algorithm {
+    hash: HashAlgorithmIdentifier;
+}
+interface HkdfParams extends Algorithm {
+    hash: HashAlgorithmIdentifier;
+    info: BufferSource;
+    salt: BufferSource;
+}
+interface HmacImportParams extends Algorithm {
+    hash: HashAlgorithmIdentifier;
+    length?: number;
+}
+interface HmacKeyAlgorithm extends KeyAlgorithm {
+    hash: KeyAlgorithm;
+    length: number;
+}
+interface HmacKeyGenParams extends Algorithm {
+    hash: HashAlgorithmIdentifier;
+    length?: number;
+}
+interface JsonWebKey {
+    alg?: string;
+    crv?: string;
+    d?: string;
+    dp?: string;
+    dq?: string;
+    e?: string;
+    ext?: boolean;
+    k?: string;
+    key_ops?: string[];
+    kty?: string;
+    n?: string;
+    oth?: RsaOtherPrimesInfo[];
+    p?: string;
+    q?: string;
+    qi?: string;
+    use?: string;
+    x?: string;
+    y?: string;
+}
+interface KeyAlgorithm {
+    name: string;
+}
+type NamedCurve = string;
+type AlgorithmIdentifier = Algorithm | string;
+type KeyFormat = "jwk" | "pkcs8" | "raw" | "spki";
+type KeyType = "private" | "public" | "secret";
+type KeyUsage = "decrypt" | "deriveBits" | "deriveKey" | "encrypt" | "sign" | "unwrapKey" | "verify" | "wrapKey";
+interface RsaHashedImportParams extends Algorithm {
+    hash: HashAlgorithmIdentifier;
+}
+interface RsaHashedKeyAlgorithm extends RsaKeyAlgorithm {
+    hash: KeyAlgorithm;
+}
+interface RsaHashedKeyGenParams extends RsaKeyGenParams {
+    hash: HashAlgorithmIdentifier;
+}
+interface RsaKeyAlgorithm extends KeyAlgorithm {
+    modulusLength: number;
+    publicExponent: BigInteger;
+}
+interface RsaKeyGenParams extends Algorithm {
+    modulusLength: number;
+    publicExponent: BigInteger;
+}
+interface RsaOaepParams extends Algorithm {
+    label?: BufferSource;
+}
+interface RsaOtherPrimesInfo {
+    d?: string;
+    r?: string;
+    t?: string;
+}
+interface RsaPssParams extends Algorithm {
+    saltLength: number;
+}
 type BlobPart = string | Blob | BufferSource;
 interface BlobPropertyBag {
     endings?: "native" | "transparent";
@@ -2570,10 +2689,16 @@ declare class Response extends Body {
  * @see https://developer.mozilla.org/docs/Web/API/fetch
  */
 declare function fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
-interface Algorithm {
-    name: string;
+declare class CryptoKey {
+    readonly algorithm: KeyAlgorithm;
+    readonly extractable: boolean;
+    readonly type: KeyType;
+    readonly usages: KeyUsage[];
+    /**
+     * @private
+     */
+    constructor();
 }
-type AlgorithmIdentifier = Algorithm | string;
 /**
  * Basic cryptography features available in the current context.
  * It allows access to a cryptographically strong random number
@@ -2641,10 +2766,17 @@ declare class SubtleCrypto {
      * @ignore
      */
     constructor();
-    decrypt(algorithm: AlgorithmIdentifier | RsaOaepParams | AesCtrParams | AesCbcParams | AesGcmParams, key: CryptoKey, data: BufferSource): Promise<ArrayBuffer>;
+    /**
+     * Decrypts some encrypted data.
+     *
+     * It takes as arguments a key to decrypt with, some optional extra parameters, and the data to decrypt (also known as "ciphertext").
+     *
+     * @returns A Promise which will be fulfilled with the decrypted data (also known as "plaintext") as an `ArrayBuffer`.
+     * @see https://developer.mozilla.org/docs/Web/API/SubtleCrypto/decrypt
+     */
+    decrypt(algorithm: AesCbcParams | AesXtsParams, key: CryptoKey, data: BufferSource): Promise<ArrayBuffer>;
     deriveBits(algorithm: AlgorithmIdentifier | EcdhKeyDeriveParams | HkdfParams | Pbkdf2Params, baseKey: CryptoKey, length: number): Promise<ArrayBuffer>;
     deriveKey(algorithm: AlgorithmIdentifier | EcdhKeyDeriveParams | HkdfParams | Pbkdf2Params, baseKey: CryptoKey, derivedKeyType: AlgorithmIdentifier | HkdfParams | Pbkdf2Params | AesDerivedKeyParams | HmacImportParams, extractable: boolean, keyUsages: KeyUsage[]): Promise<CryptoKey>;
-    deriveKey(algorithm: AlgorithmIdentifier | EcdhKeyDeriveParams | HkdfParams | Pbkdf2Params, baseKey: CryptoKey, derivedKeyType: AlgorithmIdentifier | HkdfParams | Pbkdf2Params | AesDerivedKeyParams | HmacImportParams, extractable: boolean, keyUsages: Iterable<KeyUsage>): Promise<CryptoKey>;
     /**
      * Generates a digest of the given data. A digest is a short fixed-length value
      * derived from some variable-length input. Cryptographic digests should exhibit
@@ -2668,24 +2800,25 @@ declare class SubtleCrypto {
      * @see https://developer.mozilla.org/docs/Web/API/SubtleCrypto/digest
      */
     digest(algorithm: AlgorithmIdentifier, data: BufferSource): Promise<ArrayBuffer>;
-    encrypt(algorithm: AlgorithmIdentifier | RsaOaepParams | AesCtrParams | AesCbcParams | AesGcmParams, key: CryptoKey, data: BufferSource): Promise<ArrayBuffer>;
+    encrypt(algorithm: AesCbcParams | AesXtsParams, key: CryptoKey, data: BufferSource): Promise<ArrayBuffer>;
     exportKey(format: "jwk", key: CryptoKey): Promise<JsonWebKey>;
     exportKey(format: "pkcs8" | "raw" | "spki", key: CryptoKey): Promise<ArrayBuffer>;
-    exportKey(format: KeyFormat, key: CryptoKey): Promise<ArrayBuffer | JsonWebKey>;
     generateKey(algorithm: "Ed25519", extractable: boolean, keyUsages: readonly ("sign" | "verify")[]): Promise<CryptoKeyPair>;
     generateKey(algorithm: RsaHashedKeyGenParams | EcKeyGenParams, extractable: boolean, keyUsages: readonly KeyUsage[]): Promise<CryptoKeyPair>;
     generateKey(algorithm: Pbkdf2Params | AesKeyGenParams | HmacKeyGenParams, extractable: boolean, keyUsages: readonly KeyUsage[]): Promise<CryptoKey>;
     generateKey(algorithm: AlgorithmIdentifier, extractable: boolean, keyUsages: KeyUsage[]): Promise<CryptoKey | CryptoKeyPair>;
     generateKey(algorithm: RsaHashedKeyGenParams | EcKeyGenParams, extractable: boolean, keyUsages: readonly KeyUsage[]): Promise<CryptoKeyPair>;
     generateKey(algorithm: Pbkdf2Params | AesKeyGenParams | HmacKeyGenParams, extractable: boolean, keyUsages: readonly KeyUsage[]): Promise<CryptoKey>;
-    generateKey(algorithm: AlgorithmIdentifier, extractable: boolean, keyUsages: Iterable<KeyUsage>): Promise<CryptoKey | CryptoKeyPair>;
-    importKey(format: "jwk", keyData: JsonWebKey, algorithm: AlgorithmIdentifier | HmacImportParams | RsaHashedImportParams | EcKeyImportParams | AesKeyAlgorithm, extractable: boolean, keyUsages: readonly KeyUsage[]): Promise<CryptoKey>;
+    /**
+     * Takes as input a key in an external, portable format and gives you a
+     * {@link CryptoKey} object that you can use in the Web Crypto API.
+     *
+     * @see https://developer.mozilla.org/docs/Web/API/SubtleCrypto/importKey
+     */
+    importKey(format: "jwk", keyData: JsonWebKey, algorithm: AlgorithmIdentifier | HmacImportParams | RsaHashedImportParams | EcKeyImportParams | AesKeyAlgorithm, extractable: boolean, keyUsages: KeyUsage[]): Promise<CryptoKey>;
     importKey(format: "pkcs8" | "raw" | "spki", keyData: BufferSource, algorithm: AlgorithmIdentifier | HmacImportParams | RsaHashedImportParams | EcKeyImportParams | AesKeyAlgorithm, extractable: boolean, keyUsages: KeyUsage[]): Promise<CryptoKey>;
-    importKey(format: "jwk", keyData: JsonWebKey, algorithm: AlgorithmIdentifier | HmacImportParams | RsaHashedImportParams | EcKeyImportParams | AesKeyAlgorithm, extractable: boolean, keyUsages: readonly KeyUsage[]): Promise<CryptoKey>;
-    importKey(format: "pkcs8" | "raw" | "spki", keyData: BufferSource, algorithm: AlgorithmIdentifier | HmacImportParams | RsaHashedImportParams | EcKeyImportParams | AesKeyAlgorithm, extractable: boolean, keyUsages: Iterable<KeyUsage>): Promise<CryptoKey>;
     sign(algorithm: AlgorithmIdentifier | RsaPssParams | EcdsaParams, key: CryptoKey, data: BufferSource): Promise<ArrayBuffer>;
     unwrapKey(format: KeyFormat, wrappedKey: BufferSource, unwrappingKey: CryptoKey, unwrapAlgorithm: AlgorithmIdentifier | RsaOaepParams | AesCtrParams | AesCbcParams | AesGcmParams, unwrappedKeyAlgorithm: AlgorithmIdentifier | HmacImportParams | RsaHashedImportParams | EcKeyImportParams | AesKeyAlgorithm, extractable: boolean, keyUsages: KeyUsage[]): Promise<CryptoKey>;
-    unwrapKey(format: KeyFormat, wrappedKey: BufferSource, unwrappingKey: CryptoKey, unwrapAlgorithm: AlgorithmIdentifier | RsaOaepParams | AesCtrParams | AesCbcParams | AesGcmParams, unwrappedKeyAlgorithm: AlgorithmIdentifier | HmacImportParams | RsaHashedImportParams | EcKeyImportParams | AesKeyAlgorithm, extractable: boolean, keyUsages: Iterable<KeyUsage>): Promise<CryptoKey>;
     verify(algorithm: AlgorithmIdentifier | RsaPssParams | EcdsaParams, key: CryptoKey, signature: BufferSource, data: BufferSource): Promise<boolean>;
     wrapKey(format: KeyFormat, key: CryptoKey, wrappingKey: CryptoKey, wrapAlgorithm: AlgorithmIdentifier | RsaOaepParams | AesCtrParams | AesCbcParams | AesGcmParams): Promise<ArrayBuffer>;
 }
@@ -3376,6 +3509,60 @@ declare class AmbientLightSensor extends Sensor {
     start(): void;
     stop(): void;
 }
+declare class DOMException extends Error {
+    INDEX_SIZE_ERR: 1;
+    DOMSTRING_SIZE_ERR: 2;
+    HIERARCHY_REQUEST_ERR: 3;
+    WRONG_DOCUMENT_ERR: 4;
+    INVALID_CHARACTER_ERR: 5;
+    NO_DATA_ALLOWED_ERR: 6;
+    NO_MODIFICATION_ALLOWED_ERR: 7;
+    NOT_FOUND_ERR: 8;
+    NOT_SUPPORTED_ERR: 9;
+    INUSE_ATTRIBUTE_ERR: 10;
+    INVALID_STATE_ERR: 11;
+    SYNTAX_ERR: 12;
+    INVALID_MODIFICATION_ERR: 13;
+    NAMESPACE_ERR: 14;
+    INVALID_ACCESS_ERR: 15;
+    VALIDATION_ERR: 16;
+    TYPE_MISMATCH_ERR: 17;
+    SECURITY_ERR: 18;
+    NETWORK_ERR: 19;
+    ABORT_ERR: 20;
+    URL_MISMATCH_ERR: 21;
+    QUOTA_EXCEEDED_ERR: 22;
+    TIMEOUT_ERR: 23;
+    INVALID_NODE_TYPE_ERR: 24;
+    DATA_CLONE_ERR: 25;
+    static INDEX_SIZE_ERR: 1;
+    static DOMSTRING_SIZE_ERR: 2;
+    static HIERARCHY_REQUEST_ERR: 3;
+    static WRONG_DOCUMENT_ERR: 4;
+    static INVALID_CHARACTER_ERR: 5;
+    static NO_DATA_ALLOWED_ERR: 6;
+    static NO_MODIFICATION_ALLOWED_ERR: 7;
+    static NOT_FOUND_ERR: 8;
+    static NOT_SUPPORTED_ERR: 9;
+    static INUSE_ATTRIBUTE_ERR: 10;
+    static INVALID_STATE_ERR: 11;
+    static SYNTAX_ERR: 12;
+    static INVALID_MODIFICATION_ERR: 13;
+    static NAMESPACE_ERR: 14;
+    static INVALID_ACCESS_ERR: 15;
+    static VALIDATION_ERR: 16;
+    static TYPE_MISMATCH_ERR: 17;
+    static SECURITY_ERR: 18;
+    static NETWORK_ERR: 19;
+    static ABORT_ERR: 20;
+    static URL_MISMATCH_ERR: 21;
+    static QUOTA_EXCEEDED_ERR: 22;
+    static TIMEOUT_ERR: 23;
+    static INVALID_NODE_TYPE_ERR: 24;
+    static DATA_CLONE_ERR: 25;
+    code: number;
+    constructor(message?: string, name?: string);
+}
 /**
  * The `import.meta` meta-property exposes context-specific metadata to a JavaScript module.
  * It contains information about the module, such as the module's URL.
@@ -3479,6 +3666,20 @@ declare namespace Switch {
 	 * ```
 	 */
 	declare function resolveDns(hostname: string): Promise<string[]>;
+	interface ReadFileOptions {
+	    /**
+	     * Byte offset to start reading the file from.
+	     *
+	     * @default 0
+	     */
+	    start?: number;
+	    /**
+	     * Byte offset to stop reading the file at (inclusive).
+	     *
+	     * @default Infinity
+	     */
+	    end?: number;
+	}
 	/**
 	 * Creates the directory at the provided `path`, as well as any necessary parent directories.
 	 *
@@ -3506,7 +3707,7 @@ declare namespace Switch {
 	 * const gameState = JSON.parse(new TextDecoder().decode(buffer));
 	 * ```
 	 */
-	declare function readFile(path: PathLike): Promise<ArrayBuffer | null>;
+	declare function readFile(path: PathLike, opts?: ReadFileOptions): Promise<ArrayBuffer | null>;
 	/**
 	 * Synchronously returns an array of the file names within `path`.
 	 *
@@ -3530,7 +3731,7 @@ declare namespace Switch {
 	 * const appState = JSON.parse(new TextDecoder().decode(buffer));
 	 * ```
 	 */
-	declare function readFileSync(path: PathLike): ArrayBuffer | null;
+	declare function readFileSync(path: PathLike, opts?: ReadFileOptions): ArrayBuffer | null;
 	/**
 	 * Synchronously writes the contents of `data` to the file at `path`.
 	 *
@@ -3584,7 +3785,7 @@ declare namespace Switch {
 	/**
 	 * Options object for the {@link file | `Switch.file()`} function.
 	 */
-	interface FsFileOptions {
+	interface FsFileOptions extends ReadFileOptions {
 	    type?: string;
 	    /**
 	     * Create a "big file", which is a directory with the "archive" bit set.
@@ -3603,7 +3804,7 @@ declare namespace Switch {
 	     *
 	     * @default 65536
 	     */
-	    chunkSize: number;
+	    chunkSize?: number;
 	}
 	/**
 	 * Returns a {@link FsFile | `Switch.FsFile`} instance for the given `path`.
@@ -3620,9 +3821,12 @@ declare namespace Switch {
 	 * also for writing files.
 	 */
 	declare class FsFile extends File {
+	    start?: number;
+	    end?: number;
 	    constructor(path: PathLike, opts?: FsFileOptions);
 	    get size(): number;
 	    stat(): Promise<Stats | null>;
+	    slice(start?: number, end?: number, type?: string): FsFile;
 	    arrayBuffer(): Promise<ArrayBuffer>;
 	    text(): Promise<string>;
 	    json(): Promise<any>;
@@ -4147,12 +4351,37 @@ declare namespace Switch {
 	     * ```
 	     */
 	    static openSdmc(): FileSystem;
+	    /**
+	     * Opens a file system partition for the application with the specified title ID.
+	     * The file system type is specified by the `FsFileSystemType` parameter.
+	     *
+	     * @example
+	     *
+	     * ```typescript
+	     * import { FsFileSystemType } from '@nx.js/constants';
+	     *
+	     * // Open and mount the "User" partition
+	     * const fs = Switch.FileSystem.openWithId(
+	     *   0x0100000000001000n,
+	     *   FsFileSystemType.ContentMeta,
+	     * );
+	     * const url = fs.mount();
+	     *
+	     * // Read the file entries at the root of the file system
+	     * console.log(Switch.readDirSync(url));
+	     * ```
+	     *
+	     * @param titleId The title ID of the file system to open.
+	     * @param type The `FsFileSystemType` of the file system to open.
+	     * @param path The base path of the file system to open. Defaults to `/`.
+	     */
+	    static openWithId(titleId: bigint, type: number, path?: string): FileSystem;
 	}
 	interface ServiceDispatchParams {
 	    targetSession?: number;
 	    context?: number;
 	    bufferAttrs?: number[];
-	    buffers?: ArrayBuffer[];
+	    buffers?: (ArrayBuffer | ArrayBufferView)[];
 	    inSendPid?: boolean;
 	    inObjects?: Service[];
 	    inHandles?: number[];
@@ -4166,9 +4395,9 @@ declare namespace Switch {
 	    isDomain(): void;
 	    isOverride(): void;
 	    dispatch(rid: number, params?: ServiceDispatchParams): void;
-	    dispatchIn(rid: number, inData: ArrayBuffer, parmas?: ServiceDispatchParams): void;
-	    dispatchOut(rid: number, outData: ArrayBuffer, params?: ServiceDispatchParams): void;
-	    dispatchInOut(rid: number, inData?: ArrayBuffer, outData?: ArrayBuffer, params?: ServiceDispatchParams): void;
+	    dispatchIn(rid: number, inData: ArrayBuffer | ArrayBufferView, parmas?: ServiceDispatchParams): void;
+	    dispatchOut(rid: number, outData: ArrayBuffer | ArrayBufferView, params?: ServiceDispatchParams): void;
+	    dispatchInOut(rid: number, inData?: ArrayBuffer | ArrayBufferView, outData?: ArrayBuffer | ArrayBufferView, params?: ServiceDispatchParams): void;
 	}
 	type PathLike = string | URL;
 	interface Versions {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nx.js/runtime",
-  "version": "0.0.58",
+  "version": "0.0.60",
   "description": "nx.js runtime",
   "repository": {
     "type": "git",